@notuslabs/yail 0.1.0

package/dist/sources/esplora.js

@@ -0,0 +1,138 @@
+/**
+ * Bitcoin source backed by an Esplora HTTP API (mempool.space, blockstream.info,
+ * or self-hosted electrs). HyperSync has no Bitcoin support and Bitcoin Core's
+ * RPC has no address index, so address history is scanned through Esplora.
+ * Each query scans the requested addresses newest-first and keeps confirmed
+ * transactions inside [fromBlock, toBlock).
+ */
+export function esplora(options) {
+    const doFetch = options.fetch ?? fetch;
+    const base = options.url.replace(/\/$/, "");
+    const concurrency = options.concurrency ?? 2;
+    async function getJson(path, signal) {
+        let attempt = 0;
+        for (;;) {
+            const res = await doFetch(`${base}${path}`, { headers: options.headers, signal });
+            if (res.status === 429 || res.status >= 500) {
+                attempt++;
+                if (attempt > 6)
+                    throw new Error(`esplora ${path}: HTTP ${res.status} after ${attempt} attempts`);
+                await sleep(Math.min(30_000, 500 * 2 ** attempt), signal);
+                continue;
+            }
+            if (!res.ok)
+                throw new Error(`esplora ${path}: HTTP ${res.status} ${await res.text().catch(() => "")}`);
+            const text = await res.text();
+            if (text.startsWith("{") || text.startsWith("["))
+                return JSON.parse(text);
+            return text;
+        }
+    }
+    async function scanAddress(address, fromBlock, toBlock, signal) {
+        const out = [];
+        let lastSeen;
+        for (;;) {
+            signal?.throwIfAborted();
+            let path = `/address/${address}/txs/chain`;
+            if (lastSeen)
+                path += `/${lastSeen}`;
+            const page = await getJson(path, signal);
+            if (page.length === 0)
+                break;
+            let reachedBottom = false;
+            for (const tx of page) {
+                const h = tx.status.block_height;
+                if (!tx.status.confirmed || h === undefined)
+                    continue;
+                if (h < fromBlock) {
+                    reachedBottom = true;
+                    break;
+                }
+                if (h < toBlock)
+                    out.push(tx);
+            }
+            if (reachedBottom || page.length < 25)
+                break;
+            lastSeen = page[page.length - 1].txid;
+        }
+        return out;
+    }
+    return {
+        kind: "bitcoin",
+        name: `esplora(${new URL(base).host})`,
+        async getHeight() {
+            const h = await getJson("/blocks/tip/height");
+            return Number(h);
+        },
+        async *fetch(query, fetchOptions) {
+            const byId = new Map();
+            let i = 0;
+            const addrs = query.addresses;
+            const workers = Array.from({ length: Math.min(concurrency, addrs.length) }, async () => {
+                while (i < addrs.length) {
+                    const a = addrs[i++];
+                    const txs = await scanAddress(a, query.fromBlock, query.toBlock, fetchOptions?.signal);
+                    for (const tx of txs)
+                        byId.set(tx.txid, tx);
+                }
+            });
+            await Promise.all(workers);
+            const txs = [...byId.values()]
+                .map(toTransaction)
+                .sort((a, b) => a.blockHeight - b.blockHeight || a.txid.localeCompare(b.txid));
+            const size = options.batchSize ?? 500;
+            if (txs.length === 0) {
+                yield { fromBlock: query.fromBlock, nextBlock: query.toBlock, transactions: [] };
+                return;
+            }
+            let from = query.fromBlock;
+            for (let start = 0; start < txs.length; start += size) {
+                const chunk = txs.slice(start, start + size);
+                const last = start + size >= txs.length;
+                // Batches must not split a block: extend chunk to include the rest of its last block.
+                let end = start + size;
+                while (!last && end < txs.length && txs[end].blockHeight === chunk[chunk.length - 1].blockHeight) {
+                    chunk.push(txs[end]);
+                    end++;
+                }
+                let next = chunk[chunk.length - 1].blockHeight + 1;
+                if (last)
+                    next = query.toBlock;
+                yield { fromBlock: from, nextBlock: next, transactions: chunk };
+                from = next;
+                start = end - size;
+            }
+        },
+    };
+}
+function toTransaction(tx) {
+    return {
+        txid: tx.txid,
+        blockHeight: tx.status.block_height,
+        blockHash: tx.status.block_hash ?? "",
+        blockTime: tx.status.block_time ?? 0,
+        fee: BigInt(tx.fee ?? 0),
+        vin: tx.vin.map((v) => ({
+            txid: v.txid,
+            vout: v.vout,
+            isCoinbase: v.is_coinbase,
+            prevout: toPrevout(v.prevout),
+        })),
+        vout: tx.vout.map((o, n) => ({ n, address: o.scriptpubkey_address ?? null, value: BigInt(o.value), scriptType: o.scriptpubkey_type })),
+    };
+}
+function toPrevout(prevout) {
+    if (!prevout)
+        return null;
+    return { address: prevout.scriptpubkey_address ?? null, value: BigInt(prevout.value) };
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(t);
+            reject(signal.reason);
+        });
+    });
+}
+//# sourceMappingURL=esplora.js.map

package/dist/sources/esplora.js.map

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

package/dist/sources/fixture.d.ts

@@ -0,0 +1,51 @@
+import type { BitcoinQuery, BitcoinSource, BitcoinTransaction, EvmBlock, EvmLog, EvmQuery, EvmSource, EvmTransaction } from "./types.js";
+export interface EvmFixture {
+    version: 1;
+    kind: "evm";
+    name?: string;
+    chainId?: number;
+    height: number;
+    fromBlock: number;
+    toBlock: number;
+    blocks: EvmBlock[];
+    transactions: EvmTransaction[];
+    logs: EvmLog[];
+    /** Free-form ground truth captured at record time, for assertions in tests. */
+    expected?: Record<string, unknown>;
+}
+export interface BitcoinFixture {
+    version: 1;
+    kind: "bitcoin";
+    name?: string;
+    height: number;
+    fromBlock: number;
+    toBlock: number;
+    transactions: BitcoinTransaction[];
+    expected?: Record<string, unknown>;
+}
+export type Fixture = EvmFixture | BitcoinFixture;
+/**
+ * Replay a recorded fixture as a source. Queries are answered by filtering
+ * the recorded data, so a broad recording (e.g. every log of a pool) can
+ * serve narrower runtime queries (e.g. only Swap events).
+ */
+export declare function fixtureSource(fixture: EvmFixture, options?: {
+    blocksPerBatch?: number;
+}): EvmSource;
+export declare function fixtureSource(fixture: BitcoinFixture, options?: {
+    blocksPerBatch?: number;
+}): BitcoinSource;
+export declare function matchesLogFilters(log: EvmLog, query: EvmQuery): boolean;
+/** Record every batch of a query into a fixture object (EVM). */
+export declare function recordEvmFixture(source: EvmSource, query: EvmQuery, meta?: {
+    name?: string;
+    chainId?: number;
+    expected?: Record<string, unknown>;
+}): Promise<EvmFixture>;
+export declare function recordBitcoinFixture(source: BitcoinSource, query: BitcoinQuery, meta?: {
+    name?: string;
+    expected?: Record<string, unknown>;
+}): Promise<BitcoinFixture>;
+export declare function writeFixture(path: string, fixture: Fixture): void;
+export declare function readFixture<T extends Fixture = Fixture>(path: string): T;
+//# sourceMappingURL=fixture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/sources/fixture.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAY,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAU,MAAM,YAAY,CAAC;AAGzK,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AACrG,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAAC;AAiD7G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAcvE;AAED,iEAAiE;AACjE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAalL;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAIhL;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAGjE;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAExE"}

package/dist/sources/fixture.js

@@ -0,0 +1,102 @@
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { reviveBatch, serializeBatch } from "./cached.js";
+import { matchesTxFilters } from "./rpc.js";
+import { logOrder, lower, txOrder } from "./types.js";
+export function fixtureSource(fixture, options = {}) {
+    const per = options.blocksPerBatch ?? 1000;
+    if (fixture.kind === "evm") {
+        const src = {
+            kind: "evm",
+            name: `fixture(${fixture.name ?? "evm"})`,
+            async getHeight() {
+                return fixture.height;
+            },
+            async *fetch(query) {
+                let from = query.fromBlock;
+                while (from < query.toBlock) {
+                    const to = Math.min(from + per, query.toBlock);
+                    const logs = fixture.logs.filter((l) => l.blockNumber >= from && l.blockNumber < to && matchesLogFilters(l, query)).sort(logOrder);
+                    const txs = fixture.transactions
+                        .filter((t) => t.blockNumber >= from && t.blockNumber < to)
+                        .filter((t) => (query.transactions.length > 0 && matchesTxFilters(t.from, t.to, query.transactions)) || (query.includeLogTransactions && logs.some((l) => l.transactionHash === t.hash)))
+                        .sort(txOrder);
+                    const wanted = new Set([...logs.map((l) => l.blockNumber), ...txs.map((t) => t.blockNumber)]);
+                    const blocks = fixture.blocks.filter((b) => wanted.has(b.number)).sort((a, b) => a.number - b.number);
+                    yield { fromBlock: from, nextBlock: to, blocks, transactions: txs, logs, archiveHeight: fixture.height };
+                    from = to;
+                }
+            },
+            async getBlock(n) {
+                return fixture.blocks.find((b) => b.number === n) ?? null;
+            },
+        };
+        return src;
+    }
+    const btc = {
+        kind: "bitcoin",
+        name: `fixture(${fixture.name ?? "bitcoin"})`,
+        async getHeight() {
+            return fixture.height;
+        },
+        async *fetch(query) {
+            const set = new Set(query.addresses);
+            const txs = fixture.transactions
+                .filter((t) => t.blockHeight >= query.fromBlock && t.blockHeight < query.toBlock)
+                .filter((t) => t.vin.some((v) => v.prevout?.address && set.has(v.prevout.address)) || t.vout.some((o) => o.address && set.has(o.address)))
+                .sort((a, b) => a.blockHeight - b.blockHeight || a.txid.localeCompare(b.txid));
+            yield { fromBlock: query.fromBlock, nextBlock: query.toBlock, transactions: txs };
+        },
+    };
+    return btc;
+}
+export function matchesLogFilters(log, query) {
+    if (query.logs.length === 0)
+        return false;
+    return query.logs.some((f) => {
+        if (f.address && f.address.length > 0 && !f.address.map(lower).includes(lower(log.address)))
+            return false;
+        if (f.topics) {
+            for (let i = 0; i < f.topics.length; i++) {
+                const alts = f.topics[i];
+                if (alts === null || alts === undefined || alts.length === 0)
+                    continue;
+                const topic = log.topics[i];
+                if (!topic || !alts.map(lower).includes(lower(topic)))
+                    return false;
+            }
+        }
+        return true;
+    });
+}
+/** Record every batch of a query into a fixture object (EVM). */
+export async function recordEvmFixture(source, query, meta = {}) {
+    const fx = { version: 1, kind: "evm", name: meta.name, chainId: meta.chainId, height: await source.getHeight(), fromBlock: query.fromBlock, toBlock: query.toBlock, blocks: [], transactions: [], logs: [], expected: meta.expected };
+    const blocks = new Map();
+    const txs = new Map();
+    for await (const batch of source.fetch(query)) {
+        for (const b of batch.blocks)
+            blocks.set(b.number, b);
+        for (const t of batch.transactions)
+            txs.set(t.hash, t);
+        fx.logs.push(...batch.logs);
+    }
+    fx.blocks = [...blocks.values()].sort((a, b) => a.number - b.number);
+    fx.transactions = [...txs.values()].sort(txOrder);
+    fx.logs.sort(logOrder);
+    return fx;
+}
+export async function recordBitcoinFixture(source, query, meta = {}) {
+    const fx = { version: 1, kind: "bitcoin", name: meta.name, height: await source.getHeight(), fromBlock: query.fromBlock, toBlock: query.toBlock, transactions: [], expected: meta.expected };
+    for await (const batch of source.fetch(query))
+        fx.transactions.push(...batch.transactions);
+    return fx;
+}
+export function writeFixture(path, fixture) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, serializeBatch(fixture) + "\n");
+}
+export function readFixture(path) {
+    return reviveBatch(readFileSync(path, "utf8"));
+}
+//# sourceMappingURL=fixture.js.map

package/dist/sources/fixture.js.map

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

package/dist/sources/hypersync.d.ts

@@ -0,0 +1,19 @@
+import { type Query } from "@envio-dev/hypersync-client";
+import type { EvmQuery, EvmSource } from "./types.js";
+export interface HypersyncOptions {
+    /** e.g. https://base.hypersync.xyz (see https://docs.envio.dev/docs/HyperSync/hypersync-supported-networks). */
+    url: string;
+    /** Envio API token (https://app.envio.dev/api-tokens). Falls back to ENVIO_API_TOKEN. */
+    apiToken?: string;
+    maxNumRetries?: number;
+    httpReqTimeoutMillis?: number;
+    /** Parallel requests used by the streaming path for large ranges. Default 8. */
+    concurrency?: number;
+    /** Use the parallel stream API when a range spans at least this many blocks. Default 5000. */
+    streamThreshold?: number;
+    /** Target response size hint for the stream API. Default 400k. */
+    responseBytesTarget?: number;
+}
+export declare function hypersync(options: HypersyncOptions): EvmSource;
+export declare function toHypersyncQuery(query: EvmQuery): Query;
+//# sourceMappingURL=hypersync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hypersync.d.ts","sourceRoot":"","sources":["../../src/sources/hypersync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,KAAK,EAAoI,MAAM,6BAA6B,CAAC;AAC3O,OAAO,KAAK,EAA8B,QAAQ,EAAE,SAAS,EAAgC,MAAM,YAAY,CAAC;AAIhH,MAAM,WAAW,gBAAgB;IAC/B,gHAAgH;IAChH,GAAG,EAAE,MAAM,CAAC;IACZ,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA8C9D;AA0CD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAiBvD"}

package/dist/sources/hypersync.js

@@ -0,0 +1,169 @@
+import { HypersyncClient } from "@envio-dev/hypersync-client";
+import { lower } from "./types.js";
+import { lowerOrNull } from "../util.js";
+const BLOCK_FIELDS = ["Number", "Hash", "ParentHash", "Timestamp"];
+const LOG_FIELDS = ["BlockNumber", "BlockHash", "TransactionHash", "TransactionIndex", "LogIndex", "Address", "Data", "Topic0", "Topic1", "Topic2", "Topic3", "Removed"];
+const TX_FIELDS = ["Hash", "BlockNumber", "TransactionIndex", "From", "To", "Value", "Input", "Nonce", "Gas", "GasPrice", "GasUsed", "EffectiveGasPrice", "Status", "Type", "ContractAddress"];
+export function hypersync(options) {
+    let client;
+    const getClient = () => {
+        // Resolved lazily so `yail ddl` / `yail migrate` work without a token.
+        const apiToken = options.apiToken ?? process.env.ENVIO_API_TOKEN;
+        if (!apiToken) {
+            throw new Error(`hypersync(${options.url}): missing apiToken. Pass it explicitly or set ENVIO_API_TOKEN (https://app.envio.dev/api-tokens).`);
+        }
+        client ??= new HypersyncClient({
+            url: options.url,
+            apiToken,
+            maxNumRetries: options.maxNumRetries ?? 12,
+            httpReqTimeoutMillis: options.httpReqTimeoutMillis ?? 30_000,
+        });
+        return client;
+    };
+    const source = {
+        kind: "evm",
+        name: `hypersync(${new URL(options.url).host})`,
+        async getHeight() {
+            return getClient().getHeight();
+        },
+        async *fetch(query, fetchOptions) {
+            const hsQuery = toHypersyncQuery(query);
+            const span = query.toBlock - query.fromBlock;
+            const threshold = options.streamThreshold ?? 5000;
+            if (span >= threshold) {
+                yield* streamRange(getClient(), hsQuery, query, options, fetchOptions);
+            }
+            else {
+                yield* getRange(getClient(), hsQuery, query, fetchOptions);
+            }
+        },
+        async getBlock(number) {
+            const res = await getClient().get({
+                fromBlock: number,
+                toBlock: number + 1,
+                includeAllBlocks: true,
+                fieldSelection: { block: [...BLOCK_FIELDS] },
+            });
+            const b = res.data.blocks[0];
+            if (!b)
+                return null;
+            return toBlock(b);
+        },
+    };
+    return source;
+}
+async function* getRange(client, hsQuery, query, fetchOptions) {
+    let from = query.fromBlock;
+    while (from < query.toBlock) {
+        fetchOptions?.signal?.throwIfAborted();
+        const res = await client.get({ ...hsQuery, fromBlock: from });
+        const next = Math.min(res.nextBlock, query.toBlock);
+        if (next <= from)
+            throw new Error(`hypersync: nextBlock ${res.nextBlock} did not advance from ${from}`);
+        yield toBatch(res, from, next);
+        from = next;
+    }
+}
+async function* streamRange(client, hsQuery, query, options, fetchOptions) {
+    const cfg = {
+        concurrency: options.concurrency ?? 8,
+        responseBytesTarget: options.responseBytesTarget ?? 400_000,
+        hexOutput: "Prefixed",
+    };
+    const stream = await client.stream(hsQuery, cfg);
+    let from = query.fromBlock;
+    try {
+        while (from < query.toBlock) {
+            if (fetchOptions?.signal?.aborted)
+                break;
+            const res = await stream.recv();
+            if (res === null)
+                break;
+            const next = Math.min(res.nextBlock, query.toBlock);
+            if (next <= from)
+                continue; // empty overlapping page
+            yield toBatch(res, from, next);
+            from = next;
+        }
+    }
+    finally {
+        await stream.close().catch(() => { });
+    }
+    fetchOptions?.signal?.throwIfAborted();
+    // The stream API is allowed to stop early (server-side limits); cover the remainder with plain gets.
+    if (from < query.toBlock) {
+        yield* getRange(client, hsQuery, { ...query, fromBlock: from }, fetchOptions);
+    }
+}
+export function toHypersyncQuery(query) {
+    const wantTx = query.transactions.length > 0 || query.includeLogTransactions;
+    const logFields = [];
+    if (query.logs.length > 0)
+        logFields.push(...LOG_FIELDS);
+    const txFields = [];
+    if (wantTx)
+        txFields.push(...TX_FIELDS);
+    return {
+        fromBlock: query.fromBlock,
+        toBlock: query.toBlock,
+        logs: query.logs.map((f) => {
+            const filter = { address: f.address?.map(lower) };
+            if (f.topics)
+                filter.topics = f.topics.map((alts) => alts ?? []);
+            return filter;
+        }),
+        transactions: query.transactions.map((f) => ({ from: f.from?.map(lower), to: f.to?.map(lower) })),
+        fieldSelection: { block: [...BLOCK_FIELDS], log: logFields, transaction: txFields },
+    };
+}
+function toBatch(res, fromBlock, nextBlock) {
+    const batch = {
+        fromBlock,
+        nextBlock,
+        blocks: res.data.blocks.map(toBlock),
+        transactions: res.data.transactions.map(toTransaction),
+        logs: res.data.logs.map(toLog),
+        archiveHeight: res.archiveHeight,
+    };
+    const guard = res.rollbackGuard;
+    if (guard) {
+        batch.rollbackGuard = { blockNumber: guard.blockNumber, hash: guard.hash, firstBlockNumber: guard.firstBlockNumber, firstParentHash: guard.firstParentHash };
+    }
+    return batch;
+}
+function toBlock(b) {
+    return { number: b.number, hash: b.hash, parentHash: b.parentHash, timestamp: Number(b.timestamp) };
+}
+function toLog(l) {
+    return {
+        blockNumber: l.blockNumber,
+        blockHash: l.blockHash,
+        transactionHash: l.transactionHash,
+        transactionIndex: l.transactionIndex,
+        logIndex: l.logIndex,
+        address: lower(l.address),
+        data: l.data ?? "0x",
+        topics: l.topics.filter((t) => typeof t === "string" && t.length > 0),
+        removed: l.removed,
+    };
+}
+function toTransaction(t) {
+    return {
+        hash: t.hash,
+        blockNumber: t.blockNumber,
+        transactionIndex: t.transactionIndex,
+        from: lower(t.from),
+        to: lowerOrNull(t.to),
+        value: t.value ?? 0n,
+        input: t.input ?? "0x",
+        nonce: t.nonce,
+        gas: t.gas,
+        gasPrice: t.gasPrice,
+        gasUsed: t.gasUsed,
+        effectiveGasPrice: t.effectiveGasPrice,
+        status: t.status,
+        type: t.type,
+        contractAddress: t.contractAddress ?? null,
+    };
+}
+//# sourceMappingURL=hypersync.js.map

package/dist/sources/hypersync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypersync.js","sourceRoot":"","sources":["../../src/sources/hypersync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA+K,MAAM,6BAA6B,CAAC;AAE3O,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiBzC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAU,CAAC;AAC5E,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAClL,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,CAAU,CAAC;AAExM,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,IAAI,MAAmC,CAAC;IACxC,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,uEAAuE;QACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QACjE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,GAAG,oGAAoG,CAAC,CAAC;QAChJ,CAAC;QACD,MAAM,KAAK,IAAI,eAAe,CAAC;YAC7B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ;YACR,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;YAC1C,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,MAAM;SAC7D,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAc;QACxB,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,aAAa,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG;QAC/C,KAAK,CAAC,SAAS;YACb,OAAO,SAAS,EAAE,CAAC,SAAS,EAAE,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,CAAC,KAAK,CAAC,KAAe,EAAE,YAA2B;YACvD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC;YAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;YAClD,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;gBACtB,KAAK,CAAC,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC3B,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC,GAAG,CAAC;gBAChC,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,MAAM,GAAG,CAAC;gBACnB,gBAAgB,EAAE,IAAI;gBACtB,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE;aAC7C,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAuB,EAAE,OAAc,EAAE,KAAe,EAAE,YAA2B;IAC5G,IAAI,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAC3B,OAAO,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5B,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,IAAI,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,SAAS,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACxG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,WAAW,CAAC,MAAuB,EAAE,OAAc,EAAE,KAAe,EAAE,OAAyB,EAAE,YAA2B;IAC1I,MAAM,GAAG,GAAiB;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;QACrC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,OAAO;QAC3D,SAAS,EAAE,UAAU;KACtB,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,IAAI,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5B,IAAI,YAAY,EAAE,MAAM,EAAE,OAAO;gBAAE,MAAM;YACzC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,GAAG,KAAK,IAAI;gBAAE,MAAM;YACxB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,IAAI,IAAI,IAAI;gBAAE,SAAS,CAAC,yBAAyB;YACrD,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACvC,qGAAqG;IACrG,IAAI,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACzB,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC;IAC7E,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,IAAI,MAAM;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACxC,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,MAAM,MAAM,GAAc,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjG,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE;KACpF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAkB,EAAE,SAAiB,EAAE,SAAiB;IACvE,MAAM,KAAK,GAAa;QACtB,SAAS;QACT,SAAS;QACT,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QACpC,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC;QACtD,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAC9B,aAAa,EAAE,GAAG,CAAC,aAAa;KACjC,CAAC;IACF,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;IAChC,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,aAAa,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;IAC/J,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,CAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAK,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAU,CAAC,EAAE,CAAC;AACzG,CAAC;AAED,SAAS,KAAK,CAAC,CAAQ;IACrB,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,WAAY;QAC3B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,eAAe,EAAE,CAAC,CAAC,eAAgB;QACnC,gBAAgB,EAAE,CAAC,CAAC,gBAAiB;QACrC,QAAQ,EAAE,CAAC,CAAC,QAAS;QACrB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAQ,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAClF,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,CAAO;IAC5B,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAK;QACb,WAAW,EAAE,CAAC,CAAC,WAAY;QAC3B,gBAAgB,EAAE,CAAC,CAAC,gBAAiB;QACrC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAK,CAAC;QACpB,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;QACtB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;QACtC,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;KAC3C,CAAC;AACJ,CAAC"}

package/dist/sources/index.d.ts

@@ -0,0 +1,13 @@
+export type * from "./types.js";
+export { logOrder, txOrder } from "./types.js";
+export { hypersync, toHypersyncQuery } from "./hypersync.js";
+export type { HypersyncOptions } from "./hypersync.js";
+export { rpc } from "./rpc.js";
+export type { RpcSourceOptions } from "./rpc.js";
+export { cached, hashQuery } from "./cached.js";
+export type { CachedSourceOptions } from "./cached.js";
+export { esplora } from "./esplora.js";
+export type { EsploraOptions } from "./esplora.js";
+export { fixtureSource, recordEvmFixture, recordBitcoinFixture, writeFixture, readFixture, matchesLogFilters } from "./fixture.js";
+export type { Fixture, EvmFixture, BitcoinFixture } from "./fixture.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnI,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/sources/index.js

@@ -0,0 +1,7 @@
+export { logOrder, txOrder } from "./types.js";
+export { hypersync, toHypersyncQuery } from "./hypersync.js";
+export { rpc } from "./rpc.js";
+export { cached, hashQuery } from "./cached.js";
+export { esplora } from "./esplora.js";
+export { fixtureSource, recordEvmFixture, recordBitcoinFixture, writeFixture, readFixture, matchesLogFilters } from "./fixture.js";
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/sources/rpc.d.ts

@@ -0,0 +1,21 @@
+import { type PublicClient } from "viem";
+import type { EvmSource, EvmTxFilter } from "./types.js";
+export interface RpcSourceOptions {
+    url: string;
+    /** Blocks per eth_getLogs request. Default 2000 (most public RPCs cap at 2k-10k). */
+    blockRange?: number;
+    /** Fetch receipts (gasUsed, status) for matched account transactions. Default true. */
+    receipts?: boolean;
+    /** Max concurrent RPC requests. Default 4. */
+    concurrency?: number;
+    /** Optional viem client override (testing). */
+    client?: PublicClient;
+}
+/**
+ * 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 declare function rpc(options: RpcSourceOptions): EvmSource;
+export declare function matchesTxFilters(from: string, to: string | null | undefined, filters: EvmTxFilter[]): boolean;
+//# sourceMappingURL=rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/sources/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAwC,SAAS,EAAkB,WAAW,EAAgB,MAAM,YAAY,CAAC;AAI7H,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAcD;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA+GxD;AAmCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAQ7G"}