​
What is an adapter anyway?

An adapter is a function that takes parameters and returns an object that adheres to this interface. Let’s review the interface in depth:

PropertyDescriptionRequired
vmTypeA string representing a supported vmType (evm svm bvm suivm)✅
getChainIdAn async function that returns a chain id✅
handleSignMessageStepAn async function that given a signature step item and a step generates a signature✅
handleSendTransactionStepAn async function that given a chain id, a transaction step item and a step returns a transaction hash✅
handleConfirmTransactionStepAn async function that given a transaction hash, a chain id, an onReplaced function and an onCancelled function returns a promise with either an evm receipt or an svm receipt✅
addressAn async function that returns the currently connected to address, an address that can sign messages and submit transactions✅
switchChainAn async function that given a chain id switches to that chain, either by prompting the user or automatically switching chains✅
transportAn optional transport to use when making rpc calls.❌
getBalanceAn optional method to override the default balance fetching logic for selected tokens in the ui kit.❌
supportsAtomicBatchAn optional async function that takes a chain ID and returns whether the wallet supports EIP-5792’s atomic batch capability. EVM wallets only.❌
handleBatchTransactionStepAn optional async function that takes a chain ID and an array of transaction step items, returning a call bundle identifier for batch processing. Only available for EVM wallets that support atomic batching.❌

​
What adapters are available out of the box?

The following adapters are officially maintained and developed by the Reservoir Relay team:

SVM Adapter: This adapter gives the sdk the ability to submit transactions on SVM (Solana Virtual Machine) networks. It does not support signing messages and under the hood it uses the solana web3 sdk.

Bitcoin Adapter: This adapter gives the sdk the ability to submit transaction to the Bitcoin blockchain. Under the hood it uses bitcoinjs-lib to sign and submit transactions. Note that bitcoin transactions have a long finalization period and unlike quicker vms are not polled in real time for confirmation.

Viem Adapter: This adapter is the default one used when no adapter is provided. You can also import it yourself to convert any viem wallet client into an adapted wallet ready to be used in the sdk.

Ethers Adapter: If your application uses ethers then you’ll need this adapter to use the SDK. You’ll still need to install viem as that’s required for polling transactions but you can pass in your ethers signer to submit transactions and sign messages.

Sui Adapter: This adapter gives the sdk the ability to submit transactions on Sui networks. Under the hood it uses the @mysten/sui sdk.

​
How can I use an adapter?

You can either make your own adapter, as long as it adheres to the interface above or you can use one of the officials adapters developed and maintained by the Reservoir Relay team. All of our sdk methods handle a viem wallet or adapted wallet. The viem wallet adapter is used by default when a viem wallet is passed in for convenience. Refer below for implementation details:

import { getClient, Execute, getQuote } from "@reservoir0x/relay-sdk";
import { adaptSolanaWallet } from '@reservoir0x/relay-solana-wallet-adapter'
import { Connection, Keypair, clusterApiUrl, SystemProgram, Transaction } from '@solana/web3.js';
...

//In this example we are loading a keypair as the wallet, but if you have a connector like dynamic you can just fetch the connection from that library
const wallet = Keypair.generate();
const connection = new Connection(clusterApiUrl('devnet'), 'confirmed');
const walletAddress = wallet.publicKey.toString()

const adaptedWallet = adaptSolanaWallet(
  walletAddress,
  792703809, //chain id that Relay uses to identify solana 
  connection,
  connection.sendTransaction
)

const options = ... //define this based on getQuote options

const quote = await getClient().actions.getQuote(options)

getClient().actions.execute({
  quote,
  wallet: adaptedWallet,
  onProgress: ({steps, fees, breakdown, currentStep, currentStepItem, txHashes, details}) => {
        //custom handling
  },
  ...
})