@kayibal/fynd-client 0.1.0

package/dist/viem.d.ts

@@ -0,0 +1,72 @@
+import type { Address, Hex } from './types.js';
+import type { EthProvider } from './client.js';
+/**
+ * Minimal subset of viem's `PublicClient` used by {@link viemProvider}.
+ *
+ * Any viem `PublicClient` created via `createPublicClient` satisfies this interface.
+ */
+export interface ViemPublicClient {
+    getTransactionCount(args: {
+        address: Address;
+    }): Promise<number>;
+    estimateFeesPerGas(): Promise<{
+        maxFeePerGas: bigint | null;
+        maxPriorityFeePerGas: bigint | null;
+    }>;
+    call(args: {
+        to: Address;
+        data: Hex;
+        value: bigint;
+        gas: bigint;
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }): Promise<{
+        data?: Hex | undefined;
+    }>;
+    estimateGas(args: {
+        account: Address;
+        to: Address;
+        data: Hex;
+        value: bigint;
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }): Promise<bigint>;
+    sendRawTransaction(args: {
+        serializedTransaction: Hex;
+    }): Promise<Hex>;
+    getTransactionReceipt(args: {
+        hash: Hex;
+    }): Promise<{
+        transactionHash: Hex;
+        status: 'success' | 'reverted';
+        gasUsed: bigint;
+        effectiveGasPrice: bigint;
+        logs: ReadonlyArray<{
+            address: string;
+            topics: readonly string[];
+            data: string;
+        }>;
+    }>;
+    readContract(args: {
+        address: Address;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+    /** Optional: raw RPC request, used for debug_traceTransaction. */
+    request?<T = unknown>(args: {
+        method: string;
+        params?: readonly unknown[];
+    }): Promise<T>;
+}
+/**
+ * Adapts a viem `PublicClient` into an {@link EthProvider} for use with {@link FyndClient}.
+ *
+ * @example
+ * ```ts
+ * const provider = viemProvider(publicClient, senderAddress);
+ * const client = new FyndClient({ baseUrl, chainId, provider });
+ * ```
+ */
+export declare function viemProvider(client: ViemPublicClient, sender: Address): EthProvider;
+//# sourceMappingURL=viem.d.ts.map

package/dist/viem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem.d.ts","sourceRoot":"","sources":["../src/viem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS/C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,CACjB,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,kBAAkB,IAAI,OAAO,CAAC;QAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;KACrC,CAAC,CAAC;IACH,IAAI,CACF,IAAI,EAAE;QACJ,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,GACA,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,GAAG,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IACvC,WAAW,CACT,IAAI,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,GACA,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,kBAAkB,CAChB,IAAI,EAAE;QAAE,qBAAqB,EAAE,GAAG,CAAA;KAAE,GACnC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChB,qBAAqB,CACnB,IAAI,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,GAClB,OAAO,CAAC;QACT,eAAe,EAAE,GAAG,CAAC;QACrB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,IAAI,EAAE,aAAa,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;YAC1B,IAAI,EAAE,MAAM,CAAC;SACd,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,YAAY,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,kEAAkE;IAClE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,OAAO,GACd,WAAW,CA0Eb"}

package/dist/viem.js

@@ -0,0 +1,93 @@
+const ERC20_ALLOWANCE_ABI = [{
+        name: 'allowance', type: 'function',
+        inputs: [{ name: 'owner', type: 'address' }, { name: 'spender', type: 'address' }],
+        outputs: [{ type: 'uint256' }],
+        stateMutability: 'view',
+    }];
+/**
+ * Adapts a viem `PublicClient` into an {@link EthProvider} for use with {@link FyndClient}.
+ *
+ * @example
+ * ```ts
+ * const provider = viemProvider(publicClient, senderAddress);
+ * const client = new FyndClient({ baseUrl, chainId, provider });
+ * ```
+ */
+export function viemProvider(client, sender) {
+    return {
+        async getTransactionCount(args) {
+            return client.getTransactionCount(args);
+        },
+        async estimateFeesPerGas() {
+            const fees = await client.estimateFeesPerGas();
+            return {
+                maxFeePerGas: fees.maxFeePerGas ?? 0n,
+                maxPriorityFeePerGas: fees.maxPriorityFeePerGas ?? 0n,
+            };
+        },
+        async call(tx) {
+            const result = await client.call({
+                to: tx.to,
+                data: tx.data,
+                value: tx.value,
+                gas: tx.gas,
+                maxFeePerGas: tx.maxFeePerGas,
+                maxPriorityFeePerGas: tx.maxPriorityFeePerGas,
+            });
+            return result.data !== undefined ? { data: result.data } : {};
+        },
+        async estimateGas(tx) {
+            return client.estimateGas({
+                account: sender,
+                to: tx.to,
+                data: tx.data,
+                value: tx.value,
+                maxFeePerGas: tx.maxFeePerGas,
+                maxPriorityFeePerGas: tx.maxPriorityFeePerGas,
+            });
+        },
+        async sendRawTransaction(rawTx) {
+            return client.sendRawTransaction({
+                serializedTransaction: rawTx,
+            });
+        },
+        async getTransactionReceipt(args) {
+            let receipt;
+            try {
+                receipt = await client.getTransactionReceipt(args);
+            }
+            catch {
+                // viem throws when the receipt is not yet available; settle() expects null.
+                return null;
+            }
+            return {
+                transactionHash: receipt.transactionHash,
+                status: receipt.status === 'reverted' ? 0 : 1,
+                gasUsed: receipt.gasUsed,
+                effectiveGasPrice: receipt.effectiveGasPrice,
+                logs: receipt.logs.map((log) => ({
+                    address: log.address,
+                    topics: log.topics,
+                    data: log.data,
+                })),
+            };
+        },
+        async debugTraceTransaction(hash) {
+            if (client.request === undefined)
+                throw new Error('request not available');
+            const result = await client.request({
+                method: 'debug_traceTransaction',
+                params: [hash, { tracer: 'callTracer' }],
+            });
+            return { output: (result.output ?? '0x') };
+        },
+        async readAllowance(token, owner, spender) {
+            const result = await client.readContract({
+                address: token, abi: ERC20_ALLOWANCE_ABI,
+                functionName: 'allowance', args: [owner, spender],
+            });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=viem.js.map

package/dist/viem.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@kayibal/fynd-client",
+  "version": "0.1.0",
+  "description": "TypeScript client for the Fynd DEX router",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build":     "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint":      "oxlint src/",
+    "test":      "vitest run"
+  },
+  "dependencies": {
+    "openapi-fetch": "0.17.0",
+    "viem": "2.46.3"
+  },
+  "devDependencies": {
+    "typescript": "5.8.2",
+    "oxlint":     "1.51.0",
+    "vitest":     "4.0.18"
+  }
+}