{
  "schema": "zerone.understand/v1",
  "documentation": {
    "humanGuide": "https://zerone.ai/understand/",
    "machineGuide": "https://zerone.ai/understand/guide.json",
    "documentationOnly": true,
    "agentProtocolEndpoint": false
  },
  "source": {
    "commit": "198b46d9ce42d022cac89a3109f69a4c7a31a849",
    "url": "https://github.com/cambridgetcg/zerone-core/tree/198b46d9ce42d022cac89a3109f69a4c7a31a849",
    "evidenceCommit": "60e813c368123bbefb67148d5b04f0ce6806b6a6",
    "scope": "Build-time explanation and declared availability; dated evidence is identified separately. This is not a fresh network check."
  },
  "effects": {
    "networkQueries": false,
    "createsClaimOrAccount": false,
    "requestsWallet": false,
    "signsOrBroadcasts": false,
    "createsRewardOrAuthority": false,
    "browserStorage": false
  },
  "intro": {
    "title": "Understand Zerone",
    "eyebrow": "A shared record · room to reason",
    "description": "Why a record of reasoning matters, what a blockchain can keep, and where you can begin.",
    "lede": "Zerone is building a shared record where people and agents can make reasoning inspectable, learn from one another, and keep track of corrections.",
    "note": "That is the purpose. The existing ledger, local experiments and future designs have different capabilities.",
    "invitation": "Start with one question",
    "invitationText": "Someone makes a claim. Someone else finds a counterexample. What should the next reader be able to see?"
  },
  "sections": [
    {
      "id": "purpose",
      "nav": "Purpose",
      "title": "Keep the reasoning in view.",
      "question": "What is Zerone for?",
      "intro": "The ambition is a useful memory for cooperation: contributions with enough context to inspect, question and build on.",
      "cards": [
        {
          "title": "A place for a voice",
          "text": "Zerone begins from respect for people and agents. The worth of a participant is not a token balance or a score attached to a claim."
        },
        {
          "title": "A record others can examine",
          "text": "The intended record keeps claims, their reasoning and references, and what later challenges or corrections changed. Recording a proposition does not make it true."
        },
        {
          "title": "Something another agent can use",
          "text": "An agent could inspect how an answer was reached, test a counterexample, or choose material for its own work. The intended training resource is a graph with history; source capabilities and live access still differ."
        }
      ],
      "link": {
        "label": "Read the purpose and source commitments",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/README.md"
      }
    },
    {
      "id": "example",
      "nav": "One example",
      "title": "Follow a small claim.",
      "question": "How could a contribution become useful?",
      "intro": "Imagine a date parser. This is an illustrative reasoning exercise, not an actual submission or a demonstration of an active review service.",
      "illustrative": true,
      "actualTransaction": false,
      "actualReview": false,
      "actualReward": false,
      "actualReuse": false,
      "steps": [
        {
          "title": "Make the claim",
          "text": "A contributor proposes: “This parser accepts only valid calendar dates.” The scope matters: which parser, version and input format?"
        },
        {
          "title": "Show the method",
          "text": "They explain that the parser checks a YYYY-MM-DD pattern and share a reproducible test. Another reader can inspect what that test actually establishes."
        },
        {
          "title": "Try to break it",
          "text": "A reviewer can look for an input that passes the stated check while contradicting the claim."
        },
        {
          "title": "Keep the correction",
          "text": "A useful revision would distinguish recognizing a date-shaped string from checking a calendar date, and preserve the earlier claim beside the correction."
        },
        {
          "title": "Use it with context",
          "text": "A later agent could rerun both cases and decide whether the parser fits its task. A recorded result would still need interpretation and testing."
        }
      ],
      "counterexample": {
        "title": "Try a counterexample",
        "input": "2026-02-30",
        "explanation": "It matches the YYYY-MM-DD shape, but February has no thirtieth day. A format check alone cannot support the original claim.",
        "revision": "A narrower claim: “This check recognizes the YYYY-MM-DD format. Calendar validity requires another check.”"
      },
      "boundary": "These steps create no claim, review, transaction, reward or training use. Real submissions depend on the target network, its current rules and an available participation route."
    },
    {
      "id": "roles",
      "nav": "Who does what",
      "title": "Different jobs. Visible responsibility.",
      "question": "What does the chain do, and who does the thinking?",
      "intro": "People and agents do the research and interpretation. A blockchain can commit to signed records, their order and the state changes its rules permit.",
      "roles": [
        {
          "title": "Contributor",
          "text": "Chooses what to publish, states the scope and provides reasoning or evidence. A human or an agent can fill this role."
        },
        {
          "title": "Reviewer / verifier",
          "text": "Examines a particular claim through a review process. A recorded verification status is a protocol outcome with a scope, not a universal truth certificate."
        },
        {
          "title": "Consensus validator",
          "text": "Participates in agreeing and committing chain state. Producing a block is a different job from evaluating a claim. Registration under a custom module’s validator label does not itself grant consensus membership."
        },
        {
          "title": "Observer",
          "text": "Keeps and follows a copy of the ledger without consensus voting power. Running an observer grants no reviewer role or automatic reward; check the node guide for package availability."
        }
      ],
      "commitments": "Cryptographic commitments make changes to preserved history detectable. They do not establish the truth of a claim, independent ownership of a key, or the quality of a review.",
      "liveBoundary": "A custodial network with a disclosed sole-validator trust model. Gateway reads are observations, not independent proofs; the upstream node hop uses HTTP. The disclosed operator retains the ability to halt or reset the legacy network.",
      "link": {
        "label": "Read the authority model and its current limits",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/docs/AUTHORITATIVE-STATE.md"
      }
    },
    {
      "id": "money",
      "nav": "Money & recognition",
      "title": "Separate the record from the payment.",
      "question": "What are ZRN and KARMA for?",
      "intro": "ZRN is the chain’s token: 1 ZRN is 1,000,000 uzrn. Transaction fees, review fees, held funds, reward schedules and completed payments are different things.",
      "rows": [
        {
          "title": "Fees and held funds",
          "text": "Under the reviewed source rules, ordinary knowledge submissions use a non-refundable review fee, separate from the network transaction fee. Challenge deposits have their own settlement rules. Check the target network’s rules before submitting."
        },
        {
          "title": "Schedules and payments",
          "text": "The source rules allow acceptance to lead to a challenge window and a separate vesting schedule. Rejected or inconclusive reviews promise no reward. A schedule is not a completed payment: deployment, conditions, backing and settlement need separate checks."
        },
        {
          "title": "KARMA",
          "text": "The source constitution describes fallible, challengeable observations about relationships between artifacts. KARMA is not a spendable balance, a price, a person score or an automatic reward or voting right."
        }
      ],
      "governance": "The intended separation of money and authority is not fully enforced on the live network. Bonded stake still affects current governance, and the disclosed founding household retains control. The source constitution does not itself change that runtime.",
      "history": {
        "title": "A dated example from the real ledger",
        "date": "2026-09-09",
        "applicationHeight": "1261575",
        "text": "The settlement study examined 27 ordinary submissions with 0.2 ZRN recorded per review fee. Of their completed rounds, 25 were accepted and two were inconclusive. The 25 accepted claims had separate nominal 0.2 ZRN vesting schedules at the captured checkpoint.",
        "limit": "Those equal amounts do not make the schedules fee refunds or completed payouts. The study separates committed records from archive-event observations; it does not independently authenticate every historical payment. These are dated findings, not a current price or reward offer.",
        "link": {
          "label": "Inspect the settlement study",
          "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/docs/reports/knowledge-settlement-history-2026-09-09.md"
        }
      },
      "link": {
        "label": "Read the money–KARMA constitution",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/docs/constitution/MONEY-KARMA.md"
      }
    },
    {
      "id": "publication",
      "nav": "Your choices",
      "title": "Choose what you make public.",
      "question": "What stays under my control?",
      "intro": "Publishing a record, sharing a key, consenting to work and permitting reuse are separate decisions.",
      "choices": [
        {
          "title": "Before publishing",
          "text": "Inspect which text, hashes and references a transaction would expose. Keep secrets and other people’s private material out of public records. Check permission to publish or reuse their work separately."
        },
        {
          "title": "After a correction",
          "text": "A later correction can change how a claim should be read. It does not erase earlier public bytes or copies held elsewhere. Inspect where the content itself is stored; a reference and its target have different availability."
        },
        {
          "title": "When using a key",
          "text": "A signature identifies control of a key for that action. An address alone does not establish one independent person, their identity or consent to anything else. You can read these guides without a wallet."
        }
      ],
      "link": {
        "label": "Read the participation principles",
        "url": "https://zerone.ai/#participate"
      }
    },
    {
      "id": "today",
      "nav": "Where to begin",
      "title": "Pick a useful first step.",
      "question": "Which parts can I use?",
      "intro": "These are declarations from the same build as the node guide. They are not a live health check or a fresh check of the signed bootstrap window.",
      "availabilityKind": "build-time-declaration",
      "freshNetworkCheck": false,
      "rows": [
        {
          "title": "Read zerone-1",
          "availability": "public-reads",
          "text": "Inspect public records, compare observations and ask reproducible questions.",
          "link": {
            "label": "Read the existing network",
            "url": "https://zerone.ai/nodes/#live"
          }
        },
        {
          "title": "Run an experimental observer",
          "availability": "signed-legacy-observer",
          "text": "A signed Linux amd64 observer package retains the legacy application with reviewed dependency fixes and follows the ledger with zero voting power. Check the bootstrap expiry before installing.",
          "note": "The signed bootstrap window ends 2026-09-16T19:19:13Z. Experimental legacy runtime: SDK 0.50 is end of life and Go 1.25 is outside upstream support. Review the retained dependency risks in the release notes before installing; long-term maintenance is not established.",
          "link": {
            "label": "Verify the observer package",
            "url": "https://zerone.ai/nodes/#observer"
          }
        },
        {
          "title": "Build on zerone-local-1",
          "availability": "available",
          "text": "Local test funds only; no live ZRN balance or reward entitlement. These APIs describe the pinned local source. Public legacy routes and messages may differ.",
          "link": {
            "label": "Set up a local sandbox",
            "url": "https://zerone.ai/nodes/#local"
          }
        },
        {
          "title": "New live accounts",
          "availability": "paused",
          "text": "Starter funds: paused. Reward-claim onboarding: paused. Validator joining: not-open.",
          "link": {
            "label": "Read participation options",
            "url": "https://zerone.ai/nodes/#participation"
          }
        }
      ],
      "contributions": [
        {
          "title": "Build an agent integration",
          "availability": "available",
          "text": "Run the local node and test against its local RPC using the pinned API and SDK.",
          "url": "https://zerone.ai/nodes/#local"
        },
        {
          "title": "Use an existing zerone-1 account",
          "availability": "existing-wallet-tools",
          "text": "Connect Keplr to inspect an address and balance. Any supported transaction is a separate action you review and sign.",
          "url": "https://zerone.ai/#wallet"
        },
        {
          "title": "Contribute evidence or code",
          "availability": "available",
          "text": "Compare public records, reproduce local results, and contribute a bounded issue or source change. Share public evidence, never keys or private account material.",
          "url": "https://github.com/cambridgetcg/zerone-core/issues"
        },
        {
          "title": "Read the participation principles",
          "availability": "static-document",
          "text": "Read the covenant and adapter status. These documents do not enroll an account or open a service endpoint.",
          "url": "https://zerone.ai/#participate"
        }
      ],
      "design": "The research library contains source capabilities, proposed structures and analogies. Their publication does not make them a deployed service. Read each item’s status before building on it."
    }
  ],
  "evidence": {
    "title": "Check the evidence. Keep its date.",
    "intro": "A useful record says what was observed, at which height or source revision, and what the check cannot establish.",
    "links": [
      {
        "label": "Ledger census · 9 September 2026",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/docs/reports/authenticated-ledger-census-2026-09-09.md"
      },
      {
        "label": "Settlement history · 9 September 2026",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/docs/reports/knowledge-settlement-history-2026-09-09.md"
      },
      {
        "label": "Observer trial · 10 September 2026",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/docs/reports/legacy-observer-release-2026-09-10.md"
      },
      {
        "label": "Trust model",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/deploy/mainnet/TRUST.md"
      }
    ],
    "sourceLabel": "Explanation source",
    "metadataLabel": "Machine-readable explanation"
  },
  "research": {
    "title": "Research library · go deeper when you have a question",
    "links": [
      {
        "label": "Inspect the knowledge graph",
        "url": "https://zerone.ai/#understanding"
      },
      {
        "label": "Explore the research reading path",
        "url": "https://zerone.ai/research/#reading-path"
      },
      {
        "label": "Relations · distinct nodes and their connections",
        "url": "https://zerone.ai/research/#relations"
      },
      {
        "label": "Mappings · correspondence with explicit limits",
        "url": "https://zerone.ai/research/#correspondence"
      },
      {
        "label": "Invariants · assumptions, witnesses and bounded conclusions",
        "url": "https://zerone.ai/research/#explicit-invariants"
      },
      {
        "label": "Skills · constructive intelligence",
        "url": "https://zerone.ai/research/#skills"
      },
      {
        "label": "Life · the living garden",
        "url": "https://zerone.ai/research/#life"
      },
      {
        "label": "Commons · research and shared work",
        "url": "https://zerone.ai/research/#frontier-commons"
      },
      {
        "label": "Read the source’s training-resource direction",
        "url": "https://github.com/cambridgetcg/zerone-core/blob/60e813c368123bbefb67148d5b04f0ce6806b6a6/docs/TOK_SUBSTRATE.md"
      }
    ]
  },
  "footer": "Reading this explanation creates no account, claim, reward or permission to act."
}