OpenAPI 3.1.0raw.githubusercontent.com2026-08-063469194.3 KB

ce4e0abfe33a

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"
      }
    ]
  }
}