@twinsearth/agent-universe 2.5.6 → 2.5.8

package/README.md

@@ -273,7 +273,7 @@ npm config set @twinsearth:registry https://npm.pkg.github.com
 npm install @twinsearth/agent-universe
 ```
 
-已发布版本：1.0.0 / 2.0.0 / 2.2.0 / 2.3.0 / 2.3.1 / 2.3.4 / 2.3.5 / 2.3.6 / 2.4.0 ~ 2.5.6，详见 [Releases](https://github.com/TwinsEarth/agent-universe/releases)。
+已发布版本：1.0.0 / 2.0.0 / 2.2.0 / 2.3.0 / 2.3.1 / 2.3.4 / 2.3.5 / 2.3.6 / 2.4.0 ~ 2.5.8，详见 [Releases](https://github.com/TwinsEarth/agent-universe/releases)。
 
 ## 版本谱系
 
@@ -307,6 +307,8 @@ npm install @twinsearth/agent-universe
 | v2.5.4 | **Traversal** | **NAT 穿透：Circuit Relay v2 + AutoNAT + DCUtR + Ping，跨网中继** |
 | v2.5.5 | **Relay Pool** | **Relay 节点池管理 + 多通道智能切换（默认 3 条，掉线自动补）** |
 | v2.5.6 | **Regression** | **历史 Bug 回归套件：test/ 14 条 + Rust 网络回归，CI 强制全量回归，修新 bug 先加用例** |
+| v2.5.7 | **Identity** | **跨实现身份一致性：统一 DID 派生口径 + conformance 签名向量逐字节命中上游 + 客户端构建链路根治（file: 依赖）** |
+| v2.5.8 | **Ledger** | **精确整数账本 Money(i64)：守恒精确相等无容差 + 发布即托管 __escrow__ 防铸币 + 三端共享金额向量逐值一致** |
 
 详见 [RELEASES.md](RELEASES.md) 和 [releases/](releases/) 目录。
 

package/js/index.js

@@ -9,7 +9,7 @@ const { AgentMarket, Bid, Reputation, MIN_STAKE } = require('./lib/market');
 const { McpHttpClient, McpError, MCP_PROTOCOL_VERSION } = require('./lib/mcp');
 const aca = require('./lib/aca');
 
-const version = '2.5.6';
+const version = '2.5.8';
 
 /**
  * AgentUniverse 门面：聚合身份、网络、市场能力

package/js/lib/aca.js

@@ -129,7 +129,7 @@ function buildManifest(identity, name, capabilities, opts = {}) {
   const manifest = {
     did: identity.did,
     name,
-    version: opts.version || '2.5.6',
+    version: opts.version || '2.5.8',
     capabilities: [...capabilities],
     endpoints: opts.endpoints || [],
     hardware: {

package/js/lib/keychain.js

@@ -1,29 +1,51 @@
 // lib/keychain.js
 // Ed25519 密钥对 + DID 身份（零依赖，使用 node:crypto）
+//
+// v2.5.7：身份派生口径与 Rust / Python 统一 ——
+//   fingerprint = hex(SHA-256(原始 32 字节公钥)[..8])
+// 本项目新铸造身份使用 did:nau: 前缀；parseDid 仍接受上游 did:aip:。
 
 const crypto = require('node:crypto');
 
+// Ed25519 SubjectPublicKeyInfo DER 固定前缀（其后紧跟 32 字节原始公钥）
+const SPKI_PREFIX = Buffer.from('302a300506032b6570032100', 'hex');
+
 /**
  * 密钥对与去中心化身份
  */
 class Keypair {
   constructor(publicKey, privateKey, did) {
-    this.publicKey = publicKey;   // hex
-    this.privateKey = privateKey; // hex（node KeyObject 可导出的形式）
-    this.did = did;               // did:au:<hash>
+    this.publicKey = publicKey;   // SPKI DER hex
+    this.privateKey = privateKey; // PKCS8 DER hex
+    this.did = did;               // did:nau:<fingerprint>
+  }
+
+  /** 从原始 32 字节公钥计算 fingerprint（与 Rust/Python 一致） */
+  static fingerprint(rawPubkey) {
+    return crypto.createHash('sha256')
+      .update(rawPubkey)
+      .digest('hex')
+      .slice(0, 16); // 前 8 字节 = 16 hex 字符
+  }
+
+  /** 解析 DID，接受上游 did:aip: 与本项目 did:nau:；返回 {method, identifier} */
+  static parseDid(s) {
+    const m = /^did:(aip|nau):([0-9a-f]+)$/.exec(s);
+    if (!m) {
+      throw new Error(`不支持的 DID（格式应为 did:<aip|nau>:<id>）: ${s}`);
+    }
+    return { method: m[1], identifier: m[2] };
   }
 
-  /** 生成新的 Ed25519 密钥对与 DID */
+  /** 生成新的 Ed25519 密钥对与 DID（新身份使用 did:nau:） */
   static generate() {
     const { publicKey, privateKey } = crypto.generateKeyPairSync('ed25519');
-    const pubHex = publicKey.export({ format: 'der', type: 'spki' })
-      .toString('hex');
-    // DID 由公钥的 SHA-256 哈希（取前 32 字符）派生
-    const didHash = crypto.createHash('sha256')
-      .update(publicKey.export({ format: 'der', type: 'spki' }))
-      .digest('hex')
-      .slice(0, 32);
-    const did = `did:au:${didHash}`;
+    const spkiDer = publicKey.export({ format: 'der', type: 'spki' });
+    const pubHex = spkiDer.toString('hex');
+
+    // 去掉 SPKI 固定前缀，得到 32 字节原始公钥
+    const rawPub = spkiDer.subarray(SPKI_PREFIX.length);
+    const did = `did:nau:${Keypair.fingerprint(rawPub)}`;
 
     // 私钥以 PKCS8 DER hex 保存，便于重建 KeyObject
     const privHex = privateKey.export({ format: 'der', type: 'pkcs8' })
@@ -57,6 +79,12 @@ class Keypair {
     return this._pubKeyObj;
   }
 
+  /** 返回 32 字节原始公钥 */
+  rawPublicKey() {
+    const spkiDer = this._publicKeyObject().export({ format: 'der', type: 'spki' });
+    return spkiDer.subarray(SPKI_PREFIX.length);
+  }
+
   /** 对消息签名，返回 hex */
   sign(message) {
     const data = Buffer.isBuffer(message) ? message : Buffer.from(message);

package/js/lib/market.js

@@ -41,8 +41,17 @@ class AgentMarket {
     this.paidTasks = new Set();   // 已结算任务（防重复支付）
   }
 
+  /** 金额必须是安全整数（与 Rust Money(i64) 对齐，杜绝浮点导致的跨语言守恒失效） */
+  _assertMoney(v, label) {
+    if (typeof v !== 'number' || !Number.isInteger(v) || !Number.isSafeInteger(v)) {
+      throw new Error(`${label || '金额'}必须是整数`);
+    }
+    return v;
+  }
+
   /** 充值 / 质押金进入账户 */
   deposit(account, amount) {
+    this._assertMoney(amount, '金额');
     if (amount < 0) throw new Error('金额不能为负');
     const cur = this.balances.get(account) || 0;
     this.balances.set(account, cur + amount);
@@ -57,11 +66,17 @@ class AgentMarket {
     return `__stake__:${agentId}`;
   }
 
+  /** 任务预算托管账户（发布即锁定，结算时从此支付 / 退款），与 Rust 命名一致 */
+  _escrowAccount(taskId) {
+    return `__escrow__:${taskId}`;
+  }
+
   /** 注册 Agent（需质押 ≥ MIN_STAKE） */
   registerAgent(card, stake) {
     if (!card || !card.did) throw new Error('agent_id 不能为空');
     if (!card.name) throw new Error('name 不能为空');
     if (this.agents.has(card.did)) throw new Error('Agent 已存在');
+    this._assertMoney(stake, '质押');
     if (stake < MIN_STAKE) {
       throw new Error(`质押不足，最低 ${MIN_STAKE}`);
     }
@@ -86,12 +101,15 @@ class AgentMarket {
   /** 发布任务 */
   publishTask(taskId, goal, budget, requester) {
     if (!goal) throw new Error('goal 不能为空');
+    this._assertMoney(budget, '预算');
     if (budget <= 0) throw new Error('预算必须为正');
     if (this.balance(requester) < budget) {
       throw new Error('需求方余额不足以覆盖预算');
     }
-    // 预算锁定
+    // 发布即托管：预算从需求方转入任务托管账户（钱仍在系统内，任意时刻守恒）
     this.balances.set(requester, this.balance(requester) - budget);
+    const escrowAcc = this._escrowAccount(taskId);
+    this.balances.set(escrowAcc, this.balance(escrowAcc) + budget);
 
     const task = new Task(taskId, goal);
     task.transition(TaskStatus.OPEN);
@@ -105,6 +123,8 @@ class AgentMarket {
   /** 提交投标 */
   submitBid(taskId, agentId, price) {
     if (!this.agents.has(agentId)) throw new Error('Agent 未注册');
+    this._assertMoney(price, '出价');
+    if (price <= 0) throw new Error('出价必须为正');
     const task = this.tasks.get(taskId);
     if (!task || task.status !== TaskStatus.OPEN) {
       throw new Error('任务不在开放状态');
@@ -166,12 +186,15 @@ class AgentMarket {
     const price = task.winnerPrice || task.budget;
     const pay = Math.min(price, task.budget);
 
-    // 从任务锁定预算中支付给执行者（账户间转账，系统总余额不变）
+    // 从托管账户支付给执行者、余款退还需求方（账户间转账，总余额不变）
+    const escrowAcc = this._escrowAccount(taskId);
     const assignee = task.assignee;
+    this.balances.set(escrowAcc, this.balance(escrowAcc) - pay);
     this.balances.set(assignee, this.balance(assignee) + pay);
     // 未用完的预算退还需求方
     const refund = task.budget - pay;
     if (refund > 0) {
+      this.balances.set(escrowAcc, this.balance(escrowAcc) - refund);
       this.balances.set(task.requester, this.balance(task.requester) + refund);
     }
 
@@ -184,6 +207,8 @@ class AgentMarket {
   slash(agentId, amount, reason) {
     const entry = this.agents.get(agentId);
     if (!entry) throw new Error('Agent 不存在');
+    this._assertMoney(amount, '罚没金额');
+    if (amount <= 0) throw new Error('罚没金额必须为正');
     const actual = Math.min(amount, entry.stake);
     entry.stake -= actual;
     // 从锁定账户实际扣除（退出系统）
@@ -229,7 +254,7 @@ class AgentMarket {
     for (const v of this.balances.values()) balanceSum += v;
     const expected = totalDeposits - this.totalSlashed;
     return {
-      conserved: Math.abs(balanceSum - expected) < 1e-9,
+      conserved: balanceSum === expected,
       balanceSum,
       totalSlashed: this.totalSlashed,
       expected,

package/js/lib/mcp.js

@@ -60,7 +60,7 @@ class McpHttpClient {
       method: 'initialize',
       params: {
         protocolVersion: MCP_PROTOCOL_VERSION,
-        clientInfo: { name: 'agent-universe-js', version: '2.5.6' },
+        clientInfo: { name: 'agent-universe-js', version: '2.5.8' },
         capabilities: {},
       },
     });

package/js/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@twinsearth/agent-universe",
-  "version": "2.5.6",
+  "version": "2.5.8",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@twinsearth/agent-universe",
-      "version": "2.5.6",
+      "version": "2.5.8",
       "license": "MIT",
       "engines": {
         "node": ">=18"

package/js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/agent-universe",
-  "version": "2.5.6",
+  "version": "2.5.8",
   "description": "Agent Universe - 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络。使命：让科技造福全人类！",
   "main": "index.js",
   "types": "index.d.ts",

package/js/test/test.js

@@ -1,7 +1,9 @@
 // test/test.js
-// Agent Universe JS SDK 测试（8 项）
+// Agent Universe JS SDK 测试（14 项）
 
 const assert = require('node:assert');
+const fs = require('node:fs');
+const path = require('node:path');
 const {
   version,
   AgentUniverse,
@@ -41,15 +43,15 @@ function test(name, fn) {
 console.log('Agent Universe JS SDK 测试\n');
 
 // 1. 版本号
-test('版本号为 2.5.6', () => {
-  assert.strictEqual(version, '2.5.6');
+test('版本号为 2.5.8', () => {
+  assert.strictEqual(version, '2.5.8');
 });
 
 // 2. 密钥对 + DID + 签名验证
 test('Keypair 生成 DID 且签名可验证', () => {
   const kp = Keypair.generate();
-  assert.ok(kp.did.startsWith('did:au:'), 'DID 前缀');
-  assert.strictEqual(kp.did.length, 'did:au:'.length + 32);
+  assert.ok(kp.did.startsWith('did:nau:'), 'DID 前缀');
+  assert.strictEqual(kp.did.length, 'did:nau:'.length + 16);
   const msg = 'hello agent universe';
   const sig = kp.sign(msg);
   assert.ok(kp.verify(msg, sig), '签名验证通过');
@@ -154,6 +156,45 @@ test('罚没后守恒：总余额 = 总充值 − 罚没', () => {
   assert.strictEqual(check.balanceSum, 140);
 });
 
+// 8b. 整数账本：拒绝浮点金额与 0/负出价（与 Rust Money(i64) 对齐）
+test('整数账本：拒绝浮点金额与非正出价', () => {
+  const market = new AgentMarket();
+  const owner = 'did:au:int';
+  assert.throws(() => market.deposit(owner, 10.5), /整数/);
+  market.deposit(owner, 200);
+  const card = AgentCard.new({ did: owner, name: 'int' });
+  market.registerAgent(card, MIN_STAKE);
+  market.publishTask('t-int', 'goal', 50, owner);
+  assert.throws(() => market.submitBid('t-int', owner, 0), /正/);
+  assert.throws(() => market.submitBid('t-int', owner, -5), /正/);
+  assert.throws(() => market.submitBid('t-int', owner, 5.5), /整数/);
+});
+
+// 8c. 跨语言金额向量：逐账户余额命中 conformance/money-vectors.json（与 Rust 一致）
+test('跨语言金额向量：逐账户余额命中 conformance 向量', () => {
+  const vector = JSON.parse(
+    fs.readFileSync(path.join(__dirname, '../../conformance/money-vectors.json'), 'utf8')
+  );
+  const market = new AgentMarket();
+  market.deposit('agent-1', 100);
+  const card = AgentCard.new({ did: 'agent-1', name: 'worker' }).withSkill('writing');
+  market.registerAgent(card, MIN_STAKE);
+  market.deposit('requester-1', 50);
+  market.publishTask('task-1', 'translate', 50, 'requester-1');
+  market.submitBid('task-1', 'agent-1', 10);
+  assert.strictEqual(market.matchTask('task-1').agentId, 'agent-1');
+  market.completeTask('task-1', true);
+  const paid = market.settle('task-1');
+  assert.strictEqual(paid.paid, vector.expected_report.total_paid);
+  for (const [key, want] of Object.entries(vector.expected_balances)) {
+    assert.strictEqual(market.balance(key), want, `账户 ${key} 跨语言不一致`);
+  }
+  const report = market.conservationCheck(vector.expected_report.total_deposits);
+  assert.strictEqual(report.totalSlashed, vector.expected_report.total_slashed);
+  assert.strictEqual(report.balanceSum, vector.expected_report.balance_sum);
+  assert.strictEqual(report.conserved, vector.expected_report.conserved);
+});
+
 // 9. AipIdentity DID 与签名往返
 test('AipIdentity 生成 did:aip 且签名可验证', () => {
   const id = AipIdentity.generate();

package/lib/aca.js

@@ -0,0 +1,3 @@
+// 根包 /lib 子路径入口（v2.5.7 补）：re-export js/lib，
+// 使根发布包暴露 /lib/aca.js 子路径，供浏览器端按需引入（与 js 子包发布结构对齐）。
+module.exports = require('../js/lib/aca.js');

package/lib/dht.js

@@ -0,0 +1,3 @@
+// 根包 /lib 子路径入口（v2.5.7 补）：re-export js/lib，
+// 使根发布包暴露 /lib/dht.js 子路径（与 js 子包发布结构对齐）。
+module.exports = require('../js/lib/dht.js');

package/lib/keychain.js

@@ -0,0 +1,3 @@
+// 根包 /lib 子路径入口（v2.5.7 补）：re-export js/lib，
+// 使根发布包暴露 /lib/keychain.js 子路径（依赖 node:crypto，浏览器端勿直接引）。
+module.exports = require('../js/lib/keychain.js');

package/lib/market.js

@@ -0,0 +1,4 @@
+// 根包 /lib 子路径入口（v2.5.7 补）：re-export js/lib，
+// 使根发布包暴露 /lib/market.js 子路径。market.js 为纯逻辑（仅依赖 models，不引 node:crypto），
+// 浏览器 / WKWebView 端只引此模块即可运行市场演示，避开密钥模块。
+module.exports = require('../js/lib/market.js');

package/lib/mcp.js

@@ -0,0 +1,3 @@
+// 根包 /lib 子路径入口（v2.5.7 补）：re-export js/lib，
+// 使根发布包暴露 /lib/mcp.js 子路径（与 js 子包发布结构对齐）。
+module.exports = require('../js/lib/mcp.js');

package/lib/models.js

@@ -0,0 +1,3 @@
+// 根包 /lib 子路径入口（v2.5.7 补）：re-export js/lib，
+// 使根发布包暴露 /lib/models.js 子路径（与 js 子包发布结构对齐）。
+module.exports = require('../js/lib/models.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/agent-universe",
-  "version": "2.5.6",
+  "version": "2.5.8",
   "description": "Agent Universe - 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络。使命：让科技造福全人类！",
   "main": "index.js",
   "types": "index.d.ts",
@@ -41,6 +41,7 @@
   "files": [
     "index.js",
     "index.d.ts",
-    "js"
+    "js",
+    "lib"
   ]
 }