outsmart 2.0.0-alpha.0

package/dist/transactions/landing/nonce-manager.js

@@ -0,0 +1,393 @@
+"use strict";
+/**
+ * Durable Nonce Account Manager
+ *
+ * Manages durable nonce accounts for concurrent TX landing safety.
+ *
+ * Problem: The "concurrent" landing strategy fires the SAME transaction to
+ * 9+ providers in parallel. Without a durable nonce, if multiple providers
+ * land it, the user gets DUPLICATE BUYS — spending 2-9x more SOL than intended.
+ *
+ * Solution: Durable nonce transactions use a nonce account's stored blockhash.
+ * Once consumed by the first successful landing, all other copies become
+ * invalid on-chain. This guarantees exactly-once execution.
+ *
+ * How it works:
+ * 1. NonceManager.create() creates a nonce account on-chain (~0.0015 SOL)
+ * 2. Before concurrent submission, NonceManager.get() fetches the current nonce
+ * 3. NonceManager.buildAdvanceIx() is prepended as the FIRST instruction
+ * 4. The nonce value replaces the blockhash in the transaction message
+ * 5. Providers treat the nonce as a regular blockhash — no provider changes needed
+ *
+ * Config is stored at ~/.outsmart/nonce.json
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NonceManager = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+// ---------------------------------------------------------------------------
+// NonceManager class
+// ---------------------------------------------------------------------------
+class NonceManager {
+    connection;
+    authority;
+    nonceAddress = null;
+    configLoaded = false;
+    /**
+     * @param connection - Solana RPC connection
+     * @param authority - Wallet keypair that controls the nonce account
+     */
+    constructor(connection, authority) {
+        this.connection = connection;
+        this.authority = authority;
+    }
+    // -----------------------------------------------------------------------
+    // Static config paths
+    // -----------------------------------------------------------------------
+    /** Directory for outsmart config files */
+    static get configDir() {
+        const home = process.env.HOME || process.env.USERPROFILE || "~";
+        return path.join(home, ".outsmart");
+    }
+    /** Path to nonce config JSON */
+    static get configPath() {
+        return path.join(NonceManager.configDir, "nonce.json");
+    }
+    /** Path to nonce keypair JSON */
+    static get keypairPath() {
+        return path.join(NonceManager.configDir, "nonce-keypair.json");
+    }
+    // -----------------------------------------------------------------------
+    // Config I/O
+    // -----------------------------------------------------------------------
+    readConfig() {
+        try {
+            if (!fs.existsSync(NonceManager.configPath))
+                return null;
+            const raw = fs.readFileSync(NonceManager.configPath, "utf8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    writeConfig(config) {
+        fs.mkdirSync(NonceManager.configDir, { recursive: true });
+        fs.writeFileSync(NonceManager.configPath, JSON.stringify(config, null, 2), { encoding: "utf8", mode: 0o600 });
+    }
+    deleteConfig() {
+        try {
+            if (fs.existsSync(NonceManager.configPath)) {
+                fs.unlinkSync(NonceManager.configPath);
+            }
+            if (fs.existsSync(NonceManager.keypairPath)) {
+                fs.unlinkSync(NonceManager.keypairPath);
+            }
+        }
+        catch {
+            // Best-effort cleanup
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Core operations
+    // -----------------------------------------------------------------------
+    /**
+     * Check if a valid nonce account exists (config + on-chain).
+     */
+    async exists() {
+        const config = this.readConfig();
+        if (!config)
+            return false;
+        try {
+            const pubkey = new web3_js_1.PublicKey(config.nonceAccountAddress);
+            const accountInfo = await this.connection.getAccountInfo(pubkey);
+            if (!accountInfo)
+                return false;
+            // Verify it's actually a nonce account by trying to decode it
+            web3_js_1.NonceAccount.fromAccountData(accountInfo.data);
+            this.nonceAddress = pubkey;
+            this.configLoaded = true;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Create a new nonce account on-chain.
+     *
+     * Cost: ~0.0015 SOL (rent-exempt minimum for nonce account).
+     *
+     * @returns The nonce account address and initial nonce value
+     */
+    async create() {
+        // Generate a new keypair for the nonce account
+        const nonceKeypair = web3_js_1.Keypair.generate();
+        // Calculate minimum rent for nonce account
+        const rent = await this.connection.getMinimumBalanceForRentExemption(web3_js_1.NONCE_ACCOUNT_LENGTH);
+        // Build the create + initialize instructions
+        const createAccountIx = web3_js_1.SystemProgram.createAccount({
+            fromPubkey: this.authority.publicKey,
+            newAccountPubkey: nonceKeypair.publicKey,
+            lamports: rent,
+            space: web3_js_1.NONCE_ACCOUNT_LENGTH,
+            programId: web3_js_1.SystemProgram.programId,
+        });
+        const initNonceIx = web3_js_1.SystemProgram.nonceInitialize({
+            noncePubkey: nonceKeypair.publicKey,
+            authorizedPubkey: this.authority.publicKey,
+        });
+        // Build, sign, and send the transaction
+        const { blockhash, lastValidBlockHeight } = await this.connection.getLatestBlockhash("confirmed");
+        const message = new web3_js_1.TransactionMessage({
+            payerKey: this.authority.publicKey,
+            recentBlockhash: blockhash,
+            instructions: [createAccountIx, initNonceIx],
+        }).compileToV0Message();
+        const tx = new web3_js_1.VersionedTransaction(message);
+        tx.sign([this.authority, nonceKeypair]);
+        const signature = await this.connection.sendRawTransaction(tx.serialize(), {
+            skipPreflight: false,
+            maxRetries: 3,
+        });
+        // Wait for confirmation
+        await this.connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, "confirmed");
+        // Save the keypair securely
+        fs.mkdirSync(NonceManager.configDir, { recursive: true });
+        fs.writeFileSync(NonceManager.keypairPath, JSON.stringify(Array.from(nonceKeypair.secretKey)), { encoding: "utf8", mode: 0o600 });
+        // Save config
+        const config = {
+            nonceAccountAddress: nonceKeypair.publicKey.toBase58(),
+            nonceKeypairPath: NonceManager.keypairPath,
+            authorityPubkey: this.authority.publicKey.toBase58(),
+            createdAt: new Date().toISOString(),
+        };
+        this.writeConfig(config);
+        // Set internal state
+        this.nonceAddress = nonceKeypair.publicKey;
+        this.configLoaded = true;
+        // Fetch the initial nonce value
+        const accountInfo = await this.connection.getAccountInfo(nonceKeypair.publicKey);
+        if (!accountInfo) {
+            throw new Error("Nonce account created but could not be read back");
+        }
+        const nonceAccount = web3_js_1.NonceAccount.fromAccountData(accountInfo.data);
+        console.log(`[nonce] Created nonce account: ${nonceKeypair.publicKey.toBase58()}`);
+        console.log(`[nonce] Cost: ${(rent / web3_js_1.LAMPORTS_PER_SOL).toFixed(6)} SOL (rent-exempt)`);
+        return {
+            nonceAccount: nonceKeypair.publicKey,
+            nonce: nonceAccount.nonce,
+        };
+    }
+    /**
+     * Load the nonce account from config and fetch its current on-chain state.
+     *
+     * @returns Nonce address, current nonce value, and authority
+     * @throws Error if no nonce config exists or account is invalid
+     */
+    async load() {
+        const config = this.readConfig();
+        if (!config) {
+            throw new Error("No nonce account configured. Run NonceManager.create() first, " +
+                "or use the 'outsmart nonce create' command.");
+        }
+        const address = new web3_js_1.PublicKey(config.nonceAccountAddress);
+        const accountInfo = await this.connection.getAccountInfo(address);
+        if (!accountInfo) {
+            throw new Error(`Nonce account ${config.nonceAccountAddress} not found on-chain. ` +
+                "It may have been closed. Run NonceManager.create() to create a new one.");
+        }
+        const nonceAccount = web3_js_1.NonceAccount.fromAccountData(accountInfo.data);
+        this.nonceAddress = address;
+        this.configLoaded = true;
+        return {
+            address,
+            nonce: nonceAccount.nonce,
+            authority: nonceAccount.authorizedPubkey,
+        };
+    }
+    /**
+     * Get the current nonce value (fetches fresh from chain every time).
+     *
+     * IMPORTANT: Nonce value changes after each use. Always call get() fresh
+     * before building a transaction.
+     */
+    async get() {
+        if (!this.nonceAddress) {
+            await this.load();
+        }
+        const accountInfo = await this.connection.getAccountInfo(this.nonceAddress);
+        if (!accountInfo) {
+            throw new Error(`Nonce account ${this.nonceAddress.toBase58()} no longer exists on-chain.`);
+        }
+        const nonceAccount = web3_js_1.NonceAccount.fromAccountData(accountInfo.data);
+        return {
+            nonce: nonceAccount.nonce,
+            address: this.nonceAddress,
+        };
+    }
+    /**
+     * Build a nonceAdvance instruction.
+     *
+     * This MUST be the FIRST instruction in any transaction using a durable nonce.
+     * The Solana runtime recognizes the nonceAdvance instruction and validates
+     * the nonce value as the blockhash.
+     *
+     * @returns TransactionInstruction for SystemProgram.nonceAdvance
+     */
+    buildAdvanceIx() {
+        if (!this.nonceAddress) {
+            throw new Error("Nonce account not loaded. Call load() or create() first.");
+        }
+        return web3_js_1.SystemProgram.nonceAdvance({
+            noncePubkey: this.nonceAddress,
+            authorizedPubkey: this.authority.publicKey,
+        });
+    }
+    /**
+     * Ensure a nonce account exists, prompting the user to create one if needed.
+     *
+     * In non-interactive mode (piped stdin), defaults to false (skip nonce creation).
+     *
+     * @returns true if a nonce account exists (or was just created), false if user declined
+     */
+    async ensureExists() {
+        if (await this.exists()) {
+            return true;
+        }
+        // Check if stdin is interactive (TTY)
+        if (!process.stdin.isTTY) {
+            console.warn("[nonce] No nonce account found. Non-interactive mode — skipping creation.");
+            console.warn("[nonce] Concurrent landing without nonce risks duplicate buys.");
+            return false;
+        }
+        // Prompt the user
+        const answer = await this.promptUser("Concurrent TX landing requires a durable nonce account (~0.0015 SOL).\n" +
+            "Without it, duplicate buys are possible. Create one now? [Y/n] ");
+        const normalized = answer.trim().toLowerCase();
+        if (normalized === "" || normalized === "y" || normalized === "yes") {
+            try {
+                await this.create();
+                return true;
+            }
+            catch (err) {
+                console.error("[nonce] Failed to create nonce account:", err);
+                return false;
+            }
+        }
+        console.warn("[nonce] Nonce creation declined. Concurrent strategy will fall back to race.");
+        return false;
+    }
+    /**
+     * Close the nonce account and reclaim the rent (~0.0015 SOL).
+     *
+     * Withdraws all lamports back to the authority wallet and deletes
+     * the local config files.
+     */
+    async close() {
+        if (!this.nonceAddress) {
+            const config = this.readConfig();
+            if (!config) {
+                throw new Error("No nonce account to close.");
+            }
+            this.nonceAddress = new web3_js_1.PublicKey(config.nonceAccountAddress);
+        }
+        // Get nonce account balance
+        const accountInfo = await this.connection.getAccountInfo(this.nonceAddress);
+        if (!accountInfo) {
+            // Already closed — just clean up config
+            this.deleteConfig();
+            this.nonceAddress = null;
+            this.configLoaded = false;
+            return { txSignature: "", confirmed: true };
+        }
+        const withdrawIx = web3_js_1.SystemProgram.nonceWithdraw({
+            noncePubkey: this.nonceAddress,
+            authorizedPubkey: this.authority.publicKey,
+            toPubkey: this.authority.publicKey,
+            lamports: accountInfo.lamports,
+        });
+        const { blockhash, lastValidBlockHeight } = await this.connection.getLatestBlockhash("confirmed");
+        const message = new web3_js_1.TransactionMessage({
+            payerKey: this.authority.publicKey,
+            recentBlockhash: blockhash,
+            instructions: [withdrawIx],
+        }).compileToV0Message();
+        const tx = new web3_js_1.VersionedTransaction(message);
+        tx.sign([this.authority]);
+        const signature = await this.connection.sendRawTransaction(tx.serialize(), {
+            skipPreflight: false,
+            maxRetries: 3,
+        });
+        await this.connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, "confirmed");
+        const reclaimedSol = accountInfo.lamports / web3_js_1.LAMPORTS_PER_SOL;
+        console.log(`[nonce] Closed nonce account ${this.nonceAddress.toBase58()}. ` +
+            `Reclaimed ${reclaimedSol.toFixed(6)} SOL.`);
+        // Clean up config
+        this.deleteConfig();
+        this.nonceAddress = null;
+        this.configLoaded = false;
+        return { txSignature: signature, confirmed: true };
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Get the nonce account address, if loaded.
+     */
+    getAddress() {
+        return this.nonceAddress;
+    }
+    /**
+     * Prompt the user for input via readline.
+     */
+    promptUser(question) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(question, (answer) => {
+                rl.close();
+                resolve(answer);
+            });
+        });
+    }
+}
+exports.NonceManager = NonceManager;
+//# sourceMappingURL=nonce-manager.js.map

package/dist/transactions/landing/nonce-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce-manager.js","sourceRoot":"","sources":["../../../src/transactions/landing/nonce-manager.ts"],"names":[],"mappings":"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"}

package/dist/transactions/landing/orchestrator.d.ts

@@ -0,0 +1,104 @@
+/**
+ * TX Landing Orchestrator
+ *
+ * Manages multiple TX landing providers and implements submission strategies:
+ * - concurrent: Fire to all enabled providers in parallel (fire-and-forget)
+ *   Uses durable nonce for exactly-once execution safety.
+ * - race: Fire to all, return first accepted result
+ * - random: Pick 1-3 random providers + always include a fallback (nozomi)
+ * - sequential: Try providers in order, stop on first success
+ */
+import { Keypair, TransactionInstruction } from "@solana/web3.js";
+import { NonceManager } from "./nonce-manager";
+import { ILandingProvider, LandingResult, SubmitOptions, OrchestratorConfig } from "./types";
+export declare class LandingOrchestrator {
+    private providers;
+    private config;
+    private nonceManager;
+    constructor(config?: Partial<OrchestratorConfig>);
+    /**
+     * Get all currently enabled providers.
+     */
+    getEnabledProviders(): ILandingProvider[];
+    /**
+     * Get a specific provider by name.
+     */
+    getProvider(name: string): ILandingProvider | undefined;
+    /**
+     * List all registered provider names and their enabled status.
+     */
+    listProviders(): Array<{
+        name: string;
+        enabled: boolean;
+    }>;
+    /**
+     * Set the NonceManager for durable nonce support.
+     * When set, the concurrent strategy will use nonce for exactly-once execution.
+     */
+    setNonceManager(nm: NonceManager): void;
+    /**
+     * Get the current NonceManager, if any.
+     */
+    getNonceManager(): NonceManager | null;
+    /**
+     * Submit a transaction using the configured strategy.
+     */
+    submit(ixs: TransactionInstruction[], signer: Keypair, blockhash: string | {
+        blockhash: string;
+        lastValidBlockHeight: number;
+    }, opts?: Partial<SubmitOptions>): Promise<LandingResult[]>;
+    /**
+     * Fire to all enabled providers in parallel. Returns all results.
+     * This matches the source `concurrent_snipe_tx_landing` behavior.
+     *
+     * When a NonceManager is set, this method:
+     * 1. Fetches the current nonce value from chain
+     * 2. Prepends nonceAdvance as the FIRST instruction
+     * 3. Uses the nonce value as the blockhash
+     * This guarantees exactly-once execution even when 9+ providers receive
+     * the same transaction — the nonce is consumed by the first landing.
+     *
+     * Without nonce: falls back to race strategy with a warning.
+     */
+    private submitConcurrent;
+    /**
+     * Fire to all enabled providers, return on first accepted result.
+     */
+    private submitRace;
+    /**
+     * Pick 1-3 random providers + always include nozomi as fallback.
+     * Matches the source `randomLandTx` behavior.
+     */
+    private submitRandom;
+    /**
+     * Try providers in order, stop on first success.
+     */
+    private submitSequential;
+    /**
+     * Submit with timeout wrapper.
+     */
+    private submitWithTimeout;
+    /**
+     * Resolve provider names to instances, filtering to enabled only.
+     */
+    private getResolvedProviders;
+    /**
+     * Ping all providers that support it (for keep-alive).
+     */
+    pingAll(): Promise<void>;
+}
+/**
+ * Get or create the default orchestrator singleton.
+ *
+ * If a nonce account config exists at ~/.outsmart/nonce.json, the orchestrator
+ * will automatically use it for concurrent landing safety.
+ */
+export declare function getOrchestrator(config?: Partial<OrchestratorConfig>): LandingOrchestrator;
+/**
+ * Convenience: submit via the default orchestrator.
+ */
+export declare function landTransaction(ixs: TransactionInstruction[], signer: Keypair, blockhash: string | {
+    blockhash: string;
+    lastValidBlockHeight: number;
+}, opts?: Partial<SubmitOptions>): Promise<LandingResult[]>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/transactions/landing/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/transactions/landing/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,OAAO,EACP,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAEnB,MAAM,SAAS,CAAC;AAmDjB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAmBhD;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,EAAE;IAOzC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIvD;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAO1D;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAIvC;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACG,MAAM,CACV,GAAG,EAAE,sBAAsB,EAAE,EAC7B,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,EACvE,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,OAAO,CAAC,aAAa,EAAE,CAAC;IAuB3B;;;;;;;;;;;;OAYG;YACW,gBAAgB;IAiE9B;;OAEG;YACW,UAAU;IAiCxB;;;OAGG;YACW,YAAY;IAkC1B;;OAEG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,iBAAiB;IAqB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B;AAQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,mBAAmB,CAWzF;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,sBAAsB,EAAE,EAC7B,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,EACvE,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,OAAO,CAAC,aAAa,EAAE,CAAC,CAE1B"}