zrChain

Overview

Zenrock is a Cosmos SDK-based blockchain providing bedrock security infrastructure for omnichain operations. It specializes in managing wrapped assets (Bitcoin via zenBTC, ZCash via zenZEC, and more) with oracle consensus, MPC-based signing, and cross-chain settlement.

Core Features:

• 🔐 Wrapped Assets - Bitcoin deposits → zenBTC, ZCash deposits → zenZEC
• 🤝 Oracle Consensus - Vote extensions for multi-chain data validation
• 🔑 MPC Signing - Secure multi-party computation for transaction signing
• 🔗 Cross-Chain - Solana, Ethereum, and more via Sidecar oracle
• 🪐 IBC Ready - Full Inter-Blockchain Communication support

New to the Team?

👋 Start with the Developer Onboarding Guide - It covers:

• Getting up and running in 30 minutes
• Understanding the architecture
• First week checklist
• Common development tasks

Then read CLAUDE.md for detailed developer reference and AGENTS.md for architecture deep-dives.

Table of Contents

• Overview
• New to the Team?
• Architecture
• Quick Start
• Contributing
• Commit & Release Workflow
• Resources
• Support
• License

Architecture

High-Level Design

┌─────────────────────────────────────────────────────────────┐
│                    zrChain (Cosmos Blockchain)              │
│  ┌────────┬─────────┬──────────┬─────────────────────────┐ │
│  │identity│ treasury│ validation│ zenbtc / dct / zentp   │ │
│  │ policy │  mint   │   wasm    │ Other Custom Modules   │ │
│  └────────┴─────────┴──────────┴─────────────────────────┘ │
│                         ↕ (gRPC)                            │
└──────────────────────────────────────────────────────────────┘
                              ↕
┌──────────────────────────────────────────────────────────────┐
│            Sidecar Oracle (Off-Chain Service)                │
│  • Watches Bitcoin, ZCash, Solana, Ethereum networks        │
│  • Runs EigenLayer operator loops with local keystores                              │
│  • Provides price feeds and block headers                   │
│  • Reports consensus signals to validators                          │
└──────────────────────────────────────────────────────────────┘

Key Modules

Module	Purpose
x/identity	Keyrings, workspaces, and multi-sig management
x/treasury	Asset custody and signature request workflows
x/zenbtc	Bitcoin wrapped asset (production, v0)
x/dct	Digital Currency Tokens framework (v1+, extensible)
x/validation	Validator management and oracle consensus
x/policy	Approval policies and governance
x/mint	Token minting
x/zentp	Zenrock token protocol

See CLAUDE.md for full module documentation.

Quick Start

Requirements

./scripts/dev-setup.sh

Run the bootstrap script once after cloning to install everything in one shot. It:

• Installs Go 1.25+, just, uv, and the full buf/protoc toolchain
• Detects macOS/Linux package managers automatically
• Guides Docker Desktop/Engine installation where automation isn’t possible

Prefer to manage things manually? Make sure you still have Go 1.25+, make, Docker, and the proto toolchain exposed on your PATH.

Installation & Local Network

# Install
git clone git@github.com:Zenrock-Foundation/zrchain.git
cd zrchain
make install

# Start local network (open 2 terminal tabs)
# Terminal 1:
./init.sh --localnet 1

# Terminal 2:
./init.sh --localnet 2

# Verify it's running
zenrockd status

See Developer Onboarding Guide for detailed setup instructions and common commands.

Project Structure

zrchain/
├── app/              # Blockchain setup and module wiring
├── cmd/              # CLI binary entry points
├── x/                # Custom modules (identity, treasury, zenbtc, dct, etc.)
├── sidecar/          # Off-chain oracle service
├── proto/            # Protocol Buffer definitions
├── tests/            # End-to-end tests
├── docs/             # Documentation
└── Makefile          # Build commands

Quick reference:

• 📖 Development Guide → docs/ONBOARDING.md
• 🔧 Developer Reference → CLAUDE.md
• 🏗️ Architecture Details → AGENTS.md

Agentic Worktrees

Parallel development is driven by the Justfile wrappers around the scripts in scripts/git/:

• just worktree-new (scripts/git/worktree-new.sh) – create a branch+worktree; when Graphite (gt) is installed, the script can call gt create -m … on the parent branch so the stack is tracked automatically.
• just worktree-switch – jump into an existing branch/worktree; with Graphite it uses gt get / gt checkout to stay in sync and can auto-track non-Graphite branches.
• just worktree-cleanup – interactive cleanup of stale worktrees.

Each script still works without Graphite, but when the CLI is available you get prompted to opt-in so the branch metadata is captured for stacked PRs. This is the foundation for the graphite + worktrees + agent workflow used by our AI agents.

Contributing

We appreciate all contributions to Zenrock and review them closely. See CONTRIBUTING.md for:

• Development guidelines
• Git conventions (commits, branches, PRs)
• Security considerations
• Code review process

Commit & Release Workflow

Zenrock uses semantic-release alongside the Conventional Commits specification to publish new versions automatically. Commit messages must follow the type(optional-scope)!: description pattern:

• feat: triggers a minor version bump.
• fix and perf: trigger a patch bump.
• Commits that include BREAKING CHANGE notes (or use type!: ...) trigger a major bump.
• Other conventional types (docs, chore, refactor, test, etc.) do not advance the version but must still follow the format.

See the Git conventions section for detailed guidance and examples.

Resources

Documentation

Document	For New Devs?	Topic
docs/ONBOARDING.md	✅ START HERE	Getting started, first steps, development setup
CLAUDE.md	✅ Recommended	Developer reference, commands, patterns, architecture
AGENTS.md	For deep dives	Wrapped asset flows, technical architecture
CONTRIBUTING.md	✅ Recommended	Contribution guidelines, git conventions, security

External Links

• Zenrock Website - Project overview and roadmap
• Discord - Validator + contributor chat
• Telegram - Community updates
• Twitter - Updates and news

Support

• 💬 Questions? - Ask in Discord or GitHub Issues
• 🐛 Found a bug? - Report it here
• 💡 Feature request? - Create an issue

License

Licensed under the Source Available License, Zenrock Foundation DAO. See LICENSE file for details.