@t402/evm

pnpm add @t402/evm

import { ExactEvmScheme, toClientEvmSigner } from '@t402/evm';
import { privateKeyToAccount } from 'viem/accounts';
 
const account = privateKeyToAccount(PRIVATE_KEY);
const signer = toClientEvmSigner(account);
 
const scheme = ExactEvmScheme.client({
  signer,
  network: 'eip155:8453' // Base
});

const scheme = ExactEvmScheme.server({
  rpcUrl: 'https://mainnet.base.org',
  network: 'eip155:8453'
});

const scheme = ExactEvmScheme.facilitator({
  signer: facilitatorSigner,
  rpcUrl: 'https://mainnet.base.org',
  network: 'eip155:8453'
});

import { ExactLegacyEvmClientScheme } from '@t402/evm';
 
const scheme = ExactLegacyEvmClientScheme({
  signer,
  network: 'eip155:1' // Ethereum mainnet
});

import { toClientEvmSigner } from '@t402/evm';
import { privateKeyToAccount } from 'viem/accounts';
 
const account = privateKeyToAccount('0x...');
const signer = toClientEvmSigner(account);

interface ClientEvmSigner {
  address: `0x${string}`;
  signTypedData: (params: SignTypedDataParams) => Promise<`0x${string}`>;
}

import { toFacilitatorEvmSigner } from '@t402/evm';
 
const signer = toFacilitatorEvmSigner(account, walletClient);

import {
  USDT0_ADDRESSES,
  USDC_ADDRESSES,
  USDT_LEGACY_ADDRESSES
} from '@t402/evm';
 
// USDT0 on Base
const usdt0Base = USDT0_ADDRESSES['eip155:8453'];
// 0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee

import { TOKEN_REGISTRY, getTokenConfig } from '@t402/evm';
 
const config = getTokenConfig('eip155:8453', 'USDT0');
// { address: '0x...', decimals: 6, symbol: 'USDT0', supportsEIP3009: true }

import {
  getNetworkTokens,
  getDefaultToken,
  supportsEIP3009,
  getUsdt0Networks
} from '@t402/evm';
 
// Get all tokens on Base
const tokens = getNetworkTokens('eip155:8453');
 
// Get default token for a network
const defaultToken = getDefaultToken('eip155:8453');
 
// Check EIP-3009 support
const hasGasless = supportsEIP3009('eip155:8453', '0x...');
 
// Get networks with USDT0
const networks = getUsdt0Networks(); // ['eip155:8453', 'eip155:42161', ...]

import { createUserOpBuilder } from '@t402/evm';
 
const builder = createUserOpBuilder({
  entryPoint: ENTRYPOINT_V07_ADDRESS,
  chainId: 8453,
  smartAccountAddress: '0x...'
});
 
const userOp = await builder.buildUserOp({
  to: recipientAddress,
  data: transferData,
  value: 0n
});

import { createBundlerClient } from '@t402/evm';
 
const bundler = createBundlerClient({
  url: 'https://bundler.example.com',
  chainId: 8453
});
 
// Get gas estimate
const gas = await bundler.estimateUserOperationGas(userOp);
 
// Send operation
const hash = await bundler.sendUserOperation(userOp);
 
// Wait for receipt
const receipt = await bundler.waitForUserOperationReceipt(hash);

import { createPaymasterClient, PaymasterType } from '@t402/evm';
 
const paymaster = createPaymasterClient({
  url: 'https://paymaster.example.com',
  chainId: 8453,
  type: PaymasterType.VERIFYING
});
 
// Get sponsored operation
const sponsored = await paymaster.sponsorUserOperation(userOp, {
  token: USDT0_ADDRESS
});

import { createGaslessT402Client } from '@t402/evm';
 
const client = createGaslessT402Client({
  smartAccountAddress: '0x...',
  signer: eoaSigner,
  bundlerUrl: 'https://bundler.example.com',
  paymasterUrl: 'https://paymaster.example.com',
  chainId: 8453
});
 
// Make gasless payment
const result = await client.pay({
  to: merchantAddress,
  amount: 1000000n, // 1 USDT0
  token: USDT0_ADDRESS
});

import {
  ENTRYPOINT_V07_ADDRESS,
  ENTRYPOINT_V06_ADDRESS,
  DEFAULT_GAS_LIMITS
} from '@t402/evm';

import { createUsdt0Bridge } from '@t402/evm';
 
const bridge = createUsdt0Bridge(signer, 'eip155:42161'); // From Arbitrum
 
// Get quote
const quote = await bridge.quote({
  toChain: 'eip155:8453', // To Base
  amount: 100000000n,     // 100 USDT0
  recipient: '0x...'
});
 
console.log('Native fee:', quote.nativeFee);
console.log('Estimated time:', quote.estimatedTime);
 
// Execute bridge
const result = await bridge.send({
  toChain: 'eip155:8453',
  amount: 100000000n,
  recipient: '0x...'
});
 
console.log('Tx hash:', result.txHash);
console.log('Message GUID:', result.messageGuid);

import { createLayerZeroScanClient } from '@t402/evm';
 
const scan = createLayerZeroScanClient();
 
// Get message status
const message = await scan.getMessage(messageGuid);
console.log('Status:', message.status); // INFLIGHT, CONFIRMING, DELIVERED
 
// Wait for delivery
const delivered = await scan.waitForDelivery(messageGuid, {
  timeout: 600000,  // 10 minutes
  pollInterval: 5000
});

import { createCrossChainPaymentRouter } from '@t402/evm';
 
const router = createCrossChainPaymentRouter(signer, 'eip155:42161');
 
// Check if routing is possible
if (router.canRoute('eip155:42161', 'eip155:8453')) {
  const result = await router.routePayment({
    toChain: 'eip155:8453',
    amount: 50000000n,
    recipient: '0x...'
  });
}

import {
  LAYERZERO_ENDPOINT_IDS,
  USDT0_OFT_ADDRESSES,
  getBridgeableChains,
  supportsBridging
} from '@t402/evm';
 
// Check bridge support
const canBridge = supportsBridging('eip155:8453'); // true
 
// Get all bridgeable chains
const chains = getBridgeableChains();
// ['eip155:1', 'eip155:42161', 'eip155:8453', ...]

interface ExactEvmPayloadV2 {
  signature: `0x${string}`;
  authorization: {
    from: `0x${string}`;
    to: `0x${string}`;
    value: string;
    validAfter: string;
    validBefore: string;
    nonce: `0x${string}`;
  };
}

interface UserOperation {
  sender: `0x${string}`;
  nonce: bigint;
  initCode: `0x${string}`;
  callData: `0x${string}`;
  callGasLimit: bigint;
  verificationGasLimit: bigint;
  preVerificationGas: bigint;
  maxFeePerGas: bigint;
  maxPriorityFeePerGas: bigint;
  paymasterAndData: `0x${string}`;
  signature: `0x${string}`;
}

interface BridgeResult {
  txHash: `0x${string}`;
  messageGuid: `0x${string}`;
  amountSent: bigint;
  amountToReceive: bigint;
  fromChain: string;
  toChain: string;
  estimatedTime: number;
}