@twinsearth/agent-universe 2.5.6 → 2.5.7

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.7，详见 [Releases](https://github.com/TwinsEarth/agent-universe/releases)。
 
 ## 版本谱系
 
@@ -307,6 +307,7 @@ 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: 依赖）** |
 
 详见 [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.7';
 
 /**
  * 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.7',
     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/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.7' },
         capabilities: {},
       },
     });

package/js/package-lock.json

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

package/js/package.json

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

package/js/test/test.js

@@ -1,5 +1,5 @@
 // test/test.js
-// Agent Universe JS SDK 测试（8 项）
+// Agent Universe JS SDK 测试（12 项）
 
 const assert = require('node:assert');
 const {
@@ -41,15 +41,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.7', () => {
+  assert.strictEqual(version, '2.5.7');
 });
 
 // 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), '签名验证通过');

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.7",
   "description": "Agent Universe - 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络。使命：让科技造福全人类！",
   "main": "index.js",
   "types": "index.d.ts",
@@ -41,6 +41,7 @@
   "files": [
     "index.js",
     "index.d.ts",
-    "js"
+    "js",
+    "lib"
   ]
 }