@tapforce/pod-bridge-sdk 1.1.16 → 1.2.1

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

@@ -1,55 +1,57 @@
-import { UnsignedTransaction, CertifiedLog, PodBridgeActionsClientConfig } from "../../libs/types/pod-bridge.types";
+import { UnsignedTransaction, ClaimProofData, PodBridgeActionsClientConfig } from "../../libs/types/pod-bridge.types";
+/**
+ * PodToSourceChainActionClient - Handles Pod -> ETH bridging
+ *
+ * New architecture:
+ * - User deposits ERC20 tokens on Pod
+ * - Wait for TX receipt from Pod
+ * - User claims on ETH with aggregated validator signatures
+ * - Only ERC20 tokens supported (no native tokens)
+ *
+ * Important notes:
+ * - Token addresses on Pod and ETH are different (user deposits AAAA on Pod, claims BBBB on ETH)
+ * - committee_epoch is hardcoded to 0 for now
+ * - aggregated_signatures is concatenation of 65-byte ECDSA signatures (r,s,v)
+ * - proof is the deposit TX hash (subject to change in the future)
+ */
 export declare class PodToSourceChainActionClient {
     private readonly config;
-    private readonly podIface;
-    private readonly sourceChainIface;
+    private readonly iface;
     constructor(config: PodBridgeActionsClientConfig);
     /**
-     * Create unsigned transaction for depositing ERC20 tokens from POD to Bridged chain
-     * @param args.token Token address to deposit
+     * Create unsigned transaction for depositing ERC20 tokens from Pod to ETH
+     *
+     * After deposit:
+     * - Get the TX receipt from Pod
+     * - Call claim() on ETH with aggregated validator signatures
+     *
+     * Note: Native tokens are not supported. Only ERC20.
+     * Note: Token addresses differ between Pod and ETH chains.
+     *
+     * @param args.token Token address on Pod to deposit
      * @param args.amount Amount to deposit (in wei)
-     * @param args.destinationWalletAddress Recipient address on destination chain
+     * @param args.destinationWalletAddress Recipient address on ETH
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded deposit call
      */
-    depositToken(args: {
+    deposit(args: {
         token: string;
         amount: string | bigint;
         destinationWalletAddress: string;
         from?: string;
     }): UnsignedTransaction;
     /**
-     * Create unsigned transaction for depositing native tokens from POD to Bridged chain
-     * @param args.amount Amount to deposit (in wei) - also set as transaction value
-     * @param args.destinationWalletAddress Recipient address on destination chain
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded depositNative call
-     */
-    depositNative(args: {
-        amount: string | bigint;
-        destinationWalletAddress: string;
-        from?: string;
-    }): UnsignedTransaction;
-    /**
-     * Create unsigned transaction for claiming ERC20 tokens on Source Chain (BridgeDepositWithdraw - with certificates)
-     * Used for claiming ERC20 tokens on Source Chain from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
+     * Create unsigned transaction for claiming ERC20 tokens on ETH (source chain)
+     *
+     * This is called after depositing on Pod and getting the TX receipt.
+     * The aggregated_signatures must be recovered to 65-byte format (r,s,v).
+     *
+     * @param args.claimData Claim proof data with aggregated signatures
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded claim call
      */
-    claimWithCertificate(args: {
-        certifiedLog: CertifiedLog;
-        from?: string;
-    }): UnsignedTransaction;
-    /**
-     * Create unsigned transaction for claiming native tokens on Source Chain (BridgeDepositWithdraw - with certificates)
-     * Used for claiming native tokens on Source Chain from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claimNative call
-     */
-    claimNativeWithCertificate(args: {
-        certifiedLog: CertifiedLog;
+    claim(args: {
+        claimData: ClaimProofData;
         from?: string;
     }): UnsignedTransaction;
 }

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

@@ -3,23 +3,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PodToSourceChainActionClient = void 0;
 const ethers_1 = require("ethers");
 const bridge_abi_1 = require("../../libs/abi/bridge.abi");
-const convert_certified_log_helper_1 = require("../../libs/helpers/convert-certified-log.helper");
+/**
+ * PodToSourceChainActionClient - Handles Pod -> ETH bridging
+ *
+ * New architecture:
+ * - User deposits ERC20 tokens on Pod
+ * - Wait for TX receipt from Pod
+ * - User claims on ETH with aggregated validator signatures
+ * - Only ERC20 tokens supported (no native tokens)
+ *
+ * Important notes:
+ * - Token addresses on Pod and ETH are different (user deposits AAAA on Pod, claims BBBB on ETH)
+ * - committee_epoch is hardcoded to 0 for now
+ * - aggregated_signatures is concatenation of 65-byte ECDSA signatures (r,s,v)
+ * - proof is the deposit TX hash (subject to change in the future)
+ */
 class PodToSourceChainActionClient {
     constructor(config) {
         this.config = config;
-        this.podIface = new ethers_1.Interface(bridge_abi_1.POD_BRIDGE_ABI);
-        this.sourceChainIface = new ethers_1.Interface(bridge_abi_1.SOURCE_CHAIN_BRIDGE_ABI);
+        this.iface = new ethers_1.Interface(bridge_abi_1.BRIDGE_ABI);
     }
     /**
-     * Create unsigned transaction for depositing ERC20 tokens from POD to Bridged chain
-     * @param args.token Token address to deposit
+     * Create unsigned transaction for depositing ERC20 tokens from Pod to ETH
+     *
+     * After deposit:
+     * - Get the TX receipt from Pod
+     * - Call claim() on ETH with aggregated validator signatures
+     *
+     * Note: Native tokens are not supported. Only ERC20.
+     * Note: Token addresses differ between Pod and ETH chains.
+     *
+     * @param args.token Token address on Pod to deposit
      * @param args.amount Amount to deposit (in wei)
-     * @param args.destinationWalletAddress Recipient address on destination chain
+     * @param args.destinationWalletAddress Recipient address on ETH
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded deposit call
      */
-    depositToken(args) {
-        const data = this.podIface.encodeFunctionData('deposit', [
+    deposit(args) {
+        const data = this.iface.encodeFunctionData('deposit', [
             args.token,
             args.amount,
             args.destinationWalletAddress
@@ -28,57 +49,34 @@ class PodToSourceChainActionClient {
             to: this.config.pod.contractAddress,
             data,
             value: '0',
-            from: args === null || args === void 0 ? void 0 : args.from
+            from: args?.from
         };
     }
     /**
-     * Create unsigned transaction for depositing native tokens from POD to Bridged chain
-     * @param args.amount Amount to deposit (in wei) - also set as transaction value
-     * @param args.destinationWalletAddress Recipient address on destination chain
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded depositNative call
-     */
-    depositNative(args) {
-        const data = this.podIface.encodeFunctionData('depositNative', [args.destinationWalletAddress]);
-        return {
-            to: this.config.pod.contractAddress,
-            data,
-            value: args.amount.toString(),
-            from: args === null || args === void 0 ? void 0 : args.from
-        };
-    }
-    /**
-     * Create unsigned transaction for claiming ERC20 tokens on Source Chain (BridgeDepositWithdraw - with certificates)
-     * Used for claiming ERC20 tokens on Source Chain from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
+     * Create unsigned transaction for claiming ERC20 tokens on ETH (source chain)
+     *
+     * This is called after depositing on Pod and getting the TX receipt.
+     * The aggregated_signatures must be recovered to 65-byte format (r,s,v).
+     *
+     * @param args.claimData Claim proof data with aggregated signatures
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded claim call
      */
-    claimWithCertificate(args) {
-        // Use source chain interface which has the certificate-based claim function
-        const data = this.sourceChainIface.encodeFunctionData('claim', [args.certifiedLog]);
-        return {
-            to: this.config.sourceChain.contractAddress,
-            data,
-            value: '0',
-            from: args === null || args === void 0 ? void 0 : args.from
-        };
-    }
-    /**
-     * Create unsigned transaction for claiming native tokens on Source Chain (BridgeDepositWithdraw - with certificates)
-     * Used for claiming native tokens on Source Chain from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claimNative call
-     */
-    claimNativeWithCertificate(args) {
-        // Use source chain interface which has the certificate-based claimNative function
-        const data = this.sourceChainIface.encodeFunctionData('claimNative', [(0, convert_certified_log_helper_1.convertFFICertifiedLog)(args.certifiedLog)]);
+    claim(args) {
+        const { ethTokenAddress, amount, to, committeeEpoch, aggregatedSignatures, depositTxHash } = args.claimData;
+        const data = this.iface.encodeFunctionData('claim', [
+            ethTokenAddress,
+            amount,
+            to,
+            committeeEpoch,
+            aggregatedSignatures,
+            depositTxHash
+        ]);
         return {
             to: this.config.sourceChain.contractAddress,
             data,
             value: '0',
-            from: args === null || args === void 0 ? void 0 : args.from
+            from: args?.from
         };
     }
 }

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

@@ -1,64 +1,37 @@
 import { UnsignedTransaction, PodBridgeActionsClientConfig } from "../../libs/types/pod-bridge.types";
+/**
+ * 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)
+ * - NO claim transaction needed on Pod side (auto-claim)
+ * - Only ERC20 tokens supported (wrap ETH to WETH first)
+ */
 export declare class SourceChainToPodActionClient {
     private readonly config;
     private readonly iface;
     constructor(config: PodBridgeActionsClientConfig);
     /**
-     * Create unsigned transaction for depositing ERC20 tokens
-     * @param args.token Token address to deposit
+     * Create unsigned transaction for depositing ERC20 tokens from ETH to Pod
+     *
+     * After deposit:
+     * - Wait for block finalization (~15 min on Sepolia, instant on Anvil)
+     * - 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.
+     *
+     * @param args.token Token address on source chain (ETH) to deposit
      * @param args.amount Amount to deposit (in wei)
-     * @param args.destinationWalletAddress Recipient address on destination chain
-     * @param args.contractAddress Bridge contract address (source chain)
+     * @param args.destinationWalletAddress Recipient address on Pod
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded deposit call
      */
-    depositToken(args: {
+    deposit(args: {
         token: string;
         amount: string | bigint;
         destinationWalletAddress: string;
         from?: string;
     }): UnsignedTransaction;
-    /**
-     * Create unsigned transaction for depositing native tokens (ETH)
-     * @param args.amount Amount to deposit (in wei) - also set as transaction value
-     * @param args.destinationWalletAddress Recipient address on destination chain
-     * @param args.contractAddress Bridge contract address (source chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded depositNative call
-     */
-    depositNative(args: {
-        amount: string | bigint;
-        destinationWalletAddress: string;
-        from?: string;
-    }): UnsignedTransaction;
-    /**
-     * Create unsigned transaction for claiming tokens (BridgeMintBurn - using precompiles)
-     * Used for claiming on POD from Sepolia deposits
-     * @param args.id Request ID from deposit event
-     * @param args.token Token address that was deposited on source chain
-     * @param args.blockNumber Block number of the deposit on source chain
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claim call
-     */
-    claimWithBlockNumber(args: {
-        id: string | bigint;
-        token: string;
-        blockNumber: string | bigint | number;
-        from?: string;
-    }): UnsignedTransaction;
-    /**
-     * Create unsigned transaction for claiming native tokens (BridgeMintBurn - using precompiles)
-     * Used for claiming native tokens on POD from Sepolia deposits
-     * @param args.id Request ID from deposit event
-     * @param args.blockNumber Block number of the deposit on source chain
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claimNative call
-     */
-    claimNativeWithBlockNumber(args: {
-        id: string | bigint;
-        blockNumber: string | bigint | number;
-        from?: string;
-    }): UnsignedTransaction;
 }

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

@@ -3,21 +3,37 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SourceChainToPodActionClient = void 0;
 const ethers_1 = require("ethers");
 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)
+ * - 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.POD_BRIDGE_ABI);
+        this.iface = new ethers_1.Interface(bridge_abi_1.BRIDGE_ABI);
     }
     /**
-     * Create unsigned transaction for depositing ERC20 tokens
-     * @param args.token Token address to deposit
+     * Create unsigned transaction for depositing ERC20 tokens from ETH to Pod
+     *
+     * After deposit:
+     * - Wait for block finalization (~15 min on Sepolia, instant on Anvil)
+     * - 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.
+     *
+     * @param args.token Token address on source chain (ETH) to deposit
      * @param args.amount Amount to deposit (in wei)
-     * @param args.destinationWalletAddress Recipient address on destination chain
-     * @param args.contractAddress Bridge contract address (source chain)
+     * @param args.destinationWalletAddress Recipient address on Pod
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded deposit call
      */
-    depositToken(args) {
+    deposit(args) {
         const data = this.iface.encodeFunctionData('deposit', [
             args.token,
             args.amount,
@@ -27,65 +43,7 @@ class SourceChainToPodActionClient {
             to: this.config.sourceChain.contractAddress,
             data,
             value: '0',
-            from: args === null || args === void 0 ? void 0 : args.from
-        };
-    }
-    /**
-     * Create unsigned transaction for depositing native tokens (ETH)
-     * @param args.amount Amount to deposit (in wei) - also set as transaction value
-     * @param args.destinationWalletAddress Recipient address on destination chain
-     * @param args.contractAddress Bridge contract address (source chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded depositNative call
-     */
-    depositNative(args) {
-        const data = this.iface.encodeFunctionData('depositNative', [args.destinationWalletAddress]);
-        return {
-            to: this.config.sourceChain.contractAddress,
-            data,
-            value: args.amount.toString(),
-            from: args === null || args === void 0 ? void 0 : args.from
-        };
-    }
-    /**
-     * Create unsigned transaction for claiming tokens (BridgeMintBurn - using precompiles)
-     * Used for claiming on POD from Sepolia deposits
-     * @param args.id Request ID from deposit event
-     * @param args.token Token address that was deposited on source chain
-     * @param args.blockNumber Block number of the deposit on source chain
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claim call
-     */
-    claimWithBlockNumber(args) {
-        const data = this.iface.encodeFunctionData('claim(uint256,address,uint256)', [
-            args.id,
-            args.token,
-            args.blockNumber
-        ]);
-        return {
-            to: this.config.pod.contractAddress,
-            data,
-            value: '0',
-            from: args === null || args === void 0 ? void 0 : args.from
-        };
-    }
-    /**
-     * Create unsigned transaction for claiming native tokens (BridgeMintBurn - using precompiles)
-     * Used for claiming native tokens on POD from Sepolia deposits
-     * @param args.id Request ID from deposit event
-     * @param args.blockNumber Block number of the deposit on source chain
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claimNative call
-     */
-    claimNativeWithBlockNumber(args) {
-        const data = this.iface.encodeFunctionData('claimNative(uint256,uint256)', [args.id, args.blockNumber]);
-        return {
-            to: this.config.pod.contractAddress,
-            data,
-            value: '0',
-            from: args === null || args === void 0 ? void 0 : args.from
+            from: args?.from
         };
     }
 }

package/dist/clients/tracker/client.d.ts

@@ -6,13 +6,17 @@ import { PodBridgeConfig, BridgeRequest, BridgeRequestWithType } from "../../lib
  * to provide a unified view of bridge activity across both chains.
  *
  * Bridge Architecture:
- * - Source Chain (e.g., Sepolia): BridgeDepositWithdraw contract
- *   - Deposits lock tokens
- *   - Claims use POD certificates (requires attestations)
+ * - ETH -> Pod: deposits on ETH, AUTO-CLAIM on Pod (no claim needed)
+ * - Pod -> ETH: deposits on Pod, claims on ETH with aggregated validator signatures
+ * - Only ERC20 tokens supported (wrap ETH to WETH)
  *
- * - POD Chain: BridgeMintBurn contract
- *   - Deposits burn tokens (POD has instant finality - single block)
- *   - Claims use block number verification via precompiles
+ * Source Chain (e.g., Sepolia/ETH):
+ *   - Deposits lock ERC20 tokens (ETH -> Pod direction)
+ *   - Claims release ERC20 tokens with validator signatures (Pod -> ETH direction)
+ *
+ * POD Chain:
+ *   - Auto-claim for ETH -> Pod deposits (instant finality)
+ *   - Deposits for Pod -> ETH direction
  */
 export declare class PodBridgeTrackerClient {
     private readonly sourceChainTracker;
@@ -40,19 +44,33 @@ export declare class PodBridgeTrackerClient {
      */
     getAllDepositsFor(address: string, fromBlock?: number): Promise<BridgeRequestWithType[]>;
     /**
-     * Check if deposits can be claimed (block finalized on source chain)
+     * Check if deposits can be claimed
+     *
+     * New architecture:
+     * - ETH -> Pod: AUTO-CLAIM on Pod, no manual claim needed (always returns false)
+     * - Pod -> ETH: Manual claim needed on ETH with aggregated signatures
+     *
      * @param deposit The bridge request to check
-     * @returns True if the deposit can be claimed
+     * @returns True if the deposit can be manually claimed (only Pod -> ETH direction)
      */
     canBeClaimed(deposit: BridgeRequest): Promise<boolean>;
     /**
      * Batch check claim status for multiple deposits
-     * Claims are checked on the opposite chain from where the deposit was made
+     *
+     * New architecture:
+     * - ETH -> Pod: AUTO-CLAIM on Pod (mark as claimed after finalization)
+     * - Pod -> ETH: Check claim events on Source Chain
+     *
      * @private
      */
     private updateClaimStatus;
     /**
      * Batch check if multiple requests have been processed on-chain
+     *
+     * New architecture:
+     * - ETH -> Pod: Auto-claimed after finalization
+     * - Pod -> ETH: Check claim events on Source Chain
+     *
      * @param deposits Array of deposits to check
      * @returns Array of boolean values
      */