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.
API endpoints
| Service | Base URL |
|---|
| Orchestrator | https://v1.orchestrator.rhinestone.dev |
| Deposit Service | https://v1.orchestrator.rhinestone.dev/deposit-processor |
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 |
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 |
SDK install
npm install @rhinestone/sdk viem
Useful links
