@t402/wdk-bridge

pnpm add @t402/wdk-bridge

import { WdkBridgeClient } from '@t402/wdk-bridge'
 
// Create bridge client with WDK accounts
const bridge = new WdkBridgeClient({
  accounts: {
    ethereum: ethereumWdkAccount,
    arbitrum: arbitrumWdkAccount,
    ink: inkWdkAccount
  },
  defaultStrategy: 'cheapest'
})
 
// Get multi-chain balances
const summary = await bridge.getBalances()
console.log('Total USDT0:', summary.totalUsdt0)
console.log('Bridgeable chains:', summary.bridgeableChains)
 
// Auto-bridge to Ethereum
const result = await bridge.autoBridge({
  toChain: 'ethereum',
  amount: 100_000000n, // 100 USDT0
  recipient: '0x...'
})
 
console.log('Bridge TX:', result.txHash)
console.log('From chain:', result.fromChain)
console.log('Message GUID:', result.messageGuid)
 
// Wait for delivery
const delivery = await result.waitForDelivery({
  onStatusChange: (status) => console.log('Status:', status)
})
 
console.log('Delivered!', delivery.dstTxHash)

const routes = await bridge.getRoutes('ethereum', 100_000000n)
 
routes.forEach(route => {
  console.log(`${route.fromChain} -> ${route.toChain}`)
  console.log(`  Fee: ${route.nativeFee} wei`)
  console.log(`  Time: ~${route.estimatedTime / 60} minutes`)
  console.log(`  Available: ${route.available}`)
  if (!route.available) {
    console.log(`  Reason: ${route.unavailableReason}`)
  }
})

// Use fastest route
const bridge = new WdkBridgeClient({
  accounts: { ... },
  defaultStrategy: 'fastest'
})
 
// Or specify per-request
const result = await bridge.autoBridge({
  toChain: 'ethereum',
  amount: 100_000000n,
  recipient: '0x...',
  preferredSourceChain: 'arbitrum' // Use 'preferred' strategy
})

const result = await bridge.bridge({
  fromChain: 'arbitrum',
  toChain: 'ethereum',
  amount: 50_000000n, // 50 USDT0
  recipient: '0x...',
  slippageTolerance: 0.3 // 0.3%
})

// Get message status
const message = await bridge.trackMessage(messageGuid)
console.log('Status:', message.status)
// INFLIGHT -> CONFIRMING -> DELIVERED
 
// Wait for delivery
const delivered = await bridge.waitForDelivery(messageGuid, {
  timeout: 600000, // 10 minutes
  pollInterval: 10000, // 10 seconds
  onStatusChange: (status) => console.log('Status:', status)
})

interface WdkBridgeClient {
  // Configuration
  getConfiguredChains(): string[]
  hasChain(chain: string): boolean
  setRpcUrl(chain: string, url: string): void
 
  // Balances
  getChainBalance(chain: string): Promise<ChainBalance>
  getBalances(): Promise<BalanceSummary>
 
  // Routing
  getRoutes(toChain: string, amount: bigint): Promise<BridgeRoute[]>
 
  // Bridging
  autoBridge(params: AutoBridgeParams): Promise<WdkBridgeResult>
  bridge(params: BridgeParams): Promise<WdkBridgeResult>
 
  // Tracking
  trackMessage(guid: string): Promise<LayerZeroMessage>
  waitForDelivery(guid: string, options?: WaitOptions): Promise<LayerZeroMessage>
}
 
interface AutoBridgeParams {
  toChain: string
  amount: bigint
  recipient: Address
  preferredSourceChain?: string
  slippageTolerance?: number
}
 
interface WdkBridgeResult {
  txHash: Hex
  messageGuid: Hex
  amountSent: bigint
  amountToReceive: bigint
  fromChain: string
  toChain: string
  estimatedTime: number
  waitForDelivery(options?: WaitOptions): Promise<DeliveryResult>
}
 
interface BalanceSummary {
  balances: ChainBalance[]
  totalUsdt0: bigint
  chainsWithBalance: string[]
  bridgeableChains: string[]
}