This repository is the canonical technical documentation for the Atoshi Chain — a dual-layer blockchain that combines a Cosmos SDK L1 (with native EVM compatibility) and a Polygon CDK zkEVM L2, designed around a holding-based energy model that makes everyday transactions feel free for committed holders.
If you are looking for:
| Audience | Start here |
|---|---|
| First-time reader | 00-overview.md — what Atoshi is, who it's for, what's novel |
| Builder / developer | reference/api-guide.md — REST + JSON-RPC reference |
| Wallet integrator | reference/wallet-integration.md |
| Researcher / analyst | economics/ and modules/ |
| Operator / validator | architecture/ and reference/node-operation.md |
- 00 — Overview — mission, design goals, what we built
- 01 — High-level architecture — L1/L2/bridge mental model
- Cosmos SDK L1 with EVM
- Polygon CDK zkEVM L2
- Bridge between L1 and L2
- Account model and key management
- Energy — gas via holding, not paying
- Tokenomics — supply, release, halving
- Oracle — on-chain ATOS/USD price
- Bank — ATOS native transfers
- EVM — Ethereum-compatible execution
- Bridge — cross-layer asset movement
- Privacy — shielded transactions on L2
- Staking — validator economics
- Governance — on-chain proposals with case studies
- Supply and circulation
- Release schedule and halving curves
- Gas and energy economics
- Block rewards and validator income
- Burn and recycle mechanisms
- Threat model and design goals
- Shield pool — deposit, transfer, withdraw
- ZK circuits and proving system
- Energy settlement for private txs
- CLI reference (
atoshid) - Releases and versioning
- REST + JSON-RPC API reference
- Wallet integration handbook
- Node operation guide
- Governance runbook — submitting proposals, param changes, software upgrades
- Glossary
- FAQ
These docs track the main branch of atoshi-chain. When the chain releases a major version, this repo is tagged with the matching version. Older docs live in the corresponding tag.
Found something inaccurate, outdated, or unclear? Open a PR — every page has a Last reviewed: date in the footer; please update it when you change content. For larger structural changes, file an issue first.
Documentation released under CC-BY-SA 4.0. Code snippets embedded in docs are MIT.