Skip to main content
POST
/
setup-account
Prepare account for registration
curl --request POST \
  --url https://v1.orchestrator.rhinestone.dev/deposit-processor/setup-account \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "ownerAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "sessionOwnerAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "targetToken": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "targetChain": "eip155:8453",
  "recipient": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "postBridgeActions": [
    {
      "type": "orderbook-swap",
      "contract": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
      "outputToken": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"
    }
  ],
  "outputTokenRules": [
    {
      "match": {
        "symbol": "USDC"
      },
      "outputToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    }
  ],
  "rejectUnmapped": true,
  "signerAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "sessionChainIds": [
    1
  ],
  "forceRegister": true
}
'
{
  "smartAccount": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "isRegistered": true,
  "needsRegistration": true,
  "targetChain": "<string>",
  "targetToken": "<string>",
  "solanaDepositAddress": "<string>",
  "accountParams": {
    "factory": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
    "factoryData": "0x1234abcd"
  },
  "sessionDetailsUnsigned": {
    "hashesAndChainIds": [
      {
        "chainId": "<string>",
        "sessionDigest": "0x1234abcd"
      }
    ],
    "data": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.rhinestone.dev/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
x-api-key
string
required

API key for authentication

Example:

"your-api-key"

​
x-api-version
string

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

Pattern: ^\d{4}-\d{2}\.[a-z0-9]+$
Example:

"2026-04.amazon"

Body

application/json
​
ownerAddress
string
required

Ethereum address (0x followed by 40 hex characters)

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

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

​
sessionOwnerAddress
string
required

Ethereum address (0x followed by 40 hex characters)

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

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

​
targetToken
string
required

Ethereum address (0x followed by 40 hex characters)

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

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

​
targetChain
required

Chain identifier as a positive integer or CAIP-2 string (e.g. "eip155:8453")

Required range: x > 0
Example:

"eip155:8453"

​
recipient
string

Ethereum address (0x followed by 40 hex characters)

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

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

​
postBridgeActions
object[]
​
outputTokenRules
object[]
​
rejectUnmapped
boolean
​
signerAddress
string

Ethereum address (0x followed by 40 hex characters)

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

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

​
sessionChainIds
integer[]
Required range: x > 0
​
forceRegister
boolean

Response

Account setup result

​
smartAccount
string
required

Ethereum address (0x followed by 40 hex characters)

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

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

​
isRegistered
boolean
required
​
needsRegistration
boolean
required
​
targetChain
string
​
targetToken
string
​
solanaDepositAddress
string
​
accountParams
object
​
sessionDetailsUnsigned
object