@agentunion/fastaun 0.2.20 → 0.3.0

package/dist/v2/state/commitment.d.ts

@@ -0,0 +1,58 @@
+/**
+ * AUN E2EE V2: state_commitment 计算
+ *
+ * 规范引用：§6.2
+ *
+ * state_commitment = SHA256(
+ *   "AUN-V2-SC-v1" ||
+ *   group_id ||
+ *   uint32(epoch, big-endian) ||
+ *   canonical_json({
+ *     "members": [...sorted by aid, devices sorted by device_id...],
+ *     "audit_aids": [...sorted...],
+ *     "join_policy_hash": "64hex" | null,
+ *     "admin_set": {"admin_aids": [...sorted...], "threshold": N},
+ *     "recovery_quorum": {...} | null,
+ *     "history_policy": "none" | "recent_N_days" | "full",
+ *     "wrap_protocol": "3DH" | "1DH"
+ *   })
+ * )
+ *
+ * 排序在内部完成，调用方无需预排序。
+ */
+export declare const STATE_PREFIX: Uint8Array;
+export interface MemberDevice {
+    device_id?: string;
+    fp?: string;
+    [k: string]: unknown;
+}
+export interface Member {
+    aid?: string;
+    devices?: MemberDevice[];
+    [k: string]: unknown;
+}
+export interface AdminSet {
+    admin_aids?: string[];
+    threshold?: number;
+    [k: string]: unknown;
+}
+export interface RecoveryQuorum {
+    trigger?: string;
+    quorum_aids?: string[];
+    threshold?: number;
+    [k: string]: unknown;
+}
+export interface StatePayload {
+    members?: Member[];
+    audit_aids?: string[];
+    join_policy_hash?: string | null;
+    admin_set?: AdminSet;
+    recovery_quorum?: RecoveryQuorum | null;
+    history_policy?: string;
+    wrap_protocol?: string;
+    [k: string]: unknown;
+}
+/**
+ * 计算 state_commitment（hex）。
+ */
+export declare function computeStateCommitment(groupId: string, epoch: number, statePayload: StatePayload): string;

package/dist/v2/state/commitment.js

@@ -0,0 +1,85 @@
+/**
+ * AUN E2EE V2: state_commitment 计算
+ *
+ * 规范引用：§6.2
+ *
+ * state_commitment = SHA256(
+ *   "AUN-V2-SC-v1" ||
+ *   group_id ||
+ *   uint32(epoch, big-endian) ||
+ *   canonical_json({
+ *     "members": [...sorted by aid, devices sorted by device_id...],
+ *     "audit_aids": [...sorted...],
+ *     "join_policy_hash": "64hex" | null,
+ *     "admin_set": {"admin_aids": [...sorted...], "threshold": N},
+ *     "recovery_quorum": {...} | null,
+ *     "history_policy": "none" | "recent_N_days" | "full",
+ *     "wrap_protocol": "3DH" | "1DH"
+ *   })
+ * )
+ *
+ * 排序在内部完成，调用方无需预排序。
+ */
+import { createHash } from 'node:crypto';
+import { canonicalJson } from '../crypto/canonical.js';
+export const STATE_PREFIX = new TextEncoder().encode('AUN-V2-SC-v1');
+/** in-place 规范化排序。 */
+function sortPayload(payload) {
+    if (Array.isArray(payload.members)) {
+        payload.members.sort((a, b) => {
+            const ka = a.aid ?? '';
+            const kb = b.aid ?? '';
+            if (ka === kb)
+                return 0;
+            return ka < kb ? -1 : 1;
+        });
+        for (const m of payload.members) {
+            if (Array.isArray(m.devices)) {
+                m.devices.sort((a, b) => {
+                    const ka = a.device_id ?? '';
+                    const kb = b.device_id ?? '';
+                    if (ka === kb)
+                        return 0;
+                    return ka < kb ? -1 : 1;
+                });
+            }
+        }
+    }
+    if (Array.isArray(payload.audit_aids)) {
+        payload.audit_aids.sort();
+    }
+    if (payload.admin_set && Array.isArray(payload.admin_set.admin_aids)) {
+        payload.admin_set.admin_aids.sort();
+    }
+    if (payload.recovery_quorum && Array.isArray(payload.recovery_quorum.quorum_aids)) {
+        payload.recovery_quorum.quorum_aids.sort();
+    }
+}
+/** 大端 uint32 编码。 */
+function uint32BE(value) {
+    if (value < 0 || value > 0xffffffff || !Number.isInteger(value)) {
+        throw new Error(`epoch out of uint32 range: ${value}`);
+    }
+    const out = new Uint8Array(4);
+    const dv = new DataView(out.buffer);
+    dv.setUint32(0, value, false);
+    return out;
+}
+/**
+ * 计算 state_commitment（hex）。
+ */
+export function computeStateCommitment(groupId, epoch, statePayload) {
+    // 深拷贝避免修改调用方数据
+    const payload = JSON.parse(JSON.stringify(statePayload));
+    sortPayload(payload);
+    const groupBytes = new TextEncoder().encode(groupId);
+    const epochBytes = uint32BE(epoch);
+    const payloadBytes = canonicalJson(payload);
+    const h = createHash('sha256');
+    h.update(STATE_PREFIX);
+    h.update(groupBytes);
+    h.update(epochBytes);
+    h.update(payloadBytes);
+    return h.digest('hex');
+}
+//# sourceMappingURL=commitment.js.map

package/dist/v2/state/commitment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitment.js","sourceRoot":"","sources":["../../../src/v2/state/commitment.ts"],"names":[],"mappings":"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"}

package/dist/v2/state/index.d.ts

@@ -0,0 +1,2 @@
+export { computeStateCommitment, STATE_PREFIX } from './commitment.js';
+export type { Member, MemberDevice, AdminSet, RecoveryQuorum, StatePayload } from './commitment.js';

package/dist/v2/state/index.js

@@ -0,0 +1,2 @@
+export { computeStateCommitment, STATE_PREFIX } from './commitment.js';
+//# sourceMappingURL=index.js.map

package/dist/v2/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v2/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentunion/fastaun",
-  "version": "0.2.20",
+  "version": "0.3.0",
   "description": "AUN Protocol Core SDK for Node.js",
   "type": "module",
   "main": "dist/index.js",
@@ -27,12 +27,13 @@
     "prepack": "python ../scripts/sync_packed_docs.py ts",
     "test": "vitest run",
     "test:unit": "vitest run tests/unit",
-    "test:integration": "vitest run tests/integration/e2ee.test.ts",
-    "test:e2e": "vitest run tests/e2e/group-e2ee.test.ts",
+    "test:integration": "vitest run tests/integration/federation-v2-thought.test.ts tests/integration/group-e2ee.test.ts",
+    "test:e2e": "vitest run tests/e2e/v2-p2p.test.ts tests/e2e/v2-group.test.ts tests/e2e/v2-thought.test.ts",
     "test:federation": "vitest run tests/integration/federation.test.ts tests/integration/federation-storage.test.ts",
     "test:watch": "vitest"
   },
   "dependencies": {
+    "@noble/curves": "^2.2.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {