Documentation site, 2026-09-01

Specification 1.0.0. Verified at commit 6507df3848c9.

Added

• Independent documentation site published from the repository root, replacing the previous marketing-oriented site under site/.
• Complete normative specification page with numbered grammar rules, the full error code table, and a marker byte-layout walkthrough.
• Guide with three worked examples taken from the committed vectors, including the odd-remainder fee case.
• Reference page with terminology, indexer confirmation, mempool and reorganization semantics, a fee and size table for every participant count from 2 to 16, limitations, security considerations and an implementation checklist.
• Test vectors page publishing every committed valid and invalid case with its required error code and expected state hashes.
• JSON Schema reference covering all seven published schemas.
• Conformance page defining three implementation levels, what must agree, the differential procedure and a self-declaration template.
• Circle state simulator: a client-side reimplementation of the marker decoder, transaction codec, validator, fee allocator, lineage derivation and state engine, which replays every published vector in the browser.
• Build-free local search over an authored index, a helpful 404 page, llms.txt, sitemap.xml and robots.txt.

Changed

• Repository links corrected from the bitcoinuniverse organization to the owning organization bitcoinuniverseio.
• docs.manifest.json enriched: the specification and all seven schemas are declared, the network list now reflects that all four network identifiers are parseable, and the verified commit was updated.
• Corrected mangled wording in SPECIFICATION.md section 5, 11 and 13 that had been introduced by an earlier find-and-replace over the document.

Reference implementation 0.1.0, 2026-08-01

Added

• Complete CIRCLE protocol specification.
• Exact marker and RFC 8785 manifest utilities.
• Strict Bitcoin transaction codec with minimal CompactSize enforcement.
• BIP341 key-path sighash and BIP340 signature verification.
• Deterministic validator and equal fee allocation.
• Transaction and PSBT planning model.
• Wallet signing-intent inspector.
• Rollback-capable reference lineage state engine.
• SDK, CLI, versioned schemas, golden signed transaction, state-lifecycle vector and tests.
• User, creator, developer, operator, security, governance and legal-review documentation.

Fixed

• Aligned manifest runtime validation with JSON Schema code-point limits, exact UTC timestamps, well-formed Unicode and lowercase alias keys.
• Defined the authoritative state-root preimage and committed a reproducible golden transition hash.
• Rejected non-integral planner positions, whitespace-padded manifest text, and aggregate inputs above Bitcoin MAX_MONEY.
• Rejected unsafe state integers, outpoint indices above uint32, and state amounts above Bitcoin MAX_MONEY before hashing.

Deliberate exclusions

• Mainnet production declaration.
• Transfer, market, CPFP, refuel, rekey, token, reward and governance operations.

Versioning policy

• Protocol behaviour is versioned by the marker version byte. Version 0x01 is final and will not gain new operations.
• Schemas and vectors are versioned by directory. v1 files are never edited to describe new behaviour.
• The reference package version describes the API surface, not the protocol.
• This site records the commit it was verified against in every page footer.