{"id":49052300,"url":"https://github.com/sentrix-labs/sentrix","last_synced_at":"2026-05-12T15:02:37.909Z","repository":{"id":350132714,"uuid":"1205424520","full_name":"sentrix-labs/sentrix","owner":"sentrix-labs","description":"Sentrix Chain — high-performance Layer-1 blockchain written in Rust. Native + EVM dual-layer execution.","archived":false,"fork":false,"pushed_at":"2026-05-07T02:25:34.000Z","size":5644,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-07T02:38:33.284Z","etag":null,"topics":["blockchain","consensus","cryptocurrency","cryptography","dpos-bft","ethereum-compatible","evm","indonesia","l1","layer-1","metamask","rust","sentrix","src-20","srx"],"latest_commit_sha":null,"homepage":"https://sentrixchain.com","language":"Rust","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":"audits/codebase-areas-1-7-audit-2026-04-27.md","citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"docs/GOVERNANCE.md","roadmap":"docs/roadmap/CHANGELOG.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-09T00:32:59.000Z","updated_at":"2026-05-07T02:13:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"701165fd-0d89-436a-bcc4-08dba6cbe59c","html_url":"https://github.com/sentrix-labs/sentrix","commit_stats":null,"previous_names":["satyakwok/sentrix","sentrix-labs/sentrix"],"tags_count":78,"template":false,"template_full_name":null,"purl":"pkg:github/sentrix-labs/sentrix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fsentrix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fsentrix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fsentrix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fsentrix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sentrix-labs","download_url":"https://codeload.github.com/sentrix-labs/sentrix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentrix-labs%2Fsentrix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32944279,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-12T09:19:52.626Z","status":"ssl_error","status_checked_at":"2026-05-12T09:17:33.438Z","response_time":102,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["blockchain","consensus","cryptocurrency","cryptography","dpos-bft","ethereum-compatible","evm","indonesia","l1","layer-1","metamask","rust","sentrix","src-20","srx"],"created_at":"2026-04-19T21:10:13.591Z","updated_at":"2026-05-12T15:02:37.902Z","avatar_url":"https://github.com/sentrix-labs.png","language":"Rust","funding_links":[],"categories":["Start Here"],"sub_categories":[],"readme":"# Sentrix\n\n**Open source, EVM-compatible L1 built in Rust.**\n\nReal chain, real blocks, real code. Sentrix (SRX) is a purpose-built Layer-1 with 1-second blocks, instant BFT finality, and Ethereum-compatible tooling — MetaMask, ethers.js, viem, and hardhat connect natively. Bitcoin's monetary discipline (fixed 315M supply, 4-year halving) plus Ethereum's programmability (revm 38).\n\n\n\u003ca href=\"https://sentrixchain.com\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/assets/hero.gif\"\u003e\n    \u003cimg src=\"docs/assets/hero.gif\" alt=\"Sentrix Chain — orbital nodes hero animation\" width=\"100%\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n[![Website](https://img.shields.io/badge/website-sentrixchain.com-8A5A11)](https://sentrixchain.com)\n[![CI/CD](https://github.com/sentrix-labs/sentrix/actions/workflows/ci.yml/badge.svg)](https://github.com/sentrix-labs/sentrix/actions)\n[![Coverage](https://codecov.io/gh/sentrix-labs/sentrix/branch/main/graph/badge.svg)](https://codecov.io/gh/sentrix-labs/sentrix)\n[![Release](https://img.shields.io/github/v/release/sentrix-labs/sentrix)](https://github.com/sentrix-labs/sentrix/releases/latest)\n[![Tests](https://img.shields.io/badge/tests-700%2B%20passing-brightgreen)](https://github.com/sentrix-labs/sentrix/actions)\n[![Rust](https://img.shields.io/badge/rust-stable-orange)](Cargo.toml)\n[![Chain ID](https://img.shields.io/badge/chain%20ID-7119-blue)](docs/operations/NETWORKS.md)\n[![License](https://img.shields.io/badge/license-BUSL--1.1-purple)](LICENSE)\n[![Whitepaper](https://img.shields.io/badge/whitepaper-v1.3.0-8A5A11)](https://github.com/sentrix-labs/whitepaper)\n\n---\n\n## What is Sentrix?\n\nSentrix (SRX) is a purpose-built Layer-1 blockchain with 1-second block times, instant BFT finality, and Ethereum-compatible tooling. MetaMask, ethers.js, viem, and web3.js connect natively to JSON-RPC. SDK developers can also use the Tonic-based **gRPC + gRPC-Web** transport for binary RPC and server-streaming block events.\n\n- **v2.1.86** — Same-bytes-replay exemption on the LastSignBytes guard: a legitimate rebroadcast (engine retransmitting an identical signed message on round timeout) no longer trips the strict `(h, r, step)` reject path, so the guard can stay enabled in production. Closes the rebroadcast halt class that kept `LAST_SIGN_GUARD_PATH` env-disabled across v2.1.84/v2.1.85. Builds on v2.1.85 BFT engine `last_signed` resume-at-correct-round + `HEIGHT_STALL_THRESHOLD_SEC` env override; v2.1.84 LastSignBytes / privval guard (Tendermint canonical pattern); v2.1.83 STRICT_JUSTIFICATION; v2.1.82 EXTENDED_TOUCH_LIST; v2.1.79 LivenessTracker idempotent recording. Release pipeline: SBOM (CycloneDX) + cosign keyless OIDC + SLSA Level 3 provenance on every tag.\n- Earlier line: v2.1.69-71 Tonic gRPC + gRPC-Web + StreamEvents push, v2.1.6x silent-thread-death defence-in-depth (cmd_tx/event_tx/bft_tx try_send + drop counters + watchdogs). Tokenomics v2 fork active since h=640800 (BTC-parity 4-year halving + 315M cap).\n- **700+ tests**, clippy clean, multiple internal Sentrix Labs / SentrisCloud audit rounds\n- **4 validators** running Voyager DPoS+BFT on mainnet\n\n## Features\n\n| | |\n|---|---|\n| **Consensus** | DPoS + BFT (mainnet \u0026 testnet) — Voyager active |\n| **Finality** | Instant — BFT 2/3+1 vote-based |\n| **Storage** | libmdbx — memory-mapped B+ tree (used by Reth/Erigon) |\n| **EVM** | revm 38 — Solidity contracts, MetaMask compatible (mainnet \u0026 testnet) |\n| **State** | Binary Sparse Merkle Tree (BLAKE3 + SHA-256) with proofs |\n| **Tokens** | SRC-20 native + SRC-20 (ERC-20 via EVM) |\n| **Network** | libp2p + Noise XX + Kademlia + Gossipsub |\n| **API** | REST (60+ endpoints) + JSON-RPC 2.0 (22 methods, incl. `sentrix_*` native namespace) + **Tonic gRPC + gRPC-Web** ([docs](docs/operations/GRPC.md)) — `GetBlock`, `GetBalance`, server-streaming `StreamEvents` |\n| **Explorer** | Built-in dark-themed block explorer |\n| **Wallet** | AES-256-GCM keystore (Argon2id KDF) |\n| **Fee model** | 50% burn / 50% validator (deflationary) |\n\n## Quick Start\n\n```bash\n# Build\ngit clone https://github.com/sentrix-labs/sentrix.git\ncd sentrix\ncargo build --release\n\n# Test\ncargo test    # 700+ tests\n\n# Run a node\nSENTRIX_VALIDATOR_KEY=\u003ckey\u003e ./target/release/sentrix start --port 30303\n\n# Check health\ncurl http://localhost:8545/health\n```\n\n## Run a validator\n\nSentrix is a permissioned-onboarding chain for now — the consensus is open and the binary is the same one anyone can build, but admission to the active set is co-signed by the chain admin (single-key today, N-of-M target). To run a node:\n\n```bash\n# One-line installer (Ubuntu 22.04 / 24.04, x86_64 or aarch64)\ncurl -fsSL https://raw.githubusercontent.com/sentrix-labs/sentrix/main/scripts/install-validator.sh | bash\n```\n\nThe script handles pre-flight checks (RAM ≥ 8 GiB, swap ≥ 8 GiB persistent, disk ≥ 60 GiB), apt deps, Rust 1.95+ via rustup, source clone + `cargo build --release -p sentrix-node`, keystore generation, systemd unit, and start. It's idempotent — re-runs are repair, not clobber.\n\nAfter the node is healthy, email **`validators@sentrixchain.com`** with your address + pubkey (printed by the installer) + intended self-stake (≥ 15,000 SRX) + ops contact. Activation height comes back; you appear in `GET /chain/info → validators` and at [scan.sentrixchain.com/validators](https://scan.sentrixchain.com/validators).\n\nFull operator guide: **[docs.sentrixchain.com/operations/VALIDATOR_ONBOARDING](https://docs.sentrixchain.com/operations/VALIDATOR_ONBOARDING)** (hardware, security, monitoring, recovery paths).\n\n## Connect MetaMask (Testnet)\n\n| Field | Value |\n|---|---|\n| Network name | Sentrix Testnet |\n| RPC URL | `https://testnet-rpc.sentrixchain.com/rpc` |\n| Chain ID | `7120` |\n| Symbol | `SRX` |\n| Explorer | `https://scan.sentrixchain.com` (toggle to Testnet in UI) |\n\nFull guide: [docs/operations/METAMASK.md](docs/operations/METAMASK.md). Deploy a smart contract via Remix: [docs/operations/SMART_CONTRACT_GUIDE.md](docs/operations/SMART_CONTRACT_GUIDE.md). EVM internals: [docs/architecture/EVM.md](docs/architecture/EVM.md).\n\n## Architecture\n\n```\ncrates/\n├── sentrix-primitives/   Block, Transaction, Account, Error types\n├── sentrix-codec/        Wire-format encoding helpers\n├── sentrix-wire/         Wire-protocol message types\n├── sentrix-wallet/       Keystore (Argon2id), wallet ops\n├── sentrix-trie/         Binary Sparse Merkle Tree (MDBX backend)\n├── sentrix-staking/      DPoS, epoch, slashing\n├── sentrix-evm/          revm 38 adapter\n├── sentrix-precompiles/  EVM precompiles\n├── sentrix-bft/          BFT consensus (timeout-only round advance)\n├── sentrix-core/         Blockchain, authority, executor, mempool, storage\n├── sentrix-network/      libp2p P2P, gossipsub, kademlia\n├── sentrix-rpc/          REST API, JSON-RPC, block explorer\n├── sentrix-rpc-types/    Shared RPC request/response types\n├── sentrix-storage/      MDBX wrapper + ChainStorage API\nbin/sentrix/              CLI binary (main.rs at bin/sentrix/src/main.rs)\n```\n\n14 crates + 1 binary — node, API, explorer, CLI all ship as one executable.\n\n## Network\n\n| | Mainnet | Testnet |\n|---|---|---|\n| **Chain ID** | 7119 | 7120 |\n| **RPC** | [rpc.sentrixchain.com](https://rpc.sentrixchain.com) | [testnet-rpc.sentrixchain.com](https://testnet-rpc.sentrixchain.com) |\n| **Consensus** | DPoS + BFT (4 validators) | DPoS + BFT (4 validators) |\n| **Block time** | 1 second | 1 second |\n| **EVM** | Active — MetaMask compatible | Active — MetaMask compatible |\n| **Explorer** | [scan.sentrixchain.com](https://scan.sentrixchain.com) | [scan.sentrixchain.com](https://scan.sentrixchain.com) (same unified UI, toggle Testnet) |\n\n**Website:** [sentrixchain.com](https://sentrixchain.com)\n**Docs:** [docs.sentrixchain.com](https://docs.sentrixchain.com)\n**Faucet:** [faucet.sentrixchain.com](https://faucet.sentrixchain.com) (testnet)\n**Wallet:** [solux.sentriscloud.com](https://solux.sentriscloud.com) (Solux web)\n**Verifier:** [verify.sentrixchain.com](https://verify.sentrixchain.com) (Sourcify)\n**gRPC + gRPC-Web:** [grpc.sentrixchain.com](https://grpc.sentrixchain.com) · [grpc-testnet.sentrixchain.com](https://grpc-testnet.sentrixchain.com)\n**WebSocket:** `wss://api.sentrixchain.com/ws` (mainnet) · `wss://testnet-api.sentrixchain.com/ws` (testnet)\n**Telegram:** [t.me/SentrixCommunity](https://t.me/SentrixCommunity)\n\n## Roadmap\n\n| Phase | Status | Focus |\n|-------|--------|-------|\n| **Pioneer** | Completed (mainnet h=0…579,046) | PoA round-robin, MDBX storage, 1s blocks, SRC-20 tokens — succeeded by Voyager 2026-04-25 |\n| **Voyager** | **Live on mainnet** | DPoS proposer rotation + BFT finality, EVM (revm 38) with `eth_call` against real chain state, `eth_sendRawTransaction`, L1 peer auto-discovery + connection-limits hardening, V4 reward distribution v2 (treasury escrow + ClaimRewards), runtime-aware Voyager dispatch, race-safe block sync, tokenomics v2 fork (315M cap + 4-year halving), `StakingOp::AddSelfStake` for non-phantom validator self-bond, side-car gRPC + gRPC-Web for SDK integration |\n| **Frontier** | Phase F-1 scaffold landed; F-2…F-10 planned | Parallel transaction execution, sub-1s block time, mainnet hard fork |\n| **Odyssey** | Future | Cross-chain bridges, mature ecosystem, light clients |\n\n## Documentation\n\n- **[Whitepaper](https://github.com/sentrix-labs/whitepaper)** — foundational paper (vision, mission, design philosophy, protocol depth). Available in English and Bahasa Indonesia.\n- [Architecture](docs/architecture/) — consensus, state, networking, transactions\n- [Operations](docs/operations/) — deployment, CI/CD, monitoring, validators\n- [Claim Rewards](docs/operations/CLAIM_REWARDS.md) — how validators + delegators claim escrowed rewards from `PROTOCOL_TREASURY`\n- [Security](docs/security/) — audit reports, attack vectors, pentest results\n- [Tokenomics](docs/tokenomics/) — SRX economics, staking, token standards\n- [Roadmap](docs/roadmap/) — phase details, changelog\n\n## Security\n\nSee [SECURITY.md](SECURITY.md) for vulnerability reporting.\n\n11 audit rounds completed (116 findings, 78+ fixed). Pentest 6/6 passed on live network.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and PR process.\n\n## Community\n\n- **GitHub Discussions** — https://github.com/sentrix-labs/sentrix/discussions for design conversations, feature proposals, validator setup help, integration questions.\n- **Org profile** — https://github.com/sentrix-labs for canonical contracts, brand kit, and other Sentrix Labs repos.\n\n## License\n\n[Business Source License 1.1](LICENSE) (BUSL-1.1). Converts to Apache 2.0 after the Change Date.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsentrix-labs%2Fsentrix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsentrix-labs%2Fsentrix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsentrix-labs%2Fsentrix/lists"}