@artblocks/abx-indexer 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Art Blocks, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @artblocks/abx-indexer — Layer 3 reference indexer.
+ *
+ * Replays the event spine from chain into a disposable, rebuildable projection.
+ * The canonical re-index: how every service onboards or exits a project.
+ */
+export { SelfHostIndexer, type IndexResult } from './indexer.js';
+export { SqliteStore, type Store, type ProjectRegistration, type EffectStatusRow, type EffectArtifactRow, } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAC,eAAe,EAAE,KAAK,WAAW,EAAC,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,WAAW,EACX,KAAK,KAAK,EACV,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @artblocks/abx-indexer — Layer 3 reference indexer.
+ *
+ * Replays the event spine from chain into a disposable, rebuildable projection.
+ * The canonical re-index: how every service onboards or exits a project.
+ */
+export { SelfHostIndexer } from './indexer.js';
+export { SqliteStore, } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAC,eAAe,EAAmB,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,WAAW,GAKZ,MAAM,YAAY,CAAC"}

package/dist/indexer.d.ts

@@ -0,0 +1,43 @@
+import { type Address, type ProjectState, type PublicClient } from '@artblocks/abx-sdk';
+import { type Store, type ProjectRegistration } from './store.js';
+export interface IndexResult {
+    state: ProjectState;
+    elapsedMs: number;
+    mode: 'full' | 'incremental';
+}
+/**
+ * The reference indexer (Layer 3). It does one thing well: replay the event
+ * spine from chain into the store. Because every state change rides a standard,
+ * versioned event, re-indexing is a *compute* cost, not an engineering one — and
+ * it needs no cooperation from whatever provider held the data before. This is
+ * the implementation everyone re-indexes with when they onboard or leave a
+ * service; running a different one changes nothing the protocol guarantees.
+ */
+export declare class SelfHostIndexer {
+    readonly store: Store;
+    private clients;
+    constructor(store?: Store);
+    private client;
+    /** The RPC client for a chain — exposed for reads that aren't a reindex (e.g. deploy-block
+     *  discovery in the admin control plane). Reuses the same pooled client as `reindex`. */
+    publicClient(chainKey: string): PublicClient;
+    /** Register a project to index (the minimum needed to replay it). */
+    register(reg: Omit<ProjectRegistration, 'registeredAt'>): ProjectRegistration;
+    /**
+     * Re-index a single project. By default this is **incremental**: it resumes from
+     * the stored checkpoint and only fetches blocks added since — so re-indexing is
+     * fast no matter how far head has moved — yet yields state identical to a full
+     * replay. `{full: true}` forces a replay from the deploy block (the durability
+     * proof, and what runs automatically when there's no prior state). Idempotent.
+     */
+    reindex(address: Address, opts?: {
+        full?: boolean;
+    }): Promise<IndexResult>;
+    /** Re-index every registered project. */
+    reindexAll(opts?: {
+        full?: boolean;
+    }): Promise<IndexResult[]>;
+    getProject(address: Address): ProjectState | null;
+    listProjects(): ProjectState[];
+}
+//# sourceMappingURL=indexer.d.ts.map

package/dist/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAc,KAAK,KAAK,EAAE,KAAK,mBAAmB,EAAC,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,OAAO,CAAC,OAAO,CAAmC;gBAEtC,KAAK,CAAC,EAAE,KAAK;IAIzB,OAAO,CAAC,MAAM;IAMd;6FACyF;IACzF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAI5C,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,GAAG,mBAAmB;IAM7E;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2BlF,yCAAyC;IACnC,UAAU,CAAC,IAAI,GAAE;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQrE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI;IAIjD,YAAY,IAAI,YAAY,EAAE;CAG/B"}

package/dist/indexer.js

@@ -0,0 +1,82 @@
+import { makePublicClient, reconstructIncremental, reconstructProject, } from '@artblocks/abx-sdk';
+import { SqliteStore } from './store.js';
+/**
+ * The reference indexer (Layer 3). It does one thing well: replay the event
+ * spine from chain into the store. Because every state change rides a standard,
+ * versioned event, re-indexing is a *compute* cost, not an engineering one — and
+ * it needs no cooperation from whatever provider held the data before. This is
+ * the implementation everyone re-indexes with when they onboard or leave a
+ * service; running a different one changes nothing the protocol guarantees.
+ */
+export class SelfHostIndexer {
+    store;
+    clients = new Map();
+    constructor(store) {
+        this.store = store ?? new SqliteStore();
+    }
+    client(chainKey) {
+        let c = this.clients.get(chainKey);
+        if (!c)
+            this.clients.set(chainKey, (c = makePublicClient({ chainKey })));
+        return c;
+    }
+    /** The RPC client for a chain — exposed for reads that aren't a reindex (e.g. deploy-block
+     *  discovery in the admin control plane). Reuses the same pooled client as `reindex`. */
+    publicClient(chainKey) {
+        return this.client(chainKey);
+    }
+    /** Register a project to index (the minimum needed to replay it). */
+    register(reg) {
+        const full = { ...reg, registeredAt: new Date().toISOString() };
+        this.store.register(full);
+        return full;
+    }
+    /**
+     * Re-index a single project. By default this is **incremental**: it resumes from
+     * the stored checkpoint and only fetches blocks added since — so re-indexing is
+     * fast no matter how far head has moved — yet yields state identical to a full
+     * replay. `{full: true}` forces a replay from the deploy block (the durability
+     * proof, and what runs automatically when there's no prior state). Idempotent.
+     */
+    async reindex(address, opts = {}) {
+        const reg = this.store.getRegistration(address);
+        // User-facing: this surfaces through `abx index`/`abx verify`. Name the real command a creator
+        // runs (`abx add`), never the internal `register()` (there is no `abx register` — a dead end).
+        if (!reg)
+            throw new Error(`${address} isn't registered on this node yet — add it first:  abx add ${address}`);
+        const started = Date.now();
+        const factory = reg.factory ? reg.factory : undefined;
+        const prior = opts.full ? null : this.store.getProject(address);
+        let state;
+        let mode;
+        if (prior && prior.deployBlock && prior.events.length > 0) {
+            state = await reconstructIncremental(this.client(reg.chainKey), prior, { factory });
+            mode = 'incremental';
+        }
+        else {
+            state = await reconstructProject(this.client(reg.chainKey), {
+                address,
+                fromBlock: BigInt(reg.fromBlock),
+                factory,
+            });
+            mode = 'full';
+        }
+        this.store.putProject(state);
+        return { state, elapsedMs: Date.now() - started, mode };
+    }
+    /** Re-index every registered project. */
+    async reindexAll(opts = {}) {
+        const out = [];
+        for (const reg of this.store.listRegistrations()) {
+            out.push(await this.reindex(reg.address, opts));
+        }
+        return out;
+    }
+    getProject(address) {
+        return this.store.getProject(address);
+    }
+    listProjects() {
+        return this.store.listProjects();
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,GAInB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,WAAW,EAAuC,MAAM,YAAY,CAAC;AAQ7E;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IACjB,KAAK,CAAQ;IACd,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAElD,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,WAAW,EAAE,CAAC;IAC1C,CAAC;IAEO,MAAM,CAAC,QAAgB;QAC7B,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,gBAAgB,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC;IAED;6FACyF;IACzF,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,qEAAqE;IACrE,QAAQ,CAAC,GAA8C;QACrD,MAAM,IAAI,GAAwB,EAAC,GAAG,GAAG,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAC,CAAC;QACnF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,OAAyB,EAAE;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,+FAA+F;QAC/F,+FAA+F;QAC/F,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,+DAA+D,OAAO,EAAE,CAAC,CAAC;QAE9G,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,OAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEhE,IAAI,KAAmB,CAAC;QACxB,IAAI,IAA4B,CAAC;QACjC,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,KAAK,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAC,OAAO,EAAC,CAAC,CAAC;YAClF,IAAI,GAAG,aAAa,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;gBAC1D,OAAO;gBACP,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;gBAChC,OAAO;aACR,CAAC,CAAC;YACH,IAAI,GAAG,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,EAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,IAAI,EAAC,CAAC;IACxD,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,UAAU,CAAC,OAAyB,EAAE;QAC1C,MAAM,GAAG,GAAkB,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAkB,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/store.d.ts

@@ -0,0 +1,146 @@
+import type { ProjectState } from '@artblocks/abx-sdk';
+/** How a project was registered for indexing — the minimum to replay it. */
+export interface ProjectRegistration {
+    address: string;
+    chainKey: string;
+    fromBlock: string;
+    factory: string | null;
+    label?: string;
+    /** Operator display metadata served in the token's ERC-721 JSON (the creator's words). */
+    description?: string;
+    externalUrl?: string;
+    /** Operator's off-chain OpenSea attributes (JSON array), stitched UNDER any on-chain `attributes`.
+     *  Collection-scope: a 1/1's traits, or a Series' shared/fallback traits. */
+    attributes?: string;
+    /** Operator's off-chain PER-TOKEN attributes (JSON `{ "<tokenId>": OpenSeaAttribute[] }`) — a Series'
+     *  editable, resolver-served traits (the per-token twin of `attributes`; a token's entry wins over
+     *  the collection-scope `attributes`, and any on-chain `attributes` still wins over both). */
+    tokenAttributes?: string;
+    /** Durable content locators keyed by on-chain hash (JSON `{ "0x<keccak>": "ipfs://<cid>" }`) —
+     *  bridged from the deployer so this store can point `image` at IPFS/Arweave without the bytes. */
+    contentLocators?: string;
+    registeredAt: string;
+}
+/** One producer-published effect artifact — a row in the data plane's enumeration registry
+ *  (`specs/protocol/data-plane.md`). The resolver lists a token's rows and keeps only those whose
+ *  `key` matches the recomputed address at the CURRENT settled inputsHash, so stale rows go
+ *  silently unlisted (self-invalidation). `locator === null` means the bytes live in custody
+ *  (the shared backend at `key`, or resolver-held published bytes). Producer-published, NOT
+ *  chain-derived: rows survive a projection wipe and self-heal from a runner's next sweep. */
+export interface EffectArtifactRow {
+    /** renderArtifactKey (keccak hex; encodes effectKey + settled inputsHash). */
+    key: string;
+    address: string;
+    tokenId: string;
+    effectKey: string;
+    outputKey: string;
+    inputsHash: string;
+    /** The effect's DECLARED output mimeType — what the manifest and byte route serve. */
+    contentType: string | null;
+    locator: string | null;
+    updatedAt?: string;
+}
+/** Transient per-(artifact key) effect observability — `rendering`/`failed` between triggers.
+ *  Rebuildable state ONLY: "up to date" is always artifact-presence at the current settled
+ *  inputsHash, never a row here; a lost table costs history, not correctness. */
+export interface EffectStatusRow {
+    /** The artifact key (renderArtifactKey at the settled inputsHash) this run is producing. */
+    key: string;
+    address: string;
+    tokenId: string;
+    effectKey: string;
+    status: 'rendering' | 'failed';
+    error?: string | null;
+    attempts?: number;
+    updatedAt?: string;
+}
+/**
+ * The projection store contract. Two responsibilities, kept distinct:
+ *
+ *  - **registrations** — the minimum needed to replay a project (operator input).
+ *  - **projects** — the reconstructed state, the *disposable, replay-rebuildable
+ *    projection*. `wipeProjections()` clears only this; registrations survive.
+ *
+ * The reference implementation is {@link SqliteStore}. A platform-scale deploy
+ * swaps in a Postgres-backed implementation behind this same interface — nothing
+ * upstream (indexer, token API) changes.
+ */
+export interface Store {
+    /** Where the projection lives on disk (for display / ops). */
+    readonly path: string;
+    register(reg: ProjectRegistration): void;
+    listRegistrations(): ProjectRegistration[];
+    getRegistration(address: string): ProjectRegistration | null;
+    /** Forget a project entirely — drop its registration and its projection (on-chain data is untouched). */
+    deregister(address: string): void;
+    /** Register one effect artifact (the data plane's enumeration registry). Effect-agnostic —
+     *  producers declare the (effectKey, outputKey, mimeType); the store never interprets them.
+     *  Idempotent — last write wins per key. */
+    putEffectArtifact(row: EffectArtifactRow): void;
+    /** The registered artifact row for an effect artifact key, or null. */
+    getEffectArtifact(key: string): EffectArtifactRow | null;
+    /** Every registered artifact row for (project, token) — the manifest's effect-source listing.
+     *  Callers filter by recomputing the current-inputsHash key per row (stale rows unlisted). */
+    listEffectArtifacts(address: string, tokenId: string): EffectArtifactRow[];
+    /** Node-level key/value metadata (e.g. the chain watcher's persisted watermark). */
+    putMeta(key: string, value: string): void;
+    getMeta(key: string): string | null;
+    /** Upsert transient effect observability (`rendering` / `failed`) for an artifact key. */
+    putEffectStatus(row: EffectStatusRow): void;
+    /** Clear one artifact key's status — the run finished; artifact presence takes over as truth. */
+    clearEffectStatus(key: string): void;
+    listEffectStatuses(address: string): EffectStatusRow[];
+    putProject(state: ProjectState): void;
+    getProject(address: string): ProjectState | null;
+    listProjects(): ProjectState[];
+    /** Drop the rebuildable projection (keeps registrations). Proves replay. */
+    wipeProjections(): void;
+    /** Close and remove the underlying store entirely. */
+    destroy(): void;
+}
+/**
+ * The reference store: a single SQLite file (`.abx-self-host/index.db`).
+ *
+ * It keeps the elegant property of the file-based projection — *one disposable
+ * artifact you can delete and replay* — while adding real indexes, queries, and
+ * transactional writes. No server, no second container, no connection string:
+ * SQLite is embedded, the indexer is the only writer, and the token API is
+ * read-heavy, so WAL mode fits the access pattern exactly.
+ *
+ * The reconstructed state is normalized across `projects` / `tokens` /
+ * `commitments` / `extensions` / `events`. Wiping those tables (keeping
+ * `registrations`) and replaying yields identical state — that's the whole point.
+ */
+export declare class SqliteStore implements Store {
+    readonly path: string;
+    private db;
+    constructor(dataDir?: string);
+    /** Shape changes that must land BEFORE the schema exec (its indexes reference new columns).
+     *  effect_artifacts pre-data-plane shape (key/address/locator only) → drop; the schema recreates
+     *  it. Dropping is safe pre-release: rows are producer-published and self-heal from a runner's
+     *  next sweep (record-on-skip / republish) — no chain data is lost. */
+    private premigrate;
+    /** Idempotently add columns introduced after a DB was first created (CREATE IF NOT
+     *  EXISTS won't backfill them). Keeps an existing projection working across upgrades. */
+    private migrate;
+    register(reg: ProjectRegistration): void;
+    listRegistrations(): ProjectRegistration[];
+    getRegistration(address: string): ProjectRegistration | null;
+    deregister(address: string): void;
+    putEffectArtifact(row: EffectArtifactRow): void;
+    getEffectArtifact(key: string): EffectArtifactRow | null;
+    listEffectArtifacts(address: string, tokenId: string): EffectArtifactRow[];
+    putMeta(key: string, value: string): void;
+    getMeta(key: string): string | null;
+    putEffectStatus(row: EffectStatusRow): void;
+    clearEffectStatus(key: string): void;
+    listEffectStatuses(address: string): EffectStatusRow[];
+    putProject(state: ProjectState): void;
+    getProject(address: string): ProjectState | null;
+    listProjects(): ProjectState[];
+    wipeProjections(): void;
+    destroy(): void;
+    private deleteProjection;
+    private hydrate;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.js

@@ -0,0 +1,484 @@
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync, mkdirSync, rmSync } from 'node:fs';
+import { resolve } from 'node:path';
+// The data plane's effect-artifact registry (`specs/protocol/data-plane.md`): one row per declared
+// output a runner produced, keyed by renderArtifactKey at the CURRENT settled inputsHash (a param
+// change re-addresses → old rows go silently unlisted). Effect-agnostic — producers declare the
+// (effect_key, output_key, content_type); the store never interprets them. locator NULL = the bytes
+// live in custody (shared backend, or published bytes at `key`). Producer-published, NOT chain-
+// derived, so like registrations rows survive a projection wipe/replay — and a lost table self-heals
+// from a runner's next sweep (record-on-skip / republish).
+const EFFECT_ARTIFACTS_DDL = `
+CREATE TABLE IF NOT EXISTS effect_artifacts (
+  key           TEXT PRIMARY KEY,   -- renderArtifactKey (keccak hex; encodes effectKey + settled inputsHash)
+  address       TEXT NOT NULL,      -- lowercased project address
+  token_id      TEXT NOT NULL,
+  effect_key    TEXT NOT NULL,      -- 'render' | any registered effect
+  output_key    TEXT NOT NULL,      -- 'image' | 'traits' | any declared output
+  inputs_hash   TEXT NOT NULL,      -- the settled inputsHash this row was produced at
+  locator       TEXT,               -- ipfs://<cid> | ar://<txid> | https://… | NULL (bytes in custody)
+  content_type  TEXT,               -- the effect's DECLARED output mimeType
+  updated_at    TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_effect_artifacts_token ON effect_artifacts(address, token_id);
+`;
+const SCHEMA = `
+PRAGMA journal_mode = WAL;
+PRAGMA foreign_keys = ON;
+-- Cross-process co-located writes (a local effect runner records artifact rows into this same
+-- file while the resolver serves): wait out a writer instead of failing fast. WAL keeps readers
+-- unblocked; artifact writes are rare (one per rendered output) and touch a table the indexer
+-- never writes.
+PRAGMA busy_timeout = 5000;
+
+CREATE TABLE IF NOT EXISTS registrations (
+  address       TEXT PRIMARY KEY,   -- lowercased
+  chain_key     TEXT NOT NULL,
+  from_block    TEXT NOT NULL,
+  factory       TEXT,
+  label         TEXT,
+  description   TEXT,
+  external_url  TEXT,
+  attributes    TEXT,               -- JSON OpenSeaAttribute[] (off-chain operator traits, collection-scope)
+  token_attributes TEXT,            -- JSON { "<tokenId>": OpenSeaAttribute[] } (off-chain per-token traits)
+  content_locators TEXT,            -- JSON { "0x<keccak>": "ipfs://<cid>" }
+  registered_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS projects (
+  address           TEXT PRIMARY KEY,  -- lowercased
+  address_original  TEXT NOT NULL,     -- checksummed, as reconstructed
+  chain_id          INTEGER NOT NULL,
+  abx_version       INTEGER,
+  deploy_block      TEXT,
+  deploy_tx         TEXT,
+  factory           TEXT,
+  implementation    TEXT,
+  is_canonical      INTEGER,           -- 0 | 1 | NULL
+  name              TEXT,
+  symbol            TEXT,
+  owner             TEXT,
+  contract_uri      TEXT,
+  token_uri_renderer    TEXT,          -- non-null => tokenURI resolves on-chain
+  token_uri_locked      INTEGER,       -- 0 | 1 | NULL
+  contract_uri_renderer TEXT,
+  contract_uri_locked   INTEGER,
+  royalty_receiver  TEXT,              -- NULL => no royalty
+  royalty_bps       INTEGER,
+  collection_fields TEXT,              -- JSON MetadataField[] (collection scope)
+  locked_collection_fields TEXT,       -- JSON string[]
+  contract_type     TEXT,              -- '1of1' | 'series' (from enabled extensions)
+  max_invocations   TEXT,              -- Series supply cap (decimal string) or NULL
+  minter            TEXT,              -- the single authorized minter or NULL
+  paused            INTEGER,           -- Paused extension: 1 | 0 | NULL (NULL/0 ⇒ unpaused)
+  primary_payee     TEXT,              -- Primary Payee destination or NULL
+  from_block        TEXT NOT NULL,
+  to_block          TEXT NOT NULL,
+  event_count       INTEGER NOT NULL,
+  reconstructed_at  TEXT NOT NULL,
+  rpc_url           TEXT
+);
+
+CREATE TABLE IF NOT EXISTS tokens (
+  project_address    TEXT NOT NULL,
+  token_id           TEXT NOT NULL,
+  minted             INTEGER NOT NULL DEFAULT 0,
+  owner              TEXT,
+  token_uri          TEXT,
+  fields             TEXT,             -- JSON MetadataField[] (on-chain token fields)
+  locked_fields      TEXT,             -- JSON string[] (locked field names)
+  PRIMARY KEY (project_address, token_id)
+);
+
+CREATE TABLE IF NOT EXISTS extensions (
+  project_address TEXT NOT NULL,
+  id              TEXT NOT NULL,
+  name            TEXT NOT NULL,
+  version         INTEGER NOT NULL,
+  PRIMARY KEY (project_address, id)
+);
+
+CREATE TABLE IF NOT EXISTS events (
+  project_address TEXT NOT NULL,
+  seq             INTEGER NOT NULL,  -- chain order (block, logIndex)
+  name            TEXT NOT NULL,
+  register        INTEGER NOT NULL,
+  what            TEXT NOT NULL,
+  block_number    TEXT NOT NULL,
+  log_index       INTEGER NOT NULL,
+  tx_hash         TEXT NOT NULL,
+  args            TEXT NOT NULL,     -- JSON
+  PRIMARY KEY (project_address, seq)
+);
+
+CREATE INDEX IF NOT EXISTS idx_tokens_project ON tokens(project_address);
+CREATE INDEX IF NOT EXISTS idx_extensions_project ON extensions(project_address);
+CREATE INDEX IF NOT EXISTS idx_events_project ON events(project_address);
+
+${EFFECT_ARTIFACTS_DDL}
+
+-- Node-level key/value metadata: the chain watcher's persisted watermark, etc. NOT chain-derived
+-- (survives a projection wipe; losing it merely re-notifies once, which idempotency absorbs).
+CREATE TABLE IF NOT EXISTS meta (
+  key    TEXT PRIMARY KEY,
+  value  TEXT NOT NULL
+);
+
+-- Transient effect observability: 'rendering' / 'failed' between triggers, reported by a runner.
+-- REBUILDABLE ONLY — "up to date" is artifact-presence at the current settled inputsHash, never a
+-- row here. A wiped table loses history (attempt counts, error text), not correctness.
+CREATE TABLE IF NOT EXISTS effect_status (
+  key         TEXT PRIMARY KEY,     -- the artifact key this run produces
+  address     TEXT NOT NULL,        -- lowercased project address
+  token_id    TEXT NOT NULL,
+  effect_key  TEXT NOT NULL,        -- 'render' | any registered effect
+  status      TEXT NOT NULL,        -- 'rendering' | 'failed'
+  error       TEXT,
+  attempts    INTEGER,
+  updated_at  TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_effect_status_address ON effect_status(address);
+`;
+const b = (v) => v === null || v === undefined ? null : v ? 1 : 0;
+const lc = (address) => address.toLowerCase();
+/**
+ * The reference store: a single SQLite file (`.abx-self-host/index.db`).
+ *
+ * It keeps the elegant property of the file-based projection — *one disposable
+ * artifact you can delete and replay* — while adding real indexes, queries, and
+ * transactional writes. No server, no second container, no connection string:
+ * SQLite is embedded, the indexer is the only writer, and the token API is
+ * read-heavy, so WAL mode fits the access pattern exactly.
+ *
+ * The reconstructed state is normalized across `projects` / `tokens` /
+ * `commitments` / `extensions` / `events`. Wiping those tables (keeping
+ * `registrations`) and replaying yields identical state — that's the whole point.
+ */
+export class SqliteStore {
+    path;
+    db;
+    constructor(dataDir) {
+        const dir = dataDir ?? process.env.ABX_DATA_DIR ?? resolve(process.cwd(), '.abx-self-host');
+        mkdirSync(dir, { recursive: true });
+        this.path = resolve(dir, 'index.db');
+        this.db = new DatabaseSync(this.path);
+        this.premigrate();
+        this.db.exec(SCHEMA);
+        this.migrate();
+    }
+    /** Shape changes that must land BEFORE the schema exec (its indexes reference new columns).
+     *  effect_artifacts pre-data-plane shape (key/address/locator only) → drop; the schema recreates
+     *  it. Dropping is safe pre-release: rows are producer-published and self-heal from a runner's
+     *  next sweep (record-on-skip / republish) — no chain data is lost. */
+    premigrate() {
+        const cols = this.db.prepare(`PRAGMA table_info(effect_artifacts)`).all();
+        if (cols.length > 0 && !cols.some((c) => c.name === 'token_id')) {
+            this.db.exec(`DROP TABLE effect_artifacts`);
+        }
+    }
+    /** Idempotently add columns introduced after a DB was first created (CREATE IF NOT
+     *  EXISTS won't backfill them). Keeps an existing projection working across upgrades. */
+    migrate() {
+        const add = (table, col) => {
+            try {
+                this.db.exec(`ALTER TABLE ${table} ADD COLUMN ${col}`);
+            }
+            catch {
+                /* column already exists */
+            }
+        };
+        add('registrations', 'description TEXT');
+        add('registrations', 'external_url TEXT');
+        add('registrations', 'attributes TEXT');
+        add('registrations', 'token_attributes TEXT');
+        add('registrations', 'content_locators TEXT');
+        add('tokens', 'minted INTEGER NOT NULL DEFAULT 0');
+        add('tokens', 'fields TEXT');
+        add('tokens', 'locked_fields TEXT');
+        add('projects', 'collection_fields TEXT');
+        add('projects', 'locked_collection_fields TEXT');
+        add('projects', 'token_uri_renderer TEXT');
+        add('projects', 'token_uri_locked INTEGER');
+        add('projects', 'contract_uri_renderer TEXT');
+        add('projects', 'contract_uri_locked INTEGER');
+        add('projects', 'contract_type TEXT');
+        add('projects', 'max_invocations TEXT');
+        add('projects', 'minter TEXT');
+        add('projects', 'paused INTEGER');
+        add('projects', 'primary_payee TEXT');
+        // code-project state (params, schemas, hooks, seed source, script, dependencies) —
+        // one JSON column; the shape is the ProjectState fields, spread back on hydrate.
+        add('projects', 'code_state TEXT');
+        add('tokens', 'params TEXT');
+    }
+    // ── registrations ──────────────────────────────────────────────────────────
+    register(reg) {
+        this.db
+            .prepare(`INSERT INTO registrations (address, chain_key, from_block, factory, label, description, external_url, attributes, token_attributes, content_locators, registered_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(address) DO UPDATE SET
+           chain_key=excluded.chain_key, from_block=excluded.from_block,
+           factory=excluded.factory, label=excluded.label,
+           description=excluded.description, external_url=excluded.external_url,
+           attributes=excluded.attributes, token_attributes=excluded.token_attributes,
+           content_locators=excluded.content_locators,
+           registered_at=excluded.registered_at`)
+            .run(lc(reg.address), reg.chainKey, reg.fromBlock, reg.factory, reg.label ?? null, reg.description ?? null, reg.externalUrl ?? null, reg.attributes ?? null, reg.tokenAttributes ?? null, reg.contentLocators ?? null, reg.registeredAt);
+    }
+    listRegistrations() {
+        return this.db
+            .prepare(`SELECT * FROM registrations ORDER BY registered_at`)
+            .all()
+            .map(rowToRegistration);
+    }
+    getRegistration(address) {
+        const row = this.db.prepare(`SELECT * FROM registrations WHERE address = ?`).get(lc(address));
+        return row ? rowToRegistration(row) : null;
+    }
+    deregister(address) {
+        const key = lc(address);
+        this.deleteProjection(key);
+        this.db.prepare(`DELETE FROM effect_artifacts WHERE address = ?`).run(key);
+        this.db.prepare(`DELETE FROM effect_status WHERE address = ?`).run(key);
+        this.db.prepare(`DELETE FROM registrations WHERE address = ?`).run(key);
+    }
+    // ── effect artifacts (the data plane's registry; producer-published) ──────────
+    putEffectArtifact(row) {
+        this.db
+            .prepare(`INSERT INTO effect_artifacts (key, address, token_id, effect_key, output_key, inputs_hash, locator, content_type, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(key) DO UPDATE SET
+           address=excluded.address, token_id=excluded.token_id, effect_key=excluded.effect_key,
+           output_key=excluded.output_key, inputs_hash=excluded.inputs_hash,
+           locator=excluded.locator, content_type=excluded.content_type, updated_at=excluded.updated_at`)
+            .run(row.key.toLowerCase(), lc(row.address), row.tokenId, row.effectKey, row.outputKey, row.inputsHash.toLowerCase(), row.locator, row.contentType, row.updatedAt ?? new Date().toISOString());
+    }
+    getEffectArtifact(key) {
+        const row = this.db
+            .prepare(`SELECT * FROM effect_artifacts WHERE key = ?`)
+            .get(key.toLowerCase());
+        return row ? rowToArtifact(row) : null;
+    }
+    listEffectArtifacts(address, tokenId) {
+        return this.db
+            .prepare(`SELECT * FROM effect_artifacts WHERE address = ? AND token_id = ? ORDER BY effect_key, output_key`)
+            .all(lc(address), tokenId).map(rowToArtifact);
+    }
+    // ── node metadata (watcher watermark, …) ─────────────────────────────────────
+    putMeta(key, value) {
+        this.db
+            .prepare(`INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value=excluded.value`)
+            .run(key, value);
+    }
+    getMeta(key) {
+        const row = this.db.prepare(`SELECT value FROM meta WHERE key = ?`).get(key);
+        return row?.value ?? null;
+    }
+    // ── transient effect status (runner-reported observability; rebuildable) ─────
+    putEffectStatus(row) {
+        this.db
+            .prepare(`INSERT INTO effect_status (key, address, token_id, effect_key, status, error, attempts, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(key) DO UPDATE SET
+           address=excluded.address, token_id=excluded.token_id, effect_key=excluded.effect_key,
+           status=excluded.status, error=excluded.error, attempts=excluded.attempts, updated_at=excluded.updated_at`)
+            .run(row.key.toLowerCase(), lc(row.address), row.tokenId, row.effectKey, row.status, row.error ?? null, row.attempts ?? null, row.updatedAt ?? new Date().toISOString());
+    }
+    clearEffectStatus(key) {
+        this.db.prepare(`DELETE FROM effect_status WHERE key = ?`).run(key.toLowerCase());
+    }
+    listEffectStatuses(address) {
+        const rows = this.db
+            .prepare(`SELECT key, address, token_id, effect_key, status, error, attempts, updated_at FROM effect_status WHERE address = ?`)
+            .all(lc(address));
+        return rows.map((r) => ({
+            key: r.key,
+            address: r.address,
+            tokenId: r.token_id,
+            effectKey: r.effect_key,
+            status: r.status,
+            error: r.error,
+            attempts: r.attempts ?? undefined,
+            updatedAt: r.updated_at,
+        }));
+    }
+    // ── projection ───────────────────────────────────────────────────────────--
+    putProject(state) {
+        const key = lc(state.address);
+        this.db.exec('BEGIN');
+        try {
+            this.deleteProjection(key);
+            this.db
+                .prepare(`INSERT INTO projects (
+             address, address_original, chain_id, abx_version, deploy_block, deploy_tx,
+             factory, implementation, is_canonical, name, symbol, owner, contract_uri,
+             token_uri_renderer, token_uri_locked, contract_uri_renderer, contract_uri_locked,
+             royalty_receiver, royalty_bps, collection_fields, locked_collection_fields,
+             contract_type, max_invocations, minter, paused, primary_payee, code_state,
+             from_block, to_block, event_count, reconstructed_at, rpc_url
+           ) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`)
+                .run(key, state.address, state.chainId, state.abxVersion, state.deployBlock, state.deployTx, state.factory, state.implementation, b(state.isCanonical), state.name, state.symbol, state.owner, state.contractURI, state.tokenURIRenderer, b(state.tokenURILocked), state.contractURIRenderer, b(state.contractURILocked), state.royalty?.receiver ?? null, state.royalty?.bps ?? null, JSON.stringify(state.collectionFields), JSON.stringify(state.lockedCollectionFields), state.contractType ?? null, state.maxInvocations ?? null, state.minter ?? null, b(state.paused), state.primaryPayee ?? null, JSON.stringify({
+                contractParams: state.contractParams ?? null,
+                paramSchemas: state.paramSchemas ?? null,
+                paramHooks: state.paramHooks ?? null,
+                delegateRegistry: state.delegateRegistry ?? null,
+                seedSource: state.seedSource ?? null,
+                script: state.script ?? null,
+                dependencies: state.dependencies ?? null,
+            }), state.fromBlock, state.toBlock, state.eventCount, state.reconstructedAt, state.rpcUrl ?? null);
+            const insToken = this.db.prepare(`INSERT INTO tokens (project_address, token_id, minted, owner, token_uri, fields, locked_fields, params)
+         VALUES (?,?,?,?,?,?,?,?)`);
+            for (const t of state.tokens) {
+                insToken.run(key, t.tokenId, b(t.minted), t.owner, t.tokenURI, JSON.stringify(t.fields), JSON.stringify(t.lockedFields), t.params?.length ? JSON.stringify(t.params) : null);
+            }
+            const insExt = this.db.prepare(`INSERT INTO extensions (project_address, id, name, version) VALUES (?,?,?,?)`);
+            for (const e of state.extensions)
+                insExt.run(key, e.id, e.name, e.version);
+            const insEvent = this.db.prepare(`INSERT INTO events (project_address, seq, name, register, what, block_number, log_index, tx_hash, args)
+         VALUES (?,?,?,?,?,?,?,?,?)`);
+            state.events.forEach((ev, i) => {
+                insEvent.run(key, i, ev.name, ev.register, ev.what, ev.blockNumber, ev.logIndex, ev.txHash, JSON.stringify(ev.args));
+            });
+            this.db.exec('COMMIT');
+        }
+        catch (err) {
+            this.db.exec('ROLLBACK');
+            throw err;
+        }
+    }
+    getProject(address) {
+        const row = this.db.prepare(`SELECT * FROM projects WHERE address = ?`).get(lc(address));
+        return row ? this.hydrate(row) : null;
+    }
+    listProjects() {
+        return this.db
+            .prepare(`SELECT * FROM projects ORDER BY reconstructed_at`)
+            .all()
+            .map((r) => this.hydrate(r));
+    }
+    wipeProjections() {
+        this.db.exec(`DELETE FROM events; DELETE FROM extensions; DELETE FROM tokens; DELETE FROM projects;`);
+    }
+    destroy() {
+        this.db.close();
+        for (const suffix of ['', '-wal', '-shm']) {
+            const f = this.path + suffix;
+            if (existsSync(f))
+                rmSync(f);
+        }
+    }
+    deleteProjection(key) {
+        for (const table of ['events', 'extensions', 'tokens', 'projects']) {
+            this.db.prepare(`DELETE FROM ${table} WHERE ${table === 'projects' ? 'address' : 'project_address'} = ?`).run(key);
+        }
+    }
+    hydrate(p) {
+        const key = p.address;
+        const tokens = this.db.prepare(`SELECT * FROM tokens WHERE project_address = ? ORDER BY CAST(token_id AS INTEGER)`).all(key).map((t) => ({
+            tokenId: t.token_id,
+            minted: !!t.minted,
+            owner: t.owner ?? null,
+            tokenURI: t.token_uri ?? null,
+            fields: JSON.parse(t.fields ?? '[]'),
+            lockedFields: JSON.parse(t.locked_fields ?? '[]'),
+            ...(t.params ? { params: JSON.parse(t.params) } : {}),
+        }));
+        const extensions = this.db.prepare(`SELECT * FROM extensions WHERE project_address = ? ORDER BY name`).all(key).map((e) => ({ id: e.id, name: e.name, version: e.version }));
+        const events = this.db.prepare(`SELECT * FROM events WHERE project_address = ? ORDER BY seq`).all(key).map((e) => ({
+            name: e.name,
+            register: e.register,
+            what: e.what,
+            blockNumber: e.block_number,
+            logIndex: e.log_index,
+            txHash: e.tx_hash,
+            args: JSON.parse(e.args),
+        }));
+        return {
+            address: p.address_original,
+            chainId: p.chain_id,
+            abxVersion: p.abx_version,
+            deployBlock: p.deploy_block,
+            deployTx: p.deploy_tx ?? null,
+            factory: p.factory ?? null,
+            implementation: p.implementation ?? null,
+            isCanonical: p.is_canonical === null ? null : !!p.is_canonical,
+            name: p.name,
+            symbol: p.symbol,
+            owner: p.owner ?? null,
+            contractURI: p.contract_uri,
+            tokenURIRenderer: p.token_uri_renderer ?? null,
+            tokenURILocked: p.token_uri_locked === null ? null : !!p.token_uri_locked,
+            contractURIRenderer: p.contract_uri_renderer ?? null,
+            contractURILocked: p.contract_uri_locked === null ? null : !!p.contract_uri_locked,
+            royalty: p.royalty_receiver ? { receiver: p.royalty_receiver, bps: p.royalty_bps ?? 0 } : null,
+            collectionFields: JSON.parse(p.collection_fields ?? '[]'),
+            lockedCollectionFields: JSON.parse(p.locked_collection_fields ?? '[]'),
+            contractType: p.contract_type ?? undefined,
+            maxInvocations: p.max_invocations ?? null,
+            minter: p.minter ?? null,
+            paused: !!p.paused,
+            primaryPayee: p.primary_payee ?? null,
+            ...hydrateCodeState(p.code_state),
+            extensions,
+            tokens,
+            events,
+            fromBlock: p.from_block,
+            toBlock: p.to_block,
+            eventCount: p.event_count,
+            reconstructedAt: p.reconstructed_at,
+            rpcUrl: p.rpc_url ?? undefined,
+        };
+    }
+}
+/** Spread the code-project JSON column back into its ProjectState fields (see putProject). */
+function hydrateCodeState(json) {
+    if (!json) {
+        return {
+            paramHooks: null,
+            delegateRegistry: null,
+            seedSource: null,
+            script: null,
+            dependencies: null,
+        };
+    }
+    const c = JSON.parse(json);
+    return {
+        contractParams: c.contractParams ?? undefined,
+        paramSchemas: c.paramSchemas ?? undefined,
+        paramHooks: c.paramHooks ?? null,
+        delegateRegistry: c.delegateRegistry ?? null,
+        seedSource: c.seedSource ?? null,
+        script: c.script ?? null,
+        dependencies: c.dependencies ?? null,
+    };
+}
+function rowToArtifact(row) {
+    return {
+        key: row.key,
+        address: row.address,
+        tokenId: row.token_id,
+        effectKey: row.effect_key,
+        outputKey: row.output_key,
+        inputsHash: row.inputs_hash,
+        contentType: row.content_type ?? null,
+        locator: row.locator ?? null,
+        updatedAt: row.updated_at,
+    };
+}
+function rowToRegistration(row) {
+    const r = row;
+    return {
+        address: r.address,
+        chainKey: r.chain_key,
+        fromBlock: r.from_block,
+        factory: r.factory,
+        label: r.label ?? undefined,
+        description: r.description ?? undefined,
+        externalUrl: r.external_url ?? undefined,
+        attributes: r.attributes ?? undefined,
+        tokenAttributes: r.token_attributes ?? undefined,
+        contentLocators: r.content_locators ?? undefined,
+        registeredAt: r.registered_at,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@artblocks/abx-indexer",
+  "version": "0.1.0-alpha.0",
+  "license": "MIT",
+  "description": "ABX Self-Host Toolkit (Layer 3) — the reference indexer. Replays the event spine from chain into a disposable, rebuildable projection. The canonical re-index.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArtBlocks/abx.git",
+    "directory": "packages/indexer"
+  },
+  "homepage": "https://github.com/ArtBlocks/abx#readme",
+  "bugs": "https://github.com/ArtBlocks/abx/issues",
+  "keywords": [
+    "abx",
+    "nft",
+    "indexer",
+    "ethereum",
+    "art-blocks"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "viem": "^2.21.0",
+    "@artblocks/abx-sdk": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json"
+  },
+  "types": "./dist/index.d.ts"
+}