Skip to main content

​
Simple Bridge

This example demonstrates how to execute a basic bridge transaction, moving USDC from Arbitrum to Hyperliquid’s HyperEVM chain.

​
Overview

The simplest bridge flow involves three steps:
  1. Initialize the Mina SDK
  2. Get a quote for the bridge
  3. Execute the bridge with a wallet signer

​
Prerequisites

Before starting, ensure you have:
  • Installed the Mina SDK and viem
  • A wallet with USDC on Arbitrum
  • Basic understanding of TypeScript/JavaScript async patterns

​
Complete Example

import { Mina } from '@siphoyawe/mina-sdk';
import { createWalletClient, http } from 'viem';
import { arbitrum } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

// Step 1: Initialize the SDK
const mina = new Mina({
  integrator: 'my-dapp',
  autoDeposit: true,  // Automatically deposit to Hyperliquid L1
});

// Step 2: Create a viem wallet client (or use your existing wallet)
const account = privateKeyToAccount('0x...');
const walletClient = createWalletClient({
  account,
  chain: arbitrum,
  transport: http(),
});

// Step 3: Create a signer adapter for the SDK
const signer = {
  async sendTransaction(request) {
    const hash = await walletClient.sendTransaction({
      to: request.to as `0x${string}`,
      data: request.data as `0x${string}`,
      value: BigInt(request.value),
      chain: arbitrum,
    });
    return hash;
  },
  async getAddress() {
    return walletClient.account.address;
  },
  async getChainId() {
    return arbitrum.id;
  },
};

async function bridgeUSDC() {
  const walletAddress = walletClient.account.address;

  // Step 4: Get a quote
  const quote = await mina.getQuote({
    fromChainId: 42161,        // Arbitrum
    toChainId: 999,            // HyperEVM
    fromToken: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', // USDC on Arbitrum
    toToken: '0xb88339cb7199b77e23db6e890353e22632ba630f',   // USDC on HyperEVM
    fromAmount: '1000000000',  // 1000 USDC (6 decimals)
    fromAddress: walletAddress,
    slippageTolerance: 0.5,    // 0.5% slippage
  });

  console.log('Quote received:');
  console.log(`  Will receive: ${quote.toAmount} USDC`);
  console.log(`  Estimated time: ${quote.estimatedTime}s`);
  console.log(`  Total fees: $${quote.fees.totalUsd.toFixed(2)}`);

  // Step 5: Execute the bridge with status callbacks
  const result = await mina.execute({
    quote,
    signer,
    onStepChange: (step) => {
      console.log(`Step ${step.step}: ${step.status}`);
      if (step.txHash) {
        console.log(`  Transaction: ${step.txHash}`);
      }
    },
    onStatusChange: (status) => {
      console.log(`Progress: ${status.progress}% - ${status.substatus}`);
    },
  });

  // Step 6: Handle the result
  if (result.status === 'completed') {
    console.log('Bridge successful!');
    console.log(`  Transaction hash: ${result.txHash}`);
    console.log(`  Received: ${result.receivedAmount}`);
    if (result.depositTxHash) {
      console.log(`  Deposited to L1: ${result.depositTxHash}`);
    }
  } else if (result.status === 'failed') {
    console.error('Bridge failed:', result.error?.message);
  }
}

// Run the bridge
bridgeUSDC().catch(console.error);

​
Step-by-Step Breakdown

1

Initialize the SDK

Create a new Mina instance with your integrator name. The autoDeposit option controls whether bridged funds are automatically deposited to your Hyperliquid L1 trading account.
const mina = new Mina({
  integrator: 'my-dapp',
  autoDeposit: true,
});
2

Set up the wallet signer

The SDK requires a signer that implements sendTransaction, getAddress, and getChainId. This example uses viem, but any compatible wallet library works.
const signer = {
  async sendTransaction(request) {
    return await walletClient.sendTransaction({
      to: request.to,
      data: request.data,
      value: BigInt(request.value),
      chain: arbitrum,
    });
  },
  async getAddress() {
    return walletClient.account.address;
  },
  async getChainId() {
    return arbitrum.id;
  },
};
3

Get a bridge quote

Request a quote specifying the source chain, destination chain, tokens, and amount. The quote includes estimated output, fees, and execution time.
const quote = await mina.getQuote({
  fromChainId: 42161,        // Arbitrum
  toChainId: 999,            // HyperEVM
  fromToken: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
  toToken: '0xb88339cb7199b77e23db6e890353e22632ba630f',
  fromAmount: '1000000000',  // 1000 USDC
  fromAddress: walletAddress,
  slippageTolerance: 0.5,    // 0.5%
});
4

Execute the bridge

Execute the quote with the signer. Use callbacks to track progress in real-time.
const result = await mina.execute({
  quote,
  signer,
  onStepChange: (step) => {
    console.log(`Step: ${step.step} - Status: ${step.status}`);
  },
  onStatusChange: (status) => {
    console.log(`Progress: ${status.progress}%`);
  },
});
5

Handle the result

Check the execution result and handle success or failure appropriately.
if (result.status === 'completed') {
  console.log('Success! TxHash:', result.txHash);
} else {
  console.error('Failed:', result.error?.message);
}

​
Status Callbacks

The execute method accepts two callback functions for monitoring progress:

​
onStepChange

Called when individual steps (approval, swap, bridge, deposit) change status. 
interface StepStatusPayload {
  stepId: string;
  step: 'approval' | 'swap' | 'bridge' | 'deposit';
  status: 'pending' | 'active' | 'completed' | 'failed';
  txHash: string | null;
  error: Error | null;
  timestamp: number;
}

​
onStatusChange

Called when the overall transaction status changes. 
interface TransactionStatusPayload {
  status: 'pending' | 'in_progress' | 'completed' | 'failed';
  substatus: string;
  currentStep: number;
  totalSteps: number;
  progress: number;  // 0-100
  estimatedTime: number;
  txHash: string;
  receivingTxHash: string | null;
}

​
Common Token Addresses

ChainTokenAddress
ArbitrumUSDC0xaf88d065e77c8cC2239327C5EDb3A432268e5831
EthereumUSDC0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
OptimismUSDC0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85
BaseUSDC0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
HyperEVMUSDC0xb88339cb7199b77e23db6e890353e22632ba630f
Always verify token addresses before executing transactions. The SDK’s getTokens() method returns verified token addresses for each chain.

​
Next Steps

Token Selection

Build a UI for selecting chains and tokens

Quote Display

Display detailed quote information

Error Handling

Handle errors gracefully

Full Integration

Complete bridge widget example