@tapforce/pod-bridge-sdk 1.2.5 → 2.0.1

package/dist/clients/action/source-chain-to-pod-client.js

@@ -6,30 +6,30 @@ const bridge_abi_1 = require("../../libs/abi/bridge.abi");
 /**
  * SourceChainToPodActionClient - Handles ETH -> Pod bridging
  *
- * New architecture:
  * - User deposits ERC20 tokens on ETH (source chain)
- * - Balance is automatically added on Pod (~15 min on Sepolia, instant on Anvil)
+ * - Balance is automatically added on Pod after finalization
  * - NO claim transaction needed on Pod side (auto-claim)
- * - Only ERC20 tokens supported (wrap ETH to WETH first)
  */
 class SourceChainToPodActionClient {
     constructor(config) {
         this.config = config;
-        this.iface = new ethers_1.Interface(bridge_abi_1.BRIDGE_ABI);
+        this.iface = new ethers_1.Interface(bridge_abi_1.SOURCE_CHAIN_BRIDGE_ABI);
     }
     /**
      * Create unsigned transaction for depositing ERC20 tokens from ETH to Pod
      *
      * After deposit:
-     * - Wait for block finalization (~15 min on Sepolia, instant on Anvil)
+     * - Wait for block finalization
      * - Balance will be automatically added on Pod (no claim needed)
      *
-     * Note: Native ETH is not supported. Wrap to WETH first.
      * Note: Token addresses differ between ETH and Pod chains.
+     * Note: For USDC-like tokens, use the token's decimals (e.g. parseUnits('1', 6)),
+     *       not parseEther which assumes 18 decimals.
      *
      * @param args.token Token address on source chain (ETH) to deposit
-     * @param args.amount Amount to deposit (in wei)
+     * @param args.amount Amount to deposit (in token's smallest unit)
      * @param args.destinationWalletAddress Recipient address on Pod
+     * @param args.permit Optional permit bytes for gasless approval (default '0x')
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded deposit call
      */
@@ -37,7 +37,8 @@ class SourceChainToPodActionClient {
         const data = this.iface.encodeFunctionData('deposit', [
             args.token,
             args.amount,
-            args.destinationWalletAddress
+            args.destinationWalletAddress,
+            args.permit ?? '0x',
         ]);
         return {
             to: this.config.sourceChain.contractAddress,

package/dist/clients/tracker/client.js

@@ -167,6 +167,7 @@ class PodBridgeTrackerClient {
                 }
                 else {
                     // Pod -> ETH: Check manual claim on Source Chain
+                    // Claim event's txHash field = deposit's requestId (not deposit's txHash)
                     const claimInfo = sourceChainClaimEvents.get(depositData.requestId);
                     if (claimInfo) {
                         depositData.isClaimed = true;
@@ -218,7 +219,7 @@ class PodBridgeTrackerClient {
                 return d.isClaimed;
             }
             else {
-                // Pod -> ETH: Check claim event on Source Chain
+                // Pod -> ETH: Claim event's txHash field = deposit's requestId
                 return sourceChainClaims.has(d.requestId);
             }
         });

package/dist/clients/tracker/pod-tracker.service.d.ts

@@ -2,21 +2,15 @@ import { BridgeRequest, PodBridgeChainConfig } from '../../libs/types/pod-bridge
 /**
  * PodTrackerService - Handles tracking on the POD Chain
  *
- * New architecture:
- * - ETH -> Pod: auto-claim on Pod (no claim tracking needed on Pod)
- * - Pod -> ETH: deposits are made here, claimed on ETH
- * - Only ERC20 tokens supported (no native)
- *
  * Responsibilities:
  * - Fetch deposits made on POD (Pod -> ETH direction)
  *
- * Note: POD uses a single-block architecture where blocks are essentially
- * timestamps. The chain has instant finality.
+ * Note: POD returns logs with blockNumber: null which ethers.js can't parse.
+ * We use raw eth_getLogs RPC calls and parse logs manually.
  */
 export declare class PodTrackerService {
     private readonly config;
     private readonly provider;
-    private readonly bridge;
     private readonly iface;
     private chainId;
     constructor(config: PodBridgeChainConfig);
@@ -24,18 +18,15 @@ export declare class PodTrackerService {
     ensureChainId(): Promise<void>;
     /**
      * Get deposits sent by an address on POD
-     * Note: POD has a single block, so blockNumber is essentially a timestamp
      */
     getDepositsSentBy(address: string): Promise<BridgeRequest[]>;
     /**
      * Get deposits received by an address on POD
-     * Note: POD has a single block, so blockNumber is essentially a timestamp
      */
     getDepositsReceivedBy(address: string): Promise<BridgeRequest[]>;
     /**
-     * Private method to fetch deposits from POD
-     * POD uses a single-block architecture where blocks are essentially timestamps
-     * Event: Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount)
+     * Fetch deposits from POD using raw eth_getLogs RPC.
+     * Pod returns logs with blockNumber: null, so we can't use ethers queryFilter.
      */
     private getDeposits;
 }

package/dist/clients/tracker/pod-tracker.service.js

@@ -7,24 +7,18 @@ const bridge_abi_1 = require("../../libs/abi/bridge.abi");
 /**
  * PodTrackerService - Handles tracking on the POD Chain
  *
- * New architecture:
- * - ETH -> Pod: auto-claim on Pod (no claim tracking needed on Pod)
- * - Pod -> ETH: deposits are made here, claimed on ETH
- * - Only ERC20 tokens supported (no native)
- *
  * Responsibilities:
  * - Fetch deposits made on POD (Pod -> ETH direction)
  *
- * Note: POD uses a single-block architecture where blocks are essentially
- * timestamps. The chain has instant finality.
+ * Note: POD returns logs with blockNumber: null which ethers.js can't parse.
+ * We use raw eth_getLogs RPC calls and parse logs manually.
  */
 class PodTrackerService {
     constructor(config) {
         this.config = config;
         this.chainId = null;
         this.provider = config.provider;
-        this.bridge = new ethers_1.Contract(config.contractAddress, bridge_abi_1.BRIDGE_ABI, this.provider);
-        this.iface = new ethers_1.Interface(bridge_abi_1.BRIDGE_ABI);
+        this.iface = new ethers_1.Interface(bridge_abi_1.POD_BRIDGE_ABI);
         this.initChainId();
     }
     async initChainId() {
@@ -43,43 +37,52 @@ class PodTrackerService {
     }
     /**
      * Get deposits sent by an address on POD
-     * Note: POD has a single block, so blockNumber is essentially a timestamp
      */
     async getDepositsSentBy(address) {
         // Filter by 'from' (second indexed param): Deposit(id, from, to, token, amount)
-        return this.getDeposits({
-            depositEventFilter: [null, address, null]
-        });
+        const fromTopic = ethers_1.ethers.zeroPadValue(address, 32);
+        return this.getDeposits([null, fromTopic, null]);
     }
     /**
      * Get deposits received by an address on POD
-     * Note: POD has a single block, so blockNumber is essentially a timestamp
      */
     async getDepositsReceivedBy(address) {
         // Filter by 'to' (third indexed param): Deposit(id, from, to, token, amount)
-        return this.getDeposits({
-            depositEventFilter: [null, null, address]
-        });
+        const toTopic = ethers_1.ethers.zeroPadValue(address, 32);
+        return this.getDeposits([null, null, toTopic]);
     }
     /**
-     * Private method to fetch deposits from POD
-     * POD uses a single-block architecture where blocks are essentially timestamps
-     * Event: Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount)
+     * Fetch deposits from POD using raw eth_getLogs RPC.
+     * Pod returns logs with blockNumber: null, so we can't use ethers queryFilter.
      */
-    async getDeposits(options) {
+    async getDeposits(topicFilters) {
         const deposits = [];
-        // Event: Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount)
-        const depositFilter = this.bridge.filters.Deposit(...options.depositEventFilter);
-        const depositLogs = await this.bridge.queryFilter(depositFilter);
-        // Process deposits
-        for (const log of depositLogs) {
+        // Deposit event topic
+        const depositEventTopic = this.iface.getEvent('Deposit').topicHash;
+        // Build topics array: [eventSig, ...filters]
+        const topics = [depositEventTopic, ...topicFilters];
+        // Use raw RPC to avoid ethers.js blockNumber validation
+        const rpcProvider = this.provider;
+        const rawLogs = await rpcProvider.send('eth_getLogs', [{
+                address: this.config.contractAddress,
+                topics,
+                fromBlock: 'earliest',
+                toBlock: 'latest',
+            }]);
+        // Log-level blockNumber is null/0x1 on Pod, but receipt-level blockNumber
+        // contains the real timestamp. Fetch receipts in parallel.
+        const receiptPromises = rawLogs.map(log => rpcProvider.send('eth_getTransactionReceipt', [log.transactionHash]));
+        const receipts = await Promise.all(receiptPromises);
+        for (let i = 0; i < rawLogs.length; i++) {
+            const log = rawLogs[i];
+            const receipt = receipts[i];
             const parsed = this.iface.parseLog({
-                topics: [...log.topics],
+                topics: log.topics,
                 data: log.data
             });
             if (parsed) {
-                // Get block for timestamp
-                const block = await this.provider.getBlock(log.blockNumber);
+                // Receipt blockNumber on Pod is a Unix timestamp in hex (e.g. 0x69983FE1 -> 1771585505)
+                const timestamp = receipt?.blockNumber ? parseInt(receipt.blockNumber, 16) : 0;
                 deposits.push({
                     requestId: parsed.args.id.toString(),
                     deposit: {
@@ -90,8 +93,8 @@ class PodTrackerService {
                         token: parsed.args.token,
                         amount: parsed.args.amount.toString(),
                         chainId: this.chainId,
-                        blockNumber: log.blockNumber, // On POD, this is essentially a timestamp
-                        timestamp: block ? Number(block.timestamp) : 0
+                        blockNumber: timestamp,
+                        timestamp,
                     },
                     isClaimed: false,
                     isClaimable: false

package/dist/clients/tracker/source-chain-tracker.service.d.ts

@@ -1,11 +1,6 @@
 import { BridgeRequest, BridgeChain, PodBridgeChainConfig } from '../../libs/types/pod-bridge.types';
 /**
- * SourceChainTrackerService - Handles tracking on the Source Chain (e.g., Sepolia/ETH)
- *
- * New architecture:
- * - ETH -> Pod: deposits are made here, auto-claimed on Pod
- * - Pod -> ETH: claims are made here with aggregated validator signatures
- * - Only ERC20 tokens supported (no native)
+ * SourceChainTrackerService - Handles tracking on the Source Chain (e.g., ETH Mainnet)
  *
  * Responsibilities:
  * - Fetch deposits made on Source Chain (ETH -> Pod direction)
@@ -34,13 +29,13 @@ export declare class SourceChainTrackerService {
     private getDeposits;
     /**
      * Get claim events that occurred ON Source Chain
-     * These are claims of POD deposits (POD → Source Chain direction)
-     * Event: Claim(bytes32 indexed id, address indexed to, address token, uint256 amount)
+     * These are claims of POD deposits (POD -> Source Chain direction)
+     * Event: Claim(bytes32 indexed txHash, address token, address mirrorToken, uint256 amount, address indexed to)
      *
-     * Pod Deposit.id = ETH Claim.id - used to track if deposit was claimed
+     * Pod deposit.txHash = ETH Claim.txHash - used to track if deposit was claimed
      *
      * @param deposits The POD deposits to check for claims
-     * @returns Map of requestId to claim information
+     * @returns Map of deposit txHash to claim information
      */
     getClaimEvents(deposits: BridgeRequest[]): Promise<Map<string, {
         chain: BridgeChain;

package/dist/clients/tracker/source-chain-tracker.service.js

@@ -5,12 +5,7 @@ const ethers_1 = require("ethers");
 const pod_bridge_types_1 = require("../../libs/types/pod-bridge.types");
 const bridge_abi_1 = require("../../libs/abi/bridge.abi");
 /**
- * SourceChainTrackerService - Handles tracking on the Source Chain (e.g., Sepolia/ETH)
- *
- * New architecture:
- * - ETH -> Pod: deposits are made here, auto-claimed on Pod
- * - Pod -> ETH: claims are made here with aggregated validator signatures
- * - Only ERC20 tokens supported (no native)
+ * SourceChainTrackerService - Handles tracking on the Source Chain (e.g., ETH Mainnet)
  *
  * Responsibilities:
  * - Fetch deposits made on Source Chain (ETH -> Pod direction)
@@ -21,8 +16,8 @@ class SourceChainTrackerService {
         this.config = config;
         this.chainId = null;
         this.provider = config.provider;
-        this.bridge = new ethers_1.Contract(config.contractAddress, bridge_abi_1.BRIDGE_ABI, this.provider);
-        this.iface = new ethers_1.Interface(bridge_abi_1.BRIDGE_ABI);
+        this.bridge = new ethers_1.Contract(config.contractAddress, bridge_abi_1.SOURCE_CHAIN_BRIDGE_ABI, this.provider);
+        this.iface = new ethers_1.Interface(bridge_abi_1.SOURCE_CHAIN_BRIDGE_ABI);
         this.initChainId();
     }
     async initChainId() {
@@ -61,7 +56,7 @@ class SourceChainTrackerService {
         const BLOCK_BATCH_SIZE = 10000;
         for (let start = startBlock; start <= currentBlock; start += BLOCK_BATCH_SIZE) {
             const end = Math.min(start + BLOCK_BATCH_SIZE - 1, currentBlock);
-            // Event: Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount)
+            // Event: Deposit(uint256 indexed id, address indexed from, address indexed to, address token, uint256 amount)
             const depositFilter = this.bridge.filters.Deposit(...options.depositEventFilter);
             const depositLogs = await this.bridge.queryFilter(depositFilter, start, end);
             if (start + BLOCK_BATCH_SIZE <= currentBlock) {
@@ -99,13 +94,13 @@ class SourceChainTrackerService {
     }
     /**
      * Get claim events that occurred ON Source Chain
-     * These are claims of POD deposits (POD → Source Chain direction)
-     * Event: Claim(bytes32 indexed id, address indexed to, address token, uint256 amount)
+     * These are claims of POD deposits (POD -> Source Chain direction)
+     * Event: Claim(bytes32 indexed txHash, address token, address mirrorToken, uint256 amount, address indexed to)
      *
-     * Pod Deposit.id = ETH Claim.id - used to track if deposit was claimed
+     * Pod deposit.txHash = ETH Claim.txHash - used to track if deposit was claimed
      *
      * @param deposits The POD deposits to check for claims
-     * @returns Map of requestId to claim information
+     * @returns Map of deposit txHash to claim information
      */
     async getClaimEvents(deposits) {
         const uniqueRecipients = [...new Set(deposits.map(d => d.deposit.destination))];
@@ -114,8 +109,9 @@ class SourceChainTrackerService {
         const currentBlock = await this.provider.getBlockNumber();
         const BLOCK_BATCH_SIZE = 10000;
         for (const recipient of uniqueRecipients) {
-            // Event: Claim(bytes32 indexed id, address indexed to, address token, uint256 amount)
-            const claimFilter = this.bridge.filters.Claim(null, recipient);
+            // Event: Claim(bytes32 indexed txHash, address token, address mirrorToken, uint256 amount, address indexed to)
+            // Must pass null for all non-indexed params (token, mirrorToken, amount) to reach 'to'
+            const claimFilter = this.bridge.filters.Claim(null, null, null, null, recipient);
             for (let start = startBlock; start <= currentBlock; start += BLOCK_BATCH_SIZE) {
                 const end = Math.min(start + BLOCK_BATCH_SIZE - 1, currentBlock);
                 const claimLogs = await this.bridge.queryFilter(claimFilter, start, end);
@@ -135,8 +131,8 @@ class SourceChainTrackerService {
             if (parsed) {
                 // Get block for timestamp
                 const block = await this.provider.getBlock(log.blockNumber);
-                // Pod Deposit.id = ETH Claim.id
-                claimedMap.set(parsed.args.id.toString(), {
+                // Pod deposit.txHash = ETH Claim.txHash
+                claimedMap.set(parsed.args.txHash, {
                     chain: pod_bridge_types_1.BridgeChain.SOURCE_CHAIN,
                     txHash: log.transactionHash,
                     timestamp: block ? Number(block.timestamp) : 0,
@@ -163,7 +159,7 @@ class SourceChainTrackerService {
         }
         // Fallback: Use manual calculation if RPC doesn't support finalized tag
         const currentBlock = await this.provider.getBlockNumber();
-        return currentBlock - 64; // 2 epochs (32 x 2 blocks) ~15 minutes on Sepolia
+        return currentBlock - 64; // 2 epochs (32 x 2 blocks) ~15 minutes
     }
     /**
      * Check if a block is finalized

package/dist/index.d.ts

@@ -2,5 +2,5 @@ export { PodToSourceChainActionClient } from './clients/action/pod-to-source-cha
 export { SourceChainToPodActionClient } from './clients/action/source-chain-to-pod-client';
 export { PodBridgeTrackerClient } from './clients/tracker/client';
 export { BRIDGE_ABI, POD_BRIDGE_ABI, SOURCE_CHAIN_BRIDGE_ABI, } from './libs/abi/bridge.abi';
-export { recoverSignature65B, recoverAggregatedSignatures65B, computeDepositTxHash, extractAggregatedSignatures, extractSignatureInfo, addressFromPublicKey, parseDerSignature, recoverSignatureWithoutPubkey, extractAggregatedSignaturesWithValidators } from './libs/helpers/signature-recovery.helper';
-export { PodBridgeConfig, BridgeRequest, BridgeRequestWithType, BridgeChain, DepositType, UnsignedTransaction, ClaimProofData, PodBridgeActionsClientConfig, PodBridgeChainConfig, } from './libs/types/pod-bridge.types';
+export { getBridgeClaimProof, } from './libs/helpers/bridge-claim-proof.helper';
+export { PodBridgeConfig, BridgeRequest, BridgeRequestWithType, BridgeChain, DepositType, UnsignedTransaction, ClaimProofData, BridgeClaimProofResponse, PodBridgeActionsClientConfig, PodBridgeChainConfig, } from './libs/types/pod-bridge.types';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DepositType = exports.BridgeChain = exports.extractAggregatedSignaturesWithValidators = exports.recoverSignatureWithoutPubkey = exports.parseDerSignature = exports.addressFromPublicKey = exports.extractSignatureInfo = exports.extractAggregatedSignatures = exports.computeDepositTxHash = exports.recoverAggregatedSignatures65B = exports.recoverSignature65B = exports.SOURCE_CHAIN_BRIDGE_ABI = exports.POD_BRIDGE_ABI = exports.BRIDGE_ABI = exports.PodBridgeTrackerClient = exports.SourceChainToPodActionClient = exports.PodToSourceChainActionClient = void 0;
+exports.DepositType = exports.BridgeChain = exports.getBridgeClaimProof = exports.SOURCE_CHAIN_BRIDGE_ABI = exports.POD_BRIDGE_ABI = exports.BRIDGE_ABI = exports.PodBridgeTrackerClient = exports.SourceChainToPodActionClient = exports.PodToSourceChainActionClient = void 0;
 var pod_to_source_chain_client_1 = require("./clients/action/pod-to-source-chain-client");
 Object.defineProperty(exports, "PodToSourceChainActionClient", { enumerable: true, get: function () { return pod_to_source_chain_client_1.PodToSourceChainActionClient; } });
 var source_chain_to_pod_client_1 = require("./clients/action/source-chain-to-pod-client");
@@ -11,16 +11,8 @@ var bridge_abi_1 = require("./libs/abi/bridge.abi");
 Object.defineProperty(exports, "BRIDGE_ABI", { enumerable: true, get: function () { return bridge_abi_1.BRIDGE_ABI; } });
 Object.defineProperty(exports, "POD_BRIDGE_ABI", { enumerable: true, get: function () { return bridge_abi_1.POD_BRIDGE_ABI; } });
 Object.defineProperty(exports, "SOURCE_CHAIN_BRIDGE_ABI", { enumerable: true, get: function () { return bridge_abi_1.SOURCE_CHAIN_BRIDGE_ABI; } });
-var signature_recovery_helper_1 = require("./libs/helpers/signature-recovery.helper");
-Object.defineProperty(exports, "recoverSignature65B", { enumerable: true, get: function () { return signature_recovery_helper_1.recoverSignature65B; } });
-Object.defineProperty(exports, "recoverAggregatedSignatures65B", { enumerable: true, get: function () { return signature_recovery_helper_1.recoverAggregatedSignatures65B; } });
-Object.defineProperty(exports, "computeDepositTxHash", { enumerable: true, get: function () { return signature_recovery_helper_1.computeDepositTxHash; } });
-Object.defineProperty(exports, "extractAggregatedSignatures", { enumerable: true, get: function () { return signature_recovery_helper_1.extractAggregatedSignatures; } });
-Object.defineProperty(exports, "extractSignatureInfo", { enumerable: true, get: function () { return signature_recovery_helper_1.extractSignatureInfo; } });
-Object.defineProperty(exports, "addressFromPublicKey", { enumerable: true, get: function () { return signature_recovery_helper_1.addressFromPublicKey; } });
-Object.defineProperty(exports, "parseDerSignature", { enumerable: true, get: function () { return signature_recovery_helper_1.parseDerSignature; } });
-Object.defineProperty(exports, "recoverSignatureWithoutPubkey", { enumerable: true, get: function () { return signature_recovery_helper_1.recoverSignatureWithoutPubkey; } });
-Object.defineProperty(exports, "extractAggregatedSignaturesWithValidators", { enumerable: true, get: function () { return signature_recovery_helper_1.extractAggregatedSignaturesWithValidators; } });
+var bridge_claim_proof_helper_1 = require("./libs/helpers/bridge-claim-proof.helper");
+Object.defineProperty(exports, "getBridgeClaimProof", { enumerable: true, get: function () { return bridge_claim_proof_helper_1.getBridgeClaimProof; } });
 var pod_bridge_types_1 = require("./libs/types/pod-bridge.types");
 Object.defineProperty(exports, "BridgeChain", { enumerable: true, get: function () { return pod_bridge_types_1.BridgeChain; } });
 Object.defineProperty(exports, "DepositType", { enumerable: true, get: function () { return pod_bridge_types_1.DepositType; } });

package/dist/libs/abi/bridge.abi.d.ts

@@ -1,10 +1,18 @@
 /**
- * ABI for Bridge contract on Source Chain (ETH/Sepolia)
- * New architecture:
- * - ETH -> Pod: deposit on ETH, auto-claim on Pod (no claim needed)
- * - Pod -> ETH: deposit on Pod, claim on ETH with aggregated validator signatures
- * - Only ERC20 tokens supported (no native ETH - must wrap to WETH)
+ * ABI for Bridge contract on Source Chain (ETH/Mainnet)
+ *
+ * ETH -> Pod: deposit on ETH (4-param with permit), auto-claim on Pod
+ * Pod -> ETH: deposit on Pod, claim on ETH with proof from pod_getBridgeClaimProof RPC
+ *
+ * Note: Pod and ETH bridge contracts have DIFFERENT event signatures:
+ * - ETH Deposit: uint256 indexed id (topic 0x71894900...)
+ * - Pod Deposit: bytes32 indexed id (topic 0x980e6de4...)
  */
-export declare const BRIDGE_ABI: string[];
 export declare const SOURCE_CHAIN_BRIDGE_ABI: string[];
+/**
+ * ABI for Bridge system contract on Pod chain.
+ * Pod uses bytes32 indexed id in Deposit events (different from ETH's uint256).
+ * Pod deposit is 3-param (no permit).
+ */
 export declare const POD_BRIDGE_ABI: string[];
+export declare const BRIDGE_ABI: string[];

package/dist/libs/abi/bridge.abi.js

@@ -1,29 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.POD_BRIDGE_ABI = exports.SOURCE_CHAIN_BRIDGE_ABI = exports.BRIDGE_ABI = void 0;
+exports.BRIDGE_ABI = exports.POD_BRIDGE_ABI = exports.SOURCE_CHAIN_BRIDGE_ABI = void 0;
 /**
- * ABI for Bridge contract on Source Chain (ETH/Sepolia)
- * New architecture:
- * - ETH -> Pod: deposit on ETH, auto-claim on Pod (no claim needed)
- * - Pod -> ETH: deposit on Pod, claim on ETH with aggregated validator signatures
- * - Only ERC20 tokens supported (no native ETH - must wrap to WETH)
+ * ABI for Bridge contract on Source Chain (ETH/Mainnet)
+ *
+ * ETH -> Pod: deposit on ETH (4-param with permit), auto-claim on Pod
+ * Pod -> ETH: deposit on Pod, claim on ETH with proof from pod_getBridgeClaimProof RPC
+ *
+ * Note: Pod and ETH bridge contracts have DIFFERENT event signatures:
+ * - ETH Deposit: uint256 indexed id (topic 0x71894900...)
+ * - Pod Deposit: bytes32 indexed id (topic 0x980e6de4...)
  */
-exports.BRIDGE_ABI = [
+exports.SOURCE_CHAIN_BRIDGE_ABI = [
     // Events
-    "event Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount)",
-    "event Claim(bytes32 indexed id, address indexed to, address token, uint256 amount)",
-    // Deposit function (ERC20 only)
-    "function deposit(address token, uint256 amount, address to) returns (bytes32)",
-    // Claim function with aggregated validator signatures
-    "function claim(address token, uint256 amount, address to, uint64 committeeEpoch, bytes aggregatedSignatures, bytes proof)",
+    "event Deposit(uint256 indexed id, address indexed from, address indexed to, address token, uint256 amount)",
+    "event Claim(bytes32 indexed txHash, address token, address mirrorToken, uint256 amount, address indexed to)",
+    // Deposit function (ERC20, with optional permit bytes)
+    "function deposit(address token, uint256 amount, address to, bytes permit) returns (uint256)",
+    // Claim function with proof from pod_getBridgeClaimProof
+    "function claim(address token, uint256 amount, address to, bytes proof, bytes auxTxSuffix)",
     // View functions
     "function processedRequests(bytes32) view returns (bool)",
-    "function BRIDGE_CONTRACT() view returns (address)",
-    "function DOMAIN_SEPARATOR() view returns (bytes32)",
-    "function tokenData(address) view returns (uint256 minAmount, uint256 depositLimit, uint256 claimLimit, tuple(uint256 consumed, uint256 lastUpdated) depositUsage, tuple(uint256 consumed, uint256 lastUpdated) claimUsage, address mirrorToken)",
-    "function whitelistedTokens(uint256) view returns (address)",
+    "function tokenData(address) view returns (uint256, uint256, uint256, tuple(uint256, uint256), tuple(uint256, uint256), address)",
     "function depositIndex() view returns (uint256)",
 ];
-// Legacy alias for backwards compatibility
-exports.SOURCE_CHAIN_BRIDGE_ABI = exports.BRIDGE_ABI;
-exports.POD_BRIDGE_ABI = exports.BRIDGE_ABI;
+/**
+ * ABI for Bridge system contract on Pod chain.
+ * Pod uses bytes32 indexed id in Deposit events (different from ETH's uint256).
+ * Pod deposit is 3-param (no permit).
+ */
+exports.POD_BRIDGE_ABI = [
+    // Events
+    "event Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount)",
+    // Deposit function (3-param, no permit)
+    "function deposit(address token, uint256 amount, address to)",
+];
+// Backward compatibility alias
+exports.BRIDGE_ABI = exports.SOURCE_CHAIN_BRIDGE_ABI;

package/dist/libs/helpers/bridge-claim-proof.helper.d.ts

@@ -0,0 +1,16 @@
+import { JsonRpcProvider } from 'ethers';
+/**
+ * Fetch bridge claim proof from Pod RPC.
+ *
+ * Calls the `pod_getBridgeClaimProof` RPC method with the deposit transaction hash
+ * and returns the proof data formatted for use with the ETH bridge claim function.
+ *
+ * @param podProvider A JsonRpcProvider connected to the Pod RPC
+ * @param depositTxHash The deposit transaction hash on Pod
+ * @returns Formatted proof data ready for the claim call
+ */
+export declare function getBridgeClaimProof(podProvider: JsonRpcProvider, depositTxHash: string): Promise<{
+    proof: string;
+    committeeEpoch: number;
+    auxTxSuffix: string;
+}>;

package/dist/libs/helpers/bridge-claim-proof.helper.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBridgeClaimProof = getBridgeClaimProof;
+/**
+ * Convert a number[] byte array to a 0x-prefixed hex string.
+ */
+function bytesToHex(bytes) {
+    return '0x' + bytes.map(b => b.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * Fetch bridge claim proof from Pod RPC.
+ *
+ * Calls the `pod_getBridgeClaimProof` RPC method with the deposit transaction hash
+ * and returns the proof data formatted for use with the ETH bridge claim function.
+ *
+ * @param podProvider A JsonRpcProvider connected to the Pod RPC
+ * @param depositTxHash The deposit transaction hash on Pod
+ * @returns Formatted proof data ready for the claim call
+ */
+async function getBridgeClaimProof(podProvider, depositTxHash) {
+    const response = await podProvider.send('pod_getBridgeClaimProof', [depositTxHash]);
+    return {
+        proof: bytesToHex(response.proof),
+        committeeEpoch: response.committee_epoch,
+        auxTxSuffix: bytesToHex(response.aux_tx_suffix),
+    };
+}

package/dist/libs/helpers/convert-certified-log.helper.d.ts

@@ -1,11 +1,7 @@
 /**
  * @deprecated This helper is no longer needed in the new bridge architecture.
  *
- * The new bridge uses aggregated validator signatures instead of certified logs.
- * See signature-recovery.helper.ts for the new signature recovery utilities.
- *
- * New architecture:
- * - ETH -> Pod: Auto-claim on Pod (no claim transaction needed)
- * - Pod -> ETH: Claim with aggregated 65-byte ECDSA signatures
+ * The new bridge uses pod_getBridgeClaimProof RPC for claim proofs.
+ * See bridge-claim-proof.helper.ts for the new helper.
  */
 export declare const convertFFICertifiedLog: (_ffi: unknown) => never;

package/dist/libs/helpers/convert-certified-log.helper.js

@@ -2,18 +2,14 @@
 /**
  * @deprecated This helper is no longer needed in the new bridge architecture.
  *
- * The new bridge uses aggregated validator signatures instead of certified logs.
- * See signature-recovery.helper.ts for the new signature recovery utilities.
- *
- * New architecture:
- * - ETH -> Pod: Auto-claim on Pod (no claim transaction needed)
- * - Pod -> ETH: Claim with aggregated 65-byte ECDSA signatures
+ * The new bridge uses pod_getBridgeClaimProof RPC for claim proofs.
+ * See bridge-claim-proof.helper.ts for the new helper.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertFFICertifiedLog = void 0;
 // Kept for backwards compatibility, but will be removed in future versions
 const convertFFICertifiedLog = (_ffi) => {
-    console.warn('[DEPRECATED] convertFFICertifiedLog is deprecated. Use signature-recovery.helper.ts instead.');
-    throw new Error('CertifiedLog format is no longer supported. Use ClaimProofData with aggregated signatures.');
+    console.warn('[DEPRECATED] convertFFICertifiedLog is deprecated. Use getBridgeClaimProof instead.');
+    throw new Error('CertifiedLog format is no longer supported. Use ClaimProofData with proof from pod_getBridgeClaimProof.');
 };
 exports.convertFFICertifiedLog = convertFFICertifiedLog;

package/dist/libs/types/pod-bridge.types.d.ts

@@ -69,13 +69,12 @@ export interface UnsignedTransaction {
  *
  * Flow:
  * 1. User deposits on Pod: pod_bridge.deposit(pod_token, amount, recipient)
- * 2. User waits for TX receipt
- * 3. User claims on ETH: eth_bridge.claim(eth_token, amount, recipient, epoch, signatures, txHash)
+ * 2. Call pod_getBridgeClaimProof(depositTxHash) to get proof
+ * 3. User claims on ETH: eth_bridge.claim(eth_token, amount, recipient, proof, auxTxSuffix)
  *
  * Important:
  * - Token addresses differ between Pod and ETH (deposit AAAA on Pod, claim BBBB on ETH)
- * - Signatures must be 65-byte format (r,s,v) - use recoverSignature65B helper
- * - Proof is the deposit transaction hash from Pod
+ * - Use getBridgeClaimProof helper or call pod_getBridgeClaimProof RPC directly
  */
 export interface ClaimProofData {
     /** Token address on ETH to claim (different from Pod token address) */
@@ -84,17 +83,55 @@ export interface ClaimProofData {
     amount: string | bigint;
     /** Recipient address (same as deposit recipient) */
     to: string;
-    /** Committee epoch - hardcoded to 0 for now */
-    committeeEpoch: number;
-    /**
-     * Concatenated 65-byte ECDSA signatures (r,s,v) from validators.
-     * Pod uses 64-byte signatures, so use recoverSignature65B/recoverAggregatedSignatures65B
-     * to convert to 65-byte format required by the contract.
-     */
-    aggregatedSignatures: string;
-    /**
-     * The deposit transaction hash from Pod.
-     * This is used as proof that the deposit occurred.
-     */
-    depositTxHash: string;
+    /** Hex-encoded proof bytes from pod_getBridgeClaimProof */
+    proof: string;
+    /** Hex-encoded aux_tx_suffix bytes from pod_getBridgeClaimProof */
+    auxTxSuffix: string;
+}
+/**
+ * Raw response from pod_getBridgeClaimProof RPC method
+ */
+export interface BridgeClaimProofResponse {
+    proof: number[];
+    committee_epoch: number;
+    aux_tx_suffix: number[];
+}
+/**
+ * Attestation from a validator (POD-specific)
+ * From: eth_getTransactionReceipt result.pod_metadata.attestations[]
+ */
+export interface RpcAttestation {
+    validator_address: string;
+    sequence_number: number;
+    batch_index: number;
+    timestamp: number;
+    signature: string;
+}
+/**
+ * POD metadata from receipt
+ * From: eth_getTransactionReceipt result.pod_metadata
+ */
+export interface RpcPodMetadata {
+    attestations: RpcAttestation[];
+    committee_epoch: number;
+}
+/**
+ * Raw eth_getTransactionReceipt response for POD chain
+ */
+export interface RpcPodTransactionReceipt {
+    type: string;
+    status: string;
+    cumulativeGasUsed: string;
+    logs: any[];
+    logsBloom: string;
+    transactionHash: string;
+    transactionIndex: string;
+    blockHash: string;
+    blockNumber: string;
+    gasUsed: string;
+    effectiveGasPrice: string;
+    from: string;
+    to: string;
+    contractAddress: string | null;
+    pod_metadata: RpcPodMetadata;
 }