@subsquid/ponder 0.15.17-sqd.1

package/dist/types/runtime/historical.d.ts

@@ -0,0 +1,123 @@
+import type { Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { Chain, CrashRecoveryCheckpoint, Event, EventCallback, IndexingBuild, RawEvent } from '../internal/types.js';
+import type { Rpc } from '../rpc/index.js';
+import { type SyncStore } from '../sync-store/index.js';
+import { type CachedIntervals, type ChildAddresses, type SyncProgress } from "./index.js";
+export declare function getHistoricalEventsOmnichain(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains" | "rpcs" | "finalizedBlocks">;
+    crashRecoveryCheckpoint: CrashRecoveryCheckpoint;
+    perChainSync: Map<Chain, {
+        syncProgress: SyncProgress;
+        childAddresses: ChildAddresses;
+        cachedIntervals: CachedIntervals;
+    }>;
+    database: Database;
+}): AsyncGenerator<{
+    type: "events";
+    result: {
+        chainId: number;
+        events: Event[];
+        checkpoint: string;
+        blockRange: [number, number];
+    }[];
+} | {
+    type: "pending";
+    result: Event[];
+}>;
+export declare function getHistoricalEventsMultichain(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains" | "rpcs" | "finalizedBlocks">;
+    crashRecoveryCheckpoint: CrashRecoveryCheckpoint;
+    perChainSync: Map<Chain, {
+        syncProgress: SyncProgress;
+        childAddresses: ChildAddresses;
+        cachedIntervals: CachedIntervals;
+    }>;
+    database: Database;
+}): AsyncGenerator<{
+    chainId: number;
+    events: Event[];
+    checkpoint: string;
+    blockRange: [number, number];
+}, void, unknown>;
+export declare function getHistoricalEventsIsolated(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains" | "rpcs" | "finalizedBlocks">;
+    crashRecoveryCheckpoint: CrashRecoveryCheckpoint;
+    chain: Chain;
+    syncProgress: SyncProgress;
+    childAddresses: ChildAddresses;
+    cachedIntervals: CachedIntervals;
+    database: Database;
+}): AsyncGenerator<{
+    chainId: number;
+    events: Event[];
+    checkpoint: string;
+    blockRange: [number, number];
+}, void, unknown>;
+export declare function refetchHistoricalEvents(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains">;
+    perChainSync: Map<Chain, {
+        childAddresses: ChildAddresses;
+    }>;
+    events: Event[];
+    syncStore: SyncStore;
+}): Promise<Event[]>;
+export declare function refetchLocalEvents(params: {
+    common: Common;
+    chain: Chain;
+    childAddresses: ChildAddresses;
+    eventCallbacks: EventCallback[];
+    events: Event[];
+    syncStore: SyncStore;
+}): Promise<RawEvent[]>;
+export declare function getLocalEventGenerator(params: {
+    common: Common;
+    chain: Chain;
+    rpc: Rpc;
+    eventCallbacks: EventCallback[];
+    childAddresses: ChildAddresses;
+    syncProgress: SyncProgress;
+    cachedIntervals: CachedIntervals;
+    from: string;
+    to: string;
+    limit: number;
+    database: Database;
+    isCatchup: boolean;
+}): AsyncGenerator<{
+    events: RawEvent[];
+    checkpoint: string;
+    blockRange: [number, number];
+}, void, unknown>;
+export declare function getLocalSyncGenerator(params: {
+    common: Common;
+    chain: Chain;
+    rpc: Rpc;
+    eventCallbacks: EventCallback[];
+    syncProgress: SyncProgress;
+    childAddresses: ChildAddresses;
+    cachedIntervals: CachedIntervals;
+    database: Database;
+    isCatchup: boolean;
+}): AsyncGenerator<number, void, unknown>;
+/**
+ * Merges multiple event generators into a single generator while preserving
+ * the order of events.
+ *
+ * @param generators - Generators to merge.
+ * @returns A single generator that yields events from all generators.
+ */
+export declare function mergeAsyncGeneratorsWithEventOrder(generators: AsyncGenerator<{
+    events: Event[];
+    checkpoint: string;
+    blockRange: [number, number];
+}>[]): AsyncGenerator<{
+    chainId: number;
+    events: Event[];
+    checkpoint: string;
+    blockRange: [number, number];
+}[]>;
+//# sourceMappingURL=historical.d.ts.map

package/dist/types/runtime/historical.d.ts.map

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

package/dist/types/runtime/index.d.ts

@@ -0,0 +1,89 @@
+import type { Common } from '../internal/common.js';
+import type { Chain, Factory, FactoryId, Filter, Fragment, LightBlock } from '../internal/types.js';
+import type { SyncBlock } from '../internal/types.js';
+import type { Rpc } from '../rpc/index.js';
+import type { SyncStore } from '../sync-store/index.js';
+import { type Interval } from '../utils/interval.js';
+import { type Address } from "viem";
+export type SyncProgress = {
+    start: SyncBlock | LightBlock;
+    end: SyncBlock | LightBlock | undefined;
+    current: SyncBlock | LightBlock | undefined;
+    finalized: SyncBlock | LightBlock;
+    isEnd: () => boolean;
+    isFinalized: () => boolean;
+    getCheckpoint: <tag extends "start" | "end" | "current" | "finalized">({ tag, }: {
+        tag: tag;
+    }) => tag extends "end" ? string | undefined : string;
+};
+export type ChildAddresses = Map<FactoryId, Map<Address, number>>;
+export type CachedIntervals = Map<Filter | Factory, {
+    fragment: Fragment;
+    intervals: Interval[];
+}[]>;
+export type IntervalWithFilter = {
+    interval: Interval;
+    filter: Filter;
+};
+export type IntervalWithFactory = {
+    interval: Interval;
+    factory: Factory;
+};
+export declare function getLocalSyncProgress(params: {
+    common: Common;
+    chain: Chain;
+    rpc: Rpc;
+    filters: Filter[];
+    finalizedBlock: LightBlock;
+    cachedIntervals: CachedIntervals;
+}): Promise<SyncProgress>;
+export declare function getChildAddresses(params: {
+    filters: Filter[];
+    syncStore: SyncStore;
+}): Promise<ChildAddresses>;
+export declare function getCachedIntervals(params: {
+    chain: Chain;
+    filters: Filter[];
+    syncStore: SyncStore;
+}): Promise<CachedIntervals>;
+/**
+ * Returns the intervals that need to be synced to complete the `interval`
+ * for all `filters`.
+ *
+ * @param params.filters - The filters to sync.
+ * @param params.interval - The interval to sync.
+ * @param params.cachedIntervals - The cached intervals for the filters.
+ * @returns The intervals that need to be synced.
+ */
+export declare const getRequiredIntervals: (params: {
+    filters: Filter[];
+    interval: Interval;
+    cachedIntervals: CachedIntervals;
+}) => Interval[];
+/**
+ * Returns the intervals that need to be synced to complete the `interval`
+ * for all `filters`.
+ *
+ * Note: This function dynamically builds filters using `recoverFilter`.
+ * Fragments are used to create a minimal filter, to avoid refetching data
+ * even if a filter is only partially synced.
+ *
+ * @param params.filters - The filters to sync.
+ * @param params.interval - The interval to sync.
+ * @param params.cachedIntervals - The cached intervals for the filters.
+ * @returns The intervals that need to be synced.
+ */
+export declare const getRequiredIntervalsWithFilters: (params: {
+    filters: Filter[];
+    interval: Interval;
+    cachedIntervals: CachedIntervals;
+}) => {
+    intervals: IntervalWithFilter[];
+    factoryIntervals: IntervalWithFactory[];
+};
+/** Returns the closest-to-tip block that has been synced for all `filters`. */
+export declare const getCachedBlock: ({ filters, cachedIntervals, }: {
+    filters: Filter[];
+    cachedIntervals: CachedIntervals;
+}) => number | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/runtime/index.d.ts.map

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

package/dist/types/runtime/init.d.ts

@@ -0,0 +1,28 @@
+import type { Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { Chain, EventCallback, IndexingBuild, RawEvent } from '../internal/types.js';
+import type { Rpc } from '../rpc/index.js';
+import { refetchLocalEvents } from "./historical.js";
+import { type CachedIntervals, type ChildAddresses, type SyncProgress, getLocalSyncProgress } from "./index.js";
+export declare function initEventGenerator(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains" | "rpcs" | "finalizedBlocks">;
+    chain: Chain;
+    rpc: Rpc;
+    eventCallbacks: EventCallback[];
+    childAddresses: ChildAddresses;
+    syncProgress: SyncProgress;
+    cachedIntervals: CachedIntervals;
+    from: string;
+    to: string;
+    limit: number;
+    database: Database;
+    isCatchup: boolean;
+}): Promise<AsyncGenerator<{
+    events: RawEvent[];
+    checkpoint: string;
+    blockRange: [number, number];
+}, void, unknown>>;
+export declare function initRefetchEvents(params: Parameters<typeof refetchLocalEvents>[0]): Promise<RawEvent[]>;
+export declare function initSyncProgress(params: Parameters<typeof getLocalSyncProgress>[0]): Promise<SyncProgress>;
+//# sourceMappingURL=init.d.ts.map

package/dist/types/runtime/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/runtime/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,aAAa,EACb,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAA0B,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,IAAI,CACjB,aAAa,EACb,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,iBAAiB,CACzD,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;;;;mBAEA;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,YAAY,CAAC,CAEvB"}

package/dist/types/runtime/isolated.d.ts

@@ -0,0 +1,14 @@
+import { type Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { CrashRecoveryCheckpoint, IndexingBuild, NamespaceBuild, PreBuild, SchemaBuild } from '../internal/types.js';
+export declare function runIsolated({ common, preBuild, namespaceBuild, schemaBuild, indexingBuild, crashRecoveryCheckpoint, database, onReady, }: {
+    common: Common;
+    preBuild: PreBuild;
+    namespaceBuild: NamespaceBuild;
+    schemaBuild: SchemaBuild;
+    indexingBuild: IndexingBuild;
+    crashRecoveryCheckpoint: CrashRecoveryCheckpoint;
+    database: Database;
+    onReady: () => void;
+}): Promise<void>;
+//# sourceMappingURL=isolated.d.ts.map

package/dist/types/runtime/isolated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolated.d.ts","sourceRoot":"","sources":["../../../src/runtime/isolated.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,QAAQ,EAA4B,MAAM,qBAAqB,CAAC;AAU9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAMnD,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EAEb,cAAc,EACd,QAAQ,EACR,WAAW,EAEZ,MAAM,qBAAqB,CAAC;AAwB7B,wBAAsB,WAAW,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,QAAQ,EACR,OAAO,GACR,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,iBAqrBA"}

package/dist/types/runtime/multichain.d.ts

@@ -0,0 +1,13 @@
+import { type Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { CrashRecoveryCheckpoint, IndexingBuild, NamespaceBuild, PreBuild, SchemaBuild } from '../internal/types.js';
+export declare function runMultichain({ common, preBuild, namespaceBuild, schemaBuild, indexingBuild, crashRecoveryCheckpoint, database, }: {
+    common: Common;
+    preBuild: PreBuild;
+    namespaceBuild: NamespaceBuild;
+    schemaBuild: SchemaBuild;
+    indexingBuild: IndexingBuild;
+    crashRecoveryCheckpoint: CrashRecoveryCheckpoint;
+    database: Database;
+}): Promise<void>;
+//# sourceMappingURL=multichain.d.ts.map

package/dist/types/runtime/multichain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multichain.d.ts","sourceRoot":"","sources":["../../../src/runtime/multichain.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,QAAQ,EAGd,MAAM,qBAAqB,CAAC;AAU7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAOnD,OAAO,KAAK,EAEV,uBAAuB,EACvB,aAAa,EAEb,cAAc,EACd,QAAQ,EACR,WAAW,EAEZ,MAAM,qBAAqB,CAAC;AA+B7B,wBAAsB,aAAa,CAAC,EAClC,MAAM,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,QAAQ,EAAE,QAAQ,CAAC;CACpB,iBA4vBA"}

package/dist/types/runtime/omnichain.d.ts

@@ -0,0 +1,23 @@
+import { type Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { Chain, CrashRecoveryCheckpoint, IndexingBuild, NamespaceBuild, PreBuild, SchemaBuild } from '../internal/types.js';
+import { type SyncProgress } from "./index.js";
+export declare function runOmnichain({ common, preBuild, namespaceBuild, schemaBuild, indexingBuild, crashRecoveryCheckpoint, database, }: {
+    common: Common;
+    preBuild: PreBuild;
+    namespaceBuild: NamespaceBuild;
+    schemaBuild: SchemaBuild;
+    indexingBuild: IndexingBuild;
+    crashRecoveryCheckpoint: CrashRecoveryCheckpoint;
+    database: Database;
+}): Promise<void>;
+/**
+ * Compute the checkpoint across all chains.
+ */
+export declare const getOmnichainCheckpoint: <tag extends "finalized" | "start" | "end" | "current">({ perChainSync, tag, }: {
+    perChainSync: Map<Chain, {
+        syncProgress: SyncProgress;
+    }>;
+    tag: tag;
+}) => tag extends "end" ? string | undefined : string;
+//# sourceMappingURL=omnichain.d.ts.map

package/dist/types/runtime/omnichain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omnichain.d.ts","sourceRoot":"","sources":["../../../src/runtime/omnichain.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,QAAQ,EAGd,MAAM,qBAAqB,CAAC;AAU7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAOnD,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EAEvB,aAAa,EAEb,cAAc,EACd,QAAQ,EACR,WAAW,EAEZ,MAAM,qBAAqB,CAAC;AAuB7B,OAAO,EAGL,KAAK,YAAY,EAGlB,MAAM,YAAY,CAAC;AAIpB,wBAAsB,YAAY,CAAC,EACjC,MAAM,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,QAAQ,EAAE,QAAQ,CAAC;CACpB,iBAqwBA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;kBAMnB,IAAI,KAAK,EAAE;QAAE,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC;;qDAqCzD,CAAC"}

package/dist/types/runtime/realtime.d.ts

@@ -0,0 +1,93 @@
+import type { Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { Chain, Event, EventCallback, IndexingBuild } from '../internal/types.js';
+import type { Rpc } from '../rpc/index.js';
+import { type RealtimeSyncEvent } from '../sync-realtime/index.js';
+import type { ChildAddresses, SyncProgress } from "./index.js";
+export type RealtimeEvent = {
+    type: "block";
+    events: Event[];
+    chain: Chain;
+    checkpoint: string;
+    blockCallback?: (isAccepted: boolean) => void;
+} | {
+    type: "reorg";
+    chain: Chain;
+    checkpoint: string;
+} | {
+    type: "finalize";
+    chain: Chain;
+    checkpoint: string;
+};
+export declare function getRealtimeEventsOmnichain(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains" | "rpcs" | "finalizedBlocks">;
+    perChainSync: Map<Chain, {
+        syncProgress: SyncProgress;
+        childAddresses: ChildAddresses;
+        unfinalizedBlocks: Omit<Extract<RealtimeSyncEvent, {
+            type: "block";
+        }>, "type">[];
+    }>;
+    database: Database;
+    pendingEvents: Event[];
+}): AsyncGenerator<RealtimeEvent>;
+export declare function getRealtimeEventsMultichain(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains" | "rpcs" | "finalizedBlocks">;
+    perChainSync: Map<Chain, {
+        syncProgress: SyncProgress;
+        childAddresses: ChildAddresses;
+        unfinalizedBlocks: Omit<Extract<RealtimeSyncEvent, {
+            type: "block";
+        }>, "type">[];
+    }>;
+    database: Database;
+}): AsyncGenerator<RealtimeEvent>;
+export declare function getRealtimeEventsIsolated(params: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "eventCallbacks" | "chains" | "rpcs" | "finalizedBlocks">;
+    chain: Chain;
+    syncProgress: SyncProgress;
+    childAddresses: ChildAddresses;
+    unfinalizedBlocks: Omit<Extract<RealtimeSyncEvent, {
+        type: "block";
+    }>, "type">[];
+    database: Database;
+}): AsyncGenerator<RealtimeEvent>;
+export declare function getRealtimeEventGenerator(params: {
+    common: Common;
+    chain: Chain;
+    rpc: Rpc;
+    eventCallbacks: EventCallback[];
+    syncProgress: SyncProgress;
+    childAddresses: ChildAddresses;
+    database: Database;
+}): AsyncGenerator<{
+    chain: Chain;
+    event: RealtimeSyncEvent;
+}, void, unknown>;
+export declare function handleRealtimeSyncEvent(event: RealtimeSyncEvent, params: {
+    common: Common;
+    chain: Chain;
+    eventCallbacks: EventCallback[];
+    syncProgress: SyncProgress;
+    unfinalizedBlocks: Omit<Extract<RealtimeSyncEvent, {
+        type: "block";
+    }>, "type">[];
+    database: Database;
+}): Promise<void>;
+/**
+ * Merges multiple async generators into a single async generator while preserving
+ * the order of "block" events.
+ *
+ * @dev "reorg" and "finalize" events are not ordered between chains.
+ */
+export declare function mergeAsyncGeneratorsWithRealtimeOrder(generators: AsyncGenerator<{
+    chain: Chain;
+    event: RealtimeSyncEvent;
+}>[]): AsyncGenerator<{
+    chain: Chain;
+    event: RealtimeSyncEvent;
+}>;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/types/runtime/realtime.d.ts.map

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

package/dist/types/server/error.d.ts

@@ -0,0 +1,5 @@
+import type { Common } from '../internal/common.js';
+import type { Context } from "hono";
+export declare const onError: (_error: Error, c: Context, common: Common) => Promise<Response & import("hono").TypedResponse<`${string}: ${string} occurred in 'undefined' while handling a '${string}' request to the route '${string}'` | `${string}: ${string} occurred in '${string}' while handling a '${string}' request to the route '${string}'`, 500, "text">>;
+export declare const onNotFound: (c: Context) => Response | Promise<Response>;
+//# sourceMappingURL=error.d.ts.map

package/dist/types/server/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/server/error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,MAAM,CAAC;AAGjD,eAAO,MAAM,OAAO,WAAkB,KAAK,KAAK,OAAO,UAAU,MAAM,+RAwCtE,CAAC;AAEF,eAAO,MAAM,UAAU,MAAO,OAAO,iCAMpC,CAAC"}

package/dist/types/server/index.d.ts

@@ -0,0 +1,13 @@
+import { type Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { ApiBuild } from '../internal/types.js';
+import { Hono } from "hono";
+export type Server = {
+    hono: Hono;
+};
+export declare function createServer({ common, database, apiBuild, }: {
+    common: Common;
+    database: Database;
+    apiBuild: ApiBuild;
+}): Promise<Server>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,QAAQ,EAGd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,qBAAqB,CAAC;AAI5D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,wBAAsB,YAAY,CAAC,EACjC,MAAM,EACN,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+IlB"}

package/dist/types/sync-historical/index.d.ts

@@ -0,0 +1,36 @@
+import type { Common } from '../internal/common.js';
+import type { Chain, FactoryId, SyncBlock, SyncLog } from '../internal/types.js';
+import type { Rpc } from '../rpc/index.js';
+import type { IntervalWithFactory, IntervalWithFilter } from '../runtime/index.js';
+import type { SyncStore } from '../sync-store/index.js';
+import { type Interval } from '../utils/interval.js';
+import { type Address } from "viem";
+export type HistoricalSync = {
+    /**
+     * Sync block data that can be queried for a range of blocks (logs).
+     */
+    syncBlockRangeData(params: {
+        interval: Interval;
+        requiredIntervals: IntervalWithFilter[];
+        requiredFactoryIntervals: IntervalWithFactory[];
+        syncStore: SyncStore;
+    }): Promise<SyncLog[]>;
+    /**
+     * Sync block data that must be queried for a single block (block, transactions, receipts, traces).
+     */
+    syncBlockData(params: {
+        interval: Interval;
+        requiredIntervals: IntervalWithFilter[];
+        logs: SyncLog[];
+        syncStore: SyncStore;
+    }): Promise<SyncBlock | undefined>;
+};
+type CreateHistoricalSyncParameters = {
+    common: Common;
+    chain: Chain;
+    rpc: Rpc;
+    childAddresses: Map<FactoryId, Map<Address, number>>;
+};
+export declare const createHistoricalSync: (args: CreateHistoricalSyncParameters) => HistoricalSync;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/sync-historical/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync-historical/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAEV,KAAK,EAEL,SAAS,EAET,SAAS,EACT,OAAO,EAOR,MAAM,qBAAqB,CAAC;AAY7B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAa1C,OAAO,KAAK,EAEV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EACL,KAAK,QAAQ,EAId,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,KAAK,OAAO,EASb,MAAM,MAAM,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE;QACzB,QAAQ,EAAE,QAAQ,CAAC;QACnB,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;QACxC,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;QAChD,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACvB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE;QACpB,QAAQ,EAAE,QAAQ,CAAC;QACnB,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;QACxC,IAAI,EAAE,OAAO,EAAE,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;CACpC,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,cAAc,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD,CAAC;AAEF,eAAO,MAAM,oBAAoB,SACzB,8BAA8B,KACnC,cAk8BF,CAAC"}

package/dist/types/sync-historical/portal-realtime-wire.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Wiring glue: Portal-native realtime → Ponder's realtime runtime.
+ *
+ * `portal-realtime.ts` produces `PortalRealtimeEvent`s from the Portal `/stream`. THIS module adapts them
+ * into ponder's own `RealtimeSyncEvent`s and drops into `runtime/realtime.ts` as an alternative to the
+ * `rpc.subscribe`+`createRealtimeSync` path — so the downstream indexing/checkpointing is UNCHANGED.
+ *
+ * Everything here is inert unless a chain has a Portal source AND `PORTAL_REALTIME==="stream"`. When the
+ * flag is unset/"rpc", `isPortalRealtime()` is false and `clampFinalizedToPortalHead()` is a pass-through,
+ * so the RPC realtime path (the "A-path") is byte-for-byte unchanged.
+ *
+ * WHY the finality clamp: ponder computes `syncProgress.finalized` from RPC (`latest−finalityBlockCount`),
+ * which can sit ABOVE the Portal's finalized head. If realtime streamed from below that finalized block it
+ * would silently regress ponder's persisted checkpoints; if historical skipped its RPC finality-gap
+ * fallback it would mark the gap "synced" with no data (a permanent silent hole). Both are avoided by
+ * making the Portal's finalized head the finality boundary in stream mode: `clampFinalizedToPortalHead()`
+ * lowers `syncProgress.finalized` to the Portal head, so (a) historical stops exactly at the Portal head
+ * (no gap, the RPC fallback never triggers) and (b) realtime streams `[portal-head+1 → tip]` — every block
+ * strictly ABOVE `finalized`, and every `finalize` monotonically at/above it.
+ */
+import type { Common } from '../internal/common.js';
+import type { Chain, EventCallback, Factory, FactoryId, Filter, LightBlock, SyncLog } from '../internal/types.js';
+import type { Rpc } from '../rpc/index.js';
+import type { RealtimeSyncEvent } from '../sync-realtime/index.js';
+import { type Address } from "viem";
+import { type Light, type PortalRealtimeEvent } from "./portal-realtime.js";
+/** True when this chain should use the Portal `/stream` for realtime instead of ponder's RPC path. */
+export declare const isPortalRealtime: (chain: {
+    portal?: string | undefined;
+}) => boolean;
+/** Poll the Portal `/finalized-head` (reused by both the historical finality-gap decision and here). */
+export declare function portalFinalizedHead(portalUrl: string, headers: Record<string, string>, fetchImpl?: typeof fetch): Promise<number | undefined>;
+/**
+ * In stream mode, lower `finalizedBlock` to the Portal's finalized head (when the Portal lags ponder's
+ * RPC-derived finalized block). Pass-through for the A-path (no portal / flag off) and when the Portal is
+ * already at/ahead of the RPC finalized block — so it never RAISES the boundary. Called at every site that
+ * sets `syncProgress.finalized`: the initial `getLocalSyncProgress` and the backfill-cutover refetch.
+ */
+export declare function clampFinalizedToPortalHead(params: {
+    chain: Chain;
+    rpc: Rpc;
+    finalizedBlock: LightBlock;
+    common?: Common;
+    fetchImpl?: typeof fetch;
+}): Promise<LightBlock>;
+/** Portal `/stream` log filter — same shape the historical sync uses. */
+export type PortalLogRequest = {
+    address?: string[];
+    topic0?: string[];
+    topic1?: string[];
+    topic2?: string[];
+    topic3?: string[];
+};
+/** The unique factories referenced by any filter (deduped by id). */
+export declare const uniqueFactories: (eventCallbacks: {
+    filter: Filter;
+}[]) => Factory[];
+/**
+ * Build the merged Portal `/stream` log filter for a chain's realtime: every log filter's
+ * address+topics PLUS a discovery request per factory (factory address + ProxyCreated selector), so new
+ * children are streamed and pruned/matched downstream. Mirrors `portal.ts` so the realtime and historical
+ * fetch-specs agree.
+ */
+export declare function buildPortalLogRequests(eventCallbacks: {
+    filter: Filter;
+}[], childAddresses: Map<FactoryId, Map<Address, number>>): PortalLogRequest[];
+/**
+ * Discover factory children in a block's logs — reuses ponder's own factory logic (`isLogFactoryMatched`
+ * + `getChildAddress`). For the euler `ProxyCreated(address indexed proxy,…)` factory the child is the
+ * `proxy` in topic1. Returns the per-factory children found in THIS block (keyed by `Factory`, the shape
+ * `handleRealtimeSyncEvent` finalizes into the sync-store).
+ */
+export declare function discoverChildAddresses(logs: SyncLog[], factories: Factory[]): Map<Factory, Set<Address>>;
+/** Portal `Light` (decimal number/timestamp) → ponder `LightBlock` (hex). */
+export declare const lightToLightBlock: (l: Light) => LightBlock;
+/**
+ * PortalRealtimeEvent → ponder RealtimeSyncEvent. `block` becomes a log-only BlockWithEventData (no
+ * txs/receipts/traces — euler is log-indexed); `reorg`/`finalize` pass through with hex LightBlocks.
+ */
+export declare function toRealtimeSyncEvent(ev: PortalRealtimeEvent, childAddresses: Map<Factory, Set<Address>>): RealtimeSyncEvent;
+/**
+ * Drop-in replacement for `getRealtimeEventGenerator` when `isPortalRealtime(chain)`. Yields the SAME
+ * `{chain, event: RealtimeSyncEvent}` stream, sourced from the Portal `/stream` instead of
+ * `rpc.subscribe`+`createRealtimeSync`. Callers (omni/multi/isolated) are unchanged.
+ */
+export declare function getPortalRealtimeEventGenerator(params: {
+    common: Common;
+    chain: Chain;
+    rpc: Rpc;
+    eventCallbacks: EventCallback[];
+    syncProgress: {
+        finalized: LightBlock;
+        end?: LightBlock | undefined;
+    };
+    childAddresses: Map<FactoryId, Map<Address, number>>;
+    fetchImpl?: typeof fetch;
+    finalizePollMs?: number;
+}): AsyncGenerator<{
+    chain: Chain;
+    event: RealtimeSyncEvent;
+}, void, unknown>;
+//# sourceMappingURL=portal-realtime-wire.d.ts.map

package/dist/types/sync-historical/portal-realtime-wire.d.ts.map

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