@symbiome-forge/cow-sdk-wasm 0.1.0-alpha.1

package/dist/cloudflare/raw/cloudflare.js

@@ -0,0 +1,29 @@
+import init, * as wasm from "../../raw/cloudflare-web/cow_sdk_wasm.js";
+export const initializeRaw = init;
+export const RawOrderBookClient = wasm.OrderBookClient;
+export const RawTradingClient = wasm.TradingClient;
+export const __cow_sdk_wasm_init = wasm.__cow_sdk_wasm_init;
+export const appDataDoc = wasm.appDataDoc;
+export const appDataHexToCid = wasm.appDataHexToCid;
+export const appDataInfo = wasm.appDataInfo;
+export const buildCancelOrderTx = wasm.buildCancelOrderTx;
+export const buildPresignTx = wasm.buildPresignTx;
+export const cidToAppDataHex = wasm.cidToAppDataHex;
+export const computeOrderUid = wasm.computeOrderUid;
+export const decodeEthFlowLog = wasm.decodeEthFlowLog;
+export const decodeSettlementLog = wasm.decodeSettlementLog;
+export const deploymentAddresses = wasm.deploymentAddresses;
+export const domainSeparator = wasm.domainSeparator;
+export const eip1271SignaturePayload = wasm.eip1271SignaturePayload;
+export const orderTypedData = wasm.orderTypedData;
+export const signCancellationEthSignDigest = wasm.signCancellationEthSignDigest;
+export const signCancellationWithEip1193 = wasm.signCancellationWithEip1193;
+export const signCancellationWithTypedDataSigner = wasm.signCancellationWithTypedDataSigner;
+export const signOrderEthSignDigest = wasm.signOrderEthSignDigest;
+export const signOrderWithCustomEip1271 = wasm.signOrderWithCustomEip1271;
+export const signOrderWithEip1193 = wasm.signOrderWithEip1193;
+export const signOrderWithEip1271 = wasm.signOrderWithEip1271;
+export const signOrderWithTypedDataSigner = wasm.signOrderWithTypedDataSigner;
+export const supportedChainIds = wasm.supportedChainIds;
+export const validateAppDataDoc = wasm.validateAppDataDoc;
+export const wasmVersion = wasm.wasmVersion;

package/dist/default/callbacks.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/default/callbacks.d.ts

@@ -0,0 +1,55 @@
+export type SupportedChainId = 1 | 100 | 137 | 8453 | 42161 | 43114 | 56 | 11155111 | 9745 | 57073 | 59144;
+export type CowEnv = "prod" | "staging";
+export type CowFetchMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+export interface CowFetchRequest {
+    method: CowFetchMethod;
+    url: string;
+    headers: Record<string, string>;
+    body?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface CowFetchResponse {
+    status: number;
+    statusText?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}
+export type CowFetchCallback = (request: CowFetchRequest) => Promise<CowFetchResponse> | CowFetchResponse;
+export interface TypedDataDomainDto {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: string;
+}
+export interface TypedDataFieldDto {
+    name: string;
+    type: string;
+}
+export interface TypedDataEnvelopeDto {
+    domain: TypedDataDomainDto;
+    types: Record<string, TypedDataFieldDto[]>;
+    primaryType: string;
+    message: unknown;
+}
+export interface CowEip1271SignRequest {
+    order: unknown;
+    typedData: TypedDataEnvelopeDto;
+    owner: string;
+    chainId: number;
+}
+export interface ContractCallDto {
+    address: string;
+    method: string;
+    abiJson: string;
+    argsJson: string;
+}
+export type TypedDataSignerCallback = (envelope: TypedDataEnvelopeDto) => Promise<string> | string;
+export type Eip1193RequestCallback = (request: {
+    method: string;
+    params?: unknown[];
+}) => Promise<unknown> | unknown;
+export type DigestSignerCallback = (digest: string) => Promise<string> | string;
+export type CowEip1271SignCallback = (request: CowEip1271SignRequest) => Promise<string> | string;
+export type CustomEip1271Callback = CowEip1271SignCallback;
+export type ContractReadCallback = (request: ContractCallDto) => Promise<string> | string;

package/dist/default/callbacks.js

@@ -0,0 +1 @@
+export {};

package/dist/default/envelope.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/default/envelope.d.ts

@@ -0,0 +1,5 @@
+export type SchemaVersion = "v1" | "__unknown";
+export interface WasmEnvelope<T> {
+    schemaVersion: SchemaVersion;
+    value: T;
+}

package/dist/default/envelope.js

@@ -0,0 +1 @@
+export {};

package/dist/default/errors.cjs

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeError = normalizeError;
+exports.cancelledError = cancelledError;
+exports.invalidInput = invalidInput;
+const knownKinds = new Set([
+    "invalidInput",
+    "unknownEnumValue",
+    "unsupportedChain",
+    "walletRequest",
+    "walletTimeout",
+    "transport",
+    "orderbook",
+    "subgraph",
+    "signing",
+    "appData",
+    "cancelled",
+    "internal",
+    "__unknown"
+]);
+function normalizeError(raw) {
+    if (isRecord(raw)) {
+        // The Rust `WasmError` serializes with serde `rename_all(_fields) = "camelCase"`
+        // through a json-compatible serializer, so it already crosses the boundary as a
+        // camelCase plain object — no field renaming is needed here.
+        const normalized = raw;
+        const kind = typeof normalized.kind === "string" ? normalized.kind : undefined;
+        if (kind && knownKinds.has(kind)) {
+            const schemaVersion = normalized.schemaVersion === "__unknown" ? "__unknown" : "v1";
+            if (kind === "__unknown") {
+                return {
+                    schemaVersion,
+                    kind: "__unknown",
+                    message: unknownMessage(),
+                    raw: normalized.raw ?? raw
+                };
+            }
+            return withActionableMessage({
+                ...normalized,
+                schemaVersion,
+                kind
+            });
+        }
+        if (kind) {
+            return {
+                schemaVersion: normalized.schemaVersion === "__unknown" ? "__unknown" : "v1",
+                kind: "__unknown",
+                message: unknownMessage(),
+                raw
+            };
+        }
+    }
+    if (raw instanceof Error) {
+        return (classifyDeserializationFailure(raw.message) ?? {
+            schemaVersion: "v1",
+            kind: "internal",
+            message: internalMessage(raw.message)
+        });
+    }
+    return (classifyDeserializationFailure(String(raw)) ?? {
+        schemaVersion: "v1",
+        kind: "internal",
+        message: internalMessage(String(raw))
+    });
+}
+// Input-DTO deserialization failures cross the wasm boundary as a plain
+// `Error`: the generated wasm-bindgen glue throws the serde message, so it
+// never carries a structured `kind`. These are CALLER input errors — a value
+// that does not match the documented input type (unknown enum variant,
+// missing/unknown field, wrong type) — not SDK-internal faults, so they must
+// normalize to `invalidInput` rather than `internal` (whose contract implies
+// an SDK bug). The verbatim detail is preserved because it already names the
+// offending field/variant and the expected set, e.g.
+// "unknown variant `teleport`, expected `sell` or `buy`".
+const DESERIALIZATION_FAILURE_PATTERNS = [
+    /unknown variant `/,
+    /missing field `/,
+    /unknown field `/,
+    /duplicate field `/,
+    /invalid type:/,
+    /invalid length\b/,
+    /invalid value:/,
+    /data did not match any variant/
+];
+function classifyDeserializationFailure(message) {
+    if (!DESERIALIZATION_FAILURE_PATTERNS.some((pattern) => pattern.test(message))) {
+        return undefined;
+    }
+    const detail = message.replace(/^Error:\s*/, "");
+    const field = detail.match(/(?:missing|unknown|duplicate) field `([^`]+)`/)?.[1];
+    const reason = `Invalid SDK input: ${detail}. Check the value against the documented input type and retry.`;
+    return field !== undefined
+        ? { schemaVersion: "v1", kind: "invalidInput", field, message: reason }
+        : { schemaVersion: "v1", kind: "invalidInput", message: reason };
+}
+function cancelledError() {
+    return {
+        schemaVersion: "v1",
+        kind: "cancelled",
+        message: "Operation was cancelled. Create a fresh AbortController or retry without an already-aborted signal."
+    };
+}
+function invalidInput(field, reason) {
+    return {
+        schemaVersion: "v1",
+        kind: "invalidInput",
+        field,
+        message: `Invalid \`${field}\`: ${reason}. Check the value supplied for \`${field}\` and retry with a valid SDK input.`
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function withActionableMessage(error) {
+    if ("message" in error && typeof error.message === "string" && error.message.length > 0) {
+        return error;
+    }
+    switch (error.kind) {
+        case "unknownEnumValue":
+            return {
+                ...error,
+                message: `Unsupported value \`${error.value}\` for \`${error.field}\`. Use one of the documented values for this field.`
+            };
+        case "unsupportedChain":
+            return {
+                ...error,
+                message: `Unsupported chain ID ${error.chainId}. Call supportedChainIds() before constructing requests and route unsupported networks to another integration.`
+            };
+        case "walletTimeout":
+            return {
+                ...error,
+                message: `Wallet request timed out after ${error.timeoutMs} ms. Increase walletConfig.timeoutMs or ask the user to approve the wallet request before the timeout.`
+            };
+        case "cancelled":
+            return cancelledError();
+        case "__unknown":
+            return {
+                ...error,
+                message: unknownMessage()
+            };
+        default:
+            return error;
+    }
+}
+function internalMessage(detail) {
+    return `SDK internal error: ${detail}. This indicates serialization or invariant failure; retry with the same inputs only after checking the reported input shape.`;
+}
+function unknownMessage() {
+    return "SDK received an unrecognized error variant. Inspect raw, preserve it in logs without credentials, and update the SDK if the variant is now documented.";
+}

package/dist/default/errors.d.ts

@@ -0,0 +1,82 @@
+import type { SchemaVersion } from "./envelope.js";
+/**
+ * Coarse, switchable classification of an orderbook rejection. Lets a consumer
+ * branch on the action a rejection calls for — fix the request, fund the
+ * wallet, re-quote, wait, or escalate — without matching every wire tag. The
+ * `__unknown` member is the forward-compatible sentinel for a category a newer
+ * SDK may introduce.
+ */
+export type OrderBookRejectionCategory = "authorization" | "insufficientFunds" | "invalidOrder" | "notFound" | "conflict" | "unfulfillable" | "server" | "__unknown";
+export type CowError = {
+    schemaVersion: "v1";
+    kind: "invalidInput";
+    message: string;
+    field?: string;
+} | {
+    schemaVersion: "v1";
+    kind: "unknownEnumValue";
+    message: string;
+    field: string;
+    value: string;
+} | {
+    schemaVersion: "v1";
+    kind: "unsupportedChain";
+    message: string;
+    chainId: number;
+} | {
+    schemaVersion: "v1";
+    kind: "walletRequest";
+    method: string;
+    code?: number;
+    message: string;
+} | {
+    schemaVersion: "v1";
+    kind: "walletTimeout";
+    message: string;
+    timeoutMs: number;
+} | {
+    schemaVersion: "v1";
+    kind: "transport";
+    class: string;
+    message: string;
+    status?: number;
+    headers?: [string, string][];
+    body?: string;
+} | {
+    schemaVersion: "v1";
+    kind: "orderbook";
+    code?: string;
+    category?: OrderBookRejectionCategory;
+    message: string;
+    retryable: boolean;
+    retryAfterMs?: number;
+} | {
+    schemaVersion: "v1";
+    kind: "subgraph";
+    message: string;
+} | {
+    schemaVersion: "v1";
+    kind: "signing";
+    message: string;
+} | {
+    schemaVersion: "v1";
+    kind: "appData";
+    class?: string;
+    message: string;
+} | {
+    schemaVersion: "v1";
+    kind: "cancelled";
+    message: string;
+} | {
+    schemaVersion: "v1";
+    kind: "internal";
+    message: string;
+} | {
+    schemaVersion: SchemaVersion;
+    kind: "__unknown";
+    message: string;
+    raw: unknown;
+};
+export declare function normalizeError(raw: unknown): CowError;
+export declare function cancelledError(): CowError;
+export declare function invalidInput(field: string, reason: string): CowError;

package/dist/default/errors.js

@@ -0,0 +1,145 @@
+const knownKinds = new Set([
+    "invalidInput",
+    "unknownEnumValue",
+    "unsupportedChain",
+    "walletRequest",
+    "walletTimeout",
+    "transport",
+    "orderbook",
+    "subgraph",
+    "signing",
+    "appData",
+    "cancelled",
+    "internal",
+    "__unknown"
+]);
+export function normalizeError(raw) {
+    if (isRecord(raw)) {
+        // The Rust `WasmError` serializes with serde `rename_all(_fields) = "camelCase"`
+        // through a json-compatible serializer, so it already crosses the boundary as a
+        // camelCase plain object — no field renaming is needed here.
+        const normalized = raw;
+        const kind = typeof normalized.kind === "string" ? normalized.kind : undefined;
+        if (kind && knownKinds.has(kind)) {
+            const schemaVersion = normalized.schemaVersion === "__unknown" ? "__unknown" : "v1";
+            if (kind === "__unknown") {
+                return {
+                    schemaVersion,
+                    kind: "__unknown",
+                    message: unknownMessage(),
+                    raw: normalized.raw ?? raw
+                };
+            }
+            return withActionableMessage({
+                ...normalized,
+                schemaVersion,
+                kind
+            });
+        }
+        if (kind) {
+            return {
+                schemaVersion: normalized.schemaVersion === "__unknown" ? "__unknown" : "v1",
+                kind: "__unknown",
+                message: unknownMessage(),
+                raw
+            };
+        }
+    }
+    if (raw instanceof Error) {
+        return (classifyDeserializationFailure(raw.message) ?? {
+            schemaVersion: "v1",
+            kind: "internal",
+            message: internalMessage(raw.message)
+        });
+    }
+    return (classifyDeserializationFailure(String(raw)) ?? {
+        schemaVersion: "v1",
+        kind: "internal",
+        message: internalMessage(String(raw))
+    });
+}
+// Input-DTO deserialization failures cross the wasm boundary as a plain
+// `Error`: the generated wasm-bindgen glue throws the serde message, so it
+// never carries a structured `kind`. These are CALLER input errors — a value
+// that does not match the documented input type (unknown enum variant,
+// missing/unknown field, wrong type) — not SDK-internal faults, so they must
+// normalize to `invalidInput` rather than `internal` (whose contract implies
+// an SDK bug). The verbatim detail is preserved because it already names the
+// offending field/variant and the expected set, e.g.
+// "unknown variant `teleport`, expected `sell` or `buy`".
+const DESERIALIZATION_FAILURE_PATTERNS = [
+    /unknown variant `/,
+    /missing field `/,
+    /unknown field `/,
+    /duplicate field `/,
+    /invalid type:/,
+    /invalid length\b/,
+    /invalid value:/,
+    /data did not match any variant/
+];
+function classifyDeserializationFailure(message) {
+    if (!DESERIALIZATION_FAILURE_PATTERNS.some((pattern) => pattern.test(message))) {
+        return undefined;
+    }
+    const detail = message.replace(/^Error:\s*/, "");
+    const field = detail.match(/(?:missing|unknown|duplicate) field `([^`]+)`/)?.[1];
+    const reason = `Invalid SDK input: ${detail}. Check the value against the documented input type and retry.`;
+    return field !== undefined
+        ? { schemaVersion: "v1", kind: "invalidInput", field, message: reason }
+        : { schemaVersion: "v1", kind: "invalidInput", message: reason };
+}
+export function cancelledError() {
+    return {
+        schemaVersion: "v1",
+        kind: "cancelled",
+        message: "Operation was cancelled. Create a fresh AbortController or retry without an already-aborted signal."
+    };
+}
+export function invalidInput(field, reason) {
+    return {
+        schemaVersion: "v1",
+        kind: "invalidInput",
+        field,
+        message: `Invalid \`${field}\`: ${reason}. Check the value supplied for \`${field}\` and retry with a valid SDK input.`
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function withActionableMessage(error) {
+    if ("message" in error && typeof error.message === "string" && error.message.length > 0) {
+        return error;
+    }
+    switch (error.kind) {
+        case "unknownEnumValue":
+            return {
+                ...error,
+                message: `Unsupported value \`${error.value}\` for \`${error.field}\`. Use one of the documented values for this field.`
+            };
+        case "unsupportedChain":
+            return {
+                ...error,
+                message: `Unsupported chain ID ${error.chainId}. Call supportedChainIds() before constructing requests and route unsupported networks to another integration.`
+            };
+        case "walletTimeout":
+            return {
+                ...error,
+                message: `Wallet request timed out after ${error.timeoutMs} ms. Increase walletConfig.timeoutMs or ask the user to approve the wallet request before the timeout.`
+            };
+        case "cancelled":
+            return cancelledError();
+        case "__unknown":
+            return {
+                ...error,
+                message: unknownMessage()
+            };
+        default:
+            return error;
+    }
+}
+function internalMessage(detail) {
+    return `SDK internal error: ${detail}. This indicates serialization or invariant failure; retry with the same inputs only after checking the reported input shape.`;
+}
+function unknownMessage() {
+    return "SDK received an unrecognized error variant. Inspect raw, preserve it in logs without credentials, and update the SDK if the variant is now documented.";
+}