TypeScript SDK

npm install @kernlog/brdg-sdk

import { createClient } from '@kernlog/brdg-sdk';

const brdg = createClient();

// Check which venues serve the route
const { routes } = await brdg.getRoutes({ fromChain: 'base', toChain: 'solana' });

// Quote: 100 USDC on Base to USDC on Solana
const quote = await brdg.getQuote({
  fromChain: 'base',
  toChain: 'solana',
  fromToken: 'USDC',
  toToken: 'USDC',
  amountAtomic: '100000000',
  sender: '0xYourEvmWallet',
  recipient: 'YourSolanaWallet',
});
quote.best; // the quote BRDG builds by default
quote.bestByTime; // quoteId of the fastest quote a wallet can sign
quote.quotes; // every venue that answered, best first

// Build the unsigned steps. Pass quoteId to build a different quote.
const build = await brdg.buildTransfer({ decisionId: quote.decisionId });

// Sign build.steps in order with the user's wallet, then report the hash
await brdg.submitTransfer(build.transferId, { txHash: '0x…', step: 'main' });

// Wait until the transfer finishes
const transfer = await brdg.waitForTransfer(build.transferId, {
  onUpdate: (t) => console.log(t.status),
});

createClient({
  baseUrl: 'https://api.brdg.now/v1', // default
  apiKey: process.env.BRDG_API_KEY, // partner key, sent as x-brdg-api-key; server-side only
  retry: true, // retry 429s, and 5xx and network failures on reads, with backoff; off by default
  headers: { 'x-integrator': 'my-app' }, // added to every request
  fetch: customFetch, // defaults to the global fetch
});

import { isBrdgError } from '@kernlog/brdg-sdk';

try {
  await brdg.buildTransfer({ decisionId });
} catch (error) {
  if (isBrdgError(error) && error.code === 'quote_drifted') {
    // the price moved: get a new quote
  }
}