Counselco/chronx
GitHub: Counselco/chronx
ChronX 是一条采用后量子签名算法、专为数十年期时间锁支付设计的无通胀区块链。
Stars: 0 | Forks: 0
ChronX
未来支付协议 —— 面向长期人类承诺的账本。
[](https://github.com/Counselco/chronx/actions/workflows/ci.yml)
[](LICENSE)
[](https://www.rust-lang.org)
[](https://github.com/Counselco/chronx/releases)
## ChronX 是什么?
ChronX 是一个为单一目标构建的后量子区块链:让长期的金融承诺像物理现实一样值得信赖且永久有效。传统金融需要中介来执行延期付款 —— 例如托管代理、受托人、银行 —— 而 ChronX 则通过软件在密码学层面上执行这些操作,无需托管人。
ChronX 协议围绕一种称为 *承诺* 的时间锁智能合约设计。一个承诺会锁定固定数量的 KX(ChronX 的原生代币),直到特定的 UTC 时间戳 —— 范围可以从未来的一小时到一百年。一旦解锁日期过去,只有指定的接收人才能提取资金,且一旦提交,任何一方都无法撤销或加速锁定。这使 ChronX 成为首个专为数十年期金融义务量身定制的区块链:继承、养老金、基于里程碑的支付、长期托管和个人储蓄承诺。
ChronX 从第一天起就具备抗量子特性,在所有交易中使用 Dilithium2 (CRYSTALS-Dilithium) 后量子签名。KX 的供应量固定为 8,270,000,000 —— 没有通胀,没有挖矿奖励,没有新发行 —— 并且创世设计公平透明,ChronX 旨在持久运行。
## 为什么选择 ChronX?
- **抗量子** — 所有签名均使用 Dilithium2 (NIST PQC 标准),而非 ECDSA 或 Ed25519
- **原生时间锁** — 拥有 UTC 解锁时间戳的一流链上承诺,而非脚本变通方案
- **索赔解决** — 内置针对有争议索赔的纠纷框架,包含验证者投票和挑战期
- **无通胀** — 固定供应 8,270,000,000 KX;无区块奖励,永不增发
- **无托管人** — 锁定由协议强制执行;无需托管代理、银行或受托人
- **100 年跨度** — 专为比机构更长久的承诺而设计
- **开源** — MIT 许可;每一行共识逻辑均可审计
## 快速开始
```
# 克隆 repository
git clone https://github.com/Counselco/chronx.git
cd chronx
# 构建 full node
cargo build --release -p chronx-node
# 生成 genesis parameters(仅首次运行)
# 如果省略 --genesis-params,node 将自动生成 ephemeral keys。
# 对于生产环境,请提供您自己的 genesis-params.json。
# 运行 node(开发)
./target/release/chronx-node \
--data-dir ~/.chronx/data \
--rpc-addr 127.0.0.1:8545 \
--p2p-listen /ip4/0.0.0.0/tcp/7777
# 构建并运行 CLI wallet
cargo build --release -p chronx-wallet
./target/release/chronx-wallet generate
./target/release/chronx-wallet balance
```
## 运行节点
```
chronx-node [OPTIONS]
```
| Flag | Default | Description |
|---|---|---|
| `--data-dir
` | `~/.chronx/data` | 状态数据库目录 |
| `--p2p-listen ` | `/ip4/0.0.0.0/tcp/7777` | libp2p 监听地址 |
| `--rpc-addr ` | `127.0.0.1:8545` | JSON-RPC 2.0 监听地址 |
| `--bootstrap ` | *(none)* | 逗号分隔的引导节点多地址 |
| `--genesis-params ` | *(auto-generate)* | `genesis-params.json` 的路径(生产环境必需) |
| `--pow-difficulty ` | `20` | PoW 难度(SHA3-256 前导零位数) |
**示例 —— 加入现有网络:**
```
chronx-node \
--data-dir ~/.chronx/data \
--rpc-addr 0.0.0.0:8545 \
--p2p-listen /ip4/0.0.0.0/tcp/7777 \
--bootstrap /ip4/1.2.3.4/tcp/7777/p2p/12D3Koo... \
--genesis-params /etc/chronx/genesis-params.json
```
节点在 `--rpc-addr` 上暴露 JSON-RPC 2.0 API,并为浏览器客户端启用了 CORS 标头。请参阅下方的 [RPC API](#rpc-api)。
## 使用钱包
CLI 钱包默认连接到运行在 `http://127.0.0.1:8545` 的节点。
```
# 生成新的 keypair 和 wallet 文件
chronx-wallet generate
# 检查您的余额
chronx-wallet balance
# 向另一个账户发送 KX
chronx-wallet send --to --amount 100.0
# 创建 time-locked promise(给自己,2030-01-01 解锁)
chronx-wallet lock --amount 500.0 --unlock 2030-01-01
# 列出您所有的 time-locks
chronx-wallet locks
# Claim 一个已成熟的 lock
chronx-wallet claim --lock-id
# 导出您的 Dilithium2 公钥 (hex)
chronx-wallet export-pubkey
```
图形界面钱包(Windows + Android)可在 [Counselco/wallet-gui](https://github.com/Counselco/wallet-gui) 获取。
## 架构
ChronX 被构建为一个包含 12 个专注模块的 Rust 工作区:
| Crate | Description |
|---|---|
| `chronx-core` | 核心类型:`Account`、`TimeLockContract`、`Transaction`、`AuthPolicy`、枚举 |
| `chronx-crypto` | 后量子 Dilithium2 签名,BLAKE3/SHA3 哈希,PoW 挖矿 |
| `chronx-dag` | DAG 顶点结构和父级验证规则 |
| `chronx-state` | `StateDb` (基于 sled 的存储) + `StateEngine` (共识 + 状态转换) |
| `chronx-consensus` | PoW 难度调整,终局性规则,验证者逻辑 |
| `chronx-timelock` | 时间锁查询辅助工具和国库释放计划 |
| `chronx-recovery` | 账户恢复:验证者投票,挑战机制,费用计算 |
| `chronx-p2p` | libp2p 网络:GossipSub 广播 + Kademlia 节点发现 |
| `chronx-rpc` | JSON-RPC 2.0 服务器,支持 CORS,提供 20 多个 API 端点 |
| `chronx-node` | 全节点二进制文件:创世初始化,P2P + RPC 启动,交易管道 |
| `chronx-wallet` | CLI 钱包客户端:密钥对管理,转账,时间锁 |
| `chronx-genesis` | 一次性创世状态构建器:5 笔分配 → 总计 8,270,000,000 KX |
## 创世
ChronX 的创世状态是确定性的,并在每次节点启动时进行验证。
**创世时间戳:** 2026-01-01 00:00:00 UTC
| Allocation | Amount (KX) | Unlock |
|---|---|---|
| 公开销售 | 7,268,000,000 | 立即(创世时可花费) |
| 国库 (100 个年度锁) | 1,000,000,000 | 对数递减计划,2027–2126 |
| 人类权益 | 1,000,000 | 2127-01-01 |
| 2076 里程碑 | 500,000 | 2076-01-01 |
| 协议储备 | 500,000 | 2036-01-01 |
| **Total** | **8,270,000,000** | — |
所有创世锁 ID 都是确定性的(固定字符串的 BLAKE3 哈希),无法被伪造或复制。
## RPC API
节点暴露一个 JSON-RPC 2.0 API。所有方法均以 `chronx_` 为前缀。
```
POST http://127.0.0.1:8545
Content-Type: application/json
```
| Method | Parameters | Description |
|---|---|---|
| `chronx_getAccount` | `account_id: String` | 账户余额、nonce、锁计数器、验证者权益 |
| `chronx_getBalance` | `account_id: String` | 以 Chronos 为单位的原始余额 (1 KX = 1,000,000 Chronos) |
| `chronx_sendTransaction` | `tx_hex: String` | 提交一个已签名且经 PoW 求解的交易 |
| `chronx_getTransaction` | `tx_id: String` | 通过 TxId 获取序列化的交易顶点 |
| `chronx_getTimeLockContracts` | `account_id: String` | 账户作为发送方或接收方的所有锁 |
| `chronx_getTimeLockById` | `lock_id: String` | 通过 TxId 十六进制获取单个锁 |
| `chronx_getPendingIncoming` | `account_id: String` | 账户为接收方的待处理锁 |
| `chronx_getTimeLockContractsPaged` | `account_id, offset, limit` | 分页锁列表(最大 200 条/页) |
| `chronx_getRecentTransactions` | `limit: u64` | 最近的 N 笔交易(最大 200 笔) |
| `chronx_getChainStats` | *(none)* | 账户数、时间锁数、顶点数、DAG 深度 |
| `chronx_cancelLock` | `tx_hex: String` | 提交一个 `CancelTimeLock` 交易 |
| `chronx_getVersion` | *(none)* | 节点版本,协议版本,API 版本 |
| `chronx_getGenesisInfo` | *(none)* | 创世时间戳,总供应量,初始 PoW 难度 |
| `chronx_getDagTips` | *(none)* | 当前 DAG 顶端 TxIds |
| `chronx_getNetworkInfo` | *(none)* | 用于引导分享的本地节点多地址 |
| `chronx_searchLocks` | `query: SearchQuery` | 按账户、状态、标签、日期范围筛选锁 |
## 路线图
| Phase | Status | Description |
|---|---|---|
| 第一阶段:主网启动 | 进行中 | 创世,全节点,CLI 钱包,GUI 钱包 (Windows + Android) |
| 第二阶段:移动钱包 | 计划中 | iOS 钱包,生物识别解锁,二维码承诺分享 |
| 第三阶段:索赔解决 | 计划中 | 激活 V2 索赔状态机,验证者质押,纠纷门户 |
| 第四阶段:DEX / 市场 | 计划中 | 可转让承诺的二级市场 (V3.1 可转让性) |
| 第五阶段:DAO 治理 | 计划中 | 用于协议参数更新的链上治理 |
## 安全性
ChronX 使用后量子密码学 (Dilithium2) 并严肃对待所有安全报告。请参阅 [SECURITY.md](SECURITY.md) 了解我们的漏洞披露政策。
## 许可证
MIT —— 请参阅 [LICENSE](LICENSE)。
## 链接
- **网站:** [chronx.io](https://chronx.io)
- **文档与白皮书:** [github.com/Counselco/chronx-docs](https://github.com/Counselco/chronx-docs)
- **白皮书:** [ChronX_Whitepaper_v2.0.docx](https://github.com/Counselco/chronx-docs/blob/main/whitepaper/ChronX_Whitepaper_v2.0.docx)
- **GUI 钱包:** [github.com/Counselco/wallet-gui](https://github.com/Counselco/wallet-gui)标签:Dilithium2, Rust, 价值存储, 信托, 公链, 养老金, 分布式账本, 加密货币, 区块链, 去中心化金融, 可视化界面, 后量子密码学, 抗量子, 支付协议, 数字遗产, 时间锁, 时间锁定, 智能合约, 网络安全, 网络流量审计, 通知系统, 金融承诺, 金融科技, 长期托管, 隐私保护, 零通胀