fix: reject getReferencedTransactions when scan range exceeds indexed watermark

Adds a check in IIndexedQueryManager.getReferencedTransactions that returns
DATA_AVAILABILITY_FAILURE if firstOverflowBlock.blockNumber - 1 exceeds
lastConfirmedBlockNumber, enforcing the spec requirement that the verifier
must have a complete view of all blocks in the scan range before attesting
nonexistence.

In practice, the verifier-xrp-indexer writes blocks, transactions, and the
state watermark in a single ACID transaction (SaveAllEntities), so the blocks
table cannot have rows beyond last_indexed_block_number at runtime. The check
is kept as explicit spec enforcement so correctness does not depend on that
indexer implementation detail.

Also adds an explicit null guard in XrpIndexerQueryManager._getStateObject.

Author: GrePod

src/entity/xrp-entity-definitions.ts

@@ -114,7 +114,8 @@ export class DBXrpTransaction {
     // Delete me after 1777366800 Thursday, 28 April 2026 at 11:00:00 CEST keep
     // const modifiedTimestamp = this.timestamp - XRP_UTD;
     const LUT_FORK_TIMESTAMP = 1777366800;
-    const modifiedTimestamp = this.timestamp < LUT_FORK_TIMESTAMP
+    const modifiedTimestamp =
+      this.timestamp < LUT_FORK_TIMESTAMP
         ? this.timestamp
         : this.timestamp - XRP_UTD;
 

src/indexed-query-manager/IIndexedQueryManager.ts

@@ -176,6 +176,13 @@ export abstract class IIndexedQueryManager {
       };
     }
 
+    const lastConfirmedBlock = await this.getLastConfirmedBlockNumber();
+    if (firstOverflowBlock.blockNumber - 1 > lastConfirmedBlock) {
+      return {
+        status: 'DATA_AVAILABILITY_FAILURE',
+      };
+    }
+
     const transactionsQueryResult = await this.queryTransactions({
       startBlockNumber: params.minimalBlockNumber,
       endBlockNumber: firstOverflowBlock.blockNumber - 1,

src/indexed-query-manager/XrpIndexerQueryManager.ts

@@ -39,7 +39,11 @@ export class XrpIndexerQueryManager extends IIndexedQueryManager {
 
   private async _getStateObject(): Promise<DBXrpState> {
     const query = this.entityManager.createQueryBuilder(this.tipState, 'state');
-    return query.getOne();
+    const res = await query.getOne();
+    if (res === undefined || res === null) {
+      throw new Error('Cannot find XRP state in DB');
+    }
+    return res;
   }
 
   public async getLastConfirmedBlockNumber(): Promise<number> {