Skip to main content

Configuration

The Mina SDK is configured through the MinaConfig object passed to the constructor.

Basic Configuration

Configuration Options

Configuration Details

integrator (Required)

A unique identifier for your application. This is used for analytics and tracking.
Choose a descriptive, unique integrator name. This helps with debugging and analytics.

autoDeposit

Controls whether bridged USDC is automatically deposited to your Hyperliquid L1 trading account.
When autoDeposit is enabled, the SDK will:
  1. Detect USDC arrival on HyperEVM
  2. Approve USDC for the deposit contract
  3. Execute the deposit transaction
  4. Wait for L1 confirmation

defaultSlippage

The default slippage tolerance for quotes. Expressed as a decimal (0.005 = 0.5%).
Slippage Constraints:
Setting slippage too low may cause transactions to fail. Setting it too high may result in unfavorable rates.

rpcUrls

Provide custom RPC URLs for specific chains. Useful for private RPCs or when default RPCs are unreliable.

Complete Configuration Example

Per-Request Configuration

Some options can be overridden per request:

Slippage Override

Route Preference

Environment-Based Configuration

A common pattern for managing configuration across environments:

React Configuration

When using React, pass the configuration to the provider:

Next Steps

Chains

Learn about supported chains

Slippage

Deep dive into slippage settings