Skip to main content
POST
Prepare RAMS grant principal eligibility
Maps to 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.

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 be the ComplianceProvider owner (pre-checked). Never brickken-relayed.

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

Principal receiving the eligibility record.

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

Non-zero compliance identity reference bound to the principal.

Pattern: ^0x[a-fA-F0-9]{64}$
expiresAt

Optional eligibility expiry. Defaults to 0 (no expiry). If non-zero it must be greater than now. Unix timestamp in seconds (uint48).

complianceProviderAddress
string

Optional ComplianceProvider contract override; defaults to the chain's configured RAMS ComplianceProvider 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