@abbababa/sdk 0.1.1 → 0.3.0

package/dist/wallet/escrow.d.ts

@@ -1,21 +1,39 @@
 import { type TokenInfo } from './constants.js';
-import type { EscrowDetails } from '../types.js';
+import type { EscrowDetails, AgentStats } from '../types.js';
+/** Dispute resolution outcome */
+export declare enum DisputeOutcome {
+    None = 0,
+    BuyerRefund = 1,
+    SellerPaid = 2,
+    Split = 3
+}
+/** Escrow status codes */
+export declare enum EscrowStatus {
+    None = 0,
+    Funded = 1,
+    Delivered = 2,
+    Released = 3,
+    Refunded = 4,
+    Disputed = 5,
+    Resolved = 6,
+    Abandoned = 7
+}
 /**
- * Client for interacting with the ServiceEscrow smart contracts.
- * Supports V3 (multi-token) with automatic fallback to V2 (USDC only).
+ * Client for interacting with the AbbababaEscrowV1 smart contract.
+ * Supports UUPS upgradeable escrow with criteriaHash, 3-tier dispute resolution,
+ * 24h dispute window, auto-release, and abandonment detection.
  * Uses a ZeroDev Kernel account client for sending UserOperations.
  */
 export declare class EscrowClient {
     private kernelClient;
     private chainId;
     private escrowAddress;
-    private escrowVersion;
     private tokenAddress;
     private tokenDecimals;
     constructor(kernelClient: unknown, token?: TokenInfo, chainId?: number);
     /**
      * Convert a platform transaction ID (CUID string) to a bytes32 escrow ID.
-     * Uses keccak256, matching the existing backend pattern in escrow.ts (ethers.id).
+     * Uses keccak256, matching the existing backend pattern.
      */
     static toEscrowId(transactionId: string): `0x${string}`;
     /**
@@ -23,23 +41,102 @@ export declare class EscrowClient {
      * Must be called before fundEscrow.
      */
     approveToken(amount: bigint): Promise<string>;
-    /** @deprecated Use approveToken() instead. */
-    approveUSDC(amount: bigint): Promise<string>;
     /**
-     * Fund an escrow. Calls createEscrow on the escrow contract.
-     * V3: passes token address as 4th argument.
-     * V2 fallback: USDC only (3 arguments).
+     * Generate a criteriaHash from success criteria JSON.
+     * The criteriaHash is stored on-chain to enable Tier 1 algorithmic resolution.
+     */
+    static toCriteriaHash(criteria: object | string): `0x${string}`;
+    /**
+     * Fund an escrow. Calls V1 createEscrow with 6 args including deadline and criteriaHash.
      * The contract will safeTransferFrom the token (amount + 1% buyer fee) from the caller.
+     *
+     * @param transactionId - Platform transaction ID (CUID)
+     * @param sellerAddress - Seller's wallet address
+     * @param amount - Amount in smallest token units (e.g., USDC with 6 decimals)
+     * @param deadline - Unix timestamp for delivery deadline
+     * @param criteriaHash - keccak256 hash of success criteria JSON (enables algorithmic dispute resolution)
+     */
+    fundEscrow(transactionId: string, sellerAddress: string, amount: bigint, deadline: bigint, criteriaHash?: `0x${string}`): Promise<string>;
+    /**
+     * Submit delivery proof on-chain. Called by the seller after completing work.
+     */
+    submitDelivery(transactionId: string, proofHash: `0x${string}`): Promise<string>;
+    /**
+     * Accept delivery and release funds immediately. Called by the buyer.
+     */
+    acceptDelivery(transactionId: string): Promise<string>;
+    /**
+     * Finalize release after the 24h dispute window has passed without a dispute.
+     * Can be called by anyone.
      */
-    fundEscrow(transactionId: string, sellerAddress: string, amount: bigint): Promise<string>;
+    finalizeRelease(transactionId: string): Promise<string>;
     /**
-     * Release escrow funds to the seller.
-     * Callable by the buyer or an arbitrator.
+     * Dispute a delivery within the 24h dispute window. Called by the buyer.
      */
-    releaseEscrow(transactionId: string): Promise<string>;
+    disputeEscrow(transactionId: string): Promise<string>;
     /**
-     * Read escrow details from the contract (view function, no gas needed).
+     * Claim funds for an abandoned escrow (deadline + 7 days passed with no delivery).
+     * Called by the buyer to reclaim funds.
+     */
+    claimAbandoned(transactionId: string): Promise<string>;
+    /**
+     * Read escrow details from the V1 contract (view function, no gas needed).
      */
     getEscrow(transactionId: string): Promise<EscrowDetails | null>;
+    /**
+     * Check if the 24h dispute window is currently active for an escrow.
+     */
+    isDisputeWindowActive(transactionId: string): Promise<boolean>;
+    /**
+     * Check if an escrow can be finalized (dispute window passed, no dispute filed).
+     */
+    canFinalize(transactionId: string): Promise<boolean>;
+    /**
+     * Check if an escrow can be claimed as abandoned (deadline + 7 days passed).
+     */
+    canClaimAbandoned(transactionId: string): Promise<boolean>;
+}
+/**
+ * Read-only client for the AbbababaScoreV1 on-chain reputation system.
+ * No wallet needed — all methods are view functions.
+ */
+export declare class ScoreClient {
+    private chainId;
+    private scoreAddress;
+    constructor(chainId?: number);
+    private getPublicClient;
+    /**
+     * Get an agent's trust score (int256 — can be negative).
+     */
+    getScore(agentAddress: string): Promise<bigint>;
+    /**
+     * Get full agent stats from the reputation contract.
+     */
+    getAgentStats(agentAddress: string): Promise<AgentStats>;
+}
+/**
+ * Client for interacting with the AbbababaResolverV1 contract.
+ * Used for submitting dispute resolutions (requires appropriate role).
+ */
+export declare class ResolverClient {
+    private kernelClient;
+    private chainId;
+    private resolverAddress;
+    constructor(kernelClient: unknown, chainId?: number);
+    /**
+     * Submit Tier 1 algorithmic resolution.
+     * Requires ALGORITHM_ROLE on the resolver contract.
+     */
+    submitAlgorithmicResolution(transactionId: string, outcome: DisputeOutcome, buyerPercent: number, sellerPercent: number, reason: string): Promise<string>;
+    /**
+     * Submit Tier 2 peer arbitration result.
+     * Requires PEER_ARBITER_ROLE on the resolver contract.
+     */
+    submitPeerArbitrationResult(transactionId: string, outcome: DisputeOutcome, buyerPercent: number, sellerPercent: number, reviewers: [string, string, string, string, string]): Promise<string>;
+    /**
+     * Submit Tier 3 human review result.
+     * Requires HUMAN_REVIEWER_ROLE on the resolver contract.
+     */
+    submitHumanReview(transactionId: string, outcome: DisputeOutcome, buyerPercent: number, sellerPercent: number, reason: string): Promise<string>;
 }
 //# sourceMappingURL=escrow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../src/wallet/escrow.ts"],"names":[],"mappings":"AAWA,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAShD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAO;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAQ;gBAEjB,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,SAAwB;IA6BrF;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE;IAIvD;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnD,8CAA8C;IACxC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD;;;;;OAKG;IACG,UAAU,CACd,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;IA0BlB;;;OAGG;IACG,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB3D;;OAEG;IACG,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CA+DtE"}
+{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../src/wallet/escrow.ts"],"names":[],"mappings":"AAWA,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE5D,iCAAiC;AACjC,oBAAY,cAAc;IACxB,IAAI,IAAI;IACR,WAAW,IAAI;IACf,UAAU,IAAI;IACd,KAAK,IAAI;CACV;AAED,0BAA0B;AAC1B,oBAAY,YAAY;IACtB,IAAI,IAAI;IACR,MAAM,IAAI;IACV,SAAS,IAAI;IACb,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,SAAS,IAAI;CACd;AAUD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAQ;gBAEjB,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,SAAwB;IAoBrF;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE;IAIvD;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnD;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,MAAM,EAAE;IAK/D;;;;;;;;;OASG;IACG,UAAU,CACd,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,KAAK,MAAM,EAAyE,GACjG,OAAO,CAAC,MAAM,CAAC;IAiBlB;;OAEG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBtF;;OAEG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB5D;;;OAGG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB7D;;OAEG;IACG,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB3D;;;OAGG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB5D;;OAEG;IACG,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAuCrE;;OAEG;IACG,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBpE;;OAEG;IACG,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB1D;;OAEG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAkBjE;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,SAAwB;IAQ3C,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAarD;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA8B/D;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,eAAe,CAAS;gBAEpB,YAAY,EAAE,OAAO,EAAE,OAAO,SAAwB;IASlE;;;OAGG;IACG,2BAA2B,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;IAiBlB;;;OAGG;IACG,2BAA2B,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC;IAiBlB;;;OAGG;IACG,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;CAgBnB"}

package/dist/wallet/escrow.js

@@ -1,58 +1,68 @@
 import { encodeFunctionData, keccak256, toBytes, createPublicClient, http, } from 'viem';
-import { polygonAmoy, polygon, baseSepolia, base } from 'viem/chains';
-import { SERVICE_ESCROW_V2_ABI, SERVICE_ESCROW_V3_ABI, ERC20_ABI } from './abi.js';
-import { ESCROW_ADDRESSES, ESCROW_V2_ADDRESSES, USDC_ADDRESSES, POLYGON_AMOY_CHAIN_ID, POLYGON_MAINNET_CHAIN_ID, BASE_SEPOLIA_CHAIN_ID, BASE_MAINNET_CHAIN_ID, } from './constants.js';
+import { baseSepolia, base } from 'viem/chains';
+import { ABBABABA_ESCROW_ABI, ABBABABA_SCORE_ABI, ABBABABA_RESOLVER_ABI, ERC20_ABI } from './abi.js';
+import { ESCROW_V1_ADDRESSES, SCORE_V1_ADDRESSES, RESOLVER_V1_ADDRESSES, BASE_SEPOLIA_CHAIN_ID, BASE_MAINNET_CHAIN_ID, getToken, } from './constants.js';
+/** Dispute resolution outcome */
+export var DisputeOutcome;
+(function (DisputeOutcome) {
+    DisputeOutcome[DisputeOutcome["None"] = 0] = "None";
+    DisputeOutcome[DisputeOutcome["BuyerRefund"] = 1] = "BuyerRefund";
+    DisputeOutcome[DisputeOutcome["SellerPaid"] = 2] = "SellerPaid";
+    DisputeOutcome[DisputeOutcome["Split"] = 3] = "Split";
+})(DisputeOutcome || (DisputeOutcome = {}));
+/** Escrow status codes */
+export var EscrowStatus;
+(function (EscrowStatus) {
+    EscrowStatus[EscrowStatus["None"] = 0] = "None";
+    EscrowStatus[EscrowStatus["Funded"] = 1] = "Funded";
+    EscrowStatus[EscrowStatus["Delivered"] = 2] = "Delivered";
+    EscrowStatus[EscrowStatus["Released"] = 3] = "Released";
+    EscrowStatus[EscrowStatus["Refunded"] = 4] = "Refunded";
+    EscrowStatus[EscrowStatus["Disputed"] = 5] = "Disputed";
+    EscrowStatus[EscrowStatus["Resolved"] = 6] = "Resolved";
+    EscrowStatus[EscrowStatus["Abandoned"] = 7] = "Abandoned";
+})(EscrowStatus || (EscrowStatus = {}));
 const CHAINS = {
-    [POLYGON_AMOY_CHAIN_ID]: polygonAmoy,
-    [POLYGON_MAINNET_CHAIN_ID]: polygon,
     [BASE_SEPOLIA_CHAIN_ID]: baseSepolia,
     [BASE_MAINNET_CHAIN_ID]: base,
 };
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+const ZERO_BYTES32 = '0x0000000000000000000000000000000000000000000000000000000000000000';
 /**
- * Client for interacting with the ServiceEscrow smart contracts.
- * Supports V3 (multi-token) with automatic fallback to V2 (USDC only).
+ * Client for interacting with the AbbababaEscrowV1 smart contract.
+ * Supports UUPS upgradeable escrow with criteriaHash, 3-tier dispute resolution,
+ * 24h dispute window, auto-release, and abandonment detection.
  * Uses a ZeroDev Kernel account client for sending UserOperations.
  */
 export class EscrowClient {
     kernelClient;
     chainId;
     escrowAddress;
-    escrowVersion;
     tokenAddress;
     tokenDecimals;
     constructor(kernelClient, token, chainId = BASE_SEPOLIA_CHAIN_ID) {
         this.kernelClient = kernelClient;
         this.chainId = chainId;
-        // Resolve token (default USDC for backward compat)
+        // Resolve token (default USDC)
         if (token) {
             this.tokenAddress = token.address;
             this.tokenDecimals = token.decimals;
         }
         else {
-            const usdc = USDC_ADDRESSES[chainId];
+            const usdc = getToken(chainId, 'USDC');
             if (!usdc)
                 throw new Error(`No USDC address for chain ${chainId}`);
-            this.tokenAddress = usdc;
-            this.tokenDecimals = 6;
-        }
-        // Try V3 first, fall back to V2
-        const v3 = ESCROW_ADDRESSES[chainId];
-        const v2 = ESCROW_V2_ADDRESSES[chainId];
-        if (v3) {
-            this.escrowAddress = v3;
-            this.escrowVersion = 3;
-        }
-        else if (v2) {
-            this.escrowAddress = v2;
-            this.escrowVersion = 2;
-        }
-        else {
-            throw new Error(`No escrow contract for chain ${chainId}`);
+            this.tokenAddress = usdc.address;
+            this.tokenDecimals = usdc.decimals;
         }
+        const v1 = ESCROW_V1_ADDRESSES[chainId];
+        if (!v1)
+            throw new Error(`No V1 escrow contract for chain ${chainId}`);
+        this.escrowAddress = v1;
     }
     /**
      * Convert a platform transaction ID (CUID string) to a bytes32 escrow ID.
-     * Uses keccak256, matching the existing backend pattern in escrow.ts (ethers.id).
+     * Uses keccak256, matching the existing backend pattern.
      */
     static toEscrowId(transactionId) {
         return keccak256(toBytes(transactionId));
@@ -76,33 +86,31 @@ export class EscrowClient {
         });
         return txHash;
     }
-    /** @deprecated Use approveToken() instead. */
-    async approveUSDC(amount) {
-        return this.approveToken(amount);
+    /**
+     * Generate a criteriaHash from success criteria JSON.
+     * The criteriaHash is stored on-chain to enable Tier 1 algorithmic resolution.
+     */
+    static toCriteriaHash(criteria) {
+        const json = typeof criteria === 'string' ? criteria : JSON.stringify(criteria);
+        return keccak256(toBytes(json));
     }
     /**
-     * Fund an escrow. Calls createEscrow on the escrow contract.
-     * V3: passes token address as 4th argument.
-     * V2 fallback: USDC only (3 arguments).
+     * Fund an escrow. Calls V1 createEscrow with 6 args including deadline and criteriaHash.
      * The contract will safeTransferFrom the token (amount + 1% buyer fee) from the caller.
+     *
+     * @param transactionId - Platform transaction ID (CUID)
+     * @param sellerAddress - Seller's wallet address
+     * @param amount - Amount in smallest token units (e.g., USDC with 6 decimals)
+     * @param deadline - Unix timestamp for delivery deadline
+     * @param criteriaHash - keccak256 hash of success criteria JSON (enables algorithmic dispute resolution)
      */
-    async fundEscrow(transactionId, sellerAddress, amount) {
+    async fundEscrow(transactionId, sellerAddress, amount, deadline, criteriaHash = '0x0000000000000000000000000000000000000000000000000000000000000000') {
         const escrowId = EscrowClient.toEscrowId(transactionId);
-        let data;
-        if (this.escrowVersion === 3) {
-            data = encodeFunctionData({
-                abi: SERVICE_ESCROW_V3_ABI,
-                functionName: 'createEscrow',
-                args: [escrowId, sellerAddress, amount, this.tokenAddress],
-            });
-        }
-        else {
-            data = encodeFunctionData({
-                abi: SERVICE_ESCROW_V2_ABI,
-                functionName: 'createEscrow',
-                args: [escrowId, sellerAddress, amount],
-            });
-        }
+        const data = encodeFunctionData({
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'createEscrow',
+            args: [escrowId, sellerAddress, amount, this.tokenAddress, deadline, criteriaHash],
+        });
         const txHash = await this.kernelClient.sendTransaction({
             to: this.escrowAddress,
             data,
@@ -110,15 +118,29 @@ export class EscrowClient {
         return txHash;
     }
     /**
-     * Release escrow funds to the seller.
-     * Callable by the buyer or an arbitrator.
+     * Submit delivery proof on-chain. Called by the seller after completing work.
      */
-    async releaseEscrow(transactionId) {
+    async submitDelivery(transactionId, proofHash) {
         const escrowId = EscrowClient.toEscrowId(transactionId);
-        const abi = this.escrowVersion === 3 ? SERVICE_ESCROW_V3_ABI : SERVICE_ESCROW_V2_ABI;
         const data = encodeFunctionData({
-            abi,
-            functionName: 'release',
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'submitDelivery',
+            args: [escrowId, proofHash],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.escrowAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Accept delivery and release funds immediately. Called by the buyer.
+     */
+    async acceptDelivery(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const data = encodeFunctionData({
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'accept',
             args: [escrowId],
         });
         const txHash = await this.kernelClient.sendTransaction({
@@ -128,57 +150,273 @@ export class EscrowClient {
         return txHash;
     }
     /**
-     * Read escrow details from the contract (view function, no gas needed).
+     * Finalize release after the 24h dispute window has passed without a dispute.
+     * Can be called by anyone.
+     */
+    async finalizeRelease(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const data = encodeFunctionData({
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'finalizeRelease',
+            args: [escrowId],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.escrowAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Dispute a delivery within the 24h dispute window. Called by the buyer.
+     */
+    async disputeEscrow(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const data = encodeFunctionData({
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'dispute',
+            args: [escrowId],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.escrowAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Claim funds for an abandoned escrow (deadline + 7 days passed with no delivery).
+     * Called by the buyer to reclaim funds.
+     */
+    async claimAbandoned(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const data = encodeFunctionData({
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'claimAbandoned',
+            args: [escrowId],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.escrowAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Read escrow details from the V1 contract (view function, no gas needed).
      */
     async getEscrow(transactionId) {
         const escrowId = EscrowClient.toEscrowId(transactionId);
-        const viemChain = CHAINS[this.chainId] ?? polygonAmoy;
+        const viemChain = CHAINS[this.chainId] ?? baseSepolia;
         const publicClient = createPublicClient({
             chain: viemChain,
             transport: http(),
         });
-        if (this.escrowVersion === 3) {
-            const result = await publicClient.readContract({
-                address: this.escrowAddress,
-                abi: SERVICE_ESCROW_V3_ABI,
-                functionName: 'getEscrow',
-                args: [escrowId],
-            });
-            const [token, buyer, seller, amount, buyerFee, status, createdAt, expiresAt] = result;
-            if (buyer === '0x0000000000000000000000000000000000000000') {
-                return null;
-            }
-            return {
-                token,
-                buyer,
-                seller,
-                amount,
-                buyerFee,
-                status,
-                createdAt: Number(createdAt),
-                expiresAt: Number(expiresAt),
-            };
-        }
-        // V2 fallback
         const result = await publicClient.readContract({
             address: this.escrowAddress,
-            abi: SERVICE_ESCROW_V2_ABI,
+            abi: ABBABABA_ESCROW_ABI,
             functionName: 'getEscrow',
             args: [escrowId],
         });
-        const [buyer, seller, amount, buyerFee, status, createdAt, expiresAt] = result;
-        if (buyer === '0x0000000000000000000000000000000000000000') {
+        const [token, buyer, seller, amount, buyerFee, status, createdAt, deadline, deliveredAt, proofHash, criteriaHash] = result;
+        if (buyer === ZERO_ADDRESS) {
             return null;
         }
         return {
+            token,
             buyer,
             seller,
             amount,
             buyerFee,
             status,
             createdAt: Number(createdAt),
-            expiresAt: Number(expiresAt),
+            deadline: Number(deadline),
+            deliveredAt: Number(deliveredAt),
+            proofHash: proofHash === ZERO_BYTES32 ? null : proofHash,
+            criteriaHash: criteriaHash === ZERO_BYTES32 ? null : criteriaHash,
         };
     }
+    /**
+     * Check if the 24h dispute window is currently active for an escrow.
+     */
+    async isDisputeWindowActive(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const viemChain = CHAINS[this.chainId] ?? baseSepolia;
+        const publicClient = createPublicClient({
+            chain: viemChain,
+            transport: http(),
+        });
+        const result = await publicClient.readContract({
+            address: this.escrowAddress,
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'isDisputeWindowActive',
+            args: [escrowId],
+        });
+        return result;
+    }
+    /**
+     * Check if an escrow can be finalized (dispute window passed, no dispute filed).
+     */
+    async canFinalize(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const viemChain = CHAINS[this.chainId] ?? baseSepolia;
+        const publicClient = createPublicClient({
+            chain: viemChain,
+            transport: http(),
+        });
+        const result = await publicClient.readContract({
+            address: this.escrowAddress,
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'canFinalize',
+            args: [escrowId],
+        });
+        return result;
+    }
+    /**
+     * Check if an escrow can be claimed as abandoned (deadline + 7 days passed).
+     */
+    async canClaimAbandoned(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const viemChain = CHAINS[this.chainId] ?? baseSepolia;
+        const publicClient = createPublicClient({
+            chain: viemChain,
+            transport: http(),
+        });
+        const result = await publicClient.readContract({
+            address: this.escrowAddress,
+            abi: ABBABABA_ESCROW_ABI,
+            functionName: 'canClaimAbandoned',
+            args: [escrowId],
+        });
+        return result;
+    }
+}
+/**
+ * Read-only client for the AbbababaScoreV1 on-chain reputation system.
+ * No wallet needed — all methods are view functions.
+ */
+export class ScoreClient {
+    chainId;
+    scoreAddress;
+    constructor(chainId = BASE_SEPOLIA_CHAIN_ID) {
+        this.chainId = chainId;
+        const addr = SCORE_V1_ADDRESSES[chainId];
+        if (!addr)
+            throw new Error(`No Score contract for chain ${chainId}`);
+        this.scoreAddress = addr;
+    }
+    getPublicClient() {
+        const viemChain = CHAINS[this.chainId] ?? baseSepolia;
+        return createPublicClient({
+            chain: viemChain,
+            transport: http(),
+        });
+    }
+    /**
+     * Get an agent's trust score (int256 — can be negative).
+     */
+    async getScore(agentAddress) {
+        const publicClient = this.getPublicClient();
+        const result = await publicClient.readContract({
+            address: this.scoreAddress,
+            abi: ABBABABA_SCORE_ABI,
+            functionName: 'getScore',
+            args: [agentAddress],
+        });
+        return result;
+    }
+    /**
+     * Get full agent stats from the reputation contract.
+     */
+    async getAgentStats(agentAddress) {
+        const publicClient = this.getPublicClient();
+        const [score, stats] = await Promise.all([
+            publicClient.readContract({
+                address: this.scoreAddress,
+                abi: ABBABABA_SCORE_ABI,
+                functionName: 'getScore',
+                args: [agentAddress],
+            }),
+            publicClient.readContract({
+                address: this.scoreAddress,
+                abi: ABBABABA_SCORE_ABI,
+                functionName: 'getStats',
+                args: [agentAddress],
+            }),
+        ]);
+        const [jobsCompleted, disputesLost, abandonments, lastActiveBlock] = stats;
+        return {
+            score: score,
+            totalJobs: jobsCompleted,
+            disputesLost,
+            jobsAbandoned: abandonments,
+            needsBond: score < 0n,
+        };
+    }
+}
+/**
+ * Client for interacting with the AbbababaResolverV1 contract.
+ * Used for submitting dispute resolutions (requires appropriate role).
+ */
+export class ResolverClient {
+    kernelClient;
+    chainId;
+    resolverAddress;
+    constructor(kernelClient, chainId = BASE_SEPOLIA_CHAIN_ID) {
+        this.kernelClient = kernelClient;
+        this.chainId = chainId;
+        const addr = RESOLVER_V1_ADDRESSES[chainId];
+        if (!addr)
+            throw new Error(`No Resolver contract for chain ${chainId}`);
+        this.resolverAddress = addr;
+    }
+    /**
+     * Submit Tier 1 algorithmic resolution.
+     * Requires ALGORITHM_ROLE on the resolver contract.
+     */
+    async submitAlgorithmicResolution(transactionId, outcome, buyerPercent, sellerPercent, reason) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const data = encodeFunctionData({
+            abi: ABBABABA_RESOLVER_ABI,
+            functionName: 'submitAlgorithmicResolution',
+            args: [escrowId, outcome, BigInt(buyerPercent), BigInt(sellerPercent), reason],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.resolverAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Submit Tier 2 peer arbitration result.
+     * Requires PEER_ARBITER_ROLE on the resolver contract.
+     */
+    async submitPeerArbitrationResult(transactionId, outcome, buyerPercent, sellerPercent, reviewers) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const data = encodeFunctionData({
+            abi: ABBABABA_RESOLVER_ABI,
+            functionName: 'submitPeerArbitrationResult',
+            args: [escrowId, outcome, BigInt(buyerPercent), BigInt(sellerPercent), reviewers],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.resolverAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Submit Tier 3 human review result.
+     * Requires HUMAN_REVIEWER_ROLE on the resolver contract.
+     */
+    async submitHumanReview(transactionId, outcome, buyerPercent, sellerPercent, reason) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const data = encodeFunctionData({
+            abi: ABBABABA_RESOLVER_ABI,
+            functionName: 'submitHumanReview',
+            args: [escrowId, outcome, BigInt(buyerPercent), BigInt(sellerPercent), reason],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.resolverAddress,
+            data,
+        });
+        return txHash;
+    }
 }
 //# sourceMappingURL=escrow.js.map