Quickstart SDK Documentation | Docs

The Rhino SDK is a JavaScript/TypeScript client for the Rhino Stablecoin Activation Stack. It handles authentication, config fetching, quote generation, and transaction execution — letting you bridge assets with a few lines of code. For non-JS environments, use the REST API directly.

Install the package

npm install @rhino.fi/sdk

yarn add @rhino.fi/sdk

pnpm install @rhino.fi/sdk

bun install @rhino.fi/sdk

Initialize the SDK

rhino-sdk.ts

import { RhinoSdk } from '@rhino.fi/sdk'

export const rhinoSdk = RhinoSdk({
  apiKey: 'YOUR_API_KEY',
})

Visit the Rhino.fi Console

You can create a project and manage API keys there.

Make a bridge

bridge.ts

import { SupportedChains, SupportedTokens } from '@rhino.fi/sdk'
import { getEvmChainAdapterFromPrivateKey } from '@rhino.fi/sdk/adapters/evm'
import { rhinoSdk } from './rhino-sdk'

const bridgeResult = await rhinoSdk.bridge({
  type: 'bridge',
  amount: '100',
  token: SupportedTokens.USDT,
  chainIn: SupportedChains.ARBITRUM_ONE,
  chainOut: SupportedChains.SOLANA,
  depositor: 'DEPOSITOR_ADDRESS',
  recipient: 'RECIPIENT_ADDRESS',
  mode: 'receive',
  gasBoost: {
    amountNative: '4'
  }
}, {
  getChainAdapter: chainConfig =>
    getEvmChainAdapterFromPrivateKey(
      'YOUR_PRIVATE_KEY',
      chainConfig,
    ),
    hooks: {
      checkQuote: quote => quote.fees.feeUsd < 5,
      onBridgeStatusChange: status => console.log('Bridge status changed', status),
    },
})

if (bridgeResult.data) {
  console.log('Bridge successful', bridgeResult.data.withdrawTxHash)
} else {
  console.log('Bridge error', bridgeResult.error)
}

This would bridge 100 USDT from Arbitrum to Solana while also receiving 4 SOL tokens at the recipient address. Through the checkQuote hook a bridge that would cost over $5 in fees would be aborted.

Create a Smart Deposit Address

Smart Deposit Addresses let users bridge by making a simple token transfer — no contract interaction needed.

sda.ts

import { rhinoSdk } from './rhino-sdk'

const sda = await rhinoSdk.api.depositAddresses.create({
  depositChains: ['ETHEREUM', 'ARBITRUM', 'BASE'],
  destinationChain: 'BASE',
  destinationAddress: '0x123...',
})
// Result:
// {
//   depositAddress: '0x457...',
//   depositChain: 'ETHEREUM',
//   destinationChain: 'BASE',
//   destinationAddress: '0x123...',
//   supportedTokens: [{ symbol: 'USDT', address: '0x789...' }],
//   isActive: true,
// }

Once created, anyone can send supported tokens to the deposit address and funds will be automatically bridged to the destination.

sda-status.ts

import { rhinoSdk } from './rhino-sdk'

// Check status of an existing SDA
const status = await rhinoSdk.api.depositAddresses.getStatus({
  depositAddress: '0x457...',
  depositChain: 'ETHEREUM',
})

We recommend generating SDAs on all available EVM chains at once to ensure funds sent to the wrong chain are still detected automatically.

For more details, see the full SDK SDA reference or the API integration guide.

Resources

SDK concepts

Learn about the core concepts of the SDK

Rhino architecture

Learn about the overall architecture of the Rhino bridge

Bridge functions

Learn more on how to use the bridge functions

Chain adapters

Learn how to use chain adapters to connect to all supported chains

Get Started

SDK

Migration guides

Webhook

API Integration

Smart Contracts

Widgets

General information

Quickstart

Install the package

Initialize the SDK

Visit the Rhino.fi Console

Make a bridge

Create a Smart Deposit Address

Resources

SDK concepts

Rhino architecture

Bridge functions

Chain adapters

​Install the package

​Initialize the SDK

Visit the Rhino.fi Console

​Make a bridge

​Create a Smart Deposit Address

​Resources

SDK concepts

Rhino architecture

Bridge functions

Chain adapters

Install the package

Initialize the SDK

Make a bridge

Create a Smart Deposit Address

Resources