@tapforce/pod-bridge-sdk 2.0.1 → 2.1.1

package/README.md

@@ -17,7 +17,7 @@ Pod -> ETH: Deposit on Pod, claim on ETH with proof from pod_getBridgeClaimProof
 
 ## Features
 
-- **Bridge Deposits**: Deposit ERC20 or native tokens to the bridge
+- **Bridge Deposits**: Deposit ERC20 or native tokens to the bridge (with optional CLOB integration)
 - **Claim with Proof**: Claim on ETH using `pod_getBridgeClaimProof` RPC
 - **Track Bridge Requests**: Query deposits sent/received by any address
 - **Claim Status Tracking**: Monitor claim status and finality
@@ -92,7 +92,7 @@ Deposits on ETH are automatically claimed on Pod after block finalization.
 ```typescript
 const client = new SourceChainToPodActionClient(actionConfig);
 
-// Create deposit transaction (with optional permit for gasless approval)
+// Simple deposit (bridge only)
 const depositTx = client.deposit({
   token: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC on ETH
   amount: ethers.parseUnits('1', 6),  // 1 USDC (use ETH-side decimals)
@@ -101,6 +101,16 @@ const depositTx = client.deposit({
   // permit: '0x...' // Optional: ERC20 permit bytes
 });
 
+// CLOB deposit — bridge and deposit to orderbook in one TX:
+// const clobTx = client.deposit({
+//   token: '0xdAC17F958D2ee523a2206206994597C13D831ec7', // USDT on ETH
+//   amount: ethers.parseUnits('1', 6),
+//   destinationWalletAddress: '0x...',
+//   callContract: '0x000000000000000000000000000000000000C10B', // CLOB orderbook
+//   reserveBalance: ethers.parseUnits('0.5', 6), // Keep 0.5, forward 0.5 to CLOB
+//   from: '0x...',
+// });
+
 // Don't forget to approve the bridge contract first for ERC20 tokens
 const tx = await signer.sendTransaction(depositTx);
 const receipt = await tx.wait();
@@ -192,8 +202,10 @@ deposit(args: {
   token: string;
   amount: string | bigint;
   destinationWalletAddress: string;
+  callContract?: string;           // Contract to call on Pod after deposit (default: address(0))
+  reserveBalance?: string | bigint; // Amount to reserve when using callContract (default: 0)
   from?: string;
-  permit?: string;          // Optional ERC20 permit bytes (default: '0x')
+  permit?: string;                 // Optional ERC20 permit bytes (default: '0x')
 }): UnsignedTransaction
 ```
 
@@ -204,9 +216,12 @@ For Pod -> ETH deposits and claims.
 ```typescript
 // Deposit tokens on Pod
 deposit(args: {
-  token: string;            // Use 0xEeee...EEeE for native token
-  amount: string | bigint;  // Use ETH-side decimals
+  token: string;                    // Use 0xEeee...EEeE for native token
+  amount: string | bigint;          // Use ETH-side decimals
   destinationWalletAddress: string;
+  callContract?: string;            // Contract to call after deposit (default: address(0))
+  reserveBalance?: string | bigint; // Amount to reserve when using callContract (default: 0)
+  permit?: string;                  // Optional permit bytes (default: '0x')
   from?: string;
 }): UnsignedTransaction
 
@@ -267,6 +282,8 @@ interface BridgeRequest {
     destination: string;
     token: string;
     amount: string;
+    callContract?: string;   // Contract called after deposit (address(0) for simple bridge)
+    reserveBalance?: string; // Amount reserved when using callContract ('0' for simple bridge)
     chainId: number;
     blockNumber: number;
     timestamp: number;       // Unix timestamp (seconds)
@@ -288,23 +305,23 @@ interface BridgeRequest {
 
 ## Events
 
-The bridge contracts emit different events per chain:
+The bridge contracts emit different events per chain (id type differs):
 
 ```solidity
 // ETH (Source Chain)
-event Deposit(uint256 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, address callContract, uint256 reserveBalance);
 event Claim(bytes32 indexed txHash, address token, address mirrorToken, uint256 amount, address indexed to);
 
 // Pod
-event Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount);
+event Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount, address callContract, uint256 reserveBalance);
 ```
 
 ## ABIs
 
 The SDK exports separate ABIs for each chain:
 
-- `SOURCE_CHAIN_BRIDGE_ABI` - ETH bridge (deposit with permit, claim with proof)
-- `POD_BRIDGE_ABI` - Pod bridge (3-param deposit)
+- `SOURCE_CHAIN_BRIDGE_ABI` - ETH bridge (6-param deposit with callContract/reserveBalance/permit, claim with proof)
+- `POD_BRIDGE_ABI` - Pod bridge (6-param deposit, bytes32 id events)
 - `BRIDGE_ABI` - Alias for `SOURCE_CHAIN_BRIDGE_ABI`
 
 ## Pod-specific Notes

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

@@ -30,6 +30,9 @@ export declare class PodToSourceChainActionClient {
      * @param args.token Token address on Pod to deposit (use 0xEeee...EEeE for native)
      * @param args.amount Amount to deposit (in ETH-side decimals)
      * @param args.destinationWalletAddress Recipient address on ETH
+     * @param args.callContract Optional: contract to call after deposit (default: address(0) for simple bridge)
+     * @param args.reserveBalance Optional: amount to keep as reserve when using callContract (default: 0)
+     * @param args.permit Optional permit bytes (default '0x')
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded deposit call
      */
@@ -37,6 +40,9 @@ export declare class PodToSourceChainActionClient {
         token: string;
         amount: string | bigint;
         destinationWalletAddress: string;
+        callContract?: string;
+        reserveBalance?: string | bigint;
+        permit?: string;
         from?: string;
     }): UnsignedTransaction;
     /**

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

@@ -35,6 +35,9 @@ class PodToSourceChainActionClient {
      * @param args.token Token address on Pod to deposit (use 0xEeee...EEeE for native)
      * @param args.amount Amount to deposit (in ETH-side decimals)
      * @param args.destinationWalletAddress Recipient address on ETH
+     * @param args.callContract Optional: contract to call after deposit (default: address(0) for simple bridge)
+     * @param args.reserveBalance Optional: amount to keep as reserve when using callContract (default: 0)
+     * @param args.permit Optional permit bytes (default '0x')
      * @param args.from Optional sender address
      * @returns Unsigned transaction template with encoded deposit call
      */
@@ -42,7 +45,10 @@ class PodToSourceChainActionClient {
         const data = this.podIface.encodeFunctionData('deposit', [
             args.token,
             args.amount,
-            args.destinationWalletAddress
+            args.destinationWalletAddress,
+            args.callContract ?? ethers_1.ZeroAddress,
+            args.reserveBalance ?? 0,
+            args.permit ?? '0x',
         ]);
         return {
             to: this.config.pod.contractAddress,

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

@@ -24,6 +24,10 @@ export declare class SourceChainToPodActionClient {
      * @param args.token Token address on source chain (ETH) to deposit
      * @param args.amount Amount to deposit (in token's smallest unit)
      * @param args.destinationWalletAddress Recipient address on Pod
+     * @param args.callContract Optional: contract to call on Pod after deposit (default: address(0) for simple bridge)
+     * @param args.reserveBalance Optional: amount to keep as reserve when using callContract (default: 0).
+     *   When callContract is address(0), reserveBalance MUST be 0.
+     *   When callContract is set, amount must exceed reserveBalance; contract must be whitelisted.
      * @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
@@ -32,6 +36,8 @@ export declare class SourceChainToPodActionClient {
         token: string;
         amount: string | bigint;
         destinationWalletAddress: string;
+        callContract?: string;
+        reserveBalance?: string | bigint;
         permit?: string;
         from?: string;
     }): UnsignedTransaction;

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

@@ -29,6 +29,10 @@ class SourceChainToPodActionClient {
      * @param args.token Token address on source chain (ETH) to deposit
      * @param args.amount Amount to deposit (in token's smallest unit)
      * @param args.destinationWalletAddress Recipient address on Pod
+     * @param args.callContract Optional: contract to call on Pod after deposit (default: address(0) for simple bridge)
+     * @param args.reserveBalance Optional: amount to keep as reserve when using callContract (default: 0).
+     *   When callContract is address(0), reserveBalance MUST be 0.
+     *   When callContract is set, amount must exceed reserveBalance; contract must be whitelisted.
      * @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
@@ -38,6 +42,8 @@ class SourceChainToPodActionClient {
             args.token,
             args.amount,
             args.destinationWalletAddress,
+            args.callContract ?? ethers_1.ZeroAddress,
+            args.reserveBalance ?? 0,
             args.permit ?? '0x',
         ]);
         return {

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

@@ -12,6 +12,8 @@ export declare class PodTrackerService {
     private readonly config;
     private readonly provider;
     private readonly iface;
+    /** Interface with uint256 id variant — Pod system contract may emit either bytes32 or uint256 id */
+    private readonly ifaceUint256Id;
     private chainId;
     constructor(config: PodBridgeChainConfig);
     private initChainId;
@@ -27,6 +29,9 @@ export declare class PodTrackerService {
     /**
      * Fetch deposits from POD using raw eth_getLogs RPC.
      * Pod returns logs with blockNumber: null, so we can't use ethers queryFilter.
+     *
+     * Queries both bytes32 and uint256 id event topics since Pod system contract
+     * may emit either variant.
      */
     private getDeposits;
 }

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

@@ -19,6 +19,7 @@ class PodTrackerService {
         this.chainId = null;
         this.provider = config.provider;
         this.iface = new ethers_1.Interface(bridge_abi_1.POD_BRIDGE_ABI);
+        this.ifaceUint256Id = new ethers_1.Interface(bridge_abi_1.SOURCE_CHAIN_BRIDGE_ABI);
         this.initChainId();
     }
     async initChainId() {
@@ -54,13 +55,20 @@ class PodTrackerService {
     /**
      * Fetch deposits from POD using raw eth_getLogs RPC.
      * Pod returns logs with blockNumber: null, so we can't use ethers queryFilter.
+     *
+     * Queries both bytes32 and uint256 id event topics since Pod system contract
+     * may emit either variant.
      */
     async getDeposits(topicFilters) {
         const deposits = [];
-        // Deposit event topic
-        const depositEventTopic = this.iface.getEvent('Deposit').topicHash;
-        // Build topics array: [eventSig, ...filters]
-        const topics = [depositEventTopic, ...topicFilters];
+        // Pod may emit Deposit with bytes32 id or uint256 id — query both topics
+        const bytes32IdTopic = this.iface.getEvent('Deposit').topicHash;
+        const uint256IdTopic = this.ifaceUint256Id.getEvent('Deposit').topicHash;
+        // Use array in first topic position for OR matching (standard EVM eth_getLogs)
+        const topics = [
+            [bytes32IdTopic, uint256IdTopic],
+            ...topicFilters,
+        ];
         // Use raw RPC to avoid ethers.js blockNumber validation
         const rpcProvider = this.provider;
         const rawLogs = await rpcProvider.send('eth_getLogs', [{
@@ -76,7 +84,10 @@ class PodTrackerService {
         for (let i = 0; i < rawLogs.length; i++) {
             const log = rawLogs[i];
             const receipt = receipts[i];
-            const parsed = this.iface.parseLog({
+            // Parse with the matching interface based on which topic was emitted
+            const isUint256Id = log.topics[0] === uint256IdTopic;
+            const parseIface = isUint256Id ? this.ifaceUint256Id : this.iface;
+            const parsed = parseIface.parseLog({
                 topics: log.topics,
                 data: log.data
             });
@@ -92,6 +103,8 @@ class PodTrackerService {
                         destination: parsed.args.to,
                         token: parsed.args.token,
                         amount: parsed.args.amount.toString(),
+                        callContract: parsed.args.callContract,
+                        reserveBalance: parsed.args.reserveBalance.toString(),
                         chainId: this.chainId,
                         blockNumber: timestamp,
                         timestamp,

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

@@ -56,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(uint256 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, address callContract, uint256 reserveBalance)
             const depositFilter = this.bridge.filters.Deposit(...options.depositEventFilter);
             const depositLogs = await this.bridge.queryFilter(depositFilter, start, end);
             if (start + BLOCK_BATCH_SIZE <= currentBlock) {
@@ -80,6 +80,8 @@ class SourceChainTrackerService {
                             destination: parsed.args.to,
                             token: parsed.args.token,
                             amount: parsed.args.amount.toString(),
+                            callContract: parsed.args.callContract,
+                            reserveBalance: parsed.args.reserveBalance.toString(),
                             chainId: this.chainId,
                             blockNumber: log.blockNumber,
                             timestamp: block ? Number(block.timestamp) : 0

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

@@ -1,18 +1,17 @@
 /**
  * ABI for Bridge contract on Source Chain (ETH/Mainnet)
  *
- * ETH -> Pod: deposit on ETH (4-param with permit), auto-claim on Pod
+ * ETH -> Pod: deposit on ETH (6-param with callContract, reserveBalance, 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...)
+ * New deposit params (callContract, reserveBalance) enable depositing to CLOB orderbook in one TX.
+ * For simple bridge deposits: callContract=address(0), reserveBalance=0.
  */
 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).
+ * Same 6-param deposit as source chain.
  */
 export declare const POD_BRIDGE_ABI: string[];
 export declare const BRIDGE_ABI: string[];

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

@@ -4,19 +4,18 @@ exports.BRIDGE_ABI = exports.POD_BRIDGE_ABI = exports.SOURCE_CHAIN_BRIDGE_ABI =
 /**
  * ABI for Bridge contract on Source Chain (ETH/Mainnet)
  *
- * ETH -> Pod: deposit on ETH (4-param with permit), auto-claim on Pod
+ * ETH -> Pod: deposit on ETH (6-param with callContract, reserveBalance, 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...)
+ * New deposit params (callContract, reserveBalance) enable depositing to CLOB orderbook in one TX.
+ * For simple bridge deposits: callContract=address(0), reserveBalance=0.
  */
 exports.SOURCE_CHAIN_BRIDGE_ABI = [
     // Events
-    "event Deposit(uint256 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, address callContract, uint256 reserveBalance)",
     "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)",
+    // Deposit function (6-param: token, amount, to, callContract, reserveBalance, permit)
+    "function deposit(address token, uint256 amount, address to, address callContract, uint256 reserveBalance, 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
@@ -27,13 +26,13 @@ exports.SOURCE_CHAIN_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).
+ * Same 6-param deposit as source chain.
  */
 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)",
+    "event Deposit(bytes32 indexed id, address indexed from, address indexed to, address token, uint256 amount, address callContract, uint256 reserveBalance)",
+    // Deposit function (6-param, same as source chain)
+    "function deposit(address token, uint256 amount, address to, address callContract, uint256 reserveBalance, bytes permit) returns (uint256)",
 ];
 // Backward compatibility alias
 exports.BRIDGE_ABI = exports.SOURCE_CHAIN_BRIDGE_ABI;

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

@@ -34,6 +34,8 @@ export interface BridgeRequest {
         destination: string;
         token: string;
         amount: string;
+        callContract?: string;
+        reserveBalance?: string;
         chainId: number;
         blockNumber: number;
         timestamp: number;

package/package.json

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