Skip to main content

​
Mina SDK

The Mina SDK is a TypeScript-first cross-chain bridge SDK that enables seamless bridging of assets from over 40 blockchain networks directly to Hyperliquid. With built-in auto-deposit functionality, bridged USDC is automatically deposited to your trading account on Hyperliquid L1.

​
Features

40+ Supported Chains

Bridge from Ethereum, Arbitrum, Optimism, Base, Polygon, Avalanche, BSC, and many more chains to HyperEVM.

Auto-Deposit to L1

Bridged USDC is automatically detected and deposited to your Hyperliquid L1 trading account.

Smart Route Optimization

Intelligent routing finds the best bridge path based on speed, cost, or a balanced recommendation.

React Integration

First-class React support with hooks for quotes, balances, and transaction status tracking.

​
How It Works

The Mina SDK simplifies the complex process of cross-chain bridging and depositing to Hyperliquid into a single, streamlined flow.
1

Get a Quote

Request a bridge quote specifying source chain, destination (HyperEVM), tokens, and amount. The SDK finds optimal routes across integrated bridge protocols.
2

Approve Tokens

If needed, the SDK prompts for token approval. This is a one-time operation per token per chain.
3

Execute Bridge

Sign and submit the bridge transaction. The SDK handles all the complexity of cross-chain messaging.
4

Detect USDC Arrival

The SDK monitors HyperEVM for your USDC arrival, polling the balance until the bridge completes.
5

Auto-Deposit to L1

Once USDC arrives on HyperEVM, the SDK automatically approves and executes the deposit to Hyperliquid L1.
6

Confirmation

The SDK confirms the deposit is reflected in your Hyperliquid L1 trading balance.

​
Architecture Overview

Your Application
       |
       v
+------------------+
|    Mina SDK      |
+------------------+
       |
       +---> Chain Service (discover chains)
       |
       +---> Token Service (discover tokens)
       |
       +---> Quote Service (get bridge quotes via LiFi)
       |
       +---> Execute Service (submit bridge transactions)
       |
       +---> Deposit Service (auto-deposit to Hyperliquid L1)
       |
       v
+------------------+
|    HyperEVM      |  <-- USDC arrives here
+------------------+
       |
       v
+------------------+
| Hyperliquid L1   |  <-- USDC deposited to trading account
+------------------+

Installation

Install the SDK with npm, yarn, pnpm, or bun

Quick Start

Bridge your first transaction in 5 minutes

API Reference

Complete API documentation for all methods

React Hooks

Use the SDK with React hooks and providers

​
Requirements

  • Node.js 18+ or modern browser with ES2020 support
  • TypeScript 5.0+ (optional, but recommended)
  • viem ^2.0.0 - Required for Ethereum interactions
  • react ^18.0.0 - Required only for React hooks
  • Any EVM-compatible wallet (MetaMask, WalletConnect, Coinbase Wallet, etc.)
  • Sufficient native token balance for gas on the source chain

​
Package Information

PropertyValue
Package Name@siphoyawe/mina-sdk
Latest Version1.0.0
Bundle Size~45KB (minified + gzipped)
LicenseMIT
TypeScriptFull type definitions included
Tree-ShakeableYes

​
Supported Chains

The SDK supports bridging from 40+ chains to HyperEVM (Chain ID: 999). Some of the most popular source chains include:
ChainChain IDNative Token
Ethereum1ETH
Arbitrum42161ETH
Optimism10ETH
Base8453ETH
Polygon137MATIC
Avalanche43114AVAX
BSC56BNB
HyperEVM (destination)999ETH
Use mina.getChains() to fetch the complete list of supported chains at runtime.

​
Next Steps

Ready to get started? Install the SDK and bridge your first transaction.

Install the SDK

Get the SDK installed in your project

Quick Start Guide

Follow our 5-minute quick start guide