@thryx/sdk 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -544,6 +544,15 @@ interface PriceData {
     timestamp: number;
     isStale: boolean;
 }
+/**
+ * Bridge wallet address on Base mainnet
+ * Send ETH to this address on Base to receive ETH on THRYX
+ */
+declare const BRIDGE_WALLET: Address;
+/**
+ * Base USDC contract address
+ */
+declare const BASE_USDC: Address;
 declare const DEFAULT_CONTRACTS: ContractAddresses;
 declare class ThryxSDK {
     readonly publicClient: PublicClient;
@@ -573,9 +582,68 @@ declare class ThryxSDK {
     getAgentCount(): Promise<bigint>;
     getActiveAgents(): Promise<readonly Address[]>;
     isAgentValid(agent: Address): Promise<boolean>;
+    /**
+     * Get a bridge client for Base -> THRYX bridging
+     * @param baseRpcUrl - RPC URL for Base mainnet
+     * @param privateKey - Private key for signing transactions on Base
+     */
+    createBridgeClient(baseRpcUrl?: string, privateKey?: string): BridgeClient;
     private hashPair;
     formatEther(wei: bigint): string;
     parseEther(ether: string): bigint;
 }
+interface BridgeResult {
+    success: boolean;
+    txHash?: Hash;
+    error?: string;
+    amount?: string;
+}
+/**
+ * Bridge client for Base -> THRYX transfers
+ *
+ * @example
+ * ```typescript
+ * const bridge = new BridgeClient('https://mainnet.base.org', '0xprivatekey');
+ *
+ * // Bridge 0.01 ETH from Base to THRYX
+ * const result = await bridge.bridgeETH('0.01');
+ * console.log('Bridge tx:', result.txHash);
+ * ```
+ */
+declare class BridgeClient {
+    readonly publicClient: PublicClient;
+    readonly walletClient: WalletClient | null;
+    readonly account: PrivateKeyAccount | null;
+    constructor(baseRpcUrl?: string, privateKey?: string);
+    get address(): Address | null;
+    /**
+     * Get ETH balance on Base
+     */
+    getBaseBalance(address?: Address): Promise<bigint>;
+    /**
+     * Get USDC balance on Base
+     */
+    getBaseUsdcBalance(address?: Address): Promise<bigint>;
+    /**
+     * Bridge ETH from Base to THRYX
+     * Sends ETH to the bridge wallet on Base, which triggers automatic minting on THRYX
+     *
+     * @param amount - Amount of ETH to bridge (e.g., "0.01")
+     * @returns Bridge result with transaction hash
+     */
+    bridgeETH(amount: string): Promise<BridgeResult>;
+    /**
+     * Bridge USDC from Base to THRYX
+     * Sends USDC to the bridge wallet on Base, which triggers automatic minting on THRYX
+     *
+     * @param amount - Amount of USDC to bridge (e.g., "100" for 100 USDC)
+     * @returns Bridge result with transaction hash
+     */
+    bridgeUSDC(amount: string): Promise<BridgeResult>;
+    /**
+     * Get the bridge wallet address
+     */
+    getBridgeWallet(): Address;
+}
 
-export { AGENT_REGISTRY_ABI, AMM_ABI, BASE_CHAIN, type ContractAddresses, DEFAULT_CONTRACTS, ERC20_ABI, ORACLE_ABI, type PoolState, type PriceData, THRYX_CHAIN, THRYX_TOKEN_ABI, ThryxSDK, type ThryxSDKConfig, WELCOME_BONUS_ABI, ThryxSDK as default };
+export { AGENT_REGISTRY_ABI, AMM_ABI, BASE_CHAIN, BASE_USDC, BRIDGE_WALLET, BridgeClient, type BridgeResult, type ContractAddresses, DEFAULT_CONTRACTS, ERC20_ABI, ORACLE_ABI, type PoolState, type PriceData, THRYX_CHAIN, THRYX_TOKEN_ABI, ThryxSDK, type ThryxSDKConfig, WELCOME_BONUS_ABI, ThryxSDK as default };

package/dist/index.d.ts

@@ -544,6 +544,15 @@ interface PriceData {
     timestamp: number;
     isStale: boolean;
 }
+/**
+ * Bridge wallet address on Base mainnet
+ * Send ETH to this address on Base to receive ETH on THRYX
+ */
+declare const BRIDGE_WALLET: Address;
+/**
+ * Base USDC contract address
+ */
+declare const BASE_USDC: Address;
 declare const DEFAULT_CONTRACTS: ContractAddresses;
 declare class ThryxSDK {
     readonly publicClient: PublicClient;
@@ -573,9 +582,68 @@ declare class ThryxSDK {
     getAgentCount(): Promise<bigint>;
     getActiveAgents(): Promise<readonly Address[]>;
     isAgentValid(agent: Address): Promise<boolean>;
+    /**
+     * Get a bridge client for Base -> THRYX bridging
+     * @param baseRpcUrl - RPC URL for Base mainnet
+     * @param privateKey - Private key for signing transactions on Base
+     */
+    createBridgeClient(baseRpcUrl?: string, privateKey?: string): BridgeClient;
     private hashPair;
     formatEther(wei: bigint): string;
     parseEther(ether: string): bigint;
 }
+interface BridgeResult {
+    success: boolean;
+    txHash?: Hash;
+    error?: string;
+    amount?: string;
+}
+/**
+ * Bridge client for Base -> THRYX transfers
+ *
+ * @example
+ * ```typescript
+ * const bridge = new BridgeClient('https://mainnet.base.org', '0xprivatekey');
+ *
+ * // Bridge 0.01 ETH from Base to THRYX
+ * const result = await bridge.bridgeETH('0.01');
+ * console.log('Bridge tx:', result.txHash);
+ * ```
+ */
+declare class BridgeClient {
+    readonly publicClient: PublicClient;
+    readonly walletClient: WalletClient | null;
+    readonly account: PrivateKeyAccount | null;
+    constructor(baseRpcUrl?: string, privateKey?: string);
+    get address(): Address | null;
+    /**
+     * Get ETH balance on Base
+     */
+    getBaseBalance(address?: Address): Promise<bigint>;
+    /**
+     * Get USDC balance on Base
+     */
+    getBaseUsdcBalance(address?: Address): Promise<bigint>;
+    /**
+     * Bridge ETH from Base to THRYX
+     * Sends ETH to the bridge wallet on Base, which triggers automatic minting on THRYX
+     *
+     * @param amount - Amount of ETH to bridge (e.g., "0.01")
+     * @returns Bridge result with transaction hash
+     */
+    bridgeETH(amount: string): Promise<BridgeResult>;
+    /**
+     * Bridge USDC from Base to THRYX
+     * Sends USDC to the bridge wallet on Base, which triggers automatic minting on THRYX
+     *
+     * @param amount - Amount of USDC to bridge (e.g., "100" for 100 USDC)
+     * @returns Bridge result with transaction hash
+     */
+    bridgeUSDC(amount: string): Promise<BridgeResult>;
+    /**
+     * Get the bridge wallet address
+     */
+    getBridgeWallet(): Address;
+}
 
-export { AGENT_REGISTRY_ABI, AMM_ABI, BASE_CHAIN, type ContractAddresses, DEFAULT_CONTRACTS, ERC20_ABI, ORACLE_ABI, type PoolState, type PriceData, THRYX_CHAIN, THRYX_TOKEN_ABI, ThryxSDK, type ThryxSDKConfig, WELCOME_BONUS_ABI, ThryxSDK as default };
+export { AGENT_REGISTRY_ABI, AMM_ABI, BASE_CHAIN, BASE_USDC, BRIDGE_WALLET, BridgeClient, type BridgeResult, type ContractAddresses, DEFAULT_CONTRACTS, ERC20_ABI, ORACLE_ABI, type PoolState, type PriceData, THRYX_CHAIN, THRYX_TOKEN_ABI, ThryxSDK, type ThryxSDKConfig, WELCOME_BONUS_ABI, ThryxSDK as default };

package/dist/index.js

@@ -23,6 +23,9 @@ __export(index_exports, {
   AGENT_REGISTRY_ABI: () => AGENT_REGISTRY_ABI,
   AMM_ABI: () => AMM_ABI,
   BASE_CHAIN: () => BASE_CHAIN,
+  BASE_USDC: () => BASE_USDC,
+  BRIDGE_WALLET: () => BRIDGE_WALLET,
+  BridgeClient: () => BridgeClient,
   DEFAULT_CONTRACTS: () => DEFAULT_CONTRACTS,
   ERC20_ABI: () => ERC20_ABI,
   ORACLE_ABI: () => ORACLE_ABI,
@@ -125,6 +128,8 @@ var THRYX_TOKEN_ABI = (0, import_viem.parseAbi)([
   "function transfer(address to, uint256 amount) returns (bool)",
   "function approve(address spender, uint256 amount) returns (bool)"
 ]);
+var BRIDGE_WALLET = "0x338304e35841d2Fa6849EF855f6beBD8988C65B8";
+var BASE_USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 var DEFAULT_CONTRACTS = {
   usdc: "0x5f3f1dBD7B74C6B46e8c44f98792A1dAf8d69154",
   weth: "0xb7278A61aa25c888815aFC32Ad3cC52fF24fE575",
@@ -314,6 +319,15 @@ var ThryxSDK = class {
       args: [agent]
     });
   }
+  // ==================== Bridge Operations ====================
+  /**
+   * Get a bridge client for Base -> THRYX bridging
+   * @param baseRpcUrl - RPC URL for Base mainnet
+   * @param privateKey - Private key for signing transactions on Base
+   */
+  createBridgeClient(baseRpcUrl = "https://mainnet.base.org", privateKey) {
+    return new BridgeClient(baseRpcUrl, privateKey);
+  }
   // ==================== Utilities ====================
   hashPair(pair) {
     const encoder = new TextEncoder();
@@ -327,12 +341,142 @@ var ThryxSDK = class {
     return (0, import_viem.parseEther)(ether);
   }
 };
+var BridgeClient = class {
+  constructor(baseRpcUrl = "https://mainnet.base.org", privateKey) {
+    this.publicClient = (0, import_viem.createPublicClient)({
+      chain: BASE_CHAIN,
+      transport: (0, import_viem.http)(baseRpcUrl)
+    });
+    if (privateKey) {
+      this.account = (0, import_accounts.privateKeyToAccount)(privateKey);
+      this.walletClient = (0, import_viem.createWalletClient)({
+        account: this.account,
+        chain: BASE_CHAIN,
+        transport: (0, import_viem.http)(baseRpcUrl)
+      });
+    } else {
+      this.account = null;
+      this.walletClient = null;
+    }
+  }
+  get address() {
+    return this.account?.address || null;
+  }
+  /**
+   * Get ETH balance on Base
+   */
+  async getBaseBalance(address) {
+    const addr = address || this.address;
+    if (!addr) throw new Error("No address provided");
+    return this.publicClient.getBalance({ address: addr });
+  }
+  /**
+   * Get USDC balance on Base
+   */
+  async getBaseUsdcBalance(address) {
+    const addr = address || this.address;
+    if (!addr) throw new Error("No address provided");
+    return this.publicClient.readContract({
+      address: BASE_USDC,
+      abi: ERC20_ABI,
+      functionName: "balanceOf",
+      args: [addr]
+    });
+  }
+  /**
+   * Bridge ETH from Base to THRYX
+   * Sends ETH to the bridge wallet on Base, which triggers automatic minting on THRYX
+   * 
+   * @param amount - Amount of ETH to bridge (e.g., "0.01")
+   * @returns Bridge result with transaction hash
+   */
+  async bridgeETH(amount) {
+    if (!this.walletClient || !this.account) {
+      return { success: false, error: "Wallet not connected - provide privateKey in constructor" };
+    }
+    try {
+      const amountWei = (0, import_viem.parseEther)(amount);
+      const balance = await this.getBaseBalance();
+      if (balance < amountWei) {
+        return {
+          success: false,
+          error: `Insufficient balance. Have ${(0, import_viem.formatEther)(balance)} ETH, need ${amount} ETH`
+        };
+      }
+      const txHash = await this.walletClient.sendTransaction({
+        to: BRIDGE_WALLET,
+        value: amountWei,
+        chain: BASE_CHAIN,
+        account: this.account
+      });
+      return {
+        success: true,
+        txHash,
+        amount
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  /**
+   * Bridge USDC from Base to THRYX
+   * Sends USDC to the bridge wallet on Base, which triggers automatic minting on THRYX
+   * 
+   * @param amount - Amount of USDC to bridge (e.g., "100" for 100 USDC)
+   * @returns Bridge result with transaction hash
+   */
+  async bridgeUSDC(amount) {
+    if (!this.walletClient || !this.account) {
+      return { success: false, error: "Wallet not connected - provide privateKey in constructor" };
+    }
+    try {
+      const amountUnits = BigInt(Math.floor(parseFloat(amount) * 1e6));
+      const balance = await this.getBaseUsdcBalance();
+      if (balance < amountUnits) {
+        return {
+          success: false,
+          error: `Insufficient USDC balance. Have ${Number(balance) / 1e6} USDC, need ${amount} USDC`
+        };
+      }
+      const txHash = await this.walletClient.writeContract({
+        address: BASE_USDC,
+        abi: ERC20_ABI,
+        functionName: "transfer",
+        args: [BRIDGE_WALLET, amountUnits],
+        chain: BASE_CHAIN,
+        account: this.account
+      });
+      return {
+        success: true,
+        txHash,
+        amount
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  /**
+   * Get the bridge wallet address
+   */
+  getBridgeWallet() {
+    return BRIDGE_WALLET;
+  }
+};
 var index_default = ThryxSDK;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AGENT_REGISTRY_ABI,
   AMM_ABI,
   BASE_CHAIN,
+  BASE_USDC,
+  BRIDGE_WALLET,
+  BridgeClient,
   DEFAULT_CONTRACTS,
   ERC20_ABI,
   ORACLE_ABI,

package/dist/index.mjs

@@ -96,6 +96,8 @@ var THRYX_TOKEN_ABI = parseAbi([
   "function transfer(address to, uint256 amount) returns (bool)",
   "function approve(address spender, uint256 amount) returns (bool)"
 ]);
+var BRIDGE_WALLET = "0x338304e35841d2Fa6849EF855f6beBD8988C65B8";
+var BASE_USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 var DEFAULT_CONTRACTS = {
   usdc: "0x5f3f1dBD7B74C6B46e8c44f98792A1dAf8d69154",
   weth: "0xb7278A61aa25c888815aFC32Ad3cC52fF24fE575",
@@ -285,6 +287,15 @@ var ThryxSDK = class {
       args: [agent]
     });
   }
+  // ==================== Bridge Operations ====================
+  /**
+   * Get a bridge client for Base -> THRYX bridging
+   * @param baseRpcUrl - RPC URL for Base mainnet
+   * @param privateKey - Private key for signing transactions on Base
+   */
+  createBridgeClient(baseRpcUrl = "https://mainnet.base.org", privateKey) {
+    return new BridgeClient(baseRpcUrl, privateKey);
+  }
   // ==================== Utilities ====================
   hashPair(pair) {
     const encoder = new TextEncoder();
@@ -298,11 +309,141 @@ var ThryxSDK = class {
     return parseEther(ether);
   }
 };
+var BridgeClient = class {
+  constructor(baseRpcUrl = "https://mainnet.base.org", privateKey) {
+    this.publicClient = createPublicClient({
+      chain: BASE_CHAIN,
+      transport: http(baseRpcUrl)
+    });
+    if (privateKey) {
+      this.account = privateKeyToAccount(privateKey);
+      this.walletClient = createWalletClient({
+        account: this.account,
+        chain: BASE_CHAIN,
+        transport: http(baseRpcUrl)
+      });
+    } else {
+      this.account = null;
+      this.walletClient = null;
+    }
+  }
+  get address() {
+    return this.account?.address || null;
+  }
+  /**
+   * Get ETH balance on Base
+   */
+  async getBaseBalance(address) {
+    const addr = address || this.address;
+    if (!addr) throw new Error("No address provided");
+    return this.publicClient.getBalance({ address: addr });
+  }
+  /**
+   * Get USDC balance on Base
+   */
+  async getBaseUsdcBalance(address) {
+    const addr = address || this.address;
+    if (!addr) throw new Error("No address provided");
+    return this.publicClient.readContract({
+      address: BASE_USDC,
+      abi: ERC20_ABI,
+      functionName: "balanceOf",
+      args: [addr]
+    });
+  }
+  /**
+   * Bridge ETH from Base to THRYX
+   * Sends ETH to the bridge wallet on Base, which triggers automatic minting on THRYX
+   * 
+   * @param amount - Amount of ETH to bridge (e.g., "0.01")
+   * @returns Bridge result with transaction hash
+   */
+  async bridgeETH(amount) {
+    if (!this.walletClient || !this.account) {
+      return { success: false, error: "Wallet not connected - provide privateKey in constructor" };
+    }
+    try {
+      const amountWei = parseEther(amount);
+      const balance = await this.getBaseBalance();
+      if (balance < amountWei) {
+        return {
+          success: false,
+          error: `Insufficient balance. Have ${formatEther(balance)} ETH, need ${amount} ETH`
+        };
+      }
+      const txHash = await this.walletClient.sendTransaction({
+        to: BRIDGE_WALLET,
+        value: amountWei,
+        chain: BASE_CHAIN,
+        account: this.account
+      });
+      return {
+        success: true,
+        txHash,
+        amount
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  /**
+   * Bridge USDC from Base to THRYX
+   * Sends USDC to the bridge wallet on Base, which triggers automatic minting on THRYX
+   * 
+   * @param amount - Amount of USDC to bridge (e.g., "100" for 100 USDC)
+   * @returns Bridge result with transaction hash
+   */
+  async bridgeUSDC(amount) {
+    if (!this.walletClient || !this.account) {
+      return { success: false, error: "Wallet not connected - provide privateKey in constructor" };
+    }
+    try {
+      const amountUnits = BigInt(Math.floor(parseFloat(amount) * 1e6));
+      const balance = await this.getBaseUsdcBalance();
+      if (balance < amountUnits) {
+        return {
+          success: false,
+          error: `Insufficient USDC balance. Have ${Number(balance) / 1e6} USDC, need ${amount} USDC`
+        };
+      }
+      const txHash = await this.walletClient.writeContract({
+        address: BASE_USDC,
+        abi: ERC20_ABI,
+        functionName: "transfer",
+        args: [BRIDGE_WALLET, amountUnits],
+        chain: BASE_CHAIN,
+        account: this.account
+      });
+      return {
+        success: true,
+        txHash,
+        amount
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  /**
+   * Get the bridge wallet address
+   */
+  getBridgeWallet() {
+    return BRIDGE_WALLET;
+  }
+};
 var index_default = ThryxSDK;
 export {
   AGENT_REGISTRY_ABI,
   AMM_ABI,
   BASE_CHAIN,
+  BASE_USDC,
+  BRIDGE_WALLET,
+  BridgeClient,
   DEFAULT_CONTRACTS,
   ERC20_ABI,
   ORACLE_ABI,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thryx/sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TypeScript SDK for THRYX - AI-Native Blockchain (Chain ID: 77777)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/index.ts

@@ -170,6 +170,19 @@ export interface PriceData {
   isStale: boolean;
 }
 
+// ==================== Bridge Configuration ====================
+
+/**
+ * Bridge wallet address on Base mainnet
+ * Send ETH to this address on Base to receive ETH on THRYX
+ */
+export const BRIDGE_WALLET: Address = '0x338304e35841d2Fa6849EF855f6beBD8988C65B8';
+
+/**
+ * Base USDC contract address
+ */
+export const BASE_USDC: Address = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+
 // ==================== Default Contract Addresses ====================
 
 export const DEFAULT_CONTRACTS: ContractAddresses = {
@@ -415,6 +428,17 @@ export class ThryxSDK {
     });
   }
 
+  // ==================== Bridge Operations ====================
+
+  /**
+   * Get a bridge client for Base -> THRYX bridging
+   * @param baseRpcUrl - RPC URL for Base mainnet
+   * @param privateKey - Private key for signing transactions on Base
+   */
+  createBridgeClient(baseRpcUrl: string = 'https://mainnet.base.org', privateKey?: string): BridgeClient {
+    return new BridgeClient(baseRpcUrl, privateKey);
+  }
+
   // ==================== Utilities ====================
 
   private hashPair(pair: string): `0x${string}` {
@@ -434,6 +458,181 @@ export class ThryxSDK {
   }
 }
 
+// ==================== Bridge Client ====================
+
+export interface BridgeResult {
+  success: boolean;
+  txHash?: Hash;
+  error?: string;
+  amount?: string;
+}
+
+/**
+ * Bridge client for Base -> THRYX transfers
+ * 
+ * @example
+ * ```typescript
+ * const bridge = new BridgeClient('https://mainnet.base.org', '0xprivatekey');
+ * 
+ * // Bridge 0.01 ETH from Base to THRYX
+ * const result = await bridge.bridgeETH('0.01');
+ * console.log('Bridge tx:', result.txHash);
+ * ```
+ */
+export class BridgeClient {
+  public readonly publicClient: PublicClient;
+  public readonly walletClient: WalletClient | null;
+  public readonly account: PrivateKeyAccount | null;
+
+  constructor(baseRpcUrl: string = 'https://mainnet.base.org', privateKey?: string) {
+    // Create public client for Base
+    this.publicClient = createPublicClient({
+      chain: BASE_CHAIN,
+      transport: http(baseRpcUrl),
+    });
+
+    // Create wallet client if private key provided
+    if (privateKey) {
+      this.account = privateKeyToAccount(privateKey as `0x${string}`);
+      this.walletClient = createWalletClient({
+        account: this.account,
+        chain: BASE_CHAIN,
+        transport: http(baseRpcUrl),
+      });
+    } else {
+      this.account = null;
+      this.walletClient = null;
+    }
+  }
+
+  get address(): Address | null {
+    return this.account?.address || null;
+  }
+
+  /**
+   * Get ETH balance on Base
+   */
+  async getBaseBalance(address?: Address): Promise<bigint> {
+    const addr = address || this.address;
+    if (!addr) throw new Error('No address provided');
+    return this.publicClient.getBalance({ address: addr });
+  }
+
+  /**
+   * Get USDC balance on Base
+   */
+  async getBaseUsdcBalance(address?: Address): Promise<bigint> {
+    const addr = address || this.address;
+    if (!addr) throw new Error('No address provided');
+
+    return this.publicClient.readContract({
+      address: BASE_USDC,
+      abi: ERC20_ABI,
+      functionName: 'balanceOf',
+      args: [addr],
+    });
+  }
+
+  /**
+   * Bridge ETH from Base to THRYX
+   * Sends ETH to the bridge wallet on Base, which triggers automatic minting on THRYX
+   * 
+   * @param amount - Amount of ETH to bridge (e.g., "0.01")
+   * @returns Bridge result with transaction hash
+   */
+  async bridgeETH(amount: string): Promise<BridgeResult> {
+    if (!this.walletClient || !this.account) {
+      return { success: false, error: 'Wallet not connected - provide privateKey in constructor' };
+    }
+
+    try {
+      const amountWei = parseEther(amount);
+      
+      // Check balance
+      const balance = await this.getBaseBalance();
+      if (balance < amountWei) {
+        return { 
+          success: false, 
+          error: `Insufficient balance. Have ${formatEther(balance)} ETH, need ${amount} ETH` 
+        };
+      }
+
+      // Send to bridge wallet
+      const txHash = await this.walletClient.sendTransaction({
+        to: BRIDGE_WALLET,
+        value: amountWei,
+        chain: BASE_CHAIN,
+        account: this.account,
+      });
+
+      return {
+        success: true,
+        txHash,
+        amount,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+      };
+    }
+  }
+
+  /**
+   * Bridge USDC from Base to THRYX
+   * Sends USDC to the bridge wallet on Base, which triggers automatic minting on THRYX
+   * 
+   * @param amount - Amount of USDC to bridge (e.g., "100" for 100 USDC)
+   * @returns Bridge result with transaction hash
+   */
+  async bridgeUSDC(amount: string): Promise<BridgeResult> {
+    if (!this.walletClient || !this.account) {
+      return { success: false, error: 'Wallet not connected - provide privateKey in constructor' };
+    }
+
+    try {
+      const amountUnits = BigInt(Math.floor(parseFloat(amount) * 1e6)); // USDC has 6 decimals
+      
+      // Check balance
+      const balance = await this.getBaseUsdcBalance();
+      if (balance < amountUnits) {
+        return { 
+          success: false, 
+          error: `Insufficient USDC balance. Have ${Number(balance) / 1e6} USDC, need ${amount} USDC` 
+        };
+      }
+
+      // Transfer USDC to bridge wallet
+      const txHash = await this.walletClient.writeContract({
+        address: BASE_USDC,
+        abi: ERC20_ABI,
+        functionName: 'transfer',
+        args: [BRIDGE_WALLET, amountUnits],
+        chain: BASE_CHAIN,
+        account: this.account,
+      });
+
+      return {
+        success: true,
+        txHash,
+        amount,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+      };
+    }
+  }
+
+  /**
+   * Get the bridge wallet address
+   */
+  getBridgeWallet(): Address {
+    return BRIDGE_WALLET;
+  }
+}
+
 // ==================== Exports ====================
 
 export default ThryxSDK;