@symbiome-forge/cow-sdk-wasm 0.1.0-alpha.5 → 0.1.0-alpha.7

package/README.md

@@ -37,19 +37,37 @@ flavor-specific imports — with no bundled wallet library.
 
 ## Pick your import
 
+Pick the **flavor** (feature set) by its base subpath. Every flavor ships the same
+runtime entries over one shared wasm binary, so pick the **runtime** by the suffix:
+
 | Import | Surface | Use when |
 | --- | --- | --- |
-| `@symbiome-forge/cow-sdk-wasm/trading` | Full order lifecycle: quote, sign, post, cancel, app-data | A browser dapp, a Node backend, or an edge runtime running order flow — one feature set serves all three; pick the runtime by import |
-| `@symbiome-forge/cow-sdk-wasm/trading/edge` | The `trading` flavor's web-target build, with explicit wasm init | Cloudflare Workers, Deno, or Vercel Edge; pair with `…/trading/edge/wasm` for the module asset |
+| `@symbiome-forge/cow-sdk-wasm/trading` | Full order lifecycle: quote, sign, post, cancel, app-data, and native wrap/unwrap | A browser dapp, a Node backend, or an edge runtime running order flow — one feature set serves all three; pick the runtime by suffix |
 | `@symbiome-forge/cow-sdk-wasm/orderbook` | Orderbook reads, cancellation, and signing — no trading or app-data | A read-focused dapp that does not post orders |
 | `@symbiome-forge/cow-sdk-wasm/signing` | Signing, UID, EIP-1271, deployment, and version helpers — the smallest flavor | A signer service or HSM-facing adapter |
 | `@symbiome-forge/cow-sdk-wasm` | Everything above plus subgraph analytics and IPFS app-data | General use that needs subgraph or IPFS |
 
-The `trading` flavor resolves the right target automatically through standard
-conditional exports — `node` and `browser` for bundlers and Node, and `workerd` /
-`deno` / `edge-light` / `bun` for edge — with `./trading/edge` as the explicit
-Workers entry. Public imports go through these subpaths; do not import from
-`dist/raw` or generated wasm-pack directories.
+Each flavor exposes three runtime entries that share one wasm binary:
+
+- the **base** import (above) auto-selects the build through standard conditional
+  exports: `node` loads the Node (CommonJS) build; `browser`, `import`, and the edge
+  conditions (`workerd` / `worker` / `deno` / `edge-light` / `bun`) load the
+  explicit-init **web** build, which instantiates its wasm through
+  `new URL(import.meta.url)` and so works across every bundler and with no bundler at
+  all — call `await initialize()` once before the first call;
+- **`…/edge`** is the explicit web entry for Cloudflare Workers, Deno, and Vercel
+  Edge — pair it with **`…/edge/wasm`** for the precompiled module and call
+  `await initialize(wasmModule)`;
+- **`…/module`** is the standards-track source-phase build (`import source` / Wasm
+  ESM Integration): it auto-initializes with no `initialize()` call, runs today on
+  Node 24, Deno, and esbuild, and is the forward path for browser bundlers as they
+  adopt source-phase.
+
+So the focused flavors' entries are `…/trading/edge`, `…/trading/module`,
+`…/orderbook/edge`, `…/signing/module`, and so on; the root (everything) flavor's are
+`@symbiome-forge/cow-sdk-wasm/edge` and `@symbiome-forge/cow-sdk-wasm/module`. Public
+imports go through these subpaths; do not import from `dist/raw` or generated
+wasm-pack directories.
 
 Building a **native Rust** service, or a Rust app you compile to wasm yourself?
 Use [`cow-sdk`](https://crates.io/crates/cow-sdk) — this package is for
@@ -63,10 +81,15 @@ preview and signature. The wallet signs a typed-data envelope the SDK hands it;
 no key reaches the package.
 
 ```ts
-import { TradingClient } from "@symbiome-forge/cow-sdk-wasm/trading";
+import { initialize, TradingClient } from "@symbiome-forge/cow-sdk-wasm/trading";
 import { createWalletClient, custom } from "viem";
 import { mainnet } from "viem/chains";
 
+// Instantiate the wasm module once before any call. The bundled module is resolved
+// from the package via `new URL(import.meta.url)`, so this works in every bundler
+// and with no bundler at all — no bundler wasm plugin required.
+await initialize();
+
 const [owner] = await window.ethereum.request({ method: "eth_requestAccounts" });
 const wallet = createWalletClient({ chain: mainnet, transport: custom(window.ethereum) });
 
@@ -116,6 +139,13 @@ Selling the native asset is the same shape: `getQuote`, then
 `buildSellNativeCurrencyTxFromQuote(quote.value, owner)`, which returns the EthFlow
 transaction request for the wallet to submit.
 
+Converting between the native asset and its wrapped form is not an order:
+`buildWrapTx(chainId, amount)` and `buildUnwrapTx(chainId, amount)` return the
+WETH deposit/withdraw transaction for the wallet to submit, and
+`wrappedNativeToken(chainId)` resolves the wrapped-native token (address, symbol,
+decimals) for detecting a wrap pair in a swap UI. (Selling native currency to
+trade does not need a manual wrap — eth-flow wraps on-chain.)
+
 ### Cloudflare Worker (edge)
 
 Workers cannot compile wasm from bytes at runtime, so the edge build takes the
@@ -207,16 +237,19 @@ current alpha build (gzip is the compressed-transfer figure):
 
 | Flavor | Raw wasm | Brotli | Gzip | Release gate |
 | --- | ---: | ---: | ---: | --- |
-| signing | 0.31 MiB | 120 KiB | 142 KiB | 0.9 MiB raw / 300 KiB brotli |
-| orderbook | 1.02 MiB | 341 KiB | 447 KiB | 1.5 MiB raw / 500 KiB brotli |
-| trading | 1.54 MiB | 490 KiB | 659 KiB | 3.2 MiB raw / 850 KiB brotli |
-| default | 1.63 MiB | 513 KiB | 692 KiB | 3.3 MiB raw / 900 KiB brotli |
-
-The `trading` flavor emits one wasm binary across its bundler, Node, and web
-targets; its web-target gzip size is within the current Cloudflare Workers Free
-compressed-size limit, enforced as a byte budget on every build. End-to-end
-Workers support also depends on `wrangler deploy --dry-run` verification and a
-Worker startup-time gate, tracked separately.
+| signing | 0.31 MiB | 121 KiB | 144 KiB | 0.9 MiB raw / 300 KiB brotli |
+| orderbook | 1.03 MiB | 341 KiB | 448 KiB | 1.5 MiB raw / 500 KiB brotli |
+| trading | 1.54 MiB | 491 KiB | 661 KiB | 3.2 MiB raw / 850 KiB brotli |
+| default | 1.64 MiB | 514 KiB | 693 KiB | 3.3 MiB raw / 900 KiB brotli |
+
+Each flavor emits one wasm binary shared across its bundler, Node, web, and
+source-phase module targets — the web glue's default URL, the module glue's
+`import source`, and the raw Worker module subpath all reuse the one bundler copy,
+so a flavor's gzip figure above is its size on every runtime. Each flavor's gzip
+size is enforced as a per-build byte budget within the current Cloudflare Workers
+Free compressed-size limit. End-to-end Workers support also depends on
+`wrangler deploy --dry-run` verification and a Worker startup-time gate, tracked
+separately.
 
 ## Not in this package
 

package/dist/default/edge.d.ts

@@ -0,0 +1,111 @@
+/// <reference lib="esnext.disposable" />
+import * as raw from "./raw/default.js";
+import type { WasmEnvelope } from "./envelope.js";
+import type { CommonClientConfig, IpfsClientConfig, SdkClientOptions, SigningOptions, SubgraphClientConfig, TradingClientConfig } from "./options.js";
+import type { ContractReadCallback, CustomEip1271Callback, DigestSignerCallback, Eip1193RequestCallback, TypedDataSignerCallback } from "./callbacks.js";
+export interface OrderBookClientConfig extends CommonClientConfig {
+}
+/**
+ * Initialize the wasm module, idempotently, once per module instance.
+ *
+ * On the `web` build — Cloudflare Workers, Deno, Vercel Edge, and no-bundler
+ * browsers — the host owns module instantiation, so it must call this once with
+ * the compiled module (Workers pass the `CompiledWasm` binding) or its URL/bytes
+ * (Deno and browsers). On the `bundler` and `nodejs` builds the host
+ * bundler/runtime instantiates the module on import, so this resolves
+ * immediately and the argument is ignored — calling it is optional and harmless,
+ * which keeps one call shape working across every target.
+ */
+export declare function initialize(module?: WebAssembly.Module | raw.InitInput): Promise<void>;
+export default initialize;
+export type { InitInput } from "./raw/default.js";
+export declare class IpfsClient {
+    #private;
+    constructor(config: IpfsClientConfig);
+    fetchAppDataFromCid(cid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.AppDataDocDto>>;
+    fetchAppDataFromHex(appDataHex: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.AppDataDocDto>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class OrderBookClient {
+    #private;
+    constructor(config: OrderBookClientConfig);
+    cancelOrders(signed: raw.SignedCancellationsInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<{
+        cancelled: true;
+    }>>;
+    getNativePrice(token: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.NativePriceResponseDto>>;
+    getOrder(orderUid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto>>;
+    getOrders(owner: string, pagination?: raw.PaginationOptions | null, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto[]>>;
+    getOrderMultiEnv(orderUid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto>>;
+    getTxOrders(txHash: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto[]>>;
+    getVersion(options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    getOrderLink(orderUid: string): WasmEnvelope<string>;
+    getQuote(request: raw.OrderQuoteRequestInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderQuoteResponseDto>>;
+    getTrades(query: raw.TradesQueryInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.TradeDto[]>>;
+    getOrderCompetitionStatus(orderUid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.CompetitionOrderStatusDto>>;
+    getTotalSurplus(owner: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.TotalSurplusDto>>;
+    getSolverCompetition(auctionId: number, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.SolverCompetitionResponseDto>>;
+    getSolverCompetitionByTxHash(txHash: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.SolverCompetitionResponseDto>>;
+    getAppData(appDataHash: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.AppDataObjectDto>>;
+    uploadAppData(appDataHash: string, fullAppData: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<{
+        uploaded: true;
+    }>>;
+    sendOrder(signed: raw.SignedOrderDto, options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    sendOrderCreation(input: raw.OrderCreationInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class SubgraphClient {
+    #private;
+    constructor(config: SubgraphClientConfig);
+    getLastDaysVolume(days: number, options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    getLastHoursVolume(hours: number, options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    getTotals(options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    runQuery(request: raw.SubgraphQueryInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class TradingClient {
+    #private;
+    constructor(config: TradingClientConfig);
+    buildSellNativeCurrencyTx(order: raw.OrderInput, quoteId: number, from: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.BuiltSellNativeCurrencyTxDto>>;
+    buildSellNativeCurrencyTxFromQuote(quoteResults: raw.QuoteResultsDto, from: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.BuiltSellNativeCurrencyTxDto>>;
+    getCowProtocolAllowance(params: raw.AllowanceParametersInput, readContractCallback: ContractReadCallback, options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    buildApprovalTx(params: raw.ApprovalParametersInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.TransactionRequestDto>>;
+    getQuote(params: raw.SwapParametersInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.QuoteResultsDto>>;
+    postLimitOrder(params: raw.LimitTradeParametersInput, owner: string, signerCallback: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    postSwapOrder(params: raw.SwapParametersInput, owner: string, signerCallback: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    postSwapOrderFromQuote(quoteResults: raw.QuoteResultsDto, owner: string, signerCallback: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    postSwapOrderWithEip1271(params: raw.SwapParametersInput, owner: string, customCallback: CustomEip1271Callback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare function appDataDoc(doc: raw.AppDataDocInput): WasmEnvelope<raw.AppDataDocDto>;
+export declare function appDataHexToCid(appDataHex: string): WasmEnvelope<string>;
+export declare function appDataInfo(doc: raw.AppDataDocInput): WasmEnvelope<raw.AppDataInfoDto>;
+export declare function buildCancelOrderTx(params: raw.OrderTraderParametersInput): WasmEnvelope<raw.TransactionRequestDto>;
+export declare function buildPresignTx(params: raw.OrderTraderParametersInput): WasmEnvelope<raw.TransactionRequestDto>;
+export declare function cidToAppDataHex(cid: string): WasmEnvelope<string>;
+export declare function computeOrderUid(input: raw.OrderInput, chainId: number, owner: string): WasmEnvelope<raw.GeneratedOrderUidDto>;
+export declare function decodeEthFlowLog(log: raw.EventLogInput): WasmEnvelope<raw.EthFlowEventDto>;
+export declare function decodeSettlementLog(log: raw.EventLogInput): WasmEnvelope<raw.SettlementEventDto>;
+export declare function deploymentAddresses(chainId: number, env?: string | null): WasmEnvelope<raw.DeploymentAddressesDto>;
+export declare function domainSeparator(chainId: number): string;
+export declare function eip1271SignaturePayload(input: raw.OrderInput, ecdsaSignature: string): WasmEnvelope<string>;
+export declare function orderTypedData(input: raw.OrderInput, chainId: number): WasmEnvelope<raw.TypedDataEnvelopeDto>;
+export declare function signCancellationEthSignDigest(orderUids: string[], chainId: number, digestSigner: DigestSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedCancellationsInput>>;
+export declare function signCancellationWithEip1193(orderUids: string[], chainId: number, owner: string, requestCallback: Eip1193RequestCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedCancellationsInput>>;
+export declare function signCancellationWithTypedDataSigner(orderUids: string[], chainId: number, typedDataSigner: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedCancellationsInput>>;
+export declare function signOrderEthSignDigest(input: raw.OrderInput, chainId: number, owner: string, digestSigner: DigestSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithCustomEip1271(input: raw.OrderInput, chainId: number, owner: string, customCallback: CustomEip1271Callback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithEip1193(input: raw.OrderInput, chainId: number, owner: string, requestCallback: Eip1193RequestCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithEip1271(input: raw.OrderInput, chainId: number, owner: string, typedDataSigner: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithTypedDataSigner(input: raw.OrderInput, chainId: number, owner: string, typedDataSigner: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function supportedChainIds(): Uint32Array;
+export declare function validateAppDataDoc(doc: raw.AppDataDocInput): WasmEnvelope<raw.ValidationResultDto>;
+export declare function wasmVersion(): string;
+export type { AllowanceParametersInput, AmountsDto, AppDataDocDto, AppDataDocInput, AppDataInfoDto, AppDataObjectDto, ApprovalParametersInput, BuiltSellNativeCurrencyTxDto, CompetitionAuctionDto, CompetitionOrderStatusDto, CompetitionOrderStatusKindDto, ContractCallDto, CostsDto, CowEip1271SignRequest, CowEnvDto, DeploymentAddressesDto, Eip1193Request, EthFlowEventDto, EthflowDataDto, EventLogInput, ExecutedAmountsDto, ExecutedProtocolFeeDto, FeeComponentDto, GeneratedOrderUidDto, InteractionDataDto, LimitTradeParametersInput, NativePriceResponseDto, NetworkFeeDto, OnchainOrderDataDto, OrderClassDto, OrderCreationInput, OrderDataDto, OrderDto, OrderInput, OrderInteractionsDto, OrderKindDto, OrderPostingResultDto, OrderQuoteRequestInput, OrderQuoteResponseDto, OrderStatusDto, OrderTraderParametersInput, OrderBookRuntimeBindingDto, PaginationOptions, PartnerFeeDto, PartnerFeeInput, PartnerFeePolicyDto, PartnerFeePolicyInput, QuoteAmountsAndCostsDto, QuoteDataDto, QuoteResultsDto, SettlementEventDto, SignedCancellationsInput, SignedOrderDto, SigningSchemeDto, SolverCompetitionOrderDto, SolverCompetitionResponseDto, SolverExecutionDto, SolverSettlementDto, StoredOrderQuoteDto, SubgraphQueryInput, SwapParametersInput, TokenBalanceDto, TotalSurplusDto, TradeDto, TradeParametersDto, TradesQueryInput, TradingAppDataInfoDto, TransactionRequestDto, TypedDataDomainDto, TypedDataEnvelopeDto, TypedDataFieldDto, ValidationResultDto } from "./raw/default.js";
+export type { ContractReadCallback, CowEip1271SignCallback, CowEnv, CustomEip1271Callback, DigestSignerCallback, Eip1193RequestCallback, TypedDataSignerCallback } from "./callbacks.js";
+export type { OrderBookRejectionCategory, CowError } from "./errors.js";
+export type { SchemaVersion, WasmEnvelope } from "./envelope.js";
+export type { CowFetchCallback, CowFetchRequest, CowFetchResponse, HttpTransportConfig, IpfsClientConfig, JitterStrategyConfig, LimiterScopeConfig, RequestRateLimiterConfig, RetryPolicyConfig, SdkClientOptions, SigningOptions, SubgraphClientConfig, TradingClientConfig, TransportPolicyConfig, WalletConfig } from "./options.js";

package/dist/default/{index.mjs → edge.mjs}

@@ -1,5 +1,24 @@
-import * as raw from "./raw/default.js";
+import * as raw from "./raw/default-web.js";
 import { assertActive, callAsync, callSync, defaultsFrom, disposeRaw, mergeOptions, mergeSigningOptions, translateClientConfig } from "./internal.js";
+let initialized;
+/**
+ * Initialize the wasm module, idempotently, once per module instance.
+ *
+ * On the `web` build — Cloudflare Workers, Deno, Vercel Edge, and no-bundler
+ * browsers — the host owns module instantiation, so it must call this once with
+ * the compiled module (Workers pass the `CompiledWasm` binding) or its URL/bytes
+ * (Deno and browsers). On the `bundler` and `nodejs` builds the host
+ * bundler/runtime instantiates the module on import, so this resolves
+ * immediately and the argument is ignored — calling it is optional and harmless,
+ * which keeps one call shape working across every target.
+ */
+export async function initialize(module) {
+    if (!initialized) {
+        initialized = raw.initializeRaw({ module_or_path: module }).then(() => undefined);
+    }
+    await initialized;
+}
+export default initialize;
 export class IpfsClient {
     #inner;
     #defaults;

package/dist/default/index.cjs

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TradingClient = exports.SubgraphClient = exports.OrderBookClient = exports.IpfsClient = void 0;
+exports.initialize = initialize;
 exports.appDataDoc = appDataDoc;
 exports.appDataHexToCid = appDataHexToCid;
 exports.appDataInfo = appDataInfo;
@@ -60,6 +61,25 @@ exports.validateAppDataDoc = validateAppDataDoc;
 exports.wasmVersion = wasmVersion;
 const raw = __importStar(require("./raw/default.cjs"));
 const internal_js_1 = require("./internal.cjs");
+let initialized;
+/**
+ * Initialize the wasm module, idempotently, once per module instance.
+ *
+ * On the `web` build — Cloudflare Workers, Deno, Vercel Edge, and no-bundler
+ * browsers — the host owns module instantiation, so it must call this once with
+ * the compiled module (Workers pass the `CompiledWasm` binding) or its URL/bytes
+ * (Deno and browsers). On the `bundler` and `nodejs` builds the host
+ * bundler/runtime instantiates the module on import, so this resolves
+ * immediately and the argument is ignored — calling it is optional and harmless,
+ * which keeps one call shape working across every target.
+ */
+async function initialize(module) {
+    if (!initialized) {
+        initialized = raw.initializeRaw({ module_or_path: module }).then(() => undefined);
+    }
+    await initialized;
+}
+exports.default = initialize;
 class IpfsClient {
     #inner;
     #defaults;

package/dist/default/index.d.ts

@@ -5,6 +5,20 @@ import type { CommonClientConfig, IpfsClientConfig, SdkClientOptions, SigningOpt
 import type { ContractReadCallback, CustomEip1271Callback, DigestSignerCallback, Eip1193RequestCallback, TypedDataSignerCallback } from "./callbacks.js";
 export interface OrderBookClientConfig extends CommonClientConfig {
 }
+/**
+ * Initialize the wasm module, idempotently, once per module instance.
+ *
+ * On the `web` build — Cloudflare Workers, Deno, Vercel Edge, and no-bundler
+ * browsers — the host owns module instantiation, so it must call this once with
+ * the compiled module (Workers pass the `CompiledWasm` binding) or its URL/bytes
+ * (Deno and browsers). On the `bundler` and `nodejs` builds the host
+ * bundler/runtime instantiates the module on import, so this resolves
+ * immediately and the argument is ignored — calling it is optional and harmless,
+ * which keeps one call shape working across every target.
+ */
+export declare function initialize(module?: WebAssembly.Module | raw.InitInput): Promise<void>;
+export default initialize;
+export type { InitInput } from "./raw/default.js";
 export declare class IpfsClient {
     #private;
     constructor(config: IpfsClientConfig);

package/dist/default/module.d.ts

@@ -0,0 +1,111 @@
+/// <reference lib="esnext.disposable" />
+import * as raw from "./raw/default.js";
+import type { WasmEnvelope } from "./envelope.js";
+import type { CommonClientConfig, IpfsClientConfig, SdkClientOptions, SigningOptions, SubgraphClientConfig, TradingClientConfig } from "./options.js";
+import type { ContractReadCallback, CustomEip1271Callback, DigestSignerCallback, Eip1193RequestCallback, TypedDataSignerCallback } from "./callbacks.js";
+export interface OrderBookClientConfig extends CommonClientConfig {
+}
+/**
+ * Initialize the wasm module, idempotently, once per module instance.
+ *
+ * On the `web` build — Cloudflare Workers, Deno, Vercel Edge, and no-bundler
+ * browsers — the host owns module instantiation, so it must call this once with
+ * the compiled module (Workers pass the `CompiledWasm` binding) or its URL/bytes
+ * (Deno and browsers). On the `bundler` and `nodejs` builds the host
+ * bundler/runtime instantiates the module on import, so this resolves
+ * immediately and the argument is ignored — calling it is optional and harmless,
+ * which keeps one call shape working across every target.
+ */
+export declare function initialize(module?: WebAssembly.Module | raw.InitInput): Promise<void>;
+export default initialize;
+export type { InitInput } from "./raw/default.js";
+export declare class IpfsClient {
+    #private;
+    constructor(config: IpfsClientConfig);
+    fetchAppDataFromCid(cid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.AppDataDocDto>>;
+    fetchAppDataFromHex(appDataHex: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.AppDataDocDto>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class OrderBookClient {
+    #private;
+    constructor(config: OrderBookClientConfig);
+    cancelOrders(signed: raw.SignedCancellationsInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<{
+        cancelled: true;
+    }>>;
+    getNativePrice(token: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.NativePriceResponseDto>>;
+    getOrder(orderUid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto>>;
+    getOrders(owner: string, pagination?: raw.PaginationOptions | null, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto[]>>;
+    getOrderMultiEnv(orderUid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto>>;
+    getTxOrders(txHash: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderDto[]>>;
+    getVersion(options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    getOrderLink(orderUid: string): WasmEnvelope<string>;
+    getQuote(request: raw.OrderQuoteRequestInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.OrderQuoteResponseDto>>;
+    getTrades(query: raw.TradesQueryInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.TradeDto[]>>;
+    getOrderCompetitionStatus(orderUid: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.CompetitionOrderStatusDto>>;
+    getTotalSurplus(owner: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.TotalSurplusDto>>;
+    getSolverCompetition(auctionId: number, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.SolverCompetitionResponseDto>>;
+    getSolverCompetitionByTxHash(txHash: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.SolverCompetitionResponseDto>>;
+    getAppData(appDataHash: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.AppDataObjectDto>>;
+    uploadAppData(appDataHash: string, fullAppData: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<{
+        uploaded: true;
+    }>>;
+    sendOrder(signed: raw.SignedOrderDto, options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    sendOrderCreation(input: raw.OrderCreationInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class SubgraphClient {
+    #private;
+    constructor(config: SubgraphClientConfig);
+    getLastDaysVolume(days: number, options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    getLastHoursVolume(hours: number, options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    getTotals(options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    runQuery(request: raw.SubgraphQueryInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<unknown>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class TradingClient {
+    #private;
+    constructor(config: TradingClientConfig);
+    buildSellNativeCurrencyTx(order: raw.OrderInput, quoteId: number, from: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.BuiltSellNativeCurrencyTxDto>>;
+    buildSellNativeCurrencyTxFromQuote(quoteResults: raw.QuoteResultsDto, from: string, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.BuiltSellNativeCurrencyTxDto>>;
+    getCowProtocolAllowance(params: raw.AllowanceParametersInput, readContractCallback: ContractReadCallback, options?: SdkClientOptions | null): Promise<WasmEnvelope<string>>;
+    buildApprovalTx(params: raw.ApprovalParametersInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.TransactionRequestDto>>;
+    getQuote(params: raw.SwapParametersInput, options?: SdkClientOptions | null): Promise<WasmEnvelope<raw.QuoteResultsDto>>;
+    postLimitOrder(params: raw.LimitTradeParametersInput, owner: string, signerCallback: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    postSwapOrder(params: raw.SwapParametersInput, owner: string, signerCallback: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    postSwapOrderFromQuote(quoteResults: raw.QuoteResultsDto, owner: string, signerCallback: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    postSwapOrderWithEip1271(params: raw.SwapParametersInput, owner: string, customCallback: CustomEip1271Callback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.OrderPostingResultDto>>;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare function appDataDoc(doc: raw.AppDataDocInput): WasmEnvelope<raw.AppDataDocDto>;
+export declare function appDataHexToCid(appDataHex: string): WasmEnvelope<string>;
+export declare function appDataInfo(doc: raw.AppDataDocInput): WasmEnvelope<raw.AppDataInfoDto>;
+export declare function buildCancelOrderTx(params: raw.OrderTraderParametersInput): WasmEnvelope<raw.TransactionRequestDto>;
+export declare function buildPresignTx(params: raw.OrderTraderParametersInput): WasmEnvelope<raw.TransactionRequestDto>;
+export declare function cidToAppDataHex(cid: string): WasmEnvelope<string>;
+export declare function computeOrderUid(input: raw.OrderInput, chainId: number, owner: string): WasmEnvelope<raw.GeneratedOrderUidDto>;
+export declare function decodeEthFlowLog(log: raw.EventLogInput): WasmEnvelope<raw.EthFlowEventDto>;
+export declare function decodeSettlementLog(log: raw.EventLogInput): WasmEnvelope<raw.SettlementEventDto>;
+export declare function deploymentAddresses(chainId: number, env?: string | null): WasmEnvelope<raw.DeploymentAddressesDto>;
+export declare function domainSeparator(chainId: number): string;
+export declare function eip1271SignaturePayload(input: raw.OrderInput, ecdsaSignature: string): WasmEnvelope<string>;
+export declare function orderTypedData(input: raw.OrderInput, chainId: number): WasmEnvelope<raw.TypedDataEnvelopeDto>;
+export declare function signCancellationEthSignDigest(orderUids: string[], chainId: number, digestSigner: DigestSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedCancellationsInput>>;
+export declare function signCancellationWithEip1193(orderUids: string[], chainId: number, owner: string, requestCallback: Eip1193RequestCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedCancellationsInput>>;
+export declare function signCancellationWithTypedDataSigner(orderUids: string[], chainId: number, typedDataSigner: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedCancellationsInput>>;
+export declare function signOrderEthSignDigest(input: raw.OrderInput, chainId: number, owner: string, digestSigner: DigestSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithCustomEip1271(input: raw.OrderInput, chainId: number, owner: string, customCallback: CustomEip1271Callback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithEip1193(input: raw.OrderInput, chainId: number, owner: string, requestCallback: Eip1193RequestCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithEip1271(input: raw.OrderInput, chainId: number, owner: string, typedDataSigner: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function signOrderWithTypedDataSigner(input: raw.OrderInput, chainId: number, owner: string, typedDataSigner: TypedDataSignerCallback, options?: SigningOptions | null): Promise<WasmEnvelope<raw.SignedOrderDto>>;
+export declare function supportedChainIds(): Uint32Array;
+export declare function validateAppDataDoc(doc: raw.AppDataDocInput): WasmEnvelope<raw.ValidationResultDto>;
+export declare function wasmVersion(): string;
+export type { AllowanceParametersInput, AmountsDto, AppDataDocDto, AppDataDocInput, AppDataInfoDto, AppDataObjectDto, ApprovalParametersInput, BuiltSellNativeCurrencyTxDto, CompetitionAuctionDto, CompetitionOrderStatusDto, CompetitionOrderStatusKindDto, ContractCallDto, CostsDto, CowEip1271SignRequest, CowEnvDto, DeploymentAddressesDto, Eip1193Request, EthFlowEventDto, EthflowDataDto, EventLogInput, ExecutedAmountsDto, ExecutedProtocolFeeDto, FeeComponentDto, GeneratedOrderUidDto, InteractionDataDto, LimitTradeParametersInput, NativePriceResponseDto, NetworkFeeDto, OnchainOrderDataDto, OrderClassDto, OrderCreationInput, OrderDataDto, OrderDto, OrderInput, OrderInteractionsDto, OrderKindDto, OrderPostingResultDto, OrderQuoteRequestInput, OrderQuoteResponseDto, OrderStatusDto, OrderTraderParametersInput, OrderBookRuntimeBindingDto, PaginationOptions, PartnerFeeDto, PartnerFeeInput, PartnerFeePolicyDto, PartnerFeePolicyInput, QuoteAmountsAndCostsDto, QuoteDataDto, QuoteResultsDto, SettlementEventDto, SignedCancellationsInput, SignedOrderDto, SigningSchemeDto, SolverCompetitionOrderDto, SolverCompetitionResponseDto, SolverExecutionDto, SolverSettlementDto, StoredOrderQuoteDto, SubgraphQueryInput, SwapParametersInput, TokenBalanceDto, TotalSurplusDto, TradeDto, TradeParametersDto, TradesQueryInput, TradingAppDataInfoDto, TransactionRequestDto, TypedDataDomainDto, TypedDataEnvelopeDto, TypedDataFieldDto, ValidationResultDto } from "./raw/default.js";
+export type { ContractReadCallback, CowEip1271SignCallback, CowEnv, CustomEip1271Callback, DigestSignerCallback, Eip1193RequestCallback, TypedDataSignerCallback } from "./callbacks.js";
+export type { OrderBookRejectionCategory, CowError } from "./errors.js";
+export type { SchemaVersion, WasmEnvelope } from "./envelope.js";
+export type { CowFetchCallback, CowFetchRequest, CowFetchResponse, HttpTransportConfig, IpfsClientConfig, JitterStrategyConfig, LimiterScopeConfig, RequestRateLimiterConfig, RetryPolicyConfig, SdkClientOptions, SigningOptions, SubgraphClientConfig, TradingClientConfig, TransportPolicyConfig, WalletConfig } from "./options.js";