@lasersell/lasersell-sdk 0.1.0

package/dist/stream/session.js

@@ -0,0 +1,243 @@
+import { strategyConfigFromOptional, validateStrategyAndDeadline, } from "./client.js";
+export class StreamSession {
+    connection;
+    positionsById = new Map();
+    strategy;
+    deadlineTimeoutSec;
+    deadlineTimers = new Map();
+    openedAtMs = new Map();
+    constructor(connection, strategy, deadlineTimeoutSec) {
+        this.connection = connection;
+        this.strategy = { ...strategy };
+        this.deadlineTimeoutSec = Math.max(0, deadlineTimeoutSec);
+    }
+    static async connect(client, configure) {
+        const connection = await client.connect(configure);
+        return StreamSession.fromConnection(connection, configure.strategy, configure.deadline_timeout_sec ?? 0);
+    }
+    static fromConnection(connection, strategy = defaultStrategy(), deadlineTimeoutSec = 0) {
+        return new StreamSession(connection, strategy, deadlineTimeoutSec);
+    }
+    sender() {
+        return this.connection.sender();
+    }
+    positions() {
+        return [...this.positionsById.values()].map((position) => ({ ...position }));
+    }
+    positionsForWalletMint(wallet, mint) {
+        return this.positions()
+            .filter((position) => position.wallet_pubkey === wallet && position.mint === mint)
+            .map((position) => ({ ...position }));
+    }
+    close(handle) {
+        if (handle !== undefined) {
+            this.sender().closePosition(positionHandleToSelector(handle));
+            return;
+        }
+        this.cancelAllDeadlines();
+        this.connection.close();
+    }
+    requestExitSignal(handle, slippage_bps) {
+        this.sender().requestExitSignal(positionHandleToSelector(handle), slippage_bps);
+    }
+    updateStrategy(strategy, deadlineTimeoutSec = this.deadlineTimeoutSec) {
+        validateStrategyAndDeadline(strategy, deadlineTimeoutSec);
+        this.strategy = { ...strategy };
+        this.deadlineTimeoutSec = Math.max(0, deadlineTimeoutSec);
+        this.rescheduleAllDeadlines();
+        this.sender().updateStrategy({ ...strategy });
+    }
+    updateStrategyOptional(strategy = {}, deadlineTimeoutSec = this.deadlineTimeoutSec) {
+        this.updateStrategy(strategyConfigFromOptional(strategy), deadlineTimeoutSec);
+    }
+    async recv() {
+        const message = await this.connection.recv();
+        if (message === null) {
+            return null;
+        }
+        return this.applyMessage(message);
+    }
+    applyMessage(message) {
+        switch (message.type) {
+            case "position_opened": {
+                const handle = {
+                    position_id: message.position_id,
+                    token_account: message.token_account,
+                    wallet_pubkey: message.wallet_pubkey,
+                    mint: message.mint,
+                    token_program: message.token_program,
+                    tokens: message.tokens,
+                    entry_quote_units: message.entry_quote_units,
+                };
+                this.positionsById.set(message.position_id, handle);
+                this.armDeadline(handle.token_account);
+                return {
+                    type: "position_opened",
+                    handle: { ...handle },
+                    message,
+                };
+            }
+            case "position_closed": {
+                const handle = this.removePosition(message.position_id, message.token_account);
+                const tokenAccount = handle?.token_account ?? message.token_account;
+                if (tokenAccount !== undefined) {
+                    this.cancelDeadlineFor(tokenAccount);
+                }
+                return {
+                    type: "position_closed",
+                    handle: handle === undefined ? undefined : { ...handle },
+                    message,
+                };
+            }
+            case "exit_signal_with_tx": {
+                const handle = this.findPosition(message.position_id, message.token_account);
+                return {
+                    type: "exit_signal_with_tx",
+                    handle: handle === undefined ? undefined : { ...handle },
+                    message,
+                };
+            }
+            case "pnl_update": {
+                const handle = this.findPosition(message.position_id);
+                return {
+                    type: "pnl_update",
+                    handle: handle === undefined ? undefined : { ...handle },
+                    message,
+                };
+            }
+            default: {
+                return {
+                    type: "message",
+                    message,
+                };
+            }
+        }
+    }
+    findPosition(positionId, tokenAccount) {
+        const byId = this.positionsById.get(positionId);
+        if (byId !== undefined) {
+            return byId;
+        }
+        if (tokenAccount === undefined) {
+            return undefined;
+        }
+        for (const handle of this.positionsById.values()) {
+            if (handle.token_account === tokenAccount) {
+                return handle;
+            }
+        }
+        return undefined;
+    }
+    removePosition(positionId, tokenAccount) {
+        const byId = this.positionsById.get(positionId);
+        if (byId !== undefined) {
+            this.positionsById.delete(positionId);
+            return byId;
+        }
+        if (tokenAccount === undefined) {
+            return undefined;
+        }
+        for (const [id, handle] of this.positionsById.entries()) {
+            if (handle.token_account === tokenAccount) {
+                this.positionsById.delete(id);
+                return handle;
+            }
+        }
+        return undefined;
+    }
+    deadlineMs() {
+        const raw = this.deadlineTimeoutSec;
+        const sec = Number.isFinite(raw) ? Math.max(0, raw) : 0;
+        return sec * 1_000;
+    }
+    armDeadline(tokenAccount) {
+        this.cancelDeadlineTimer(tokenAccount);
+        const deadlineMs = this.deadlineMs();
+        const openedAt = Date.now();
+        this.openedAtMs.set(tokenAccount, openedAt);
+        if (deadlineMs === 0) {
+            return;
+        }
+        this.scheduleDeadline(tokenAccount, deadlineMs);
+    }
+    rescheduleAllDeadlines() {
+        this.cancelAllDeadlineTimers();
+        const deadlineMs = this.deadlineMs();
+        if (deadlineMs === 0) {
+            return;
+        }
+        const now = Date.now();
+        const tokenAccounts = new Set([...this.positionsById.values()].map((position) => position.token_account));
+        for (const tokenAccount of tokenAccounts) {
+            const openedAt = this.openedAtMs.get(tokenAccount) ?? now;
+            this.openedAtMs.set(tokenAccount, openedAt);
+            const remaining = openedAt + deadlineMs - now;
+            if (remaining <= 0) {
+                queueMicrotask(() => {
+                    this.tryRequestExitSignal(tokenAccount);
+                });
+                continue;
+            }
+            this.scheduleDeadline(tokenAccount, remaining);
+        }
+    }
+    scheduleDeadline(tokenAccount, delayMs) {
+        const timer = setTimeout(() => {
+            this.deadlineTimers.delete(tokenAccount);
+            this.tryRequestExitSignal(tokenAccount);
+        }, Math.max(0, delayMs));
+        this.deadlineTimers.set(tokenAccount, timer);
+    }
+    tryRequestExitSignal(tokenAccount) {
+        if (!this.hasOpenPositionForTokenAccount(tokenAccount)) {
+            return;
+        }
+        try {
+            this.sender().requestExitSignal(tokenAccount);
+        }
+        catch {
+            // Ignore timer callback failures to avoid crashing caller loops.
+        }
+    }
+    hasOpenPositionForTokenAccount(tokenAccount) {
+        for (const handle of this.positionsById.values()) {
+            if (handle.token_account === tokenAccount) {
+                return true;
+            }
+        }
+        return false;
+    }
+    cancelDeadlineFor(tokenAccount) {
+        this.cancelDeadlineTimer(tokenAccount);
+        this.openedAtMs.delete(tokenAccount);
+    }
+    cancelDeadlineTimer(tokenAccount) {
+        const timer = this.deadlineTimers.get(tokenAccount);
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            this.deadlineTimers.delete(tokenAccount);
+        }
+    }
+    cancelAllDeadlineTimers() {
+        for (const timer of this.deadlineTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.deadlineTimers.clear();
+    }
+    cancelAllDeadlines() {
+        this.cancelAllDeadlineTimers();
+        this.openedAtMs.clear();
+    }
+}
+function positionHandleToSelector(handle) {
+    return {
+        token_account: handle.token_account,
+    };
+}
+function defaultStrategy() {
+    return {
+        target_profit_pct: 0,
+        stop_loss_pct: 0,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/stream/session.js.map

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

package/dist/tx.d.ts

@@ -0,0 +1,85 @@
+import { VersionedTransaction, type Signer } from "@solana/web3.js";
+export declare const HELIUS_SENDER_BASE_URL = "https://sender.helius-rpc.com";
+export declare const HELIUS_SENDER_FAST_URL = "https://sender.helius-rpc.com/fast";
+export declare const HELIUS_SENDER_PING_URL = "https://sender.helius-rpc.com/ping";
+/** Default Astralane Iris region (Frankfurt). */
+export declare const ASTRALANE_DEFAULT_REGION = "fr";
+/**
+ * Builds the Astralane Iris endpoint URL for a given region.
+ *
+ * Known regions: `fr` (Frankfurt, recommended), `fr2`, `la` (San Francisco),
+ * `jp` (Tokyo), `ny` (New York), `ams` (Amsterdam, recommended), `ams2`,
+ * `lim` (Limburg), `sg` (Singapore), `lit` (Lithuania).
+ */
+export declare function astralaneIrisUrl(region: string): string;
+/** Unified send target that selects the transaction submission endpoint. */
+export type SendTarget = {
+    kind: "rpc";
+    url: string;
+} | {
+    kind: "helius_sender";
+} | {
+    kind: "astralane";
+    apiKey: string;
+    region?: string;
+};
+/** Creates an RPC send target. */
+export declare function sendTargetRpc(url: string): SendTarget;
+/** Creates a Helius Sender send target. */
+export declare function sendTargetHeliusSender(): SendTarget;
+/** Creates an Astralane Iris send target. */
+export declare function sendTargetAstralane(apiKey: string, region?: string): SendTarget;
+/** Submits a signed transaction via the specified send target. */
+export declare function sendTransaction(target: SendTarget, tx: VersionedTransaction, options?: SendTransactionOptions): Promise<string>;
+/** Submits a signed base64-encoded transaction via the specified send target. */
+export declare function sendTransactionB64To(target: SendTarget, txB64: string, options?: SendTransactionOptions): Promise<string>;
+/** Signs an unsigned base64 transaction and sends via the specified send target. */
+export declare function signAndSendUnsignedTxB64(target: SendTarget, unsignedTxB64: string, signer: Signer, options?: SendTransactionOptions): Promise<string>;
+export type TxSubmitErrorKind = "decode_unsigned_tx" | "deserialize_unsigned_tx" | "sign_tx" | "serialize_tx" | "request_send" | "response_read" | "http_status" | "decode_response" | "rpc_error" | "missing_result";
+export declare class TxSubmitError extends Error {
+    readonly kind: TxSubmitErrorKind;
+    readonly target?: string;
+    readonly status?: number;
+    readonly body?: string;
+    private constructor();
+    static decodeUnsignedTx(cause: unknown): TxSubmitError;
+    static deserializeUnsignedTx(cause: unknown): TxSubmitError;
+    static signTx(cause: unknown): TxSubmitError;
+    static serializeTx(cause: unknown): TxSubmitError;
+    static requestSend(target: string, cause: unknown): TxSubmitError;
+    static responseRead(target: string, cause: unknown): TxSubmitError;
+    static httpStatus(target: string, status: number, body: string): TxSubmitError;
+    static decodeResponse(target: string, body: string, cause: unknown): TxSubmitError;
+    static rpcError(target: string, error: string): TxSubmitError;
+    static missingResult(target: string, response: string): TxSubmitError;
+}
+export declare function signUnsignedTx(unsignedTxB64: string, signer: Signer): VersionedTransaction;
+/**
+ * Fast-path signer for LaserSell-provided unsigned transactions.
+ *
+ * Unlike `signUnsignedTx` (which deserializes into a `VersionedTransaction`), this method:
+ * 1) base64-decodes the transaction
+ * 2) signs the raw message bytes
+ * 3) patches the signature bytes in-place
+ * 4) re-encodes to base64
+ *
+ * This avoids `VersionedTransaction.deserialize()` and `tx.serialize()` on the hot path.
+ */
+export declare function signUnsignedTxB64Fast(unsignedTxB64: string, signer: Signer): string;
+export declare function encodeSignedTx(tx: VersionedTransaction): string;
+export interface SendTransactionOptions {
+    fetch_impl?: FetchLike;
+}
+export declare function pingHeliusSender(options?: {
+    baseUrl?: string;
+    fetch_impl?: FetchLike;
+}): Promise<boolean>;
+export declare function startHeliusSenderWarmLoop(options?: {
+    baseUrl?: string;
+    intervalMs?: number;
+    fetch_impl?: FetchLike;
+}): {
+    stop: () => void;
+};
+type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export {};