@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/adapters/IntermediateAdapter.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * IntermediateAdapter - Balanced API for developers with some protocol knowledge
+ *
+ * Provides more control than BeginnerAdapter while still offering convenience:
+ * - Explicit transaction lifecycle methods
+ * - Direct escrow operations
+ * - State transition control
+ *
+ * Use this adapter when you need fine-grained control but still want
+ * user-friendly input parsing and validation.
+ *
+ * @module adapters/IntermediateAdapter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntermediateAdapter = void 0;
+const BaseAdapter_1 = require("./BaseAdapter");
+/**
+ * IntermediateAdapter - Balanced API for transaction lifecycle control.
+ *
+ * Provides explicit methods for each stage of the ACTP lifecycle:
+ * - `createTransaction()` - Create transaction without escrow
+ * - `linkEscrow()` - Link escrow (auto-transitions to COMMITTED)
+ * - `transitionState()` - Manually transition state
+ * - `releaseEscrow()` - Release funds to provider
+ * - `getEscrowBalance()` - Check escrow balance
+ * - `getTransaction()` - Get transaction details
+ *
+ * @example
+ * ```typescript
+ * const client = await ACTPClient.create({ mode: 'mock' });
+ *
+ * // Create transaction (INITIATED state)
+ * const txId = await client.intermediate.createTransaction({
+ *   provider: '0xProvider123',
+ *   amount: '100',
+ *   deadline: '+7d',
+ * });
+ *
+ * // Link escrow (auto-transitions to COMMITTED)
+ * await client.intermediate.linkEscrow(txId, '100');
+ *
+ * // Provider delivers
+ * await client.intermediate.transitionState(txId, 'DELIVERED');
+ *
+ * // Release funds after dispute window
+ * await client.intermediate.releaseEscrow(escrowId);
+ * ```
+ */
+class IntermediateAdapter extends BaseAdapter_1.BaseAdapter {
+    /**
+     * Creates a new IntermediateAdapter instance.
+     *
+     * @param runtime - ACTP runtime implementation (MockRuntime or BlockchainRuntime)
+     * @param requesterAddress - The requester's Ethereum address
+     * @param easHelper - Optional EAS helper for attestation verification (SECURITY FIX C-4)
+     */
+    constructor(runtime, requesterAddress, easHelper) {
+        super(requesterAddress);
+        this.runtime = runtime;
+        this.easHelper = easHelper;
+    }
+    /**
+     * Create a transaction (INITIATED state, no escrow yet).
+     *
+     * Unlike `beginner.pay()`, this only creates the transaction
+     * without linking escrow. You must call `linkEscrow()` separately.
+     *
+     * @param params - Transaction parameters
+     * @returns Transaction ID
+     * @throws {ValidationError} If inputs are invalid
+     *
+     * @example
+     * ```typescript
+     * const txId = await adapter.createTransaction({
+     *   provider: '0xProvider123',
+     *   amount: '100',
+     *   deadline: '+24h',
+     * });
+     * ```
+     */
+    async createTransaction(params) {
+        const provider = this.validateAddress(params.provider, 'provider');
+        const amount = this.parseAmount(params.amount);
+        const currentTime = this.runtime.time.now();
+        const deadline = this.parseDeadline(params.deadline, currentTime);
+        // SECURITY FIX (L-1): Validate dispute window bounds
+        const disputeWindow = this.validateDisputeWindow(params.disputeWindow);
+        const requester = this.requesterAddress;
+        // Validation
+        if (requester.toLowerCase() === provider.toLowerCase()) {
+            throw new BaseAdapter_1.ValidationError('Cannot create transaction with yourself as provider');
+        }
+        if (deadline <= currentTime) {
+            throw new BaseAdapter_1.ValidationError('Deadline must be in the future');
+        }
+        return this.runtime.createTransaction({
+            provider,
+            requester,
+            amount: amount.toString(),
+            deadline,
+            disputeWindow,
+            serviceDescription: params.serviceDescription,
+        });
+    }
+    /**
+     * Link escrow to a transaction.
+     *
+     * Automatically transitions INITIATED or QUOTED → COMMITTED.
+     * Deducts funds from requester and locks in escrow.
+     *
+     * @param txId - Transaction ID
+     * @returns Escrow ID
+     * @throws {Error} If transaction not found or in wrong state
+     *
+     * @example
+     * ```typescript
+     * const escrowId = await adapter.linkEscrow(txId);
+     * ```
+     */
+    async linkEscrow(txId) {
+        const tx = await this.runtime.getTransaction(txId);
+        if (!tx) {
+            throw new Error(`Transaction ${txId} not found`);
+        }
+        // Use the transaction's amount (already in correct format)
+        return this.runtime.linkEscrow(txId, tx.amount);
+    }
+    /**
+     * Transition transaction to a new state.
+     *
+     * Validates the transition against the ACTP 8-state machine.
+     *
+     * Valid transitions:
+     * - INITIATED → QUOTED, COMMITTED, CANCELLED
+     * - QUOTED → COMMITTED, CANCELLED
+     * - COMMITTED → IN_PROGRESS, DELIVERED, CANCELLED
+     * - IN_PROGRESS → DELIVERED, CANCELLED
+     * - DELIVERED → SETTLED, DISPUTED
+     * - DISPUTED → SETTLED
+     *
+     * @param txId - Transaction ID
+     * @param newState - Target state
+     * @throws {Error} If transition is invalid
+     *
+     * @example
+     * ```typescript
+     * // Provider marks work as delivered
+     * await adapter.transitionState(txId, 'DELIVERED');
+     * ```
+     */
+    async transitionState(txId, newState) {
+        return this.runtime.transitionState(txId, newState);
+    }
+    /**
+     * Release escrow funds to the provider.
+     *
+     * Can only be called when transaction is in DELIVERED state
+     * and dispute window has expired.
+     *
+     * SECURITY FIX (C-4 + HIGH-5): MANDATORY attestation verification before release.
+     * When EASHelper is available (testnet/mainnet modes), attestation verification
+     * is REQUIRED - not optional. This prevents releasing funds without proper
+     * delivery proof.
+     *
+     * Verifications performed:
+     * - Attestation exists and is not revoked
+     * - Attestation belongs to this transaction (prevents replay attacks)
+     * - Attestation has not been used for a different transaction
+     *
+     * @param escrowId - Escrow ID
+     * @param attestationParams - Attestation verification params (REQUIRED when EASHelper available)
+     * @param attestationParams.txId - Transaction ID (bytes32)
+     * @param attestationParams.attestationUID - Attestation UID (bytes32)
+     * @throws {Error} If escrow not found or dispute window active
+     * @throws {Error} If EASHelper is available but attestationParams not provided (HIGH-5)
+     * @throws {Error} If attestation verification fails
+     *
+     * @example
+     * ```typescript
+     * // With attestation verification (REQUIRED in testnet/mainnet)
+     * await adapter.releaseEscrow(escrowId, {
+     *   txId: '0x...',
+     *   attestationUID: '0x...'
+     * });
+     *
+     * // Mock mode only (no attestation required)
+     * await adapter.releaseEscrow(escrowId);
+     * ```
+     */
+    async releaseEscrow(escrowId, attestationParams) {
+        // Determine whether the underlying runtime requires attestation.
+        // BlockchainRuntime exposes isAttestationRequired(), but it's not part of the generic interface.
+        const runtimeAny = this.runtime;
+        const runtimeSupportsAttestationFlag = typeof runtimeAny?.isAttestationRequired === 'function';
+        const attestationRequired = runtimeSupportsAttestationFlag
+            ? Boolean(runtimeAny.isAttestationRequired())
+            : Boolean(this.easHelper);
+        if (attestationRequired && !attestationParams) {
+            throw new Error('Attestation verification is REQUIRED for escrow release. ' +
+                'Provide attestationParams: { txId: string, attestationUID: string }.');
+        }
+        // If caller provided attestation params, ensure they match the escrow/tx being released.
+        if (attestationParams) {
+            // Support legacy escrowId format "escrow-{txId}-{timestamp}".
+            // Standard is escrowId === txId.
+            const legacyMatch = escrowId.match(/^escrow-(.+)-\d+$/);
+            const txIdFromEscrowId = legacyMatch ? legacyMatch[1] : escrowId;
+            if (txIdFromEscrowId.toLowerCase() !== attestationParams.txId.toLowerCase()) {
+                throw new Error(`Attestation txId (${attestationParams.txId}) does not match escrow/txId (${txIdFromEscrowId}). ` +
+                    `Refusing to release escrow with mismatched attestation.`);
+            }
+            // If runtime does NOT handle attestation internally but EASHelper exists, verify here.
+            // Otherwise, pass attestationUID down so BlockchainRuntime can enforce/record.
+            if (!runtimeSupportsAttestationFlag && this.easHelper) {
+                await this.easHelper.verifyAndRecordForRelease(attestationParams.txId, attestationParams.attestationUID);
+            }
+        }
+        return this.runtime.releaseEscrow(escrowId, attestationParams?.attestationUID);
+    }
+    /**
+     * Get escrow balance.
+     *
+     * Returns formatted balance string (e.g., "100.00 USDC").
+     *
+     * @param escrowId - Escrow ID
+     * @returns Formatted balance
+     * @throws {Error} If escrow not found
+     *
+     * @example
+     * ```typescript
+     * const balance = await adapter.getEscrowBalance(escrowId);
+     * console.log(balance); // "100.00 USDC"
+     * ```
+     */
+    async getEscrowBalance(escrowId) {
+        const balance = await this.runtime.getEscrowBalance(escrowId);
+        return this.formatAmount(balance);
+    }
+    /**
+     * Get transaction details.
+     *
+     * Returns the full transaction object from the runtime.
+     *
+     * @param txId - Transaction ID
+     * @returns Transaction object or null if not found
+     *
+     * @example
+     * ```typescript
+     * const tx = await adapter.getTransaction(txId);
+     * console.log('State:', tx?.state);
+     * console.log('Amount:', tx?.amount);
+     * ```
+     */
+    async getTransaction(txId) {
+        return this.runtime.getTransaction(txId);
+    }
+}
+exports.IntermediateAdapter = IntermediateAdapter;
+//# sourceMappingURL=IntermediateAdapter.js.map

package/dist/adapters/IntermediateAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntermediateAdapter.js","sourceRoot":"","sources":["../../src/adapters/IntermediateAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,+CAA6F;AA2B7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAa,mBAAoB,SAAQ,yBAAW;IAClD;;;;;;OAMG;IACH,YACU,OAAqB,EAC7B,gBAAwB,EAChB,SAAqB;QAE7B,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAJhB,YAAO,GAAP,OAAO,CAAc;QAErB,cAAS,GAAT,SAAS,CAAY;IAG/B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAAqC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAClE,qDAAqD;QACrD,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAEvE,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAExC,aAAa;QACb,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,6BAAe,CAAC,qDAAqD,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,IAAI,6BAAe,CAAC,gCAAgC,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;YACpC,QAAQ;YACR,SAAS;YACT,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;YACzB,QAAQ;YACR,aAAa;YACb,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;SAC9C,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAEnD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,YAAY,CAAC,CAAC;QACnD,CAAC;QAED,2DAA2D;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY,EAAE,QAA0B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,KAAK,CAAC,aAAa,CACjB,QAAgB,EAChB,iBAA4D;QAE5D,iEAAiE;QACjE,iGAAiG;QACjG,MAAM,UAAU,GAAG,IAAI,CAAC,OAAc,CAAC;QACvC,MAAM,8BAA8B,GAClC,OAAO,UAAU,EAAE,qBAAqB,KAAK,UAAU,CAAC;QAE1D,MAAM,mBAAmB,GAAY,8BAA8B;YACjE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC;YAC7C,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE5B,IAAI,mBAAmB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,2DAA2D;gBACzD,sEAAsE,CACzE,CAAC;QACJ,CAAC;QAED,yFAAyF;QACzF,IAAI,iBAAiB,EAAE,CAAC;YACtB,8DAA8D;YAC9D,iCAAiC;YACjC,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACxD,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAEjE,IAAI,gBAAgB,CAAC,WAAW,EAAE,KAAK,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5E,MAAM,IAAI,KAAK,CACb,qBAAqB,iBAAiB,CAAC,IAAI,iCAAiC,gBAAgB,KAAK;oBAC/F,yDAAyD,CAC5D,CAAC;YACJ,CAAC;YAED,uFAAuF;YACvF,+EAA+E;YAC/E,IAAI,CAAC,8BAA8B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtD,MAAM,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAC5C,iBAAiB,CAAC,IAAI,EACtB,iBAAiB,CAAC,cAAc,CACjC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAC/B,QAAQ,EACR,iBAAiB,EAAE,cAAc,CAClC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF;AAlPD,kDAkPC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Adapter Layer - Bridges user-friendly API to protocol-level SDK
+ *
+ * This module exports all adapter classes and types for the Three-Level API:
+ * - BaseAdapter: Abstract base with shared utilities
+ * - BeginnerAdapter: High-level, opinionated API
+ * - IntermediateAdapter: Balanced control API
+ *
+ * @module adapters
+ */
+export { BaseAdapter, ValidationError, DEFAULT_DISPUTE_WINDOW_SECONDS, DEFAULT_DEADLINE_SECONDS, MIN_AMOUNT_WEI, MAX_DEADLINE_HOURS, MAX_DEADLINE_DAYS, } from './BaseAdapter';
+export { BeginnerAdapter, BeginnerPayParams, BeginnerPayResult } from './BeginnerAdapter';
+export { IntermediateAdapter, IntermediateTransactionParams } from './IntermediateAdapter';
+export { IACTPRuntime, CreateTransactionParams } from '../runtime/IACTPRuntime';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,WAAW,EACX,eAAe,EACf,8BAA8B,EAC9B,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAG3F,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Adapter Layer - Bridges user-friendly API to protocol-level SDK
+ *
+ * This module exports all adapter classes and types for the Three-Level API:
+ * - BaseAdapter: Abstract base with shared utilities
+ * - BeginnerAdapter: High-level, opinionated API
+ * - IntermediateAdapter: Balanced control API
+ *
+ * @module adapters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntermediateAdapter = exports.BeginnerAdapter = exports.MAX_DEADLINE_DAYS = exports.MAX_DEADLINE_HOURS = exports.MIN_AMOUNT_WEI = exports.DEFAULT_DEADLINE_SECONDS = exports.DEFAULT_DISPUTE_WINDOW_SECONDS = exports.ValidationError = exports.BaseAdapter = void 0;
+var BaseAdapter_1 = require("./BaseAdapter");
+Object.defineProperty(exports, "BaseAdapter", { enumerable: true, get: function () { return BaseAdapter_1.BaseAdapter; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return BaseAdapter_1.ValidationError; } });
+Object.defineProperty(exports, "DEFAULT_DISPUTE_WINDOW_SECONDS", { enumerable: true, get: function () { return BaseAdapter_1.DEFAULT_DISPUTE_WINDOW_SECONDS; } });
+Object.defineProperty(exports, "DEFAULT_DEADLINE_SECONDS", { enumerable: true, get: function () { return BaseAdapter_1.DEFAULT_DEADLINE_SECONDS; } });
+Object.defineProperty(exports, "MIN_AMOUNT_WEI", { enumerable: true, get: function () { return BaseAdapter_1.MIN_AMOUNT_WEI; } });
+Object.defineProperty(exports, "MAX_DEADLINE_HOURS", { enumerable: true, get: function () { return BaseAdapter_1.MAX_DEADLINE_HOURS; } });
+Object.defineProperty(exports, "MAX_DEADLINE_DAYS", { enumerable: true, get: function () { return BaseAdapter_1.MAX_DEADLINE_DAYS; } });
+var BeginnerAdapter_1 = require("./BeginnerAdapter");
+Object.defineProperty(exports, "BeginnerAdapter", { enumerable: true, get: function () { return BeginnerAdapter_1.BeginnerAdapter; } });
+var IntermediateAdapter_1 = require("./IntermediateAdapter");
+Object.defineProperty(exports, "IntermediateAdapter", { enumerable: true, get: function () { return IntermediateAdapter_1.IntermediateAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,6CAQuB;AAPrB,0GAAA,WAAW,OAAA;AACX,8GAAA,eAAe,OAAA;AACf,6HAAA,8BAA8B,OAAA;AAC9B,uHAAA,wBAAwB,OAAA;AACxB,6GAAA,cAAc,OAAA;AACd,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AAEnB,qDAA0F;AAAjF,kHAAA,eAAe,OAAA;AACxB,6DAA2F;AAAlF,0HAAA,mBAAmB,OAAA"}

package/dist/builders/DeliveryProofBuilder.d.ts

@@ -1,9 +1,27 @@
+/**
+ * DeliveryProofBuilder - AIP-4 Delivery Proof Construction
+ * Reference: AIP-4 §9.1
+ *
+ * Builds complete delivery proofs with:
+ * - IPFS upload of result data
+ * - EAS attestation creation
+ * - EIP-712 signature
+ * - Canonical JSON hashing
+ */
 import { Signer } from 'ethers';
 import { EAS } from '@ethereum-attestation-service/eas-sdk';
 import { IPFSClient } from '../utils/IPFSClient';
 import { NonceManager } from '../utils/NonceManager';
 import { DeliveryProofMessage } from '../types/message';
-export declare const AGIRAILS_DELIVERY_SCHEMA_UID = "0x0000000000000000000000000000000000000000000000000000000000000000";
+/**
+ * AGIRAILS Delivery Schema UID (Base Sepolia)
+ * Deployed 2025-11-23 - AIP-4 delivery proof schema
+ * Schema: bytes32 txId, string resultCID, bytes32 resultHash, uint256 deliveredAt
+ */
+export declare const AGIRAILS_DELIVERY_SCHEMA_UID = "0x1b0ebdf0bd20c28ec9d5362571ce8715a55f46e81c3de2f9b0d8e1b95fb5ffce";
+/**
+ * Delivery proof build parameters
+ */
 export interface DeliveryProofParams {
     txId: string;
     provider: string;
@@ -18,20 +36,61 @@ export interface DeliveryProofParams {
     chainId: number;
     kernelAddress: string;
 }
+/**
+ * DeliveryProofBuilder - Main Builder Class
+ */
 export declare class DeliveryProofBuilder {
     private ipfs;
     private signer;
     private nonceManager;
     private eas;
     constructor(ipfs: IPFSClient, signer: Signer, nonceManager: NonceManager, eas: EAS);
+    /**
+     * Build complete delivery proof
+     * Reference: AIP-4 §5.1 (Provider workflow steps 1-9)
+     *
+     * @param params - Delivery proof parameters
+     * @returns Delivery proof message, IPFS CID, and attestation UID
+     */
     build(params: DeliveryProofParams): Promise<{
         deliveryProof: DeliveryProofMessage;
         deliveryProofCID: string;
         attestationUID: string;
     }>;
+    /**
+     * Verify delivery proof signature and integrity
+     * Reference: AIP-4 §5.2 (Consumer verification)
+     *
+     * @param deliveryProof - Delivery proof message
+     * @param resultData - Actual result data (from IPFS)
+     * @param kernelAddress - ACTPKernel contract address
+     * @returns true if valid, throws error otherwise
+     */
     verify(deliveryProof: DeliveryProofMessage, resultData: any, kernelAddress: string): Promise<boolean>;
+    /**
+     * Sign delivery proof with EIP-712
+     * Reference: AIP-4 §3.3
+     *
+     * @param deliveryProof - Delivery proof message (unsigned)
+     * @param kernelAddress - ACTPKernel contract address
+     * @returns EIP-712 signature (0x-prefixed, 130 chars)
+     */
     private signDeliveryProof;
+    /**
+     * Recover signer address from delivery proof signature
+     *
+     * @param deliveryProof - Delivery proof message
+     * @param kernelAddress - ACTPKernel contract address
+     * @returns Recovered Ethereum address
+     */
     private recoverDeliveryProofSigner;
+    /**
+     * Extract Ethereum address from DID
+     * Supports: did:ethr:0x... and did:ethr:84532:0x...
+     *
+     * @param did - DID string
+     * @returns Ethereum address (0x-prefixed, checksummed)
+     */
     private extractAddressFromDID;
 }
 //# sourceMappingURL=DeliveryProofBuilder.d.ts.map

package/dist/builders/DeliveryProofBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeliveryProofBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/DeliveryProofBuilder.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,MAAM,EAAmB,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,GAAG,EAAiB,MAAM,uCAAuC,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAOxD,eAAO,MAAM,4BAA4B,uEAAuE,CAAC;AAKjH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,GAAG;gBAHH,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,GAAG;IAUZ,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAChD,aAAa,EAAE,oBAAoB,CAAC;QACpC,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAmFI,MAAM,CACV,aAAa,EAAE,oBAAoB,EACnC,UAAU,EAAE,GAAG,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;YAqEL,iBAAiB;YA6CjB,0BAA0B;IA+CxC,OAAO,CAAC,qBAAqB;CAU9B"}
+{"version":3,"file":"DeliveryProofBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/DeliveryProofBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAmB,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,GAAG,EAAiB,MAAM,uCAAuC,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,uEAAuE,CAAC;AAEjH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;GAEG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,GAAG;gBAHH,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,GAAG;IAGlB;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAChD,aAAa,EAAE,oBAAoB,CAAC;QACpC,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IA0EF;;;;;;;;OAQG;IACG,MAAM,CACV,aAAa,EAAE,oBAAoB,EACnC,UAAU,EAAE,GAAG,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;IA6DnB;;;;;;;OAOG;YACW,iBAAiB;IAsC/B;;;;;;OAMG;YACW,0BAA0B;IAwCxC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/builders/DeliveryProofBuilder.js

@@ -1,11 +1,30 @@
 "use strict";
+/**
+ * DeliveryProofBuilder - AIP-4 Delivery Proof Construction
+ * Reference: AIP-4 §9.1
+ *
+ * Builds complete delivery proofs with:
+ * - IPFS upload of result data
+ * - EAS attestation creation
+ * - EIP-712 signature
+ * - Canonical JSON hashing
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeliveryProofBuilder = exports.AGIRAILS_DELIVERY_SCHEMA_UID = void 0;
 const ethers_1 = require("ethers");
 const eas_sdk_1 = require("@ethereum-attestation-service/eas-sdk");
 const canonicalJson_1 = require("../utils/canonicalJson");
 const eip712_1 = require("../types/eip712");
-exports.AGIRAILS_DELIVERY_SCHEMA_UID = '0x0000000000000000000000000000000000000000000000000000000000000000';
+/**
+ * AGIRAILS Delivery Schema UID (Base Sepolia)
+ * Deployed 2025-11-23 - AIP-4 delivery proof schema
+ * Schema: bytes32 txId, string resultCID, bytes32 resultHash, uint256 deliveredAt
+ */
+exports.AGIRAILS_DELIVERY_SCHEMA_UID = '0x1b0ebdf0bd20c28ec9d5362571ce8715a55f46e81c3de2f9b0d8e1b95fb5ffce';
+// IPFSClient and NonceManager interfaces imported from utils
+/**
+ * DeliveryProofBuilder - Main Builder Class
+ */
 class DeliveryProofBuilder {
     constructor(ipfs, signer, nonceManager, eas) {
         this.ipfs = ipfs;
@@ -13,12 +32,23 @@ class DeliveryProofBuilder {
         this.nonceManager = nonceManager;
         this.eas = eas;
     }
+    /**
+     * Build complete delivery proof
+     * Reference: AIP-4 §5.1 (Provider workflow steps 1-9)
+     *
+     * @param params - Delivery proof parameters
+     * @returns Delivery proof message, IPFS CID, and attestation UID
+     */
     async build(params) {
+        // Step 1: Upload result to IPFS
         const resultCID = await this.ipfs.add(JSON.stringify(params.resultData));
-        await this.ipfs.pin(resultCID);
+        await this.ipfs.pin(resultCID); // Permanent pinning
+        // Step 2: Compute result hash (canonical JSON)
         const resultHash = (0, canonicalJson_1.computeResultHash)(params.resultData);
+        // Step 3: Create EAS attestation on-chain
         const deliveredAt = Math.floor(Date.now() / 1000);
         const schemaEncoder = new eas_sdk_1.SchemaEncoder('bytes32 txId,string resultCID,bytes32 resultHash,uint256 deliveredAt');
+        // Extract Ethereum address from consumer DID
         const consumerAddress = this.extractAddressFromDID(params.consumer);
         const encodedData = schemaEncoder.encodeData([
             { name: 'txId', value: params.txId, type: 'bytes32' },
@@ -30,13 +60,15 @@ class DeliveryProofBuilder {
             schema: exports.AGIRAILS_DELIVERY_SCHEMA_UID,
             data: {
                 recipient: consumerAddress,
-                expirationTime: 0n,
+                expirationTime: 0n, // No expiration (use bigint)
                 revocable: false,
                 data: encodedData
             }
         });
         const receipt = await tx.wait();
+        // EAS SDK returns attestation UID directly in newAttestationUID
         const attestationUID = receipt.newAttestationUID || receipt;
+        // Step 4: Build delivery proof message (unsigned)
         const deliveryProof = {
             type: 'agirails.delivery.v1',
             version: '1.0.0',
@@ -50,12 +82,15 @@ class DeliveryProofBuilder {
             deliveredAt,
             chainId: params.chainId,
             nonce: this.nonceManager.getNextNonce('agirails.delivery.v1'),
-            signature: ''
+            signature: '' // Filled in next step
         };
+        // Step 5: Sign with EIP-712
         const signature = await this.signDeliveryProof(deliveryProof, params.kernelAddress);
         deliveryProof.signature = signature;
+        // Step 6: Upload delivery proof to IPFS
         const deliveryProofCID = await this.ipfs.add(JSON.stringify(deliveryProof));
-        await this.ipfs.pin(deliveryProofCID);
+        await this.ipfs.pin(deliveryProofCID); // Permanent
+        // Record nonce usage
         this.nonceManager.recordNonce('agirails.delivery.v1', deliveryProof.nonce);
         return {
             deliveryProof,
@@ -63,16 +98,28 @@ class DeliveryProofBuilder {
             attestationUID
         };
     }
+    /**
+     * Verify delivery proof signature and integrity
+     * Reference: AIP-4 §5.2 (Consumer verification)
+     *
+     * @param deliveryProof - Delivery proof message
+     * @param resultData - Actual result data (from IPFS)
+     * @param kernelAddress - ACTPKernel contract address
+     * @returns true if valid, throws error otherwise
+     */
     async verify(deliveryProof, resultData, kernelAddress) {
+        // 1. Verify signature
         const recoveredAddress = await this.recoverDeliveryProofSigner(deliveryProof, kernelAddress);
         const expectedAddress = this.extractAddressFromDID(deliveryProof.provider);
         if (recoveredAddress.toLowerCase() !== expectedAddress.toLowerCase()) {
             throw new Error('Invalid signature: recovered address does not match provider');
         }
+        // 2. Verify result hash
         const computedHash = (0, canonicalJson_1.computeResultHash)(resultData);
         if (computedHash !== deliveryProof.resultHash) {
             throw new Error('Result hash mismatch - data may be tampered');
         }
+        // 3. Verify EAS attestation exists and is valid
         const attestation = await this.eas.getAttestation(deliveryProof.easAttestationUID);
         if (!attestation) {
             throw new Error('Attestation not found on EAS');
@@ -80,12 +127,14 @@ class DeliveryProofBuilder {
         if (attestation.schema !== exports.AGIRAILS_DELIVERY_SCHEMA_UID) {
             throw new Error(`Invalid attestation schema: expected ${exports.AGIRAILS_DELIVERY_SCHEMA_UID}, got ${attestation.schema}`);
         }
+        // Check if attestation is revoked (property may not exist in all EAS SDK versions)
         if ('revoked' in attestation && attestation.revoked) {
             throw new Error('Attestation was revoked');
         }
         if ('revocationTime' in attestation && attestation.revocationTime > 0) {
             throw new Error('Attestation was revoked');
         }
+        // 4. Verify attestation data matches delivery proof
         const schemaEncoder = new eas_sdk_1.SchemaEncoder('bytes32 txId,string resultCID,bytes32 resultHash,uint256 deliveredAt');
         const decodedData = schemaEncoder.decodeData(attestation.data);
         const attestationTxId = decodedData.find((d) => d.name === 'txId')?.value.value;
@@ -102,6 +151,14 @@ class DeliveryProofBuilder {
         }
         return true;
     }
+    /**
+     * Sign delivery proof with EIP-712
+     * Reference: AIP-4 §3.3
+     *
+     * @param deliveryProof - Delivery proof message (unsigned)
+     * @param kernelAddress - ACTPKernel contract address
+     * @returns EIP-712 signature (0x-prefixed, 130 chars)
+     */
     async signDeliveryProof(deliveryProof, kernelAddress) {
         const domain = {
             name: 'AGIRAILS',
@@ -120,12 +177,21 @@ class DeliveryProofBuilder {
             chainId: deliveryProof.chainId,
             nonce: deliveryProof.nonce
         };
+        // Sign using ethers v6 signTypedData API
+        // ethers v6 uses signTypedData() (without underscore)
         if ('signTypedData' in this.signer && typeof this.signer.signTypedData === 'function') {
             const signature = await this.signer.signTypedData(domain, eip712_1.AIP4DeliveryProofTypes, message);
             return signature;
         }
         throw new Error('Signer does not support EIP-712 typed data signing (ethers v6+)');
     }
+    /**
+     * Recover signer address from delivery proof signature
+     *
+     * @param deliveryProof - Delivery proof message
+     * @param kernelAddress - ACTPKernel contract address
+     * @returns Recovered Ethereum address
+     */
     async recoverDeliveryProofSigner(deliveryProof, kernelAddress) {
         const domain = {
             name: 'AGIRAILS',
@@ -144,14 +210,24 @@ class DeliveryProofBuilder {
             chainId: deliveryProof.chainId,
             nonce: deliveryProof.nonce
         };
+        // Recover address using ethers.js verifyTypedData
+        // Wrap in try-catch to handle low-level cryptographic errors gracefully
         try {
             const recoveredAddress = (0, ethers_1.verifyTypedData)(domain, eip712_1.AIP4DeliveryProofTypes, message, deliveryProof.signature);
             return recoveredAddress;
         }
         catch (error) {
+            // Wrap low-level cryptographic errors in meaningful error message
             throw new Error(`Invalid signature: ${error.message || 'signature verification failed'}`);
         }
     }
+    /**
+     * Extract Ethereum address from DID
+     * Supports: did:ethr:0x... and did:ethr:84532:0x...
+     *
+     * @param did - DID string
+     * @returns Ethereum address (0x-prefixed, checksummed)
+     */
     extractAddressFromDID(did) {
         const parts = did.replace('did:ethr:', '').split(':');
         const address = parts.length === 2 ? parts[1] : parts[0];

package/dist/builders/DeliveryProofBuilder.js.map

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