@tapforce/pod-bridge-sdk 1.0.3 → 1.1.1

package/README.md

@@ -34,7 +34,8 @@ pnpm add @tapforce/pod-bridge-sdk
 
 ```typescript
 import { 
-  PodBridgeActionClient, 
+  BridgedToPodActionClient,
+  PodToBridgedActionClient,
   PodBridgeTrackerClient,
   PodBridgeConfig 
 } from '@tapforce/pod-bridge-sdk';
@@ -48,97 +49,122 @@ Create a configuration object with source and destination chain details:
 const config: PodBridgeConfig = {
   bridged: {
     rpcUrl: 'https://sepolia.infura.io/v3/YOUR_KEY',
-    contractAddress: '0x...' // Source chain bridge contract
+    contractAddress: '0x...', // Source chain bridge contract
+    deploymentBlock: 9502541  // Optional: Start indexing from deployment block (avoids querying empty blocks)
   },
   pod: {
     rpcUrl: 'https://pod-rpc.example.com',
-    contractAddress: '0x...' // Destination chain bridge contract
+    contractAddress: '0x...', // Destination chain bridge contract
+    deploymentBlock: 0        // Optional: POD deployment block
   }
 };
 ```
 
 ## Usage
 
-### 1. Action Client - Creating Transactions
+### 1. Action Clients - Creating Transactions
 
-The `PodBridgeActionClient` creates unsigned transactions that you can sign and broadcast.
+The SDK provides two action clients for different bridge directions:
 
-#### Deposit ERC20 Tokens
+- **`BridgedToPodActionClient`**: For Bridged → POD transfers (e.g., Sepolia → POD)
+- **`PodToBridgedActionClient`**: For POD → Bridged transfers (e.g., POD → Sepolia)
+
+#### Configuration for Action Clients
 
 ```typescript
-const actionClient = new PodBridgeActionClient();
+const actionConfig = {
+  bridged: {
+    contractAddress: '0x...' // Bridged chain bridge contract (e.g., Sepolia)
+  },
+  pod: {
+    contractAddress: '0x...' // POD chain bridge contract
+  }
+};
 
-// Create unsigned transaction for ERC20 deposit
-const unsignedTx = actionClient.depositToken({
+const bridgedToPodClient = new BridgedToPodActionClient(actionConfig);
+const podToBridgedClient = new PodToBridgedActionClient(actionConfig);
+```
+
+#### Deposit from Bridged Chain (e.g., Sepolia → POD)
+
+```typescript
+// Create unsigned transaction for ERC20 deposit on Bridged chain
+const unsignedTx = bridgedToPodClient.depositToken({
   token: '0x...', // ERC20 token address
   amount: '1000000000000000000', // Amount in wei (1 token with 18 decimals)
-  recipient: '0x...', // Recipient address on destination chain
-  contractAddress: config.source.contractAddress,
+  destinationWalletAddress: '0x...', // Recipient address on POD
   from: '0x...' // Optional: sender address
 });
 
-// Sign and send transaction using your wallet/provider
-// const tx = await signer.sendTransaction(unsignedTx);
-```
-
-#### Deposit Native Tokens (ETH)
-
-```typescript
-// Create unsigned transaction for native token deposit
-const unsignedTx = actionClient.depositNative({
+// Deposit native tokens
+const unsignedNativeTx = bridgedToPodClient.depositNative({
   amount: '1000000000000000000', // Amount in wei (1 ETH)
-  recipient: '0x...', // Recipient address on destination chain
-  contractAddress: config.source.contractAddress,
+  destinationWalletAddress: '0x...', // Recipient address on POD
   from: '0x...' // Optional: sender address
 });
 
-// Sign and send transaction
+// Sign and send transaction using your wallet/provider
 // const tx = await signer.sendTransaction(unsignedTx);
 ```
 
-#### Claim Tokens (with Certificate) - Sepolia from POD
+#### Claim on POD from Bridged Chain Deposits
 
-For claiming on Sepolia from POD deposits, use certificate-based claims. First, get the certified log from the POD deposit transaction:
+For claiming on POD from Bridged chain deposits, use block number-based claims:
 
 ```typescript
-// Get certified log from POD deposit transaction
-const depositTxHash = '0x...'; // Transaction hash of deposit on POD
-const certifiedLog = await trackerClient.getDepositCertifiedLog(depositTxHash);
-
-// Create unsigned claim transaction for ERC20
-const unsignedTx = actionClient.claimWithCertificate({
-  certifiedLog,
-  contractAddress: config.bridged.contractAddress, // Sepolia bridge contract
+// Create unsigned claim transaction for ERC20 on POD
+const unsignedTx = bridgedToPodClient.claimWithBlockNumber({
+  id: '123', // Request ID from deposit event
+  token: '0x...', // Token address on source chain
+  blockNumber: 12345678, // Block number of deposit on source chain
   from: '0x...' // Optional: claimer address
 });
 
 // For native tokens
-const unsignedNativeTx = actionClient.claimNativeWithCertificate({
-  certifiedLog,
-  contractAddress: config.bridged.contractAddress,
+const unsignedNativeTx = bridgedToPodClient.claimNativeWithBlockNumber({
+  id: '123',
+  blockNumber: 12345678,
   from: '0x...'
 });
 ```
 
-#### Claim Tokens (with Block Number) - POD from Sepolia
+#### Deposit from POD (POD → Bridged Chain)
 
-For claiming on POD from Sepolia deposits, use block number-based claims:
+```typescript
+// Create unsigned transaction for ERC20 deposit on POD
+const unsignedTx = podToBridgedClient.depositToken({
+  token: '0x...', // ERC20 token address
+  amount: '1000000000000000000', // Amount in wei
+  destinationWalletAddress: '0x...', // Recipient address on Bridged chain
+  from: '0x...' // Optional: sender address
+});
+
+// Deposit native tokens
+const unsignedNativeTx = podToBridgedClient.depositNative({
+  amount: '1000000000000000000',
+  destinationWalletAddress: '0x...',
+  from: '0x...'
+});
+```
+
+#### Claim on Bridged Chain from POD Deposits
+
+For claiming on Bridged chain from POD deposits, use certificate-based claims. First, get the certified log from the POD deposit transaction:
 
 ```typescript
-// Create unsigned claim transaction for ERC20
-const unsignedTx = actionClient.claimWithBlockNumber({
-  id: '123', // Request ID from deposit event
-  token: '0x...', // Token address on source chain
-  blockNumber: 12345678, // Block number of deposit on source chain
-  contractAddress: config.destination.contractAddress,
+// Get certified log from POD deposit transaction
+const depositTxHash = '0x...'; // Transaction hash of deposit on POD
+const certifiedLog = await trackerClient.getDepositCertifiedLog(depositTxHash);
+
+// Create unsigned claim transaction for ERC20 on Bridged chain
+const unsignedTx = podToBridgedClient.claimWithCertificate({
+  certifiedLog,
   from: '0x...' // Optional: claimer address
 });
 
 // For native tokens
-const unsignedNativeTx = actionClient.claimNativeWithBlockNumber({
-  id: '123',
-  blockNumber: 12345678,
-  contractAddress: config.destination.contractAddress,
+const unsignedNativeTx = podToBridgedClient.claimNativeWithCertificate({
+  certifiedLog,
   from: '0x...'
 });
 ```
@@ -224,44 +250,69 @@ processedStatuses.forEach((isProcessed, index) => {
 
 ## API Reference
 
-### PodBridgeActionClient
+### BridgedToPodActionClient
+
+Handles transactions for Bridged → POD direction.
+
+#### Constructor
+
+```typescript
+new BridgedToPodActionClient(config: PodBridgeActionsClientConfig)
+```
 
 #### Methods
 
-- **`depositToken(args)`**: Create unsigned transaction for ERC20 deposit
+- **`depositToken(args)`**: Create unsigned transaction for ERC20 deposit on Bridged chain
   - `token`: Token address
   - `amount`: Amount in wei (string | bigint)
-  - `recipient`: Recipient address on destination chain
-  - `contractAddress`: Bridge contract address
+  - `destinationWalletAddress`: Recipient address on POD
   - `from?`: Optional sender address
 
-- **`depositNative(args)`**: Create unsigned transaction for native token deposit
+- **`depositNative(args)`**: Create unsigned transaction for native token deposit on Bridged chain
   - `amount`: Amount in wei (string | bigint)
-  - `recipient`: Recipient address on destination chain
-  - `contractAddress`: Bridge contract address
+  - `destinationWalletAddress`: Recipient address on POD
   - `from?`: Optional sender address
 
-- **`claimWithCertificate(args)`**: Create unsigned transaction for claiming with certificate
-  - `certifiedLog`: Certified log from POD certificate system
-  - `contractAddress`: Bridge contract address
+- **`claimWithBlockNumber(args)`**: Create unsigned transaction for claiming on POD with block number
+  - `id`: Request ID
+  - `token`: Token address
+  - `blockNumber`: Block number of deposit on Bridged chain
   - `from?`: Optional claimer address
 
-- **`claimNativeWithCertificate(args)`**: Create unsigned transaction for claiming native tokens with certificate
-  - `certifiedLog`: Certified log from POD certificate system
-  - `contractAddress`: Bridge contract address
+- **`claimNativeWithBlockNumber(args)`**: Create unsigned transaction for claiming native tokens on POD with block number
+  - `id`: Request ID
+  - `blockNumber`: Block number of deposit on Bridged chain
   - `from?`: Optional claimer address
 
-- **`claimWithBlockNumber(args)`**: Create unsigned transaction for claiming with block number
-  - `id`: Request ID
+### PodToBridgedActionClient
+
+Handles transactions for POD → Bridged direction.
+
+#### Constructor
+
+```typescript
+new PodToBridgedActionClient(config: PodBridgeActionsClientConfig)
+```
+
+#### Methods
+
+- **`depositToken(args)`**: Create unsigned transaction for ERC20 deposit on POD
   - `token`: Token address
-  - `blockNumber`: Block number of deposit
-  - `contractAddress`: Bridge contract address
+  - `amount`: Amount in wei (string | bigint)
+  - `destinationWalletAddress`: Recipient address on Bridged chain
+  - `from?`: Optional sender address
+
+- **`depositNative(args)`**: Create unsigned transaction for native token deposit on POD
+  - `amount`: Amount in wei (string | bigint)
+  - `destinationWalletAddress`: Recipient address on Bridged chain
+  - `from?`: Optional sender address
+
+- **`claimWithCertificate(args)`**: Create unsigned transaction for claiming on Bridged chain with certificate
+  - `certifiedLog`: Certified log from POD certificate system
   - `from?`: Optional claimer address
 
-- **`claimNativeWithBlockNumber(args)`**: Create unsigned transaction for claiming native tokens with block number
-  - `id`: Request ID
-  - `blockNumber`: Block number of deposit
-  - `contractAddress`: Bridge contract address
+- **`claimNativeWithCertificate(args)`**: Create unsigned transaction for claiming native tokens on Bridged chain with certificate
+  - `certifiedLog`: Certified log from POD certificate system
   - `from?`: Optional claimer address
 
 ### PodBridgeTrackerClient
@@ -365,10 +416,10 @@ The SDK supports two bridge implementations:
 
 ```typescript
 import { ethers } from 'ethers';
-import { PodBridgeActionClient, PodBridgeTrackerClient } from '@tapforce/pod-bridge-sdk';
+import { BridgedToPodActionClient, PodBridgeTrackerClient } from '@tapforce/pod-bridge-sdk';
 
 // Setup
-const config = {
+const trackerConfig = {
   bridged: {
     rpcUrl: 'https://sepolia.infura.io/v3/YOUR_KEY',
     contractAddress: '0xSepoliaBridgeContract'
@@ -379,17 +430,21 @@ const config = {
   }
 };
 
-const actionClient = new PodBridgeActionClient();
-const trackerClient = new PodBridgeTrackerClient(config);
-const sepoliaProvider = new ethers.JsonRpcProvider(config.bridged.rpcUrl);
+const actionConfig = {
+  bridged: { contractAddress: '0xSepoliaBridgeContract' },
+  pod: { contractAddress: '0xPodBridgeContract' }
+};
+
+const actionClient = new BridgedToPodActionClient(actionConfig);
+const trackerClient = new PodBridgeTrackerClient(trackerConfig);
+const sepoliaProvider = new ethers.JsonRpcProvider(trackerConfig.bridged.rpcUrl);
 const sepoliaSigner = new ethers.Wallet('PRIVATE_KEY', sepoliaProvider);
 
 // Step 1: Deposit tokens on Sepolia
 const depositTx = actionClient.depositToken({
   token: '0xTokenAddress',
   amount: ethers.parseEther('10').toString(),
-  destinationWalletAddress: await sepoliaSigner.getAddress(),
-  contractAddress: config.bridged.contractAddress
+  destinationWalletAddress: await sepoliaSigner.getAddress()
 });
 
 const tx = await sepoliaSigner.sendTransaction(depositTx);
@@ -409,12 +464,11 @@ if (canClaim) {
   const claimTx = actionClient.claimWithBlockNumber({
     id: latestDeposit.requestId,
     token: latestDeposit.token,
-    blockNumber: latestDeposit.blockNumber,
-    contractAddress: config.pod.contractAddress
+    blockNumber: latestDeposit.blockNumber
   });
   
   // Submit claim on POD
-  const podProvider = new ethers.JsonRpcProvider(config.pod.rpcUrl);
+  const podProvider = new ethers.JsonRpcProvider(trackerConfig.pod.rpcUrl);
   const podSigner = new ethers.Wallet('PRIVATE_KEY', podProvider);
   const claim = await podSigner.sendTransaction(claimTx);
   await claim.wait();
@@ -426,10 +480,10 @@ if (canClaim) {
 
 ```typescript
 import { ethers } from 'ethers';
-import { PodBridgeActionClient, PodBridgeTrackerClient } from '@tapforce/pod-bridge-sdk';
+import { PodToBridgedActionClient, PodBridgeTrackerClient } from '@tapforce/pod-bridge-sdk';
 
 // Setup
-const config = {
+const trackerConfig = {
   bridged: {
     rpcUrl: 'https://sepolia.infura.io/v3/YOUR_KEY',
     contractAddress: '0xSepoliaBridgeContract'
@@ -440,17 +494,21 @@ const config = {
   }
 };
 
-const actionClient = new PodBridgeActionClient();
-const trackerClient = new PodBridgeTrackerClient(config);
-const podProvider = new ethers.JsonRpcProvider(config.pod.rpcUrl);
+const actionConfig = {
+  bridged: { contractAddress: '0xSepoliaBridgeContract' },
+  pod: { contractAddress: '0xPodBridgeContract' }
+};
+
+const actionClient = new PodToBridgedActionClient(actionConfig);
+const trackerClient = new PodBridgeTrackerClient(trackerConfig);
+const podProvider = new ethers.JsonRpcProvider(trackerConfig.pod.rpcUrl);
 const podSigner = new ethers.Wallet('PRIVATE_KEY', podProvider);
 
 // Step 1: Deposit tokens on POD
 const depositTx = actionClient.depositToken({
   token: '0xTokenAddress',
   amount: ethers.parseEther('10').toString(),
-  destinationWalletAddress: await podSigner.getAddress(),
-  contractAddress: config.pod.contractAddress
+  destinationWalletAddress: await podSigner.getAddress()
 });
 
 const tx = await podSigner.sendTransaction(depositTx);
@@ -463,11 +521,10 @@ console.log('Got certified log with attestations');
 
 // Step 3: Claim on Sepolia using certified log
 const claimTx = actionClient.claimWithCertificate({
-  certifiedLog,
-  contractAddress: config.bridged.contractAddress
+  certifiedLog
 });
 
-const sepoliaProvider = new ethers.JsonRpcProvider(config.bridged.rpcUrl);
+const sepoliaProvider = new ethers.JsonRpcProvider(trackerConfig.bridged.rpcUrl);
 const sepoliaSigner = new ethers.Wallet('PRIVATE_KEY', sepoliaProvider);
 const claim = await sepoliaSigner.sendTransaction(claimTx);
 await claim.wait();

package/dist/clients/action/{client.d.ts → bridged-to-pod-client.d.ts}

@@ -1,7 +1,8 @@
-import { UnsignedTransaction, CertifiedLog } from "../../libs/types/pod-bridge.types";
-export declare class PodBridgeActionClient {
+import { UnsignedTransaction, PodBridgeActionsClientConfig } from "../../libs/types/pod-bridge.types";
+export declare class BridgedToPodActionClient {
+    private readonly config;
     private readonly iface;
-    constructor();
+    constructor(config: PodBridgeActionsClientConfig);
     /**
      * Create unsigned transaction for depositing ERC20 tokens
      * @param args.token Token address to deposit
@@ -15,7 +16,6 @@ export declare class PodBridgeActionClient {
         token: string;
         amount: string | bigint;
         destinationWalletAddress: string;
-        contractAddress: string;
         from?: string;
     }): UnsignedTransaction;
     /**
@@ -29,33 +29,6 @@ export declare class PodBridgeActionClient {
     depositNative(args: {
         amount: string | bigint;
         destinationWalletAddress: string;
-        contractAddress: string;
-        from?: string;
-    }): UnsignedTransaction;
-    /**
-     * Create unsigned transaction for claiming tokens (BridgeDepositWithdraw - with certificates)
-     * Used for claiming on Sepolia from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claim call
-     */
-    claimWithCertificate(args: {
-        certifiedLog: CertifiedLog;
-        contractAddress: string;
-        from?: string;
-    }): UnsignedTransaction;
-    /**
-     * Create unsigned transaction for claiming native tokens (BridgeDepositWithdraw - with certificates)
-     * Used for claiming native tokens on Sepolia from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claimNative call
-     */
-    claimNativeWithCertificate(args: {
-        certifiedLog: CertifiedLog;
-        contractAddress: string;
         from?: string;
     }): UnsignedTransaction;
     /**

package/dist/clients/action/{client.js → bridged-to-pod-client.js}

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PodBridgeActionClient = void 0;
+exports.BridgedToPodActionClient = void 0;
 const ethers_1 = require("ethers");
 const bridge_abi_1 = require("../../libs/abi/bridge.abi");
-class PodBridgeActionClient {
-    constructor() {
+class BridgedToPodActionClient {
+    constructor(config) {
+        this.config = config;
         this.iface = new ethers_1.Interface(bridge_abi_1.POD_BRIDGE_ABI);
     }
     /**
@@ -23,7 +24,7 @@ class PodBridgeActionClient {
             args.destinationWalletAddress
         ]);
         return {
-            to: args.contractAddress,
+            to: this.config.bridged.contractAddress,
             data,
             value: '0',
             from: args === null || args === void 0 ? void 0 : args.from
@@ -40,46 +41,12 @@ class PodBridgeActionClient {
     depositNative(args) {
         const data = this.iface.encodeFunctionData('depositNative', [args.destinationWalletAddress]);
         return {
-            to: args.contractAddress,
+            to: this.config.bridged.contractAddress,
             data,
             value: args.amount.toString(),
             from: args === null || args === void 0 ? void 0 : args.from
         };
     }
-    /**
-     * Create unsigned transaction for claiming tokens (BridgeDepositWithdraw - with certificates)
-     * Used for claiming on Sepolia from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claim call
-     */
-    claimWithCertificate(args) {
-        const data = this.iface.encodeFunctionData('claim', [args.certifiedLog]);
-        return {
-            to: args.contractAddress,
-            data,
-            value: '0',
-            from: args === null || args === void 0 ? void 0 : args.from
-        };
-    }
-    /**
-     * Create unsigned transaction for claiming native tokens (BridgeDepositWithdraw - with certificates)
-     * Used for claiming native tokens on Sepolia from POD deposits
-     * @param args.certifiedLog Certified log from POD certificate system
-     * @param args.contractAddress Bridge contract address (destination chain)
-     * @param args.from Optional sender address
-     * @returns Unsigned transaction template with encoded claimNative call
-     */
-    claimNativeWithCertificate(args) {
-        const data = this.iface.encodeFunctionData('claimNative', [args.certifiedLog]);
-        return {
-            to: args.contractAddress,
-            data,
-            value: '0',
-            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
@@ -97,7 +64,7 @@ class PodBridgeActionClient {
             args.blockNumber
         ]);
         return {
-            to: args.contractAddress,
+            to: this.config.pod.contractAddress,
             data,
             value: '0',
             from: args === null || args === void 0 ? void 0 : args.from
@@ -115,11 +82,11 @@ class PodBridgeActionClient {
     claimNativeWithBlockNumber(args) {
         const data = this.iface.encodeFunctionData('claimNative(uint256,uint256)', [args.id, args.blockNumber]);
         return {
-            to: args.contractAddress,
+            to: this.config.pod.contractAddress,
             data,
             value: '0',
             from: args === null || args === void 0 ? void 0 : args.from
         };
     }
 }
-exports.PodBridgeActionClient = PodBridgeActionClient;
+exports.BridgedToPodActionClient = BridgedToPodActionClient;

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

@@ -0,0 +1,54 @@
+import { UnsignedTransaction, CertifiedLog, PodBridgeActionsClientConfig } from "../../libs/types/pod-bridge.types";
+export declare class PodToBridgedActionClient {
+    private readonly config;
+    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
+     * @param args.amount Amount to deposit (in wei)
+     * @param args.destinationWalletAddress Recipient address on destination chain
+     * @param args.from Optional sender address
+     * @returns Unsigned transaction template with encoded deposit call
+     */
+    depositToken(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 tokens on Bridged chain (BridgeDepositWithdraw - with certificates)
+     * Used for claiming on Bridged 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 claim call
+     */
+    claimWithCertificate(args: {
+        certifiedLog: CertifiedLog;
+        from?: string;
+    }): UnsignedTransaction;
+    /**
+     * Create unsigned transaction for claiming native tokens on Bridged chain (BridgeDepositWithdraw - with certificates)
+     * Used for claiming native tokens on Bridged 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;
+        from?: string;
+    }): UnsignedTransaction;
+}

package/dist/clients/action/pod-to-bridged-client.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodToBridgedActionClient = void 0;
+const ethers_1 = require("ethers");
+const bridge_abi_1 = require("../../libs/abi/bridge.abi");
+class PodToBridgedActionClient {
+    constructor(config) {
+        this.config = config;
+        this.iface = new ethers_1.Interface(bridge_abi_1.POD_BRIDGE_ABI);
+    }
+    /**
+     * Create unsigned transaction for depositing ERC20 tokens from POD to Bridged chain
+     * @param args.token Token address to deposit
+     * @param args.amount Amount to deposit (in wei)
+     * @param args.destinationWalletAddress Recipient address on destination chain
+     * @param args.from Optional sender address
+     * @returns Unsigned transaction template with encoded deposit call
+     */
+    depositToken(args) {
+        const data = this.iface.encodeFunctionData('deposit', [
+            args.token,
+            args.amount,
+            args.destinationWalletAddress
+        ]);
+        return {
+            to: this.config.pod.contractAddress,
+            data,
+            value: '0',
+            from: args === null || args === void 0 ? void 0 : 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.iface.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 tokens on Bridged chain (BridgeDepositWithdraw - with certificates)
+     * Used for claiming on Bridged 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 claim call
+     */
+    claimWithCertificate(args) {
+        const data = this.iface.encodeFunctionData('claim', [args.certifiedLog]);
+        return {
+            to: this.config.bridged.contractAddress,
+            data,
+            value: '0',
+            from: args === null || args === void 0 ? void 0 : args.from
+        };
+    }
+    /**
+     * Create unsigned transaction for claiming native tokens on Bridged chain (BridgeDepositWithdraw - with certificates)
+     * Used for claiming native tokens on Bridged 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) {
+        const data = this.iface.encodeFunctionData('claimNative', [args.certifiedLog]);
+        return {
+            to: this.config.bridged.contractAddress,
+            data,
+            value: '0',
+            from: args === null || args === void 0 ? void 0 : args.from
+        };
+    }
+}
+exports.PodToBridgedActionClient = PodToBridgedActionClient;

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

@@ -10,21 +10,21 @@ export declare class PodBridgeTrackerClient {
     /**
      * Get all deposits SENT by an address
      * @param address The address that sent deposits
-     * @param fromBlock Starting block number (default: 0)
+     * @param fromBlock Starting block number (default: contract deployment block or 0)
      * @returns Array of bridge requests sent by this address
      */
     getDepositsSentBy(address: string, fromBlock?: number): Promise<BridgeRequest[]>;
     /**
      * Get all deposits RECEIVED by an address
      * @param address The address that will receive deposits
-     * @param fromBlock Starting block number (default: 0)
+     * @param fromBlock Starting block number (default: contract deployment block or 0)
      * @returns Array of bridge requests sent to this address
      */
     getDepositsReceivedBy(address: string, fromBlock?: number): Promise<BridgeRequest[]>;
     /**
      * Get ALL deposits for an address (both sent and received)
      * @param address The address to check
-     * @param fromBlock Starting block number (default: 0)
+     * @param fromBlock Starting block number (default: contract deployment block or 0)
      * @returns Array of bridge requests with type indicator
      */
     getAllDepositsFor(address: string, fromBlock?: number): Promise<BridgeRequestWithType[]>;
@@ -37,6 +37,7 @@ export declare class PodBridgeTrackerClient {
     /**
      * Batch check claim status for multiple deposits
      * @param deposits Array of deposits to check
+     * @param fromBlock Starting block to query claims from
      */
     private updateClaimStatus;
     /**

package/dist/clients/tracker/client.js

@@ -19,14 +19,16 @@ class PodBridgeTrackerClient {
     /**
      * Get all deposits SENT by an address
      * @param address The address that sent deposits
-     * @param fromBlock Starting block number (default: 0)
+     * @param fromBlock Starting block number (default: contract deployment block or 0)
      * @returns Array of bridge requests sent by this address
      */
-    async getDepositsSentBy(address, fromBlock = 0) {
+    async getDepositsSentBy(address, fromBlock) {
+        var _a;
+        const startBlock = (_a = fromBlock !== null && fromBlock !== void 0 ? fromBlock : this.config.bridged.deploymentBlock) !== null && _a !== void 0 ? _a : 0;
         const deposits = [];
         const currentBlock = await this.bridgedProvider.getBlockNumber();
         const BLOCK_BATCH_SIZE = 10000;
-        for (let start = fromBlock; start <= currentBlock; start += BLOCK_BATCH_SIZE) {
+        for (let start = startBlock; start <= currentBlock; start += BLOCK_BATCH_SIZE) {
             const end = Math.min(start + BLOCK_BATCH_SIZE - 1, currentBlock);
             // With improved events, we can filter by 'from' directly!
             const depositFilter = this.bridgedBridge.filters.Deposit(null, // id
@@ -41,6 +43,10 @@ class PodBridgeTrackerClient {
                 this.bridgedBridge.queryFilter(depositFilter, start, end),
                 this.bridgedBridge.queryFilter(depositNativeFilter, start, end)
             ]);
+            // Add small delay to avoid rate limiting
+            if (start + BLOCK_BATCH_SIZE <= currentBlock) {
+                await new Promise(resolve => setTimeout(resolve, 100));
+            }
             // Process Deposit events
             for (const log of depositLogs) {
                 const parsed = this.iface.parseLog({
@@ -83,20 +89,22 @@ class PodBridgeTrackerClient {
             }
         }
         // Check claim status
-        await this.updateClaimStatus(deposits);
+        await this.updateClaimStatus(deposits, startBlock);
         return deposits.sort((a, b) => b.timestamp - a.timestamp);
     }
     /**
      * Get all deposits RECEIVED by an address
      * @param address The address that will receive deposits
-     * @param fromBlock Starting block number (default: 0)
+     * @param fromBlock Starting block number (default: contract deployment block or 0)
      * @returns Array of bridge requests sent to this address
      */
-    async getDepositsReceivedBy(address, fromBlock = 0) {
+    async getDepositsReceivedBy(address, fromBlock) {
+        var _a;
+        const startBlock = (_a = fromBlock !== null && fromBlock !== void 0 ? fromBlock : this.config.bridged.deploymentBlock) !== null && _a !== void 0 ? _a : 0;
         const deposits = [];
         const currentBlock = await this.bridgedProvider.getBlockNumber();
         const BLOCK_BATCH_SIZE = 10000;
-        for (let start = fromBlock; start <= currentBlock; start += BLOCK_BATCH_SIZE) {
+        for (let start = startBlock; start <= currentBlock; start += BLOCK_BATCH_SIZE) {
             const end = Math.min(start + BLOCK_BATCH_SIZE - 1, currentBlock);
             // With improved events, we can filter by 'to' directly!
             const depositFilter = this.bridgedBridge.filters.Deposit(null, // id
@@ -111,6 +119,10 @@ class PodBridgeTrackerClient {
                 this.bridgedBridge.queryFilter(depositFilter, start, end),
                 this.bridgedBridge.queryFilter(depositNativeFilter, start, end)
             ]);
+            // Add small delay to avoid rate limiting
+            if (start + BLOCK_BATCH_SIZE <= currentBlock) {
+                await new Promise(resolve => setTimeout(resolve, 100));
+            }
             // Process Deposit events
             for (const log of depositLogs) {
                 const parsed = this.iface.parseLog({
@@ -153,16 +165,16 @@ class PodBridgeTrackerClient {
             }
         }
         // Check claim status
-        await this.updateClaimStatus(deposits);
+        await this.updateClaimStatus(deposits, startBlock);
         return deposits.sort((a, b) => b.timestamp - a.timestamp);
     }
     /**
      * Get ALL deposits for an address (both sent and received)
      * @param address The address to check
-     * @param fromBlock Starting block number (default: 0)
+     * @param fromBlock Starting block number (default: contract deployment block or 0)
      * @returns Array of bridge requests with type indicator
      */
-    async getAllDepositsFor(address, fromBlock = 0) {
+    async getAllDepositsFor(address, fromBlock) {
         // Fetch both sent and received in parallel
         const [sent, received] = await Promise.all([
             this.getDepositsSentBy(address, fromBlock),
@@ -209,19 +221,37 @@ class PodBridgeTrackerClient {
     /**
      * Batch check claim status for multiple deposits
      * @param deposits Array of deposits to check
+     * @param fromBlock Starting block to query claims from
      */
-    async updateClaimStatus(deposits) {
+    async updateClaimStatus(deposits, fromBlock) {
+        var _a;
         if (deposits.length === 0) {
             return;
         }
         try {
-            // Get claim events from destination chain
+            const startBlock = (_a = fromBlock !== null && fromBlock !== void 0 ? fromBlock : this.config.pod.deploymentBlock) !== null && _a !== void 0 ? _a : 0;
+            const currentBlock = await this.podProvider.getBlockNumber();
+            const BLOCK_BATCH_SIZE = 10000;
+            const allClaimLogs = [];
+            const allClaimNativeLogs = [];
+            // Get claim events from destination chain in batches
             const claimFilter = this.podBridge.filters.Claim();
             const claimNativeFilter = this.podBridge.filters.ClaimNative();
-            const [claimLogs, claimNativeLogs] = await Promise.all([
-                this.podBridge.queryFilter(claimFilter),
-                this.podBridge.queryFilter(claimNativeFilter)
-            ]);
+            for (let start = startBlock; start <= currentBlock; start += BLOCK_BATCH_SIZE) {
+                const end = Math.min(start + BLOCK_BATCH_SIZE - 1, currentBlock);
+                const [claimLogs, claimNativeLogs] = await Promise.all([
+                    this.podBridge.queryFilter(claimFilter, start, end),
+                    this.podBridge.queryFilter(claimNativeFilter, start, end)
+                ]);
+                allClaimLogs.push(...claimLogs);
+                allClaimNativeLogs.push(...claimNativeLogs);
+                // Add small delay to avoid rate limiting
+                if (start + BLOCK_BATCH_SIZE <= currentBlock) {
+                    await new Promise(resolve => setTimeout(resolve, 100));
+                }
+            }
+            const claimLogs = allClaimLogs;
+            const claimNativeLogs = allClaimNativeLogs;
             // Create a map of claimed request IDs
             const claimedMap = new Map();
             for (const log of [...claimLogs, ...claimNativeLogs]) {

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { PodBridgeActionClient } from './clients/action/client';
+export { PodToBridgedActionClient } from './clients/action/pod-to-bridged-client';
+export { BridgedToPodActionClient } from './clients/action/bridged-to-pod-client';
 export { PodBridgeTrackerClient } from './clients/tracker/client';
 export { POD_BRIDGE_ABI } from './libs/abi/bridge.abi';
 export { PodBridgeConfig, BridgeRequest, BridgeRequestWithType, DepositType, UnsignedTransaction, CertifiedLog, PodAttestation, PodMetadata, PodTransactionReceipt, } from './libs/types/pod-bridge.types';

package/dist/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DepositType = exports.POD_BRIDGE_ABI = exports.PodBridgeTrackerClient = exports.PodBridgeActionClient = void 0;
-var client_1 = require("./clients/action/client");
-Object.defineProperty(exports, "PodBridgeActionClient", { enumerable: true, get: function () { return client_1.PodBridgeActionClient; } });
-var client_2 = require("./clients/tracker/client");
-Object.defineProperty(exports, "PodBridgeTrackerClient", { enumerable: true, get: function () { return client_2.PodBridgeTrackerClient; } });
+exports.DepositType = exports.POD_BRIDGE_ABI = exports.PodBridgeTrackerClient = exports.BridgedToPodActionClient = exports.PodToBridgedActionClient = void 0;
+var pod_to_bridged_client_1 = require("./clients/action/pod-to-bridged-client");
+Object.defineProperty(exports, "PodToBridgedActionClient", { enumerable: true, get: function () { return pod_to_bridged_client_1.PodToBridgedActionClient; } });
+var bridged_to_pod_client_1 = require("./clients/action/bridged-to-pod-client");
+Object.defineProperty(exports, "BridgedToPodActionClient", { enumerable: true, get: function () { return bridged_to_pod_client_1.BridgedToPodActionClient; } });
+var client_1 = require("./clients/tracker/client");
+Object.defineProperty(exports, "PodBridgeTrackerClient", { enumerable: true, get: function () { return client_1.PodBridgeTrackerClient; } });
 var bridge_abi_1 = require("./libs/abi/bridge.abi");
 Object.defineProperty(exports, "POD_BRIDGE_ABI", { enumerable: true, get: function () { return bridge_abi_1.POD_BRIDGE_ABI; } });
 var pod_bridge_types_1 = require("./libs/types/pod-bridge.types");

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

@@ -1,6 +1,7 @@
 export interface PodBridgeChainConfig {
     rpcUrl: string;
     contractAddress: string;
+    deploymentBlock?: number;
 }
 /**
  * Configuration for the bridge
@@ -11,6 +12,14 @@ export interface PodBridgeConfig {
     bridged: PodBridgeChainConfig;
     pod: PodBridgeChainConfig;
 }
+export interface PodBridgeActionsClientConfig {
+    bridged: {
+        contractAddress: string;
+    };
+    pod: {
+        contractAddress: string;
+    };
+}
 export interface BridgeRequest {
     requestId: string;
     blockNumber: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tapforce/pod-bridge-sdk",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "description": "SDK for interacting with Bridges between pod and other chains",
   "keywords": [
     "pod",