> For the complete documentation index, see [llms.txt](https://docs.sat20.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sat20.org/english/readme.md). # Welcome to SAT20 ## SatoshiNet Is the Native Execution Layer for Bitcoin’s Future Value Network SAT20 is a protocol and open-source technology stack around Bitcoin-native assets. SatoshiNet is the open execution network in the SAT20 stack. It does not replace Bitcoin L1. It extends Bitcoin L1 asset facts, user control, and final settlement into a faster, lower-cost, programmable, and automatable execution environment. Our long-term thesis is: **Bitcoin will become the foundation of the future value network, and SatoshiNet will become a core network for carrying services, applications, and AI Agents in that value network.** “Helping BTC communities build, own, and operate their own financial infrastructure” remains an important goal, but it is more accurately a near-term adoption path rather than the final vision. Community DEX, DAO, wallet, Indexer, Explorer, nodes, and Launchpad are the first scenarios for validating SAT20’s native extension path, creating real usage, fee flow, and ecosystem coordination. ## Core Capability Chain and R\&D Directions ``` Indexer ↓ STP ↓ SatoshiNet ↓ Smart Contracts ↓ DKVS ↓ AI Agent Wallet ``` This chain shows the current capability relationship: Indexer provides asset facts; STP provides cross-layer control; SatoshiNet provides the execution network; Smart Contracts provide programmable logic; DKVS provides account and application small-data synchronization; and AI Agent Wallet evolves from SAT20 Wallet into an Agent-facing authorization entry. D-Indexer remains a later R\&D direction rather than a delivered layer in this chain. ## SAT20 in One Paragraph ``` Bitcoin L1 provides asset origin, UTXO facts, final settlement, and dispute boundaries. Indexer provides queryable and reviewable asset facts. STP provides cross-layer asset control, exits, and punishment paths for revoked states. SatoshiNet provides transactions, assets, blocks, contracts, and application execution. Smart Contracts, DKVS, and AI Agent Wallet move SatoshiNet toward a more open value-network service layer. D-Indexer continues as an R&D direction. ``` ## Names and Relationships | Name | Positioning | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SAT20 | Protocol and open-source technology stack around Bitcoin-native assets | | SatoshiNet | Native execution layer for Bitcoin’s future value network | | Indexer | Mainnet asset fact layer for Bitcoin L1 and SatoshiNet | | STP / Transcend | Mainnet cross-layer asset control, exit, and punishment protocol between Bitcoin L1 and SatoshiNet | | SatoshiNet | Mainnet execution network for transactions, assets, blocks, contracts, applications, and services | | Smart Contracts | Programmability layer on SatoshiNet. The framework has been implemented and entered public testnet; current testing includes Agent / Prediction contracts and, under PWA `Tools -> Smart Contracts`, template AMM / limit order plus EVM `ConstantProductAMM` / `LimitOrderBook` samples | | DKVS | Implemented signed small-data storage and synchronization under testnet integration, used for account management, RGB11 backup, mailbox, and application configuration; it is not chain consensus state | | D-Indexer | Distributed L1 Indexer direction still in R\&D; DKVS is one reusable foundation, but the two are not one delivered product | | SAT20 Wallet | Wallet entry with existing browser extension and PWA forms, continuously iterating | | AI Agent Wallet | Agent authorization and operation entry evolving from SAT20 Wallet | | ORDX | Satoshi-denominated asset protocol in the SAT20 stack | | GAS | SatoshiNet-native network fee and security staking asset | ## Why SatoshiNet Exists Bitcoin L1 is well suited for scarce assets, final settlement, and long-term security. It is not designed to carry every high-frequency transaction, complex contract, community governance flow, AI Agent operation, or large-scale application execution. Scaling execution is a natural direction for Bitcoin, but the hard problem is preserving links to Bitcoin L1 asset facts, user control, and exit paths while gaining better execution. SatoshiNet explores an open Bitcoin-native extension path: 1. Assets originate from Bitcoin L1. 2. Asset facts can be traced and verified. 3. Users retain protection and exit paths in abnormal situations. 4. Applications execute in a faster, lower-cost, programmable network. 5. Communities, developers, and third parties can run infrastructure independently instead of permanently depending on SAT20 Labs. 6. AI Agents can understand evidence, explain risk, generate plans, and execute actions without bypassing wallet authorization or holding user private keys. ## From Bitcoin Facts to Agent Wallet ``` Bitcoin L1: Asset origin, UTXO facts, final settlement, and dispute boundary ↓ Indexer: Mainnet asset fact layer ↓ STP: Mainnet cross-layer control, exit, and punishment ↓ SatoshiNet: Mainnet transactions, assets, blocks, and service execution ↓ Smart Contracts: Agent / Prediction contracts on public testnet, plus template AMM / limit order and EVM ConstantProductAMM / LimitOrderBook in PWA tools ↓ DKVS: signed small data, account recovery, mailbox, and application-state coordination ↓ AI Agent Wallet: authorization entry based on SAT20 Wallet ``` D-Indexer is intentionally not shown above as a delivered layer. It remains an R\&D direction for distributed L1 asset facts. ## What You Can Do Now | Capability | Use | Entry | | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | Understand SatoshiNet | Understand why Bitcoin needs native extension, the asset safety model, Indexer, STP, contracts, GAS, and AI Agents | [Learn: Understanding SatoshiNet](/english/learn-understanding-satoshinet/learn.md) | | Community infrastructure | Plan nodes, indexers, explorers, wallets, DEX, DAO, Launchpad, and operations backend for BTC communities | [Community Stack](/english/ecosystem-adoption-path-community-owned-infrastructure/community-stack.md) | | Bring assets into SatoshiNet | Use mainnet Indexer to identify Bitcoin L1 asset facts and mainnet STP to place assets into a user-exitable channel safety boundary | [STP Introduction](/english/learn-understanding-satoshinet/stp.md) | | User flows | Use SAT20 Wallet extension or PWA to enter SatoshiNet, complete swaps, and verify transactions with Explorer | [Use SatoshiNet](/english/use-satoshinet/use.md) | | Test smart contracts | Use PWA Wallet to claim test GAS, deploy or participate in Prediction contract testing | [Prediction Contract Test](/english/use-satoshinet/prediction-contract.md) | | Developer integration | Integrate Indexer, STP, SatoshiNet, Smart Contracts, Wallet SDK, and community DEX / DAO | [Developer Center](/english/developer-center/build.md) | | Network operation | Run Mining Node, Core Node, Indexer, Explorer, RPC, and monitoring | [Run the Network](/english/run-the-network-nodes-and-infrastructure/run.md) | | Network economics | Understand GAS, fee flows, node staking, incentives, and open design questions | [Network Economics](/english/network-economics.md) | | AI Agent operations | Let Agents perform asset safety checks and actions without holding private keys or bypassing wallet authorization | [AI Agent](/english/ai-agent-automation-and-safety/ai.md) | | Ecosystem cooperation | Apply for pilots, contribute tools, provide liquidity, run nodes, or support protocol development | [Ecosystem](/english/ecosystem.md) | ## Choose Your Role | Who You Are | Start Here | | ------------------------------- | ----------------------------------------------------------------------------------- | | I run a BTC community | [Community Path](/english/start-here-choose-your-path/btc-community.md) | | I am a Solidity / EVM developer | [Developer Path](/english/start-here-choose-your-path/developers.md) | | I run infrastructure | [Infrastructure Path](/english/start-here-choose-your-path/infrastructure.md) | | I am a wallet or exchange | [Wallet and Exchange Path](/english/start-here-choose-your-path/wallet-exchange.md) | | I am an AI Agent developer | [AI Agent Path](/english/start-here-choose-your-path/ai-agent-builders.md) | | I want to provide liquidity | [Liquidity Path](/english/start-here-choose-your-path/liquidity.md) | ## Security Is Expressed with Evidence SatoshiNet does not use a centralized custodial bridge as its core cross-layer model. User protection depends on STP channel state, valid commitment transactions, punishment coverage, wallet backup, indexer evidence, and executable Bitcoin L1 paths. Users, wallets, and Agents need to verify: 1. Whether assets are on Bitcoin L1, in an STP channel, in a SatoshiNet user address, or in a contract address. 2. Whether critical transactions can be traced to txid, vout, height, and confirmations. 3. Whether the wallet holds the latest commitment transaction and required backup material. 4. Whether revoked states have punishment coverage. 5. Whether users still have exit or protection paths when a Core Node is offline, refuses service, or behaves maliciously. 6. Whether design-stage capabilities are clearly marked rather than presented as finished products. ## Current Key Status The website and docs use the same status language to express capability boundaries: | Capability | Current Status | Notes | | ----------------------------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Indexer | Implemented · Mainnet | Mainnet asset fact layer for Bitcoin L1 and SatoshiNet assets, transactions, confirmations, and protocol events | | STP | Implemented · Mainnet | STP has been implemented and deployed to mainnet for cross-layer asset control, exit paths, and punishment coverage | | SatoshiNet | Implemented · Mainnet | Mainnet execution network carrying transactions, asset representation, base applications, and services | | Smart Contracts / EVM Runtime / Agent Contracts | Testnet / Iterating | The smart contract framework has been implemented and entered public testnet; current validation includes Agent / Prediction contracts and, under PWA `Tools -> Smart Contracts`, template AMM / limit order plus EVM `ConstantProductAMM` / `LimitOrderBook` samples | | DKVS | Implemented · Testnet / Iterating | Signed records, CAS, subscriptions, FREE\_LOCAL, AUTOPAY propagation, account management, and RGB11 recovery paths are implemented and remain under testnet integration and stability validation | | D-Indexer | R\&D / In Development | Distributed L1 asset-fact networking remains under development; DKVS implementation does not imply that D-Indexer is live | | SAT20 Wallet / AI Agent Wallet | Implemented · Iterating | SAT20 Wallet already exists as browser extension and PWA. AI Agent Wallet continues evolving from that base | | VSN / Long-Term Governance | Design / R\&D | These areas remain under design, experimentation, and validation, and are not presented as finished production capabilities | ## Status and Evidence Docs use consistent status labels: | Status | Meaning | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------- | | Implemented | Code and core flow exist, but this does not automatically imply full production maturity | | Mainnet | The capability is deployed to a mainnet environment. Production maturity is read together with documentation and risk boundaries | | Testnet | Reproducible testnet flow exists | | In Development | Code is being developed; full availability is not promised | | Iterating | The capability exists, but product experience, interfaces, or safety boundaries continue to improve | | Design in Progress | Rules, parameters, or governance are not finalized | | R\&D | Research infrastructure direction that may continue to change | | Experimental | Research feature that may change or be removed | Every status links to code, documentation, demo, Explorer, contract address, test transaction, or validation record as evidence becomes available. ## Official Links * Website: [sat20.org](https://sat20.org) * Documentation: [docs.sat20.org](https://docs.sat20.org) * X: [SAT20Labs](https://x.com/SAT20Labs) * GitHub: [sat20-labs](https://github.com/sat20-labs) This documentation serves users, developers, communities, node operators, wallets, exchanges, AI Agents, infrastructure teams, and strategic partners. The website explains vision, outcomes, opportunities, and action paths. Docs provide protocol facts, implementation details, evidence, and risk boundaries.