@agirails/sdk 2.0.0-beta

package/src/__tests__/utils/NonceManager.test.ts

@@ -0,0 +1,205 @@
+/**
+ * Tests for Nonce Manager
+ */
+
+import {
+  InMemoryNonceManager,
+  DIDScopedNonceManager,
+  createNonceManager
+} from '../../utils/NonceManager';
+
+describe('InMemoryNonceManager', () => {
+  let manager: InMemoryNonceManager;
+
+  beforeEach(() => {
+    manager = new InMemoryNonceManager();
+  });
+
+  describe('getNextNonce', () => {
+    it('should return 1 for first nonce', () => {
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(1);
+    });
+
+    it('should increment for multiple calls', () => {
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(1);
+      manager.recordNonce('agirails.delivery.v1', 1);
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(2);
+      manager.recordNonce('agirails.delivery.v1', 2);
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(3);
+    });
+
+    it('should track nonces separately per message type', () => {
+      manager.recordNonce('agirails.delivery.v1', 5);
+      manager.recordNonce('agirails.quote.v1', 10);
+
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(6);
+      expect(manager.getNextNonce('agirails.quote.v1')).toBe(11);
+    });
+  });
+
+  describe('recordNonce', () => {
+    it('should update current nonce', () => {
+      manager.recordNonce('agirails.delivery.v1', 5);
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(5);
+    });
+
+    it('should throw if nonce is not strictly increasing', () => {
+      manager.recordNonce('agirails.delivery.v1', 5);
+
+      expect(() => manager.recordNonce('agirails.delivery.v1', 5))
+        .toThrow('Nonce must be strictly increasing');
+
+      expect(() => manager.recordNonce('agirails.delivery.v1', 3))
+        .toThrow('Nonce must be strictly increasing');
+    });
+
+    it('should allow gaps in nonces', () => {
+      manager.recordNonce('agirails.delivery.v1', 1);
+      manager.recordNonce('agirails.delivery.v1', 10);
+
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(10);
+    });
+  });
+
+  describe('getCurrentNonce', () => {
+    it('should return 0 for unused message type', () => {
+      expect(manager.getCurrentNonce('agirails.unknown.v1')).toBe(0);
+    });
+
+    it('should return last recorded nonce', () => {
+      manager.recordNonce('agirails.delivery.v1', 42);
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(42);
+    });
+  });
+
+  describe('resetNonce', () => {
+    it('should reset nonce to 0', () => {
+      manager.recordNonce('agirails.delivery.v1', 10);
+      manager.resetNonce('agirails.delivery.v1');
+
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(0);
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(1);
+    });
+  });
+
+  describe('getAllNonces', () => {
+    it('should return all nonces as object', () => {
+      manager.recordNonce('agirails.delivery.v1', 5);
+      manager.recordNonce('agirails.quote.v1', 10);
+
+      const nonces = manager.getAllNonces();
+
+      expect(nonces).toEqual({
+        'agirails.delivery.v1': 5,
+        'agirails.quote.v1': 10
+      });
+    });
+
+    it('should be empty for new manager', () => {
+      expect(manager.getAllNonces()).toEqual({});
+    });
+  });
+
+  describe('constructor with initialNonces', () => {
+    it('should initialize with provided nonces', () => {
+      const manager = new InMemoryNonceManager({
+        'agirails.delivery.v1': 100,
+        'agirails.quote.v1': 200
+      });
+
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(100);
+      expect(manager.getCurrentNonce('agirails.quote.v1')).toBe(200);
+    });
+  });
+});
+
+describe('DIDScopedNonceManager', () => {
+  const did1 = 'did:ethr:84532:0x1111111111111111111111111111111111111111';
+  const did2 = 'did:ethr:84532:0x2222222222222222222222222222222222222222';
+
+  let manager: DIDScopedNonceManager;
+
+  beforeEach(() => {
+    manager = new DIDScopedNonceManager(did1);
+  });
+
+  describe('DID scoping', () => {
+    it('should track nonces per DID', () => {
+      manager.recordNonceForDID(did1, 'agirails.delivery.v1', 5);
+      manager.recordNonceForDID(did2, 'agirails.delivery.v1', 10);
+
+      expect(manager.getNextNonceForDID(did1, 'agirails.delivery.v1')).toBe(6);
+      expect(manager.getNextNonceForDID(did2, 'agirails.delivery.v1')).toBe(11);
+    });
+
+    it('should use current DID for simple methods', () => {
+      manager.recordNonce('agirails.delivery.v1', 5);
+
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(5);
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(6);
+    });
+
+    it('should allow switching DID context', () => {
+      manager.recordNonce('agirails.delivery.v1', 5);
+
+      manager.switchDID(did2);
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(0);
+
+      manager.recordNonce('agirails.delivery.v1', 10);
+
+      manager.switchDID(did1);
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(5);
+    });
+  });
+
+  describe('getAllNonces', () => {
+    it('should return nested structure', () => {
+      manager.recordNonceForDID(did1, 'agirails.delivery.v1', 5);
+      manager.recordNonceForDID(did1, 'agirails.quote.v1', 3);
+      manager.recordNonceForDID(did2, 'agirails.delivery.v1', 10);
+
+      const nonces = manager.getAllNonces();
+
+      expect(nonces).toEqual({
+        [did1]: {
+          'agirails.delivery.v1': 5,
+          'agirails.quote.v1': 3
+        },
+        [did2]: {
+          'agirails.delivery.v1': 10
+        }
+      });
+    });
+  });
+
+  describe('constructor with initialNonces', () => {
+    it('should initialize DID with provided nonces', () => {
+      const manager = new DIDScopedNonceManager(did1, {
+        'agirails.delivery.v1': 100
+      });
+
+      expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(100);
+      expect(manager.getNextNonce('agirails.delivery.v1')).toBe(101);
+    });
+  });
+});
+
+describe('createNonceManager factory', () => {
+  it('should create InMemoryNonceManager when no DID provided', () => {
+    const manager = createNonceManager();
+    expect(manager).toBeInstanceOf(InMemoryNonceManager);
+  });
+
+  it('should create DIDScopedNonceManager when DID provided', () => {
+    const manager = createNonceManager('did:ethr:84532:0x...');
+    expect(manager).toBeInstanceOf(DIDScopedNonceManager);
+  });
+
+  it('should pass initialNonces to manager', () => {
+    const manager = createNonceManager(undefined, {
+      'agirails.delivery.v1': 50
+    });
+
+    expect(manager.getCurrentNonce('agirails.delivery.v1')).toBe(50);
+  });
+});

package/src/__tests__/utils/canonicalJson.test.ts

@@ -0,0 +1,153 @@
+/**
+ * Tests for Canonical JSON Utilities (AIP-4 §3.6)
+ */
+
+import { canonicalJsonStringify, computeCanonicalHash, computeResultHash } from '../../utils/canonicalJson';
+import { keccak256, toUtf8Bytes } from 'ethers';
+
+describe('Canonical JSON Utilities', () => {
+  describe('canonicalJsonStringify', () => {
+    it('should sort object keys alphabetically', () => {
+      const obj = { z: 1, a: 2, m: 3 };
+      const result = canonicalJsonStringify(obj);
+      expect(result).toBe('{"a":2,"m":3,"z":1}');
+    });
+
+    it('should handle nested objects', () => {
+      const obj = {
+        b: { y: 1, x: 2 },
+        a: { z: 3, w: 4 }
+      };
+      const result = canonicalJsonStringify(obj);
+      expect(result).toBe('{"a":{"w":4,"z":3},"b":{"x":2,"y":1}}');
+    });
+
+    it('should handle arrays', () => {
+      const obj = { items: [3, 1, 2], name: 'test' };
+      const result = canonicalJsonStringify(obj);
+      expect(result).toBe('{"items":[3,1,2],"name":"test"}');
+    });
+
+    it('should produce deterministic output', () => {
+      const obj1 = { a: 1, b: 2, c: 3 };
+      const obj2 = { c: 3, b: 2, a: 1 };
+
+      expect(canonicalJsonStringify(obj1)).toBe(canonicalJsonStringify(obj2));
+    });
+
+    it('should handle special characters', () => {
+      const obj = { text: 'hello "world"', emoji: '🎉' };
+      const result = canonicalJsonStringify(obj);
+      expect(result).toContain('hello \\"world\\"');
+      expect(result).toContain('🎉');
+    });
+
+    it('should handle null and boolean values', () => {
+      const obj = { isTrue: true, isFalse: false, nothing: null };
+      const result = canonicalJsonStringify(obj);
+      expect(result).toBe('{"isFalse":false,"isTrue":true,"nothing":null}');
+    });
+  });
+
+  describe('computeCanonicalHash', () => {
+    it('should compute keccak256 hash of canonical JSON', () => {
+      const obj = { a: 1, b: 2 };
+      const hash = computeCanonicalHash(obj);
+
+      // Hash should be 0x-prefixed, 66 chars (0x + 64 hex)
+      expect(hash).toMatch(/^0x[a-f0-9]{64}$/);
+    });
+
+    it('should produce same hash for semantically equal objects', () => {
+      const obj1 = { a: 1, b: 2, c: 3 };
+      const obj2 = { c: 3, b: 2, a: 1 }; // Different order
+
+      const hash1 = computeCanonicalHash(obj1);
+      const hash2 = computeCanonicalHash(obj2);
+
+      expect(hash1).toBe(hash2);
+    });
+
+    it('should produce different hashes for different objects', () => {
+      const obj1 = { a: 1, b: 2 };
+      const obj2 = { a: 1, b: 3 };
+
+      const hash1 = computeCanonicalHash(obj1);
+      const hash2 = computeCanonicalHash(obj2);
+
+      expect(hash1).not.toBe(hash2);
+    });
+  });
+
+  describe('computeResultHash', () => {
+    it('should alias computeCanonicalHash', () => {
+      const obj = { txId: '0xabc', result: 'test' };
+
+      const hash1 = computeResultHash(obj);
+      const hash2 = computeCanonicalHash(obj);
+
+      expect(hash1).toBe(hash2);
+    });
+  });
+
+  describe('AIP-4 Test Vector (§10.1)', () => {
+    it('should match AIP-4 canonical JSON test vector', () => {
+      const input = {
+        txId: '0x7d87c3b8e23a5c9d1f4e6b2a8c5d9e3f1a7b4c6d8e2f5a3b9c1d7e4f6a8b2c5d',
+        serviceType: 'ocr',
+        result: { text: 'test', confidence: 1.0 },
+        createdAt: 1700000000,
+        provider: 'did:ethr:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
+      };
+
+      const canonical = canonicalJsonStringify(input);
+
+      // Expected output from AIP-4 §10.1
+      const expected = '{"createdAt":1700000000,"provider":"did:ethr:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb","result":{"confidence":1,"text":"test"},"serviceType":"ocr","txId":"0x7d87c3b8e23a5c9d1f4e6b2a8c5d9e3f1a7b4c6d8e2f5a3b9c1d7e4f6a8b2c5d"}';
+
+      expect(canonical).toBe(expected);
+    });
+
+    it('should compute correct hash for test vector', () => {
+      const input = {
+        txId: '0x7d87c3b8e23a5c9d1f4e6b2a8c5d9e3f1a7b4c6d8e2f5a3b9c1d7e4f6a8b2c5d',
+        serviceType: 'ocr',
+        result: { text: 'test', confidence: 1.0 },
+        createdAt: 1700000000,
+        provider: 'did:ethr:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
+      };
+
+      const hash = computeResultHash(input);
+
+      // Compute expected hash manually
+      const canonical = '{"createdAt":1700000000,"provider":"did:ethr:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb","result":{"confidence":1,"text":"test"},"serviceType":"ocr","txId":"0x7d87c3b8e23a5c9d1f4e6b2a8c5d9e3f1a7b4c6d8e2f5a3b9c1d7e4f6a8b2c5d"}';
+      const expectedHash = keccak256(toUtf8Bytes(canonical));
+
+      expect(hash).toBe(expectedHash);
+    });
+  });
+
+  describe('Cross-language compatibility', () => {
+    it('should handle numbers without decimals', () => {
+      const obj = { value: 1.0 };
+      const result = canonicalJsonStringify(obj);
+
+      // JavaScript serializes 1.0 as 1 (no decimal)
+      expect(result).toBe('{"value":1}');
+    });
+
+    it('should handle large numbers', () => {
+      const obj = { timestamp: 1700000000, amount: 1000000000000 };
+      const result = canonicalJsonStringify(obj);
+
+      expect(result).toBe('{"amount":1000000000000,"timestamp":1700000000}');
+    });
+
+    it('should handle unicode strings', () => {
+      const obj = { text: 'Hello 世界 🌍' };
+      const result = canonicalJsonStringify(obj);
+
+      expect(result).toContain('Hello 世界 🌍');
+    });
+  });
+});