Skip to main content

Tokens

The Mina SDK provides token discovery to identify which tokens can be bridged from each chain to HyperEVM.

Overview

Not all tokens on a chain can be bridged to HyperEVM. The SDK provides methods to discover tokens that have valid bridge routes, along with their metadata including prices and logos.

Token Methods

getTokens(chainId)

Fetches all tokens available on a specific chain.

getBridgeableTokens(chainId)

Fetches only tokens that can be bridged to HyperEVM from a specific chain. This is the recommended method for building bridge UIs.
Use getBridgeableTokens() instead of getTokens() when building your bridge UI. This ensures users only see tokens with valid bridge routes.

Response Types

TokensResponse

Both methods return a response with metadata:

Token

Each token object contains:

Native Token Address

The native gas token (ETH, MATIC, etc.) uses a special zero address:

Common Tokens

Source Chain Tokens

Commonly bridged tokens from source chains:

HyperEVM Destination Tokens

Tokens receivable on HyperEVM:

Example: Token Selector

Build a token selector that shows bridgeable tokens with USD values:

Example: Calculate USD Value

Calculate the USD value of a token amount:

Caching Behavior

Token data is cached for 15 minutes:
  • Bridgeable tokens and all tokens are cached separately
  • Stale cache is returned if the API fails
  • Cache can be manually invalidated

Error Handling

Handle token fetch errors gracefully:

Next Steps

Quotes

Get bridge quotes with token amounts

Execution

Execute bridge transactions