@notuslabs/yail 0.1.0

package/dist/sources/rpc.js

@@ -0,0 +1,187 @@
+import { createPublicClient, http } from "viem";
+import { lower } from "./types.js";
+import { lowerOrNull } from "../util.js";
+/**
+ * JSON-RPC source. Slower than HyperSync but works against any node,
+ * needs no token, and is what the recorded test fixtures are captured with.
+ * Account (from/to) filters require scanning full blocks; keep ranges small.
+ */
+export function rpc(options) {
+    const client = options.client ?? createPublicClient({ transport: http(options.url, { batch: true, retryCount: 5 }) });
+    const blockRange = options.blockRange ?? 2000;
+    const concurrency = options.concurrency ?? 4;
+    const source = {
+        kind: "evm",
+        name: `rpc(${safeHost(options.url)})`,
+        async getHeight() {
+            return Number(await client.getBlockNumber());
+        },
+        async *fetch(query, fetchOptions) {
+            let from = query.fromBlock;
+            while (from < query.toBlock) {
+                fetchOptions?.signal?.throwIfAborted();
+                const to = Math.min(from + blockRange, query.toBlock);
+                yield await fetchRange(from, to, query);
+                from = to;
+            }
+        },
+        async getBlock(number) {
+            const b = await client.getBlock({ blockNumber: BigInt(number) }).catch(() => null);
+            if (!b)
+                return null;
+            return { number: Number(b.number), hash: b.hash, parentHash: b.parentHash, timestamp: Number(b.timestamp) };
+        },
+    };
+    async function fetchRange(from, to, query) {
+        const logs = [];
+        const seenLogs = new Set();
+        for (const f of query.logs) {
+            const params = { fromBlock: hex(from), toBlock: hex(to - 1) };
+            if (f.address && f.address.length > 0)
+                params.address = f.address.map(lower);
+            if (f.topics)
+                params.topics = f.topics.map(topicAlternatives);
+            const raw = (await client.request({ method: "eth_getLogs", params: [params] }));
+            for (const l of raw) {
+                const key = `${l.blockNumber}:${l.logIndex}`;
+                if (seenLogs.has(key))
+                    continue;
+                seenLogs.add(key);
+                logs.push({
+                    blockNumber: Number(l.blockNumber),
+                    blockHash: l.blockHash,
+                    transactionHash: l.transactionHash,
+                    transactionIndex: Number(l.transactionIndex),
+                    logIndex: Number(l.logIndex),
+                    address: lower(l.address),
+                    data: l.data,
+                    topics: l.topics,
+                    removed: l.removed,
+                });
+            }
+        }
+        logs.sort((a, b) => a.blockNumber - b.blockNumber || a.logIndex - b.logIndex);
+        const blocks = new Map();
+        const transactions = new Map();
+        const needTxOfLogs = query.includeLogTransactions === true;
+        const wantBlocks = new Set(logs.map((l) => l.blockNumber));
+        const logTxHashes = new Set();
+        if (needTxOfLogs)
+            for (const l of logs)
+                logTxHashes.add(l.transactionHash);
+        if (query.transactions.length > 0) {
+            // Account filters: scan every block in range with its transactions.
+            const numbers = Array.from({ length: to - from }, (_, i) => from + i);
+            await mapLimit(numbers, concurrency, async (n) => {
+                const b = await client.getBlock({ blockNumber: BigInt(n), includeTransactions: true });
+                blocks.set(n, { number: n, hash: b.hash, parentHash: b.parentHash, timestamp: Number(b.timestamp) });
+                for (const tx of b.transactions) {
+                    if (typeof tx === "string")
+                        continue;
+                    if (matchesTxFilters(tx.from, tx.to, query.transactions) || logTxHashes.has(tx.hash)) {
+                        transactions.set(tx.hash, toTx(tx, n));
+                    }
+                }
+            });
+        }
+        const missingBlocks = [...wantBlocks].filter((n) => !blocks.has(n));
+        await mapLimit(missingBlocks, concurrency, async (n) => {
+            const b = await client.getBlock({ blockNumber: BigInt(n), includeTransactions: needTxOfLogs });
+            blocks.set(n, { number: n, hash: b.hash, parentHash: b.parentHash, timestamp: Number(b.timestamp) });
+            if (needTxOfLogs) {
+                const wanted = new Set(logs.filter((l) => l.blockNumber === n).map((l) => l.transactionHash));
+                for (const tx of b.transactions) {
+                    if (typeof tx === "string")
+                        continue;
+                    if (wanted.has(tx.hash))
+                        transactions.set(tx.hash, toTx(tx, n));
+                }
+            }
+        });
+        if (options.receipts !== false && transactions.size > 0) {
+            await mapLimit([...transactions.values()], concurrency, async (tx) => {
+                const r = await client.getTransactionReceipt({ hash: tx.hash }).catch(() => null);
+                if (!r)
+                    return;
+                tx.gasUsed = r.gasUsed;
+                tx.effectiveGasPrice = r.effectiveGasPrice;
+                tx.status = 0;
+                if (r.status === "success")
+                    tx.status = 1;
+                tx.contractAddress = lowerOrNull(r.contractAddress);
+            });
+        }
+        return {
+            fromBlock: from,
+            nextBlock: to,
+            blocks: [...blocks.values()].sort((a, b) => a.number - b.number),
+            transactions: [...transactions.values()].sort((a, b) => a.blockNumber - b.blockNumber || a.transactionIndex - b.transactionIndex),
+            logs,
+        };
+    }
+    return source;
+}
+function toTx(tx, blockNumber) {
+    return {
+        hash: tx.hash,
+        blockNumber,
+        transactionIndex: Number(tx.transactionIndex),
+        from: lower(tx.from),
+        to: lowerOrNull(tx.to),
+        value: BigInt(tx.value ?? 0),
+        input: tx.input ?? "0x",
+        nonce: optionalBigInt(tx.nonce),
+        gas: optionalBigInt(tx.gas),
+        gasPrice: optionalBigInt(tx.gasPrice),
+        type: optionalHexNumber(tx.typeHex),
+    };
+}
+function optionalBigInt(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    return BigInt(value);
+}
+function optionalHexNumber(value) {
+    if (typeof value !== "string")
+        return undefined;
+    return Number(value);
+}
+/** eth_getLogs wants a single topic as a string and alternatives as an array. */
+function topicAlternatives(alts) {
+    if (alts === null)
+        return null;
+    if (alts.length === 1)
+        return alts[0];
+    return alts;
+}
+export function matchesTxFilters(from, to, filters) {
+    const f = lower(from);
+    const t = lowerOrNull(to);
+    return filters.some((filter) => {
+        const fromOk = !filter.from || filter.from.length === 0 || filter.from.map(lower).includes(f);
+        const toOk = !filter.to || filter.to.length === 0 || (t !== null && filter.to.map(lower).includes(t));
+        return fromOk && toOk;
+    });
+}
+async function mapLimit(items, limit, fn) {
+    let i = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (i < items.length) {
+            const item = items[i++];
+            await fn(item);
+        }
+    });
+    await Promise.all(workers);
+}
+function hex(n) {
+    return `0x${n.toString(16)}`;
+}
+function safeHost(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/sources/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/sources/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAqB,MAAM,MAAM,CAAC;AAEnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0BzC;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,OAAyB;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,kBAAkB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtH,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAc;QACxB,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG;QACrC,KAAK,CAAC,SAAS;YACb,OAAO,MAAM,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,CAAC,KAAK,CAAC,KAAe,EAAE,YAA2B;YACvD,IAAI,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;YAC3B,OAAO,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC5B,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;gBACvC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtD,MAAM,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;gBACxC,IAAI,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC3B,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnF,IAAI,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9G,CAAC;KACF,CAAC;IAEF,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,EAAU,EAAE,KAAe;QACjE,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3B,MAAM,MAAM,GAA4B,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YACvF,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7E,IAAI,CAAC,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,MAAa,CAAC,EAAE,CAAC,CAAwB,CAAC;YAC9G,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC7C,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC;oBACR,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;oBAClC,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,eAAe,EAAE,CAAC,CAAC,eAAe;oBAClC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;oBAC5C,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAC5B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;oBACzB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAC;QACvD,MAAM,YAAY,GAAG,KAAK,CAAC,sBAAsB,KAAK,IAAI,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAEnE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,IAAI,YAAY;YAAE,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAC3E,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,oEAAoE;YACpE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YACtE,MAAM,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC/C,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvF,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACrG,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;oBAChC,IAAI,OAAO,EAAE,KAAK,QAAQ;wBAAE,SAAS;oBACrC,IAAI,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;wBACrF,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,QAAQ,CAAC,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACrD,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/F,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACrG,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;gBAC9F,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;oBAChC,IAAI,OAAO,EAAE,KAAK,QAAQ;wBAAE,SAAS;oBACrC,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;wBAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,QAAQ,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;gBACnE,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBACnG,IAAI,CAAC,CAAC;oBAAE,OAAO;gBACf,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;gBACvB,EAAE,CAAC,iBAAiB,GAAG,CAAC,CAAC,iBAAiB,CAAC;gBAC3C,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;gBACd,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;oBAAE,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC1C,EAAE,CAAC,eAAe,GAAG,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YAChE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;YACjI,IAAI;SACL,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,IAAI,CAAC,EAAO,EAAE,WAAmB;IACxC,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,WAAW;QACX,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC;QAC7C,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;QACpB,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;QAC5B,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI;QACvB,KAAK,EAAE,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC;QAC/B,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC;QAC3B,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC,QAAQ,CAAC;QACrC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC,OAAO,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,MAAM,CAAC,KAAiC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,iFAAiF;AACjF,SAAS,iBAAiB,CAAC,IAAqB;IAC9C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,CAAE,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,EAA6B,EAAE,OAAsB;IAClG,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACtG,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,QAAQ,CAAI,KAAU,EAAE,KAAa,EAAE,EAA8B;IAClF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/E,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAE,CAAC;YACzB,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/sources/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Source abstraction. Every data provider (HyperSync, JSON-RPC, the cache
+ * wrapper, Esplora for Bitcoin, recorded fixtures) implements the same
+ * shape: `getHeight()` and `fetch(query)` yielding ordered, contiguous
+ * batches of blocks/transactions/logs for a block range.
+ */
+export interface FetchOptions {
+    signal?: AbortSignal;
+}
+export interface RangeQuery {
+    fromBlock: number;
+    /** Exclusive. */
+    toBlock: number;
+}
+export interface RangeBatch {
+    fromBlock: number;
+    /** Exclusive end of the range covered by this batch. Contiguous with the next batch. */
+    nextBlock: number;
+}
+export interface EvmLogFilter {
+    /** Contract addresses (OR). Empty/undefined = any contract. */
+    address?: string[];
+    /** Per-position topic alternatives (OR within a position, AND across positions). `null` = any. */
+    topics?: Array<string[] | null>;
+}
+export interface EvmTxFilter {
+    /** Sender addresses (OR). */
+    from?: string[];
+    /** Recipient addresses (OR). Combined with `from` using AND (HyperSync semantics). */
+    to?: string[];
+}
+export interface EvmQuery extends RangeQuery {
+    logs: EvmLogFilter[];
+    transactions: EvmTxFilter[];
+    /** Also return the transaction of every matched log. */
+    includeLogTransactions?: boolean;
+}
+export interface EvmBlock {
+    number: number;
+    hash: string;
+    parentHash?: string;
+    timestamp: number;
+}
+export interface EvmTransaction {
+    hash: string;
+    blockNumber: number;
+    transactionIndex: number;
+    from: string;
+    to: string | null;
+    value: bigint;
+    input: string;
+    nonce?: bigint;
+    gas?: bigint;
+    gasPrice?: bigint;
+    gasUsed?: bigint;
+    effectiveGasPrice?: bigint;
+    status?: number;
+    type?: number;
+    contractAddress?: string | null;
+}
+export interface EvmLog {
+    blockNumber: number;
+    blockHash?: string;
+    transactionHash: string;
+    transactionIndex: number;
+    logIndex: number;
+    address: string;
+    data: string;
+    topics: string[];
+    removed?: boolean;
+}
+export interface RollbackGuard {
+    blockNumber: number;
+    hash: string;
+    firstBlockNumber: number;
+    firstParentHash: string;
+}
+export interface EvmBatch extends RangeBatch {
+    blocks: EvmBlock[];
+    transactions: EvmTransaction[];
+    logs: EvmLog[];
+    rollbackGuard?: RollbackGuard;
+    archiveHeight?: number;
+}
+export interface EvmSource {
+    readonly kind: "evm";
+    readonly name: string;
+    getHeight(): Promise<number>;
+    fetch(query: EvmQuery, options?: FetchOptions): AsyncIterable<EvmBatch>;
+    /** Optional: block header lookup (used for reorg checks and `startBlock: "latest"`). */
+    getBlock?(number: number): Promise<EvmBlock | null>;
+}
+export interface BitcoinQuery extends RangeQuery {
+    addresses: string[];
+}
+export interface BitcoinOutput {
+    n: number;
+    address: string | null;
+    value: bigint;
+    scriptType?: string;
+}
+export interface BitcoinInput {
+    txid: string;
+    vout: number;
+    prevout: {
+        address: string | null;
+        value: bigint;
+    } | null;
+    isCoinbase: boolean;
+}
+export interface BitcoinTransaction {
+    txid: string;
+    blockHeight: number;
+    blockHash: string;
+    blockTime: number;
+    fee: bigint;
+    vin: BitcoinInput[];
+    vout: BitcoinOutput[];
+}
+export interface BitcoinBatch extends RangeBatch {
+    transactions: BitcoinTransaction[];
+}
+export interface BitcoinSource {
+    readonly kind: "bitcoin";
+    readonly name: string;
+    getHeight(): Promise<number>;
+    fetch(query: BitcoinQuery, options?: FetchOptions): AsyncIterable<BitcoinBatch>;
+}
+export type Source = EvmSource | BitcoinSource;
+export type SourceKind = Source["kind"];
+export type QueryOf<S extends Source> = S extends EvmSource ? EvmQuery : BitcoinQuery;
+export type BatchOf<S extends Source> = S extends EvmSource ? EvmBatch : BitcoinBatch;
+/** Sort key for deterministic ordering of logs within a chain. */
+export declare function logOrder(a: EvmLog, b: EvmLog): number;
+export declare function txOrder(a: EvmTransaction, b: EvmTransaction): number;
+export declare function lower(s: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/sources/types.d.ts.map

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

package/dist/sources/types.js

@@ -0,0 +1,17 @@
+/**
+ * Source abstraction. Every data provider (HyperSync, JSON-RPC, the cache
+ * wrapper, Esplora for Bitcoin, recorded fixtures) implements the same
+ * shape: `getHeight()` and `fetch(query)` yielding ordered, contiguous
+ * batches of blocks/transactions/logs for a block range.
+ */
+/** Sort key for deterministic ordering of logs within a chain. */
+export function logOrder(a, b) {
+    return a.blockNumber - b.blockNumber || a.transactionIndex - b.transactionIndex || a.logIndex - b.logIndex;
+}
+export function txOrder(a, b) {
+    return a.blockNumber - b.blockNumber || a.transactionIndex - b.transactionIndex;
+}
+export function lower(s) {
+    return s.toLowerCase();
+}
+//# sourceMappingURL=types.js.map

package/dist/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoJH,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;AAC7G,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,CAAiB,EAAE,CAAiB;IAC1D,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,20 @@
+import type { DatabaseConfig } from "../db/client.js";
+export { fixtureSource, readFixture, writeFixture, recordEvmFixture, recordBitcoinFixture } from "../sources/fixture.js";
+export type { Fixture, EvmFixture, BitcoinFixture } from "../sources/fixture.js";
+export { readMemoryLogs } from "evlog/memory";
+export interface TestClickHouse {
+    /** Base HTTP URL with credentials, e.g. http://default:pass@localhost:32768 */
+    url: string;
+    /** `database` config for an isolated database (created by migrate). */
+    database(config?: Partial<DatabaseConfig>): DatabaseConfig;
+    stop(): Promise<void>;
+}
+/**
+ * A ClickHouse for tests. Uses `YAIL_TEST_CLICKHOUSE_URL` when set (a running
+ * server), otherwise starts a `clickhouse/clickhouse-server` container via
+ * testcontainers (needs Docker). One instance is shared per process.
+ */
+export declare function startTestClickHouse(options?: {
+    image?: string;
+}): Promise<TestClickHouse>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzH,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAoB7F"}

package/dist/testing/index.js

@@ -0,0 +1,44 @@
+import { randomUUID } from "node:crypto";
+export { fixtureSource, readFixture, writeFixture, recordEvmFixture, recordBitcoinFixture } from "../sources/fixture.js";
+export { readMemoryLogs } from "evlog/memory";
+let shared;
+/**
+ * A ClickHouse for tests. Uses `YAIL_TEST_CLICKHOUSE_URL` when set (a running
+ * server), otherwise starts a `clickhouse/clickhouse-server` container via
+ * testcontainers (needs Docker). One instance is shared per process.
+ */
+export function startTestClickHouse(options = {}) {
+    shared ??= (async () => {
+        const envUrl = process.env.YAIL_TEST_CLICKHOUSE_URL;
+        if (envUrl)
+            return make(envUrl, async () => { });
+        let ClickHouseContainer;
+        try {
+            ({ ClickHouseContainer } = await import("@testcontainers/clickhouse"));
+        }
+        catch (cause) {
+            throw new Error("startTestClickHouse(): install the optional peer dependency `@testcontainers/clickhouse` (and have Docker running), or point YAIL_TEST_CLICKHOUSE_URL at a running ClickHouse.", { cause });
+        }
+        const container = await new ClickHouseContainer(options.image ?? process.env.YAIL_TEST_CLICKHOUSE_IMAGE ?? "clickhouse/clickhouse-server:25.8")
+            .withUsername("default")
+            .withPassword("yail")
+            .start();
+        return make(container.getConnectionUrl(), () => container.stop().then(() => { }));
+    })();
+    return shared;
+}
+function make(url, stop) {
+    const u = new URL(url);
+    let auth = "";
+    if (u.username)
+        auth = `${u.username}:${u.password}@`;
+    const base = `${u.protocol}//${auth}${u.host}`;
+    return {
+        url: base,
+        database(config) {
+            return { url: base, database: `yail_test_${randomUUID().slice(0, 8)}`, ...config };
+        },
+        stop,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEzH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU9C,IAAI,MAA2C,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAuB,EAAE;IAClE,MAAM,KAAK,CAAC,KAAK,IAAI,EAAE;QACrB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;QACpD,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAC;QAChD,IAAI,mBAAyF,CAAC;QAC9F,IAAI,CAAC;YACH,CAAC,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,gLAAgL,EAChL,EAAE,KAAK,EAAE,CACV,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,mCAAmC,CAAC;aAC5I,YAAY,CAAC,SAAS,CAAC;aACvB,YAAY,CAAC,MAAM,CAAC;aACpB,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,IAAI,CAAC,GAAW,EAAE,IAAyB;IAClD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,CAAC,CAAC,QAAQ;QAAE,IAAI,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC;IACtD,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,QAAQ,KAAK,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,OAAO;QACL,GAAG,EAAE,IAAI;QACT,QAAQ,CAAC,MAAM;YACb,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;QACrF,CAAC;QACD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,9 @@
+/** Wrap a single value in an array; copy an array. */
+export declare function toArray<T>(value: T | readonly T[]): T[];
+/** JSON.stringify replacer that turns bigints into decimal strings. */
+export declare function bigintReplacer(_key: string, value: unknown): unknown;
+/** Lowercase a hex string, or null when absent. */
+export declare function lowerOrNull(value: string | null | undefined): string | null;
+/** URL-decode a credential from a URL, or fall back when the URL has none. */
+export declare function decodeOr(value: string, fallback: string): string;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAGvD;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAGpE;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG3E;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/util.js

@@ -0,0 +1,25 @@
+/** Wrap a single value in an array; copy an array. */
+export function toArray(value) {
+    if (Array.isArray(value))
+        return [...value];
+    return [value];
+}
+/** JSON.stringify replacer that turns bigints into decimal strings. */
+export function bigintReplacer(_key, value) {
+    if (typeof value === "bigint")
+        return value.toString();
+    return value;
+}
+/** Lowercase a hex string, or null when absent. */
+export function lowerOrNull(value) {
+    if (value)
+        return value.toLowerCase();
+    return null;
+}
+/** URL-decode a credential from a URL, or fall back when the URL has none. */
+export function decodeOr(value, fallback) {
+    if (value)
+        return decodeURIComponent(value);
+    return fallback;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,UAAU,OAAO,CAAI,KAAuB;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,GAAI,KAAsB,CAAC,CAAC;IAC9D,OAAO,CAAC,KAAU,CAAC,CAAC;AACtB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAc;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,KAAgC;IAC1D,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,QAAgB;IACtD,IAAI,KAAK;QAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@notuslabs/yail",
+  "version": "0.1.0",
+  "description": "Blockchain indexer with Ponder-style DX: HyperSync as the primary EVM source, Esplora for Bitcoin, ClickHouse as the only storage",
+  "keywords": [
+    "indexer",
+    "blockchain",
+    "ethereum",
+    "evm",
+    "bitcoin",
+    "hypersync",
+    "envio",
+    "clickhouse",
+    "ponder",
+    "web3"
+  ],
+  "homepage": "https://github.com/notuslabs/YAIL/tree/main/packages/yail#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/notuslabs/YAIL.git",
+    "directory": "packages/yail"
+  },
+  "bugs": {
+    "url": "https://github.com/notuslabs/YAIL/issues"
+  },
+  "author": "Thalles Passos",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "yail": "bin/yail.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
+    "./otel": {
+      "types": "./dist/observability/otel.d.ts",
+      "default": "./dist/observability/otel.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepack": "pnpm run clean && pnpm run build",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@clickhouse/client": "^1.23.1",
+    "@envio-dev/hypersync-client": "^1.4.1",
+    "@hono/node-server": "^2.1.1",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.222.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.222.0",
+    "@opentelemetry/resources": "^2.11.0",
+    "@opentelemetry/sdk-metrics": "^2.11.0",
+    "@opentelemetry/sdk-node": "^0.222.0",
+    "@opentelemetry/semantic-conventions": "^1.37.0",
+    "evlog": "^2.29.0",
+    "hono": "^4.13.10",
+    "tsx": "^4.23.15",
+    "viem": "^2.56.9"
+  },
+  "peerDependencies": {
+    "@testcontainers/clickhouse": ">=12"
+  },
+  "peerDependenciesMeta": {
+    "@testcontainers/clickhouse": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testcontainers/clickhouse": "^12.2.0",
+    "@types/node": "^24",
+    "testcontainers": "^12.2.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.2"
+  }
+}