Freeze RAMS Agent
Prepare an enforcement freeze for an ERC-8226 agent.
ramsFreezeAgent. signerAddress must hold ENFORCER_ROLE on AgentMandate. It is always client-signed and freezes the agent across all mandates in that registry.
The AgentMandate admin cannot also be its enforcer (AdminEnforcerOverlap). Use a distinct operational wallet.
Next step
Preparing does not touch the chain. The response gives youtxId, the unsigned transactions, and an x402Requirements quote.
Choose who signs and who broadcasts
brickken-relayed — the relayer signs, broadcasts, and pays the native gas; you sign only the payment, and prepare is free. client-signed (the default) — you sign, Brickken broadcasts. client-broadcast — you sign and broadcast yourself, then confirm with txHash. Both client-controlled modes charge half the price at prepare and half at send.Relaying is available on the ERC-8004 and agent-token facades and on the four signed RAMS lifecycle calls. The other RAMS operations check msg.sender against an on-chain role, so they reject it.Submit it and settle the payment
POST to /send-transactions. The first attempt answers 402 Payment Required; read PAYMENT-REQUIRED, sign the payment locally, and retry with X-PAYMENT. An API key is accepted here only in client-signed mode.Poll until it confirms
GET /get-transaction-status with the txId. Relayed transactions need no credential to poll. Your payment settles only after the operation confirms, and is released if it reverts.Authorizations
Base64-encoded x402 payment payload. Supported for x402-eligible agentic methods on /x402/... facades, /prepare-transactions, and eligible /send-transactions retries.
Body
Target operation chain ID. RAMS is available on Ethereum Sepolia (11155111) only at launch. Decimal and 0x hex values are accepted.
"11155111"
"0xaa36a7"
MUST hold ENFORCER_ROLE on the AgentMandate registry (pre-checked). Never brickken-relayed.
^0x[a-fA-F0-9]{40}$Agent to freeze.
^0x[a-fA-F0-9]{40}$Optional AgentMandate contract override; defaults to the chain's configured RAMS AgentMandate address.
^0x[a-fA-F0-9]{40}$Optional explicit gas limit.
Optional explicit transaction nonce when managing nonces manually.
Optional owner attribution email.
Alias for ownerEmail where supported.
Response
Prepared unsigned transaction payload.