Skip to content

aragonos:act

Execute an action on a target contract through an agent or vault.

Supports runtime fields inside smart blocks. Use explicit @helper! expressions or captured outputs; other fields are evaluated at build time.

aragonos:act <agent> <target> <signature> [...params]
NameTypeEvaluationDescription
agentaddressBuild timeAgent or vault forwarder address (build-time protocol discovery)
targetaddressRuntime in smart blocksTarget contract address
signaturewrite-abiBuild timeFunction signature to call
[...params]anyRuntime in smart blocksFunction arguments
# Execute a contract call through the DAO agent
aragonos:connect 0x1fc7e8d8e4bbbef77a4d035aec189373b52125a8 (
aragonos:act @aragonos:app(agent) @aragonos:app(agent 2) "deposit((uint256,int256),uint256[][])" [1 -2] [[2 3] [4 5]]
)
  • The agent must have the necessary permissions to execute the action
  • Parameters are ABI-encoded from the function signature, just like exec
  • exec — direct contract calls (without DAO agent)
  • forward — route through forwarder apps