`Agent`

The runtime handle returned by createAgent and getAgent. All ongoing operations on an agent flow through this object.

Properties

Field	Type	Description
`name`	`string`	Full ENS name, e.g. `my-agent.agensai.eth`
`address`	`0x${string}`	Smart account address
`chainId`	`number`	Active chain
`status`	`"active" \| "revoked"`	Current state

Submit a single transaction.

const txHash = await agent.execute({
  to: "treasury.acme.eth",
  amount: "10 USDC",
});

Accepts ENS names or 0x addresses. Accepts "10 USDC" strings or raw { value, data }.

Submit an atomic batch. All calls succeed or all revert.

const { id } = await agent.batch([
  { to: "uniswap.eth", value: 0n, data: swapCalldata },
  { to: "treasury.acme.eth", amount: "5 USDC" },
]);

Read the active policy bundle from chain.

const active = await agent.policies();

Append a policy to the bundle. Onchain.

await agent.addPolicy({ type: "rate", count: 5, period: "hourly" });

Permanently revoke every policy. The smart account survives but cannot act.

await agent.revoke();

An Agent instance is cheap. Construct it on demand. Don't try to share one across processes.