Evalanche — Multi-EVM Agent Wallet

Headless wallet SDK with ERC-8004 identity, x402 payments, Li.Fi cross-chain liquidity (bridging + DEX aggregation + DeFi Composer), Gas.zip gas funding, dYdX v4 perpetuals, CoinGecko market intelligence, Polymarket market discovery and execution, contract interaction helpers (approve-and-call + UUPS upgrade), and DeFi operations (liquid staking + EIP-4626 vaults). Works on 22+ EVM chains. Works as CLI or MCP server.

Source: https://github.com/iJaack/evalanche License: MIT

Supported Chains

Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Robinhood Chain, Fantom, Gnosis, zkSync Era, Linea, Scroll, Blast, Mantle, Celo, Moonbeam, Cronos, Berachain, + testnets (Fuji, Sepolia, Base Sepolia).

Routescan RPCs preferred where available, with public fallback RPCs.

Security Model

Key Storage & Encryption

Evalanche.boot() manages keys autonomously with encrypted-at-rest storage:

1. First run: Generates a BIP-39 mnemonic via ethers.HDNodeWallet.createRandom()
2. Encryption: AES-128-CTR + scrypt KDF (geth-compatible keystore format)
3. Password derivation: 32-byte random entropy file via crypto.randomBytes(32)
4. File permissions: chmod 0o600 (owner read/write only)
5. Storage location: ~/.evalanche/keys/ by default

MCP Server Access Controls

• Stdio mode (default): stdin/stdout only. No network exposure.
• HTTP mode (--http): localhost:3402 by default and requires EVALANCHE_MCP_HTTP_TOKEN (or startHTTP({ authToken })). Do not expose publicly without additional network controls.

OpenClaw External Secrets (Preferred when available)

Priority: OpenClaw secrets → raw env vars → encrypted keystore.

Polymarket CLI

Authenticated Polymarket MCP tools use the official polymarket CLI. Production agents should pin the binary path with EVALANCHE_POLYMARKET_CLI_BIN; otherwise Evalanche resolves polymarket from PATH. Signer material is passed through the child process environment and never through CLI arguments.

Setup

1. Install

npm install -g evalanche

2. Boot on any chain

import { Evalanche } from 'evalanche';

// Base
const { agent } = await Evalanche.boot({ network: 'base' });

// Ethereum
const { agent: eth } = await Evalanche.boot({ network: 'ethereum' });

// Arbitrum
const { agent: arb } = await Avalanche.boot({ network: 'arbitrum' });

// Avalanche (with identity)
const { agent: avax } = await Evalanche.boot({
  network: 'avalanche',
  identity: { agentId: '1599' },
});

3. Run as MCP server

AVALANCHE_NETWORK=base evalanche-mcp

Available Tools (MCP)

Wallet

Tool	Description
get_address	Get agent wallet address
get_balance	Get native token balance
sign_message	Sign arbitrary message
send_avax	Send native tokens
call_contract	Call a contract method

Identity (ERC-8004)

Tool	Description
resolve_identity	Resolve agent identity + reputation
resolve_agent	Look up any agent by ID

Payments (x402)

Tool	Description
pay_and_fetch	x402 payment-gated HTTP request

Reputation

Tool	Description
submit_feedback	Submit on-chain reputation feedback

Network & Chains

Tool	Description
get_network	Get current network config
get_supported_chains	List all 22+ supported chains
get_chain_info	Get details for a specific chain
switch_network	Switch to different EVM chain

Arena DEX (Avalanche)

Tool	Description
arena_buy	Buy Arena community tokens via bonding curve (spends $ARENA)
arena_sell	Sell Arena community tokens for $ARENA
arena_token_info	Get token info (fees, curve params) by address
arena_buy_cost	Calculate $ARENA cost for a given buy amount (read-only)

Polymarket (Polygon)

Tool	Description
pm_search	Search active Polymarket markets by keyword
pm_market	Get market details and outcome tokens by condition ID
pm_positions	Get Polymarket positions for a wallet
pm_orderbook	Get the order book for an outcome token
pm_balances	Get normalized collateral and outcome-token balances
pm_order	Get venue-truth order status and reconciliation
pm_cancel_order	Cancel an open Polymarket order
pm_open_orders	List open Polymarket orders
pm_trades	List recent Polymarket venue trades
pm_approve	Approve collateral spending for Polymarket on Polygon
pm_preflight	Run deterministic buy/sell/limit-sell preflight checks
pm_buy	Buy YES/NO shares with market or limit orders
pm_sell	Slippage-protected immediate YES/NO sell toward a target USDC proceeds amount
pm_limit_sell	Post or take a YES/NO limit sell depending on postOnly
pm_reconcile	Reconcile balances, positions, orders, and trades against venue truth
pm_withdraw	Withdraw Polygon USDC.e from the Polymarket wallet through the official Polymarket bridge
pm_redeem	Redeem winning positions from a resolved Polymarket market for USDC via the CTF contract

Contract Interaction Helpers (v0.9.0)

Tool	Description
approve_and_call	Approve ERC-20 spending, then execute a follow-up contract call
upgrade_proxy	Upgrade a UUPS proxy via upgradeToAndCall

Bridging & Cross-Chain

Tool	Description
get_bridge_quote	Get cross-chain bridge quote (Li.Fi)
get_bridge_routes	Get all bridge route options
bridge_tokens	Bridge tokens between chains
check_bridge_status	Poll cross-chain transfer status (PENDING/DONE/FAILED)
fund_destination_gas	Fund gas via Gas.zip

Li.Fi Liquidity SDK (v0.8.0)

Tool	Description
lifi_swap_quote	Get same-chain DEX swap quote (31+ aggregators)
lifi_swap	Execute same-chain DEX swap
lifi_get_tokens	List tokens with prices on specified chains
lifi_get_token	Get specific token info (symbol, decimals, priceUSD)
lifi_get_chains	List all Li.Fi supported chains
lifi_get_tools	List available bridges and DEX aggregators
lifi_gas_prices	Get gas prices across all chains
lifi_gas_suggestion	Get gas suggestion for a specific chain
lifi_get_connections	Discover possible transfer paths between chains
lifi_compose	Cross-chain DeFi Composer (bridge + deposit into Morpho/Aave/Pendle/Lido/etc in one tx)

lifi_swap and lifi_compose return execution envelopes with request, submission, verification, and warnings.

Platform CLI (requires platform-cli binary — go install github.com/ava-labs/platform-cli@latest)

Tool	Description
platform_cli_available	Check if platform-cli is installed
subnet_create	Create a new Avalanche subnet
subnet_convert_l1	Convert subnet to L1 blockchain
subnet_transfer_ownership	Transfer subnet ownership
add_validator	Add validator with BLS keys to Primary Network
l1_register_validator	Register a new L1 validator
l1_add_balance	Add balance to L1 validator
l1_disable_validator	Disable an L1 validator
node_info	Get NodeID + BLS keys from running node
pchain_send	Send AVAX on P-Chain (P→P)

dYdX v4 Perpetuals (v0.7.0 — requires mnemonic)

Tool	Description
dydx_get_markets	List all dYdX perpetual markets with prices/leverage
dydx_has_market	Check if a specific perp market exists (e.g. AKT-USD)
dydx_get_balance	Get USDC equity on dYdX subaccount
dydx_get_positions	Get all open perpetual positions
dydx_place_market_order	Place a market order (BUY/SELL)
dydx_place_limit_order	Place a limit order
dydx_cancel_order	Cancel an open order
dydx_close_position	Close position with reduce-only market order
dydx_get_orders	List orders (optionally filter by status)
hyperliquid_get_markets	List Hyperliquid perpetual markets
hyperliquid_get_account_state	Get Hyperliquid account summary
hyperliquid_get_positions	Get Hyperliquid open positions
hyperliquid_place_market_order	Place Hyperliquid market order
hyperliquid_place_limit_order	Place Hyperliquid limit order
hyperliquid_cancel_order	Cancel Hyperliquid order
hyperliquid_close_position	Close Hyperliquid position
hyperliquid_get_order	Get Hyperliquid order status
hyperliquid_get_orders	List Hyperliquid open orders
hyperliquid_get_trades	List Hyperliquid recent fills
find_perp_market	Search for a market across all connected perp venues

Programmatic Usage

Check balance on Base

node -e "
const { Evalanche } = require('evalanche');
const agent = new Evalanche({ privateKey: process.env.AGENT_PRIVATE_KEY, network: 'base' });
agent.provider.getBalance(agent.address).then(b => {
  const { formatEther } = require('ethers');
  console.log(formatEther(b) + ' ETH');
});
"

Bridge tokens (Ethereum → Arbitrum)

node -e "
const { Evalanche } = require('evalanche');
const agent = new Evalanche({ privateKey: process.env.AGENT_PRIVATE_KEY, network: 'ethereum' });
agent.bridgeTokens({
  fromChainId: 1, toChainId: 42161,
  fromToken: '0x0000000000000000000000000000000000000000',
  toToken: '0x0000000000000000000000000000000000000000',
  fromAmount: '0.1', fromAddress: agent.address,
}).then(r => console.log('tx:', r.txHash));
"

Same-chain DEX swap (ETH → USDC on Base)

node -e "
const { Evalanche } = require('evalanche');
const agent = new Evalanche({ privateKey: process.env.AGENT_PRIVATE_KEY, network: 'base' });
agent.swap({
  fromChainId: 8453, toChainId: 8453,
  fromToken: '0x0000000000000000000000000000000000000000',
  toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
  fromAmount: '0.05', fromAddress: agent.address,
}).then(r => console.log('swap tx:', r.txHash));
"

Track bridge transfer status

node -e "
const { Evalanche } = require('evalanche');
const agent = new Evalanche({ privateKey: process.env.AGENT_PRIVATE_KEY, network: 'ethereum' });
agent.checkBridgeStatus({ txHash: '0x...', fromChainId: 1, toChainId: 8453 })
  .then(s => console.log(s.status, s.substatus));
"

Token discovery

node -e "
const { Evalanche } = require('evalanche');
const agent = new Evalanche({ privateKey: process.env.AGENT_PRIVATE_KEY, network: 'base' });
agent.getToken(8453, '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913')
  .then(t => console.log(t.symbol, t.priceUSD));
"

Cross-chain transfer on Avalanche (requires mnemonic)

node -e "
const { Evalanche } = require('evalanche');
const agent = new Evalanche({ mnemonic: process.env.AGENT_MNEMONIC, multiVM: true });
agent.transfer({ from: 'C', to: 'P', amount: '25' })
  .then(r => console.log('export:', r.exportTxId, 'import:', r.importTxId));
"

Key Concepts

ERC-8004 Agent Identity (Avalanche only)

• On-chain agent identity registry on Avalanche C-Chain
• Agent ID → tokenURI, owner, reputation score (0-100), trust level
• Trust levels: high (≥75), medium (≥40), low (<40)

Li.Fi Cross-Chain Liquidity (v0.8.0)

• Bridging: Aggregated routes across 27+ bridges (Across, Stargate, Hop, etc.)
• DEX Aggregation: Same-chain swaps via 31+ DEX aggregators (1inch, Paraswap, Jupiter, etc.)
• DeFi Composer: One-tx cross-chain DeFi (bridge + deposit into Morpho, Aave V3, Euler, Pendle, Lido wstETH, EtherFi, etc.)
• Status Tracking: Poll transfer status (PENDING → DONE/FAILED with substatus)
• Token Discovery: List/lookup tokens with prices across all chains
• Gas Pricing: Gas prices and suggestions per chain
• Uses Li.Fi REST API (no SDK dependency needed)

Gas.zip

• Cheap cross-chain gas funding
• Send gas to any destination chain via deposit addresses

x402 Payment Protocol

• HTTP 402 Payment Required → parse requirements → sign payment → retry
• maxPayment prevents overspending

Multi-VM (Avalanche X-Chain, P-Chain)

• Requires mnemonic and network: 'avalanche' or 'fuji'
• C-Chain: EVM (ethers v6), X-Chain: AVM (UTXO), P-Chain: PVM (staking)

Contracts

Contract	Address	Chain
Identity Registry	0x8004A169FB4a3325136EB29fA0ceB6D2e539a432	AVAX C-Chain (43114)
Reputation Registry	0x8004BAa17C55a88189AE136b182e5fdA19dE9b63	AVAX C-Chain (43114)
sAVAX (Benqi)	0x2b2C81e08f1Af8835a78Bb2A90AE924ACE0eA4bE	AVAX C-Chain (43114)
yoUSD Vault	0x0000000f2eb9f69274678c76222b35eec7588a65	Base (8453)

DeFi — Liquid Staking & EIP-4626 Vaults (v1.2.0)

const { agent } = await Evalanche.boot({ network: 'avalanche' });
const { staking, vaults } = agent.defi();

// sAVAX unstake (instant if pool available, delayed otherwise)
const q = await staking.sAvaxUnstakeQuote('5');
// { avaxOut, isInstant, poolBalance, minOutput }
await staking.sAvaxUnstakeInstant('5');   // redeemInstant on Benqi
await staking.sAvaxUnstakeDelayed('5');   // requestRedeem (no pool needed)

// Stake AVAX → sAVAX
await staking.sAvaxStake('10', 50);  // 50bps slippage

// EIP-4626 vault deposit (any chain)
const YOUSD = '0x0000000f2eb9f69274678c76222b35eec7588a65';
const baseAgent = new Evalanche({ privateKey: '0x...', network: 'base' });
const { vaults: baseVaults } = baseAgent.defi();
const info = await baseVaults.vaultInfo(YOUSD);
// { assetDecimals: 6, shareDecimals: 18, ... }
await baseVaults.deposit(YOUSD, '1000');   // approve + deposit
await baseVaults.withdraw(YOUSD, '998');   // redeem shares

MCP tools (defi): savax_stake_quote, savax_stake, savax_unstake_quote, savax_unstake, vault_info, vault_deposit_quote, vault_deposit, vault_withdraw_quote, vault_withdraw

Known DeFi routing behavior:

• yoUSD auto-routes to Base
• sAVAX auto-routes to Avalanche
• explicit wrong-chain overrides fail clearly before contract reads
• interoperable address inputs like 0x...@base are accepted for address-based DeFi tools

Live Smoke Checklist

Use docs/live-smoke-checklist.md as the release-certification runbook for:

• Polymarket tiny write + reconciliation
• Hyperliquid tiny trade + order verification
• LI.FI tiny swap/bridge execution + tx verification
• sAVAX / EIP-4626 tiny round-trip + balance/share verification

v1.13.0 execution reliability

• A vault position can have verified shares but no underlyingValue when conversion fails. Honor the scan warning and medium confidence; never substitute shares for assets.
• The dYdX SDK is optional. An installation made with --omit=optional must add @dydxprotocol/v4-client-js before using dYdX.
• Zero high/critical audit counts require the shipped security-overrides.json recipe at the consumer root. Plain installs still inherit upstream advisories; audit the resolved tree.
• A2A task execution is not shipped. Existing agent-card identity support does not authorize or expose remote wallet actions.