@kayibal/fynd-client 0.1.0

package/dist/client.js

@@ -0,0 +1,498 @@
+import { decodeAbiParameters, encodeFunctionData, keccak256, serializeTransaction, toHex } from 'viem';
+import { createFyndClient } from "./autogen.js";
+import { FyndError } from "./error.js";
+import * as mapping from "./mapping.js";
+import { DEFAULT_SETTLE_TIMEOUT_MS, } from "./signing.js";
+const ERC20_APPROVE_ABI = [{
+        name: 'approve', type: 'function',
+        inputs: [{ name: 'spender', type: 'address' }, { name: 'amount', type: 'uint256' }],
+        outputs: [{ type: 'bool' }],
+        stateMutability: 'nonpayable',
+    }];
+// ERC-20 Transfer(address,address,uint256)
+const ERC20_TRANSFER_TOPIC = keccak256(toHex('Transfer(address,address,uint256)'));
+// ERC-6909 Transfer(address,address,address,uint256,uint256)
+const ERC6909_TRANSFER_TOPIC = keccak256(toHex('Transfer(address,address,address,uint256,uint256)'));
+/**
+ * Client for the Fynd swap routing API.
+ *
+ * Provides methods to request quotes, build signable payloads, and execute
+ * signed swap transactions on-chain.
+ *
+ * Requires `provider` for building signable payloads and executing transactions.
+ * Optionally accepts a separate `submitProvider` for broadcasting (falls back to `provider`).
+ */
+export class FyndClient {
+    constructor(options) {
+        this.infoPromise = undefined;
+        this.http = createFyndClient(options.baseUrl);
+        this.options = options;
+    }
+    /**
+     * Requests a swap quote from the solver.
+     *
+     * Retries automatically on transient server errors (`TIMEOUT`, `QUEUE_FULL`,
+     * `SERVICE_OVERLOADED`, `STALE_DATA`, `NOT_READY`) using exponential backoff
+     * with jitter. Configure retry behavior via {@link FyndClientOptions.retry}
+     * (defaults: 3 attempts, 100ms initial backoff, 2s max backoff).
+     *
+     * Each request is subject to an HTTP timeout controlled by
+     * {@link FyndClientOptions.timeoutMs} (default: 30s).
+     *
+     * @throws {FyndError} With a server error code (`NO_ROUTE_FOUND`, `INSUFFICIENT_LIQUIDITY`, etc.) on non-retryable failures.
+     * @throws {FyndError} With code `HTTP` on network-level failures.
+     */
+    async quote(params) {
+        const tokenOut = params.order.tokenOut;
+        const receiver = params.order.receiver ?? params.order.sender;
+        const retry = this.options.retry ?? {};
+        const maxAttempts = retry.maxAttempts ?? 3;
+        const initialBackoffMs = retry.initialBackoffMs ?? 100;
+        const maxBackoffMs = retry.maxBackoffMs ?? 2000;
+        const body = mapping.toWireRequest({ ...params, order: { ...params.order, receiver } });
+        let delay = initialBackoffMs;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                return await this.doQuote(body, tokenOut, receiver);
+            }
+            catch (e) {
+                if (e instanceof FyndError && e.isRetryable() && attempt < maxAttempts) {
+                    const jittered = delay * (0.75 + Math.random() * 0.5);
+                    await sleep(jittered);
+                    delay = Math.min(delay * 2, maxBackoffMs);
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        // Unreachable but satisfies TypeScript exhaustiveness
+        throw FyndError.config("retry loop exhausted without result");
+    }
+    async doQuote(body, tokenOut, receiver) {
+        const timeoutMs = this.options.timeoutMs ?? 30000;
+        const { data, error } = await this.http.POST("/v1/quote", {
+            body,
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (error !== undefined) {
+            // openapi-fetch does not yet union error shapes per status code; cast is required here
+            throw FyndError.fromWireError(error);
+        }
+        if (data === undefined) {
+            throw FyndError.config("server returned no data for successful response");
+        }
+        return mapping.fromWireQuote(data, tokenOut, receiver);
+    }
+    /**
+     * Returns the solver's health status.
+     *
+     * Unlike {@link quote}, this method does not retry on transient errors.
+     *
+     * @throws {FyndError} With a server error code if the solver reports unhealthy.
+     * @throws {FyndError} With code `HTTP` on network-level failures.
+     */
+    async health() {
+        const { data, error } = await this.http.GET("/v1/health");
+        if (error !== undefined) {
+            // GET /v1/health has no error schema, so openapi-fetch types error as the success shape;
+            // route through unknown to satisfy the type checker.
+            throw FyndError.fromWireError(error);
+        }
+        if (data === undefined) {
+            throw FyndError.config("server returned no data for health response");
+        }
+        return mapping.fromWireHealth(data);
+    }
+    /**
+     * Fetches and caches static instance metadata from `GET /v1/info`.
+     *
+     * The result is cached for the lifetime of the client. On failure, the cache
+     * is cleared so the next call retries.
+     *
+     * @throws {FyndError} With a server error code on non-OK responses.
+     * @throws {FyndError} With code `HTTP` on network-level failures.
+     */
+    async info() {
+        this.infoPromise ?? (this.infoPromise = this.fetchInfo().catch((err) => {
+            this.infoPromise = undefined;
+            throw err;
+        }));
+        return this.infoPromise;
+    }
+    async fetchInfo() {
+        const timeoutMs = this.options.timeoutMs ?? 30000;
+        const { data, error } = await this.http.GET("/v1/info", {
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (error !== undefined) {
+            throw FyndError.fromWireError(error);
+        }
+        if (data === undefined) {
+            throw FyndError.config("server returned no data for /v1/info");
+        }
+        return mapping.fromWireInstanceInfo(data);
+    }
+    /**
+     * Builds an unsigned EIP-1559 transaction payload from a quote, ready for wallet signing.
+     *
+     * Fetches the sender's nonce, current gas fees, and gas estimate from the provider
+     * unless overridden via {@link SigningHints}.
+     *
+     * The quote must include a `transaction` field (returned when `encodingOptions`
+     * is set in the quote request). The `to`, `value`, and `data` fields are read
+     * from `quote.transaction`.
+     *
+     * When `hints.simulate` is `true`, the transaction is executed via `eth_call`
+     * before returning. This catches reverts early but adds one RPC round-trip.
+     *
+     * @param quote - A quote obtained from {@link quote}. Must have `transaction` populated.
+     * @param hints - Optional overrides for nonce, gas fees, gas limit (defaults to `eth_estimateGas`), sender, and simulation.
+     * @throws {FyndError} With code `CONFIG` if `provider` or `sender` is not configured.
+     * @throws {FyndError} With code `CONFIG` if `quote.transaction` is absent (forgot `encodingOptions`).
+     * @throws {FyndError} With code `SIMULATE_FAILED` if `hints.simulate` is `true` and the `eth_call` reverts.
+     */
+    async swapPayload(quote, hints) {
+        if (quote.backend !== 'fynd') {
+            throw new Error('not implemented: Turbine backend signing');
+        }
+        return this.fyndSwapPayload(quote, hints ?? {});
+    }
+    async fyndSwapPayload(quote, hints) {
+        const senderOpt = hints.sender ?? this.options.sender;
+        if (senderOpt === undefined) {
+            throw FyndError.config("sender is required: set FyndClientOptions.sender or SigningHints.sender");
+        }
+        const sender = senderOpt;
+        const provider = this.options.provider;
+        if (provider === undefined) {
+            throw FyndError.config("provider is required for swapPayload");
+        }
+        const nonce = hints.nonce !== undefined
+            ? hints.nonce
+            : await provider.getTransactionCount({ address: sender });
+        const { maxFeePerGas, maxPriorityFeePerGas } = hints.maxFeePerGas !== undefined && hints.maxPriorityFeePerGas !== undefined
+            ? { maxFeePerGas: hints.maxFeePerGas, maxPriorityFeePerGas: hints.maxPriorityFeePerGas }
+            : await provider.estimateFeesPerGas();
+        const txData = quote.transaction;
+        if (txData === undefined) {
+            throw FyndError.config("quote has no calldata; set encodingOptions in QuoteOptions");
+        }
+        const txBase = {
+            chainId: this.options.chainId,
+            nonce,
+            maxFeePerGas,
+            maxPriorityFeePerGas,
+            to: txData.to,
+            value: txData.value,
+            data: txData.data,
+        };
+        const gas = hints.gasLimit !== undefined
+            ? hints.gasLimit
+            : await provider.estimateGas({ ...txBase, gas: 0n });
+        const tx = { ...txBase, gas };
+        if (hints.simulate === true) {
+            await provider.call(tx).catch((err) => {
+                throw FyndError.simulateFailed(`transaction simulation failed: ${String(err)}`);
+            });
+        }
+        const payload = { quote, tx };
+        return { kind: 'fynd', payload };
+    }
+    /**
+     * Broadcasts a signed order on-chain and returns a handle to await settlement.
+     *
+     * Uses `submitProvider` if configured, otherwise falls back to `provider`.
+     * The signed transaction is serialized as an EIP-1559 envelope and sent via
+     * `eth_sendRawTransaction`.
+     *
+     * Call {@link ExecutionReceipt.settle} on the returned handle to poll for
+     * the transaction receipt. Settlement polling has a default timeout of
+     * {@link DEFAULT_SETTLE_TIMEOUT_MS} (120s), configurable via {@link SettleOptions.timeoutMs}.
+     * The settled result includes `gasCost` (gasUsed * effectiveGasPrice) and
+     * `settledAmount` (parsed from ERC-20/ERC-6909 Transfer logs to the receiver).
+     *
+     * When `dryRun` is `true`, the transaction is simulated via `eth_call` and
+     * `eth_estimateGas` without broadcasting. The returned `settle()` resolves
+     * immediately with estimated gas cost and decoded return data.
+     *
+     * @param order - A signed swap from {@link assembleSignedSwap}.
+     * @param options - Set `dryRun: true` to simulate without broadcasting.
+     * @throws {FyndError} With code `CONFIG` if no provider is configured.
+     * @throws {FyndError} With code `CONFIG` if the signature has an invalid v byte.
+     * @throws {FyndError} With code `SIMULATE_FAILED` when `dryRun` is `true` and the simulation reverts.
+     * @throws {FyndError} With code `EXECUTION_REVERTED` when the mined transaction reverts.
+     */
+    async executeSwap(order, options) {
+        const { payload, signature } = order;
+        const tx = payload.payload.tx;
+        const quote = payload.payload.quote;
+        if (options?.dryRun === true) {
+            return this.dryRunExecute(tx, quote);
+        }
+        const provider = this.options.submitProvider ?? this.options.provider;
+        if (provider === undefined) {
+            throw FyndError.config("provider is required for executeSwap");
+        }
+        const txHash = await this.serializeAndBroadcast(tx, signature);
+        const tokenOut = quote.tokenOut;
+        const receiver = quote.receiver;
+        return {
+            settle: async (options) => {
+                const timeoutMs = options?.timeoutMs ?? DEFAULT_SETTLE_TIMEOUT_MS;
+                const receipt = await this.pollForReceipt(provider, txHash, timeoutMs);
+                if (receipt.status === 0) {
+                    const reason = this.options.fetchRevertReason !== false
+                        ? await this.getRevertReason(provider, tx, txHash)
+                        : 'revert reason fetching disabled';
+                    throw FyndError.executionReverted(`swap reverted: ${reason}`);
+                }
+                const settledAmount = computeSettledAmount(receipt, tokenOut, receiver);
+                const gasCost = receipt.gasUsed * receipt.effectiveGasPrice;
+                // exactOptionalPropertyTypes: spread optional fields only when defined
+                return {
+                    txHash,
+                    gasCost,
+                    ...(settledAmount !== undefined ? { settledAmount } : {}),
+                };
+            },
+        };
+    }
+    async serializeAndBroadcast(tx, signature) {
+        const provider = this.options.submitProvider ?? this.options.provider;
+        if (provider === undefined) {
+            throw FyndError.config("provider is required for broadcast");
+        }
+        // Parse r, s, yParity from the 65-byte hex signature: r[32] + s[32] + v[1]
+        // signature is '0x' + 130 hex chars (65 bytes)
+        const r = `0x${signature.slice(2, 66)}`;
+        const s = `0x${signature.slice(66, 130)}`;
+        const vByte = parseInt(signature.slice(130, 132), 16);
+        // Normalize: legacy v=27/28 → yParity 0/1; EIP-1559 v=0/1 pass through
+        const vNormalized = vByte === 27 ? 0 : vByte === 28 ? 1 : vByte;
+        if (vNormalized !== 0 && vNormalized !== 1) {
+            throw FyndError.config(`invalid signature v byte: ${vByte}`);
+        }
+        const yParity = vNormalized;
+        const rawTx = serializeTransaction({
+            type: 'eip1559',
+            chainId: tx.chainId,
+            nonce: tx.nonce,
+            maxFeePerGas: tx.maxFeePerGas,
+            maxPriorityFeePerGas: tx.maxPriorityFeePerGas,
+            gas: tx.gas,
+            to: tx.to,
+            value: tx.value,
+            data: tx.data,
+        }, { r, s, yParity });
+        return provider.sendRawTransaction(rawTx);
+    }
+    async getRevertReason(provider, tx, txHash) {
+        if (provider.debugTraceTransaction !== undefined) {
+            try {
+                const trace = await provider.debugTraceTransaction(txHash);
+                return decodeRevertData(trace.output);
+            }
+            catch { /* fall through to eth_call */ }
+        }
+        console.warn('[fynd] debug_traceTransaction unavailable; replaying via eth_call — ' +
+            'revert reason may differ if block state has changed since execution');
+        return provider.call(tx).then(() => 'transaction reverted with no revert data', (err) => String(err));
+    }
+    async pollForReceipt(provider, txHash, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        for (;;) {
+            const receipt = await provider.getTransactionReceipt({ hash: txHash });
+            if (receipt !== null) {
+                return receipt;
+            }
+            if (Date.now() >= deadline) {
+                throw FyndError.timeout(`transaction ${txHash} did not settle within ${timeoutMs}ms`);
+            }
+            await sleep(2000);
+        }
+    }
+    /**
+     * Builds an unsigned EIP-1559 `approve(spender, amount)` transaction for the given token,
+     * or `null` if the approval is not needed.
+     *
+     * Returns `null` immediately when `params.transferType` is `'none'`.
+     * When `params.checkAllowance` is `true`, reads the on-chain allowance first and returns
+     * `null` if it is already sufficient (skipping nonce and fee resolution).
+     *
+     * Fetches the spender address from `GET /v1/info` (cached after first call):
+     * `'transfer_from'` → router, `'transfer_from_permit2'` → Permit2.
+     * Reads nonce and gas fees from `provider` unless overridden via `hints`.
+     * Gas defaults to `hints.gasLimit ?? 65_000n`.
+     *
+     * @param params - Token, amount, transfer type, and optional allowance-check flag.
+     * @param hints - Optional overrides for sender, nonce, gas fees, and gas limit.
+     * @throws {FyndError} With code `CONFIG` if `provider` or `sender` is not configured.
+     * @throws {FyndError} With code `CONFIG` if `params.checkAllowance` is `true` and `provider.readAllowance` is absent.
+     */
+    async approval(params, hints) {
+        if (params.transferType === 'none')
+            return null;
+        const info = await this.info();
+        const spender = params.transferType === 'transfer_from_permit2'
+            ? info.permit2Address
+            : info.routerAddress;
+        const provider = this.options.provider;
+        if (provider === undefined)
+            throw FyndError.config("provider is required for approval");
+        const senderOpt = hints?.sender ?? this.options.sender;
+        if (senderOpt === undefined)
+            throw FyndError.config("sender is required for approval");
+        const sender = senderOpt;
+        const { token, amount } = params;
+        if (params.checkAllowance === true) {
+            if (provider.readAllowance === undefined) {
+                throw FyndError.config("provider.readAllowance is required when checkAllowance is true");
+            }
+            const current = await provider.readAllowance(token, sender, spender);
+            if (current >= amount)
+                return null;
+        }
+        const nonce = hints?.nonce !== undefined
+            ? hints.nonce
+            : await provider.getTransactionCount({ address: sender });
+        const { maxFeePerGas, maxPriorityFeePerGas } = hints?.maxFeePerGas !== undefined && hints?.maxPriorityFeePerGas !== undefined
+            ? { maxFeePerGas: hints.maxFeePerGas, maxPriorityFeePerGas: hints.maxPriorityFeePerGas }
+            : await provider.estimateFeesPerGas();
+        const gas = hints?.gasLimit ?? 65000n;
+        const data = encodeFunctionData({
+            abi: ERC20_APPROVE_ABI,
+            functionName: 'approve',
+            args: [spender, amount],
+        });
+        const tx = {
+            chainId: this.options.chainId,
+            nonce,
+            maxFeePerGas,
+            maxPriorityFeePerGas,
+            gas,
+            to: token,
+            value: 0n,
+            data,
+        };
+        return { tx, token, spender, amount };
+    }
+    /**
+     * Broadcasts a signed ERC-20 approval and polls for inclusion.
+     *
+     * @param signedApproval - Signed approval from {@link approval} + wallet signature.
+     * @param options - Optional poll timeout (defaults to {@link DEFAULT_SETTLE_TIMEOUT_MS}).
+     * @throws {FyndError} With code `CONFIG` if no provider is configured.
+     * @throws {FyndError} With code `SETTLE_TIMEOUT` if the transaction does not confirm in time.
+     * @throws {FyndError} With code `EXECUTION_REVERTED` when the mined transaction reverts.
+     */
+    async executeApproval(signedApproval, options) {
+        const provider = this.options.submitProvider ?? this.options.provider;
+        if (provider === undefined)
+            throw FyndError.config("provider is required for executeApproval");
+        const txHash = await this.serializeAndBroadcast(signedApproval.tx, signedApproval.signature);
+        const receipt = await this.pollForReceipt(provider, txHash, options?.timeoutMs ?? DEFAULT_SETTLE_TIMEOUT_MS);
+        if (receipt.status === 0) {
+            const reason = this.options.fetchRevertReason !== false
+                ? await this.getRevertReason(provider, signedApproval.tx, txHash)
+                : 'revert reason fetching disabled';
+            throw FyndError.executionReverted(`approval reverted: ${reason}`);
+        }
+        return { txHash, gasCost: receipt.gasUsed * receipt.effectiveGasPrice };
+    }
+    async dryRunExecute(tx, quote) {
+        const provider = this.options.provider;
+        if (provider === undefined) {
+            throw FyndError.config("provider is required for dry-run execute");
+        }
+        const callResult = await provider.call(tx).catch((err) => {
+            throw FyndError.simulateFailed(`dry run simulation failed: ${String(err)}`);
+        });
+        const gasUsed = await provider.estimateGas(tx).catch((err) => {
+            throw FyndError.simulateFailed(`dry run gas estimation failed: ${String(err)}`);
+        });
+        // Parse first 32 bytes of return data as uint256 settled amount.
+        // Hex string: '0x' + 64 hex chars = 66 chars total for 32 bytes.
+        const returnData = callResult.data;
+        const settledAmount = returnData !== undefined && returnData.length >= 66
+            ? BigInt(`0x${returnData.slice(2, 66)}`)
+            : undefined;
+        const gasCost = gasUsed * tx.maxFeePerGas;
+        // No txHash for dry-run
+        void quote;
+        return {
+            settle: async () => ({
+                gasCost,
+                // exactOptionalPropertyTypes: spread optional fields only when defined
+                ...(settledAmount !== undefined ? { settledAmount } : {}),
+            }),
+        };
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function computeSettledAmount(receipt, tokenOut, receiver) {
+    let total = 0n;
+    let found = false;
+    for (const log of receipt.logs) {
+        if (log.address.toLowerCase() !== tokenOut.toLowerCase())
+            continue;
+        if (log.topics.length === 0)
+            continue;
+        const topic0 = log.topics[0];
+        if (topic0 === undefined)
+            continue;
+        if (topic0 === ERC20_TRANSFER_TOPIC && log.topics.length >= 3) {
+            // topics[2] = to address (padded to 32 bytes, address in last 20 bytes)
+            const toTopic = log.topics[2];
+            if (toTopic === undefined)
+                continue;
+            const toAddr = `0x${toTopic.slice(-40)}`;
+            if (toAddr.toLowerCase() === receiver.toLowerCase()) {
+                // data = uint256 amount (32 bytes = 64 hex chars after '0x')
+                const amount = BigInt(`0x${log.data.slice(2, 66)}`);
+                total += amount;
+                found = true;
+            }
+        }
+        else if (topic0 === ERC6909_TRANSFER_TOPIC && log.topics.length >= 3) {
+            // topics[2] = to address
+            const toTopic = log.topics[2];
+            if (toTopic === undefined)
+                continue;
+            const toAddr = `0x${toTopic.slice(-40)}`;
+            if (toAddr.toLowerCase() === receiver.toLowerCase()) {
+                // data layout: caller[32 bytes] + amount[32 bytes]
+                // amount starts at byte offset 32 → hex positions 2+64=66 to 66+64=130
+                const amount = BigInt(`0x${log.data.slice(66, 130)}`);
+                total += amount;
+                found = true;
+            }
+        }
+    }
+    return found ? total : undefined;
+}
+const ERROR_SELECTOR = '0x08c379a0';
+const PANIC_SELECTOR = '0x4e487b71';
+/** Decode a Solidity revert payload into a human-readable string. */
+function decodeRevertData(output) {
+    if (output === '0x')
+        return 'empty revert data';
+    if (output.startsWith(ERROR_SELECTOR) && output.length > 10) {
+        try {
+            const [msg] = decodeAbiParameters([{ type: 'string' }], `0x${output.slice(10)}`);
+            return msg;
+        }
+        catch { /* fall through */ }
+    }
+    if (output.startsWith(PANIC_SELECTOR) && output.length > 10) {
+        try {
+            const [code] = decodeAbiParameters([{ type: 'uint256' }], `0x${output.slice(10)}`);
+            return `Panic(${code})`;
+        }
+        catch { /* fall through */ }
+    }
+    return `revert data: ${output}`;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/error.d.ts

@@ -0,0 +1,38 @@
+import type { components } from "./autogen.js";
+type WireErrorResponse = components["schemas"]["ErrorResponse"];
+/** Error code returned by the Fynd server. Kept in sync with the server schema. */
+export type ServerErrorCode = 'BAD_REQUEST' | 'NO_ROUTE_FOUND' | 'INSUFFICIENT_LIQUIDITY' | 'TIMEOUT' | 'QUEUE_FULL' | 'SERVICE_OVERLOADED' | 'STALE_DATA' | 'INVALID_ORDER' | 'INTERNAL_ERROR' | 'NOT_READY' | 'ALGORITHM_ERROR' | {
+    kind: 'UNKNOWN';
+    raw: string;
+};
+/** Error code originating from the client SDK itself. */
+export type ClientErrorCode = 'HTTP' | 'DESERIALIZE' | 'CONFIG' | 'SIMULATE_FAILED' | 'SETTLE_TIMEOUT' | 'EXECUTION_REVERTED';
+/** Union of all error codes, covering both server and client errors. */
+export type ErrorCode = ServerErrorCode | ClientErrorCode;
+/**
+ * Typed error thrown by all Fynd client operations.
+ *
+ * Use {@link FyndError.code} to programmatically handle specific failure modes,
+ * and {@link FyndError.isRetryable} to decide whether to retry.
+ */
+export declare class FyndError extends Error {
+    /** Machine-readable error code identifying the failure category. */
+    readonly code: ErrorCode;
+    /** Optional structured details from the server error response. */
+    readonly details?: unknown;
+    constructor(message: string, code: ErrorCode, details?: unknown);
+    /** Returns `true` if the error is transient and the operation can be retried. */
+    isRetryable(): boolean;
+    /** Creates a `FyndError` from a server error response or unstructured error. */
+    static fromWireError(wire: WireErrorResponse | unknown): FyndError;
+    /** Creates a `CONFIG` error for invalid or missing client configuration. */
+    static config(message: string): FyndError;
+    /** Creates a `SIMULATE_FAILED` error when an on-chain simulation reverts. */
+    static simulateFailed(reason: string): FyndError;
+    /** Creates a `SETTLE_TIMEOUT` error when transaction confirmation takes too long. */
+    static timeout(message: string): FyndError;
+    /** Creates an `EXECUTION_REVERTED` error when a mined transaction reverts. */
+    static executionReverted(reason: string): FyndError;
+}
+export {};
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC;AAEhE,mFAAmF;AACnF,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,gBAAgB,GAChB,wBAAwB,GACxB,SAAS,GACT,YAAY,GACZ,oBAAoB,GACpB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,iBAAiB,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAE9H,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAyB1D;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO;IAS/D,iFAAiF;IACjF,WAAW,IAAI,OAAO;IAOtB,gFAAgF;IAChF,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS;IAclE,4EAA4E;IAC5E,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAIzC,6EAA6E;IAC7E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAIhD,qFAAqF;IACrF,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAI1C,8EAA8E;IAC9E,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;CAGpD"}

package/dist/error.js

@@ -0,0 +1,75 @@
+const KNOWN_SERVER_CODES = new Set([
+    'BAD_REQUEST',
+    'NO_ROUTE_FOUND',
+    'INSUFFICIENT_LIQUIDITY',
+    'TIMEOUT',
+    'QUEUE_FULL',
+    'SERVICE_OVERLOADED',
+    'STALE_DATA',
+    'INVALID_ORDER',
+    'INTERNAL_ERROR',
+    'NOT_READY',
+    'ALGORITHM_ERROR',
+]);
+const RETRYABLE_CODES = new Set([
+    'TIMEOUT',
+    'QUEUE_FULL',
+    'SERVICE_OVERLOADED',
+    'STALE_DATA',
+    'NOT_READY',
+    'HTTP',
+]);
+/**
+ * Typed error thrown by all Fynd client operations.
+ *
+ * Use {@link FyndError.code} to programmatically handle specific failure modes,
+ * and {@link FyndError.isRetryable} to decide whether to retry.
+ */
+export class FyndError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.name = 'FyndError';
+        this.code = code;
+        if (details !== undefined) {
+            this.details = details;
+        }
+    }
+    /** Returns `true` if the error is transient and the operation can be retried. */
+    isRetryable() {
+        if (typeof this.code === 'string') {
+            return RETRYABLE_CODES.has(this.code);
+        }
+        return false;
+    }
+    /** Creates a `FyndError` from a server error response or unstructured error. */
+    static fromWireError(wire) {
+        const obj = wire;
+        const rawCode = obj['code'];
+        const rawError = obj['error'];
+        if (typeof rawCode !== 'string' || typeof rawError !== 'string') {
+            const message = typeof wire === 'string' ? wire : JSON.stringify(wire);
+            return new FyndError(message, 'HTTP');
+        }
+        const code = KNOWN_SERVER_CODES.has(rawCode)
+            ? rawCode
+            : { kind: 'UNKNOWN', raw: rawCode };
+        return new FyndError(rawError, code, obj['details']);
+    }
+    /** Creates a `CONFIG` error for invalid or missing client configuration. */
+    static config(message) {
+        return new FyndError(message, 'CONFIG');
+    }
+    /** Creates a `SIMULATE_FAILED` error when an on-chain simulation reverts. */
+    static simulateFailed(reason) {
+        return new FyndError(reason, 'SIMULATE_FAILED');
+    }
+    /** Creates a `SETTLE_TIMEOUT` error when transaction confirmation takes too long. */
+    static timeout(message) {
+        return new FyndError(message, 'SETTLE_TIMEOUT');
+    }
+    /** Creates an `EXECUTION_REVERTED` error when a mined transaction reverts. */
+    static executionReverted(reason) {
+        return new FyndError(reason, 'EXECUTION_REVERTED');
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAyBA,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,aAAa;IACb,gBAAgB;IAChB,wBAAwB;IACxB,SAAS;IACT,YAAY;IACZ,oBAAoB;IACpB,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,iBAAiB;CAClB,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS;IACtC,SAAS;IACT,YAAY;IACZ,oBAAoB;IACpB,YAAY;IACZ,WAAW;IACX,MAAM;CACP,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAMlC,YAAY,OAAe,EAAE,IAAe,EAAE,OAAiB;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,WAAW;QACT,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,aAAa,CAAC,IAAiC;QACpD,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACvE,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,GAAc,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC;YACrD,CAAC,CAAE,OAA2B;YAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QACtC,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,MAAM,CAAC,OAAe;QAC3B,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,cAAc,CAAC,MAAc;QAClC,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAClD,CAAC;IAED,qFAAqF;IACrF,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED,8EAA8E;IAC9E,MAAM,CAAC,iBAAiB,CAAC,MAAc;QACrC,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACrD,CAAC;CACF"}