Counselco/chronx

GitHub: Counselco/chronx

ChronX 是一条采用后量子签名算法、专为数十年期时间锁支付设计的无通胀区块链。

Stars: 0 | Forks: 0

ChronX Logo

ChronX

未来支付协议 —— 面向长期人类承诺的账本。

[![ChronX CI](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/847f17b9b3110851.svg)](https://github.com/Counselco/chronx/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-gold.svg)](LICENSE) [![Rust](https://img.shields.io/badge/Rust-stable-orange.svg)](https://www.rust-lang.org) [![Release](https://img.shields.io/badge/release-v1.0.0-blue.svg)](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, 价值存储, 信托, 公链, 养老金, 分布式账本, 加密货币, 区块链, 去中心化金融, 可视化界面, 后量子密码学, 抗量子, 支付协议, 数字遗产, 时间锁, 时间锁定, 智能合约, 网络安全, 网络流量审计, 通知系统, 金融承诺, 金融科技, 长期托管, 隐私保护, 零通胀