Quick reference

API endpoints

Service	Base URL
Orchestrator	`https://v1.orchestrator.rhinestone.dev`
Deposit Service	`https://v1.orchestrator.rhinestone.dev/deposit-processor`

Authentication: pass your API key in the x-api-key header. Request a key. Pin a version with x-api-version: 2026-04.blanc — see API versioning.

Key endpoints

Endpoint	Method	Purpose
`/quotes`	POST	Get a quote for an intent
`/intents`	POST	Submit a signed intent
`/intents/{id}`	GET	Track intent status
`/accounts/{address}/portfolio`	GET	Fetch user token balances across chains

Supported chains

See Supported chains for the full list with token addresses.

Account types

Type	Description	SDK config
Smart Account (default)	ERC-7579 modular account (Safe, Kernel, Nexus)	`accountType: 'safe'` (or `'kernel'`, `'nexus'`)
Plain EOA	Standard externally owned account	`accountType: 'eoa'`
Smart EOA (EIP-7702)	EOA with smart account capabilities	`accountType: 'eip7702'`

Transaction path

The default transaction path is Warp (native relay). ERC-4337 userops are opt-in.

Scenario	Path
Crosschain, built-in swap, bridging	Warp (default)
Same-chain, ERC-4337 bundler needed	Use `sendUserOperation` instead of `sendTransaction`

Common error codes

All non-2xx responses share the envelope { code, message, traceId, details? }. Switch on code.

Code	HTTP	Meaning	Fix
`VALIDATION_ERROR`	400	Request didn’t validate (bad chain id, missing version header, unsupported token, etc.)	Inspect `details[]` and correct the payload
`UNAUTHORIZED`	401	API key missing or invalid	Pass your key in `x-api-key`
`NOT_FOUND`	404	Quote TTL elapsed before submit	Re-quote and re-sign — don’t retry the submit
`INSUFFICIENT_LIQUIDITY`	422	Account can’t cover the intent given gas and fees	Check balance; see `details.availableIntents` for fallbacks
`TOO_MANY_REQUESTS`	429	Rate limited	Honour `Retry-After`

See Error handling and the versioning guide for the full list.

Intent status values

Status	Meaning
`PENDING`	Submitted and in progress
`CLAIMED`	Source funds claimed by the solver, destination execution pending
`FILLED`	Executed on the destination chain, source funds not yet claimed
`COMPLETED`	Fully executed and settled onchain
`FAILED`	Execution failed
`EXPIRED`	Missed the execution deadline

See Tracking intents for more details on the lifecycle.

SDK install

npm install @rhinestone/sdk viem

Useful links

Dashboard for API keys and sponsorship config
GitHub examples for runnable code
Contract addresses for all deployments

Introduction

Concepts

Resources

Dashboard

API endpoints

Key endpoints

Supported chains

Account types

Transaction path

Common error codes

Intent status values

SDK install

Useful links

​API endpoints

​Key endpoints

​Supported chains

​Account types

​Transaction path

​Common error codes

​Intent status values

​SDK install

​Useful links

API endpoints

Key endpoints

Supported chains

Account types

Transaction path

Common error codes

Intent status values

SDK install

Useful links