@switch-win/sdk 1.2.8 → 1.3.0

package/dist/gasless-operators.js

@@ -0,0 +1,132 @@
+import { Contract, Interface, verifyTypedData } from "ethers";
+import { GASLESS_OPERATOR_ROLE, GASLESS_SWITCH_ABI, GaslessError, gaslessAddress, gaslessUint, getGaslessSigningParams, readGaslessChainState, sameAddress, validateGaslessConfig, } from "./gasless.js";
+/** Never infer gasless from a symbol, short deadline, orderType label, or legacy array. */
+export function classifySwitchOrder(order, config, deployment) {
+    validateGaslessConfig(config, deployment);
+    if (sameAddress(order.limitOrderContract, deployment.contract))
+        return "gasless";
+    if (sameAddress(order.limitOrderContract, config.limitOrderContract))
+        return "limit-order";
+    return "unsupported";
+}
+export function selectGaslessPriorityOrders(orders, config, deployment, chainTimestamp) {
+    if (!Number.isSafeInteger(chainTimestamp) || chainTimestamp <= 0)
+        throw new GaslessError("INVALID_TIMESTAMP", "A chain timestamp is required.");
+    const seen = new Set();
+    return orders
+        .filter((order) => {
+        const key = `${order.limitOrderContract?.toLowerCase()}:${order.maker.toLowerCase()}:${order.nonce}`;
+        if (classifySwitchOrder(order, config, deployment) !== "gasless" ||
+            order.status !== "ACTIVE" ||
+            !Number.isSafeInteger(order.deadline) ||
+            order.deadline <= chainTimestamp ||
+            seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    })
+        .sort((a, b) => a.deadline - b.deadline || a.nonce - b.nonce);
+}
+/** Gasless V2 fixes the excess side from the maker's signed fee mode. */
+export function gaslessExcessOnInput(feeOnOutput) {
+    if (typeof feeOnOutput !== "boolean")
+        throw new GaslessError("INVALID_FEE_MODE", "The signed fee mode is required.");
+    return !feeOnOutput;
+}
+/** Nominal cap before payout transfer tax. Gas is part of this payout, never an add-on. */
+export function cappedGaslessPayout(availableSurplus, afterFeeBase) {
+    if (afterFeeBase <= 0n || availableSurplus <= 0n)
+        return 0n;
+    const cap = (afterFeeBase * 5n) / 10000n;
+    return availableSurplus < cap ? availableSurplus : cap;
+}
+/** Use measured after-tax payout valued via an executable payout-token/native route. */
+export function assessGaslessOperatorProfit(payoutNative, gasLimit, gasPrice, minimumNetNative = 0n) {
+    if (payoutNative < 0n ||
+        gasLimit <= 0n ||
+        gasPrice <= 0n ||
+        minimumNetNative < 0n)
+        throw new GaslessError("INVALID_GAS", "Invalid payout or full gas budget.");
+    const gasBudgetNative = gasLimit * gasPrice;
+    const netNative = payoutNative - gasBudgetNative;
+    return {
+        eligible: netNative > 0n && netNative >= minimumNetNative,
+        gasBudgetNative,
+        netNative,
+    };
+}
+export async function assertGaslessOperator(provider, deployment, operator) {
+    const state = await readGaslessChainState(provider, deployment);
+    const c = new Contract(deployment.contract, GASLESS_SWITCH_ABI, provider);
+    if (!(await c.hasRole(GASLESS_OPERATOR_ROLE, gaslessAddress(operator), {
+        blockTag: state.blockNumber,
+    })))
+        throw new GaslessError("OPERATOR_NOT_APPROVED", "This operator is not registered on the gasless settlement contract.");
+}
+/** Encode already-built execution routes. This does NOT quote, simulate, or establish profitability. */
+export function encodeGaslessFill(input) {
+    const { deployment, order, signature, routes } = input;
+    if (!Number.isSafeInteger(order.nonce) ||
+        order.nonce < 0 ||
+        !Number.isSafeInteger(order.deadline) ||
+        !Number.isSafeInteger(input.chainTimestamp) ||
+        order.deadline <= input.chainTimestamp ||
+        order.deadline === 0 ||
+        typeof order.unwrapOutput !== "boolean" ||
+        (order.unwrapOutput &&
+            !sameAddress(order.tokenOut, deployment.wrappedNative)))
+        throw new GaslessError("INVALID_ORDER", "Invalid or expired gasless order.");
+    [order.maker, order.tokenIn, order.tokenOut, order.recipient].forEach((a) => gaslessAddress(a));
+    gaslessAddress(order.partnerAddress, true);
+    gaslessUint(order.minAmountOut);
+    if (sameAddress(order.tokenIn, order.tokenOut) ||
+        sameAddress(order.recipient, deployment.contract))
+        throw new GaslessError("INVALID_ORDER", "Invalid gasless token pair or recipient.");
+    const { domain, types } = getGaslessSigningParams(deployment);
+    if (!sameAddress(verifyTypedData(domain, types, order, signature), order.maker))
+        throw new GaslessError("INVALID_SIGNATURE", "Gasless signature does not match the maker.");
+    let total = 0n;
+    if (!routes.length || routes.length > 16)
+        throw new GaslessError("INVALID_ROUTE", "Execution routes are required.");
+    for (const route of routes) {
+        const amount = gaslessUint(String(route.amountIn));
+        total += amount;
+        if (!route.hops.length ||
+            route.hops.length > 8 ||
+            !sameAddress(route.hops[0].tokenIn, order.tokenIn) ||
+            !sameAddress(route.hops[route.hops.length - 1].tokenOut, order.tokenOut))
+            throw new GaslessError("INVALID_ROUTE", "Route endpoints do not match the order.");
+        let previous = order.tokenIn;
+        for (const hop of route.hops) {
+            if (!sameAddress(hop.tokenIn, previous) || !hop.legs.length)
+                throw new GaslessError("INVALID_ROUTE", "Disconnected execution route.");
+            previous = gaslessAddress(hop.tokenOut);
+            for (const leg of hop.legs) {
+                gaslessAddress(leg.adapter);
+                gaslessUint(String(leg.amountIn));
+            }
+        }
+    }
+    const amountIn = gaslessUint(order.amountIn);
+    if (order.feeOnOutput) {
+        if (total !== amountIn)
+            throw new GaslessError("INVALID_ROUTE", "Output-fee gasless orders route the full signed input.");
+    }
+    else {
+        const received = gaslessUint(input.receivedInput);
+        const available = received - (received * 10n) / 10000n;
+        if (received > amountIn || total > available)
+            throw new GaslessError("INVALID_ROUTE", "Input-fee routes exceed the measured after-fee input.");
+    }
+    return {
+        to: deployment.contract,
+        data: new Interface(GASLESS_SWITCH_ABI).encodeFunctionData("fillOrder", [
+            order,
+            signature,
+            routes,
+            gaslessExcessOnInput(order.feeOnOutput),
+        ]),
+        value: "0",
+    };
+}
+//# sourceMappingURL=gasless-operators.js.map

package/dist/gasless-operators.js.map

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

package/dist/gasless-store.d.ts

@@ -0,0 +1,18 @@
+import type { LimitOrderNetwork } from "./limit-orders.js";
+import type { GaslessPendingStore, PendingGaslessOrder } from "./gasless-types.js";
+export interface GaslessStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface GaslessLockManager {
+    request<T>(name: string, callback: () => T | PromiseLike<T>): Promise<T>;
+}
+/** Invalid storage must block new orders rather than silently discarding a live signature. */
+export declare function parseGaslessPending(value: string, network: LimitOrderNetwork, maker: string): PendingGaslessOrder;
+/** Browser store serializes tabs using Web Locks and persists orders across reloads. */
+export declare function createGaslessBrowserStore(network: LimitOrderNetwork, makerInput: string, options?: {
+    storage?: GaslessStorage;
+    locks?: GaslessLockManager;
+}): GaslessPendingStore;
+//# sourceMappingURL=gasless-store.d.ts.map

package/dist/gasless-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasless-store.d.ts","sourceRoot":"","sources":["../src/gasless-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAS5B,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1E;AAMD,8FAA8F;AAC9F,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAmCrB;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACvB,GACL,mBAAmB,CA2DrB"}

package/dist/gasless-store.js

@@ -0,0 +1,83 @@
+import { GASLESS_DEPLOYMENTS, GaslessError, gaslessAddress, gaslessUint, sameAddress, } from "./gasless.js";
+function identity(p) {
+    return `${p.chainId}:${p.contract.toLowerCase()}:${p.order.maker.toLowerCase()}:${p.order.nonce}`;
+}
+/** Invalid storage must block new orders rather than silently discarding a live signature. */
+export function parseGaslessPending(value, network, maker) {
+    try {
+        const p = JSON.parse(value);
+        if (p.network !== network ||
+            p.chainId !== GASLESS_DEPLOYMENTS[network].chainId ||
+            !sameAddress(p.order.maker, maker) ||
+            !Number.isSafeInteger(p.order.nonce) ||
+            p.order.nonce < 0 ||
+            !Number.isSafeInteger(p.order.deadline) ||
+            p.order.deadline <= 0 ||
+            typeof p.order.feeOnOutput !== "boolean" ||
+            typeof p.order.unwrapOutput !== "boolean" ||
+            !["signing", "submitting", "submitted", "uncertain"].includes(p.state) ||
+            (p.state !== "signing" && !p.signature) ||
+            (p.signature !== undefined && !/^0x[\da-f]{130}$/i.test(p.signature)))
+            throw Error();
+        [
+            p.contract,
+            p.order.maker,
+            p.order.tokenIn,
+            p.order.tokenOut,
+            p.order.recipient,
+        ].forEach((a) => gaslessAddress(a));
+        gaslessAddress(p.order.partnerAddress, true);
+        gaslessUint(p.order.amountIn);
+        gaslessUint(p.order.minAmountOut);
+        return p;
+    }
+    catch {
+        throw new GaslessError("PENDING_STORAGE_INVALID", "Saved gasless order data is invalid. Recover its status before starting another swap.");
+    }
+}
+/** Browser store serializes tabs using Web Locks and persists orders across reloads. */
+export function createGaslessBrowserStore(network, makerInput, options = {}) {
+    const maker = gaslessAddress(makerInput);
+    const storage = options.storage ?? globalThis.localStorage;
+    const locks = options.locks ?? globalThis.navigator?.locks;
+    if (!storage || !locks)
+        throw new GaslessError("PENDING_STORAGE_UNAVAILABLE", "Durable storage and Web Locks are required. Supply an atomic application store in this environment.");
+    const key = `switch:sdk:gasless-pending:${GASLESS_DEPLOYMENTS[network].chainId}:${maker.toLowerCase()}`;
+    const load = () => {
+        const value = storage.getItem(key);
+        return value === null ? null : parseGaslessPending(value, network, maker);
+    };
+    const check = (p) => parseGaslessPending(JSON.stringify(p), network, maker);
+    return {
+        async load() {
+            return load();
+        },
+        async reserve(pending) {
+            await locks.request(key, () => {
+                if (load())
+                    throw new GaslessError("ORDER_PENDING", "Another gasless order is pending in this browser.");
+                storage.setItem(key, JSON.stringify(check(pending)));
+            });
+        },
+        async update(pending) {
+            await locks.request(key, () => {
+                const current = load();
+                if (!current || identity(current) !== identity(pending))
+                    throw new GaslessError("PENDING_ORDER_CHANGED", "Saved pending order changed.");
+                if (JSON.stringify(current.order) !== JSON.stringify(pending.order))
+                    throw new GaslessError("PENDING_ORDER_CHANGED", "Cannot change a pending order's signed fields.");
+                if (current.signature && current.signature !== pending.signature)
+                    throw new GaslessError("PENDING_ORDER_CHANGED", "Cannot replace a saved signature.");
+                storage.setItem(key, JSON.stringify(check(pending)));
+            });
+        },
+        async release(pending) {
+            await locks.request(key, () => {
+                const current = load();
+                if (current && identity(current) === identity(pending))
+                    storage.removeItem(key);
+            });
+        },
+    };
+}
+//# sourceMappingURL=gasless-store.js.map

package/dist/gasless-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasless-store.js","sourceRoot":"","sources":["../src/gasless-store.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AAYtB,SAAS,QAAQ,CAAC,CAAsB;IACtC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;AACpG,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,OAA0B,EAC1B,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAwB,CAAC;QACnD,IACE,CAAC,CAAC,OAAO,KAAK,OAAO;YACrB,CAAC,CAAC,OAAO,KAAK,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO;YAClD,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC;YAClC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;YACpC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC;YACjB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YACvC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC;YACrB,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;YACxC,OAAO,CAAC,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS;YACzC,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;YACtE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YACvC,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAErE,MAAM,KAAK,EAAE,CAAC;QAChB;YACE,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,KAAK,CAAC,KAAK;YACb,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,KAAK,CAAC,QAAQ;YAChB,CAAC,CAAC,KAAK,CAAC,SAAS;SAClB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC7C,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CACpB,yBAAyB,EACzB,uFAAuF,CACxF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CACvC,OAA0B,EAC1B,UAAkB,EAClB,UAGI,EAAE;IAEN,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC;IAC3D,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;QACpB,MAAM,IAAI,YAAY,CACpB,6BAA6B,EAC7B,qGAAqG,CACtG,CAAC;IACJ,MAAM,GAAG,GAAG,8BAA8B,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IACxG,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5E,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,CAAsB,EAAE,EAAE,CACvC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE;gBAC5B,IAAI,IAAI,EAAE;oBACR,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,mDAAmD,CACpD,CAAC;gBACJ,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO;YAClB,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE;gBAC5B,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC;oBACrD,MAAM,IAAI,YAAY,CACpB,uBAAuB,EACvB,8BAA8B,CAC/B,CAAC;gBACJ,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;oBACjE,MAAM,IAAI,YAAY,CACpB,uBAAuB,EACvB,gDAAgD,CACjD,CAAC;gBACJ,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS;oBAC9D,MAAM,IAAI,YAAY,CACpB,uBAAuB,EACvB,mCAAmC,CACpC,CAAC;gBACJ,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE;gBAC5B,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;gBACvB,IAAI,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC;oBACpD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/gasless-types.d.ts

@@ -0,0 +1,218 @@
+import type { BestPathResponse, LimitOrderParams, LimitOrderRecord } from "./types.js";
+import type { LimitOrderNetwork } from "./limit-orders.js";
+export interface GaslessDeployment {
+    network: LimitOrderNetwork;
+    chainId: number;
+    contract: string;
+    router: string;
+    wrappedNative: string;
+    explorer: string;
+}
+export type GaslessEligibilityReason = "READY" | "NOT_REQUESTED" | "EXECUTION_UNVERIFIED" | "PAYOUT_UNVALUED" | "GAS_NOT_COVERED" | "INSUFFICIENT_SAFETY_MARGIN" | "OPERATOR_GAS_UNAVAILABLE" | "NO_APPROVED_OPERATOR" | "SLIPPAGE_BUFFER_TOO_SMALL" | "STALE_PREVIEW";
+/** Server recommendation; all native Wei values are decimal strings. */
+export interface GaslessEligibility {
+    policyVersion: 1;
+    status: "eligible" | "ineligible" | "unavailable" | "not_checked";
+    eligible: boolean;
+    recommendation: "gasless" | "regular";
+    reasonCode: GaslessEligibilityReason;
+    reason: string;
+    nativeSymbol: "PLS" | "ETH";
+    protocolFeeBps: 10;
+    maxOperatorPayoutBps: 5;
+    requiredGasCoverageBps: 20000;
+    payoutValuationHaircutBps: 1000;
+    minimumSlippageBps: 50;
+    /** Registration and a funded wallet do not prove a worker is online. */
+    operatorLivenessVerified: false;
+    /** Milliseconds since the Unix epoch. */
+    checkedAt: number;
+    /** Milliseconds since the Unix epoch. */
+    expiresAt: number;
+    economics?: {
+        estimatedGasUnits: string;
+        gasLimit: string;
+        gasPriceWei: string;
+        estimatedGasCostNativeWei: string;
+        estimatedGasCostNative: string;
+        operatorPayoutNativeWei: string;
+        operatorPayoutNative: string;
+        gasBudgetNativeWei: string;
+        gasBudgetNative: string;
+        conservativeGasBudgetNativeWei: string;
+        conservativeGasBudgetNative: string;
+        stressedOperatorPayoutNativeWei: string;
+        requiredOperatorPayoutNativeWei: string;
+        requiredOperatorPayoutNative: string;
+        payoutToGasCoverageBps: string;
+        /** Signed: negative values mean the payout does not cover the budget. */
+        netAfterGasBudgetNativeWei: string;
+        shortfallNativeWei: string;
+        gasCovered: boolean;
+        safetyMarginCovered: boolean;
+    };
+    operator?: {
+        address: string;
+        nativeBalanceWei: string;
+        gasAvailable: boolean;
+    };
+}
+/** Amounts are uint256 decimal strings; timestamps are Unix seconds except checkedAt. */
+export interface GaslessExecutionPreview {
+    status: "ready";
+    version: 2;
+    settlementVersion: 2;
+    maker: string;
+    chainId: number;
+    contract: string;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    recipient: string;
+    unwrapOutput: boolean;
+    feeOnOutput: boolean;
+    excessOnInput: boolean;
+    payoutToken: string;
+    routeHash: string;
+    quoteBlockNumber: number;
+    /** Milliseconds since the Unix epoch. */
+    checkedAt: number;
+    slippageBps: number;
+    expectedOutputAmount: string;
+    minAmountOut: string;
+    recipientAmountOut: string;
+    /** Actual payout received after any transfer tax. */
+    operatorPayout: string;
+    nominalOperatorPayout: string;
+    payoutCapBase: string;
+    operatorPayoutNative: string;
+    estimatedGas: string;
+    gasLimit: string;
+    gasPriceWei: string;
+    gasBudgetNative: string;
+    gasPriceBoostBps: number;
+    gasLimitBps: number;
+    headroomBps: number;
+    eligible: boolean;
+    reason?: string;
+    /** Additive API metadata. A ready simulation can still be economically ineligible. */
+    eligibility?: GaslessEligibility;
+}
+export type GaslessPreviewResult = GaslessExecutionPreview | {
+    status: "unavailable";
+    reason: string;
+    eligibility?: GaslessEligibility;
+};
+export interface GaslessQuoteResponse extends BestPathResponse {
+    protocolFeeBps: number;
+    feeOnOutput: boolean;
+    quoteGasPrice: string;
+    quoteBlockNumber: number;
+    gaslessExecution: GaslessPreviewResult;
+}
+export interface GaslessTrade {
+    maker: string;
+    tokenIn: string;
+    /** Native sentinel is supported on output; signed orders use wrapped native. */
+    tokenOut: string;
+    amountIn: string;
+    recipient?: string;
+    partnerAddress?: string;
+    /** User price tolerance only. It never increases the contract's payout cap. 0–100. */
+    slippageBps?: number;
+}
+export interface GaslessTaxInfo {
+    isTaxToken: boolean;
+    buyTaxBps: number;
+    sellTaxBps: number;
+}
+export interface GaslessChainState {
+    checkedAt: number;
+    blockNumber: number;
+    blockTimestamp: number;
+    rawGasPriceWei: string;
+}
+export interface PreparedGaslessSwap {
+    deployment: GaslessDeployment;
+    trade: Required<GaslessTrade>;
+    quote: GaslessQuoteResponse;
+    preview: GaslessExecutionPreview;
+    feeOnOutput: boolean;
+    expectedOutput: string;
+    minAmountOut: string;
+    payoutToken: string;
+    operatorPayout: string;
+    gasPriceWei: string;
+    gasLimit: string;
+    gasBudgetNative: string;
+    chainState: GaslessChainState;
+}
+export type GaslessUnavailableCode = "NATIVE_INPUT_REQUIRES_WRAP" | "CONFIGURATION_CHANGED" | "TAX_CHECK_UNAVAILABLE" | "QUOTE_UNAVAILABLE" | "PREVIEW_UNAVAILABLE" | "STALE_QUOTE" | "INVALID_PREVIEW" | "SERVER_INELIGIBLE" | "INSUFFICIENT_OPERATOR_PAYOUT";
+export type GaslessQuoteDecision = {
+    eligible: true;
+    prepared: PreparedGaslessSwap;
+    eligibility?: GaslessEligibility;
+} | {
+    eligible: false;
+    code: GaslessUnavailableCode;
+    reason: string;
+    retryable: boolean;
+    /** Server economics are available even when this swap cannot use gasless. */
+    eligibility?: GaslessEligibility;
+};
+/** The API currently stores nonces as safe JSON integers, even though Solidity uses uint256. */
+export interface GaslessOrder extends LimitOrderParams {
+}
+export interface SignedGaslessOrder extends GaslessOrder {
+    limitOrderContract: string;
+    signature: string;
+}
+export interface PendingGaslessOrder {
+    network: LimitOrderNetwork;
+    chainId: number;
+    contract: string;
+    order: GaslessOrder;
+    state: "signing" | "submitting" | "submitted" | "uncertain";
+    signature?: string;
+}
+/** Implement atomically, scoped to network + maker. Persist before opening the wallet. */
+export interface GaslessPendingStore {
+    load(): Promise<PendingGaslessOrder | null>;
+    /** Must reject if another pending order already occupies this maker's slot. */
+    reserve(pending: PendingGaslessOrder): Promise<void>;
+    /** Must update only the same contract + maker + nonce; preserve the signature. */
+    update(pending: PendingGaslessOrder): Promise<void>;
+    /** Must release only the matching order. Never clear a different tab's order. */
+    release(pending: PendingGaslessOrder): Promise<void>;
+}
+export type GaslessOrderOutcome = {
+    status: "pending";
+    pending: PendingGaslessOrder;
+} | {
+    status: "filled";
+    pending: PendingGaslessOrder;
+    record: LimitOrderRecord;
+    settlementTxUrl?: string;
+} | {
+    status: "cancelled";
+    pending: PendingGaslessOrder;
+    record: LimitOrderRecord;
+} | {
+    status: "closed";
+    pending: PendingGaslessOrder;
+    reason: string;
+};
+export interface GaslessRoute {
+    amountIn: string | bigint;
+    hops: {
+        tokenIn: string;
+        tokenOut: string;
+        legs: {
+            adapter: string;
+            amountIn: string | bigint;
+            fee: number;
+            data: string;
+        }[];
+    }[];
+}
+//# sourceMappingURL=gasless-types.d.ts.map

package/dist/gasless-types.d.ts.map

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

package/dist/gasless-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gasless-types.js.map

package/dist/gasless-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasless-types.js","sourceRoot":"","sources":["../src/gasless-types.ts"],"names":[],"mappings":""}

package/dist/gasless.d.ts

@@ -0,0 +1,135 @@
+import { type Provider } from "ethers";
+import type { LimitOrderConfigResponse } from "./types.js";
+import type { LimitOrderNetwork } from "./limit-orders.js";
+import type { GaslessChainState, GaslessDeployment, GaslessOrder, GaslessQuoteDecision, GaslessQuoteResponse, GaslessTaxInfo, GaslessTrade, PreparedGaslessSwap } from "./gasless-types.js";
+export * from "./gasless-types.js";
+/** Fixed on-chain gasless protocol fee: 10 bps (0.1%), not an integration setting.
+ * Integrations that do not want this fee policy should offer regular swaps only. */
+export declare const GASLESS_PROTOCOL_FEE_BPS = 10;
+export declare const GASLESS_MAX_OPERATOR_PAYOUT_BPS = 5;
+export declare const GASLESS_ORDER_LIFETIME_SECONDS = 180;
+export declare const GASLESS_QUOTE_MAX_AGE_MS = 30000;
+export declare const GASLESS_MAX_SLIPPAGE_BPS = 100;
+export declare const GASLESS_GAS_PRICE_BOOST_BPS = 13000;
+export declare const GASLESS_GAS_LIMIT_BPS = 13000;
+export declare const GASLESS_GAS_HEADROOM_BPS = 11000;
+export declare const GASLESS_ORDER_TYPES: {
+    readonly LimitOrder: readonly [{
+        readonly name: "maker";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenIn";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenOut";
+        readonly type: "address";
+    }, {
+        readonly name: "amountIn";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minAmountOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "feeOnOutput";
+        readonly type: "bool";
+    }, {
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly name: "unwrapOutput";
+        readonly type: "bool";
+    }, {
+        readonly name: "partnerAddress";
+        readonly type: "address";
+    }];
+};
+export declare const GASLESS_ORDER_TUPLE = "(address maker,address tokenIn,address tokenOut,uint256 amountIn,uint256 minAmountOut,uint256 deadline,uint256 nonce,bool feeOnOutput,address recipient,bool unwrapOutput,address partnerAddress)";
+export declare const GASLESS_ROUTES_TUPLE = "(uint256 amountIn,(address tokenIn,address tokenOut,(address adapter,uint256 amountIn,uint24 fee,bytes data)[] legs)[] hops)[]";
+/** V2 only: fillOrder returns maker output, nominal payout, and the realized cap base. */
+export declare const GASLESS_SWITCH_ABI: readonly ["function settlementVersion() pure returns (uint256)", "function SWITCH_ROUTER() view returns (address)", "function WNATIVE() view returns (address)", "function getFee() pure returns (uint256)", "function MAX_OPERATOR_EXCESS_BPS() pure returns (uint256)", "function paused() view returns (bool)", "function operatorGateEnabled() pure returns (bool)", "function hasRole(bytes32,address) view returns (bool)", "function domainSeparator() view returns (bytes32)", "function isNonceUsed(address maker,uint256 nonce) view returns (bool)", "function invalidateNonce(uint256 nonce)", "function invalidateNonces(uint256[] nonces)", "function canFillOrder((address maker,address tokenIn,address tokenOut,uint256 amountIn,uint256 minAmountOut,uint256 deadline,uint256 nonce,bool feeOnOutput,address recipient,bool unwrapOutput,address partnerAddress) order,bytes signature) view returns (bool)", "function fillOrder((address maker,address tokenIn,address tokenOut,uint256 amountIn,uint256 minAmountOut,uint256 deadline,uint256 nonce,bool feeOnOutput,address recipient,bool unwrapOutput,address partnerAddress) order,bytes signature,(uint256 amountIn,(address tokenIn,address tokenOut,(address adapter,uint256 amountIn,uint24 fee,bytes data)[] legs)[] hops)[] routes,bool excessOnInput) returns (uint256 makerOutput,uint256 operatorPayout,uint256 capBase)", "event OrderFilled(address indexed maker,address indexed filler,uint256 indexed nonce,address tokenIn,address tokenOut,uint256 amountIn,uint256 makerAmountOut,uint256 fillerProfit,bool excessOnInput,address partnerAddress,bool directFill)", "event NonceCancelled(address indexed maker,uint256 indexed nonce)", "event GaslessFeePaid(address indexed maker,uint256 indexed nonce,address indexed token,uint256 nominalFee,uint256 protocolReceived,uint256 partnerReceived)", ...string[]];
+/** Pinned V2 deployments. A future migration requires an explicit trusted override. */
+export declare const GASLESS_DEPLOYMENTS: Readonly<Record<LimitOrderNetwork, Readonly<GaslessDeployment>>>;
+/** Historical V1 gasless addresses for indexing/cancellation, never new submissions. */
+export declare const GASLESS_LEGACY_CONTRACTS: Readonly<Record<LimitOrderNetwork, readonly string[]>>;
+export declare class GaslessError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    constructor(code: string, message: string, retryable?: boolean);
+}
+export declare const sameAddress: (a: unknown, b: string) => boolean;
+export declare function gaslessUint(value: unknown, allowZero?: boolean): bigint;
+export declare function gaslessAddress(value: string, allowZero?: boolean): string;
+export declare function normalizeGaslessTrade(trade: GaslessTrade): Required<GaslessTrade>;
+export declare function getGaslessSigningParams(deployment: GaslessDeployment): {
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: string;
+    };
+    types: {
+        LimitOrder: ({
+            name: "maker";
+            type: "address";
+        } | {
+            name: "tokenIn";
+            type: "address";
+        } | {
+            name: "tokenOut";
+            type: "address";
+        } | {
+            name: "amountIn";
+            type: "uint256";
+        } | {
+            name: "minAmountOut";
+            type: "uint256";
+        } | {
+            name: "deadline";
+            type: "uint256";
+        } | {
+            name: "nonce";
+            type: "uint256";
+        } | {
+            name: "feeOnOutput";
+            type: "bool";
+        } | {
+            name: "recipient";
+            type: "address";
+        } | {
+            name: "unwrapOutput";
+            type: "bool";
+        } | {
+            name: "partnerAddress";
+            type: "address";
+        })[];
+    };
+};
+export declare function validateGaslessConfig(config: LimitOrderConfigResponse, deployment: GaslessDeployment): void;
+export declare function validateGaslessTaxInfo(tax: GaslessTaxInfo): void;
+/** Same directional tax rules and preferred fee tokens as the Switch frontend. */
+export declare function selectGaslessFeeOnOutput(network: LimitOrderNetwork, tokenIn: string, tokenOut: string, inputTax: GaslessTaxInfo, outputTax: GaslessTaxInfo): boolean;
+export declare const gaslessCeil: (n: bigint, denominator: bigint) => bigint;
+/** gasPrice from the quote is already boosted: take the maximum, never boost it twice. */
+export declare function gaslessGasBudget(estimate: bigint, rawGasPrice: bigint, quoteGasPrice: bigint): {
+    gasLimit: bigint;
+    gasPrice: bigint;
+    gasBudgetNative: bigint;
+};
+/** Current contract state, not just an API-provided address or USD estimate. */
+export declare function readGaslessChainState(provider: Provider, deployment: GaslessDeployment, now?: number): Promise<GaslessChainState>;
+/** Bind every execution check to the exact trade, route bytes, fee side, and chain. */
+export declare function assessGaslessQuote(quote: GaslessQuoteResponse, tradeInput: GaslessTrade, deployment: GaslessDeployment, state: GaslessChainState, now?: number): GaslessQuoteDecision;
+/** Random 48-bit nonce stays exact in the hosted API's safe-integer database. */
+export declare function createGaslessNonce(): number;
+export declare function buildGaslessOrder(prepared: PreparedGaslessSwap, options?: {
+    nonce?: number;
+    now?: number;
+}): GaslessOrder;
+export declare const GASLESS_OPERATOR_ROLE: string;
+//# sourceMappingURL=gasless.d.ts.map

package/dist/gasless.d.ts.map

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