Action Plans

An Action Plan is the agent-facing proposal that Grantline evaluates. It describes one or more intended actions in a form that can be checked against an active Mandate before execution.

A structured proposal

An Action Plan gives Grantline a complete object to evaluate rather than a request to execute arbitrary Vault calls. It carries the identity of the authority being used, the proposing agent, replay and timing controls, and an ordered set of typed actions.

The proposal format can expand as Grantline supports more capabilities, while the principle stays the same: the agent submits a structured request that Grantline can evaluate before execution.

Action types

The current contracts support two action types:

• TRANSFER (version 1): moves native asset or ERC-20 tokens from the Vault to a recipient.
• SWAP (version 1): swaps tokens through a configured adapter (currently Uniswap V3). The adapter validates the route before execution.

A plan can contain multiple actions of either type. The executor runs them in array order.

Ordered and atomic

An Action Plan can contain multiple actions. Grantline evaluates the plan as a whole, which prevents separate actions from being used to bypass a boundary that applies to their combined effect.

The current executor runs actions in order and treats the plan as one operation. If a later action fails, the transaction reverts, so earlier capital movement is not left behind as a successful completion.

Signed intent

The agent signs the proposal it wants to submit. The signature binds the agent to the exact Action Plan and the Mandate ID it uses, so changing the plan's signed values produces a different commitment that must be checked again. The evaluator reads current Mandate rules and conditions when it checks the plan, so the signature does not freeze historical permissions. See Action commitments, signatures and nonces for the current EIP-712 rules and digest usage.

Action Plans are proposals, not permission by themselves. The active Mandate, current conditions, and any required approval still determine whether the plan may proceed.

See Decisions for the result of evaluation.