@bundie/evm-sdk

Prepare-only TypeScript SDK for the Bundie protocol on EVM chains. Embed it in agent backends, automated workflows, or any service that needs to compose Bundie operations without an LLM in the loop.

Status: 0.1.0 scaffold. Public API and registries are stable; calldata encoders for the write entry points are stubbed and throw "not implemented".

Install

npm install @bundie/evm-sdk

What you get

• DEPLOYMENTS, getDeployment(chainId), listChains() — typed contract address registry for every chain Bundie targets (Scroll, Base, Arbitrum, Avalanche, Optimism today).
• ALL_STRATEGIES, getStrategies(filter), getStrategyBySymbol(symbol) — the cross-chain strategy registry, sourced from the SynthOS contracts repo.
• PreparedTx type — the unsigned-tx envelope every write entry point returns (chainId, to, value, data, optional gas, metadata).
• prepareCreateAccount, prepareDeposit, prepareWithdraw, prepareBridge, prepareApprove — write entry points (stubbed in 0.1.0).

Example

import { getStrategies, getDeployment, prepareDeposit } from "@bundie/evm-sdk";

// Read state from the registry.
const baseStrategies = getStrategies({ sourceChain: 534352, destinationChain: 8453 });
const scroll = getDeployment(534352);
console.log(scroll.accountManager);

// Build an unsigned tx (will throw "not implemented" until 0.2.0).
const tx = await prepareDeposit({
  chainId: 534352,
  payer: "0xYourEOA",
  strategySymbol: "YEARN_yvUSDC-H_8453",
  asset: "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
  amount: "1000000",
});
// tx is a PreparedTx envelope; sign and broadcast with viem / ethers / Privy / Safe.

Design

The SDK never reads or holds a private key. Every write entry point returns a PreparedTx; signing is the caller's job. This keeps the SDK safe to run in any backend, CI pipeline, or multi-sig flow without granting key access.

For a CLI wrapper around this SDK, see @bundie/evm-cli. For the Solana sister implementation, see @bundie/sol-cli.

License

MIT