OneCipher 介绍¶
面向 AI 代理的策略门控、本地密钥托管签名栈与统一敏感数据保险库。
OneCipher 严格遵循 WalletConnect v2 规范与开放钱包标准（Open Wallet Standard）设计实现，
为生产级代理工作负载加固。
它不只是钱包——它是私钥（12 条链）、密码、TOTP 密钥与加密笔记的单一加密保险库，
由 age（纯 Rust，无 GPG 依赖）、内存加固与策略引擎共同保护。
为什么需要 OneCipher？¶
AI 代理正在获得签名能力： 每一次交易、每一次工具调用、每一次会话授权—— 代理都需要用密钥签名。 但让代理裸奔持有私钥是灾难：
- 无边界：代理一次越权就能花光钱包、泄露密钥
- 无策略：链、金额、预算、时效没有任何门控
- 无审计：谁签了什么、为什么，无从追溯
- 碎片化：私钥、密码、TOTP、笔记散落在不同工具
OneCipher 用**策略先于签名**（Policy before signing）解决这些问题：
私钥只在 Key-Agent 进程内经策略检查后解密，
敏感材料存放在 mlock、MADV_DONTDUMP、zeroized 的加固内存中。
核心洞察¶
OneCipher 的 API 永远不返回原始私钥。
签名路径是审计过的、策略门控的、与网络隔离的。 代理只获得"能做什么"的授权，从不获得"密钥本身"。
工作原理¶
Text Only
[ dApp / 外部代理 ]
|
| WalletConnect v2 relay（WSS）
v
[ Network-Agent（tokio）]
| - WC v2 wallet server
| - JSON-RPC 方法路由
| - 本地 HTTP JSON-RPC（loopback）
| UDS（length-prefixed prost frames）
v
[ Key-Agent（sync，无 tokio/网络）]
| - 策略引擎 v2（签名前 11 步）
| - Passkey 认证 + 审计日志
| - 签名核心（12 条链）
| - 钱包保险库（age 加密）
核心特性¶
快速开始¶
- 架构 — 两层隔离、crate 依赖与硬门禁
- 安全模型 — 密钥生命周期、内存加固、威胁模型
- 策略引擎 — 11 步签名前评估
- 签名接口 — 各链签名方法与错误码
- 快速开始 — 安装、创建钱包、签名、统一保险库、agent 访问
- CLI 参考 — 完整命令参考
项目状态¶
OneCipher 是生产级实现：
- 测试：单元测试、proptest 属性测试、集成测试、
cargo-mutants变异测试 - 硬门禁（CI 强制）：R56（核心 crate 禁 async/网络）、R12（二进制无 TCP 符号）、 R51/R52（oc-crypto 零 I/O）、R55（Key-Agent 用 UDS）
- 真网验证：x402（Arc Testnet EIP-3009）与 MPP（Tempo Moderato）支付签名成功
许可证¶
Apache-2.0