I'm 18 and I'm building NOVAI, an AI-native Layer 1 blockchain written from scratch in Rust. This week I went open source and shipped a full set of developer docs. Here's everything that landed.
The project
NOVAI is a Layer 1 blockchain where AI entities are protocol primitives, not smart contracts. Most "AI blockchains" bolt AI onto an existing VM through oracle calls or contract wrappers. NOVAI does it differently. AI entities exist at the same level as accounts and validators. They have on-chain identity, persistent memory, economic balance, and capability flags. All enforced at the protocol layer.
There is no smart contract VM. No WASM runtime. Every transaction type is a native protocol operation.
The entire codebase is clean-room. No code from Substrate, Tendermint, Cosmos SDK, or any other implementation. 65,000+ lines of Rust across 16 crates, 1,100+ tests, zero unsafe code.
GitHub: github.com/0x-devc/NOVAI-node
Website: novai.network
What makes NOVAI different
On most blockchains, "AI integration" means an off-chain model that pokes the chain through oracle calls or contract wrappers. The AI runs somewhere else. The chain just stores the result.
NOVAI puts AI entities inside the protocol. An entity is a first-class on-chain identity that:
- Holds its own balance and pays its own fees
- Has its own Ed25519 signing key and signs its own transactions
- Publishes signal commitments (anomaly, prediction, risk-score, and 4 more types)
- Owns persistent memory objects (chain summaries, statistics snapshots, anomaly logs)
- Has governance-controlled autonomy modes and capability flags
The chain doesn't need to interpret bytecode to understand what an entity is doing. Every operation has known semantics at the protocol layer.
What shipped this week
Open source launch
The full codebase went public under Apache 2.0. Git history was cleaned. CI is green on GitHub Actions.
Developer docs - 5 deliverables
1. Quick Start Tutorial - "Build Your First AI Entity on NOVAI in 10 Minutes"
Step-by-step CLI walkthrough. Generate keys, fund from faucet, register an AI entity with its own signing key, publish a signal, create a memory object, query everything back. Every command and output block is real captured data from a live 4-node devnet.
2. TypeScript SDK Tutorial
170-line working example. Connect to a node, fund an account, transfer tokens, register an AI entity, verify it on chain. Self-contained npm project. Just run npm install && npm start.
3. Rust SDK Tutorial
Same flow in idiomatic async Rust on tokio. Single file, runs with cargo run --example quick-start.
4. RPC Reference
777 lines covering all 13 JSON-RPC endpoints. Each one has a description, parameter table, response shape, error table, and a real curl command with captured output.
5. Architecture Deep Dive
Crate-by-crate walkthrough of all 16 crates organized by dependency layer. Mermaid diagrams for the consensus flow and the transaction lifecycle. Three guided reading paths for newcomers.
Block explorer
React + Vite + Tailwind single-page app that calls the node's RPC endpoints. Live block list with 2-second polling, block detail page, account lookup, AI entity page with memory objects and signals, and a network stats dashboard. Developers run it locally against their devnet.
AI entity demos
Three runnable demos showing the AI-entity-as-protocol-primitive pattern.
Anomaly bot - A TypeScript bot that registers itself as an on-chain entity, polls chain activity every 1.5 seconds, runs three heuristic detectors (empty block streaks, round spikes, stalled chains), and publishes an anomaly signal plus a memory object whenever one fires. Cooldowns prevent re-firing on the same condition.
Multi-entity demo - Two bots interacting purely through the chain. Bot A (predictor) publishes prediction signals guessing future block tx counts. Bot B (risk-scorer) reads those predictions via on-chain memory objects, waits for the target block, compares predicted vs actual, and publishes a risk-score signal with the delta. No shared database. No API calls between them. Just on-chain data.
CLI demo script - Full entity lifecycle in bash with banner sections for blog posts or video recordings. Keygen, faucet, register, credit, signal publish, memory CRUD, query.
The bug fix that unblocked everything
While building the tutorials I found that entity-signed signal and memory transactions were silently failing through the RPC path. The root cause was four handlers using the wrong lookup key. They did a primary-key lookup with an address value instead of using the reverse index that maps address to entity ID. The entity record was never found so every signal and memory transaction quietly returned an error that got swallowed.
The fix was refactoring all four handlers into inner functions that take a pre-resolved entity. Added 7 regression tests that exercise the full dispatch path. Verified end-to-end on a live devnet.
I wrote about a similar silent-failure bug in my first blog post: The Bug That Silently Broke My Entire Blockchain
The numbers
- 65,000+ lines of Rust
- 16 crates in the workspace
- 1,100+ tests passing
- 30M+ blocks committed on the private testnet
- Zero unsafe code
- 10 native transaction types
- 4-validator private testnet running since early 2026
- HotStuff BFT consensus with 3-chain commit rule
- Sparse Merkle Tree state with deterministic 32-byte roots
- Ed25519 signatures, Blake3 hashing, Noise XX transport encryption
- Apache 2.0 licensed
What's next
Public testnet. The private testnet runs on a shared VPS that causes state root divergence under sustained load. The fix is a dedicated CPU server. Once that's in place we'll have a public RPC with SSL, validator onboarding, and the block explorer deployed at explorer.novai.network.
I'm also looking for a technical co-founder. I'm building this solo. If you're a Rust engineer interested in BFT consensus, on-chain AI primitives, or clean-room blockchain development, the codebase is open and PRs are welcome.
Website: novai.network
GitHub: github.com/0x-devc/NOVAI-node
Twitter: @NOVAInetwork
Top comments (0)