Developers

Build on Quantum-Safe
Infrastructure.

46 RPC endpoints. 3-command Cargo quickstart. Full Rust source on GitHub. TypeScript and Python SDKs in development. Node running in under five minutes.


Quickstart

Node Running in
3 Commands.

1
Clone the Repository

The complete 19-crate workspace. Rust stable required.

git clone https://github.com/BleepEcosystem/BLEEP-v1.git && cd BLEEP-v1
2
Build the Node

Full workspace build. Compiles all 19 crates in dependency order.

cargo build --workspace --release
3
Start a Local Node

Single-node devnet with all 46 RPC endpoints live on port 3030.

cargo run --bin bleep-node -- --config config/devnet.toml
bleep-node — devnet
$ cargo run --bin bleep-node -- --config config/devnet.toml Compiling bleep-crypto v0.5.0 Compiling bleep-zkp v0.5.0 Compiling bleep-consensus v0.5.0 Compiling bleep-node v0.5.0 Finished release [optimized] target(s) [ BLEEP ] Protocol Version 5 — Quantum Trust Network [ BLEEP ] Generating SPHINCS+ keypair ... done (32ms) [ BLEEP ] Generating Kyber-1024 keypair ... done (8ms) [ BLEEP ] Opening RocksDB column families ... done [ BLEEP ] Winterfell STARK self-test prove-verify ... passed (847ms) [ BLEEP ] Confirming 46 RPC endpoints active ... [ BLEEP ] Node ready — Block Height: 0 — Validators: 1 (devnet) [ BLEEP ] RPC listening on http://localhost:3030 $ curl http://localhost:3030/rpc/node/status {   "version": "5.0.0",   "block_height": 0,   "signature": "SPHINCS+-SHAKE-256f-simple",   "kem": "Kyber-1024/ML-KEM-1024",   "zk_proof_system": "Winterfell-STARK",   "status": "ready" }

RPC Reference

46 Endpoints.
Full Coverage.

Node
6 endpoints
GET/rpc/node/statusNode version, block height, cryptographic config, readiness state
GET/rpc/node/peersConnected peer list with SPHINCS+ public key hashes and latency
GET/rpc/node/metricsTPS, mempool depth, STARK proof generation time, uptime
GET/rpc/node/audit-logLast N tamper-evident audit log entries (SHA3-256 Merkle-chained)
GET/rpc/node/configActive node configuration and protocol parameters
POST/rpc/node/shutdownGraceful shutdown — requires admin JWT with appropriate role
Chain
7 endpoints
GET/rpc/chain/latest-blockMost recent finalised block with SPHINCS+ signature and STARK proof hash
GET/rpc/chain/block/:heightBlock by height — full header, transaction list, SMT root, proof reference
GET/rpc/chain/block-hash/:hashBlock by SHA3-256 block hash
GET/rpc/chain/epochCurrent epoch ID, block range, validator set, next rotation ETA
GET/rpc/chain/state-rootCurrent Sparse Merkle Trie root commitment (SHA3-256)
GET/rpc/chain/shard/:idShard status, block height, validator subset, and transaction throughput
GET/rpc/chain/finalityFinality status of a block — BFT precommit weight and irreversibility flag
Transactions
8 endpoints
POST/rpc/tx/submitSubmit SPHINCS+-signed transaction to mempool. Nonce, balance, and signature checked.
GET/rpc/tx/:hashTransaction status, inclusion block, execution result, and gas used
GET/rpc/tx/mempoolCurrent mempool — pending transactions ordered by fee descending
POST/rpc/tx/simulateSimulate transaction execution — returns gas estimate and outcome without broadcasting
GET/rpc/tx/history/:addressTransaction history for address — paginated, newest first
GET/rpc/tx/proof/:hashSMT inclusion proof (8,192 bytes) for a confirmed transaction
POST/rpc/tx/batchSubmit up to 256 transactions in a single API call
GET/rpc/tx/fee-estimateCurrent base fee and priority fee recommendations by confirmation target
Consensus & Validators
8 endpoints
GET/rpc/validatorsActive validator set — SPHINCS+ key hashes, stake, and uptime
GET/rpc/validators/:idSingle validator detail — commission, slashing history, rewards earned
POST/rpc/stakeDelegate stake to a validator
POST/rpc/unstakeInitiate unstaking — subject to epoch unbonding period
GET/rpc/consensus/stateCurrent BFT consensus round, prevotes, precommits, and supermajority status
GET/rpc/consensus/stark-proof/:blockRetrieve Winterfell STARK block validity proof for independent verification
GET/rpc/slashing/evidenceSlashing evidence committed to audit log — double-signs and equivocations
GET/rpc/rewards/:addressAccumulated staking rewards for an address; claimable balance
BLEEP Connect Bridge
6 endpoints
POST/rpc/bridge/intentSubmit cross-chain intent — auto-routed to appropriate tier
GET/rpc/bridge/intent/:idIntent status, selected tier, proof reference, and settlement ETA
GET/rpc/bridge/proof/:batchSTARK proof for a Tier 3 intent batch (SPHINCS+-bound)
GET/rpc/bridge/executorsActive Tier 4 executor list — bond amounts and timeout records
POST/rpc/bridge/quoteFee quote for a cross-chain transfer by amount and destination chain
GET/rpc/bridge/supported-chainsSupported destination chains, current status, and recommended tier
Governance
5 endpoints
GET/rpc/governance/proposalsAll proposals — active, passed, rejected — with current vote tally
POST/rpc/governance/submitSubmit governance proposal (requires 10,000 BLEEP deposit + SPHINCS+ signature)
POST/rpc/governance/voteCast ZK-encrypted stake-weighted vote (EncryptedBallot struct)
GET/rpc/governance/proposal/:idProposal detail — lifecycle stage, vote counts, AIConstraintValidator pre-flight result
GET/rpc/governance/constitutionConstitutional parameters and their compile-time enforcement source constants
Cryptography Utilities
6 endpoints
POST/rpc/crypto/verify-sigVerify SPHINCS+-SHAKE-256f-simple signature against public key and message
POST/rpc/crypto/verify-starkVerify Winterfell STARK block validity proof using only public inputs
POST/rpc/crypto/kem-encapsulateKyber-1024 key encapsulation against a validator public key
GET/rpc/crypto/smt-proof/:addressSparse Merkle Trie membership proof for an address (8,192 bytes fixed)
POST/rpc/crypto/hashSHA3-256 or BLAKE3 hash of arbitrary input data
GET/rpc/crypto/paramsAll cryptographic parameters — key sizes, signature sizes, security levels

SDKs

Client Libraries
in Development.

🦀
Rust SDK
Available — Source

Full workspace source. All 19 crates directly importable as library dependencies via Cargo.

🟦
TypeScript SDK
In Development

Wraps all 46 RPC endpoints. Wallet integration, transaction signing helpers, and bridge utilities.

🐍
Python SDK
In Development

Research and data tooling focus. Transaction analysis, validator monitoring, and STARK proof verification.


🚰

Testnet Faucet

Get testnet BLEEP for development. The faucet dispenses 1,000 BLEEP per address per epoch. Available after public testnet launch.

POST /rpc/faucet/drip · { "address": "bleep1..." }
Public Testnet — Phase 3 100K BLEEP Bug Bounty Pool