@notuslabs/yail 0.1.0

package/dist/http/client.js

@@ -0,0 +1,128 @@
+import { createHash } from "node:crypto";
+import { httpCache } from "../db/internal.js";
+import { sql } from "../db/sql.js";
+/**
+ * HTTP client with an optional response cache. Cached calls are deterministic
+ * across re-indexes, which is what you want for price lookups, swap
+ * classification via aggregator APIs, token metadata, etc.
+ */
+export function createHttpClient(options = {}) {
+    const doFetch = options.fetch ?? fetch;
+    const memory = new Map();
+    const memorySize = options.memorySize ?? 5000;
+    const persist = options.persist !== false && options.db !== undefined;
+    const retries = options.retries ?? 3;
+    const remember = (key, res, expiresAt) => {
+        if (memory.size >= memorySize)
+            memory.delete(memory.keys().next().value);
+        memory.set(key, { res, expiresAt });
+    };
+    async function run(url, init = {}) {
+        const { cache, cacheKey, ...reqInit } = init;
+        let ttl = 0;
+        if (cache === true)
+            ttl = Infinity;
+        else if (typeof cache === "number")
+            ttl = cache;
+        let key;
+        if (ttl > 0)
+            key = hashRequest(url, reqInit, cacheKey);
+        const now = Date.now();
+        if (key) {
+            const m = memory.get(key);
+            if (m && m.expiresAt > now) {
+                options.onCache?.(true);
+                return { ...m.res, cached: true };
+            }
+            if (persist) {
+                const rows = await options.db.rows(httpCache, sql `WHERE key = ${key} LIMIT 1`);
+                const row = rows[0];
+                if (row && row.expiresAt.getTime() > now) {
+                    const res = toResponse(row.status, JSON.parse(row.headers), row.body, true);
+                    remember(key, res, row.expiresAt.getTime());
+                    options.onCache?.(true);
+                    return res;
+                }
+            }
+            options.onCache?.(false);
+        }
+        const res = await fetchWithRetry(url, reqInit);
+        if (key && res.ok) {
+            let expiresAt = now + ttl;
+            if (ttl === Infinity)
+                expiresAt = new Date("2200-01-01T00:00:00Z").getTime();
+            remember(key, res, expiresAt);
+            if (persist) {
+                await options.db.insert(httpCache).values({
+                    key,
+                    url,
+                    status: res.status,
+                    headers: JSON.stringify(res.headers),
+                    body: res.body,
+                    fetchedAt: new Date(now),
+                    expiresAt: new Date(expiresAt),
+                });
+            }
+        }
+        return res;
+    }
+    async function fetchWithRetry(url, init) {
+        let attempt = 0;
+        for (;;) {
+            try {
+                const r = await doFetch(url, init);
+                if ((r.status === 429 || r.status >= 500) && attempt < retries) {
+                    attempt++;
+                    await new Promise((res) => setTimeout(res, 300 * 2 ** attempt));
+                    continue;
+                }
+                const headers = {};
+                r.headers.forEach((v, k) => (headers[k] = v));
+                return toResponse(r.status, headers, await r.text(), false);
+            }
+            catch (err) {
+                if (attempt >= retries)
+                    throw err;
+                attempt++;
+                await new Promise((res) => setTimeout(res, 300 * 2 ** attempt));
+            }
+        }
+    }
+    return {
+        fetch: run,
+        get: (url, init) => run(url, { ...init, method: "GET" }),
+        post: (url, body, init) => run(url, {
+            ...init,
+            method: "POST",
+            headers: { "content-type": "application/json", ...init?.headers },
+            body: toBody(body),
+        }),
+    };
+}
+function toBody(body) {
+    if (typeof body === "string")
+        return body;
+    return JSON.stringify(body);
+}
+function toResponse(status, headers, body, cached) {
+    return {
+        status,
+        ok: status >= 200 && status < 300,
+        headers,
+        body,
+        cached,
+        json() {
+            return JSON.parse(body);
+        },
+    };
+}
+function hashRequest(url, init, extra) {
+    const h = createHash("sha256");
+    h.update(init.method ?? "GET").update("\n").update(url).update("\n");
+    if (init.body)
+        h.update(toBody(init.body));
+    if (extra)
+        h.update("\n").update(extra);
+    return h.digest("hex").slice(0, 40);
+}
+//# sourceMappingURL=client.js.map

package/dist/http/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { createConfig, addressSet, factory } from "./config/index.js";
+export type { Config, ChainConfig, ContractConfig, AccountConfig, EventFilter, AddressSpec, AddressSetRef, FactoryRef, CacheConfig, ObservabilityConfig, ServerConfig, IndexingConfig, AddressSetConfig } from "./config/index.js";
+export { t, table, materializedView, tableDdl, materializedViewDdl } from "./schema/index.js";
+export type { Table, TableOptions, TableEngine, Column, InsertRow, InferRow, MaterializedView } from "./schema/index.js";
+export { createDb, sql, migrate, schemaDdl, BatchWriter, internalTables } from "./db/index.js";
+export type { Db, DatabaseConfig, SqlFragment, MigrateOptions } from "./db/index.js";
+export { hypersync, rpc, cached, esplora, fixtureSource } from "./sources/index.js";
+export type { Source, EvmSource, BitcoinSource, EvmQuery, EvmBatch, EvmLog, EvmBlock, EvmTransaction, BitcoinQuery, BitcoinBatch, BitcoinTransaction, HypersyncOptions, RpcSourceOptions, EsploraOptions, CachedSourceOptions } from "./sources/index.js";
+export { createIndexer } from "./indexer/indexer.js";
+export type { Indexer, IndexerOptions, StatusSnapshot, ReindexRequest } from "./indexer/indexer.js";
+export type { HandlerContext, HandlerDb, AddressesApi } from "./indexer/context.js";
+export type { ContractEvent, EvmAccountEvent, BitcoinAccountEvent, SetupEvent, EventNames, EventOf } from "./indexer/events.js";
+export type { HttpClient, HttpResponse, HttpRequestInit, HttpCacheOptions } from "./http/client.js";
+export type { CachedClient, ReadContractParams } from "./rpc/cached-client.js";
+export type { AddressRow, AddressStatus } from "./addresses/registry.js";
+export { createError } from "./observability/logger.js";
+export type { Observability, WideLogger } from "./observability/logger.js";
+export { createApp } from "./server/api.js";
+export { parseAbi, parseAbiItem, formatUnits, parseUnits, getAddress, isAddress } from "viem";
+export type { Abi, AbiEvent } from "viem";
+//# 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":"AACA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGnO,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/F,YAAY,EAAE,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrF,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpF,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG1P,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpG,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAChI,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpG,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAC9F,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// Config
+export { createConfig, addressSet, factory } from "./config/index.js";
+// Schema + database
+export { t, table, materializedView, tableDdl, materializedViewDdl } from "./schema/index.js";
+export { createDb, sql, migrate, schemaDdl, BatchWriter, internalTables } from "./db/index.js";
+// Sources
+export { hypersync, rpc, cached, esplora, fixtureSource } from "./sources/index.js";
+// Indexer
+export { createIndexer } from "./indexer/indexer.js";
+// Observability
+export { createError } from "./observability/logger.js";
+export { createApp } from "./server/api.js";
+// Handy re-exports
+export { parseAbi, parseAbiItem, formatUnits, parseUnits, getAddress, isAddress } from "viem";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGtE,oBAAoB;AACpB,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/F,UAAU;AACV,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGpF,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQrD,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,mBAAmB;AACnB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC"}

package/dist/indexer/context.d.ts

@@ -0,0 +1,84 @@
+import type { Abi } from "viem";
+import type { AddressRegistry, AddressRow } from "../addresses/registry.js";
+import type { Db } from "../db/client.js";
+import { BatchWriter } from "../db/batch.js";
+import type { RowMeta } from "../db/serialize.js";
+import type { HttpClient } from "../http/client.js";
+import type { CachedClient } from "../rpc/cached-client.js";
+import type { InferRow, InsertRow, Table } from "../schema/table.js";
+import type { WideLogger } from "../observability/logger.js";
+import type { Config } from "../config/types.js";
+/** `context.db`: same as `Db` but inserts are buffered and flushed per batch. */
+export interface HandlerDb extends Omit<Db, "insert"> {
+    /** Buffered insert. Rows become visible in ClickHouse after the batch flushes (before the checkpoint is written). */
+    insert<T extends Table<any>>(table: T): {
+        values(rows: InsertRow<T> | InsertRow<T>[]): void;
+    };
+    /** Buffer-aware lookup: returns the latest row written in this batch for the key, else reads ClickHouse (FINAL). */
+    find<T extends Table<any>>(table: T, key: Partial<InferRow<T>>): Promise<InferRow<T> | null>;
+    /** Force a flush now (rarely needed). */
+    flush(): Promise<void>;
+}
+export interface AddressesApi {
+    /** Is the address a live or pending member of the set on the current chain? */
+    has(set: string, address: string, chain?: string): boolean;
+    /** Register an address for backfill + live indexing. Idempotent. */
+    register(set: string, address: string, options?: {
+        chain?: string;
+        fromBlock?: number;
+        meta?: Record<string, unknown>;
+    }): Promise<AddressRow>;
+    list(set: string, chain?: string): AddressRow[];
+}
+export interface HandlerContext<C extends Config<any, any, any> = Config<any, any, any>, chain extends string = string> {
+    chain: {
+        name: chain;
+        id: number | string;
+        kind: "evm" | "bitcoin";
+    };
+    db: HandlerDb;
+    /** Cached contract reads; only defined for EVM chains with `rpc` configured. */
+    client: CachedClient | undefined;
+    http: HttpClient;
+    addresses: AddressesApi;
+    /** ABIs and static addresses from the config, for `client.readContract`. */
+    contracts: {
+        [K in keyof NonNullable<C["contracts"]> & string]: {
+            abi: NonNullable<C["contracts"]>[K]["abi"];
+            address?: string;
+        };
+    };
+    /** evlog wide-event logger for the current batch. `log.set({...})` adds fields to the batch event. */
+    log: WideLogger;
+    /** True while running an address backfill or re-index job (vs. the live loop). */
+    backfill: boolean;
+}
+export interface ContextDeps {
+    db: Db;
+    writer: BatchWriter;
+    registry: AddressRegistry;
+    http: HttpClient;
+    client: CachedClient | undefined;
+    chain: {
+        name: string;
+        id: number | string;
+        kind: "evm" | "bitcoin";
+    };
+    contracts: Record<string, {
+        abi: Abi;
+        address?: string;
+    }>;
+    defaultFromBlock: (set: string) => number;
+    log: WideLogger;
+    backfill: boolean;
+    /** Set by the runtime before each handler call. */
+    meta: {
+        current: RowMeta;
+    };
+}
+export declare function createHandlerDb(db: Db, writer: BatchWriter, meta: {
+    current: RowMeta;
+}): HandlerDb;
+export declare function createContext(deps: ContextDeps): HandlerContext<any, string>;
+export { BatchWriter };
+//# sourceMappingURL=context.d.ts.map

package/dist/indexer/context.d.ts.map

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

package/dist/indexer/context.js

@@ -0,0 +1,45 @@
+import { BatchWriter } from "../db/batch.js";
+import { toArray } from "../util.js";
+export function createHandlerDb(db, writer, meta) {
+    const handlerDb = {
+        ...db,
+        insert(table) {
+            return {
+                values(rows) {
+                    for (const r of toArray(rows))
+                        writer.add(table, r, meta.current);
+                },
+            };
+        },
+        async find(table, key) {
+            const buffered = writer.peek(table, key);
+            if (buffered)
+                return buffered;
+            return db.find(table, key);
+        },
+        async flush() {
+            await writer.flush();
+        },
+    };
+    return handlerDb;
+}
+export function createContext(deps) {
+    return {
+        chain: deps.chain,
+        db: createHandlerDb(deps.db, deps.writer, deps.meta),
+        client: deps.client,
+        http: deps.http,
+        addresses: {
+            has: (set, address, chain) => deps.registry.has(set, chain ?? deps.chain.name, address),
+            register: (set, address, options) => deps.registry
+                .register({ set, chain: options?.chain ?? deps.chain.name, address, fromBlock: options?.fromBlock ?? deps.defaultFromBlock(set), meta: options?.meta })
+                .then((rows) => rows[0]),
+            list: (set, chain) => deps.registry.list({ set, chain: chain ?? deps.chain.name }),
+        },
+        contracts: deps.contracts,
+        log: deps.log,
+        backfill: deps.backfill,
+    };
+}
+export { BatchWriter };
+//# sourceMappingURL=context.js.map

package/dist/indexer/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/indexer/context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAkDrC,MAAM,UAAU,eAAe,CAAC,EAAM,EAAE,MAAmB,EAAE,IAA0B;IACrF,MAAM,SAAS,GAAc;QAC3B,GAAG,EAAE;QACL,MAAM,CAAC,KAAK;YACV,OAAO;gBACL,MAAM,CAAC,IAAI;oBACT,KAAK,MAAM,CAAC,IAAI,OAAO,CAAM,IAAI,CAAC;wBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzE,CAAC;aACF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG;YACnB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACzC,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,EAAE,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;QACpD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE;YACT,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;YACvF,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAClC,IAAI,CAAC,QAAQ;iBACV,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;iBACtJ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;YAC7B,IAAI,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACnF;QACD,SAAS,EAAE,IAAI,CAAC,SAAgB;QAChC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/indexer/events.d.ts

@@ -0,0 +1,87 @@
+import { type Abi, type AbiEvent, type ContractEventName, type DecodeEventLogReturnType } from "viem";
+import type { Config, EventFilter } from "../config/types.js";
+import type { BitcoinTransaction, EvmBlock, EvmLog, EvmTransaction } from "../sources/types.js";
+type ContractsOf<C extends Config<any, any, any>> = NonNullable<C["contracts"]>;
+type AccountsOf<C extends Config<any, any, any>> = NonNullable<C["accounts"]>;
+export type ContractEventNames<C extends Config<any, any, any>> = {
+    [K in keyof ContractsOf<C> & string]: `${K}:${ContractEventName<ContractsOf<C>[K]["abi"]>}`;
+}[keyof ContractsOf<C> & string];
+export type AccountEventNames<C extends Config<any, any, any>> = {
+    [K in keyof AccountsOf<C> & string]: `${K}:transaction`;
+}[keyof AccountsOf<C> & string];
+export type EventNames<C extends Config<any, any, any>> = ContractEventNames<C> | AccountEventNames<C> | "setup";
+export interface ContractEvent<abi extends Abi = Abi, name extends string = string> {
+    /** Event name as in the ABI. */
+    name: name;
+    /** Decoded, typed arguments. */
+    args: name extends ContractEventName<abi> ? DecodeEventLogReturnType<abi, name>["args"] : Record<string, unknown>;
+    /** Emitting contract, lowercase. */
+    address: string;
+    log: EvmLog;
+    block: EvmBlock;
+    /** Present when the contract sets `includeTransactions: true`. */
+    transaction?: EvmTransaction;
+}
+export interface EvmAccountEvent {
+    /** The matched account address (lowercase). */
+    address: string;
+    direction: "from" | "to" | "self";
+    transaction: EvmTransaction;
+    block: EvmBlock;
+}
+export interface BitcoinAccountEvent {
+    /** The matched account address. */
+    address: string;
+    tx: BitcoinTransaction;
+    block: {
+        height: number;
+        hash: string;
+        time: number;
+    };
+    /** Sum of outputs paying the address, in satoshis. */
+    received: bigint;
+    /** Sum of inputs spent from the address, in satoshis. */
+    sent: bigint;
+    /** received - sent (negative when the address paid out). */
+    net: bigint;
+    fee: bigint;
+    /** True when the address funded at least one input. */
+    isSender: boolean;
+}
+export interface SetupEvent {
+    /** Block the chain starts (or resumes) indexing from. */
+    block: number;
+}
+type ChainKind<C extends Config<any, any, any>, ref> = ref extends string ? C["chains"][ref]["source"]["kind"] : C["chains"][keyof ref & string]["source"]["kind"];
+export type AccountEventOf<C extends Config<any, any, any>, K extends keyof AccountsOf<C>> = ChainKind<C, AccountsOf<C>[K]["chain"]> extends "bitcoin" ? BitcoinAccountEvent : ChainKind<C, AccountsOf<C>[K]["chain"]> extends "evm" ? EvmAccountEvent : EvmAccountEvent | BitcoinAccountEvent;
+export type EventOf<C extends Config<any, any, any>, name extends string> = name extends "setup" ? SetupEvent : name extends `${infer K}:${infer E}` ? K extends keyof ContractsOf<C> ? ContractEvent<ContractsOf<C>[K]["abi"], E> : K extends keyof AccountsOf<C> ? AccountEventOf<C, K> : never : never;
+export type ChainNames<C extends Config<any, any, any>> = keyof C["chains"] & string;
+export interface CompiledFilter {
+    event: AbiEvent;
+    topic0: string;
+    /** topic position (1..3) -> allowed values (padded hex) or an address set name. */
+    topics: Array<{
+        index: number;
+        values?: string[];
+        set?: string;
+    }>;
+}
+export interface CompiledEvent {
+    name: string;
+    abi: AbiEvent;
+    topic0: string;
+}
+export declare function eventTopic(event: AbiEvent): string;
+export declare function abiEvents(abi: Abi): AbiEvent[];
+export declare function compileFilter(abi: Abi, filter: EventFilter): CompiledFilter;
+export declare function encodeTopicValue(type: string, value: string | number | bigint | boolean): string;
+export declare function padAddress(address: string): string;
+export declare function unpadAddress(topic: string): string;
+export declare function decodeLog(event: AbiEvent, log: EvmLog): {
+    args: Record<string, unknown>;
+} | null;
+/** Does a log satisfy a compiled filter? `inSet` resolves address-set membership. */
+export declare function logMatchesFilter(log: EvmLog, filter: CompiledFilter, inSet: (set: string, address: string) => boolean): boolean;
+export declare function bitcoinAccountEvent(tx: BitcoinTransaction, address: string): BitcoinAccountEvent | null;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/indexer/events.d.ts.map

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

package/dist/indexer/events.js

@@ -0,0 +1,88 @@
+import { decodeEventLog, encodeAbiParameters, toEventSelector } from "viem";
+import { isAddressSet } from "../config/address.js";
+import { toArray } from "../util.js";
+export function eventTopic(event) {
+    return toEventSelector(event).toLowerCase();
+}
+export function abiEvents(abi) {
+    return abi.filter((x) => x.type === "event");
+}
+export function compileFilter(abi, filter) {
+    const event = abiEvents(abi).find((e) => e.name === filter.event);
+    if (!event)
+        throw new Error(`filter: unknown event ${filter.event}`);
+    const indexed = event.inputs.filter((i) => i.indexed);
+    const topics = [];
+    for (const [name, value] of Object.entries(filter.args ?? {})) {
+        const idx = indexed.findIndex((i) => i.name === name);
+        if (idx < 0)
+            throw new Error(`filter: ${filter.event}.${name} is not an indexed parameter`);
+        const input = indexed[idx];
+        if (isAddressSet(value)) {
+            if (input.type !== "address")
+                throw new Error(`filter: ${filter.event}.${name} must be an address to use addressSet()`);
+            topics.push({ index: idx + 1, set: value.set });
+        }
+        else {
+            topics.push({ index: idx + 1, values: toArray(value).map((v) => encodeTopicValue(input.type, v)) });
+        }
+    }
+    return { event, topic0: eventTopic(event), topics };
+}
+export function encodeTopicValue(type, value) {
+    if (type === "address")
+        return `0x${"0".repeat(24)}${String(value).toLowerCase().replace(/^0x/, "")}`;
+    if (type.startsWith("bytes") && type !== "bytes")
+        return String(value).toLowerCase();
+    return encodeAbiParameters([{ type }], [value]).toLowerCase();
+}
+export function padAddress(address) {
+    return `0x${"0".repeat(24)}${address.toLowerCase().replace(/^0x/, "")}`;
+}
+export function unpadAddress(topic) {
+    return `0x${topic.slice(-40)}`.toLowerCase();
+}
+export function decodeLog(event, log) {
+    try {
+        const decoded = decodeEventLog({ abi: [event], data: log.data, topics: log.topics, strict: false });
+        return { args: (decoded.args ?? {}) };
+    }
+    catch {
+        return null;
+    }
+}
+/** Does a log satisfy a compiled filter? `inSet` resolves address-set membership. */
+export function logMatchesFilter(log, filter, inSet) {
+    if ((log.topics[0] ?? "").toLowerCase() !== filter.topic0)
+        return false;
+    for (const t of filter.topics) {
+        const topic = log.topics[t.index]?.toLowerCase();
+        if (!topic)
+            return false;
+        if (t.set !== undefined) {
+            if (!inSet(t.set, unpadAddress(topic)))
+                return false;
+        }
+        else if (t.values && !t.values.includes(topic))
+            return false;
+    }
+    return true;
+}
+export function bitcoinAccountEvent(tx, address) {
+    let received = 0n;
+    let sent = 0n;
+    let isSender = false;
+    for (const o of tx.vout)
+        if (o.address === address)
+            received += o.value;
+    for (const i of tx.vin) {
+        if (i.prevout?.address === address) {
+            sent += i.prevout.value;
+            isSender = true;
+        }
+    }
+    if (received === 0n && sent === 0n)
+        return null;
+    return { address, tx, block: { height: tx.blockHeight, hash: tx.blockHash, time: tx.blockTime }, received, sent, net: received - sent, fee: tx.fee, isSender };
+}
+//# sourceMappingURL=events.js.map

package/dist/indexer/events.js.map

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

package/dist/indexer/indexer.d.ts

@@ -0,0 +1,114 @@
+import { AddressRegistry, type AddressRow } from "../addresses/registry.js";
+import type { Config } from "../config/types.js";
+import { type Db } from "../db/client.js";
+import { type MigrateOptions, type SchemaModule } from "../db/migrate.js";
+import { type HttpClient } from "../http/client.js";
+import { type Observability } from "../observability/logger.js";
+import type { MaterializedView } from "../schema/view.js";
+import type { Table } from "../schema/table.js";
+import { isAddressSet, isFactory } from "../config/address.js";
+import type { HandlerContext } from "./context.js";
+import type { ChainNames, EventNames, EventOf } from "./events.js";
+import { JobRunner, type JobRow } from "./jobs.js";
+import { type ChainPlan } from "./plan.js";
+import { ChainRunner } from "./runtime.js";
+export interface IndexerOptions<C extends Config<any, any, any>> {
+    config: C;
+    /** The schema module (`import * as schema from "./schema"`) or an array of tables/views. */
+    schema: SchemaModule | ReadonlyArray<Table<any> | MaterializedView>;
+    /** What to do when a handler throws. `stop` (default) halts the chain so data stays consistent. */
+    onError?: "stop" | "skip";
+    /** Override `fetch` used by `context.http` (tests). */
+    fetch?: typeof fetch;
+}
+export interface StatusSnapshot {
+    chains: Record<string, {
+        cursor: number;
+        head: number;
+        finalized: number;
+        lagBlocks: number;
+        caughtUp: boolean;
+        running: boolean;
+        error?: string;
+        pendingJobs: number;
+        blocksIndexed: number;
+        eventsProcessed: number;
+        batches: number;
+        errors: number;
+        lastBatchMs: number;
+        lastBatchAt?: string;
+    }>;
+    addresses: Array<{
+        set: string;
+        chain: string;
+        status: string;
+        count: number;
+    }>;
+    counters: Record<string, number>;
+}
+export interface ReindexRequest {
+    chain: string;
+    /** Re-index a block range [fromBlock, toBlock). */
+    fromBlock?: number;
+    toBlock?: number;
+    /** Or re-index one entity: delete rows where the scope column equals `value` and re-run its address history. */
+    scope?: string;
+    value?: string;
+}
+export interface Indexer<C extends Config<any, any, any>> {
+    readonly config: C;
+    readonly schema: SchemaModule | ReadonlyArray<Table<any> | MaterializedView>;
+    /** Register a handler. Names are `Contract:Event`, `Account:transaction`, or `setup`. */
+    on<name extends EventNames<C>>(name: name, handler: (args: {
+        event: EventOf<C, name>;
+        context: HandlerContext<C, ChainNames<C>>;
+    }) => Promise<void> | void): Indexer<C>;
+    /** Connect, migrate, and prepare runners without indexing. Idempotent. */
+    init(): Promise<void>;
+    /** Run migrations only. */
+    migrate(options?: MigrateOptions): Promise<void>;
+    /** Index continuously (live). Resolves when stopped or when a chain fails. */
+    start(options?: {
+        server?: boolean;
+    }): Promise<void>;
+    /** Index until every chain is caught up to its finalized head and all jobs are done, then stop. For tests and one-shot runs. */
+    run(): Promise<void>;
+    stop(): Promise<void>;
+    /** The ClickHouse client (available after `init`). */
+    readonly db: Db;
+    readonly observability: Observability;
+    readonly http: HttpClient;
+    addresses: {
+        register(input: {
+            set: string;
+            address: string;
+            chain?: string;
+            fromBlock?: number;
+            meta?: Record<string, unknown>;
+        } | Array<{
+            set: string;
+            address: string;
+            chain?: string;
+            fromBlock?: number;
+            meta?: Record<string, unknown>;
+        }>): Promise<AddressRow[]>;
+        list(filter?: {
+            set?: string;
+            chain?: string;
+            status?: AddressRow["status"];
+        }): AddressRow[];
+        has(set: string, chain: string, address: string): boolean;
+    };
+    reindex(request: ReindexRequest): Promise<JobRow[]>;
+    status(): Promise<StatusSnapshot>;
+    /** Internal: access to plans/runners (used by the server and tests). */
+    readonly internals: {
+        plans: Map<string, ChainPlan>;
+        runners: Map<string, ChainRunner>;
+        jobs: Map<string, JobRunner>;
+        registry: AddressRegistry;
+    };
+}
+export declare function createIndexer<C extends Config<any, any, any>>(options: IndexerOptions<C>): Indexer<C>;
+export { isAddressSet, isFactory };
+//# sourceMappingURL=indexer.d.ts.map