Grant RAMS Principal Eligibility
Prepare a compliance eligibility record for a principal.
ramsGrantPrincipal. signerAddress must be the ComplianceProvider owner; this admin operation is always client-signed.
Provide the principal, a non-zero bytes32 identityRef, and optional expiresAt (0 means no expiry). This must be completed before granting a mandate that references the same provider and identity.
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 be the ComplianceProvider owner (pre-checked). Never brickken-relayed.
^0x[a-fA-F0-9]{40}$Principal receiving the eligibility record.
^0x[a-fA-F0-9]{40}$Non-zero compliance identity reference bound to the principal.
^0x[a-fA-F0-9]{64}$Optional eligibility expiry. Defaults to 0 (no expiry). If non-zero it must be greater than now. Unix timestamp in seconds (uint48).
Optional ComplianceProvider contract override; defaults to the chain's configured RAMS ComplianceProvider 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.