Skip to content

sentrix-labs/sentrix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

722 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sentrix

Open source, EVM-compatible L1 built in Rust.

Real 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).

Website CI/CD Release Tests Rust Chain ID License Whitepaper


What is Sentrix?

Sentrix (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.

  • v2.1.71 — Tonic gRPC StreamEvents push (server subscribes to the same broadcast bus that powers WS eth_subscribe). Plus v2.1.70 (tonic-web browser support) and v2.1.69 (read-only side-car: GetBlock, GetBalance). Earlier in the v2.1.6x line: silent-thread-death defence-in-depth (cmd_tx + event_tx + bft_tx try_send + drop counters; swarm-task / heartbeat / chain-height watchdogs). Tokenomics v2 fork active since h=640800 (BTC-parity 4-year halving + 315M cap).
  • 700+ tests, clippy clean, multiple internal Sentrix Labs / SentrisCloud audit rounds
  • 4 validators running Voyager DPoS+BFT on mainnet

Features

Consensus DPoS + BFT (mainnet & testnet) — Voyager active
Finality Instant — BFT 2/3+1 vote-based
Storage libmdbx — memory-mapped B+ tree (used by Reth/Erigon)
EVM revm 38 — Solidity contracts, MetaMask compatible (mainnet & testnet)
State Binary Sparse Merkle Tree (BLAKE3 + SHA-256) with proofs
Tokens SRC-20 native + SRC-20 (ERC-20 via EVM)
Network libp2p + Noise XX + Kademlia + Gossipsub
API REST (60+ endpoints) + JSON-RPC 2.0 (25 methods, incl. sentrix_* native namespace) + Tonic gRPC + gRPC-Web (docs) — GetBlock, GetBalance, server-streaming StreamEvents
Explorer Built-in dark-themed block explorer
Wallet AES-256-GCM keystore (Argon2id KDF)
Fee model 50% burn / 50% validator (deflationary)

Quick Start

# Build
git clone https://github.com/sentrix-labs/sentrix.git
cd sentrix
cargo build --release

# Test
cargo test    # 700+ tests

# Run a node
SENTRIX_VALIDATOR_KEY=<key> ./target/release/sentrix start --port 30303

# Check health
curl http://localhost:8545/health

Connect MetaMask (Testnet)

Field Value
Network name Sentrix Testnet
RPC URL https://testnet-rpc.sentrixchain.com/rpc
Chain ID 7120
Symbol SRX
Explorer https://scan.sentrixchain.com (toggle to Testnet in UI)

Full guide: docs/operations/METAMASK.md. Deploy a smart contract via Remix: docs/operations/SMART_CONTRACT_GUIDE.md. EVM internals: docs/architecture/EVM.md.

Architecture

crates/
├── sentrix-primitives/   Block, Transaction, Account, Error types
├── sentrix-codec/        Wire-format encoding helpers
├── sentrix-wire/         Wire-protocol message types
├── sentrix-wallet/       Keystore (Argon2id), wallet ops
├── sentrix-trie/         Binary Sparse Merkle Tree (MDBX backend)
├── sentrix-staking/      DPoS, epoch, slashing
├── sentrix-evm/          revm 38 adapter
├── sentrix-precompiles/  EVM precompiles
├── sentrix-bft/          BFT consensus (timeout-only round advance)
├── sentrix-core/         Blockchain, authority, executor, mempool, storage
├── sentrix-network/      libp2p P2P, gossipsub, kademlia
├── sentrix-rpc/          REST API, JSON-RPC, block explorer
├── sentrix-rpc-types/    Shared RPC request/response types
├── sentrix-storage/      MDBX wrapper + ChainStorage API
bin/sentrix/              CLI binary (main.rs at bin/sentrix/src/main.rs)

14 crates + 1 binary — node, API, explorer, CLI all ship as one executable.

Network

Mainnet Testnet
Chain ID 7119 7120
RPC rpc.sentrixchain.com testnet-rpc.sentrixchain.com
Consensus DPoS + BFT (4 validators) DPoS + BFT (4 validators)
Block time 1 second 1 second
EVM Active — MetaMask compatible Active — MetaMask compatible
Explorer scan.sentrixchain.com scan.sentrixchain.com (same unified UI, toggle Testnet)

Website: sentrixchain.com Faucet: faucet.sentrixchain.com (testnet) Wallet: solux.sentriscloud.com (Solux web) Docs: sentrixchain.com/docs/faucet Telegram: t.me/SentrixCommunity

Roadmap

Phase Status Focus
Pioneer Completed (mainnet h=0…579058) PoA round-robin, MDBX storage, 1s blocks, SRC-20 tokens — succeeded by Voyager 2026-04-25
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
Frontier Phase F-1 scaffold landed; F-2…F-10 planned Parallel transaction execution, sub-1s block time, mainnet hard fork
Odyssey Future Cross-chain bridges, mature ecosystem, light clients

Documentation

  • Whitepaper — foundational paper (vision, mission, design philosophy, protocol depth). Available in English and Bahasa Indonesia.
  • Architecture — consensus, state, networking, transactions
  • Operations — deployment, CI/CD, monitoring, validators
  • Claim Rewards — how validators + delegators claim escrowed rewards from PROTOCOL_TREASURY
  • Security — audit reports, attack vectors, pentest results
  • Tokenomics — SRX economics, staking, token standards
  • Roadmap — phase details, changelog

Security

See SECURITY.md for vulnerability reporting.

11 audit rounds completed (116 findings, 78+ fixed). Pentest 6/6 passed on live network.

Contributing

See CONTRIBUTING.md for development setup and PR process.

Community

License

Business Source License 1.1 (BUSL-1.1). Converts to Apache 2.0 after the Change Date.

About

Sentrix Chain — high-performance Layer-1 blockchain written in Rust. Native + EVM dual-layer execution.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors