Skip to content

Repository files navigation

Constantinople

A high-throughput blockchain built on commonware primitives.

CI Codecov License commonware deepwiki

OverviewPackagesDemoDeploymentContributingLicense

Overview

Constantinople is a high-throughput account-model blockchain example built on top of commonware primitives.

Primitive Role
commonware-consensus (simplex) Single-epoch BFT consensus with BLS threshold signatures
commonware-consensus (marshal) Erasure-coded broadcast and backfill of finalized blocks
commonware-storage (QMDB) Merkleized key-value database for state and transactions
commonware-glue (stateful) Speculative state management and sync
commonware-p2p (discovery) Authenticated peer-to-peer networking with discovery

Packages

Package Description
constantinople-indexer Publishes finalized block artifacts and SQL metadata to exoware.
constantinople-explorer Streams indexer metadata into a live React block explorer.

Demo

Generate a local four-validator network with the indexer secondary, relayer, spammer, metadata indexer, QMDB indexer, and explorer:

cargo run --bin constantinople-deploy -- generate \
  --validators 4 \
  --indexer \
  --relayer \
  --output-dir ./local \
  --spammer --spammer-accounts 4096 --spammer-accounts-jitter 0.1 \
  local

The command prints an mprocs invocation that starts the generated local network. See bin/deploy/README.md for port and service details.

Deployment

See deploy/README.md.

Contributing

See CONTRIBUTING.md.

License

See LICENSE-MIT & LICENSE-APACHE.

About

A high-throughput blockchain built on commonware primitives.

Resources

Contributing

Security policy

Stars

25 stars

Watchers

0 watching

Forks

Used by

Contributors

Languages