RAMS EIP-712 Typed Data
Fetch complete typed-data envelopes for signature-authorized RAMS lifecycle operations.
Client flow
- Fetch typed data with the exact operation parameters.
- Sign the returned
typedData.domain,types, andmessagelocally with the principal wallet (ethers._signTypedData/signTypedData). The API’stypesintentionally omitEIP712Domain. - Prepare the matching RAMS write using the same parameters, the returned
deadline, and the signature. - Client-sign the returned transaction, or request
executionMode: "brickken-relayed"; then send and settle x402.
RAMS version 1, and the verifying contract is the selected AgentMandate. The default deadline is one hour; caller-supplied deadlines cannot exceed 30 days.
Authorizations
Query Parameters
Target chain ID. RAMS is available on Ethereum Sepolia (11155111) only at launch. Decimal and 0x hex values are accepted.
Agent wallet receiving the mandate.
^0x[a-fA-F0-9]{40}$Principal delegating authority (the signer).
^0x[a-fA-F0-9]{40}$Mandate expiry (Unix seconds, uint48).
Mandate start (Unix seconds, uint48). Defaults to 0 (immediately valid).
Compliance provider contract. Defaults to the chain's configured RAMS ComplianceProvider address.
^0x[a-fA-F0-9]{40}$Compliance identity reference (bytes32).
^0x[a-fA-F0-9]{64}$Asset (token) the mandate is scoped to.
^0x[a-fA-F0-9]{40}$Per-transaction cap in raw base units. Alias "max" / "unlimited" = 2^256-1.
Cumulative cap in raw base units. Alias "max" / "unlimited" = 2^256-1.
Optional bytes32 metadata. Defaults to the zero value.
^0x[a-fA-F0-9]{64}$Comma-separated list of bytes32 actions and/or 4-byte selectors, minimum 1 (e.g. 0x23b872dd). Selectors are normalized to left-aligned bytes32 before signing.
Optional signature deadline (Unix seconds). Must be greater than now and at most now + 30 days. Defaults to now + 3600 (1 hour). Submit the SAME deadline with the signature at prepare time.
Optional AgentMandate contract override.
^0x[a-fA-F0-9]{40}$Response
EIP-712 typed-data envelope ready for wallet._signTypedData(domain, types, message).