Repository navigation
v0.1.0 — first public release
First public release of the OpenSwap CLI — open-source crosschain swaps from your terminal.
npx openswap@latestNoncustodial by design: it finds the route, mints a deposit address, and you pay from any wallet you already trust. No seed phrases, no private keys, no browser extension.
Highlights
- Route discovery across every provider — Chainflip, THORChain, Maya, NEAR, Relay, and more, streamed live so each gets its window.
- Honest fees. A fee we cannot price renders as "not provided", never as zero, and a route with unpriced components can never win the cheapest badge.
- Exact money math — decimal strings and BigInt only, never floats. Base-unit amounts above 2^53 (and above 1e21, where JSON switches to exponent notation) are handled exactly.
- Durable receipts. Close the terminal any time;
openswap resumepicks the swap back up. - Built for agents and bots — every command takes
--jsonwith a versioned envelope and frozen exit codes. SeeAGENT-CONTRACT.md. - Practice safely —
openswap tourwalks a complete swap in 2 minutes, andopenswap test onruns the whole CLI against a simulated backend.
Notes for this release
- Wallet-signed execution is off by default while its transaction validation is hardened. The noncustodial deposit lane — the default — is unaffected. Set
OPENSWAP_ENABLE_SIGNER=1to opt in knowingly. - Use
npx openswap@latestrather than barenpx openswap: npx caches by package name and never expires that cache, so the bare form keeps serving whichever build you first fetched.
Published from CI with Sigstore provenance. Node >= 20.19.