protocol-stack is the open-source research and implementation monorepo for a
sovereign, single-native-asset ecosystem: deterministic blockchain rules,
permanent Founder infrastructure, controlled applications, bounded self-hosted
AI authority, and a restricted external-value boundary.
The project is research software. Its Sovereign Devnet Alpha is runnable; the active milestone is an exact Founder Economy specification and independent proof before those economic rules enter C++ consensus. It is not production-ready.
- Founder Constitution
- Vision
- Project charter
- First operational goal
- Roadmap
- Current state and next action
- Documentation index
Claude Code sessions opened at the repository root automatically receive the instructions in CLAUDE.md, including the boundary between founder-reserved direction and autonomous engineering. A clean session can continue the next verified unit of work with:
proceed
For a concise, plain-language reality check covering what works, milestone progress, value, quality, maintainability, and what remains, use:
status
On a supported Linux x86_64 development host, one foreground command builds the required pinned binaries on first use, initializes four independent local validators, and starts the M1 devnet:
tools/devnet.sh startIn another terminal, inspect the exact four-replica height and root or submit the first public synthetic signed transfer:
tools/devnet.sh health
tools/devnet.sh transaction examples/devnet/transaction-1.hexPress Ctrl-C in the start terminal for an orderly stop. Run the same start
command to restart the retained homes and SQLite ledgers; the second fixture
then continues with nonce 2:
tools/devnet.sh transaction examples/devnet/transaction-2.hex 1The fixtures have public development keys and must never hold real value.
PROTOCOL_STACK_DEVNET_ROOT selects a different persistent network directory,
PROTOCOL_STACK_DEVNET_SOCKET_ROOT selects a shared short-lived socket
directory for all terminals, and PROTOCOL_STACK_DEVNET_BASE_P2P_PORT moves
the fixed local port block.
Configure, build, test, and run both the single-node compatibility integration and the complete four-validator lifecycle with:
tools/verify.shSee the build and test toolchain for host prerequisites and compiler/sanitizer presets.
Apache License 2.0. See LICENSE.