@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/types/eip712.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MESSAGE_TYPES = exports.ACTPMessageTypes = exports.AIP4DeliveryProofTypes = exports.DeliveryProofTypes = exports.QuoteResponseTypes = exports.QuoteRequestTypes = void 0;
-exports.deliveryProofDataFromProof = deliveryProofDataFromProof;
-exports.getMessageTypes = getMessageTypes;
+exports.getMessageTypes = exports.MESSAGE_TYPES = exports.ACTPMessageTypes = exports.AIP4DeliveryProofTypes = exports.deliveryProofDataFromProof = exports.DeliveryProofTypes = exports.QuoteResponseTypes = exports.QuoteRequestTypes = void 0;
+/**
+ * QuoteRequest (AIP-2)
+ * Reference: Yellow Paper §4.2
+ */
 exports.QuoteRequestTypes = {
     QuoteRequest: [
-        { name: 'from', type: 'string' },
-        { name: 'to', type: 'string' },
+        { name: 'from', type: 'string' }, // DID
+        { name: 'to', type: 'string' }, // DID
         { name: 'timestamp', type: 'uint256' },
         { name: 'nonce', type: 'bytes32' },
         { name: 'serviceType', type: 'string' },
@@ -15,6 +17,10 @@ exports.QuoteRequestTypes = {
         { name: 'disputeWindow', type: 'uint256' }
     ]
 };
+/**
+ * QuoteResponse (AIP-2)
+ * Reference: Yellow Paper §4.2
+ */
 exports.QuoteResponseTypes = {
     QuoteResponse: [
         { name: 'from', type: 'string' },
@@ -28,6 +34,10 @@ exports.QuoteResponseTypes = {
         { name: 'terms', type: 'string' }
     ]
 };
+/**
+ * DeliveryProof (AIP-4) - DEPRECATED
+ * @deprecated Use AIP4DeliveryProofTypes instead (AIP-4 v1.1)
+ */
 exports.DeliveryProofTypes = {
     DeliveryProof: [
         { name: 'txId', type: 'bytes32' },
@@ -48,6 +58,11 @@ function deliveryProofDataFromProof(proof) {
         mimeType: proof.metadata.mimeType
     };
 }
+exports.deliveryProofDataFromProof = deliveryProofDataFromProof;
+/**
+ * AIP-4 Delivery Proof (v1.1)
+ * Reference: AIP-4 §3.3
+ */
 exports.AIP4DeliveryProofTypes = {
     DeliveryProof: [
         { name: 'txId', type: 'bytes32' },
@@ -61,6 +76,9 @@ exports.AIP4DeliveryProofTypes = {
         { name: 'nonce', type: 'uint256' }
     ]
 };
+/**
+ * Generic ACTPMessage (fallback for custom AIPs)
+ */
 exports.ACTPMessageTypes = {
     ACTPMessage: [
         { name: 'type', type: 'string' },
@@ -72,13 +90,21 @@ exports.ACTPMessageTypes = {
         { name: 'payload', type: 'bytes' }
     ]
 };
+/**
+ * Message type registry
+ */
 exports.MESSAGE_TYPES = {
     'quote.request': exports.QuoteRequestTypes,
     'quote.response': exports.QuoteResponseTypes,
     'delivery.proof': exports.DeliveryProofTypes,
+    // Fallback for custom/future AIPs
     default: exports.ACTPMessageTypes
 };
+/**
+ * Get EIP-712 types for message type
+ */
 function getMessageTypes(messageType) {
     return exports.MESSAGE_TYPES[messageType] || exports.MESSAGE_TYPES.default;
 }
+exports.getMessageTypes = getMessageTypes;
 //# sourceMappingURL=eip712.js.map

package/dist/types/eip712.js.map

@@ -1 +1 @@
-{"version":3,"file":"eip712.js","sourceRoot":"","sources":["../../src/types/eip712.ts"],"names":[],"mappings":";;;AAqGA,gEASC;AA6DD,0CAEC;AAtJY,QAAA,iBAAiB,GAAG;IAC/B,YAAY,EAAE;QACZ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;QACrC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;KAC3C;CACF,CAAC;AAiBW,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;QACrC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;QACzC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;CACF,CAAC;AAkBW,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;QACxC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;KACrC;CACF,CAAC;AAWF,SAAgB,0BAA0B,CAAC,KAAoB;IAC7D,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;QACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ;KAClC,CAAC;AACJ,CAAC;AAMY,QAAA,sBAAsB,GAAG;IACpC,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;QACvC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC9C,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;QACxC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;KACnC;CACF,CAAC;AAiBW,QAAA,gBAAgB,GAAG;IAC9B,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;QACnC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;KACnC;CACF,CAAC;AAKW,QAAA,aAAa,GAAG;IAC3B,eAAe,EAAE,yBAAiB;IAClC,gBAAgB,EAAE,0BAAkB;IACpC,gBAAgB,EAAE,0BAAkB;IAEpC,OAAO,EAAE,wBAAgB;CAC1B,CAAC;AAKF,SAAgB,eAAe,CAAC,WAAmB;IACjD,OAAO,qBAAa,CAAC,WAAyC,CAAC,IAAI,qBAAa,CAAC,OAAO,CAAC;AAC3F,CAAC"}
+{"version":3,"file":"eip712.js","sourceRoot":"","sources":["../../src/types/eip712.ts"],"names":[],"mappings":";;;AAmBA;;;GAGG;AACU,QAAA,iBAAiB,GAAG;IAC/B,YAAY,EAAE;QACZ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM;QACxC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM;QACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;QACrC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;KAC3C;CACF,CAAC;AAaF;;;GAGG;AACU,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;QACrC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;QACzC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;CACF,CAAC;AAcF;;;GAGG;AACU,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;QACxC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;KACrC;CACF,CAAC;AAWF,SAAgB,0BAA0B,CAAC,KAAoB;IAC7D,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;QACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ;KAClC,CAAC;AACJ,CAAC;AATD,gEASC;AAED;;;GAGG;AACU,QAAA,sBAAsB,GAAG;IACpC,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;QACvC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC9C,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;QACxC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;KACnC;CACF,CAAC;AAcF;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;QACnC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;KACnC;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,eAAe,EAAE,yBAAiB;IAClC,gBAAgB,EAAE,0BAAkB;IACpC,gBAAgB,EAAE,0BAAkB;IACpC,kCAAkC;IAClC,OAAO,EAAE,wBAAgB;CAC1B,CAAC;AAEF;;GAEG;AACH,SAAgB,eAAe,CAAC,WAAmB;IACjD,OAAO,qBAAa,CAAC,WAAyC,CAAC,IAAI,qBAAa,CAAC,OAAO,CAAC;AAC3F,CAAC;AAFD,0CAEC"}

package/dist/types/escrow.d.ts

@@ -1,18 +1,25 @@
+/**
+ * Escrow creation parameters
+ */
 export interface CreateEscrowParams {
-    kernelAddress: string;
-    txId: string;
-    token: string;
+    /** Escrow identifier (bytes32). In ACTP standard this is typically the txId. */
+    escrowId: string;
+    /** Consumer/requester who funds the escrow */
+    requester: string;
+    /** Provider who receives payout on settlement */
+    provider: string;
+    /** Amount locked in escrow (USDC wei, 6 decimals) */
     amount: bigint;
-    beneficiary: string;
 }
+/**
+ * Escrow state (matches on-chain EscrowVault.EscrowData struct)
+ */
 export interface Escrow {
     escrowId: string;
-    kernel: string;
-    txId: string;
-    token: string;
+    requester: string;
+    provider: string;
     amount: bigint;
-    beneficiary: string;
-    createdAt: number;
-    released: boolean;
+    releasedAmount: bigint;
+    active: boolean;
 }
 //# sourceMappingURL=escrow.d.ts.map

package/dist/types/escrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../src/types/escrow.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../src/types/escrow.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/types/index.d.ts

@@ -1,6 +1,11 @@
+/**
+ * Type exports
+ */
 export * from './state';
 export * from './transaction';
 export * from './escrow';
 export * from './message';
 export * from './eip712';
+export * from './agent';
+export * from './did';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/types/index.js

@@ -1,4 +1,7 @@
 "use strict";
+/**
+ * Type exports
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -19,4 +22,9 @@ __exportStar(require("./transaction"), exports);
 __exportStar(require("./escrow"), exports);
 __exportStar(require("./message"), exports);
 __exportStar(require("./eip712"), exports);
+__exportStar(require("./agent"), exports);
+__exportStar(require("./did"), exports);
+// Note: storage and archive types are not yet implemented in this version
+// export * from './storage';
+// export * from './archive';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAIA,0CAAwB;AACxB,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,wCAAsB;AACtB,0EAA0E;AAC1E,6BAA6B;AAC7B,6BAA6B"}

package/dist/types/message.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ACTP Message Types
+ * Reference: Yellow Paper §4-10 (AIPs)
+ */
+/**
+ * Base ACTP message structure
+ */
 export interface ACTPMessage {
     type: string;
     version: string;
@@ -8,6 +15,10 @@ export interface ACTPMessage {
     signature?: string;
     [key: string]: any;
 }
+/**
+ * Quote Request (AIP-2)
+ * Reference: Yellow Paper §6.2.1
+ */
 export interface QuoteRequest extends ACTPMessage {
     type: 'quote.request';
     serviceRequest: {
@@ -24,6 +35,10 @@ export interface QuoteRequest extends ACTPMessage {
     };
     expiresAt: string;
 }
+/**
+ * Quote Response (AIP-2)
+ * Reference: Yellow Paper §6.2.2
+ */
 export interface QuoteResponse extends ACTPMessage {
     type: 'quote.response';
     inResponseTo: string;
@@ -43,6 +58,10 @@ export interface QuoteResponse extends ACTPMessage {
     };
     expiresAt: string;
 }
+/**
+ * Delivery Proof (AIP-4) - DEPRECATED
+ * @deprecated Use DeliveryProofMessage instead (AIP-4 v1.1)
+ */
 export interface DeliveryProof {
     type: 'delivery.proof';
     txId: string;
@@ -55,6 +74,11 @@ export interface DeliveryProof {
         [key: string]: any;
     };
 }
+/**
+ * Delivery Proof Message (AIP-4 v1.1)
+ * Reference: AIP-4 §3.2, §8.1
+ * Complete schema for delivery proofs with EAS attestations
+ */
 export interface DeliveryProofMessage {
     type: 'agirails.delivery.v1';
     version: string;
@@ -75,6 +99,9 @@ export interface DeliveryProofMessage {
     nonce: number;
     signature: string;
 }
+/**
+ * EAS Attestation Data for delivery proofs
+ */
 export interface EASAttestationData {
     schema: string;
     recipient: string;
@@ -83,6 +110,11 @@ export interface EASAttestationData {
     refUID: string;
     data: string;
 }
+/**
+ * Quote Message (AIP-2 v1.0)
+ * Reference: AIP-2 §2.1, §2.2
+ * Price quote submitted by provider for negotiated transactions
+ */
 export interface QuoteMessageV2 {
     type: 'agirails.quote.v1';
     version: '1.0.0';

package/dist/types/message.d.ts.map

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

package/dist/types/message.js

@@ -1,3 +1,7 @@
 "use strict";
+/**
+ * ACTP Message Types
+ * Reference: Yellow Paper §4-10 (AIPs)
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=message.js.map

package/dist/types/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":""}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/state.d.ts

@@ -1,3 +1,7 @@
+/**
+ * ACTP State Machine
+ * Reference: Yellow Paper §3.2
+ */
 export declare enum State {
     INITIATED = 0,
     QUOTED = 1,
@@ -9,11 +13,35 @@ export declare enum State {
     CANCELLED = 7
 }
 export declare class StateMachine {
+    /**
+     * Valid state transitions per Yellow Paper §3.2.2
+     *
+     * SECURITY FIX (CRITICAL-1): State machine must match ACTPKernel contract exactly
+     * Per CLAUDE.md §Architecture Overview - ACTP Protocol State Machine:
+     * - COMMITTED can transition to IN_PROGRESS, DELIVERED, or CANCELLED
+     * - IN_PROGRESS can transition to DELIVERED or CANCELLED (not DISPUTED)
+     * - DISPUTED can only transition to SETTLED (not CANCELLED)
+     */
     private static readonly TRANSITIONS;
+    /**
+     * Check if state transition is valid
+     */
     static isValidTransition(from: State, to: State): boolean;
+    /**
+     * Check if state is terminal (no further transitions)
+     */
     static isTerminalState(state: State): boolean;
+    /**
+     * Get human-readable state name
+     */
     static getStateName(state: State): string;
+    /**
+     * Get all valid next states from current state
+     */
     static getNextValidStates(currentState: State): State[];
+    /**
+     * Validate state transition or throw error
+     */
     static validateTransition(from: State, to: State): void;
 }
 //# sourceMappingURL=state.d.ts.map

package/dist/types/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAKA,oBAAY,KAAK;IACf,SAAS,IAAI;IACb,MAAM,IAAI;IACV,SAAS,IAAI;IACb,WAAW,IAAI;IACf,SAAS,IAAI;IACb,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,SAAS,IAAI;CACd;AAED,qBAAa,YAAY;IAIvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CASjC;IAKF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO;IAOzD,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAO7C,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAOzC,MAAM,CAAC,kBAAkB,CAAC,YAAY,EAAE,KAAK,GAAG,KAAK,EAAE;IAOvD,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,IAAI;CAYxD"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,KAAK;IACf,SAAS,IAAI;IACb,MAAM,IAAI;IACV,SAAS,IAAI;IACb,WAAW,IAAI;IACf,SAAS,IAAI;IACb,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,SAAS,IAAI;CACd;AAED,qBAAa,YAAY;IACvB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAYjC;IAEF;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO;IAIzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAI7C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAIzC;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,YAAY,EAAE,KAAK,GAAG,KAAK,EAAE;IAIvD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,IAAI;CAYxD"}

package/dist/types/state.js

@@ -1,4 +1,8 @@
 "use strict";
+/**
+ * ACTP State Machine
+ * Reference: Yellow Paper §3.2
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StateMachine = exports.State = void 0;
 var State;
@@ -13,18 +17,33 @@ var State;
     State[State["CANCELLED"] = 7] = "CANCELLED";
 })(State || (exports.State = State = {}));
 class StateMachine {
+    /**
+     * Check if state transition is valid
+     */
     static isValidTransition(from, to) {
         return this.TRANSITIONS[from]?.includes(to) ?? false;
     }
+    /**
+     * Check if state is terminal (no further transitions)
+     */
     static isTerminalState(state) {
         return state === State.SETTLED || state === State.CANCELLED;
     }
+    /**
+     * Get human-readable state name
+     */
     static getStateName(state) {
         return State[state];
     }
+    /**
+     * Get all valid next states from current state
+     */
     static getNextValidStates(currentState) {
         return this.TRANSITIONS[currentState] || [];
     }
+    /**
+     * Validate state transition or throw error
+     */
     static validateTransition(from, to) {
         if (!this.isValidTransition(from, to)) {
             const validStates = this.getNextValidStates(from)
@@ -36,14 +55,26 @@ class StateMachine {
     }
 }
 exports.StateMachine = StateMachine;
+/**
+ * Valid state transitions per Yellow Paper §3.2.2
+ *
+ * SECURITY FIX (CRITICAL-1): State machine must match ACTPKernel contract exactly
+ * Per CLAUDE.md §Architecture Overview - ACTP Protocol State Machine:
+ * - COMMITTED can transition to IN_PROGRESS, DELIVERED, or CANCELLED
+ * - IN_PROGRESS can transition to DELIVERED or CANCELLED (not DISPUTED)
+ * - DISPUTED can only transition to SETTLED (not CANCELLED)
+ */
 StateMachine.TRANSITIONS = {
-    [State.INITIATED]: [State.QUOTED, State.COMMITTED, State.CANCELLED],
+    [State.INITIATED]: [State.QUOTED, State.COMMITTED, State.CANCELLED], // Allow direct INITIATED → COMMITTED (AIP-3)
     [State.QUOTED]: [State.COMMITTED, State.CANCELLED],
-    [State.COMMITTED]: [State.IN_PROGRESS, State.CANCELLED],
-    [State.IN_PROGRESS]: [State.DELIVERED, State.DISPUTED],
+    // SECURITY FIX (CRITICAL-1): Add DELIVERED (can skip IN_PROGRESS)
+    [State.COMMITTED]: [State.IN_PROGRESS, State.DELIVERED, State.CANCELLED],
+    // SECURITY FIX (CRITICAL-1): Remove DISPUTED, add CANCELLED
+    [State.IN_PROGRESS]: [State.DELIVERED, State.CANCELLED],
     [State.DELIVERED]: [State.SETTLED, State.DISPUTED],
-    [State.DISPUTED]: [State.SETTLED, State.CANCELLED],
-    [State.SETTLED]: [],
-    [State.CANCELLED]: []
+    // SECURITY FIX (CRITICAL-1): Remove CANCELLED (disputes resolve to SETTLED only)
+    [State.DISPUTED]: [State.SETTLED],
+    [State.SETTLED]: [], // Terminal state
+    [State.CANCELLED]: [] // Terminal state
 };
 //# sourceMappingURL=state.js.map

package/dist/types/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":";;;AAKA,IAAY,KASX;AATD,WAAY,KAAK;IACf,2CAAa,CAAA;IACb,qCAAU,CAAA;IACV,2CAAa,CAAA;IACb,+CAAe,CAAA;IACf,2CAAa,CAAA;IACb,uCAAW,CAAA;IACX,yCAAY,CAAA;IACZ,2CAAa,CAAA;AACf,CAAC,EATW,KAAK,qBAAL,KAAK,QAShB;AAED,MAAa,YAAY;IAkBvB,MAAM,CAAC,iBAAiB,CAAC,IAAW,EAAE,EAAS;QAC7C,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;IACvD,CAAC;IAKD,MAAM,CAAC,eAAe,CAAC,KAAY;QACjC,OAAO,KAAK,KAAK,KAAK,CAAC,OAAO,IAAI,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC;IAC9D,CAAC;IAKD,MAAM,CAAC,YAAY,CAAC,KAAY;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAKD,MAAM,CAAC,kBAAkB,CAAC,YAAmB;QAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAKD,MAAM,CAAC,kBAAkB,CAAC,IAAW,EAAE,EAAS;QAC9C,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;iBAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBAClB,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,IAAI;gBAC3D,0BAA0B,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,IAAI,uBAAuB,EAAE,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;;AAzDH,oCA0DC;AAtDyB,wBAAW,GAA2B;IAC5D,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IACnE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IAClD,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IACvD,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC;IACtD,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;IAClD,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IAClD,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE;IACnB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE;CACtB,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,IAAY,KASX;AATD,WAAY,KAAK;IACf,2CAAa,CAAA;IACb,qCAAU,CAAA;IACV,2CAAa,CAAA;IACb,+CAAe,CAAA;IACf,2CAAa,CAAA;IACb,uCAAW,CAAA;IACX,yCAAY,CAAA;IACZ,2CAAa,CAAA;AACf,CAAC,EATW,KAAK,qBAAL,KAAK,QAShB;AAED,MAAa,YAAY;IAwBvB;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAW,EAAE,EAAS;QAC7C,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAY;QACjC,OAAO,KAAK,KAAK,KAAK,CAAC,OAAO,IAAI,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAY;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,YAAmB;QAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAW,EAAE,EAAS;QAC9C,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;iBAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBAClB,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,IAAI;gBAC3D,0BAA0B,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,IAAI,uBAAuB,EAAE,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;;AAlEH,oCAmEC;AAlEC;;;;;;;;GAQG;AACqB,wBAAW,GAA2B;IAC5D,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,6CAA6C;IAClH,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IAClD,kEAAkE;IAClE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IACxE,4DAA4D;IAC5D,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IACvD,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;IAClD,iFAAiF;IACjF,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IACjC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,iBAAiB;IACtC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,iBAAiB;CACxC,CAAC"}

package/dist/types/transaction.d.ts

@@ -1,4 +1,8 @@
 import { State } from './state';
+/**
+ * ACTP Transaction
+ * Reference: Yellow Paper §3.1
+ */
 export interface Transaction {
     txId: string;
     requester: string;
@@ -6,12 +10,19 @@ export interface Transaction {
     amount: bigint;
     state: State;
     createdAt: number;
+    updatedAt: number;
     deadline: number;
     disputeWindow: number;
     escrowContract: string;
     escrowId: string;
+    serviceHash: string;
+    attestationUID: string;
     metadata: string;
+    platformFeeBpsLocked: number;
 }
+/**
+ * Parameters for creating a new transaction
+ */
 export interface CreateTransactionParams {
     provider: string;
     requester: string;
@@ -20,12 +31,18 @@ export interface CreateTransactionParams {
     disputeWindow: number;
     metadata?: string;
 }
+/**
+ * Dispute resolution split
+ */
 export interface DisputeResolution {
     requesterAmount: bigint;
     providerAmount: bigint;
     mediatorAmount: bigint;
     mediator?: string;
 }
+/**
+ * Economic parameters (fee structure)
+ */
 export interface EconomicParams {
     baseFeeNumerator: number;
     baseFeeDenominator: number;

package/dist/types/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/types/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/types/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/utils/ErrorRecoveryGuide.d.ts

@@ -0,0 +1,125 @@
+/**
+ * ErrorRecoveryGuide - Structured Error Classification and Recovery Guidance
+ *
+ * SECURITY FIX (HIGH-6): Provides comprehensive error recovery documentation
+ * to help developers handle errors appropriately and avoid security pitfalls.
+ *
+ * @module utils/ErrorRecoveryGuide
+ */
+/**
+ * Error severity levels for prioritization
+ */
+export type ErrorSeverity = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Error categories for classification
+ */
+export type ErrorCategory = 'network' | 'authentication' | 'validation' | 'state' | 'escrow' | 'attestation' | 'permission' | 'timeout' | 'unknown';
+/**
+ * Structured error recovery information
+ */
+export interface ErrorRecoveryInfo {
+    /** Error category */
+    category: ErrorCategory;
+    /** Severity level */
+    severity: ErrorSeverity;
+    /** Human-readable description */
+    description: string;
+    /** Recovery steps to attempt */
+    recoverySteps: string[];
+    /** Whether the operation can be safely retried */
+    retryable: boolean;
+    /** Suggested retry delay in milliseconds (if retryable) */
+    retryDelayMs?: number;
+    /** Maximum retry attempts (if retryable) */
+    maxRetries?: number;
+    /** Whether user intervention is required */
+    requiresUserAction: boolean;
+    /** Security implications to be aware of */
+    securityNotes?: string[];
+}
+/**
+ * ErrorRecoveryGuide - Utility for error classification and recovery guidance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.beginner.pay({ to: provider, amount: '100' });
+ * } catch (error) {
+ *   const recovery = ErrorRecoveryGuide.analyze(error);
+ *   console.log('Category:', recovery.category);
+ *   console.log('Steps:', recovery.recoverySteps.join('\n'));
+ *
+ *   if (recovery.retryable) {
+ *     console.log(`Retrying in ${recovery.retryDelayMs}ms...`);
+ *   }
+ * }
+ * ```
+ */
+export declare class ErrorRecoveryGuide {
+    /**
+     * Analyze an error and return recovery guidance
+     *
+     * @param error - The error to analyze
+     * @returns Recovery information with steps and recommendations
+     */
+    static analyze(error: unknown): ErrorRecoveryInfo;
+    /**
+     * Get all known error patterns (for documentation/testing)
+     */
+    static getKnownPatterns(): string[];
+    /**
+     * Check if an error is retryable
+     *
+     * @param error - The error to check
+     * @returns true if the error can be retried
+     */
+    static isRetryable(error: unknown): boolean;
+    /**
+     * Get retry parameters for an error
+     *
+     * @param error - The error to check
+     * @returns Retry parameters or null if not retryable
+     */
+    static getRetryParams(error: unknown): {
+        delayMs: number;
+        maxRetries: number;
+    } | null;
+    /**
+     * Check if an error requires user action
+     *
+     * @param error - The error to check
+     * @returns true if user intervention is needed
+     */
+    static requiresUserAction(error: unknown): boolean;
+    /**
+     * Get security notes for an error (if any)
+     *
+     * @param error - The error to check
+     * @returns Security notes or undefined
+     */
+    static getSecurityNotes(error: unknown): string[] | undefined;
+    /**
+     * Format recovery guidance as a string for logging
+     *
+     * @param error - The error to analyze
+     * @returns Formatted recovery guidance string
+     */
+    static formatGuidance(error: unknown): string;
+}
+/**
+ * Helper function for try-catch with automatic recovery guidance
+ *
+ * @example
+ * ```typescript
+ * const result = await withRecoveryGuidance(
+ *   () => client.beginner.pay({ to: provider, amount: '100' }),
+ *   { logGuidance: true, autoRetry: true }
+ * );
+ * ```
+ */
+export declare function withRecoveryGuidance<T>(operation: () => Promise<T>, options?: {
+    logGuidance?: boolean;
+    autoRetry?: boolean;
+    onError?: (error: unknown, recovery: ErrorRecoveryInfo) => void;
+}): Promise<T>;
+//# sourceMappingURL=ErrorRecoveryGuide.d.ts.map

package/dist/utils/ErrorRecoveryGuide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorRecoveryGuide.d.ts","sourceRoot":"","sources":["../../src/utils/ErrorRecoveryGuide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,gBAAgB,GAChB,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AA2ZD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAkB;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB;IAyBjD;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;IAMnC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAK3C;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,OAAO,GACb;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAajD;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAKlD;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS;IAK7D;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;CAoC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC5D,GACL,OAAO,CAAC,CAAC,CAAC,CAsCZ"}