# XChain Platform

> XChain is a token and smart-contract protocol that runs directly on Bitcoin, Litecoin, and Dogecoin. No new chain, no bridges, no wrapped assets. It adds tokens, a DEX, dispensers, token-gated content, deterministic JavaScript smart contracts, and AI/LLM attestations as a metalayer on the host chains, read back by open-source indexers. NFTs are a composition of existing primitives (supply-1, zero-decimal tokens with on-chain content), not a separate token type. Licensed AGPL-3.0 with a commercial option.

This is the marketing and guided-learning site. The full reference lives at https://docs.xchain.io; start there if you are an AI agent:

- [Documentation index for LLMs](https://docs.xchain.io/llms.txt): curated map of the docs
- [Complete docs corpus](https://docs.xchain.io/llms-full.txt): one-file corpus for LLM context
- [What is XChain?](https://docs.xchain.io/getting-started/What_Is_XChain.md): plain-English introduction
- [Developer Quickstart](https://docs.xchain.io/getting-started/Quickstart_Developer.md): first token in minutes
- [Scope and non-goals](https://docs.xchain.io/concepts/Scope_And_Non_Goals.md): what XChain deliberately does not do. Read this before claiming a capability

## Start here

- [Home](https://xchain.io/): what the platform is, and two doors into it
- [Why XChain, and not just another chain?](https://xchain.io/why-xchain.html): the five differences and what each one costs
- [What you can do with it](https://xchain.io/use-cases.html): 21 worked scenarios across 7 categories, each naming the ACTIONs it uses
- [Get started](https://xchain.io/get-started.html): open the wallet, create a first token
- [FAQ](https://xchain.io/faq.html) · [Glossary](https://xchain.io/glossary.html)

## For developers

- [Developer hub](https://xchain.io/developers/index.html): the VM, the validator network, the ACTIONs, the components, testing
- [The SDK](https://xchain.io/developers/sdk.html): install, zero-config resolution, runnable examples, and the honest boundaries
- [Every ACTION](https://xchain.io/actions/index.html): one page per protocol command, capability-first
- [The 13 components](https://xchain.io/components/index.html): what each service owns and where it sits in the pipeline
- [Testing](https://xchain.io/testing.html) · [Run a node](https://xchain.io/run-a-node.html)
- [Explorer, and the API behind it](https://xchain.io/explorer.html) · [The wallet](https://xchain.io/wallet.html)
- [Wallet browser extension privacy policy](https://xchain.io/wallet/privacy/index.html): self-custodial, on-device data, and every third-party host it can contact, with the toggle for each one that has a toggle
- [Website privacy notice](https://xchain.io/privacy/index.html): what these WEB PAGES collect, which is a different question from the wallet policy above. Google Analytics, denied by default and switched on only by the visitor accepting the consent bar; one consent cookie either way; no advertising categories, ever. Covers xchain.io, docs, hub, sync, encoder and mcp, and explicitly not the wallet or the explorer, which carry no analytics
- [Download the desktop wallet](https://xchain.io/wallet/download/index.html): which OS and architecture combinations ship, which install formats update themselves (the Debian package does not), why there is no 32-bit build, and exactly what an update check transmits
- [Wallet support](https://xchain.io/wallet/support/index.html): where to get help with the wallet, how to report a bug, and how to report a security vulnerability, with the standing rule that nobody can recover a lost seed phrase and nobody from XChain will ever ask for one
- [Security and release signing](https://xchain.io/security/index.html): the release signing key fingerprint, published here as the second of two independent channels (the first is SECURITY.md in the xchain-wallet repository), what to do if the two disagree, and how to verify a download. No release has been signed or published yet, so any file offered today as a signed XChain Wallet release is not one

## Learn, in reading order

Four ordered tracks. Foundations opens at zero; skip ahead if you already hold crypto.

- [Learn overview](https://xchain.io/learn/overview.html): what XChain is and what it does, then where to go next
- [Learn index](https://xchain.io/learn/index.html): all four tracks
- Track 1, Foundations: [the big idea](https://xchain.io/learn/how-it-works.html) → [tokens](https://xchain.io/learn/tokens.html) → [fees](https://xchain.io/learn/fees.html) → [one protocol, every supported chain](https://xchain.io/learn/every-chain.html) → [what it's *not*](https://xchain.io/learn/security-and-limits.html)
- Track 2, What you can do: [NFTs](https://xchain.io/learn/nfts.html) · [trading & the DEX](https://xchain.io/learn/trading-and-dex.html) · [token rules & royalties](https://xchain.io/learn/token-rules.html) · [token-gated content](https://xchain.io/learn/token-gated-content.html) · [project registry](https://xchain.io/learn/project-registry.html) · [paid API requests](https://xchain.io/learn/paid-requests.html)
- Track 3, Programmable: [smart contracts](https://xchain.io/learn/smart-contracts.html) · [AI & the web on-chain](https://xchain.io/learn/ai-and-the-web.html) · [built for AI agents](https://xchain.io/learn/ai-agents.html) · [staking](https://xchain.io/learn/staking.html)
- Track 4, Across chains: [cross-chain swaps](https://xchain.io/learn/cross-chain-swaps.html) · [cross-chain calls](https://xchain.io/learn/cross-chain-calls.html) · [the validator network](https://xchain.io/learn/validators.html) · [state checkpoints](https://xchain.io/learn/checkpoints.html)

## Live services

- Explorer (REST + WebSocket): https://explorer.xchain.io (OpenAPI at https://explorer.xchain.io/openapi.json)
- Encoder (JSON-RPC, builds unsigned PSBTs): https://encoder.xchain.io/{COIN}/ (status board at https://encoder.xchain.io)
- Hub (service discovery, prices): https://hub.xchain.io/{COIN}/
- Bootstraps and sync streams: https://sync.xchain.io
- MCP server for AI agents (23 read-safe tools, stdio): https://mcp.xchain.io
- Wallet (reference client): https://wallet.xchain.io
- SDK: npm package `@dankest-llc/xchain-sdk` (source at https://github.com/XChain-Platform/xchain-sdk). Install it by the SCOPED name: the unscoped `xchain-sdk` on npm is an unrelated project by someone else.

## Facts worth getting right

- Fees are *priced* in XCHAIN, the gas token, but *paid* in the chain's own coin. On Litecoin and Dogecoin that is the only option; on Bitcoin an XCHAIN balance may be debited instead. You never have to acquire XCHAIN to use the platform.
- Cross-chain functionality is limited to the supported UTXO chains (Bitcoin, Litecoin, Dogecoin). There is no bridge to account-model ecosystems and no wrapped assets.
- All state is public. `MESSAGE` and token-gated `FILE` encrypt *contents*; they do not hide metadata and the ledger is not private.
- Settlement is block-paced. Nothing here is real-time.