AtomX-Bitcoin

AtomX-Bitcoin / AtomX

Public

AtomX – Open‑source reference implementation of trustless Bitcoin ↔ Litecoin atomic swaps using HTLCs on native Segwit (P2WSH). TypeScript monorepo with core library, CLI (simulate / walk / relay), and WebSocket GUI. No custodial bridge, no wrapped assets.

atomic-swap bitcoin bitcoinjs-lib cli corss-chain
23
151
69% credibility
Found May 22, 2026 at 23 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

AtomX is an open-source educational project that demonstrates how Bitcoin and Litecoin can be swapped directly between two people using smart contracts called Hash Time-Locked Contracts (HTLCs). It provides simulation tools so you can safely experiment with the swap process without touching real money, a command-line interface to run demonstrations, and a web-based coordination app where two people can share swap plans. The project is explicitly designed as a reference implementation to teach how trustless cross-chain swaps work - no custodial bridge, no wrapped tokens, just cryptographic rules that ensure both parties either complete the exchange or get their funds back via timeout refunds.

How It Works

1
🔍 Discovering the Project

You hear about AtomX - a tool that lets people swap Bitcoin and Litecoin directly without needing a centralized exchange.

2
📦 Installing the Tools

You download and set up AtomX on your computer, getting three tools: a core engine, a command-line interface, and a web-based coordination app.

3
🎭 Running the Simulation

You watch a complete atomic swap unfold in a safe test environment - Alice locks her Bitcoin, Bob locks his Litecoin, Alice claims Bob's coins (revealing a secret), and Bob claims Alice's coins using that secret.

4
📚 Understanding the Mechanics

You explore the step-by-step walkthrough that explains how Hash Time-Locked Contracts work - smart contracts that automatically release funds when the right secret is revealed.

5
Choosing Your Path
🌐
Web App Path

Open two browser tabs, connect to the coordination server, share plans with your peer, and exchange lock parameters safely.

📋
Plan-Only Path

Generate swap parameters (addresses, timeouts, secret hash) to study how the coordination would work without actually running it.

6
🔐 Seeing the Safety Features

You notice built-in protections: if something goes wrong, there's a timeout refund path, and the system ensures one blockchain's refund activates before the other's.

✅ Understanding Trustless Swaps

You've learned how two people can exchange different cryptocurrencies directly - no middleman, no wrapped tokens, just cryptographic guarantees that either both succeed or both fail.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 23 to 23 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is AtomX?

AtomX is a reference implementation for trustless Bitcoin-Litecoin atomic swaps using Hash Time-Locked Contracts on native Segwit outputs. It is built in TypeScript as a monorepo containing a core library for HTLC script construction, a CLI for running simulations and coordinating swaps, and a WebSocket-based GUI for browser-based coordination. The system handles the full atomic swap lifecycle: HTLC address generation, PSBT transaction finalization for both redeem and CLTV refund paths, and cross-chain parameter planning that enforces the critical safety invariant where Litecoin's refund timelock must expire before Bitcoin's.

Why is it gaining traction?

The project addresses a real need for trust-minimized cross-chain interoperability without custodial bridges or wrapped assets. Developers appreciate that it runs entirely in-memory simulations for Bitcoin and Litecoin regtest, meaning you can experiment with the full atomic swap flow without running nodes. The CLI provides multiple entry points: simulate for end-to-end smoke tests, walk for step-by-step explanations, and relay for WebSocket coordination between peers. The GUI lets you open two browser tabs, generate demo plans, and exchange HTLC parameters over a shared session.

Who should use this?

Cryptocurrency protocol developers learning HTLC mechanics should start here. Builders integrating Bitcoin-Litecoin liquidity swaps into custody solutions will find the simulator useful for testing without mainnet risk. Educators teaching atomic swap concepts can use the walk command and GUI to demonstrate the preimage reveal flow interactively.

Verdict

AtomX is a well-structured educational reference that demonstrates correct HTLC implementation patterns, but with only 23 stars and a credibility score of 0.699999988079071%, it remains early-stage and unaudited for production use. The documentation is thorough and the simulator provides genuine value for learning, but anyone considering mainnet deployment should conduct independent security review first.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.