@anywalletkit/protocol-swap2-omniston 0.2.8 → 0.3.0

package/dist/provider.d.cts

@@ -1,4 +1,4 @@
-import { CrossChainProvider } from '@anywalletkit/protocol-swap2-core/types';
+import { RemotePins, CrossChainProvider, Quote, UnsignedTx, QuoteParams } from '@anywalletkit/protocol-swap2-core/types';
 
 /** Omniston's `SwapChunk.protocol` names and the layout each one builds. */
 declare const TON_SWAP_PROTOCOL_LAYOUTS: Readonly<Record<string, "stonfi-v1" | "stonfi-v2" | "dedust-v1" | "dedust-v2">>;
@@ -90,6 +90,13 @@ interface OmnistonQuoteStore {
     save(quoteId: string, valueJson: string): void | Promise<void>;
     load(quoteId: string): string | undefined | Promise<string | undefined>;
     clear(quoteId: string): void | Promise<void>;
+    /**
+     * Save only if nothing is stored under `quoteId` yet, atomically (Redis `SET NX`, a KV conditional put): true when
+     * this call wrote it. A quote id is the platform's choice, so a context must never be overwritten by another user's
+     * quote under the same id (scan 2026-10-27 modules, F27). Without it the provider checks then saves — fine for one
+     * process, racy across instances.
+     */
+    claim?(quoteId: string, valueJson: string): boolean | Promise<boolean>;
 }
 /** Default quote store — long-lived processes and tests only. */
 declare function inMemoryQuoteStore(): OmnistonQuoteStore;
@@ -585,6 +592,61 @@ declare function validateEvmToTonOrderExtension(extension: Uint8Array, expected:
      *  ERC-20 (`outputTokenAddress`, `traderDstAddress` are EVM then). Absent = TON. */
     dstChainId?: number;
 }): Promise<void>;
+/**
+ * The EVM order checks the provider runs on every build, exported so an app that holds the quote's settlement data
+ * can run them itself (scan 2026-10-27 modules, F4): the 1inch Limit Order Protocol v4 domain on the settlement
+ * contract and chain, the exact Order schema, this owner as maker, the resolver as receiver, the input asset and
+ * amount, single-fill traits, the salt committing the order extension and the expiry at the trade-start deadline.
+ * Throws when any of it does not hold.
+ */
+declare function validateEvmTypedOrder(td: unknown, expected: {
+    chainId: number;
+    settlementContract: string;
+    owner: string;
+    receiver: string;
+    makerAsset: string;
+    makingAmount: string;
+    takingAmount: string;
+    orderExtension: Uint8Array;
+    quoteTimestamp: number;
+    tradeStartDeadline: number;
+}): asserts td is {
+    domain: {
+        verifyingContract: string;
+        chainId: string | number;
+    };
+    types: Record<string, {
+        name: string;
+        type: string;
+    }[]>;
+    primaryType: string;
+    message: Record<string, unknown>;
+};
+/**
+ * The app's side of `remoteProvider({name: "omniston", baseUrl, ...omnistonPins(trustedEvmOrderProtocols)})`: the
+ * audited order-protocol contracts per EVM chain — the list the provider's `trustedEvmOrderProtocols` takes — are the
+ * only spenders, and so the only EIP-712 verifying contracts, a remote typed order may name (scan 2026-10-27 modules,
+ * F4). Omniston's EVM orders call no contract from the wallet: there are no call targets.
+ */
+declare function omnistonPins(trustedEvmOrderProtocols: Readonly<Record<string, readonly string[]>>): RemotePins;
+/**
+ * The app's check of a remote Omniston TON swap build, for `remoteProvider({name: "omniston", baseUrl, verifyBuild:
+ * omnistonVerifyBuild({validateTonSwapTarget, validateTonSwapLeg})})` (scan 2026-10-27 modules, F7/F13/F18/F19): the
+ * body is opened with `checkTonSwapPayload` against the app's own request — receiver, refund / excess to the trader,
+ * the on-chain minimum, the input — and the DEX it pays is confirmed with the app's validators (the same hooks the
+ * provider takes; `createOmnistonTonValidators` builds them). Any other cell body (a TON → EVM escrow) cannot be
+ * checked without the quote's settlement data and is refused; EVM typed orders pass through to the engine's own
+ * order checks. The reason it fails, or null.
+ */
+declare function omnistonVerifyBuild(hooks: {
+    validateTonSwapTarget: (input: {
+        address: string;
+        protocols: readonly string[];
+    }) => Promise<boolean> | boolean;
+    validateTonSwapLeg?: (leg: TonSwapLeg) => Promise<boolean> | boolean;
+    /** The integrator your backend's Omniston provider uses: the only referral a body may name. */
+    integratorAddress?: string | null;
+}): (quote: Quote, tx: UnsignedTx, params?: QuoteParams) => Promise<string | null>;
 declare function omnistonProvider(opts?: OmnistonProviderOptions): CrossChainProvider;
 
-export { type AssetId, type ChainAddress, type EscrowMessage, type HtlcSecretStore, type ObservableLike, type OmnistonClientLike, type OmnistonProviderOptions, type OmnistonQuote, type OmnistonQuoteStore, type OrderEvent, type OrderExecution, type OrderSettlement, type OrderSnapshot, type QuoteRequest, type RfqEvent, type SwapSettlement, type SwapTrackEvent, TON_SWAP_PROTOCOL_LAYOUTS, type TonSwapCheckInput, type TonSwapCheckResult, type TonSwapLeg, TonSwapPayloadError, checkTonSwapPayload, encodeTypedMessage, inMemoryQuoteStore, inMemorySecretStore, omnistonProvider, validateEvmToTonOrderExtension };
+export { type AssetId, type ChainAddress, type EscrowMessage, type HtlcSecretStore, type ObservableLike, type OmnistonClientLike, type OmnistonProviderOptions, type OmnistonQuote, type OmnistonQuoteStore, type OrderEvent, type OrderExecution, type OrderSettlement, type OrderSnapshot, type QuoteRequest, type RfqEvent, type SwapSettlement, type SwapTrackEvent, TON_SWAP_PROTOCOL_LAYOUTS, type TonSwapCheckInput, type TonSwapCheckResult, type TonSwapLeg, TonSwapPayloadError, checkTonSwapPayload, encodeTypedMessage, inMemoryQuoteStore, inMemorySecretStore, omnistonPins, omnistonProvider, omnistonVerifyBuild, validateEvmToTonOrderExtension, validateEvmTypedOrder };

package/dist/provider.d.ts

@@ -1,4 +1,4 @@
-import { CrossChainProvider } from '@anywalletkit/protocol-swap2-core/types';
+import { RemotePins, CrossChainProvider, Quote, UnsignedTx, QuoteParams } from '@anywalletkit/protocol-swap2-core/types';
 
 /** Omniston's `SwapChunk.protocol` names and the layout each one builds. */
 declare const TON_SWAP_PROTOCOL_LAYOUTS: Readonly<Record<string, "stonfi-v1" | "stonfi-v2" | "dedust-v1" | "dedust-v2">>;
@@ -90,6 +90,13 @@ interface OmnistonQuoteStore {
     save(quoteId: string, valueJson: string): void | Promise<void>;
     load(quoteId: string): string | undefined | Promise<string | undefined>;
     clear(quoteId: string): void | Promise<void>;
+    /**
+     * Save only if nothing is stored under `quoteId` yet, atomically (Redis `SET NX`, a KV conditional put): true when
+     * this call wrote it. A quote id is the platform's choice, so a context must never be overwritten by another user's
+     * quote under the same id (scan 2026-10-27 modules, F27). Without it the provider checks then saves — fine for one
+     * process, racy across instances.
+     */
+    claim?(quoteId: string, valueJson: string): boolean | Promise<boolean>;
 }
 /** Default quote store — long-lived processes and tests only. */
 declare function inMemoryQuoteStore(): OmnistonQuoteStore;
@@ -585,6 +592,61 @@ declare function validateEvmToTonOrderExtension(extension: Uint8Array, expected:
      *  ERC-20 (`outputTokenAddress`, `traderDstAddress` are EVM then). Absent = TON. */
     dstChainId?: number;
 }): Promise<void>;
+/**
+ * The EVM order checks the provider runs on every build, exported so an app that holds the quote's settlement data
+ * can run them itself (scan 2026-10-27 modules, F4): the 1inch Limit Order Protocol v4 domain on the settlement
+ * contract and chain, the exact Order schema, this owner as maker, the resolver as receiver, the input asset and
+ * amount, single-fill traits, the salt committing the order extension and the expiry at the trade-start deadline.
+ * Throws when any of it does not hold.
+ */
+declare function validateEvmTypedOrder(td: unknown, expected: {
+    chainId: number;
+    settlementContract: string;
+    owner: string;
+    receiver: string;
+    makerAsset: string;
+    makingAmount: string;
+    takingAmount: string;
+    orderExtension: Uint8Array;
+    quoteTimestamp: number;
+    tradeStartDeadline: number;
+}): asserts td is {
+    domain: {
+        verifyingContract: string;
+        chainId: string | number;
+    };
+    types: Record<string, {
+        name: string;
+        type: string;
+    }[]>;
+    primaryType: string;
+    message: Record<string, unknown>;
+};
+/**
+ * The app's side of `remoteProvider({name: "omniston", baseUrl, ...omnistonPins(trustedEvmOrderProtocols)})`: the
+ * audited order-protocol contracts per EVM chain — the list the provider's `trustedEvmOrderProtocols` takes — are the
+ * only spenders, and so the only EIP-712 verifying contracts, a remote typed order may name (scan 2026-10-27 modules,
+ * F4). Omniston's EVM orders call no contract from the wallet: there are no call targets.
+ */
+declare function omnistonPins(trustedEvmOrderProtocols: Readonly<Record<string, readonly string[]>>): RemotePins;
+/**
+ * The app's check of a remote Omniston TON swap build, for `remoteProvider({name: "omniston", baseUrl, verifyBuild:
+ * omnistonVerifyBuild({validateTonSwapTarget, validateTonSwapLeg})})` (scan 2026-10-27 modules, F7/F13/F18/F19): the
+ * body is opened with `checkTonSwapPayload` against the app's own request — receiver, refund / excess to the trader,
+ * the on-chain minimum, the input — and the DEX it pays is confirmed with the app's validators (the same hooks the
+ * provider takes; `createOmnistonTonValidators` builds them). Any other cell body (a TON → EVM escrow) cannot be
+ * checked without the quote's settlement data and is refused; EVM typed orders pass through to the engine's own
+ * order checks. The reason it fails, or null.
+ */
+declare function omnistonVerifyBuild(hooks: {
+    validateTonSwapTarget: (input: {
+        address: string;
+        protocols: readonly string[];
+    }) => Promise<boolean> | boolean;
+    validateTonSwapLeg?: (leg: TonSwapLeg) => Promise<boolean> | boolean;
+    /** The integrator your backend's Omniston provider uses: the only referral a body may name. */
+    integratorAddress?: string | null;
+}): (quote: Quote, tx: UnsignedTx, params?: QuoteParams) => Promise<string | null>;
 declare function omnistonProvider(opts?: OmnistonProviderOptions): CrossChainProvider;
 
-export { type AssetId, type ChainAddress, type EscrowMessage, type HtlcSecretStore, type ObservableLike, type OmnistonClientLike, type OmnistonProviderOptions, type OmnistonQuote, type OmnistonQuoteStore, type OrderEvent, type OrderExecution, type OrderSettlement, type OrderSnapshot, type QuoteRequest, type RfqEvent, type SwapSettlement, type SwapTrackEvent, TON_SWAP_PROTOCOL_LAYOUTS, type TonSwapCheckInput, type TonSwapCheckResult, type TonSwapLeg, TonSwapPayloadError, checkTonSwapPayload, encodeTypedMessage, inMemoryQuoteStore, inMemorySecretStore, omnistonProvider, validateEvmToTonOrderExtension };
+export { type AssetId, type ChainAddress, type EscrowMessage, type HtlcSecretStore, type ObservableLike, type OmnistonClientLike, type OmnistonProviderOptions, type OmnistonQuote, type OmnistonQuoteStore, type OrderEvent, type OrderExecution, type OrderSettlement, type OrderSnapshot, type QuoteRequest, type RfqEvent, type SwapSettlement, type SwapTrackEvent, TON_SWAP_PROTOCOL_LAYOUTS, type TonSwapCheckInput, type TonSwapCheckResult, type TonSwapLeg, TonSwapPayloadError, checkTonSwapPayload, encodeTypedMessage, inMemoryQuoteStore, inMemorySecretStore, omnistonPins, omnistonProvider, omnistonVerifyBuild, validateEvmToTonOrderExtension, validateEvmTypedOrder };

package/dist/provider.js

@@ -5,9 +5,12 @@ import {
   encodeTypedMessage,
   inMemoryQuoteStore,
   inMemorySecretStore,
+  omnistonPins,
   omnistonProvider,
-  validateEvmToTonOrderExtension
-} from "./chunk-KNT2XSQU.js";
+  omnistonVerifyBuild,
+  validateEvmToTonOrderExtension,
+  validateEvmTypedOrder
+} from "./chunk-JVFDD7PV.js";
 import "./chunk-QDXFC6BC.js";
 import "./chunk-AIWAM7BS.js";
 export {
@@ -17,7 +20,10 @@ export {
   encodeTypedMessage,
   inMemoryQuoteStore,
   inMemorySecretStore,
+  omnistonPins,
   omnistonProvider,
-  validateEvmToTonOrderExtension
+  omnistonVerifyBuild,
+  validateEvmToTonOrderExtension,
+  validateEvmTypedOrder
 };
 //# sourceMappingURL=provider.js.map