{"id":50722449,"url":"https://github.com/sentrix-labs/whitepaper","last_synced_at":"2026-06-10T01:30:25.897Z","repository":{"id":354889460,"uuid":"1225656286","full_name":"sentrix-labs/whitepaper","owner":"sentrix-labs","description":"Foundational whitepaper for Sentrix Chain — Layer-One blockchain for the real economy","archived":false,"fork":false,"pushed_at":"2026-06-03T09:55:24.000Z","size":3192,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T11:23:34.030Z","etag":null,"topics":["bft","blockchain","consensus","evm","layer1","rust","sentrix-chain","whitepaper"],"latest_commit_sha":null,"homepage":"https://sentrixchain.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sentrix-labs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://github.com/satyakwok#sponsor"]}},"created_at":"2026-04-30T13:54:46.000Z","updated_at":"2026-06-03T09:55:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sentrix-labs/whitepaper","commit_stats":null,"previous_names":["sentrix-labs/whitepaper"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/sentrix-labs/whitepaper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fwhitepaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fwhitepaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fwhitepaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fwhitepaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sentrix-labs","download_url":"https://codeload.github.com/sentrix-labs/whitepaper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fwhitepaper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34133404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bft","blockchain","consensus","evm","layer1","rust","sentrix-chain","whitepaper"],"created_at":"2026-06-10T01:30:25.247Z","updated_at":"2026-06-10T01:30:25.884Z","avatar_url":"https://github.com/sentrix-labs.png","language":"HTML","funding_links":["https://github.com/satyakwok#sponsor"],"categories":["Core Protocol"],"sub_categories":["Testnet"],"readme":"# Sentrix Whitepaper\n\n[![CI](https://github.com/sentrix-labs/whitepaper/actions/workflows/lint.yml/badge.svg)](https://github.com/sentrix-labs/whitepaper/actions/workflows/lint.yml)\n[![License](https://img.shields.io/github/license/sentrix-labs/whitepaper)](LICENSE)\n[![Latest release](https://img.shields.io/github/v/release/sentrix-labs/whitepaper?include_prereleases\u0026sort=semver)](https://github.com/sentrix-labs/whitepaper/releases/latest)\n\n\nFoundational paper for [Sentrix Chain](https://sentrixchain.com) — a Layer-1 blockchain.\n\nAuthor: Satya Kwok \u0026lt;satya@sentrixchain.com\u0026gt;\n\n## Contents\n\n- [`sentrix-whitepaper-en.tex`](sentrix-whitepaper-en.tex) — English LaTeX source (v1.3.0)\n- [`sentrix-whitepaper-en.pdf`](sentrix-whitepaper-en.pdf) — English PDF (LaTeX-rendered, canonical)\n- [`sentrix-whitepaper-en.md`](sentrix-whitepaper-en.md) — English Markdown source (v1.3.0)\n- [`sentrix-whitepaper-en.html`](sentrix-whitepaper-en.html) — English HTML (browser-readable)\n- [`sentrix-whitepaper-id.tex`](sentrix-whitepaper-id.tex) — Bahasa Indonesia LaTeX source (v1.3.0)\n- [`sentrix-whitepaper-id.pdf`](sentrix-whitepaper-id.pdf) — Bahasa Indonesia PDF (v1.3.0)\n- [`sentrix-whitepaper-id.md`](sentrix-whitepaper-id.md) — Bahasa Indonesia Markdown (v1.3.0)\n- [`sentrix-whitepaper-id.html`](sentrix-whitepaper-id.html) — Bahasa Indonesia HTML (v1.3.0)\n\n### Litepaper\n\nA short, developer-facing on-ramp — the 5-minute read. The whitepaper is the\nengineer-auditable spec; the litepaper is the \"is this worth my time\" version.\n\n- [`sentrix-litepaper-en.md`](sentrix-litepaper-en.md) — English Markdown source\n- [`sentrix-litepaper-en.html`](sentrix-litepaper-en.html) — English HTML (browser-readable)\n- [`sentrix-litepaper-en.pdf`](sentrix-litepaper-en.pdf) — English PDF (shareable)\n\n## Building from source\n\n```bash\npdflatex sentrix-whitepaper-en.tex\npdflatex sentrix-whitepaper-en.tex   # second pass for cross-references\n```\n\nRequires `texlive-latex-recommended`, `texlive-latex-extra`, `lmodern`, and (for the ID build) `texlive-lang-other`. The English `.tex` uses `newunicodechar` mappings for math glyphs (`⌊⌋⌈⌉∈Σ` etc.) so plain `pdflatex` produces the canonical PDF without needing XeLaTeX.\n\n## Versions\n\n- **v1.3.0** (current) — Full revision targeting infra-grade protocol-specification\n  rigor (Tendermint / Monad / Solana paper level). Each constant traces to a specific\n  module path in `sentrix-labs/sentrix@v2.1.56`; Appendix A pins every parameter to\n  its file of origin so future drift is detectable.\n\n  Major upgrades over v1.2.4:\n\n  - **§2 System Model** added: notation table, partial-synchrony assumption (Dwork-\n    Lynch-Stockmeyer), adversarial model `β \u003c 1/3` of stake-Byzantine, SMR formalism.\n  - **§4 Voyager BFT** formalized: round structure with PROPOSE / PREVOTE / PRECOMMIT /\n    FINALIZE phases, real timeout values from `crates/sentrix-bft/src/engine/timeouts.rs`\n    (`PROPOSE 20s`, `PREVOTE 12s`, `PRECOMMIT 12s`, linear backoff `+1s` propose / `+2s`\n    votes per round, capped 30s, `MAX_ROUND = 100`), locking invariant, Agreement /\n    Validity / Termination theorems with proof sketches, `O(n²)` message complexity.\n  - **§5 Execution Layer** expanded: pipeline diagram, three determinism axioms (D1/D2/D3),\n    fully-formalised STF pseudocode, forward-looking optimistic-parallel execution model\n    (Block-STM-style).\n  - **§10 Performance Model** added: `TPS_max = MAX_TX_PER_BLOCK / BLOCK_TIME = 5,000`,\n    latency decomposition `T_block = T_propose + T_prevote + T_precommit + T_apply`,\n    scalability bounds.\n  - **§11 Failure Handling** explicit protocols for partition / equivocation / downtime /\n    chain recovery, with the operator-side `chain.db` rsync runbook (pulls FROM canonical\n    TO stale via `ssh canonical-peer 'tar | tar -x'`).\n  - **§12 Benchmark Framework** added: sequential reference engine + batched optimistic-\n    parallel engine pseudocode, metrics definitions for `tps`, `p50_latency`, `p99_latency`,\n    `conflict_rate`.\n  - **§13 Comparative Analysis** restructured into three tables (execution model / consensus\n    design / scalability approach) across Ethereum, Solana, Monad, Polygon PoS, Sentrix.\n    MonadBFT correctly listed as `O(n)` per round (HotStuff-derivative with threshold\n    aggregation).\n  - **§14 Open Problems** expanded: parallel-execution determinism proof, light-client weak-\n    subjectivity, cross-rail atomicity, NFT TokenOp activation, consensus-jail fix, EVM\n    value-transfer fork-gate retirement, multi-implementation diversity, founder vesting.\n  - 3 Mermaid diagrams in the Markdown source replace the v1.2.4 ASCII art (architecture,\n    BFT round sequence, execution pipeline). The LaTeX source falls back to ASCII inside\n    `verbatim` blocks for those three figures so the PDF renders without a TikZ pass.\n  - Voice shifted strictly technical: retired \"real-economy / Indonesia first / world after\"\n    framing from §1, §2, §9. The chain is described as what it is — an open-source EVM-\n    compatible Layer-1 built in Rust — without market-strategy claims.\n\n  Corrections of factual errors in v1.2.4 surfaced by the v1.3.0 audit:\n\n  - Slashing constant correctly named `DOUBLE_SIGN_SLASH_BP` (v1.2.4 used the spec'd-but-\n    unused name `EQUIVOCATION_SLASH_BP`).\n  - Burn mechanism corrected: there is no `BURN_ADDRESS` sentinel. `burn_share = total_fee.div_ceil(2)`\n    is debited from sender and never credited; supply contracts. v1.2.4 implied a sentinel.\n  - `MAX_ACTIVE_VALIDATORS = 21` is a compile-time `const`, not parametric (v1.2.4 was vague).\n  - `STATE_ROOT_FORK_HEIGHT = 100,000` is a compile-time `const`, not parametric.\n  - Proposer selection is pure round-robin `(h + r) mod n`. The function name in the source\n    is `weighted_proposer` but the body is unweighted.\n  - Round advancement is **timeout-only** (per the 2026-04-17 leapfrog-stall fix); no vote-\n    triggered or `RoundStatus`-triggered cross-round catch-up.\n\n  The Bahasa Indonesia translation tracks v1.3.0 in this release.\n\n- **v1.2.4** — Two corrections: reworked §7.2 validator-revenue formula (subsidy is split\n  pro-rata across precommit signers, not paid to the proposer; only fees go to proposer).\n  Fixed §11.2 SentrixSafe deployment claim — was \"deployed at genesis\" but actually deployed\n  shortly after Voyager activation as part of the canonical contracts set.\n\n- **v1.2.3** — Two corrections. First, the §6.4 premine table no longer carries fabricated\n  sub-allocation strings (\"market-making seed\", \"DEX liquidity bootstrap\", \"under multi-\n  signature control\") — those operational details belong in the mutable `sentrixchain.com/docs/tokenomics`\n  page, not in the stable whitepaper. Second, reverted the v1.2.2 fee-routing description:\n  the actual chain credits the 50% non-burn fee share directly to the block proposer's balance\n  (immediate spendable). It is the block subsidy (1 SRX coinbase), not the fee, that goes\n  through `PROTOCOL_TREASURY` for pro-rata distribution to precommit signers. v1.2.2\n  conflated the two paths.\n\n- **v1.2.2** — Technical-accuracy audit pass: transaction format, signing payload, and a\n  `JAIL_CONSENSUS` risk note. (Note: this version introduced the fee-routing inaccuracy that\n  v1.2.3 corrects.)\n\n- **v1.2.1** — LaTeX source (.tex) added, contact email `satya@sentrixchain.com`, \"Focus\n  Statement\" preamble.\n\n- **v1.2** — Adds genesis allocation addresses (on-chain verifiable), validator onboarding\n  requirements (§7.5), incident response model (§7.6), privacy posture (§8.7), expanded\n  comparison with Aptos/Sui/Near, full governance section (§11) covering current binary-\n  release coordination + SentrixSafe multisig + future on-chain governance + non-governable\n  invariants, risk disclosures (Appendix B), legal notice (Appendix C), and About the Author.\n\n- **v1.1** — Vision, mission, and protocol depth: state transition function, BFT safety/\n  liveness, network model, transaction lifecycle, slashing matrix, long-range attack\n  defense, comparison table, parameters appendix.\n\n- **v1.0** (initial) — Vision-first foundational document.\n\n## Citation\n\n```\nKwok, S. (2026). Sentrix: A Layer-1 Blockchain — Protocol Specification (v1.3.0).\nSentrix Labs. https://github.com/sentrix-labs/whitepaper\n```\n\n## License\n\nThe whitepaper text is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).\nYou may share, adapt, and build on this work with attribution.\n\nThe Sentrix Chain implementation is licensed separately — see\n[sentrix-labs/sentrix](https://github.com/sentrix-labs/sentrix) for protocol code (BUSL-1.1).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsentrix-labs%2Fwhitepaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsentrix-labs%2Fwhitepaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsentrix-labs%2Fwhitepaper/lists"}