XChain is an open token protocol that runs directly on Bitcoin, Litecoin, and Dogecoin. It encodes a compact set of ACTIONs into ordinary on-chain transactions, then indexes them into a deterministic, replayable ledger: tokens, transfers, a built-in DEX, dispensers, smart contracts, cross-chain calls, and more, secured by the base chains themselves rather than a new one.
- Website: XChain Platform
- Documentation: XChain Platform documentation
- Block explorer: XChain block explorer
- Wallet: XChain Wallet
Coin node (bitcoind / litecoind / dogecoind)
-> utxo-tracker (UTXO + balance queries)
-> encoder (builds the PSBT you sign and broadcast)
-> coin node (your transaction is mined)
-> decoder (reads blocks, decodes XChain ACTIONs)
-> indexer (applies ACTION logic, writes the ledger)
-> explorer (REST + JSON-RPC + web UI over the ledger)
hub (config oracle and cross-chain coordinator)
| Repo | What it does |
|---|---|
| xchain-node | One-command installer and manager for the whole stack |
| xchain-encoder | Builds unsigned PSBTs that embed XChain ACTIONs |
| xchain-decoder | Decodes XChain transactions from the chain into a database |
| xchain-indexer | Applies ACTION logic and writes the deterministic ledger |
| xchain-explorer | REST + JSON-RPC API and web block explorer |
| xchain-hub | Config oracle, price feeds, and cross-chain coordination |
| xchain-utxo-tracker | Indexes UTXOs and serves balance queries |
| xchain-sync | Replicates the ledger to validators |
| xchain-vm | Deterministic smart-contract execution engine |
| xchain-sdk | Developer SDK for building XChain ACTIONs |
| xchain-wallet | Self-custodial multi-chain wallet (web, extension, desktop) |
| xchain-contracts | Smart-contract template library and scaffolding CLI |
| xchain-documentation | The protocol specification |
- See what it is: the XChain Platform site.
- Use the platform: the Getting Started guide.
- Build on it: the Developer Guide and the API Reference.
- Run a node: xchain-node.
Found a vulnerability? Please do not open a public issue. Use GitHub Private
Vulnerability Reporting on the affected repository, or email
security@dankest.llc. Each repository carries its own SECURITY.md with
scope and response details.
Contributions are welcome. See the CONTRIBUTING.md in each repository. The
organization-wide Code of Conduct applies to every repo; the canonical Code of
Conduct and the MAINTAINERS.md ownership and escalation list live in the
xchain-documentation
repository.
XChain Platform is dual-licensed: the GNU Affero General Public License v3.0 (AGPL-3.0-or-later) for everyone, and a commercial license for organizations that need to keep modifications private. "XChain" is a trademark of Dankest, LLC.