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.
Rhinestone supports two swap modes:
- Swaps: Warp handles the swap using solver liquidity. Simpler to integrate, best for common tokens.
- Injected swaps: you supply the calldata for a swap from an external API (1inch, 0x, etc.). More setup, but full token coverage and best-price routing.
Swaps
Specify the token you want on the destination chain. If it differs from what the user holds, Warp handles the bridge and swap automatically.import { baseSepolia, arbitrumSepolia } from 'viem/chains'
const ethAmount = 2n
const receiver = '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
const prepared = await rhinestoneAccount.prepareTransaction({
sourceChains: [baseSepolia],
targetChain: arbitrumSepolia,
calls: [
{
to: receiver,
value: ethAmount,
},
],
tokenRequests: [
{
address: 'ETH',
amount: ethAmount,
},
],
})
const signed = await rhinestoneAccount.signTransaction(prepared)
const transaction = await rhinestoneAccount.submitTransaction(signed)
The token address in calls and tokenRequests must correspond to the target chain.
Injected swaps
For full token coverage or best-price routing, supply swap calldata from a DEX aggregator and include it as destination chain calls.The example below makes a WETH to cbBTC swap on Base using funds from Arbitrum, via 1inch.1. Initialize the 1inch client:const walletAddress = rhinestoneAccount.getAddress()
const wethBase = '0x4200000000000000000000000000000000000006'
const wethAmount = parseEther('0.1')
const cbbtcBase = '0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf'
const oneInchApiKey = 'YOUR_1INCH_API_KEY'
const baseUrl = 'https://api.1inch.dev/swap/v6.0/8453'
async function call1inchAPI<T>(
endpointPath: string,
queryParams: Record<string, string>
): Promise<T> {
const url = new URL(baseUrl + endpointPath)
url.search = new URLSearchParams(queryParams).toString()
const response = await fetch(url.toString(), {
headers: { Accept: 'application/json', Authorization: `Bearer ${oneInchApiKey}` },
})
if (!response.ok) throw new Error(`1inch API error ${response.status}`)
return response.json() as Promise<T>
}
const approveTx = await call1inchAPI<ApproveTransactionResponse>('/approve/transaction', {
tokenAddress: wethBase,
amount: wethAmount.toString(),
})
const swapTx = await call1inchAPI<TxResponse>('/swap', {
src: wethBase,
dst: cbbtcBase,
amount: wethAmount.toString(),
from: walletAddress,
slippage: '1',
disableEstimate: 'false',
allowPartialFill: 'false',
})
const transaction = await rhinestoneAccount.prepareTransaction({
sourceChains: [arbitrum],
targetChain: base,
calls: [
{ to: approveTx.to, data: approveTx.data, value: approveTx.value },
{ to: swapTx.tx.to, data: swapTx.tx.data, value: swapTx.tx.value },
],
tokenRequests: [
{ address: wethBase, amount: wethAmount },
],
})
Swaps
When you request a token on the destination chain that differs from the user’s source token, Warp routes through the solver market to bridge and swap in a single operation. No additional parameters are required — the quote response tells you what will be spent and what will be received.In a swap, cost.input and cost.output show different tokens:{
"cost": {
"input": [
{
"chainId": "eip155:8453",
"tokenAddress": "0x4200000000000000000000000000000000000006",
"symbol": "WETH",
"decimals": 18,
"price": { "usd": 2412.37 },
"amount": "959454558006521"
}
],
"output": [
{
"chainId": "eip155:10",
"tokenAddress": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
"symbol": "USDC",
"decimals": 6,
"price": { "usd": 0.99 },
"amount": "2000000"
}
],
"fees": {
"total": { "usd": 0.31 },
"breakdown": {
"gas": { "usd": 0.30, "sponsored": false },
"swap": { "usd": 0.01, "sponsored": false },
"bridge": { "usd": 0.0004, "sponsored": false }
}
}
}
}
eip155:8453) to receive USDC on Optimism. output.amount matches the requested amount exactly — fees are paid in input tokens and surfaced via cost.fees.breakdown.For the full quote and submission flow, see the API Quickstart.
