v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-013469188.5 KB

Accounts

Prepare account for registration

Derive the Rhinestone smart account for (ownerAddress, sessionOwnerAddress), compare against the existing registration and target, and return either the Solana deposit address (if no re-registration is needed) or the unsigned session details and factory parameters the client must sign before calling /register.

post/setup-account

Headers

x-api-keystring required

API key for authentication

Example:your-api-key

API key for authentication

x-api-versionstring

API version identifier (e.g. "2026-04.amazon"). Optional today, will become required in a future release.

Example:2026-04.amazon

API version identifier (e.g. "2026-04.amazon"). Optional today, will become required in a future release.

Request body

ownerAddressstring required

Ethereum address (0x followed by 40 hex characters)

sessionOwnerAddressstring required

Ethereum address (0x followed by 40 hex characters)

targetTokenstring required

recipientstring

rejectUnmappedboolean

{"stackTrail":"components:schemas:SetupAccountRequestBody:properties:postBridgeActions","oasType":"schema","type":"unknown"}

signerAddressstring

Ethereum address (0x followed by 40 hex characters)

sessionChainIdsinteger[]

forceRegisterboolean

Example request

{
  "ownerAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "sessionOwnerAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "outputTokenRules": [
    {
      "match": {
        "symbol": "USDC"
      },
      "outputToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    }
  ],
  "signerAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"
}

Response

Account setup result

smartAccountstring required

Ethereum address (0x followed by 40 hex characters)

isRegisteredboolean required

targetChainstring

targetTokenstring

needsRegistrationboolean required

solanaDepositAddressstring

Example response

{
  "smartAccount": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "accountParams": {
    "factory": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
    "factoryData": "0x1234abcd"
  },
  "sessionDetailsUnsigned": {
    "hashesAndChainIds": [
      {
        "sessionDigest": "0x1234abcd"
      }
    ]
  }
}