@kayibal/fynd-client 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { Address, ApprovalParams, BackendKind, BlockInfo, ClientFeeParams, EncodingOptions, Hex, HealthStatus, InstanceInfo, Order, OrderSide, PermitDetails, PermitSingle, Quote, QuoteOptions, QuoteParams, Route, SolutionStatus, Swap, Transaction, UserTransferType, } from "./types.js";
+export { FyndError } from "./error.js";
+export type { ClientErrorCode, ErrorCode, ServerErrorCode } from "./error.js";
+export type { ApprovalPayload, Eip1559Transaction, ExecutionReceipt, FyndPayload, PrimitiveSignature, SettledOrder, SettleOptions, SignedApproval, SignedSwap, SwapPayload, TxReceipt, } from "./signing.js";
+export { approvalSigningHash, assembleSignedSwap, DEFAULT_SETTLE_TIMEOUT_MS, swapSigningHash } from "./signing.js";
+export { permit2SigningHash, encodingOptions, withPermit2, withVaultFunds, } from "./permit2.js";
+export { clientFeeSigningHash, withClientFee, } from "./client-fee.js";
+export { FyndClient } from "./client.js";
+export type { EthProvider, ExecutionOptions, FyndClientOptions, MinimalReceipt, RetryConfig, SigningHints, } from "./client.js";
+export { viemProvider } from "./viem.js";
+export type { ViemPublicClient } from "./viem.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,SAAS,EACT,eAAe,EACf,eAAe,EACf,GAAG,EACH,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,WAAW,EACX,KAAK,EACL,cAAc,EACd,IAAI,EACJ,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9E,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { FyndError } from "./error.js";
+export { approvalSigningHash, assembleSignedSwap, DEFAULT_SETTLE_TIMEOUT_MS, swapSigningHash } from "./signing.js";
+export { permit2SigningHash, encodingOptions, withPermit2, withVaultFunds, } from "./permit2.js";
+export { clientFeeSigningHash, withClientFee, } from "./client-fee.js";
+export { FyndClient } from "./client.js";
+export { viemProvider } from "./viem.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAevC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/mapping.d.ts

@@ -0,0 +1,12 @@
+import type { components } from "./autogen.js";
+import type { Address, HealthStatus, InstanceInfo, Quote, QuoteParams } from "./types.js";
+type WireSolution = components["schemas"]["Quote"];
+type WireSolutionRequest = components["schemas"]["QuoteRequest"];
+type WireHealthStatus = components["schemas"]["HealthStatus"];
+type WireInstanceInfo = components["schemas"]["InstanceInfo"];
+export declare function toWireRequest(params: QuoteParams): WireSolutionRequest;
+export declare function fromWireQuote(wire: WireSolution, tokenOut: Address, receiver: Address): Quote;
+export declare function fromWireHealth(wire: WireHealthStatus): HealthStatus;
+export declare function fromWireInstanceInfo(wire: WireInstanceInfo): InstanceInfo;
+export {};
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EACR,OAAO,EAIP,YAAY,EAEZ,YAAY,EAGZ,KAAK,EACL,WAAW,EAId,MAAM,YAAY,CAAC;AAGpB,KAAK,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;AACnD,KAAK,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;AAEjE,KAAK,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;AAC9D,KAAK,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;AAW9D,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,CA8BtE;AAED,wBAAgB,aAAa,CACzB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,GAClB,KAAK,CA4BP;AA4ED,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAOnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAMzE"}

package/dist/mapping.js

@@ -0,0 +1,143 @@
+import { FyndError } from "./error.js";
+export function toWireRequest(params) {
+    const wireOrder = {
+        token_in: params.order.tokenIn,
+        token_out: params.order.tokenOut,
+        amount: params.order.amount.toString(),
+        side: 'sell',
+        sender: params.order.sender,
+        // exactOptionalPropertyTypes: must omit undefined keys entirely
+        ...(params.order.receiver !== undefined ? { receiver: params.order.receiver } : {}),
+    };
+    const wireOptions = params.options !== undefined
+        ? {
+            ...(params.options.timeoutMs !== undefined
+                ? { timeout_ms: params.options.timeoutMs }
+                : {}),
+            ...(params.options.minResponses !== undefined
+                ? { min_responses: params.options.minResponses }
+                : {}),
+            ...(params.options.maxGas !== undefined
+                ? { max_gas: params.options.maxGas.toString() }
+                : {}),
+            ...(params.options.encodingOptions !== undefined
+                ? { encoding_options: toWireEncodingOptions(params.options.encodingOptions) }
+                : {}),
+        }
+        : undefined;
+    return {
+        orders: [wireOrder],
+        ...(wireOptions !== undefined ? { options: wireOptions } : {}),
+    };
+}
+export function fromWireQuote(wire, tokenOut, receiver) {
+    const orderSolution = wire.orders[0];
+    if (orderSolution === undefined) {
+        throw FyndError.config("server returned empty orders array");
+    }
+    const route = orderSolution.route !== null && orderSolution.route !== undefined
+        ? fromWireRoute(orderSolution.route)
+        : undefined;
+    const transaction = orderSolution.transaction !== null
+        && orderSolution.transaction !== undefined
+        ? fromWireTransaction(orderSolution.transaction)
+        : undefined;
+    const priceImpactBps = orderSolution.price_impact_bps ?? undefined;
+    return {
+        orderId: orderSolution.order_id,
+        status: orderSolution.status,
+        backend: 'fynd', // WireOrderQuote has no backend field; hardcoded per design
+        amountIn: BigInt(orderSolution.amount_in),
+        amountOut: BigInt(orderSolution.amount_out),
+        gasEstimate: BigInt(orderSolution.gas_estimate),
+        block: fromWireBlockInfo(orderSolution.block),
+        tokenOut,
+        receiver,
+        // exactOptionalPropertyTypes: spread optional fields only when defined
+        ...(route !== undefined ? { route } : {}),
+        ...(transaction !== undefined ? { transaction } : {}),
+        ...(priceImpactBps !== undefined ? { priceImpactBps } : {}),
+    };
+}
+function fromWireRoute(wire) {
+    return { swaps: wire.swaps.map(fromWireSwap) };
+}
+function fromWireSwap(wire) {
+    return {
+        poolId: wire.component_id,
+        protocol: wire.protocol,
+        tokenIn: wire.token_in,
+        tokenOut: wire.token_out,
+        amountIn: BigInt(wire.amount_in),
+        amountOut: BigInt(wire.amount_out),
+        gasEstimate: BigInt(wire.gas_estimate),
+    };
+}
+function fromWireBlockInfo(wire) {
+    return {
+        number: wire.number,
+        hash: wire.hash,
+        timestamp: wire.timestamp,
+    };
+}
+function toWireEncodingOptions(opts) {
+    return {
+        // Server deserializes slippage as a string despite OpenAPI declaring number.
+        slippage: opts.slippage.toString(),
+        ...(opts.transferType !== undefined && opts.transferType !== 'none' ? { transfer_type: opts.transferType } : {}),
+        ...(opts.permit !== undefined ? { permit: toWirePermitSingle(opts.permit) } : {}),
+        ...(opts.permit2Signature !== undefined
+            ? { permit2_signature: opts.permit2Signature }
+            : {}),
+        ...(opts.clientFeeParams !== undefined
+            ? { client_fee_params: toWireClientFeeParams(opts.clientFeeParams) }
+            : {}),
+    };
+}
+function toWireClientFeeParams(p) {
+    return {
+        bps: p.bps,
+        receiver: p.receiver,
+        max_contribution: p.maxContribution.toString(),
+        deadline: p.deadline,
+        signature: p.signature ?? '',
+    };
+}
+function toWirePermitSingle(permit) {
+    return {
+        details: toWirePermitDetails(permit.details),
+        spender: permit.spender,
+        sig_deadline: permit.sigDeadline.toString(),
+    };
+}
+function toWirePermitDetails(d) {
+    return {
+        token: d.token,
+        amount: d.amount.toString(),
+        expiration: d.expiration.toString(),
+        nonce: d.nonce.toString(),
+    };
+}
+function fromWireTransaction(wire) {
+    return {
+        to: wire.to,
+        value: BigInt(wire.value),
+        data: wire.data,
+    };
+}
+export function fromWireHealth(wire) {
+    return {
+        healthy: wire.healthy,
+        lastUpdateMs: wire.last_update_ms,
+        numSolverPools: wire.num_solver_pools,
+        ...(wire.gas_price_age_ms != null ? { gasPriceAgeMs: wire.gas_price_age_ms } : {}),
+    };
+}
+export function fromWireInstanceInfo(wire) {
+    return {
+        routerAddress: wire.router_address,
+        permit2Address: wire.permit2_address,
+        chainId: wire.chain_id,
+    };
+}
+//# sourceMappingURL=mapping.js.map

package/dist/mapping.js.map

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

package/dist/permit2.d.ts

@@ -0,0 +1,26 @@
+import type { Address, EncodingOptions, Hex, PermitSingle } from './types.js';
+/**
+ * Computes the EIP-712 signing hash for a Permit2 PermitSingle.
+ *
+ * Pass the returned hash to your signer's signMessage/signHash method,
+ * then supply the 65-byte signature to EncodingOptions.permit2Signature.
+ *
+ * The canonical Permit2 address across all chains is:
+ * 0x000000000022D473030F116dDEE9F6B43aC78BA3
+ */
+export declare function permit2SigningHash(permit: PermitSingle, chainId: number, permit2Address: Address): Hex;
+/**
+ * Create encoding options with slippage tolerance.
+ * Default transfer type is 'transfer_from'.
+ */
+export declare function encodingOptions(slippage: number): EncodingOptions;
+/**
+ * Add Permit2 authorization to encoding options.
+ * Validates that signature is exactly 65 bytes (130 hex chars + '0x' prefix).
+ */
+export declare function withPermit2(opts: EncodingOptions, permit: PermitSingle, signature: Hex): EncodingOptions;
+/**
+ * Set transfer type to 'use_vaults_funds' (funds already in router vault).
+ */
+export declare function withVaultFunds(opts: EncodingOptions): EncodingOptions;
+//# sourceMappingURL=permit2.d.ts.map

package/dist/permit2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.d.ts","sourceRoot":"","sources":["../src/permit2.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoB9E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,OAAO,GACtB,GAAG,CAoBL;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAEjE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,GAAG,GACb,eAAe,CAYjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,CAErE"}

package/dist/permit2.js

@@ -0,0 +1,77 @@
+import { hashTypedData } from 'viem';
+import { FyndError } from './error.js';
+const PERMIT_DETAILS_TYPE = {
+    PermitDetails: [
+        { name: 'token', type: 'address' },
+        { name: 'amount', type: 'uint160' },
+        { name: 'expiration', type: 'uint48' },
+        { name: 'nonce', type: 'uint48' },
+    ],
+};
+const PERMIT_SINGLE_TYPE = {
+    PermitSingle: [
+        { name: 'details', type: 'PermitDetails' },
+        { name: 'spender', type: 'address' },
+        { name: 'sigDeadline', type: 'uint256' },
+    ],
+    ...PERMIT_DETAILS_TYPE,
+};
+/**
+ * Computes the EIP-712 signing hash for a Permit2 PermitSingle.
+ *
+ * Pass the returned hash to your signer's signMessage/signHash method,
+ * then supply the 65-byte signature to EncodingOptions.permit2Signature.
+ *
+ * The canonical Permit2 address across all chains is:
+ * 0x000000000022D473030F116dDEE9F6B43aC78BA3
+ */
+export function permit2SigningHash(permit, chainId, permit2Address) {
+    return hashTypedData({
+        domain: {
+            name: 'Permit2',
+            chainId,
+            verifyingContract: permit2Address,
+        },
+        types: PERMIT_SINGLE_TYPE,
+        primaryType: 'PermitSingle',
+        message: {
+            details: {
+                token: permit.details.token,
+                amount: permit.details.amount,
+                expiration: Number(permit.details.expiration),
+                nonce: Number(permit.details.nonce),
+            },
+            spender: permit.spender,
+            sigDeadline: permit.sigDeadline,
+        },
+    });
+}
+/**
+ * Create encoding options with slippage tolerance.
+ * Default transfer type is 'transfer_from'.
+ */
+export function encodingOptions(slippage) {
+    return { slippage, transferType: 'transfer_from' };
+}
+/**
+ * Add Permit2 authorization to encoding options.
+ * Validates that signature is exactly 65 bytes (130 hex chars + '0x' prefix).
+ */
+export function withPermit2(opts, permit, signature) {
+    if (signature.length !== 132) {
+        throw FyndError.config(`Permit2 signature must be exactly 65 bytes (132 hex chars), got ${String(signature.length)} chars`);
+    }
+    return {
+        ...opts,
+        transferType: 'transfer_from_permit2',
+        permit,
+        permit2Signature: signature,
+    };
+}
+/**
+ * Set transfer type to 'use_vaults_funds' (funds already in router vault).
+ */
+export function withVaultFunds(opts) {
+    return { ...opts, transferType: 'use_vaults_funds' };
+}
+//# sourceMappingURL=permit2.js.map

package/dist/permit2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.js","sourceRoot":"","sources":["../src/permit2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,mBAAmB,GAAG;IAC1B,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;QACnC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;CACO,CAAC;AAEX,MAAM,kBAAkB,GAAG;IACzB,YAAY,EAAE;QACZ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE;QAC1C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;KACzC;IACD,GAAG,mBAAmB;CACd,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAoB,EACpB,OAAe,EACf,cAAuB;IAEvB,OAAO,aAAa,CAAC;QACnB,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO;YACP,iBAAiB,EAAE,cAAc;SAClC;QACD,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,cAAc;QAC3B,OAAO,EAAE;YACP,OAAO,EAAE;gBACP,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;gBAC3B,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aACpC;YACD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,IAAqB,EACrB,MAAoB,EACpB,SAAc;IAEd,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,MAAM,CACpB,mEAAmE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CACpG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,uBAAuB;QACrC,MAAM;QACN,gBAAgB,EAAE,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,OAAO,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACvD,CAAC"}

package/dist/signing.d.ts

@@ -0,0 +1,89 @@
+import type { Address, Hex, Quote } from './types.js';
+/** An unsigned EIP-1559 `approve(spender, amount)` transaction. */
+export interface ApprovalPayload {
+    tx: Eip1559Transaction;
+    token: Address;
+    spender: Address;
+    amount: bigint;
+}
+/** A signed approval ready for {@link FyndClient.executeApproval}. */
+export interface SignedApproval {
+    tx: Eip1559Transaction;
+    /** 65-byte hex signature over the EIP-1559 signing hash. */
+    signature: Hex;
+}
+/** Receipt for a mined transaction (gas cost only, no settled-amount). */
+export interface TxReceipt {
+    txHash: Hex;
+    gasCost: bigint;
+}
+/** An unsigned EIP-1559 transaction ready for signing. */
+export interface Eip1559Transaction {
+    chainId: number;
+    nonce: number;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    gas: bigint;
+    to: Address;
+    value: bigint;
+    data: Hex;
+}
+/** Internal payload pairing a quote with its unsigned transaction. */
+export interface FyndPayload {
+    /** Original quote; carries `tokenOut` and `receiver` needed for settlement parsing. */
+    quote: Quote;
+    tx: Eip1559Transaction;
+}
+/** Discriminated union of backend-specific swap payloads ready to be signed. */
+export type SwapPayload = {
+    kind: 'fynd';
+    payload: FyndPayload;
+};
+/** A 65-byte ECDSA signature encoded as a hex string. */
+export type PrimitiveSignature = `0x${string}`;
+/** A swap payload paired with its cryptographic signature, ready for on-chain submission. */
+export interface SignedSwap {
+    payload: SwapPayload;
+    signature: PrimitiveSignature;
+}
+/** Result of a settled (or dry-run) swap execution. */
+export interface SettledOrder {
+    /** Transaction hash; absent for dry-run executions. */
+    txHash?: Hex;
+    /** Total output tokens received by the receiver, parsed from Transfer logs. */
+    settledAmount?: bigint;
+    /** Gas cost in wei (gasUsed * effectiveGasPrice, or estimated for dry-run). */
+    gasCost: bigint;
+}
+/** Options for waiting on transaction settlement. */
+export interface SettleOptions {
+    /** Maximum time to wait for confirmation in milliseconds. Defaults to {@link DEFAULT_SETTLE_TIMEOUT_MS}. */
+    timeoutMs?: number;
+}
+/** Default timeout for {@link ExecutionReceipt.settle} (120 seconds). */
+export declare const DEFAULT_SETTLE_TIMEOUT_MS = 120000;
+/** Handle returned by {@link FyndClient.executeSwap} to await transaction settlement. */
+export interface ExecutionReceipt {
+    /** Polls for the transaction receipt and returns the settled result.
+     * @throws {FyndError} With code `SETTLE_TIMEOUT` if the transaction does not confirm in time.
+     */
+    settle(options?: SettleOptions): Promise<SettledOrder>;
+}
+/**
+ * Computes the EIP-1559 signing hash for a swap payload.
+ *
+ * Equivalent to keccak256 of the unsigned serialized EIP-1559 transaction,
+ * which is the hash the signer must sign.
+ */
+export declare function swapSigningHash(payload: SwapPayload): Hex;
+/**
+ * Wraps a swap payload and signature into a {@link SignedSwap} without any I/O.
+ * Mirrors Rust's `SignedSwap::assemble`.
+ */
+export declare function assembleSignedSwap(payload: SwapPayload, signature: PrimitiveSignature): SignedSwap;
+/**
+ * Compute the EIP-1559 signing hash for an approval payload.
+ * Sign this and pass the result to {@link FyndClient.executeApproval} via {@link SignedApproval}.
+ */
+export declare function approvalSigningHash(payload: ApprovalPayload): Hex;
+//# sourceMappingURL=signing.d.ts.map

package/dist/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEtD,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,kBAAkB,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,kBAAkB,CAAC;IACvB,4DAA4D;IAC5D,SAAS,EAAE,GAAG,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;CACX;AAED,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,uFAAuF;IACvF,KAAK,EAAE,KAAK,CAAC;IACb,EAAE,EAAE,kBAAkB,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjE,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,KAAK,MAAM,EAAE,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,4GAA4G;IAC5G,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAEjD,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACxD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,GAAG,CAczD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,kBAAkB,GAC5B,UAAU,CAEZ;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG,CAEjE"}

package/dist/signing.js

@@ -0,0 +1,39 @@
+import { keccak256, serializeTransaction } from 'viem';
+/** Default timeout for {@link ExecutionReceipt.settle} (120 seconds). */
+export const DEFAULT_SETTLE_TIMEOUT_MS = 120000;
+/**
+ * Computes the EIP-1559 signing hash for a swap payload.
+ *
+ * Equivalent to keccak256 of the unsigned serialized EIP-1559 transaction,
+ * which is the hash the signer must sign.
+ */
+export function swapSigningHash(payload) {
+    const tx = payload.payload.tx;
+    const serialized = 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,
+    });
+    return keccak256(serialized);
+}
+/**
+ * Wraps a swap payload and signature into a {@link SignedSwap} without any I/O.
+ * Mirrors Rust's `SignedSwap::assemble`.
+ */
+export function assembleSignedSwap(payload, signature) {
+    return { payload, signature };
+}
+/**
+ * Compute the EIP-1559 signing hash for an approval payload.
+ * Sign this and pass the result to {@link FyndClient.executeApproval} via {@link SignedApproval}.
+ */
+export function approvalSigningHash(payload) {
+    return keccak256(serializeTransaction({ type: 'eip1559', ...payload.tx }));
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.js","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,MAAM,CAAC;AAuEvD,yEAAyE;AACzE,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAO,CAAC;AAUjD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IAClD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,oBAAoB,CAAC;QACtC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,YAAY,EAAE,EAAE,CAAC,YAAY;QAC7B,oBAAoB,EAAE,EAAE,CAAC,oBAAoB;QAC7C,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,IAAI,EAAE,EAAE,CAAC,IAAI;KACd,CAAC,CAAC;IACH,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAoB,EACpB,SAA6B;IAE7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAwB;IAC1D,OAAO,SAAS,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAAQ,CAAC;AACpF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,177 @@
+/** Outcome status of a quote request. Must stay in sync with the server schema. */
+export type SolutionStatus = 'success' | 'no_route_found' | 'insufficient_liquidity' | 'timeout' | 'not_ready';
+/** Routing backend that produced a quote. */
+export type BackendKind = 'fynd' | 'turbine';
+/** EVM address as a hex string. */
+export type Address = `0x${string}`;
+/** Arbitrary hex-encoded bytes. */
+export type Hex = `0x${string}`;
+/** Order side. Currently only sell orders are supported. */
+export type OrderSide = 'sell';
+/** A swap order specifying input/output tokens, amount, and participants. */
+export interface Order {
+    /** Token to sell. */
+    tokenIn: Address;
+    /** Token to receive. */
+    tokenOut: Address;
+    /** Amount of `tokenIn` to sell (in token base units). */
+    amount: bigint;
+    side: OrderSide;
+    /** Address that holds the input tokens and sends the transaction. */
+    sender: Address;
+    /** Address that receives output tokens. Defaults to `sender` if omitted. */
+    receiver?: Address;
+}
+/** How the router pulls input tokens from the sender. */
+export type UserTransferType = 'transfer_from' | 'transfer_from_permit2' | 'use_vaults_funds' | 'none';
+/** Uniswap Permit2 allowance details for a single token. */
+export interface PermitDetails {
+    token: Address;
+    /** Maximum transferable amount (uint160). */
+    amount: bigint;
+    /** Unix timestamp after which the permit expires (uint48). */
+    expiration: bigint;
+    /** Permit2 nonce for this token/spender pair (uint48). */
+    nonce: bigint;
+}
+/** Uniswap Permit2 single-token permit, ready for EIP-712 signing. */
+export interface PermitSingle {
+    details: PermitDetails;
+    /** Address authorized to spend tokens via Permit2. */
+    spender: Address;
+    /** Unix timestamp after which the signature is invalid. */
+    sigDeadline: bigint;
+}
+/** Client fee configuration for the Tycho Router.
+ *
+ * When provided, the router charges a fee in basis points on the swap output.
+ * The `signature` must be an EIP-712 signature by the `receiver` over the
+ * `ClientFee` typed data — compute the hash with `clientFeeSigningHash`.
+ */
+export interface ClientFeeParams {
+    /** Fee in basis points (0–10,000). 100 = 1%. */
+    bps: number;
+    /** Address that receives the fee (also the required EIP-712 signer). */
+    receiver: Address;
+    /** Maximum subsidy from the client's vault balance. */
+    maxContribution: bigint;
+    /** Unix timestamp after which the signature is invalid. */
+    deadline: number;
+    /** 65-byte EIP-712 ECDSA signature by `receiver`. Set after signing. */
+    signature?: Hex;
+}
+/** Controls how the solver encodes the settlement transaction. */
+export interface EncodingOptions {
+    /** Maximum acceptable slippage as a fraction (e.g. 0.01 for 1%). */
+    slippage: number;
+    /** How tokens are transferred to the router. Defaults to `'transfer_from'`. */
+    transferType?: UserTransferType;
+    /** Permit2 permit data; required when `transferType` is `'transfer_from_permit2'`. */
+    permit?: PermitSingle;
+    /** 65-byte Permit2 signature over the permit; required with `permit`. */
+    permit2Signature?: Hex;
+    /** Client fee configuration. When absent, no fee is charged. */
+    clientFeeParams?: ClientFeeParams;
+}
+/** An encoded on-chain transaction returned by the solver. */
+export interface Transaction {
+    to: Address;
+    value: bigint;
+    data: Hex;
+}
+/** Optional parameters for a quote request. */
+export interface QuoteOptions {
+    /** Server-side solver timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Minimum number of solver responses to wait for before returning. */
+    minResponses?: number;
+    /** Maximum gas the solution may consume. */
+    maxGas?: bigint;
+    /** Encoding options; when set, the response includes a ready-to-sign transaction. */
+    encodingOptions?: EncodingOptions;
+}
+/** Input parameters for {@link FyndClient.quote}. */
+export interface QuoteParams {
+    order: Order;
+    options?: QuoteOptions;
+}
+/** Block metadata at the time the quote was computed. */
+export interface BlockInfo {
+    number: number;
+    hash: string;
+    /** Unix timestamp of the block (seconds). */
+    timestamp: number;
+}
+/** A single pool-level swap within a route. */
+export interface Swap {
+    /** Unique pool identifier (wire name: `component_id`). */
+    poolId: string;
+    /** Protocol name (e.g. "uniswap_v3", "balancer_v2"). */
+    protocol: string;
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    amountOut: bigint;
+    gasEstimate: bigint;
+}
+/** An ordered sequence of swaps forming a complete routing path. */
+export interface Route {
+    swaps: Swap[];
+}
+/** A solver quote containing the best route, amounts, and optional encoded transaction. */
+export interface Quote {
+    orderId: string;
+    status: SolutionStatus;
+    backend: BackendKind;
+    route?: Route;
+    amountIn: bigint;
+    amountOut: bigint;
+    gasEstimate: bigint;
+    /** Price impact in basis points (1 bp = 0.01%). */
+    priceImpactBps?: number;
+    block: BlockInfo;
+    /** Output token address from the original order; used internally for settlement parsing. */
+    tokenOut: Address;
+    /** Receiver address; defaults to sender if not specified in the original order. */
+    receiver: Address;
+    /** Encoded transaction; present only when `encodingOptions` was set in the quote request. */
+    transaction?: Transaction;
+}
+/** Solver health status and readiness information. */
+export interface HealthStatus {
+    healthy: boolean;
+    /** Milliseconds since the last state update. */
+    lastUpdateMs: number;
+    /** Number of liquidity pools tracked by the solver. */
+    numSolverPools: number;
+    gasPriceAgeMs?: number;
+}
+/** Static metadata about a Fynd server instance. */
+export interface InstanceInfo {
+    routerAddress: Address;
+    permit2Address: Address;
+    chainId: number;
+}
+/** Parameters for {@link FyndClient.approval}. */
+export interface ApprovalParams {
+    /** ERC-20 token to approve. */
+    token: Address;
+    /** Amount to approve (in token base units). */
+    amount: bigint;
+    /**
+     * Which contract to approve as spender.
+     *
+     * `'transfer_from'` → router contract (default).
+     * `'transfer_from_permit2'` → Permit2 contract.
+     * `'none'` → {@link FyndClient.approval} returns `null` immediately.
+     */
+    transferType?: UserTransferType;
+    /**
+     * When `true`, read on-chain allowance before building the transaction.
+     *
+     * If the allowance is already sufficient, {@link FyndClient.approval} returns `null`.
+     * Requires `provider.readAllowance` to be implemented.
+     */
+    checkAllowance?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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