@palindromepay/sdk 1.9.9 → 2.0.1

package/dist/PalindromePaySDK.d.ts

@@ -86,7 +86,8 @@ export declare enum SDKErrorCode {
     RPC_ERROR = "RPC_ERROR",
     EVIDENCE_ALREADY_SUBMITTED = "EVIDENCE_ALREADY_SUBMITTED",
     ESCROW_NOT_FOUND = "ESCROW_NOT_FOUND",
-    ALREADY_ACCEPTED = "ALREADY_ACCEPTED"
+    ALREADY_ACCEPTED = "ALREADY_ACCEPTED",
+    SIGNATURE_INVALID = "SIGNATURE_INVALID"
 }
 export type EscrowWalletClient = WalletClient<Transport, Chain, Account>;
 export declare class SDKError extends Error {
@@ -331,6 +332,11 @@ export declare class PalindromePaySDK {
      * Used for: deposit, confirmDelivery, requestCancel, submitArbiterDecision
      */
     signWalletAuthorization(walletClient: EscrowWalletClient, walletAddress: Address, escrowId: bigint): Promise<Hex>;
+    /**
+     * Verify a wallet authorization signature locally before submitting transaction
+     * This ensures the signature is cryptographically valid for the expected signer
+     */
+    private verifyWalletSignature;
     /**
      * Sign a confirm delivery message (for gasless meta-tx)
      */
@@ -349,6 +355,7 @@ export declare class PalindromePaySDK {
     isSignatureDeadlineExpired(deadline: bigint, safetySeconds?: number): boolean;
     /**
      * Predict the wallet address for a given escrow ID (before creation)
+     * Calls the contract's computeWalletAddress function - single source of truth
      */
     predictWalletAddress(escrowId: bigint): Promise<Address>;
     /**
@@ -488,6 +495,7 @@ export declare class PalindromePaySDK {
         escrowId: bigint;
         txHash: Hex;
         walletAddress: Address;
+        signatureValid: boolean;
     }>;
     /**
      * Create a new escrow and deposit funds as the buyer (single transaction)
@@ -517,6 +525,7 @@ export declare class PalindromePaySDK {
         escrowId: bigint;
         txHash: Hex;
         walletAddress: Address;
+        signatureValid: boolean;
     }>;
     /**
      * Deposit funds into an existing escrow as the buyer
@@ -530,13 +539,16 @@ export declare class PalindromePaySDK {
      *
      * @param walletClient - The buyer's wallet client (must have account connected)
      * @param escrowId - The escrow ID to deposit into
-     * @returns Transaction hash
+     * @returns Object containing transaction hash and signature validity
      * @throws {SDKError} WALLET_NOT_CONNECTED - If wallet client is not connected
      * @throws {SDKError} NOT_BUYER - If caller is not the designated buyer
      * @throws {SDKError} INVALID_STATE - If escrow is not in AWAITING_PAYMENT state
      * @throws {SDKError} INSUFFICIENT_BALANCE - If buyer has insufficient token balance
      */
-    deposit(walletClient: EscrowWalletClient, escrowId: bigint): Promise<Hex>;
+    deposit(walletClient: EscrowWalletClient, escrowId: bigint): Promise<{
+        txHash: Hex;
+        signatureValid: boolean;
+    }>;
     /**
      * Accept an escrow as the seller (for buyer-created escrows)
      *
@@ -548,13 +560,16 @@ export declare class PalindromePaySDK {
      *
      * @param walletClient - The seller's wallet client (must have account connected)
      * @param escrowId - The escrow ID to accept
-     * @returns Transaction hash
+     * @returns Object containing transaction hash and signature validity
      * @throws {SDKError} WALLET_NOT_CONNECTED - If wallet client is not connected
      * @throws {SDKError} NOT_SELLER - If caller is not the designated seller
      * @throws {SDKError} INVALID_STATE - If escrow is not in AWAITING_DELIVERY state
      * @throws {SDKError} ALREADY_ACCEPTED - If escrow was already accepted
      */
-    acceptEscrow(walletClient: EscrowWalletClient, escrowId: bigint): Promise<Hex>;
+    acceptEscrow(walletClient: EscrowWalletClient, escrowId: bigint): Promise<{
+        txHash: Hex;
+        signatureValid: boolean;
+    }>;
     /**
      * Confirm delivery and release funds to the seller
      *

package/dist/PalindromePaySDK.js

@@ -130,6 +130,7 @@ var SDKErrorCode;
     SDKErrorCode["EVIDENCE_ALREADY_SUBMITTED"] = "EVIDENCE_ALREADY_SUBMITTED";
     SDKErrorCode["ESCROW_NOT_FOUND"] = "ESCROW_NOT_FOUND";
     SDKErrorCode["ALREADY_ACCEPTED"] = "ALREADY_ACCEPTED";
+    SDKErrorCode["SIGNATURE_INVALID"] = "SIGNATURE_INVALID";
 })(SDKErrorCode || (exports.SDKErrorCode = SDKErrorCode = {}));
 class SDKError extends Error {
     constructor(message, code, details) {
@@ -573,6 +574,32 @@ class PalindromePaySDK {
         validateSignature(signature, "wallet authorization signature");
         return signature;
     }
+    /**
+     * Verify a wallet authorization signature locally before submitting transaction
+     * This ensures the signature is cryptographically valid for the expected signer
+     */
+    async verifyWalletSignature(signature, walletAddress, escrowId, expectedSigner) {
+        try {
+            return await (0, viem_1.verifyTypedData)({
+                address: expectedSigner,
+                domain: this.getWalletDomain(walletAddress),
+                types: this.walletAuthorizationTypes,
+                primaryType: "WalletAuthorization",
+                message: {
+                    escrowId,
+                    wallet: walletAddress,
+                    participant: expectedSigner,
+                },
+                signature,
+            });
+        }
+        catch (error) {
+            this.log('warn', 'Signature verification failed', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }
     /**
      * Sign a confirm delivery message (for gasless meta-tx)
      */
@@ -644,17 +671,16 @@ class PalindromePaySDK {
     // ==========================================================================
     /**
      * Predict the wallet address for a given escrow ID (before creation)
+     * Calls the contract's computeWalletAddress function - single source of truth
      */
     async predictWalletAddress(escrowId) {
-        // Use the contract's computeWalletAddress function for accurate prediction
-        // This ensures the SDK always matches the contract's CREATE2 computation
-        const walletAddress = await this.publicClient.readContract({
+        const predicted = await (0, actions_1.readContract)(this.publicClient, {
             address: this.contractAddress,
-            abi: this.abiEscrow,
+            abi: PalindromePay_json_1.default.abi,
             functionName: "computeWalletAddress",
             args: [escrowId],
         });
-        return walletAddress;
+        return predicted;
     }
     // ==========================================================================
     // ESCROW DATA READING
@@ -1045,6 +1071,11 @@ class PalindromePaySDK {
         const predictedWallet = await this.predictWalletAddress(nextId);
         // Sign wallet authorization
         const sellerWalletSig = await this.signWalletAuthorization(walletClient, predictedWallet, nextId);
+        // Pre-validate signature before submitting transaction
+        const isValidSig = await this.verifyWalletSignature(sellerWalletSig, predictedWallet, nextId, walletClient.account.address);
+        if (!isValidSig) {
+            throw new SDKError("Seller wallet signature is invalid - cannot create escrow", SDKErrorCode.SIGNATURE_INVALID);
+        }
         // Create escrow
         const hash = await this.resilientWriteContract(walletClient, {
             address: this.contractAddress,
@@ -1073,7 +1104,30 @@ class PalindromePaySDK {
         });
         const escrowId = events[0]?.args?.escrowId ?? nextId;
         const deal = await this.getEscrowByIdParsed(escrowId);
-        return { escrowId, txHash: hash, walletAddress: deal.wallet };
+        // Verify seller signature is valid on-chain after creation
+        let sellerSigValid = false;
+        try {
+            sellerSigValid = await this.publicClient.readContract({
+                address: deal.wallet,
+                abi: this.abiWallet,
+                functionName: "isSignatureValid",
+                args: [walletClient.account.address],
+            });
+        }
+        catch (error) {
+            this.log('warn', 'Failed to verify seller signature after escrow creation', {
+                escrowId: escrowId.toString(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        if (!sellerSigValid) {
+            this.log('error', 'Seller wallet signature is invalid after escrow creation', {
+                escrowId: escrowId.toString(),
+                seller: walletClient.account.address,
+                wallet: deal.wallet,
+            });
+        }
+        return { escrowId, txHash: hash, walletAddress: deal.wallet, signatureValid: sellerSigValid };
     }
     /**
      * Create a new escrow and deposit funds as the buyer (single transaction)
@@ -1136,6 +1190,11 @@ class PalindromePaySDK {
         const predictedWallet = await this.predictWalletAddress(nextId);
         // Sign wallet authorization
         const buyerWalletSig = await this.signWalletAuthorization(walletClient, predictedWallet, nextId);
+        // Pre-validate signature before submitting transaction
+        const isValidSig = await this.verifyWalletSignature(buyerWalletSig, predictedWallet, nextId, walletClient.account.address);
+        if (!isValidSig) {
+            throw new SDKError("Buyer wallet signature is invalid - cannot create escrow", SDKErrorCode.SIGNATURE_INVALID);
+        }
         // Create escrow and deposit
         const hash = await this.resilientWriteContract(walletClient, {
             address: this.contractAddress,
@@ -1164,7 +1223,30 @@ class PalindromePaySDK {
         });
         const escrowId = events[0]?.args?.escrowId ?? nextId;
         const deal = await this.getEscrowByIdParsed(escrowId);
-        return { escrowId, txHash: hash, walletAddress: deal.wallet };
+        // Verify buyer signature is valid on-chain after creation
+        let buyerSigValid = false;
+        try {
+            buyerSigValid = await this.publicClient.readContract({
+                address: deal.wallet,
+                abi: this.abiWallet,
+                functionName: "isSignatureValid",
+                args: [walletClient.account.address],
+            });
+        }
+        catch (error) {
+            this.log('warn', 'Failed to verify buyer signature after escrow creation', {
+                escrowId: escrowId.toString(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        if (!buyerSigValid) {
+            this.log('error', 'Buyer wallet signature is invalid after escrow creation', {
+                escrowId: escrowId.toString(),
+                buyer: walletClient.account.address,
+                wallet: deal.wallet,
+            });
+        }
+        return { escrowId, txHash: hash, walletAddress: deal.wallet, signatureValid: buyerSigValid };
     }
     // ==========================================================================
     // DEPOSIT
@@ -1181,7 +1263,7 @@ class PalindromePaySDK {
      *
      * @param walletClient - The buyer's wallet client (must have account connected)
      * @param escrowId - The escrow ID to deposit into
-     * @returns Transaction hash
+     * @returns Object containing transaction hash and signature validity
      * @throws {SDKError} WALLET_NOT_CONNECTED - If wallet client is not connected
      * @throws {SDKError} NOT_BUYER - If caller is not the designated buyer
      * @throws {SDKError} INVALID_STATE - If escrow is not in AWAITING_PAYMENT state
@@ -1195,8 +1277,13 @@ class PalindromePaySDK {
         this.verifyState(deal, EscrowState.AWAITING_PAYMENT, "deposit");
         // Approve token spending
         await this.approveTokenIfNeeded(walletClient, deal.token, this.contractAddress, deal.amount);
-        // Sign wallet authorization
+        // Sign wallet authorization using the wallet address from the escrow
         const buyerWalletSig = await this.signWalletAuthorization(walletClient, deal.wallet, escrowId);
+        // Pre-validate signature before submitting transaction
+        const isValidSig = await this.verifyWalletSignature(buyerWalletSig, deal.wallet, escrowId, walletClient.account.address);
+        if (!isValidSig) {
+            throw new SDKError("Buyer wallet signature is invalid - cannot deposit", SDKErrorCode.SIGNATURE_INVALID);
+        }
         // Deposit
         const hash = await this.resilientWriteContract(walletClient, {
             address: this.contractAddress,
@@ -1205,7 +1292,30 @@ class PalindromePaySDK {
             args: [escrowId, buyerWalletSig],
         });
         await this.waitForReceipt(hash);
-        return hash;
+        // Verify buyer signature is valid on-chain after deposit
+        let buyerSigValid = false;
+        try {
+            buyerSigValid = await this.publicClient.readContract({
+                address: deal.wallet,
+                abi: this.abiWallet,
+                functionName: "isSignatureValid",
+                args: [walletClient.account.address],
+            });
+        }
+        catch (error) {
+            this.log('warn', 'Failed to verify buyer signature after deposit', {
+                escrowId: escrowId.toString(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        if (!buyerSigValid) {
+            this.log('error', 'Buyer wallet signature is invalid after deposit', {
+                escrowId: escrowId.toString(),
+                buyer: walletClient.account.address,
+                wallet: deal.wallet,
+            });
+        }
+        return { txHash: hash, signatureValid: buyerSigValid };
     }
     // ==========================================================================
     // ACCEPT ESCROW (for buyer-created escrows)
@@ -1221,7 +1331,7 @@ class PalindromePaySDK {
      *
      * @param walletClient - The seller's wallet client (must have account connected)
      * @param escrowId - The escrow ID to accept
-     * @returns Transaction hash
+     * @returns Object containing transaction hash and signature validity
      * @throws {SDKError} WALLET_NOT_CONNECTED - If wallet client is not connected
      * @throws {SDKError} NOT_SELLER - If caller is not the designated seller
      * @throws {SDKError} INVALID_STATE - If escrow is not in AWAITING_DELIVERY state
@@ -1237,8 +1347,13 @@ class PalindromePaySDK {
         if (deal.sellerWalletSig && deal.sellerWalletSig !== "0x") {
             throw new SDKError("Escrow already accepted", SDKErrorCode.ALREADY_ACCEPTED);
         }
-        // Sign wallet authorization
+        // Sign wallet authorization using the wallet address from the escrow
         const sellerWalletSig = await this.signWalletAuthorization(walletClient, deal.wallet, escrowId);
+        // Pre-validate signature before submitting transaction
+        const isValidSig = await this.verifyWalletSignature(sellerWalletSig, deal.wallet, escrowId, walletClient.account.address);
+        if (!isValidSig) {
+            throw new SDKError("Seller wallet signature is invalid - cannot accept escrow", SDKErrorCode.SIGNATURE_INVALID);
+        }
         // Accept escrow
         const hash = await this.resilientWriteContract(walletClient, {
             address: this.contractAddress,
@@ -1247,7 +1362,30 @@ class PalindromePaySDK {
             args: [escrowId, sellerWalletSig],
         });
         await this.waitForReceipt(hash);
-        return hash;
+        // Verify seller signature is valid on-chain after accept
+        let sellerSigValid = false;
+        try {
+            sellerSigValid = await this.publicClient.readContract({
+                address: deal.wallet,
+                abi: this.abiWallet,
+                functionName: "isSignatureValid",
+                args: [walletClient.account.address],
+            });
+        }
+        catch (error) {
+            this.log('warn', 'Failed to verify seller signature after accept', {
+                escrowId: escrowId.toString(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        if (!sellerSigValid) {
+            this.log('error', 'Seller wallet signature is invalid after accept', {
+                escrowId: escrowId.toString(),
+                seller: walletClient.account.address,
+                wallet: deal.wallet,
+            });
+        }
+        return { txHash: hash, signatureValid: sellerSigValid };
     }
     // ==========================================================================
     // CONFIRM DELIVERY
@@ -1278,6 +1416,11 @@ class PalindromePaySDK {
         this.verifyState(deal, EscrowState.AWAITING_DELIVERY, "confirm delivery");
         // Sign wallet authorization
         const buyerWalletSig = await this.signWalletAuthorization(walletClient, deal.wallet, escrowId);
+        // Pre-validate signature before submitting transaction
+        const isValidSig = await this.verifyWalletSignature(buyerWalletSig, deal.wallet, escrowId, walletClient.account.address);
+        if (!isValidSig) {
+            throw new SDKError("Buyer wallet signature is invalid - cannot confirm delivery", SDKErrorCode.SIGNATURE_INVALID);
+        }
         // Confirm delivery
         const hash = await this.resilientWriteContract(walletClient, {
             address: this.contractAddress,
@@ -1389,6 +1532,11 @@ class PalindromePaySDK {
         }
         // Sign wallet authorization
         const walletSig = await this.signWalletAuthorization(walletClient, deal.wallet, escrowId);
+        // Pre-validate signature before submitting transaction
+        const isValidSig = await this.verifyWalletSignature(walletSig, deal.wallet, escrowId, walletClient.account.address);
+        if (!isValidSig) {
+            throw new SDKError("Wallet signature is invalid - cannot request cancel", SDKErrorCode.SIGNATURE_INVALID);
+        }
         // Request cancel
         const hash = await this.resilientWriteContract(walletClient, {
             address: this.contractAddress,
@@ -1626,6 +1774,11 @@ class PalindromePaySDK {
         this.verifyArbiter(walletClient.account.address, deal);
         // Sign wallet authorization
         const arbiterWalletSig = await this.signWalletAuthorization(walletClient, deal.wallet, escrowId);
+        // Pre-validate signature before submitting transaction
+        const isValidSig = await this.verifyWalletSignature(arbiterWalletSig, deal.wallet, escrowId, walletClient.account.address);
+        if (!isValidSig) {
+            throw new SDKError("Arbiter wallet signature is invalid - cannot submit decision", SDKErrorCode.SIGNATURE_INVALID);
+        }
         // Submit decision
         const hash = await this.resilientWriteContract(walletClient, {
             address: this.contractAddress,