Quick reference - Rhinestone

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.

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

See Supported chains for the full list with token addresses.

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'`

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`

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.

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.

npm install @rhinestone/sdk viem