Skip to content

iJaack/evalanche

Repository files navigation

Evalanche

Avalanche-first agent wallet and execution SDK for AI agents, with multi-EVM support for holdings, payments, DeFi, bridge flows, prediction markets, and perpetuals.

Current Release

  • Latest release: v1.11.0
  • Published package: evalanche@1.11.0
  • Current package surface:
    • Replaces the Polymarket SDK execution path with the official polymarket CLI for authenticated venue operations.
    • Routes the MCP Polymarket wallet tools through a hardened CLI adapter that uses execFile, forces JSON output, avoids argv secrets, redacts signer material, and fails closed on malformed CLI output.
    • Removes @polymarket/clob-client, @polymarket/clob-client-v2, and the local Polymarket client type shim from the package dependency surface.
    • Removes hidden raw/diagnostic Polymarket write paths so production agents use the advertised preflight, execution, and reconciliation tools.
  • Docs:

Install

npm install evalanche

Polymarket authenticated actions use the official polymarket CLI. Install it on production agents and keep it on a pinned path, or set EVALANCHE_POLYMARKET_CLI_BIN=/absolute/path/to/polymarket. Evalanche passes signer material through POLYMARKET_PRIVATE_KEY in the child process environment and never through CLI argv.

Quick Start

import { Evalanche } from 'evalanche';

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

console.log(agent.address);

const holdings = await agent.holdings().scan();
console.log(holdings.summary);

MCP

npx evalanche-mcp

Evalanche ships an MCP server for wallet actions, holdings discovery, DeFi, bridge and swap flows, Polymarket, and perpetual venues. The default MCP transport is stdio. HTTP mode is available for local automation, but requires an explicit bearer token:

EVALANCHE_MCP_HTTP_TOKEN="$(openssl rand -hex 32)" npx evalanche-mcp --http --port 3402

What It Does

  • Avalanche-first wallet boot, identity, and agent execution flows
  • Unified holdings discovery across wallet balances, DeFi positions, prediction positions, and perp venues
  • Cross-chain bridge, swap, and gas-funding flows
  • Avalanche and multi-EVM DeFi actions
  • Polymarket market reads plus official-CLI-backed execution
  • Perpetual trading support for Hyperliquid and dYdX

Also Works Across EVM

Avalanche is the primary path, but Evalanche also supports Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, and other EVM networks for execution and holdings discovery.

Docs

Website

The public site for evalanche.xyz lives in website/. It is deployed separately from the npm package and is not included in the published package tarball. Git-based Vercel deploys use vercel.json plus build-website.mjs to publish only the website assets, not the SDK build.

License

MIT

About

Agent wallet SDK for Avalanche with onchain identity (ERC-8004) and payment rails (x402)

Resources

License

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors