@x402x/facilitator-sdk 2.0.0

package/README.md

@@ -0,0 +1,307 @@
+# @x402x/facilitator-sdk
+
+SchemeNetworkFacilitator SDK for x402x - enables router settlement with official x402 protocol.
+
+## Overview
+
+This package provides a complete implementation of the `SchemeNetworkFacilitator` interface that enables atomic settlement using SettlementRouter contracts. It supports:
+
+- **Atomic Settlement**: Single transaction completes verification, transfer, and hook execution
+- **Multi-Party Support**: Facilitator fees and merchant payments in one atomic operation
+- **Hook Integration**: Extensible business logic execution during settlement
+- **v2 Compatibility**: Uses official `@x402/*` v2 packages only
+- **Type Safety**: Full TypeScript support with comprehensive validation
+
+## Features
+
+- ✅ Implements `SchemeNetworkFacilitator` interface from `@x402/core`
+- ✅ SettlementRouter contract integration with viem
+- ✅ Comprehensive parameter validation and security checks
+- ✅ Support for both SettlementRouter and standard modes
+- ✅ Gas optimization and configurable limits
+- ✅ Multi-network support with dynamic RPC URLs
+- ✅ Full error handling and mapping
+- ✅ Workspace-only package (private, not published to npm)
+
+## Installation
+
+This is a workspace-only package. Install within the x402-exec monorepo:
+
+```bash
+pnpm install
+```
+
+## Quick Start
+
+```typescript
+import { createRouterSettlementFacilitator } from "@x402x/facilitator_v2";
+
+// Create facilitator instance
+const facilitator = createRouterSettlementFacilitator({
+  signer: "0x1234567890123456789012345678901234567890",
+  allowedRouters: {
+    "eip155:84532": ["0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"], // Base Sepolia
+    "eip155:8453": ["0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"], // Base
+  },
+  rpcUrls: {
+    "eip155:84532": "https://sepolia.base.org",
+    "eip155:8453": "https://mainnet.base.org",
+  },
+});
+
+// Verify payment without executing
+const verification = await facilitator.verify(paymentPayload, paymentRequirements);
+if (!verification.isValid) {
+  console.error("Payment verification failed:", verification.invalidReason);
+  return;
+}
+
+// Execute settlement atomically
+const settlement = await facilitator.settle(paymentPayload, paymentRequirements);
+if (settlement.success) {
+  console.log("Settlement successful:", {
+    transaction: settlement.transaction,
+    network: settlement.network,
+    payer: settlement.payer,
+  });
+} else {
+  console.error("Settlement failed:", settlement.errorReason);
+}
+```
+
+## Configuration
+
+### FacilitatorConfig
+
+```typescript
+interface FacilitatorConfig {
+  // Required
+  signer: Address; // Facilitator signer address
+
+  // Optional security
+  allowedRouters?: Record<string, string[]>; // Whitelisted routers per network
+  rpcUrls?: Record<string, string>; // Custom RPC URLs per network
+
+  // Optional gas settings
+  gasConfig?: {
+    maxGasLimit: bigint; // Maximum gas limit (default: 5M)
+    gasMultiplier: number; // Gas multiplier for safety (default: 1.2)
+  };
+
+  // Optional fee settings
+  feeConfig?: {
+    minFee: string; // Minimum facilitator fee
+    maxFee: string; // Maximum facilitator fee
+  };
+
+  // Optional timeouts
+  timeouts?: {
+    verify: number; // Verification timeout in ms (default: 5000)
+    settle: number; // Settlement timeout in ms (default: 30000)
+  };
+}
+```
+
+## API Reference
+
+### RouterSettlementFacilitator
+
+Implements `SchemeNetworkFacilitator` interface:
+
+#### Properties
+
+- `scheme`: "exact" - Payment scheme identifier
+- `caipFamily`: "eip155:\*" - Supported network families
+
+#### Methods
+
+##### `getExtra(network: string): Record<string, unknown> | undefined`
+
+Returns scheme-specific metadata for the given network.
+
+##### `getSigners(network: string): string[]`
+
+Returns list of signer addresses for the given network.
+
+##### `verify(payload, requirements): Promise<VerifyResponse>`
+
+Validates payment without executing settlement.
+
+**Returns:**
+
+```typescript
+interface VerifyResponse {
+  isValid: boolean;
+  invalidReason?: string;
+  payer?: string;
+}
+```
+
+##### `settle(payload, requirements): Promise<SettleResponse>`
+
+Executes payment settlement on-chain.
+
+**Returns:**
+
+```typescript
+interface SettleResponse {
+  success: boolean;
+  transaction: string;
+  network: string;
+  payer?: string;
+  errorReason?: string;
+}
+```
+
+### SettlementRouter Integration
+
+#### `createPublicClientForNetwork(network, rpcUrls?): PublicClient`
+
+Creates a viem public client for the specified network.
+
+#### `createWalletClientForNetwork(network, signer, rpcUrls?): WalletClient`
+
+Creates a viem wallet client for the specified network.
+
+#### `settleWithSettlementRouter(requirements, payload, config, options?): Promise<SettleResponse>`
+
+Direct SettlementRouter settlement execution.
+
+### Validation Utilities
+
+#### `validateSettlementExtra(extra): SettlementExtraCore`
+
+Validates and parses settlement extra parameters.
+
+#### `validateSettlementRouter(network, router, allowedRouters?, networkConfig?): Address`
+
+Validates SettlementRouter address against whitelist and network config.
+
+#### `validateNetwork(network): Network`
+
+Validates network string format.
+
+#### `isValidEthereumAddress(address): boolean`
+
+Checks if string is a valid Ethereum address.
+
+## Error Handling
+
+The package provides custom error types:
+
+- `FacilitatorValidationError`: Parameter validation failures
+- `SettlementRouterError`: Contract interaction failures
+
+All errors include descriptive messages for debugging.
+
+## Settlement Mode Detection
+
+The package automatically detects SettlementRouter mode using:
+
+```typescript
+import { isSettlementMode } from "@x402x/facilitator_v2";
+
+if (isSettlementMode(paymentRequirements)) {
+  // Use SettlementRouter flow
+} else {
+  // Use standard EIP-3009 flow
+}
+```
+
+## Examples
+
+### Basic SettlementRouter Usage
+
+```typescript
+import { createRouterSettlementFacilitator } from "@x402x/facilitator_v2";
+
+const facilitator = createRouterSettlementFacilitator({
+  signer: "0xYourFacilitatorAddress",
+});
+
+// Payment requirements with SettlementRouter extra
+const requirements = {
+  scheme: "exact",
+  network: "eip155:84532",
+  maxAmountRequired: "1000000", // 1 USDC (6 decimals)
+  asset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  payTo: "0xSettlementRouterAddress",
+  extra: {
+    settlementRouter: "0xSettlementRouterAddress",
+    salt: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+    payTo: "0xMerchantAddress",
+    facilitatorFee: "100000", // 0.1 USDC
+    hook: "0xTransferHookAddress",
+    hookData: "0x",
+    name: "USD Coin",
+    version: "3",
+  },
+};
+
+const settlement = await facilitator.settle(paymentPayload, requirements);
+```
+
+### Multi-Network Configuration
+
+```typescript
+const facilitator = createRouterSettlementFacilitator({
+  signer: "0xYourFacilitatorAddress",
+  allowedRouters: {
+    "eip155:84532": ["0xBaseSepoliaRouter"],
+    "eip155:8453": ["0xBaseRouter"],
+    "eip155:137": ["0xPolygonRouter"],
+  },
+  rpcUrls: {
+    "eip155:84532": "https://sepolia.base.org",
+    "eip155:8453": "https://mainnet.base.org",
+    "eip155:137": "https://polygon-rpc.com",
+  },
+  gasConfig: {
+    maxGasLimit: 3_000_000n,
+    gasMultiplier: 1.1,
+  },
+});
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build package
+pnpm build
+
+# Run tests
+pnpm test
+
+# Run tests in watch mode
+pnpm test:watch
+
+# Generate coverage report
+pnpm test:coverage
+
+# Lint code
+pnpm lint
+
+# Format code
+pnpm format
+```
+
+## Dependencies
+
+- `@x402/core`: Official x402 v2 core types
+- `@x402/evm`: Official x402 v2 EVM utilities
+- `@x402x/core_v2`: x402x core utilities (workspace)
+- `viem`: Ethereum TypeScript library
+
+## License
+
+Apache-2.0 - see LICENSE file for details.
+
+## Related Packages
+
+- `@x402x/core_v2`: Core utilities and types
+- `@x402x/express_v2`: Express middleware wrapper
+- `@x402x/hono_v2`: Hono middleware wrapper
+- `@x402x/fetch_v2`: Fetch client wrapper

package/dist/index.d.mts

@@ -0,0 +1,189 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, SettleResponse } from '@x402/core/types';
+export { PaymentPayload, PaymentRequirements, SchemeNetworkFacilitator, SettleResponse } from '@x402/core/types';
+import { FacilitatorConfig, VerifyResponse, SettlementRouterParams, Address as Address$1, NetworkConfig, SettlementExtraCore, Network } from '@x402x/extensions';
+export { Address, FacilitatorConfig, FacilitatorValidationError, Network, NetworkConfig, SETTLEMENT_ROUTER_ABI, SettlementExtraCore, SettlementRouterError, SettlementRouterParams, VerifyResponse, getNetworkConfig, isSettlementMode, parseSettlementExtra } from '@x402x/extensions';
+import { PublicClient, Address, Transport, WalletClient, Hex } from 'viem';
+
+/**
+ * RouterSettlementFacilitator implementation
+ *
+ * Implements SchemeNetworkFacilitator interface using SettlementRouter for atomic settlement
+ */
+
+/**
+ * SchemeNetworkFacilitator implementation using SettlementRouter
+ *
+ * Provides atomic settlement with hooks and facilitator fee handling
+ */
+declare class RouterSettlementFacilitator implements SchemeNetworkFacilitator {
+    readonly scheme = "exact";
+    readonly caipFamily = "eip155:*";
+    private readonly config;
+    constructor(config: FacilitatorConfig);
+    /**
+     * Get scheme-specific extra data for responses
+     */
+    getExtra(network: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses for the network
+     * Derives from privateKey if signer address not explicitly provided
+     */
+    getSigners(network: string): string[];
+    /**
+     * Verify payment payload without executing settlement
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settle payment by executing blockchain transaction
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    /**
+     * Validate basic payload and requirements
+     */
+    private validateBasicPayload;
+    /**
+     * Verify payment for SettlementRouter mode
+     */
+    private verifySettlementRouter;
+    /**
+     * Verify payment for standard mode (fallback)
+     */
+    private verifyStandard;
+    /**
+     * Settle payment using SettlementRouter
+     */
+    private settleWithRouter;
+    /**
+     * Settle payment using standard method (fallback)
+     */
+    private settleStandard;
+}
+/**
+ * Factory function to create RouterSettlementFacilitator instance
+ */
+declare function createRouterSettlementFacilitator(config: FacilitatorConfig): RouterSettlementFacilitator;
+
+/**
+ * SettlementRouter integration utilities for @x402x/facilitator-sdk
+ *
+ * Provides direct viem integration with SettlementRouter contracts
+ */
+
+/**
+ * Create viem public client for a network
+ *
+ * @param network - Network identifier (V1 name or V2 CAIP-2 format)
+ * @param rpcUrls - Optional custom RPC URLs
+ */
+declare function createPublicClientForNetwork(network: string, rpcUrls?: Record<string, string>): PublicClient;
+/**
+ * Create viem wallet client for a network
+ * If privateKey is provided, uses local signing (works with standard RPC providers)
+ * If only signer address is provided, requires node to have the account unlocked
+ */
+declare function createWalletClientForNetwork(network: string, signer?: Address, rpcUrls?: Record<string, string>, transport?: Transport, privateKey?: string): WalletClient;
+/**
+ * Calculate gas limit for SettlementRouter transaction
+ */
+declare function calculateGasLimit(baseFee: string, facilitatorFee: string, gasMultiplier?: number): bigint;
+/**
+ * Check if a settlement has already been executed
+ */
+declare function checkIfSettled(publicClient: PublicClient, router: Address, contextKey: Hex): Promise<boolean>;
+/**
+ * Execute settlement via SettlementRouter
+ */
+declare function executeSettlementWithRouter(walletClient: WalletClient, params: SettlementRouterParams, config?: {
+    gasLimit?: bigint;
+    gasMultiplier?: number;
+}): Promise<Hex>;
+/**
+ * Wait for transaction receipt and extract relevant data
+ */
+declare function waitForSettlementReceipt(publicClient: PublicClient, txHash: Hex, timeoutMs?: number): Promise<{
+    success: boolean;
+    blockNumber?: bigint;
+    gasUsed?: bigint;
+    effectiveGasPrice?: bigint;
+}>;
+/**
+ * Parse settlement parameters from payment requirements and payload
+ */
+declare function parseSettlementRouterParams(paymentRequirements: any, paymentPayload: any): SettlementRouterParams;
+/**
+ * Execute settlement using provided WalletClient (for AccountPool integration)
+ * This function allows external wallet management by accepting a pre-configured WalletClient
+ */
+declare function executeSettlementWithWalletClient(walletClient: WalletClient, publicClient: PublicClient, paymentRequirements: PaymentRequirements, paymentPayload: PaymentPayload, config?: {
+    gasLimit?: bigint;
+    gasMultiplier?: number;
+    timeoutMs?: number;
+    allowedRouters?: Record<string, string[]>;
+}): Promise<SettleResponse>;
+/**
+ * Full settlement workflow using SettlementRouter
+ * This function creates its own clients based on FacilitatorConfig
+ */
+declare function settleWithSettlementRouter(paymentRequirements: any, paymentPayload: any, config: FacilitatorConfig, options?: {
+    gasMultiplier?: number;
+    gasLimit?: bigint;
+    timeoutMs?: number;
+}): Promise<SettleResponse>;
+
+/**
+ * Validation utilities for @x402x/facilitator-sdk
+ *
+ * Provides parameter validation and security checks for SettlementRouter integration
+ */
+
+/**
+ * Check if an Ethereum address is valid
+ */
+declare function isValidEthereumAddress(address: string): address is Address$1;
+/**
+ * Check if a hex string is valid
+ */
+declare function isValidHex(hex: string): boolean;
+/**
+ * Check if a string is a valid 32-byte hex (for salt, nonce, etc.)
+ */
+declare function isValid32ByteHex(hex: string): boolean;
+/**
+ * Check if a string is a valid 256-bit number (for values, fees, timestamps)
+ */
+declare function isValid256BitHex(hex: string): boolean;
+/**
+ * Validate SettlementRouter address against allowed list
+ */
+declare function validateSettlementRouter(network: string, router: Address$1, allowedRouters?: Record<string, string[]>, networkConfig?: NetworkConfig): Address$1;
+/**
+ * Validate settlement extra parameters
+ */
+declare function validateSettlementExtra(extra: unknown): SettlementExtraCore;
+/**
+ * Validate network string format
+ */
+declare function validateNetwork(network: string): Network;
+/**
+ * Validate facilitator configuration
+ */
+declare function validateFacilitatorConfig(config: {
+    signer?: string;
+    privateKey?: string;
+    allowedRouters?: Record<string, string[]>;
+    rpcUrls?: Record<string, string>;
+}): void;
+/**
+ * Validate gas limit configuration
+ */
+declare function validateGasLimit(gasLimit: bigint): void;
+/**
+ * Validate gas multiplier
+ */
+declare function validateGasMultiplier(multiplier: number): void;
+/**
+ * Validate fee amount against minimum and maximum
+ */
+declare function validateFeeAmount(fee: string, minFee?: string, maxFee?: string): void;
+
+export { RouterSettlementFacilitator, calculateGasLimit, checkIfSettled, createPublicClientForNetwork, createRouterSettlementFacilitator, createWalletClientForNetwork, executeSettlementWithRouter, executeSettlementWithWalletClient, isValid256BitHex, isValid32ByteHex, isValidEthereumAddress, isValidHex, parseSettlementRouterParams, settleWithSettlementRouter, validateFacilitatorConfig, validateFeeAmount, validateGasLimit, validateGasMultiplier, validateNetwork, validateSettlementExtra, validateSettlementRouter, waitForSettlementReceipt };

package/dist/index.d.ts

@@ -0,0 +1,189 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, SettleResponse } from '@x402/core/types';
+export { PaymentPayload, PaymentRequirements, SchemeNetworkFacilitator, SettleResponse } from '@x402/core/types';
+import { FacilitatorConfig, VerifyResponse, SettlementRouterParams, Address as Address$1, NetworkConfig, SettlementExtraCore, Network } from '@x402x/extensions';
+export { Address, FacilitatorConfig, FacilitatorValidationError, Network, NetworkConfig, SETTLEMENT_ROUTER_ABI, SettlementExtraCore, SettlementRouterError, SettlementRouterParams, VerifyResponse, getNetworkConfig, isSettlementMode, parseSettlementExtra } from '@x402x/extensions';
+import { PublicClient, Address, Transport, WalletClient, Hex } from 'viem';
+
+/**
+ * RouterSettlementFacilitator implementation
+ *
+ * Implements SchemeNetworkFacilitator interface using SettlementRouter for atomic settlement
+ */
+
+/**
+ * SchemeNetworkFacilitator implementation using SettlementRouter
+ *
+ * Provides atomic settlement with hooks and facilitator fee handling
+ */
+declare class RouterSettlementFacilitator implements SchemeNetworkFacilitator {
+    readonly scheme = "exact";
+    readonly caipFamily = "eip155:*";
+    private readonly config;
+    constructor(config: FacilitatorConfig);
+    /**
+     * Get scheme-specific extra data for responses
+     */
+    getExtra(network: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses for the network
+     * Derives from privateKey if signer address not explicitly provided
+     */
+    getSigners(network: string): string[];
+    /**
+     * Verify payment payload without executing settlement
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settle payment by executing blockchain transaction
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    /**
+     * Validate basic payload and requirements
+     */
+    private validateBasicPayload;
+    /**
+     * Verify payment for SettlementRouter mode
+     */
+    private verifySettlementRouter;
+    /**
+     * Verify payment for standard mode (fallback)
+     */
+    private verifyStandard;
+    /**
+     * Settle payment using SettlementRouter
+     */
+    private settleWithRouter;
+    /**
+     * Settle payment using standard method (fallback)
+     */
+    private settleStandard;
+}
+/**
+ * Factory function to create RouterSettlementFacilitator instance
+ */
+declare function createRouterSettlementFacilitator(config: FacilitatorConfig): RouterSettlementFacilitator;
+
+/**
+ * SettlementRouter integration utilities for @x402x/facilitator-sdk
+ *
+ * Provides direct viem integration with SettlementRouter contracts
+ */
+
+/**
+ * Create viem public client for a network
+ *
+ * @param network - Network identifier (V1 name or V2 CAIP-2 format)
+ * @param rpcUrls - Optional custom RPC URLs
+ */
+declare function createPublicClientForNetwork(network: string, rpcUrls?: Record<string, string>): PublicClient;
+/**
+ * Create viem wallet client for a network
+ * If privateKey is provided, uses local signing (works with standard RPC providers)
+ * If only signer address is provided, requires node to have the account unlocked
+ */
+declare function createWalletClientForNetwork(network: string, signer?: Address, rpcUrls?: Record<string, string>, transport?: Transport, privateKey?: string): WalletClient;
+/**
+ * Calculate gas limit for SettlementRouter transaction
+ */
+declare function calculateGasLimit(baseFee: string, facilitatorFee: string, gasMultiplier?: number): bigint;
+/**
+ * Check if a settlement has already been executed
+ */
+declare function checkIfSettled(publicClient: PublicClient, router: Address, contextKey: Hex): Promise<boolean>;
+/**
+ * Execute settlement via SettlementRouter
+ */
+declare function executeSettlementWithRouter(walletClient: WalletClient, params: SettlementRouterParams, config?: {
+    gasLimit?: bigint;
+    gasMultiplier?: number;
+}): Promise<Hex>;
+/**
+ * Wait for transaction receipt and extract relevant data
+ */
+declare function waitForSettlementReceipt(publicClient: PublicClient, txHash: Hex, timeoutMs?: number): Promise<{
+    success: boolean;
+    blockNumber?: bigint;
+    gasUsed?: bigint;
+    effectiveGasPrice?: bigint;
+}>;
+/**
+ * Parse settlement parameters from payment requirements and payload
+ */
+declare function parseSettlementRouterParams(paymentRequirements: any, paymentPayload: any): SettlementRouterParams;
+/**
+ * Execute settlement using provided WalletClient (for AccountPool integration)
+ * This function allows external wallet management by accepting a pre-configured WalletClient
+ */
+declare function executeSettlementWithWalletClient(walletClient: WalletClient, publicClient: PublicClient, paymentRequirements: PaymentRequirements, paymentPayload: PaymentPayload, config?: {
+    gasLimit?: bigint;
+    gasMultiplier?: number;
+    timeoutMs?: number;
+    allowedRouters?: Record<string, string[]>;
+}): Promise<SettleResponse>;
+/**
+ * Full settlement workflow using SettlementRouter
+ * This function creates its own clients based on FacilitatorConfig
+ */
+declare function settleWithSettlementRouter(paymentRequirements: any, paymentPayload: any, config: FacilitatorConfig, options?: {
+    gasMultiplier?: number;
+    gasLimit?: bigint;
+    timeoutMs?: number;
+}): Promise<SettleResponse>;
+
+/**
+ * Validation utilities for @x402x/facilitator-sdk
+ *
+ * Provides parameter validation and security checks for SettlementRouter integration
+ */
+
+/**
+ * Check if an Ethereum address is valid
+ */
+declare function isValidEthereumAddress(address: string): address is Address$1;
+/**
+ * Check if a hex string is valid
+ */
+declare function isValidHex(hex: string): boolean;
+/**
+ * Check if a string is a valid 32-byte hex (for salt, nonce, etc.)
+ */
+declare function isValid32ByteHex(hex: string): boolean;
+/**
+ * Check if a string is a valid 256-bit number (for values, fees, timestamps)
+ */
+declare function isValid256BitHex(hex: string): boolean;
+/**
+ * Validate SettlementRouter address against allowed list
+ */
+declare function validateSettlementRouter(network: string, router: Address$1, allowedRouters?: Record<string, string[]>, networkConfig?: NetworkConfig): Address$1;
+/**
+ * Validate settlement extra parameters
+ */
+declare function validateSettlementExtra(extra: unknown): SettlementExtraCore;
+/**
+ * Validate network string format
+ */
+declare function validateNetwork(network: string): Network;
+/**
+ * Validate facilitator configuration
+ */
+declare function validateFacilitatorConfig(config: {
+    signer?: string;
+    privateKey?: string;
+    allowedRouters?: Record<string, string[]>;
+    rpcUrls?: Record<string, string>;
+}): void;
+/**
+ * Validate gas limit configuration
+ */
+declare function validateGasLimit(gasLimit: bigint): void;
+/**
+ * Validate gas multiplier
+ */
+declare function validateGasMultiplier(multiplier: number): void;
+/**
+ * Validate fee amount against minimum and maximum
+ */
+declare function validateFeeAmount(fee: string, minFee?: string, maxFee?: string): void;
+
+export { RouterSettlementFacilitator, calculateGasLimit, checkIfSettled, createPublicClientForNetwork, createRouterSettlementFacilitator, createWalletClientForNetwork, executeSettlementWithRouter, executeSettlementWithWalletClient, isValid256BitHex, isValid32ByteHex, isValidEthereumAddress, isValidHex, parseSettlementRouterParams, settleWithSettlementRouter, validateFacilitatorConfig, validateFeeAmount, validateGasLimit, validateGasMultiplier, validateNetwork, validateSettlementExtra, validateSettlementRouter, waitForSettlementReceipt };