feat: bridge adapter

src/lxly/bridge/abi/bridge-adapter.ts

@@ -0,0 +1,20 @@
+/**
+ * Bridge Adapter ABI
+ *
+ * Polygon ZkEVM Bridge Adapter contract ABI for custom ERC20 bridging
+ */
+
+export const bridgeAdapterAbi = [
+  {
+    inputs: [
+      { internalType: 'address', name: 'recipient', type: 'address' },
+      { internalType: 'uint256', name: 'amount', type: 'uint256' },
+      { internalType: 'uint32', name: 'destinationNetworkId', type: 'uint32' },
+      { internalType: 'bool', name: 'forceUpdateGlobalExitRoot', type: 'bool' },
+    ],
+    name: 'bridgeToken',
+    outputs: [],
+    stateMutability: 'nonpayable',
+    type: 'function',
+  },
+] as const;

src/lxly/bridge/abi/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Bridge ABI Exports
+ *
+ * Central export point for all bridge-related ABIs
+ */
+
+export { bridgeAbi } from './bridge';
+export { bridgeAdapterAbi } from './bridge-adapter';

src/lxly/bridge/bridge-adapter.ts

@@ -0,0 +1,61 @@
+/**
+ * Bridge Adapter Implementation
+ *
+ * Custom ERC20 bridging functionality using bridge adapter contract
+ */
+
+import { encodeFunctionData, type Address } from 'viem';
+import { ValidationUtils } from '../utils';
+import { BaseContract } from '../base/contract';
+import type { BridgeTokenParams, TransactionParams } from '../../types';
+import { bridgeAdapterAbi } from './abi/bridge-adapter';
+
+export interface BridgeAdapterConfig {
+  bridgeAdapterAddress: string;
+  rpcUrl: string;
+  chainId: number;
+}
+
+export class BridgeAdapter extends BaseContract {
+  private bridgeAdapterAddress: string;
+
+  constructor(config: BridgeAdapterConfig) {
+    super({ rpcUrl: config.rpcUrl, chainId: config.chainId });
+    this.bridgeAdapterAddress = config.bridgeAdapterAddress;
+  }
+
+  /**
+   * Build bridge token transaction for custom ERC20
+   */
+  async buildBridgeToken(
+    params: BridgeTokenParams,
+    from?: string
+  ): Promise<TransactionParams> {
+    ValidationUtils.validateAddress(params.recipient, 'Recipient address');
+    ValidationUtils.validateAmount(params.amount, 'Amount');
+
+    const data = encodeFunctionData({
+      abi: bridgeAdapterAbi,
+      functionName: 'bridgeToken',
+      args: [
+        params.recipient as Address,
+        BigInt(params.amount),
+        params.destinationNetworkId,
+        params.forceUpdateGlobalExitRoot,
+      ],
+    });
+
+    const [nonce, gas] = await Promise.all([
+      this.getNonce(from),
+      this.estimateGas(data, this.bridgeAdapterAddress, from),
+    ]);
+
+    return {
+      from,
+      to: this.bridgeAdapterAddress,
+      data,
+      gas,
+      nonce,
+    };
+  }
+}

src/lxly/bridge/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Bridge Exports
+ *
+ * Central export point for all bridge-related functionality
+ */
+
+export { Bridge } from './bridge';
+export { BridgeAdapter } from './bridge-adapter';
+export { BridgeUtil } from './util';

src/lxly/index.ts

@@ -16,6 +16,7 @@ export interface LxlyConfig {
 
 export { ERC20 } from './tokens/erc20';
 export { Bridge } from './bridge/bridge';
+export { BridgeAdapter } from './bridge/bridge-adapter';
 export { BridgeUtil } from './bridge/util';
 
 export class LxlyClient {

src/lxly/tokens/erc20.ts

@@ -19,6 +19,7 @@ import {
   buildTransferFrom as buildTransferFromTx,
 } from './build';
 import { Bridge } from '../bridge/bridge';
+import { BridgeAdapter } from '../bridge/bridge-adapter';
 import { chainRegistry } from '../../chains/registry';
 import { getAbi } from '../services/abi';
 
@@ -174,6 +175,41 @@ export class ERC20 extends BaseContract {
     );
   }
 
+  /**
+   * Bridge custom ERC20 token to another network using bridge adapter
+   */
+  async bridgeToken(
+    recipient: string,
+    amount: string,
+    destinationNetworkId: number,
+    bridgeAdapterAddress: string,
+    forceUpdateGlobalExitRoot = true,
+    from?: string
+  ): Promise<TransactionParams> {
+    ValidationUtils.validateAddress(recipient, 'Recipient address');
+    ValidationUtils.validateAmount(amount, 'Amount');
+    ValidationUtils.validateAddress(
+      bridgeAdapterAddress,
+      'Bridge adapter address'
+    );
+
+    const bridgeAdapter = new BridgeAdapter({
+      bridgeAdapterAddress,
+      rpcUrl: this.config.rpcUrl,
+      chainId: this.config.chainId,
+    });
+
+    return bridgeAdapter.buildBridgeToken(
+      {
+        recipient,
+        amount,
+        destinationNetworkId,
+        forceUpdateGlobalExitRoot,
+      },
+      from
+    );
+  }
+
   /**
    * Get wrapped version of this token on destination network
    */

src/types/bridge.ts

@@ -13,6 +13,13 @@ export interface BridgeAssetParams {
   permitData?: string;
 }
 
+export interface BridgeTokenParams {
+  recipient: string;
+  amount: string;
+  destinationNetworkId: number;
+  forceUpdateGlobalExitRoot: boolean;
+}
+
 export interface BridgeOptions {
   forceUpdateGlobalExitRoot?: boolean;
   permitData?: string;