@twinsearth/agent-universe 2.5.7 → 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.7，详见 [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)。
 
 ## 版本谱系
 
@@ -308,6 +308,7 @@ npm install @twinsearth/agent-universe
 | 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.7';
+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.7',
+    version: opts.version || '2.5.8',
     capabilities: [...capabilities],
     endpoints: opts.endpoints || [],
     hardware: {

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.7' },
+        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.7",
+  "version": "2.5.8",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@twinsearth/agent-universe",
-      "version": "2.5.7",
+      "version": "2.5.8",
       "license": "MIT",
       "engines": {
         "node": ">=18"

package/js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/agent-universe",
-  "version": "2.5.7",
+  "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 测试（12 项）
+// Agent Universe JS SDK 测试（14 项）
 
 const assert = require('node:assert');
+const fs = require('node:fs');
+const path = require('node:path');
 const {
   version,
   AgentUniverse,
@@ -41,8 +43,8 @@ function test(name, fn) {
 console.log('Agent Universe JS SDK 测试\n');
 
 // 1. 版本号
-test('版本号为 2.5.7', () => {
-  assert.strictEqual(version, '2.5.7');
+test('版本号为 2.5.8', () => {
+  assert.strictEqual(version, '2.5.8');
 });
 
 // 2. 密钥对 + DID + 签名验证
@@ -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/package.json

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