@t402/smart-router 1.0.0-beta.1

package/dist/execution/index.d.ts

@@ -0,0 +1,679 @@
+import { z } from 'zod';
+import { c as Route, b as RouteStep, C as ChainId } from '../types-C0ey6WqI.js';
+import { c as GasOracle } from '../gas-CNpJzuy5.js';
+
+/**
+ * Transaction status
+ */
+declare const TransactionStatus: z.ZodEnum<["pending", "submitted", "confirmed", "failed", "replaced"]>;
+type TransactionStatus = z.infer<typeof TransactionStatus>;
+/**
+ * MEV protection strategy
+ */
+declare const MevProtectionStrategy: z.ZodEnum<["none", "flashbots", "private_mempool", "timing", "splitting"]>;
+type MevProtectionStrategy = z.infer<typeof MevProtectionStrategy>;
+/**
+ * Transaction request
+ */
+declare const TransactionRequest: z.ZodObject<{
+    to: z.ZodString;
+    data: z.ZodString;
+    value: z.ZodDefault<z.ZodString>;
+    gasLimit: z.ZodString;
+    maxFeePerGas: z.ZodOptional<z.ZodString>;
+    maxPriorityFeePerGas: z.ZodOptional<z.ZodString>;
+    gasPrice: z.ZodOptional<z.ZodString>;
+    nonce: z.ZodOptional<z.ZodNumber>;
+    chainId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    to: string;
+    data: string;
+    gasLimit: string;
+    chainId: number;
+    maxFeePerGas?: string | undefined;
+    maxPriorityFeePerGas?: string | undefined;
+    gasPrice?: string | undefined;
+    nonce?: number | undefined;
+}, {
+    to: string;
+    data: string;
+    gasLimit: string;
+    chainId: number;
+    value?: string | undefined;
+    maxFeePerGas?: string | undefined;
+    maxPriorityFeePerGas?: string | undefined;
+    gasPrice?: string | undefined;
+    nonce?: number | undefined;
+}>;
+type TransactionRequest = z.infer<typeof TransactionRequest>;
+/**
+ * Signed transaction
+ */
+declare const SignedTransaction: z.ZodObject<{
+    raw: z.ZodString;
+    hash: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    nonce: z.ZodNumber;
+    gasLimit: z.ZodString;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    to: string;
+    gasLimit: string;
+    nonce: number;
+    raw: string;
+    hash: string;
+    from: string;
+}, {
+    value: string;
+    to: string;
+    gasLimit: string;
+    nonce: number;
+    raw: string;
+    hash: string;
+    from: string;
+}>;
+type SignedTransaction = z.infer<typeof SignedTransaction>;
+/**
+ * Transaction receipt
+ */
+declare const TransactionReceipt: z.ZodObject<{
+    hash: z.ZodString;
+    status: z.ZodEnum<["pending", "submitted", "confirmed", "failed", "replaced"]>;
+    blockNumber: z.ZodOptional<z.ZodNumber>;
+    blockHash: z.ZodOptional<z.ZodString>;
+    gasUsed: z.ZodOptional<z.ZodString>;
+    effectiveGasPrice: z.ZodOptional<z.ZodString>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        topics: z.ZodArray<z.ZodString, "many">;
+        data: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        address: string;
+        data: string;
+        topics: string[];
+    }, {
+        address: string;
+        data: string;
+        topics: string[];
+    }>, "many">>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+    timestamp: number;
+    hash: string;
+    blockNumber?: number | undefined;
+    blockHash?: string | undefined;
+    gasUsed?: string | undefined;
+    effectiveGasPrice?: string | undefined;
+    logs?: {
+        address: string;
+        data: string;
+        topics: string[];
+    }[] | undefined;
+}, {
+    status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+    timestamp: number;
+    hash: string;
+    blockNumber?: number | undefined;
+    blockHash?: string | undefined;
+    gasUsed?: string | undefined;
+    effectiveGasPrice?: string | undefined;
+    logs?: {
+        address: string;
+        data: string;
+        topics: string[];
+    }[] | undefined;
+}>;
+type TransactionReceipt = z.infer<typeof TransactionReceipt>;
+/**
+ * Execution step result
+ */
+declare const ExecutionStepResult: z.ZodObject<{
+    stepId: z.ZodString;
+    status: z.ZodEnum<["pending", "submitted", "confirmed", "failed", "replaced"]>;
+    transaction: z.ZodOptional<z.ZodObject<{
+        hash: z.ZodString;
+        status: z.ZodEnum<["pending", "submitted", "confirmed", "failed", "replaced"]>;
+        blockNumber: z.ZodOptional<z.ZodNumber>;
+        blockHash: z.ZodOptional<z.ZodString>;
+        gasUsed: z.ZodOptional<z.ZodString>;
+        effectiveGasPrice: z.ZodOptional<z.ZodString>;
+        logs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            topics: z.ZodArray<z.ZodString, "many">;
+            data: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            address: string;
+            data: string;
+            topics: string[];
+        }, {
+            address: string;
+            data: string;
+            topics: string[];
+        }>, "many">>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        timestamp: number;
+        hash: string;
+        blockNumber?: number | undefined;
+        blockHash?: string | undefined;
+        gasUsed?: string | undefined;
+        effectiveGasPrice?: string | undefined;
+        logs?: {
+            address: string;
+            data: string;
+            topics: string[];
+        }[] | undefined;
+    }, {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        timestamp: number;
+        hash: string;
+        blockNumber?: number | undefined;
+        blockHash?: string | undefined;
+        gasUsed?: string | undefined;
+        effectiveGasPrice?: string | undefined;
+        logs?: {
+            address: string;
+            data: string;
+            topics: string[];
+        }[] | undefined;
+    }>>;
+    actualOutput: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodNumber;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+    stepId: string;
+    startedAt: number;
+    transaction?: {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        timestamp: number;
+        hash: string;
+        blockNumber?: number | undefined;
+        blockHash?: string | undefined;
+        gasUsed?: string | undefined;
+        effectiveGasPrice?: string | undefined;
+        logs?: {
+            address: string;
+            data: string;
+            topics: string[];
+        }[] | undefined;
+    } | undefined;
+    actualOutput?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+}, {
+    status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+    stepId: string;
+    startedAt: number;
+    transaction?: {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        timestamp: number;
+        hash: string;
+        blockNumber?: number | undefined;
+        blockHash?: string | undefined;
+        gasUsed?: string | undefined;
+        effectiveGasPrice?: string | undefined;
+        logs?: {
+            address: string;
+            data: string;
+            topics: string[];
+        }[] | undefined;
+    } | undefined;
+    actualOutput?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+}>;
+type ExecutionStepResult = z.infer<typeof ExecutionStepResult>;
+/**
+ * Route execution result
+ */
+declare const ExecutionResult: z.ZodObject<{
+    routeId: z.ZodString;
+    status: z.ZodEnum<["pending", "partial", "completed", "failed", "reverted"]>;
+    steps: z.ZodArray<z.ZodObject<{
+        stepId: z.ZodString;
+        status: z.ZodEnum<["pending", "submitted", "confirmed", "failed", "replaced"]>;
+        transaction: z.ZodOptional<z.ZodObject<{
+            hash: z.ZodString;
+            status: z.ZodEnum<["pending", "submitted", "confirmed", "failed", "replaced"]>;
+            blockNumber: z.ZodOptional<z.ZodNumber>;
+            blockHash: z.ZodOptional<z.ZodString>;
+            gasUsed: z.ZodOptional<z.ZodString>;
+            effectiveGasPrice: z.ZodOptional<z.ZodString>;
+            logs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                address: z.ZodString;
+                topics: z.ZodArray<z.ZodString, "many">;
+                data: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                address: string;
+                data: string;
+                topics: string[];
+            }, {
+                address: string;
+                data: string;
+                topics: string[];
+            }>, "many">>;
+            timestamp: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+            timestamp: number;
+            hash: string;
+            blockNumber?: number | undefined;
+            blockHash?: string | undefined;
+            gasUsed?: string | undefined;
+            effectiveGasPrice?: string | undefined;
+            logs?: {
+                address: string;
+                data: string;
+                topics: string[];
+            }[] | undefined;
+        }, {
+            status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+            timestamp: number;
+            hash: string;
+            blockNumber?: number | undefined;
+            blockHash?: string | undefined;
+            gasUsed?: string | undefined;
+            effectiveGasPrice?: string | undefined;
+            logs?: {
+                address: string;
+                data: string;
+                topics: string[];
+            }[] | undefined;
+        }>>;
+        actualOutput: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodNumber;
+        completedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        stepId: string;
+        startedAt: number;
+        transaction?: {
+            status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+            timestamp: number;
+            hash: string;
+            blockNumber?: number | undefined;
+            blockHash?: string | undefined;
+            gasUsed?: string | undefined;
+            effectiveGasPrice?: string | undefined;
+            logs?: {
+                address: string;
+                data: string;
+                topics: string[];
+            }[] | undefined;
+        } | undefined;
+        actualOutput?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+    }, {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        stepId: string;
+        startedAt: number;
+        transaction?: {
+            status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+            timestamp: number;
+            hash: string;
+            blockNumber?: number | undefined;
+            blockHash?: string | undefined;
+            gasUsed?: string | undefined;
+            effectiveGasPrice?: string | undefined;
+            logs?: {
+                address: string;
+                data: string;
+                topics: string[];
+            }[] | undefined;
+        } | undefined;
+        actualOutput?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+    }>, "many">;
+    actualOutput: z.ZodOptional<z.ZodString>;
+    totalGasUsed: z.ZodOptional<z.ZodString>;
+    totalGasCost: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodNumber;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "failed" | "partial" | "completed" | "reverted";
+    steps: {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        stepId: string;
+        startedAt: number;
+        transaction?: {
+            status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+            timestamp: number;
+            hash: string;
+            blockNumber?: number | undefined;
+            blockHash?: string | undefined;
+            gasUsed?: string | undefined;
+            effectiveGasPrice?: string | undefined;
+            logs?: {
+                address: string;
+                data: string;
+                topics: string[];
+            }[] | undefined;
+        } | undefined;
+        actualOutput?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+    }[];
+    startedAt: number;
+    routeId: string;
+    totalGasCost?: string | undefined;
+    actualOutput?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+    totalGasUsed?: string | undefined;
+}, {
+    status: "pending" | "failed" | "partial" | "completed" | "reverted";
+    steps: {
+        status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+        stepId: string;
+        startedAt: number;
+        transaction?: {
+            status: "pending" | "submitted" | "confirmed" | "failed" | "replaced";
+            timestamp: number;
+            hash: string;
+            blockNumber?: number | undefined;
+            blockHash?: string | undefined;
+            gasUsed?: string | undefined;
+            effectiveGasPrice?: string | undefined;
+            logs?: {
+                address: string;
+                data: string;
+                topics: string[];
+            }[] | undefined;
+        } | undefined;
+        actualOutput?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+    }[];
+    startedAt: number;
+    routeId: string;
+    totalGasCost?: string | undefined;
+    actualOutput?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+    totalGasUsed?: string | undefined;
+}>;
+type ExecutionResult = z.infer<typeof ExecutionResult>;
+/**
+ * Execution options
+ */
+declare const ExecutionOptions: z.ZodObject<{
+    gasSpeed: z.ZodDefault<z.ZodEnum<["slow", "standard", "fast", "instant"]>>;
+    maxGasPrice: z.ZodOptional<z.ZodString>;
+    mevProtection: z.ZodDefault<z.ZodEnum<["none", "flashbots", "private_mempool", "timing", "splitting"]>>;
+    flashbotsRelay: z.ZodOptional<z.ZodString>;
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+    retryDelay: z.ZodDefault<z.ZodNumber>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    simulate: z.ZodDefault<z.ZodBoolean>;
+    autoApprove: z.ZodDefault<z.ZodBoolean>;
+    approvalBuffer: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    gasSpeed: "slow" | "standard" | "fast" | "instant";
+    mevProtection: "none" | "flashbots" | "private_mempool" | "timing" | "splitting";
+    maxRetries: number;
+    retryDelay: number;
+    timeout: number;
+    simulate: boolean;
+    autoApprove: boolean;
+    approvalBuffer: string;
+    maxGasPrice?: string | undefined;
+    flashbotsRelay?: string | undefined;
+}, {
+    gasSpeed?: "slow" | "standard" | "fast" | "instant" | undefined;
+    maxGasPrice?: string | undefined;
+    mevProtection?: "none" | "flashbots" | "private_mempool" | "timing" | "splitting" | undefined;
+    flashbotsRelay?: string | undefined;
+    maxRetries?: number | undefined;
+    retryDelay?: number | undefined;
+    timeout?: number | undefined;
+    simulate?: boolean | undefined;
+    autoApprove?: boolean | undefined;
+    approvalBuffer?: string | undefined;
+}>;
+type ExecutionOptions = z.infer<typeof ExecutionOptions>;
+/**
+ * Simulation result
+ */
+declare const SimulationResult: z.ZodObject<{
+    success: z.ZodBoolean;
+    gasUsed: z.ZodString;
+    output: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    logs: z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        topics: z.ZodArray<z.ZodString, "many">;
+        data: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        address: string;
+        data: string;
+        topics: string[];
+    }, {
+        address: string;
+        data: string;
+        topics: string[];
+    }>, "many">;
+    stateChanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        key: z.ZodString;
+        before: z.ZodString;
+        after: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        address: string;
+        before: string;
+        after: string;
+    }, {
+        key: string;
+        address: string;
+        before: string;
+        after: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    gasUsed: string;
+    logs: {
+        address: string;
+        data: string;
+        topics: string[];
+    }[];
+    success: boolean;
+    error?: string | undefined;
+    output?: string | undefined;
+    stateChanges?: {
+        key: string;
+        address: string;
+        before: string;
+        after: string;
+    }[] | undefined;
+}, {
+    gasUsed: string;
+    logs: {
+        address: string;
+        data: string;
+        topics: string[];
+    }[];
+    success: boolean;
+    error?: string | undefined;
+    output?: string | undefined;
+    stateChanges?: {
+        key: string;
+        address: string;
+        before: string;
+        after: string;
+    }[] | undefined;
+}>;
+type SimulationResult = z.infer<typeof SimulationResult>;
+/**
+ * Fallback route
+ */
+interface FallbackRoute {
+    route: Route;
+    reason: string;
+    priority: number;
+}
+/**
+ * Execution context for tracking state
+ */
+interface ExecutionContext {
+    routeId: string;
+    sender: string;
+    currentStep: number;
+    completedSteps: ExecutionStepResult[];
+    options: ExecutionOptions;
+    startedAt: number;
+    fallbackRoutes: FallbackRoute[];
+}
+
+/**
+ * Transaction builder configuration
+ */
+interface BuilderConfig {
+    defaultGasBuffer?: number;
+}
+/**
+ * Transaction builder - converts route steps to executable transactions
+ */
+declare class TransactionBuilder {
+    private gasOracle;
+    private config;
+    constructor(gasOracle: GasOracle, config?: BuilderConfig);
+    /**
+     * Build all transactions for a route
+     */
+    buildRoute(route: Route, sender: string, options: ExecutionOptions): Promise<TransactionRequest[]>;
+    /**
+     * Build a single step transaction
+     */
+    buildStep(step: RouteStep, sender: string, options: ExecutionOptions): Promise<TransactionRequest>;
+    /**
+     * Build approval transaction if needed
+     */
+    buildApproval(tokenAddress: string, spender: string, amount: string, _chainId: string, infinite?: boolean): {
+        data: string;
+        to: string;
+    };
+    /**
+     * Build transfer transaction
+     */
+    buildTransfer(tokenAddress: string, recipient: string, amount: string): {
+        data: string;
+        to: string;
+    };
+    /**
+     * Estimate required approvals for a route
+     */
+    getRequiredApprovals(route: Route, _sender: string): Array<{
+        token: string;
+        spender: string;
+        amount: string;
+    }>;
+    private buildCalldata;
+    private buildTransferCalldata;
+    private buildApproveCalldata;
+    private buildSwapCalldata;
+    private buildBridgeCalldata;
+    private buildWrapCalldata;
+    private buildUnwrapCalldata;
+    private applyGasBuffer;
+}
+/**
+ * Builder error codes
+ */
+type BuilderErrorCode = 'UNSUPPORTED_CHAIN' | 'UNKNOWN_STEP_TYPE' | 'INVALID_CALLDATA';
+/**
+ * Custom error for builder operations
+ */
+declare class BuilderError extends Error {
+    code: BuilderErrorCode;
+    constructor(message: string, code: BuilderErrorCode);
+}
+
+/**
+ * MEV protection configuration
+ */
+interface MevProtectionConfig {
+    flashbotsRelay?: string;
+    privateRpcUrls?: Record<ChainId, string>;
+    simulationRpc?: string;
+    maxBundleSize?: number;
+}
+/**
+ * Bundle submission result
+ */
+interface BundleResult {
+    bundleHash: string;
+    submitted: boolean;
+    simulationResult?: SimulationResult;
+    error?: string;
+}
+/**
+ * MEV protection service
+ */
+declare class MevProtection {
+    private config;
+    constructor(config?: MevProtectionConfig);
+    /**
+     * Apply MEV protection to a transaction
+     */
+    protect(_tx: TransactionRequest, signedTx: SignedTransaction, strategy: MevProtectionStrategy, chain: ChainId): Promise<{
+        method: string;
+        endpoint?: string;
+        bundleHash?: string;
+    }>;
+    /**
+     * Submit transaction bundle to Flashbots
+     */
+    submitBundle(signedTxs: SignedTransaction[], targetBlock: number, _chain: ChainId): Promise<BundleResult>;
+    /**
+     * Simulate transaction without executing
+     */
+    simulate(tx: TransactionRequest, _chain: ChainId): Promise<SimulationResult>;
+    /**
+     * Estimate MEV risk for a transaction
+     */
+    estimateMevRisk(tx: TransactionRequest, _chain: ChainId): {
+        riskLevel: 'low' | 'medium' | 'high';
+        estimatedMevCost: string;
+        recommendations: string[];
+    };
+    /**
+     * Get optimal block for transaction submission
+     */
+    getOptimalSubmissionTime(_chain: ChainId): {
+        targetBlock: number;
+        delay: number;
+        reason: string;
+    };
+    /**
+     * Check if Flashbots is available for a chain
+     */
+    isFlashbotsAvailable(chain: ChainId): boolean;
+    /**
+     * Get private RPC URL for a chain
+     */
+    getPrivateRpcUrl(chain: ChainId): string | undefined;
+    private useFlashbots;
+    private usePrivateMempool;
+    private useTimingProtection;
+    private generateBundleHash;
+    private simpleHash;
+}
+/**
+ * Create MEV-protected transaction options
+ */
+declare function createMevProtectedOptions(chain: ChainId, value: string): {
+    strategy: MevProtectionStrategy;
+    reason: string;
+};
+
+export { type BuilderConfig, BuilderError, type BuilderErrorCode, type BundleResult, type ExecutionContext, ExecutionOptions, ExecutionResult, ExecutionStepResult, type FallbackRoute, MevProtection, type MevProtectionConfig, MevProtectionStrategy, SignedTransaction, SimulationResult, TransactionBuilder, TransactionReceipt, TransactionRequest, TransactionStatus, createMevProtectedOptions };

package/dist/execution/index.js

@@ -0,0 +1,31 @@
+import {
+  BuilderError,
+  ExecutionOptions,
+  ExecutionResult,
+  ExecutionStepResult,
+  MevProtection,
+  MevProtectionStrategy,
+  SignedTransaction,
+  SimulationResult,
+  TransactionBuilder,
+  TransactionReceipt,
+  TransactionRequest,
+  TransactionStatus,
+  createMevProtectedOptions
+} from "../chunk-XKFKUWJY.js";
+export {
+  BuilderError,
+  ExecutionOptions,
+  ExecutionResult,
+  ExecutionStepResult,
+  MevProtection,
+  MevProtectionStrategy,
+  SignedTransaction,
+  SimulationResult,
+  TransactionBuilder,
+  TransactionReceipt,
+  TransactionRequest,
+  TransactionStatus,
+  createMevProtectedOptions
+};
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}