Skip to main content
POST
Prepare RAMS freeze agent
Maps to 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.

Authorizations

X-Payment
string
header
required

Base64-encoded x402 payment payload. Supported for x402-eligible agentic methods on /x402/... facades, /prepare-transactions, and eligible /send-transactions retries.

Body

application/json
chainId
string
default:11155111
required

Target operation chain ID. RAMS is available on Ethereum Sepolia (11155111) only at launch. Decimal and 0x hex values are accepted.

Examples:

"11155111"

"0xaa36a7"

signerAddress
string
required

MUST hold ENFORCER_ROLE on the AgentMandate registry (pre-checked). Never brickken-relayed.

Pattern: ^0x[a-fA-F0-9]{40}$
agent
string
required

Agent to freeze.

Pattern: ^0x[a-fA-F0-9]{40}$
agentMandateAddress
string

Optional AgentMandate contract override; defaults to the chain's configured RAMS AgentMandate address.

Pattern: ^0x[a-fA-F0-9]{40}$
gasLimit

Optional explicit gas limit.

nonce
number

Optional explicit transaction nonce when managing nonces manually.

ownerEmail
string<email>

Optional owner attribution email.

email
string<email>

Alias for ownerEmail where supported.

Response

Prepared unsigned transaction payload.

data
object