@agirails/sdk 2.0.1-beta → 2.0.2

package/src/__tests__/protocol/EASHelper.test.ts

@@ -1,472 +0,0 @@
-/**
- * EASHelper Test Suite
- *
- * Coverage Target: 80%+ (statements, functions, lines, branches)
- *
- * Test Categories:
- * 1. Attestation Creation (3 tests)
- * 2. Attestation Revocation (2 tests)
- * 3. Attestation Retrieval (3 tests)
- * 4. Attestation Verification (6 tests) - NEW: Security protection
- *
- * References:
- * - EASHelper.ts implementation
- * - Ethereum Attestation Service integration
- * - Genetic Memory: EAS Uniqueness Model (HIGH severity)
- */
-
-import { Wallet, zeroPadValue, AbiCoder } from 'ethers';
-import { EASHelper } from '../../protocol/EASHelper';
-import { DeliveryProof } from '../../types';
-
-// Test signer
-const testPrivateKey = '0x' + '1'.repeat(64);
-const testSigner = new Wallet(testPrivateKey);
-
-// Mock EAS contract
-const mockEASContract = {
-  attest: jest.fn(),
-  revoke: jest.fn(),
-  getAttestation: jest.fn(),
-  interface: {
-    parseLog: jest.fn()
-  }
-};
-
-// Mock Contract constructor
-jest.mock('ethers', () => {
-  const actual = jest.requireActual('ethers');
-  return {
-    ...actual,
-    Contract: jest.fn().mockImplementation(() => mockEASContract)
-  };
-});
-
-// Test delivery proof
-const testDeliveryProof: DeliveryProof = {
-  type: 'delivery.proof',
-  txId: '0x' + '1'.repeat(64),
-  contentHash: '0x' + '2'.repeat(64),
-  timestamp: Math.floor(Date.now() / 1000),
-  deliveryUrl: 'ipfs://QmTest123',
-  metadata: {
-    size: 1024,
-    mimeType: 'application/json'
-  }
-};
-
-// Test EAS config
-const testConfig = {
-  contractAddress: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
-  deliveryProofSchemaId: '0x' + '3'.repeat(64)
-};
-
-describe('EASHelper - Attestation Creation', () => {
-  let easHelper: EASHelper;
-
-  beforeEach(() => {
-    jest.clearAllMocks();
-    easHelper = new EASHelper(testSigner, testConfig);
-  });
-
-  it('should create attestation with default options', async () => {
-    const recipientAddress = '0x742d35cc6634c0532925a3b844bc9e7595f0beb0';
-    const mockAttestationUID = '0x' + '4'.repeat(64);
-    const mockTxHash = '0x' + '5'.repeat(64);
-
-    // Mock interface.parseLog to return uid
-    mockEASContract.interface.parseLog.mockReturnValue({
-      name: 'Attested',
-      args: {
-        uid: mockAttestationUID,
-        attester: testSigner.address,
-        schema: testConfig.deliveryProofSchemaId
-      }
-    });
-
-    mockEASContract.attest.mockResolvedValue({
-      wait: jest.fn().mockResolvedValue({
-        transactionHash: mockTxHash,
-        logs: [
-          {
-            // ethers v6: logs instead of events
-            topics: ['0x' + '6'.repeat(64)],
-            data: '0x'
-          }
-        ]
-      })
-    });
-
-    const result = await easHelper.attestDeliveryProof(testDeliveryProof, recipientAddress);
-
-    expect(mockEASContract.attest).toHaveBeenCalledWith(
-      expect.objectContaining({
-        schema: testConfig.deliveryProofSchemaId,
-        data: expect.objectContaining({
-          recipient: recipientAddress,
-          expirationTime: 0,
-          revocable: true,
-          refUID: testDeliveryProof.txId
-        })
-      })
-    );
-
-    expect(result).toEqual({
-      uid: mockAttestationUID,
-      transactionHash: mockTxHash
-    });
-  });
-
-  it('should create attestation with custom options', async () => {
-    const recipientAddress = '0x742d35cc6634c0532925a3b844bc9e7595f0beb0';
-    const mockAttestationUID = '0x' + '4'.repeat(64);
-    const mockTxHash = '0x' + '5'.repeat(64);
-    const customExpirationTime = Math.floor(Date.now() / 1000) + 86400; // 24 hours
-
-    // Mock interface.parseLog to return uid
-    mockEASContract.interface.parseLog.mockReturnValue({
-      name: 'Attested',
-      args: {
-        uid: mockAttestationUID
-      }
-    });
-
-    mockEASContract.attest.mockResolvedValue({
-      wait: jest.fn().mockResolvedValue({
-        transactionHash: mockTxHash,
-        logs: [
-          {
-            // ethers v6: logs instead of events
-            topics: ['0x' + '6'.repeat(64)],
-            data: '0x'
-          }
-        ]
-      })
-    });
-
-    const result = await easHelper.attestDeliveryProof(
-      testDeliveryProof,
-      recipientAddress,
-      {
-        expirationTime: customExpirationTime,
-        revocable: false
-      }
-    );
-
-    expect(mockEASContract.attest).toHaveBeenCalledWith(
-      expect.objectContaining({
-        schema: testConfig.deliveryProofSchemaId,
-        data: expect.objectContaining({
-          recipient: recipientAddress,
-          expirationTime: customExpirationTime,
-          revocable: false,
-          refUID: testDeliveryProof.txId
-        })
-      })
-    );
-
-    expect(result.uid).toBe(mockAttestationUID);
-    expect(result.transactionHash).toBe(mockTxHash);
-  });
-
-  it('should handle attestation creation with missing event', async () => {
-    const recipientAddress = '0x742d35cc6634c0532925a3b844bc9e7595f0beb0';
-    const mockTxHash = '0x' + '5'.repeat(64);
-
-    // Mock response with no Attested event (edge case)
-    mockEASContract.attest.mockResolvedValue({
-      wait: jest.fn().mockResolvedValue({
-        transactionHash: mockTxHash,
-        logs: [] // No logs
-      })
-    });
-
-    const result = await easHelper.attestDeliveryProof(testDeliveryProof, recipientAddress);
-
-    expect(result.uid).toBe(zeroPadValue('0x00', 32));
-    expect(result.transactionHash).toBe(mockTxHash);
-  });
-});
-
-describe('EASHelper - Attestation Revocation', () => {
-  let easHelper: EASHelper;
-
-  beforeEach(() => {
-    jest.clearAllMocks();
-    easHelper = new EASHelper(testSigner, testConfig);
-  });
-
-  it('should revoke attestation successfully', async () => {
-    const attestationUID = '0x' + '4'.repeat(64);
-    const mockTxHash = '0x' + '6'.repeat(64);
-
-    mockEASContract.revoke.mockResolvedValue({
-      wait: jest.fn().mockResolvedValue({
-        transactionHash: mockTxHash
-      })
-    });
-
-    const result = await easHelper.revokeAttestation(attestationUID);
-
-    expect(mockEASContract.revoke).toHaveBeenCalledWith({
-      schema: testConfig.deliveryProofSchemaId,
-      uid: attestationUID
-    });
-
-    expect(result).toBe(mockTxHash);
-  });
-
-  it('should handle revocation errors', async () => {
-    const attestationUID = '0x' + '4'.repeat(64);
-
-    mockEASContract.revoke.mockRejectedValue(new Error('Attestation not found'));
-
-    await expect(easHelper.revokeAttestation(attestationUID)).rejects.toThrow('Attestation not found');
-
-    expect(mockEASContract.revoke).toHaveBeenCalledWith({
-      schema: testConfig.deliveryProofSchemaId,
-      uid: attestationUID
-    });
-  });
-});
-
-describe('EASHelper - Attestation Retrieval', () => {
-  let easHelper: EASHelper;
-
-  beforeEach(() => {
-    jest.clearAllMocks();
-    easHelper = new EASHelper(testSigner, testConfig);
-  });
-
-  it('should get attestation data', async () => {
-    const attestationUID = '0x' + '4'.repeat(64);
-    const mockAttestationData = {
-      uid: attestationUID,
-      schema: testConfig.deliveryProofSchemaId,
-      recipient: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
-      attester: testSigner.address,
-      time: BigInt(Math.floor(Date.now() / 1000)),
-      expirationTime: BigInt(0),
-      revocable: true,
-      refUID: testDeliveryProof.txId,
-      data: '0x',
-      bump: 0
-    };
-
-    mockEASContract.getAttestation.mockResolvedValue(mockAttestationData);
-
-    const result = await easHelper.getAttestation(attestationUID);
-
-    expect(mockEASContract.getAttestation).toHaveBeenCalledWith(attestationUID);
-    expect(result).toEqual(mockAttestationData);
-  });
-
-  it('should handle non-existent attestation', async () => {
-    const attestationUID = '0x' + '4'.repeat(64);
-
-    mockEASContract.getAttestation.mockResolvedValue(null);
-
-    const result = await easHelper.getAttestation(attestationUID);
-
-    expect(result).toBeNull();
-  });
-
-  it('should verify attestation structure', async () => {
-    const attestationUID = '0x' + '4'.repeat(64);
-    const mockAttestationData = {
-      uid: attestationUID,
-      schema: testConfig.deliveryProofSchemaId,
-      recipient: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
-      attester: testSigner.address,
-      time: BigInt(Math.floor(Date.now() / 1000)),
-      expirationTime: BigInt(0),
-      revocable: true,
-      refUID: testDeliveryProof.txId,
-      data: '0x',
-      bump: 0
-    };
-
-    mockEASContract.getAttestation.mockResolvedValue(mockAttestationData);
-
-    const result = await easHelper.getAttestation(attestationUID);
-
-    expect(result).toHaveProperty('uid');
-    expect(result).toHaveProperty('schema');
-    expect(result).toHaveProperty('recipient');
-    expect(result).toHaveProperty('attester');
-    expect(result).toHaveProperty('time');
-    expect(result).toHaveProperty('expirationTime');
-    expect(result).toHaveProperty('revocable');
-    expect(result).toHaveProperty('refUID');
-    expect(result).toHaveProperty('data');
-  });
-});
-
-describe('EASHelper - Attestation Verification (Security)', () => {
-  let easHelper: EASHelper;
-  const validTxId = '0x' + '1'.repeat(64);
-  const validAttestationUID = '0x' + '4'.repeat(64);
-
-  beforeEach(() => {
-    jest.clearAllMocks();
-    easHelper = new EASHelper(testSigner, testConfig);
-  });
-
-  it('should verify valid attestation successfully', async () => {
-    // Properly encode attestation data matching the schema
-    const abiCoder = AbiCoder.defaultAbiCoder();
-    const encodedData = abiCoder.encode(
-      ['bytes32', 'bytes32', 'uint256', 'string', 'uint256', 'string'],
-      [
-        validTxId, // txId - MUST match expected txId for verification to pass
-        '0x' + '2'.repeat(64), // contentHash
-        BigInt(Math.floor(Date.now() / 1000)), // timestamp
-        'ipfs://QmTest123', // deliveryUrl
-        BigInt(1024), // size
-        'application/json' // mimeType
-      ]
-    );
-
-    const mockAttestationData = {
-      uid: validAttestationUID,
-      schema: testConfig.deliveryProofSchemaId,
-      recipient: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
-      attester: testSigner.address,
-      time: BigInt(Math.floor(Date.now() / 1000)),
-      expirationTime: BigInt(0), // No expiration
-      revocationTime: BigInt(0), // Not revoked
-      revocable: true,
-      refUID: testDeliveryProof.txId,
-      data: encodedData, // Properly encoded data
-      bump: 0
-    };
-
-    // Mock getAttestation to return valid data
-    mockEASContract.getAttestation.mockResolvedValue(mockAttestationData);
-
-    const result = await easHelper.verifyDeliveryAttestation(validTxId, validAttestationUID);
-
-    expect(result).toBe(true);
-    expect(mockEASContract.getAttestation).toHaveBeenCalledWith(validAttestationUID);
-  });
-
-  it('should throw error if attestation not found', async () => {
-    // Mock attestation with different UID (not found scenario)
-    const mockAttestationData = {
-      uid: '0x' + '9'.repeat(64), // Different UID
-      schema: testConfig.deliveryProofSchemaId,
-      recipient: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
-      attester: testSigner.address,
-      time: BigInt(Math.floor(Date.now() / 1000)),
-      expirationTime: BigInt(0),
-      revocationTime: BigInt(0),
-      revocable: true,
-      refUID: validTxId,
-      data: '0x',
-      bump: 0
-    };
-
-    mockEASContract.getAttestation.mockResolvedValue(mockAttestationData);
-
-    await expect(
-      easHelper.verifyDeliveryAttestation(validTxId, validAttestationUID)
-    ).rejects.toThrow('Attestation not found');
-  });
-
-  it('should throw error if attestation is revoked', async () => {
-    const revokedTime = BigInt(Math.floor(Date.now() / 1000));
-
-    const mockAttestationData = {
-      uid: validAttestationUID,
-      schema: testConfig.deliveryProofSchemaId,
-      recipient: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
-      attester: testSigner.address,
-      time: BigInt(Math.floor(Date.now() / 1000)),
-      expirationTime: BigInt(0),
-      revocationTime: revokedTime, // REVOKED!
-      revocable: true,
-      refUID: validTxId,
-      data: '0x',
-      bump: 0
-    };
-
-    mockEASContract.getAttestation.mockResolvedValue(mockAttestationData);
-
-    await expect(
-      easHelper.verifyDeliveryAttestation(validTxId, validAttestationUID)
-    ).rejects.toThrow(/Attestation has been revoked/);
-  });
-
-  it('should throw error if attestation has expired', async () => {
-    const pastTimestamp = BigInt(Math.floor(Date.now() / 1000) - 86400); // 24 hours ago
-
-    const mockAttestationData = {
-      uid: validAttestationUID,
-      schema: testConfig.deliveryProofSchemaId,
-      recipient: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
-      attester: testSigner.address,
-      time: BigInt(Math.floor(Date.now() / 1000)),
-      expirationTime: pastTimestamp, // EXPIRED!
-      revocationTime: BigInt(0),
-      revocable: true,
-      refUID: validTxId,
-      data: '0x',
-      bump: 0
-    };
-
-    mockEASContract.getAttestation.mockResolvedValue(mockAttestationData);
-
-    await expect(
-      easHelper.verifyDeliveryAttestation(validTxId, validAttestationUID)
-    ).rejects.toThrow(/Attestation has expired/);
-  });
-
-  it('should throw error if attestation txId does not match (integration test required)', async () => {
-    // This test validates the CRITICAL security check: attestation.txId must match expected txId
-    // Testing this requires mocking AbiCoder.decode() to return a different txId
-    // This is covered by integration tests (scripts/test-eas-multiple-attestations.ts)
-    // where we create real attestations with different txIds and verify rejection
-
-    // SECURITY TEST: Provider attempting to use attestation from different transaction
-    // Expected behavior: verifyDeliveryAttestation() should throw:
-    // "Attestation txId mismatch: expected 0x111...111, got 0x777...777. Provider may be attempting..."
-
-    expect(true).toBe(true); // Placeholder - integration test validates this
-  });
-
-  it('should accept attestation with no expiration (expirationTime = 0)', async () => {
-    // Properly encode attestation data
-    const abiCoder = AbiCoder.defaultAbiCoder();
-    const encodedData = abiCoder.encode(
-      ['bytes32', 'bytes32', 'uint256', 'string', 'uint256', 'string'],
-      [
-        validTxId, // txId
-        '0x' + '2'.repeat(64), // contentHash
-        BigInt(Math.floor(Date.now() / 1000)), // timestamp
-        'ipfs://QmTest456', // deliveryUrl
-        BigInt(2048), // size
-        'text/plain' // mimeType
-      ]
-    );
-
-    const mockAttestationData = {
-      uid: validAttestationUID,
-      schema: testConfig.deliveryProofSchemaId,
-      recipient: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
-      attester: testSigner.address,
-      time: BigInt(Math.floor(Date.now() / 1000)),
-      expirationTime: BigInt(0), // No expiration - valid forever
-      revocationTime: BigInt(0),
-      revocable: true,
-      refUID: validTxId,
-      data: encodedData, // Properly encoded
-      bump: 0
-    };
-
-    mockEASContract.getAttestation.mockResolvedValue(mockAttestationData);
-
-    const result = await easHelper.verifyDeliveryAttestation(validTxId, validAttestationUID);
-
-    expect(result).toBe(true);
-  });
-});