https://github.com/satyakwok/sentrix
Fast, deterministic Layer-1 blockchain for payments, tokens, and decentralized apps.
https://github.com/satyakwok/sentrix
bitcoin blockchain cryptocurrency cryptography dpos-bft ethereum evm rust
Last synced: 2 months ago
JSON representation
Fast, deterministic Layer-1 blockchain for payments, tokens, and decentralized apps.
- Host: GitHub
- URL: https://github.com/satyakwok/sentrix
- Owner: satyakwok
- License: other
- Created: 2026-04-09T00:32:59.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-16T06:35:02.000Z (2 months ago)
- Last Synced: 2026-04-16T06:44:46.708Z (2 months ago)
- Topics: bitcoin, blockchain, cryptocurrency, cryptography, dpos-bft, ethereum, evm, rust
- Language: Rust
- Homepage:
- Size: 867 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Sentrix
Fast, secure Layer-1 blockchain built in Rust.
[](https://github.com/satyakwok/sentrix/actions)
[](https://github.com/satyakwok/sentrix/releases/latest)
[](https://github.com/satyakwok/sentrix/actions)
[](Cargo.toml)
[](docs/operations/NETWORKS.md)
[](LICENSE)
---
## What is Sentrix?
Sentrix (SRX) is a purpose-built Layer-1 blockchain with 3-second block times, instant finality, and Ethereum-compatible tooling. MetaMask, ethers.js, and web3.js connect natively.
- **v1.2.0** — Voyager EVM live on testnet (revm + `eth_sendRawTransaction`), DPoS+BFT consensus, PoA on mainnet
- **519 tests**, clippy clean, 11 security audit rounds
- **7 validators** across 3 nodes, zero-downtime rolling CI/CD
## Features
| | |
|---|---|
| **Consensus** | PoA round-robin (Pioneer) + DPoS/BFT (Voyager testnet) |
| **Finality** | Instant — BFT 2/3+1 vote-based on testnet |
| **EVM** | revm 37 — Solidity contracts, MetaMask compatible (testnet) |
| **State** | Binary Sparse Merkle Tree (BLAKE3 + SHA-256) with proofs |
| **Tokens** | SRX-20 native + SRC-20 (ERC-20 via EVM) |
| **Network** | libp2p + Noise XX + Kademlia + Gossipsub |
| **API** | REST (25+ endpoints) + JSON-RPC 2.0 (20 methods) |
| **Explorer** | Built-in dark-themed block explorer |
| **Wallet** | AES-256-GCM keystore (Argon2id KDF) |
| **Fee model** | 50% burn / 50% validator (deflationary) |
## Quick Start
```bash
# Build
git clone https://github.com/satyakwok/sentrix.git
cd sentrix
cargo build --release
# Test
cargo test # 519 tests
# Run a node
SENTRIX_VALIDATOR_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.sentriscloud.com/rpc` |
| Chain ID | `7120` |
| Symbol | `SRX` |
| Explorer | `https://testnet-explorer.sentriscloud.com` |
Full 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).
## Architecture
```
src/
├── core/ # Blockchain engine, consensus, state trie, tokens
├── network/ # libp2p P2P: Noise XX, Kademlia, Gossipsub
├── api/ # REST + JSON-RPC + block explorer
├── wallet/ # Key generation, Argon2id keystore
└── storage/ # sled embedded database
```
Single binary — node, API, explorer, CLI all ship as one ~12 MB executable.
## Network
| | Mainnet | Testnet |
|---|---|---|
| **Chain ID** | 7119 | 7120 |
| **RPC** | [sentrix-rpc.sentriscloud.com](https://sentrix-rpc.sentriscloud.com) | [testnet-rpc.sentriscloud.com](https://testnet-rpc.sentriscloud.com) |
| **Consensus** | PoA (7 validators) | DPoS + BFT (4 validators) |
| **EVM** | Disabled | Active — MetaMask compatible |
| **Explorer** | sentrixscan.sentriscloud.com | testnet-explorer.sentriscloud.com |
**Explorer:** [sentrixscan.sentriscloud.com](https://sentrixscan.sentriscloud.com)
**Wallet:** [sentrix-wallet.sentriscloud.com](https://sentrix-wallet.sentriscloud.com)
**Faucet:** [faucet.sentriscloud.com](https://faucet.sentriscloud.com)
**Telegram:** [t.me/SentrixCommunity](https://t.me/SentrixCommunity)
## Roadmap
| Phase | Status | Focus |
|-------|--------|-------|
| **Pioneer** | Live (mainnet) | PoA consensus, SRX-20 tokens, SentrixTrie, libp2p |
| **Voyager** | Live (testnet) | DPoS + BFT finality, EVM (revm 37), eth_sendRawTransaction |
| **Frontier** | Planned | Mainnet hard fork, ecosystem expansion, dApps |
| **Odyssey** | Future | Cross-chain, mature ecosystem |
## Documentation
- [Architecture](docs/architecture/) — consensus, state, networking, transactions
- [Operations](docs/operations/) — deployment, CI/CD, monitoring, validators
- [Security](docs/security/) — audit reports, attack vectors, pentest results
- [Tokenomics](docs/tokenomics/) — SRX economics, staking, token standards
- [Roadmap](docs/roadmap/) — phase details, changelog
## Security
See [SECURITY.md](SECURITY.md) for vulnerability reporting.
11 audit rounds completed (116 findings, 78+ fixed). Pentest 6/6 passed on live network.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and PR process.
## License
[Business Source License 1.1](LICENSE) (BUSL-1.1). Converts to Apache 2.0 after the Change Date.