@lasersell/lasersell-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Xen LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @lasersell/lasersell-sdk
+
+TypeScript SDK for the LaserSell API.
+
+Modules:
+- `exit-api`: build unsigned buy/sell transactions.
+- `stream`: websocket client, protocol types, and session helpers.
+- `tx`: sign/encode/send Solana transactions.
+- `retry`: shared retry helpers.
+
+## Install
+
+```bash
+npm install @lasersell/lasersell-sdk
+```
+
+For local development in this repository:
+
+```bash
+cd lasersell-sdk/js
+npm install
+```
+
+## API Surface
+
+- LaserSell API client:
+  - `ExitApiClient`
+  - `BuildBuyTxRequest`, `BuildSellTxRequest`, `BuildTxResponse`
+- Stream client and session:
+  - `StreamClient`, `StreamSession`
+  - `StreamConfigure`, `StreamEvent`, `PositionHandle`
+- Stream protocol types (ported inline):
+  - `ClientMessage`, `ServerMessage`, `StrategyConfigMsg`, `MarketContextMsg`
+- Transaction helpers:
+  - `signUnsignedTx`, `encodeSignedTx`
+  - `sendTransaction`, `sendTransactionB64To`
+  - `sendTargetRpc`, `sendTargetHeliusSender`, `sendTargetAstralane`
+
+## Build a sell transaction
+
+```ts
+import { ExitApiClient, type BuildSellTxRequest } from "@lasersell/lasersell-sdk";
+
+const client = ExitApiClient.withApiKey("REPLACE_WITH_API_KEY");
+
+const request: BuildSellTxRequest = {
+  mint: "REPLACE_WITH_MINT",
+  user_pubkey: "REPLACE_WITH_WALLET_PUBKEY",
+  amount_tokens: 1_000_000,
+  slippage_bps: 2_000,
+  output: "SOL",
+};
+
+const response = await client.buildSellTx(request);
+console.log(response.tx);
+```
+
+## Stream + auto-sell flow
+
+```ts
+import {
+  StreamClient,
+  StreamSession,
+  singleWalletStreamConfigureOptional,
+  signUnsignedTx,
+  sendTransaction,
+  sendTargetHeliusSender,
+} from "@lasersell/lasersell-sdk";
+import { Keypair } from "@solana/web3.js";
+
+const client = new StreamClient("REPLACE_WITH_API_KEY");
+const session = await StreamSession.connect(
+  client,
+  singleWalletStreamConfigureOptional(
+    "REPLACE_WITH_WALLET_PUBKEY",
+    {},
+    45, // timeout-only strategy is valid
+  ),
+);
+
+const signer = Keypair.generate();
+
+while (true) {
+  const event = await session.recv();
+  if (event === null) break;
+
+  if (event.type === "exit_signal_with_tx" && event.message.type === "exit_signal_with_tx") {
+    const signed = signUnsignedTx(event.message.unsigned_tx_b64, signer);
+    const signature = await sendTransaction(sendTargetHeliusSender(), signed);
+    console.log(signature);
+  }
+}
+```
+
+`deadline_timeout_sec` is enforced client-side by `StreamSession` timers and is not sent as part of wire strategy.
+Use `session.updateStrategy(...)` when changing strategy so local deadline timers stay in sync (pass a second `deadlineTimeoutSec` argument to change local deadline timing).
+Use `singleWalletStreamConfigureOptional(...)` / `strategyConfigFromOptional(...)` to omit TP/SL fields; at least one of take profit, stop loss, or timeout must be enabled.
+
+## Examples
+
+Runnable examples live in `examples/`:
+
+- `examples/build_buy.ts`: build unsigned buy tx
+- `examples/build_sell.ts`: build unsigned sell tx
+- `examples/build_and_send_sell.ts`: build, sign, and submit sell tx
+- `examples/auto_sell.ts`: stream listener that signs and submits exits
+
+See `examples/README.md` for required placeholders/inputs and exact run commands.
+
+## Build
+
+```bash
+npm run build
+```

package/dist/exitApi.d.ts

@@ -0,0 +1,87 @@
+import { type RetryPolicy } from "./retry.js";
+import type { MarketContextMsg } from "./stream/proto.js";
+export declare const EXIT_API_BASE_URL = "https://api.lasersell.io";
+export declare const LOCAL_EXIT_API_BASE_URL = "http://localhost:8080";
+export declare const EXIT_API_DEFAULTS: {
+    readonly connect_timeout_ms: 200;
+    readonly attempt_timeout_ms: 900;
+    readonly max_attempts: 2;
+    readonly backoff_ms: 25;
+    readonly jitter_ms: 25;
+};
+export type SellOutput = "SOL" | "USD1";
+/** Transaction send mode for the exit API. */
+export type SendMode = "helius_sender" | "astralane" | "rpc";
+export interface BuildSellTxRequest {
+    mint: string;
+    user_pubkey: string;
+    amount_tokens: number;
+    slippage_bps?: number;
+    mode?: string;
+    output?: SellOutput;
+    market_context?: MarketContextMsg;
+    /** Transaction send mode: `"helius_sender"`, `"astralane"`, or `"rpc"`. */
+    send_mode?: SendMode;
+    /** Optional tip amount in lamports for the transaction. */
+    tip_lamports?: number;
+}
+export interface BuildBuyTxRequest {
+    mint: string;
+    user_pubkey: string;
+    amount_quote_units: number;
+    slippage_bps?: number;
+    mode?: string;
+    /** Transaction send mode: `"helius_sender"`, `"astralane"`, or `"rpc"`. */
+    send_mode?: SendMode;
+    /** Optional tip amount in lamports for the transaction. */
+    tip_lamports?: number;
+}
+export interface BuildTxResponse {
+    tx: string;
+    route?: unknown;
+    debug?: unknown;
+}
+export interface ExitApiClientOptions {
+    connect_timeout_ms: number;
+    attempt_timeout_ms: number;
+    retry_policy: RetryPolicy;
+    fetch_impl: FetchLike;
+}
+export type ExitApiErrorKind = "transport" | "http_status" | "envelope_status" | "parse";
+export declare class ExitApiError extends Error {
+    readonly kind: ExitApiErrorKind;
+    readonly status?: number;
+    readonly body?: string;
+    readonly detail?: string;
+    private constructor();
+    static transport(cause: unknown): ExitApiError;
+    static httpStatus(status: number, body: string): ExitApiError;
+    static envelopeStatus(status: string, detail: string): ExitApiError;
+    static parse(message: string, cause?: unknown): ExitApiError;
+    isRetryable(): boolean;
+}
+export declare class ExitApiClient {
+    private readonly apiKey?;
+    private readonly connectTimeoutMs;
+    private readonly attemptTimeoutMs;
+    private readonly retryPolicy;
+    private readonly fetchImpl;
+    private local;
+    private baseUrlOverride?;
+    constructor(apiKey?: string, options?: Partial<ExitApiClientOptions>);
+    static withApiKey(apiKey: string): ExitApiClient;
+    static withOptions(apiKey: string | undefined, options: Partial<ExitApiClientOptions>): ExitApiClient;
+    withLocalMode(local: boolean): this;
+    withBaseUrl(baseUrl: string): this;
+    buildSellTx(request: BuildSellTxRequest): Promise<BuildTxResponse>;
+    buildSellTxB64(request: BuildSellTxRequest): Promise<string>;
+    buildBuyTx(request: BuildBuyTxRequest): Promise<BuildTxResponse>;
+    private buildTx;
+    private endpoint;
+    private baseUrl;
+    private sendAttempt;
+}
+export declare function parseBuildTxResponse(body: string): BuildTxResponse;
+type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+export {};

package/dist/exitApi.js

@@ -0,0 +1,238 @@
+import { LOW_LATENCY_RETRY_POLICY, retryAsync, } from "./retry.js";
+const ERROR_BODY_SNIPPET_LEN = 220;
+export const EXIT_API_BASE_URL = "https://api.lasersell.io";
+export const LOCAL_EXIT_API_BASE_URL = "http://localhost:8080";
+export const EXIT_API_DEFAULTS = {
+    connect_timeout_ms: 200,
+    attempt_timeout_ms: 900,
+    max_attempts: 2,
+    backoff_ms: 25,
+    jitter_ms: 25,
+};
+export class ExitApiError extends Error {
+    kind;
+    status;
+    body;
+    detail;
+    constructor(kind, message, options) {
+        super(message, { cause: options?.cause });
+        this.name = "ExitApiError";
+        this.kind = kind;
+        this.status = options?.status;
+        this.body = options?.body;
+        this.detail = options?.detail;
+    }
+    static transport(cause) {
+        return new ExitApiError("transport", `request failed: ${stringifyError(cause)}`, { cause });
+    }
+    static httpStatus(status, body) {
+        return new ExitApiError("http_status", `http status ${status}: ${body}`, {
+            status,
+            body,
+        });
+    }
+    static envelopeStatus(status, detail) {
+        return new ExitApiError("envelope_status", `exit-api status ${status}: ${detail}`, { detail });
+    }
+    static parse(message, cause) {
+        return new ExitApiError("parse", `failed to parse response: ${message}`, {
+            cause,
+        });
+    }
+    isRetryable() {
+        if (this.kind === "transport") {
+            return true;
+        }
+        if (this.kind === "http_status") {
+            return ((this.status !== undefined && this.status >= 500) || this.status === 429);
+        }
+        return false;
+    }
+}
+export class ExitApiClient {
+    apiKey;
+    connectTimeoutMs;
+    attemptTimeoutMs;
+    retryPolicy;
+    fetchImpl;
+    local = false;
+    baseUrlOverride;
+    constructor(apiKey, options = {}) {
+        this.apiKey = apiKey;
+        this.connectTimeoutMs =
+            options.connect_timeout_ms ?? EXIT_API_DEFAULTS.connect_timeout_ms;
+        this.attemptTimeoutMs =
+            options.attempt_timeout_ms ?? EXIT_API_DEFAULTS.attempt_timeout_ms;
+        this.retryPolicy = options.retry_policy
+            ? { ...options.retry_policy }
+            : {
+                max_attempts: EXIT_API_DEFAULTS.max_attempts,
+                initial_backoff_ms: EXIT_API_DEFAULTS.backoff_ms,
+                max_backoff_ms: EXIT_API_DEFAULTS.backoff_ms,
+                jitter_ms: EXIT_API_DEFAULTS.jitter_ms,
+            };
+        this.fetchImpl = options.fetch_impl ?? globalThis.fetch;
+        if (typeof this.fetchImpl !== "function") {
+            throw new Error("No fetch implementation available. Provide options.fetch_impl in environments without global fetch.");
+        }
+    }
+    static withApiKey(apiKey) {
+        return new ExitApiClient(apiKey);
+    }
+    static withOptions(apiKey, options) {
+        return new ExitApiClient(apiKey, options);
+    }
+    withLocalMode(local) {
+        this.local = local;
+        return this;
+    }
+    withBaseUrl(baseUrl) {
+        this.baseUrlOverride = baseUrl.trim().replace(/\/+$/, "");
+        return this;
+    }
+    async buildSellTx(request) {
+        return await this.buildTx("/v1/sell", request);
+    }
+    async buildSellTxB64(request) {
+        const response = await this.buildSellTx(request);
+        return response.tx;
+    }
+    async buildBuyTx(request) {
+        return await this.buildTx("/v1/buy", request);
+    }
+    async buildTx(path, request) {
+        const endpoint = this.endpoint(path);
+        return await retryAsync(this.retryPolicy, async () => await this.sendAttempt(endpoint, request), (error) => error instanceof ExitApiError && error.isRetryable());
+    }
+    endpoint(path) {
+        return `${this.baseUrl()}${path}`;
+    }
+    baseUrl() {
+        if (this.baseUrlOverride !== undefined) {
+            return this.baseUrlOverride;
+        }
+        if (this.local) {
+            return LOCAL_EXIT_API_BASE_URL;
+        }
+        return EXIT_API_BASE_URL;
+    }
+    async sendAttempt(endpoint, request) {
+        const timeoutMs = Math.max(this.connectTimeoutMs, this.attemptTimeoutMs);
+        const controller = new AbortController();
+        const timer = setTimeout(() => {
+            controller.abort();
+        }, timeoutMs);
+        try {
+            const headers = {
+                "content-type": "application/json",
+            };
+            if (this.apiKey !== undefined) {
+                headers["x-api-key"] = this.apiKey;
+            }
+            const response = await this.fetchImpl(endpoint, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(request),
+                signal: controller.signal,
+            });
+            const body = await response.text();
+            if (!response.ok) {
+                throw ExitApiError.httpStatus(response.status, summarizeErrorBody(body));
+            }
+            return parseBuildTxResponse(body);
+        }
+        catch (error) {
+            if (error instanceof ExitApiError) {
+                throw error;
+            }
+            throw ExitApiError.transport(error);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+export function parseBuildTxResponse(body) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch (error) {
+        throw ExitApiError.parse("response was not valid JSON", error);
+    }
+    const obj = asRecord(parsed, "response");
+    const taggedStatus = asOptionalString(obj.status);
+    if (taggedStatus !== undefined) {
+        if (taggedStatus.toLowerCase() === "ok") {
+            const tx = asOptionalString(obj.tx) ?? asOptionalString(obj.unsigned_tx_b64);
+            if (tx === undefined) {
+                throw ExitApiError.parse("status=ok payload missing tx");
+            }
+            return {
+                tx,
+                route: obj.route,
+                debug: obj.debug,
+            };
+        }
+        const detail = asOptionalString(obj.reason) ??
+            asOptionalString(obj.message) ??
+            asOptionalString(obj.error) ??
+            "unknown failure";
+        throw ExitApiError.envelopeStatus(taggedStatus, detail);
+    }
+    const legacyTx = asOptionalString(obj.unsigned_tx_b64);
+    if (legacyTx !== undefined) {
+        return {
+            tx: legacyTx,
+            route: obj.route,
+            debug: obj.debug,
+        };
+    }
+    const bareTx = asOptionalString(obj.tx);
+    if (bareTx !== undefined) {
+        return {
+            tx: bareTx,
+            route: obj.route,
+            debug: obj.debug,
+        };
+    }
+    throw ExitApiError.parse("response did not match any supported schema");
+}
+function summarizeErrorBody(body) {
+    try {
+        const parsed = JSON.parse(body);
+        const obj = asRecord(parsed, "error body");
+        const message = asOptionalString(obj.error) ??
+            asOptionalString(obj.message) ??
+            asOptionalString(obj.reason);
+        if (message !== undefined) {
+            return message;
+        }
+    }
+    catch {
+        // Ignore JSON parse errors and fall back to body snippet.
+    }
+    return body.slice(0, ERROR_BODY_SNIPPET_LEN);
+}
+function asRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw ExitApiError.parse(`${path} must be an object`);
+    }
+    return value;
+}
+function asOptionalString(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    return undefined;
+}
+function stringifyError(error) {
+    if (error instanceof Error) {
+        return `${error.name}: ${error.message}`;
+    }
+    return String(error);
+}
+export const DEFAULT_RETRY_POLICY = {
+    ...LOW_LATENCY_RETRY_POLICY,
+};
+//# sourceMappingURL=exitApi.js.map

package/dist/exitApi.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./exitApi.js";
+export * from "./retry.js";
+export * from "./tx.js";
+export * from "./stream/index.js";
+export * as stream from "./stream/index.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./exitApi.js";
+export * from "./retry.js";
+export * from "./tx.js";
+export * from "./stream/index.js";
+export * as stream from "./stream/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"}

package/dist/retry.d.ts

@@ -0,0 +1,15 @@
+export interface RetryPolicy {
+    max_attempts: number;
+    initial_backoff_ms: number;
+    max_backoff_ms: number;
+    jitter_ms: number;
+}
+export declare const LOW_LATENCY_RETRY_POLICY: RetryPolicy;
+export declare function lowLatencyRetryPolicy(): RetryPolicy;
+export declare function delayForAttempt(policy: RetryPolicy, attempt: number): number;
+export declare function retryAsync<T, E>(policy: RetryPolicy, op: (attempt: number) => Promise<T>, shouldRetry: (error: E) => boolean): Promise<T>;
+export declare class TimeoutError extends Error {
+    readonly timeout_ms: number;
+    constructor(timeoutMs: number, message?: string);
+}
+export declare function withTimeout<T>(timeoutMs: number, promise: Promise<T>): Promise<T>;

package/dist/retry.js

@@ -0,0 +1,74 @@
+export const LOW_LATENCY_RETRY_POLICY = {
+    max_attempts: 2,
+    initial_backoff_ms: 25,
+    max_backoff_ms: 100,
+    jitter_ms: 25,
+};
+export function lowLatencyRetryPolicy() {
+    return { ...LOW_LATENCY_RETRY_POLICY };
+}
+export function delayForAttempt(policy, attempt) {
+    let delay = Math.max(0, policy.initial_backoff_ms);
+    for (let i = 1; i < attempt; i += 1) {
+        delay = Math.min(delay * 2, Math.max(0, policy.max_backoff_ms));
+    }
+    return delay + jitterDurationMs(Math.max(0, policy.jitter_ms));
+}
+export async function retryAsync(policy, op, shouldRetry) {
+    const maxAttempts = Math.max(1, policy.max_attempts);
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        try {
+            return await op(attempt);
+        }
+        catch (error) {
+            const typedError = error;
+            if (attempt >= maxAttempts || !shouldRetry(typedError)) {
+                throw typedError;
+            }
+            const delay = delayForAttempt(policy, attempt);
+            if (delay > 0) {
+                await sleep(delay);
+            }
+        }
+    }
+    throw new Error("retryAsync reached an unreachable state");
+}
+export class TimeoutError extends Error {
+    timeout_ms;
+    constructor(timeoutMs, message = "operation timed out") {
+        super(message);
+        this.name = "TimeoutError";
+        this.timeout_ms = timeoutMs;
+    }
+}
+export async function withTimeout(timeoutMs, promise) {
+    if (timeoutMs <= 0) {
+        return promise;
+    }
+    return await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new TimeoutError(timeoutMs));
+        }, timeoutMs);
+        promise
+            .then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        })
+            .catch((error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+function jitterDurationMs(maxJitterMs) {
+    if (maxJitterMs <= 0) {
+        return 0;
+    }
+    return Math.floor(Math.random() * (maxJitterMs + 1));
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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