@t402/wdk

pnpm add @t402/wdk @tetherto/wdk @tetherto/wdk-wallet-evm

import WDK from '@tetherto/wdk';
import WalletManagerEvm from '@tetherto/wdk-wallet-evm';
import { T402WDK } from '@t402/wdk';
 
// Register WDK modules (once at app startup)
T402WDK.registerWDK(WDK, WalletManagerEvm);
 
// Create wallet
const seedPhrase = T402WDK.generateSeedPhrase();
const wallet = new T402WDK(seedPhrase, {
  arbitrum: 'https://arb1.arbitrum.io/rpc',
  base: 'https://mainnet.base.org'
});
 
// Initialize
await wallet.initialize();
 
// Get address
const address = await wallet.getAddress('arbitrum');

const wallet = new T402WDK(seedPhrase, chainConfig, options?);

interface T402WDKOptions {
  /** Cache configuration */
  cache?: T402BalanceCacheConfig;
 
  /** Auto-refresh balances */
  autoRefresh?: boolean;
 
  /** Refresh interval (ms) */
  refreshInterval?: number;
}

T402WDK.registerWDK(WDK, WalletManagerEvm);

const seedPhrase = T402WDK.generateSeedPhrase();
// "word1 word2 word3 ... word12"

await wallet.initialize();

const address = await wallet.getAddress('arbitrum');
// '0x...'

const signer = await wallet.getSigner('arbitrum');
 
// Use with T402 HTTP client
const client = createT402HTTPClient({
  signers: [{ scheme: 'exact', signer }]
});

const balance = await wallet.getUsdt0Balance('arbitrum');
// 1000000n (1 USDT0)

const balance = await wallet.getUsdcBalance('base');

const balances = await wallet.getAggregatedBalances();
 
console.log('Total USDT0:', balances.totalUsdt0);
console.log('Total USDC:', balances.totalUsdc);
console.log('By chain:', balances.byChain);
// {
//   arbitrum: { usdt0: 500000n, usdc: 0n },
//   base: { usdt0: 500000n, usdc: 1000000n }
// }

const best = await wallet.findBestChainForPayment(1000000n);
 
if (best) {
  console.log('Chain:', best.chain);   // 'arbitrum'
  console.log('Token:', best.token);   // 'USDT0'
  console.log('Balance:', best.balance); // 5000000n
}

const result = await wallet.bridgeUsdt0({
  fromChain: 'ethereum',
  toChain: 'arbitrum',
  amount: 100000000n // 100 USDT0
});
 
console.log('Tx hash:', result.txHash);
console.log('Message GUID:', result.messageGuid);

import { createWDKSigner } from '@t402/wdk';
 
const signer = createWDKSigner(wdkAccount, chainId);

import { MockWDKSigner } from '@t402/wdk';
 
const mockSigner = new MockWDKSigner('0x...address', 8453);

import { DEFAULT_CHAINS, DEFAULT_RPC_ENDPOINTS } from '@t402/wdk';
 
// Supported chains
// ['ethereum', 'arbitrum', 'base', 'optimism', 'polygon', 'ink', 'berachain', 'unichain']
 
// Default RPC endpoints (use your own for production)
// {
//   ethereum: 'https://eth.llamarpc.com',
//   arbitrum: 'https://arb1.arbitrum.io/rpc',
//   base: 'https://mainnet.base.org',
//   ...
// }

import { USDT0_ADDRESSES, USDC_ADDRESSES, CHAIN_TOKENS } from '@t402/wdk';
 
// USDT0 on Arbitrum
const usdt0 = USDT0_ADDRESSES['arbitrum'];
 
// All tokens available on a chain
const tokens = CHAIN_TOKENS['base'];
// ['USDT0', 'USDC']

import {
  getNetworkFromChain,
  getChainFromNetwork,
  getChainId,
  getUsdt0Chains,
  getPreferredToken
} from '@t402/wdk';
 
// Chain to CAIP-2 network
getNetworkFromChain('arbitrum'); // 'eip155:42161'
 
// CAIP-2 to chain name
getChainFromNetwork('eip155:8453'); // 'base'
 
// Get chain ID
getChainId('arbitrum'); // 42161
 
// Chains with USDT0
getUsdt0Chains(); // ['ethereum', 'arbitrum', 'base', ...]
 
// Get preferred token for chain
getPreferredToken('base'); // 'USDT0'

import { TTLCache } from '@t402/wdk';
 
const cache = new TTLCache<string>({
  ttl: 60000, // 1 minute
  maxSize: 100
});
 
cache.set('key', 'value');
const value = cache.get('key');

import { BalanceCache, DEFAULT_BALANCE_CACHE_CONFIG } from '@t402/wdk';
 
const balanceCache = new BalanceCache(DEFAULT_BALANCE_CACHE_CONFIG);
 
// Cache balance
balanceCache.setBalance('arbitrum', '0x...', 'USDT0', 1000000n);
 
// Get cached balance
const balance = balanceCache.getBalance('arbitrum', '0x...', 'USDT0');
 
// Get stats
const stats = balanceCache.getStats();
console.log('Hit rate:', stats.hitRate);

import {
  WDKError,
  WDKInitializationError,
  ChainError,
  SignerError,
  SigningError,
  BalanceError,
  TransactionError,
  BridgeError,
  RPCError
} from '@t402/wdk';
 
try {
  await wallet.getUsdt0Balance('invalid-chain');
} catch (error) {
  if (error instanceof ChainError) {
    console.log('Chain not supported:', error.chain);
  }
}

import { WDKErrorCode, hasErrorCode } from '@t402/wdk';
 
// WDKErrorCode enum values:
// NOT_INITIALIZED, INVALID_SEED_PHRASE, CHAIN_NOT_CONFIGURED,
// SIGNER_NOT_AVAILABLE, SIGNING_FAILED, BALANCE_FETCH_FAILED,
// TRANSACTION_FAILED, BRIDGE_FAILED, RPC_ERROR
 
if (hasErrorCode(error, WDKErrorCode.BALANCE_FETCH_FAILED)) {
  // Handle balance fetch error
}

import { wrapError, isWDKError, withRetry, withTimeout } from '@t402/wdk';
 
// Wrap unknown errors
const wdkError = wrapError(unknownError, WDKErrorCode.RPC_ERROR);
 
// Check if WDK error
if (isWDKError(error)) {
  console.log('Error code:', error.code);
}
 
// Retry with exponential backoff
const result = await withRetry(
  () => fetchBalance(),
  { maxRetries: 3, initialDelay: 1000 }
);
 
// Timeout wrapper
const result = await withTimeout(
  slowOperation(),
  5000 // 5 second timeout
);

import { WdkBridge } from '@t402/wdk';
 
const bridge = new WdkBridge(wallet, 'arbitrum');
 
// Get quote
const quote = await bridge.quote({
  toChain: 'base',
  amount: 50000000n
});
 
// Execute bridge
const result = await bridge.execute({
  toChain: 'base',
  amount: 50000000n
});

import { createDirectBridge } from '@t402/wdk';
 
const bridge = createDirectBridge(signer, 'arbitrum');

interface T402WDKConfig {
  /** Seed phrase */
  seedPhrase: string;
 
  /** Chain RPC endpoints */
  chains: EvmChainConfig;
 
  /** Optional settings */
  options?: T402WDKOptions;
}

type EvmChainConfig = {
  [chain: string]: string; // chain name -> RPC URL
};
 
// Example
const config: EvmChainConfig = {
  arbitrum: 'https://arb1.arbitrum.io/rpc',
  base: 'https://mainnet.base.org'
};

interface TokenBalance {
  chain: string;
  token: string;
  balance: bigint;
  address: string;
}

interface AggregatedBalance {
  totalUsdt0: bigint;
  totalUsdc: bigint;
  byChain: {
    [chain: string]: {
      usdt0: bigint;
      usdc: bigint;
    };
  };
}

interface BridgeParams {
  fromChain: string;
  toChain: string;
  amount: bigint;
  recipient?: string; // Defaults to same address
}

interface BridgeResult {
  txHash: string;
  messageGuid: string;
  fromChain: string;
  toChain: string;
  amount: bigint;
  estimatedTime: number;
}