@o1-labs/mina-archive-node-graphql 0.0.6 → 2.0.0

package/build/src/config.js

@@ -0,0 +1,86 @@
+export { parseBoolean, validateConfig, assertValidConfig };
+const TRUE_VALUES = new Set(['true', '1', 'yes', 'on']);
+const FALSE_VALUES = new Set(['false', '0', 'no', 'off']);
+const BOOLEAN_VARS = [
+    'ENABLE_GRAPHIQL',
+    'ENABLE_INTROSPECTION',
+    'ENABLE_LOGGING',
+    'ENABLE_METRICS',
+    'ENABLE_JAEGER',
+    'ENABLE_BLOCK_TRANSACTION_DETAILS',
+    'ENABLE_ZKAPP_COMMANDS_QUERY',
+];
+const POSITIVE_INT_VARS = ['PORT', 'BLOCK_RANGE_SIZE'];
+const KNOWN_QUERIES = [
+    'events',
+    'actions',
+    'verificationKeyUpdates',
+    'zkappCommands',
+    'networkState',
+    'blocks',
+];
+function parseBoolean(value, fallback = false) {
+    if (value === undefined)
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === '')
+        return fallback;
+    if (TRUE_VALUES.has(normalized))
+        return true;
+    if (FALSE_VALUES.has(normalized))
+        return false;
+    return fallback;
+}
+function isRecognisedBoolean(value) {
+    const normalized = value.trim().toLowerCase();
+    return TRUE_VALUES.has(normalized) || FALSE_VALUES.has(normalized);
+}
+function validateConfig(env = process.env) {
+    const errors = [];
+    if (!env.PG_CONN || env.PG_CONN.trim() === '') {
+        errors.push('PG_CONN is required (Postgres connection string).');
+    }
+    for (const name of BOOLEAN_VARS) {
+        const value = env[name];
+        if (value !== undefined &&
+            value.trim() !== '' &&
+            !isRecognisedBoolean(value)) {
+            errors.push(`${name} must be a boolean (true/false), got "${value}".`);
+        }
+    }
+    for (const name of POSITIVE_INT_VARS) {
+        const value = env[name];
+        if (value !== undefined && value.trim() !== '') {
+            const parsed = Number(value);
+            if (!Number.isInteger(parsed) || parsed <= 0) {
+                errors.push(`${name} must be a positive integer, got "${value}".`);
+            }
+        }
+    }
+    const enabledQueries = env.ENABLED_QUERIES;
+    if (enabledQueries !== undefined) {
+        const names = enabledQueries
+            .split(',')
+            .map((query) => query.trim())
+            .filter((query) => query !== '');
+        if (names.length === 0) {
+            errors.push('ENABLED_QUERIES is set but lists no queries; unset it to expose all of ' +
+                `${KNOWN_QUERIES.join(', ')}.`);
+        }
+        const unknown = names.filter((name) => !KNOWN_QUERIES.includes(name) &&
+            name !== 'schemaVersion');
+        if (unknown.length > 0) {
+            errors.push(`ENABLED_QUERIES contains unknown queries: ${unknown.join(', ')}. ` +
+                `Known queries: ${KNOWN_QUERIES.join(', ')}. ` +
+                'schemaVersion is always served and does not need listing.');
+        }
+    }
+    return errors;
+}
+function assertValidConfig(env = process.env) {
+    const errors = validateConfig(env);
+    if (errors.length > 0) {
+        throw new Error(`Invalid configuration:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/build/src/config.js.map

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

package/build/src/db/archive-node-adapter/archive-node-adapter.js

@@ -1,18 +1,29 @@
 import postgres from 'postgres';
 import { getTables, USED_TABLES } from '../../db/sql/events-actions/queries.js';
+import { buildPostgresOptions } from './postgres-options.js';
 import { EventsService } from '../../services/events-service/events-service.js';
 import { ActionsService } from '../../services/actions-service/actions-service.js';
+import { ZkappCommandsService } from '../../services/zkapp-commands-service/zkapp-commands-service.js';
 import { NetworkService } from '../../services/network-service/network-service.js';
 import { BlocksService } from '../../services/blocks-service/blocks-service.js';
+import { VerificationKeyUpdatesService } from '../../services/verification-key-updates-service/verification-key-updates-service.js';
+const PING_CONNECT_TIMEOUT_S = 2;
 export class ArchiveNodeAdapter {
     constructor(connectionString) {
         if (!connectionString)
             throw new Error('Missing Postgres Connection String. Please provide a valid connection string in the environment variables or in your configuration file to connect to the Postgres database.');
-        this.client = postgres(connectionString);
+        this.client = postgres(connectionString, buildPostgresOptions());
+        this.pingClient = postgres(connectionString, {
+            max: 1,
+            idle_timeout: 60,
+            connect_timeout: PING_CONNECT_TIMEOUT_S,
+        });
         this.eventsService = new EventsService(this.client);
         this.actionsService = new ActionsService(this.client);
+        this.zkappCommandsService = new ZkappCommandsService(this.client);
         this.networkService = new NetworkService(this.client);
         this.blocksService = new BlocksService(this.client);
+        this.verificationKeyUpdatesService = new VerificationKeyUpdatesService(this.client);
     }
     async getEvents(input, options) {
         return this.eventsService.getEvents(input, options);
@@ -20,9 +31,15 @@ export class ArchiveNodeAdapter {
     async getActions(input, options) {
         return this.actionsService.getActions(input, options);
     }
+    async getZkappCommands(input, options) {
+        return this.zkappCommandsService.getZkappCommands(input, options);
+    }
     async getNetworkState(options) {
         return this.networkService.getNetworkState(options);
     }
+    async getVerificationKeyUpdates(input, options) {
+        return this.verificationKeyUpdatesService.getVerificationKeyUpdates(input, options);
+    }
     async getBlocks(query, limit, sortBy, options) {
         return this.blocksService.getBlocks(query, limit, sortBy, options);
     }
@@ -40,8 +57,18 @@ export class ArchiveNodeAdapter {
             }
         }
     }
+    async ping() {
+        try {
+            await this.pingClient `SELECT 1`;
+            return true;
+        }
+        catch (error) {
+            console.warn(`[readiness] database ping failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
     async close() {
-        return this.client.end();
+        await Promise.all([this.client.end(), this.pingClient.end()]);
     }
 }
 //# sourceMappingURL=archive-node-adapter.js.map

package/build/src/db/archive-node-adapter/archive-node-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"archive-node-adapter.js","sourceRoot":"","sources":["../../../../src/db/archive-node-adapter/archive-node-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAchC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AAEnF,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAGhF,MAAM,OAAO,kBAAkB;IAa7B,YAAY,gBAAoC;QAC9C,IAAI,CAAC,gBAAgB;YACnB,MAAM,IAAI,KAAK,CACb,8KAA8K,CAC/K,CAAC;QACJ,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAA8B,EAC9B,OAAgB;QAEhB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAA+B,EAC/B,OAAgB;QAEhB,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAgB;QACpC,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAAyC,EACzC,KAAgC,EAChC,MAA2C,EAC3C,OAAgB;QAEhB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,CACb,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAC7B,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,kLAAkL,CAAC,EAAE,CACtL,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,iBAAiB,KAAK,sDAAsD,CAC7E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"archive-node-adapter.js","sourceRoot":"","sources":["../../../../src/db/archive-node-adapter/archive-node-adapter.ts"],"names":[],"mappings":"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"}

package/build/src/db/archive-node-adapter/postgres-options.js

@@ -0,0 +1,35 @@
+export { buildPostgresOptions, resolvePoolConfig, POOL_DEFAULTS };
+const POOL_DEFAULTS = {
+    max: 10,
+    idleTimeout: 30,
+    connectTimeout: 30,
+    statementTimeout: 15_000,
+};
+function intFromEnv(value, fallback) {
+    if (value === undefined || value.trim() === '')
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0)
+        return fallback;
+    return parsed;
+}
+function resolvePoolConfig(env = process.env) {
+    return {
+        max: Math.max(1, intFromEnv(env.PG_MAX_CONNECTIONS, POOL_DEFAULTS.max)),
+        idleTimeout: intFromEnv(env.PG_IDLE_TIMEOUT, POOL_DEFAULTS.idleTimeout),
+        connectTimeout: intFromEnv(env.PG_CONNECT_TIMEOUT, POOL_DEFAULTS.connectTimeout),
+        statementTimeout: intFromEnv(env.PG_STATEMENT_TIMEOUT, POOL_DEFAULTS.statementTimeout),
+    };
+}
+function buildPostgresOptions(env = process.env) {
+    const config = resolvePoolConfig(env);
+    return {
+        max: config.max,
+        idle_timeout: config.idleTimeout,
+        connect_timeout: config.connectTimeout,
+        connection: {
+            statement_timeout: String(config.statementTimeout),
+        },
+    };
+}
+//# sourceMappingURL=postgres-options.js.map

package/build/src/db/archive-node-adapter/postgres-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-options.js","sourceRoot":"","sources":["../../../../src/db/archive-node-adapter/postgres-options.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC;AA4BlE,MAAM,aAAa,GAAuB;IACxC,GAAG,EAAE,EAAE;IACP,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAOF,SAAS,UAAU,CAAC,KAAyB,EAAE,QAAgB;IAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAID,SAAS,iBAAiB,CAAC,MAAiB,OAAO,CAAC,GAAG;IACrD,OAAO;QAEL,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;QACvE,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,WAAW,CAAC;QACvE,cAAc,EAAE,UAAU,CACxB,GAAG,CAAC,kBAAkB,EACtB,aAAa,CAAC,cAAc,CAC7B;QACD,gBAAgB,EAAE,UAAU,CAC1B,GAAG,CAAC,oBAAoB,EACxB,aAAa,CAAC,gBAAgB,CAC/B;KACF,CAAC;AACJ,CAAC;AAOD,SAAS,oBAAoB,CAC3B,MAAiB,OAAO,CAAC,GAAG;IAE5B,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,eAAe,EAAE,MAAM,CAAC,cAAc;QACtC,UAAU,EAAE;YAMV,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAsB;SACxE;KACF,CAAC;AACJ,CAAC"}

package/build/src/db/sql/best-chain.js

@@ -0,0 +1,5 @@
+export const BEST_CHAIN_TIP_HEIGHT_SQL = "(SELECT MAX(height) FROM blocks WHERE chain_status <> 'orphaned')";
+export function bestChainTipHeight(db_client) {
+    return db_client.unsafe(BEST_CHAIN_TIP_HEIGHT_SQL);
+}
+//# sourceMappingURL=best-chain.js.map

package/build/src/db/sql/best-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-chain.js","sourceRoot":"","sources":["../../../../src/db/sql/best-chain.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,yBAAyB,GACpC,mEAAmE,CAAC;AAMtE,MAAM,UAAU,kBAAkB,CAAC,SAAuB;IACxD,OAAO,SAAS,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;AACrD,CAAC"}

package/build/src/db/sql/events-actions/queries.js

@@ -1,5 +1,6 @@
 import { BlockStatusFilter } from '../../../blockchain/types.js';
 import { BLOCK_RANGE_SIZE } from '../../../server/server.js';
+import { bestChainTipHeight } from '../best-chain.js';
 function fullChainCTE(db_client, from, to) {
     let toAsNum = to ? Number(to) : undefined;
     let fromAsNum = from ? Number(from) : undefined;
@@ -18,20 +19,25 @@ function fullChainCTE(db_client, from, to) {
       FROM
         blocks b
       WHERE
-        height = (SELECT max(height) FROM blocks)
+        height = ${bestChainTipHeight(db_client)}
     ) 
     UNION ALL
     SELECT
       b.id, b.state_hash, b.parent_hash, b.parent_id, b.height, b.global_slot_since_genesis, b.global_slot_since_hard_fork, b.timestamp, b.chain_status, b.ledger_hash, b.last_vrf_output
     FROM
       blocks b
+      -- The walk terminates because genesis has parent_id = NULL, so the
+      -- id = parent_id join can never match there. No block is its own parent
+      -- (parent_id is a FK to blocks.id; a self-reference would be a cycle), so
+      -- no explicit id <> parent_id guard is needed. A schema/hard-fork change
+      -- that ever self-references a block would loop here — see the matching
+      -- note in getZkappsWithPendingEventsQuery.
       INNER JOIN pending_chain ON b.id = pending_chain.parent_id
-      AND pending_chain.id <> pending_chain.parent_id
       AND pending_chain.chain_status <> 'canonical'
-  ), 
+  ),
   full_chain AS (
     SELECT
-      DISTINCT id, state_hash, parent_id, parent_hash, height, global_slot_since_genesis, global_slot_since_hard_fork, timestamp, chain_status, ledger_hash, (SELECT max(height) FROM blocks) - height AS distance_from_max_block_height, last_vrf_output
+      DISTINCT id, state_hash, parent_id, parent_hash, height, global_slot_since_genesis, global_slot_since_hard_fork, timestamp, chain_status, ledger_hash, ${bestChainTipHeight(db_client)} - height AS distance_from_max_block_height, last_vrf_output
     FROM
       (
         SELECT
@@ -54,10 +60,7 @@ function fullChainCTE(db_client, from, to) {
           chain_status = 'canonical'
           ${fromAsNum
         ? db_client `AND b.height >= ${fromAsNum} AND b.height < ${toAsNum}`
-        : db_client `AND b.height >= (
-                SELECT MAX(b2.height)
-                FROM blocks b2
-            ) - ${BLOCK_RANGE_SIZE}`}
+        : db_client `AND b.height >= ${bestChainTipHeight(db_client)} - ${BLOCK_RANGE_SIZE}`}
       ) AS full_chain
   )
   `;
@@ -232,7 +235,7 @@ function emittedActionsCTE(db_client) {
   )
   `;
 }
-function emittedActionStateCTE(db_client, fromActionState, endActionState) {
+function emittedActionStateCTE(db_client, fromActionStateHeight, endActionStateHeight) {
     return db_client `
   emitted_action_state AS (
     SELECT
@@ -282,11 +285,25 @@ function emittedActionStateCTE(db_client, fromActionState, endActionState) {
       INNER JOIN zkapp_field zkf4 ON zkf4.id = zks.element4
     WHERE
       1 = 1
-    ${fromActionState
-        ? db_client `AND zkf0.id >= (SELECT id FROM zkapp_field WHERE field = ${fromActionState})`
+    -- Filter on the position of the checkpoint ON THE CHAIN, resolved by
+    -- resolveActionStateBoundary() before this query runs.
+    --
+    -- This used to compare zkf0.id against the id of the requested action state.
+    -- zkapp_field is the interning table for every field value in the archive,
+    -- and its id records when a value was FIRST WRITTEN, not where it sits on
+    -- the chain. Any archive filled out of chain order — a bulk import, a
+    -- hard-fork migration, a bootstrap — breaks that assumption, and the filter
+    -- then silently dropped real actions or returned actions from before the
+    -- checkpoint. See tests/integration/action-state-ordering.test.ts.
+    --
+    -- Greater-or-equal keeps the checkpoint's own block in the answer. o1js
+    -- removes it in createActionsList by comparing actionStateOne with the
+    -- requested value, so excluding it here would change what clients receive.
+    ${fromActionStateHeight
+        ? db_client `AND emitted_actions.height >= ${fromActionStateHeight}`
         : db_client ``}
-    ${endActionState
-        ? db_client `AND zkf0.id <= (SELECT id FROM zkapp_field WHERE field = ${endActionState})`
+    ${endActionStateHeight
+        ? db_client `AND emitted_actions.height <= ${endActionStateHeight}`
         : db_client ``}
   )`;
 }
@@ -332,15 +349,15 @@ export function getEventsQuery(db_client, address, tokenId, status, to, from) {
   FROM emitted_events
   `;
 }
-export function getActionsQuery(db_client, address, tokenId, status, to, from, fromActionState, endActionState) {
+export function getActionsQuery(db_client, address, tokenId, status, to, from, fromActionStateHeight, endActionStateHeight) {
     return db_client `
-  WITH 
+  WITH
   ${fullChainCTE(db_client, from, to)},
   ${accountIdentifierCTE(db_client, address, tokenId)},
   ${blocksAccessedCTE(db_client, status)},
   ${emittedZkAppCommandsCTE(db_client)},
   ${emittedActionsCTE(db_client)},
-  ${emittedActionStateCTE(db_client, fromActionState, endActionState)}
+  ${emittedActionStateCTE(db_client, fromActionStateHeight, endActionStateHeight)}
   SELECT *
   FROM emitted_action_state
   `;
@@ -362,9 +379,60 @@ JOIN max_heights mh
   AND b.height = mh.max_height;
   `;
 }
-export function checkActionState(db_client, actionState) {
+export function resolveActionStateBoundary(db_client, address, tokenId, actionState, from, to) {
+    const fromAsNum = from ? Number(from) : null;
+    const toAsNum = to ? Number(to) : null;
     return db_client `
-  SELECT field FROM zkapp_field WHERE field = ${actionState}
+  WITH RECURSIVE pending_chain AS (
+    (
+      SELECT id, parent_id, chain_status
+      FROM blocks
+      WHERE height = ${bestChainTipHeight(db_client)}
+    )
+    UNION ALL
+    SELECT b.id, b.parent_id, b.chain_status
+    FROM blocks b
+      -- Same invariant as fullChainCTE: genesis has parent_id = NULL, and no
+      -- block is its own parent, so an explicit id <> parent_id guard never
+      -- excludes a row.
+      INNER JOIN pending_chain ON b.id = pending_chain.parent_id
+      AND pending_chain.chain_status <> 'canonical'
+  ),
+  bounds AS (
+    SELECT ${fromAsNum !== null
+        ? db_client `${fromAsNum}::bigint`
+        : toAsNum !== null
+            ? db_client `${toAsNum - BLOCK_RANGE_SIZE}::bigint`
+            : db_client `${bestChainTipHeight(db_client)} - ${BLOCK_RANGE_SIZE}::bigint`} AS window_start
+  ),
+  target AS (
+    SELECT id FROM zkapp_field WHERE field = ${actionState}
+  ),
+  account_action_states AS (
+    SELECT b.height, zks.element0 AS state_field_id
+    FROM accounts_accessed aa
+      INNER JOIN blocks b ON b.id = aa.block_id
+      INNER JOIN zkapp_accounts zkacc ON zkacc.id = aa.zkapp_id
+      INNER JOIN zkapp_action_states zks ON zks.id = zkacc.action_state_id
+    WHERE aa.account_identifier_id = (
+        SELECT ai.id FROM account_identifiers ai
+        WHERE ai.public_key_id = (SELECT id FROM public_keys WHERE value = ${address})
+          AND ai.token_id = (SELECT id FROM tokens WHERE value = ${tokenId})
+      )
+      AND (b.chain_status = 'canonical' OR b.id IN (SELECT id FROM pending_chain))
+  )
+  SELECT
+    (
+      SELECT min(height) FROM account_action_states
+      WHERE state_field_id = (SELECT id FROM target)
+    ) AS boundary_height,
+    (SELECT window_start FROM bounds) AS window_start,
+    (
+      SELECT state_field_id FROM account_action_states
+      WHERE height < (SELECT window_start FROM bounds)
+      ORDER BY height DESC
+      LIMIT 1
+    ) = (SELECT id FROM target) AS state_entering_window
   `;
 }
 export function getTables(db_client) {
@@ -375,16 +443,27 @@ export function getTables(db_client) {
 export const USED_TABLES = [
     'blocks',
     'account_identifiers',
+    'public_keys',
+    'tokens',
     'accounts_accessed',
     'blocks_zkapp_commands',
+    'public_keys',
+    'tokens',
     'zkapp_commands',
+    'zkapp_fee_payer_body',
     'zkapp_account_update',
     'zkapp_account_update_body',
+    'zkapp_updates',
     'zkapp_events',
     'zkapp_field_array',
     'zkapp_field',
+    'zkapp_account_precondition',
+    'zkapp_network_precondition',
+    'zkapp_global_slot_bounds',
+    'zkapp_states_nullable',
     'zkapp_verification_key_hashes',
     'zkapp_verification_keys',
+    'zkapp_updates',
     'zkapp_accounts',
     'zkapp_action_states',
 ];
@@ -394,17 +473,19 @@ export function getZkappsWithPendingEventsQuery(db_client) {
   -- start at the tip
   SELECT id, parent_id, chain_status
     FROM blocks
-   WHERE height = (SELECT MAX(height) FROM blocks)
+   WHERE height = ${bestChainTipHeight(db_client)}
 
   UNION ALL
 
   -- walk back until we re-join the canonical branch
+  -- The id <> parent_id guard was dropped here for the same reason as in
+  -- fullChainCTE: no block is its own parent, so it never excludes a row, and
+  -- the walk terminates on genesis's NULL parent_id regardless.
   SELECT b.id, b.parent_id, b.chain_status
     FROM blocks b
     JOIN pending_chain pc
       ON b.id = pc.parent_id
-   WHERE pc.id <> pc.parent_id
-     AND pc.chain_status <> 'canonical'
+   WHERE pc.chain_status <> 'canonical'
 )
 SELECT DISTINCT
   pk.value AS public_key

package/build/src/db/sql/events-actions/queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../../../src/db/sql/events-actions/queries.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../../../src/db/sql/events-actions/queries.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,SAAS,YAAY,CAAC,SAAuB,EAAE,IAAa,EAAE,EAAW;IACvE,IAAI,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,IAAI,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC;QAC9C,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAA;;;;;;;;mBAQC,kBAAkB,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;+JAkB+G,kBAAkB,CACzK,SAAS,CACV;;;;;;;;YAWK,SAAS;QACP,CAAC,CAAC,SAAS,CAAA,iBAAiB,SAAS,iBAAiB,OAAQ,EAAE;QAChE,CAAC,CAAC,SAAS,CAAA;;;kBAGP,gBAAgB,EACxB;;;;;;;;YAWE,SAAS;QACP,CAAC,CAAC,SAAS,CAAA,mBAAmB,SAAS,mBAAmB,OAAQ,EAAE;QACpE,CAAC,CAAC,SAAS,CAAA,mBAAmB,kBAAkB,CAC5C,SAAS,CACV,MAAM,gBAAgB,EAC7B;;;GAGP,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,SAAuB,EACvB,OAAe,EACf,OAAe;IAEf,OAAO,SAAS,CAAA;;;;;;;qEAOmD,OAAO;;2DAEjB,OAAO;IAC9D,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAuB,EAAE,MAAyB;IAC3E,OAAO,SAAS,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;MA0BZ,MAAM,KAAK,iBAAiB,CAAC,GAAG;QAC9B,CAAC,CAAC,SAAS,CAAA,EAAE;QACb,CAAC,CAAC,SAAS,CAAA,sBAAsB,MAAM,CAAC,WAAW,EAAE,EACzD;IACA,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,SAAuB;IACtD,OAAO,SAAS,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsCd,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAuB;IAC/C,OAAO,SAAS,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCf,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAuB;IAChD,OAAO,SAAS,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCf,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,SAAuB,EACvB,qBAA8B,EAC9B,oBAA6B;IAE7B,OAAO,SAAS,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgEZ,qBAAqB;QACnB,CAAC,CAAC,SAAS,CAAA,iCAAiC,qBAAqB,EAAE;QACnE,CAAC,CAAC,SAAS,CAAA,EACf;MAEE,oBAAoB;QAClB,CAAC,CAAC,SAAS,CAAA,iCAAiC,oBAAoB,EAAE;QAClE,CAAC,CAAC,SAAS,CAAA,EACf;IACA,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAAuB,EACvB,OAAe,EACf,OAAe,EACf,MAAyB,EACzB,EAAW,EACX,IAAa;IAEb,OAAO,SAAS,CAA0B;;IAExC,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;IACjC,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;IACjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC;IACpC,uBAAuB,CAAC,SAAS,CAAC;IAClC,gBAAgB,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAAuB,EACvB,OAAe,EACf,OAAe,EACf,MAAyB,EACzB,EAAW,EACX,IAAa,EACb,qBAA8B,EAC9B,oBAA6B;IAE7B,OAAO,SAAS,CAA0B;;IAExC,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;IACjC,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;IACjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC;IACpC,uBAAuB,CAAC,SAAS,CAAC;IAClC,iBAAiB,CAAC,SAAS,CAAC;IAC5B,qBAAqB,CACrB,SAAS,EACT,qBAAqB,EACrB,oBAAoB,CACrB;;;GAGA,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAuB;IAC1D,OAAO,SAAS,CAAA;;;;;;;;;;;;;;GAcf,CAAC;AACJ,CAAC;AA6CD,MAAM,UAAU,0BAA0B,CACxC,SAAuB,EACvB,OAAe,EACf,OAAe,EACf,WAAmB,EACnB,IAAa,EACb,EAAW;IAEX,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvC,OAAO,SAAS,CAA0B;;;;;uBAKrB,kBAAkB,CAAC,SAAS,CAAC;;;;;;;;;;;;aAa9C,SAAS,KAAK,IAAI;QAChB,CAAC,CAAC,SAAS,CAAA,GAAG,SAAS,UAAU;QACjC,CAAC,CAAC,OAAO,KAAK,IAAI;YAClB,CAAC,CAAC,SAAS,CAAA,GAAG,OAAO,GAAG,gBAAgB,UAAU;YAClD,CAAC,CAAC,SAAS,CAAA,GAAG,kBAAkB,CAC5B,SAAS,CACV,MAAM,gBAAgB,UAC7B;;;+CAG2C,WAAW;;;;;;;;;;6EAUmB,OAAO;mEACjB,OAAO;;;;;;;;;;;;;;;;GAgBvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAuB;IAC/C,OAAO,SAAS,CAAA;;GAEf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ;IACR,qBAAqB;IACrB,aAAa;IACb,QAAQ;IACR,mBAAmB;IACnB,uBAAuB;IACvB,aAAa;IACb,QAAQ;IACR,gBAAgB;IAChB,sBAAsB;IACtB,sBAAsB;IACtB,2BAA2B;IAC3B,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,aAAa;IACb,4BAA4B;IAC5B,4BAA4B;IAC5B,0BAA0B;IAC1B,uBAAuB;IACvB,+BAA+B;IAC/B,yBAAyB;IACzB,eAAe;IACf,gBAAgB;IAChB,qBAAqB;CACb,CAAC;AAEX,MAAM,UAAU,+BAA+B,CAAC,SAAuB;IACrE,OAAO,SAAS,CAAA;;;;;oBAKE,kBAAkB,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyC9C,CAAC;AACJ,CAAC"}

package/build/src/db/sql/verification-key-updates/queries.js

@@ -0,0 +1,100 @@
+import { BlockStatusFilter } from '../../../blockchain/types.js';
+export function getVerificationKeyUpdatesQuery(client, verificationKeyHash, from, to, status) {
+    const statusClause = status === BlockStatusFilter.all
+        ? client `AND b.chain_status <> 'orphaned'`
+        : client `AND b.chain_status = ${status.toLowerCase()}`;
+    return client `
+      WITH RECURSIVE pending_chain AS (
+        SELECT id, parent_id
+        FROM blocks
+        WHERE chain_status = 'pending'
+          AND height = (
+            SELECT MAX(height) FROM blocks WHERE chain_status = 'pending'
+          )
+
+        UNION ALL
+
+        SELECT parent.id, parent.parent_id
+        FROM blocks parent
+        INNER JOIN pending_chain child ON parent.id = child.parent_id
+        WHERE parent.chain_status <> 'canonical'
+          AND child.id <> child.parent_id
+      ),
+      -- Resolve the requested hash to the set of zkapp_updates rows that SET
+      -- that verification key, before touching any block. The set is small — one
+      -- row per distinct update that ever wrote this key — and MATERIALIZED
+      -- keeps the planner from inlining it back into the join tree, where it
+      -- would hash the whole of zkapp_updates and zkapp_account_update_body once
+      -- per query. Measured on a 681k-block devnet archive over the maximum
+      -- 10 000-block range: 405 ms inlined, 199 ms materialised.
+      target_updates AS MATERIALIZED (
+        SELECT zu.id
+        FROM zkapp_verification_key_hashes vkh
+        INNER JOIN zkapp_verification_keys vk ON vk.hash_id = vkh.id
+        INNER JOIN zkapp_updates zu ON zu.verification_key_id = vk.id
+        WHERE vkh.value = ${verificationKeyHash}
+      ),
+      full_chain AS (
+        SELECT b.*
+        FROM blocks b
+        WHERE b.height >= ${from}
+          AND b.height < ${to}
+          AND (
+            b.chain_status = 'canonical'
+            OR b.id IN (SELECT id FROM pending_chain)
+          )
+      )
+      SELECT
+        zau.id AS account_update_id,
+        pk.value AS address,
+        t.value AS token_id,
+        ${verificationKeyHash}::text AS verification_key_hash,
+        b.state_hash,
+        b.parent_hash,
+        b.height,
+        b.global_slot_since_genesis,
+        b.global_slot_since_hard_fork,
+        b.timestamp,
+        b.chain_status,
+        b.ledger_hash,
+        (SELECT MAX(height) FROM blocks) - b.height
+          AS distance_from_max_block_height,
+        b.last_vrf_output,
+        bzc.status,
+        zc.hash,
+        zc.memo,
+        zaub.authorization_kind,
+        bzc.sequence_no AS sequence_number,
+        zc.zkapp_account_updates_ids
+      FROM full_chain b
+      INNER JOIN blocks_zkapp_commands bzc ON bzc.block_id = b.id
+      INNER JOIN zkapp_commands zc ON zc.id = bzc.zkapp_command_id
+      INNER JOIN LATERAL UNNEST(zc.zkapp_account_updates_ids)
+        WITH ORDINALITY AS update_ref(id, position) ON TRUE
+      INNER JOIN zkapp_account_update zau ON zau.id = update_ref.id
+      -- An account update SETS a verification key through update_id. The other
+      -- column that names a verification key on this table,
+      -- verification_key_hash_id, is the PRECONDITION: the key the update
+      -- requires the account to already have. Filtering on that one would answer
+      -- "who called this contract" instead of "who deployed it".
+      INNER JOIN zkapp_account_update_body zaub ON zaub.id = zau.body_id
+        AND zaub.update_id IN (SELECT id FROM target_updates)
+      INNER JOIN account_identifiers ai ON ai.id = zaub.account_identifier_id
+      INNER JOIN public_keys pk ON pk.id = ai.public_key_id
+      INNER JOIN tokens t ON t.id = ai.token_id
+      WHERE bzc.status = 'applied'
+        ${statusClause}
+      -- state_hash is what makes this order total. Two competing tips sit at the
+      -- same height, and pending_chain seeds from every block at the maximum
+      -- pending height, so both are in the answer. A command carried by both —
+      -- the normal case during a reorg; one command was measured in 8 blocks at
+      -- a single height on devnet — then produces rows that agree on height,
+      -- sequence_no, account-update position and zkapp_account_update.id alike.
+      ORDER BY
+        b.height ASC,
+        b.state_hash ASC,
+        bzc.sequence_no ASC,
+        update_ref.position ASC
+    `;
+}
+//# sourceMappingURL=queries.js.map

package/build/src/db/sql/verification-key-updates/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../../../src/db/sql/verification-key-updates/queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAyBjE,MAAM,UAAU,8BAA8B,CAC5C,MAAoB,EACpB,mBAA2B,EAC3B,IAAY,EACZ,EAAU,EACV,MAAyB;IAEzB,MAAM,YAAY,GAChB,MAAM,KAAK,iBAAiB,CAAC,GAAG;QAC9B,CAAC,CAAC,MAAM,CAAA,kCAAkC;QAC1C,CAAC,CAAC,MAAM,CAAA,wBAAwB,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;IAE3D,OAAO,MAAM,CAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA6BvB,mBAAmB;;;;;4BAKnB,IAAI;2BACL,EAAE;;;;;;;;;;UAUnB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAmCnB,YAAY;;;;;;;;;;;;KAYjB,CAAC;AACN,CAAC"}