# XYO Docs ## XYO Docs - [Overview](https://docs.xyo.network/introduction/readme.md) - [Glossary](https://docs.xyo.network/introduction/readme-1.md) - [XYO Papers](https://docs.xyo.network/introduction/xyo-papers.md) - [What is XYO?](https://docs.xyo.network/about-xyo/what-is-xyo.md) - [XYO 101](https://docs.xyo.network/about-xyo/xyo-101.md): Data is meant to be easy. With XYO, it is. - [The XYO Ecosystem](https://docs.xyo.network/about-xyo/xyo-101/the-xyo-ecosystem.md) - [What is DePIN?](https://docs.xyo.network/about-xyo/xyo-101/the-xyo-ecosystem/what-is-depin.md): And why does it matter? - [What is XYO Layer One?](https://docs.xyo.network/about-xyo/xyo-101/the-xyo-ecosystem/what-is-xyo-layer-one.md): And why does it matter? - [What is COIN?](https://docs.xyo.network/about-xyo/xyo-101/the-xyo-ecosystem/off-chain-data-producers.md) - [XYO Layer One](https://docs.xyo.network/about-xyo/xyo-101/xyo-layer-one.md) - [What is Blockchain Bloat?](https://docs.xyo.network/about-xyo/xyo-101/xyo-layer-one/what-is-blockchain-bloat.md) - [XYO Layer One](https://docs.xyo.network/about-xyo/xyo-101/xyo-layer-one/xyo-layer-one.md): And why does it matter? - [Two Tokens, One Ecosystem](https://docs.xyo.network/about-xyo/xyo-101/xyo-layer-one/off-chain-data-producers.md) - [Build, Operate & Scale with XYO](https://docs.xyo.network/about-xyo/xyo-101/build-operate-and-scale-with-xyo.md) - [XYO Cheatsheet](https://docs.xyo.network/about-xyo/xyo-101/xyo-cheatsheet.md) - [Proprietary Technologies & Solutions](https://docs.xyo.network/about-xyo/proprietary-technologies-and-solutions.md) - [Proof of Location](https://docs.xyo.network/about-xyo/proprietary-technologies-and-solutions/proof-of-location.md) - [Ground-Truth Validation](https://docs.xyo.network/about-xyo/proprietary-technologies-and-solutions/ground-truth-validation.md) - [Proof of Origin](https://docs.xyo.network/about-xyo/proprietary-technologies-and-solutions/proof-of-origin.md) - [Core Paradigms of XYO](https://docs.xyo.network/about-xyo/core-paradigms-of-xyo.md) - [Off-Chain Data, On-Chain Proof](https://docs.xyo.network/about-xyo/core-paradigms-of-xyo/off-chain-data-on-chain-proof.md) - [Off-Chain Data XYO Layer One](https://docs.xyo.network/about-xyo/core-paradigms-of-xyo/off-chain-data-on-chain-proof/off-chain-data-xyo-layer-one.md) - [XYO Schema](https://docs.xyo.network/about-xyo/core-paradigms-of-xyo/xyo-schema.md) - [Example: Test Payload with Schema](https://docs.xyo.network/about-xyo/core-paradigms-of-xyo/xyo-schema/example-test-payload-with-schema.md) - [Real-World Examples: A Geospatial Schemas for Eco-Focused Industries](https://docs.xyo.network/about-xyo/core-paradigms-of-xyo/xyo-schema/real-world-examples-a-geospatial-schemas-for-eco-focused-industries.md) - [Global Stats, Core Details, & Case Studies](https://docs.xyo.network/about-xyo/global-stats-core-details-and-case-studies.md) - [Enterprise](https://docs.xyo.network/about-xyo/enterprise.md) - [Partnership Opportunities](https://docs.xyo.network/about-xyo/enterprise/partnership-opportunities.md) - [What is XYO Layer One?](https://docs.xyo.network/xyo-layer-one/what-is-xyo-layer-one.md) - [XYO Layer One vs. Today's Chains](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-vs.-todays-chains.md) - [Uses of XYO Layer One](https://docs.xyo.network/xyo-layer-one/uses-of-xyo-layer-one.md) - [Dual-Token Model](https://docs.xyo.network/xyo-layer-one/dual-token-model.md) - [XYO Token](https://docs.xyo.network/xyo-layer-one/dual-token-model/xyo-token.md) - [XL1 Token](https://docs.xyo.network/xyo-layer-one/dual-token-model/xl1-token.md) - [Architecture](https://docs.xyo.network/xyo-layer-one/architecture.md) - [Node Structure](https://docs.xyo.network/xyo-layer-one/architecture/node-structure.md) - [Block Structure](https://docs.xyo.network/xyo-layer-one/architecture/block-structure.md) - [Transaction Fees](https://docs.xyo.network/xyo-layer-one/architecture/transaction-fees.md) - [XYO Layer One Features](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features.md) - [Step Hash](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/step-hash.md) - [Step Hash: Real-World Examples](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/step-hash/step-hash-real-world-examples.md) - [Step Hash: Analogies](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/step-hash/step-hash-analogies.md) - [Step Hash Size Function](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/step-hash/step-hash-size-function.md) - [Rollups](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/rollups.md) - [Rollups: Real-World Examples](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/rollups/rollups-real-world-examples.md) - [Rollups: Analogies](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/rollups/rollups-analogies.md) - [Bound Witness Trees](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/rollups/bound-witness-trees.md) - [Bound Witness Tree: Real-World Examples](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/rollups/bound-witness-trees/bound-witness-tree-real-world-examples.md) - [Bound Witness Tree: Analogies](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/rollups/bound-witness-trees/bound-witness-tree-analogies.md) - [Comparing Bound Witness Trees and Rollups](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/rollups/comparing-bound-witness-trees-and-rollups.md) - [Lookback Window](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/lookback-window.md) - [Lookback Window: Real-World Examples](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/lookback-window/lookback-window-real-world-examples.md) - [Lookback Window: Analogies](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/lookback-window/lookback-window-analogies.md) - [Framing Cursor](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/framing-cursor.md) - [Framing Cursor: Real-World Examples](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/framing-cursor/framing-cursor-real-world-examples.md) - [Framing Cursor: Analogies](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/framing-cursor/framing-cursor-analogies.md) - [Bound Witness](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/bound-witness.md) - [Bound Witness: Real-World Examples](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/bound-witness/bound-witness-real-world-examples.md) - [Bound Witness: Analogies](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/bound-witness/bound-witness-analogies.md) - [Bearer Proof](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/bearer-proof.md) - [Bearer Proof: Real-World Examples](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/bearer-proof/bearer-proof-real-world-examples.md) - [Bearer Proof: Analogies](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/bearer-proof/bearer-proof-analogies.md) - [Proof of Perfect Algorithm](https://docs.xyo.network/xyo-layer-one/xyo-layer-one-features/proof-of-perfect-algorithm.md) - [Tokenomics](https://docs.xyo.network/xyo-layer-one/tokenomics.md) - [Tokenomics Chart](https://docs.xyo.network/xyo-layer-one/tokenomics/tokenomics-chart.md) - [Genesis Era](https://docs.xyo.network/xyo-layer-one/tokenomics/genesis-era.md) - [Block Reward Decay Over Time](https://docs.xyo.network/xyo-layer-one/tokenomics/genesis-era/block-reward-decay-over-time.md): This chart models how the block reward decreases every 1,000,000 blocks (each step hash). Rewards start at 1,000 XL1 and decrease by 5% per step. Inflation flattens to 0.7% over time. - [Slashing & Penalties](https://docs.xyo.network/xyo-layer-one/tokenomics/slashing-and-penalties.md) - [Incentives](https://docs.xyo.network/xyo-layer-one/tokenomics/incentives.md) - [Consensus Model](https://docs.xyo.network/xyo-layer-one/consensus-model.md) - [Staking](https://docs.xyo.network/xyo-layer-one/staking.md) - [Types of Staking](https://docs.xyo.network/xyo-layer-one/staking/types-of-staking.md) - [Staking Process: Actions & Rules](https://docs.xyo.network/xyo-layer-one/staking/staking-process-actions-and-rules.md) - [Why is There a Cooldown Period?](https://docs.xyo.network/xyo-layer-one/staking/staking-process-actions-and-rules/why-is-there-a-cooldown-period.md) - [Slashing](https://docs.xyo.network/xyo-layer-one/staking/slashing.md) - [System Staking Guide](https://docs.xyo.network/xyo-layer-one/staking/system-staking-guide.md) - [System Staking with Mobile Metamask](https://docs.xyo.network/xyo-layer-one/staking/system-staking-guide/system-staking-with-mobile-metamask.md) - [How to Claim Your Earned XL1](https://docs.xyo.network/xyo-layer-one/staking/system-staking-guide/how-to-claim-your-earned-xl1.md): You earn XL1 for staking! Learn how to redeem it to an XL1 Wallet here. - [Genesis Staking Explained](https://docs.xyo.network/xyo-layer-one/staking/genesis-staking-explained.md) - [Rewards](https://docs.xyo.network/xyo-layer-one/rewards.md) - [Block Rewards](https://docs.xyo.network/xyo-layer-one/rewards/block-rewards.md) - [Step Rewards](https://docs.xyo.network/xyo-layer-one/rewards/step-rewards.md) - [Comparison Table](https://docs.xyo.network/xyo-layer-one/rewards/comparison-table.md) - [XYO AI SDK - Quick Start](https://docs.xyo.network/ai-sdk/xyo-ai-sdk-quick-start.md) - [API](https://docs.xyo.network/ai-sdk/api-key.md): Understand which XYO developer interfaces are available today and where to find their source. - [COIN](https://docs.xyo.network/xyo-data-nodes-coin/coin.md) - [XYO Technology in COIN](https://docs.xyo.network/xyo-data-nodes-coin/xyo-technology-in-coin.md) - [Case Studies](https://docs.xyo.network/xyo-data-nodes-coin/case-studies.md) - [2021 Paying a 30-Year Mortgage with COIN](https://docs.xyo.network/xyo-data-nodes-coin/case-studies/2021-paying-a-30-year-mortgage-with-coin.md) - [2021 500 Active User Case Study](https://docs.xyo.network/xyo-data-nodes-coin/case-studies/2021-500-active-user-case-study.md) - [2025 Multi-User Case Study After 1200% XYO Increase](https://docs.xyo.network/xyo-data-nodes-coin/case-studies/2025-multi-user-case-study-after-1200-xyo-increase.md) - [Start Building on XL1](https://docs.xyo.network/developers/introduction.md): Choose a safe starting point for building, testing, and exploring applications on XYO Layer One. - [Getting Started](https://docs.xyo.network/developers/getting-started.md): A practical route from choosing an XL1 environment to running a first project. - [Choose an Environment](https://docs.xyo.network/developers/getting-started/environments.md): Compare Local, Sequence, and Mainnet before running an XL1 application. - [Prepare Your Tools](https://docs.xyo.network/developers/getting-started/tooling.md): Install the XL1 wallet and development tools required by the guide you choose. - [Choose Your First Project](https://docs.xyo.network/developers/getting-started/first-project.md): Choose a first XL1 project based on what you want to learn. - [XL1 Wallet](https://docs.xyo.network/developers/xl1-wallet.md) - [Get XL1 Browser Wallet](https://docs.xyo.network/developers/xl1-wallet/get-xl1-browser-wallet.md) - [How to Import or Replace an XL1 Wallet](https://docs.xyo.network/developers/xl1-wallet/get-xl1-browser-wallet/how-to-import-an-xl1-wallet.md) - [Request XL1 Testnet Tokens](https://docs.xyo.network/developers/how-to-request-xl1-testnet-tokens.md): Request no-value Sequence tokens for testing XL1 transactions and applications. - [Run a Local Blockchain & Block Producer](https://docs.xyo.network/developers/how-to-request-xl1-testnet-tokens-1.md): Run an isolated XL1 blockchain and block producer for local development. - [Run with React](https://docs.xyo.network/developers/how-to-request-xl1-testnet-tokens-1/introduction.md) - [Run with Node.js](https://docs.xyo.network/developers/how-to-request-xl1-testnet-tokens-1/introduction-1.md) - [Developer Tools](https://docs.xyo.network/developers/tools.md): Official wallets, explorers, code repositories, and samples for building on XYO Layer One. - [Public SDK Reference](https://docs.xyo.network/developers/sdk-reference.md): Public npm libraries for building with XYO Protocol and XYO Layer One. - [XL1 Libraries](https://docs.xyo.network/developers/sdk-reference/xl1-libraries.md): Public npm libraries for XL1 chain access and React applications. - [XYO Protocol Libraries](https://docs.xyo.network/developers/sdk-reference/xyo-protocol-libraries.md): Public npm libraries for XYO Protocol data, identity, and modules. - [Storage Libraries](https://docs.xyo.network/developers/sdk-reference/storage-libraries.md): Public npm libraries for XYO storage adapters and portable dApp contracts. - [Cookbook](https://docs.xyo.network/developers/cookbook.md): Task-oriented recipes built only from verified public npm libraries. - [Submit and Retrieve a Payload](https://docs.xyo.network/developers/cookbook/submit-and-retrieve.md): Submit a payload through an XL1 gateway and retrieve it through typed viewers. - [Stream Finalized Blocks](https://docs.xyo.network/developers/cookbook/stream-finalized-blocks.md): Consume finalized XL1 blocks in order with resumable checkpoints. - [Build a Local Indexer](https://docs.xyo.network/developers/cookbook/build-a-local-indexer.md): Build a restartable read model from finalized XL1 blocks. - [Connect a Browser Wallet](https://docs.xyo.network/developers/cookbook/connect-a-browser-wallet.md): Connect an XL1 browser wallet through the public React client SDK. - [Verify a Transaction](https://docs.xyo.network/developers/cookbook/verify-a-transaction.md): Verify that an XL1 transaction reached finalized chain state. - [Move from Local to Sequence](https://docs.xyo.network/developers/cookbook/local-to-sequence.md): Move an XL1 application from an isolated local chain to the shared Sequence testnet. - [Recover an Uncertain Submission](https://docs.xyo.network/developers/cookbook/recover-an-uncertain-submission.md): Investigate an interrupted XL1 submission without creating accidental duplicates. - [Prepare for Mainnet](https://docs.xyo.network/developers/cookbook/prepare-for-mainnet.md): Review an XL1 application before moving from Sequence to Mainnet. - [XYO Block Explorer](https://docs.xyo.network/developers/xyo-block-explorer.md): Inspect Sequence blocks, transactions, payloads, and signatures in a web browser. - [In-House dApps](https://docs.xyo.network/developers/in-house-dapps.md) - [Foreverize](https://docs.xyo.network/developers/in-house-dapps/foreverize.md) - [Autonomys Data Lake](https://docs.xyo.network/developers/autonomys-data-lake.md): Use Autonomys Auto Drive as an off-chain data layer for XYO applications. - [Public-Library Quickstart](https://docs.xyo.network/developers/autonomys-data-lake/quickstart.md): Start an Auto Drive integration using the verified public npm adapter. - [Architecture](https://docs.xyo.network/developers/autonomys-data-lake/architecture.md): Understand the trust boundaries in an Auto Drive and XL1 data-lake design. - [Integration Guide](https://docs.xyo.network/developers/autonomys-data-lake/integration-guide.md): Design a bounded and verifiable Auto Drive integration using public libraries. - [Security and Recovery](https://docs.xyo.network/developers/autonomys-data-lake/security-and-recovery.md): Protect Auto Drive credentials and recover safely from uncertain operations. - [Maintenance Policy](https://docs.xyo.network/documentation-operations/maintenance-policy.md): Ownership, verification, and automated quality controls for XYO documentation. - [Deprecation and Migration Policy](https://docs.xyo.network/documentation-operations/deprecation-and-migration.md): How XYO documentation marks deprecated libraries and guides readers to supported replacements. - [Release Notes](https://docs.xyo.network/release-notes/release-notes.md): Verified developer-facing changes to public XYO and XL1 libraries. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation This site has an agentic ask interface you may use to query the documentation dynamically by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.xyo.network/index.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.