@distrohelena/canton-explorer 0.1.0

package/dist/src/packages/package-sync.service.d.ts

@@ -0,0 +1,22 @@
+import type { NodeConfig } from '../config/node-config.schema';
+import { GrpcOperationsService } from '../grpc/grpc-operations.service';
+import { PackageCacheService } from './package-cache.service';
+import { PqsPackageService } from './pqs-package.service';
+export interface PackageSyncResult {
+    missingPackageIds: string[];
+    fetchedPackageCount: number;
+    skippedBecauseNotDue: boolean;
+}
+export declare class PackageSyncService {
+    private readonly cacheService;
+    private readonly pqsPackageService;
+    private readonly grpcOperationsService;
+    private readonly lastSyncStartedAtByNode;
+    private readonly syncIntervalMs;
+    constructor(cacheService: PackageCacheService, pqsPackageService: PqsPackageService, grpcOperationsService: GrpcOperationsService);
+    syncNodePackagesIfDue(node: NodeConfig): Promise<PackageSyncResult>;
+    syncNodePackages(node: NodeConfig): Promise<PackageSyncResult>;
+    syncPackagesById(node: NodeConfig, packageIds: string[]): Promise<PackageSyncResult>;
+    private fetchPackageRefs;
+    private fetchPackages;
+}

package/dist/src/packages/package-sync.service.js

@@ -0,0 +1,129 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageSyncService = void 0;
+const common_1 = require("@nestjs/common");
+const grpc_operations_service_1 = require("../grpc/grpc-operations.service");
+const package_cache_service_1 = require("./package-cache.service");
+const pqs_package_service_1 = require("./pqs-package.service");
+let PackageSyncService = class PackageSyncService {
+    cacheService;
+    pqsPackageService;
+    grpcOperationsService;
+    lastSyncStartedAtByNode = new Map();
+    syncIntervalMs = 15 * 60 * 1000;
+    constructor(cacheService, pqsPackageService, grpcOperationsService) {
+        this.cacheService = cacheService;
+        this.pqsPackageService = pqsPackageService;
+        this.grpcOperationsService = grpcOperationsService;
+    }
+    async syncNodePackagesIfDue(node) {
+        const now = Date.now();
+        const lastSyncStartedAt = this.lastSyncStartedAtByNode.get(node.id);
+        if (typeof lastSyncStartedAt === 'number' &&
+            now - lastSyncStartedAt < this.syncIntervalMs) {
+            return {
+                missingPackageIds: [],
+                fetchedPackageCount: 0,
+                skippedBecauseNotDue: true,
+            };
+        }
+        this.lastSyncStartedAtByNode.set(node.id, now);
+        return this.syncNodePackages(node);
+    }
+    async syncNodePackages(node) {
+        const { source, packageRefs } = await this.fetchPackageRefs(node);
+        const missingPackageIds = this.cacheService.recordPackagePresence(node.id, packageRefs, new Date().toISOString());
+        if (missingPackageIds.length === 0) {
+            return {
+                missingPackageIds: [],
+                fetchedPackageCount: 0,
+                skippedBecauseNotDue: false,
+            };
+        }
+        const missingPackageRefs = packageRefs.filter((packageRef) => missingPackageIds.includes(packageRef.packageId));
+        const packages = await this.fetchPackages(node, source, missingPackageIds, missingPackageRefs);
+        this.cacheService.storePackages(packages);
+        return {
+            missingPackageIds,
+            fetchedPackageCount: packages.length,
+            skippedBecauseNotDue: false,
+        };
+    }
+    async syncPackagesById(node, packageIds) {
+        const normalizedPackageIds = Array.from(new Set(packageIds.map((packageId) => packageId.trim()).filter((packageId) => packageId.length > 0)));
+        if (normalizedPackageIds.length === 0) {
+            return {
+                missingPackageIds: [],
+                fetchedPackageCount: 0,
+                skippedBecauseNotDue: false,
+            };
+        }
+        const { source, packageRefs } = await this.fetchPackageRefs(node);
+        const requestedRefs = packageRefs.filter((packageRef) => normalizedPackageIds.includes(packageRef.packageId));
+        const requestedIds = requestedRefs.map((packageRef) => packageRef.packageId);
+        const missingPackageIds = normalizedPackageIds.filter((packageId) => !requestedIds.includes(packageId));
+        if (requestedRefs.length === 0) {
+            return {
+                missingPackageIds,
+                fetchedPackageCount: 0,
+                skippedBecauseNotDue: false,
+            };
+        }
+        this.cacheService.recordPackagePresence(node.id, requestedRefs, new Date().toISOString());
+        const packages = await this.fetchPackages(node, source, requestedIds, requestedRefs);
+        this.cacheService.storePackages(packages);
+        return {
+            missingPackageIds,
+            fetchedPackageCount: packages.length,
+            skippedBecauseNotDue: false,
+        };
+    }
+    async fetchPackageRefs(node) {
+        if (node.mode !== 'pqs_with_grpc') {
+            return {
+                source: 'pqs',
+                packageRefs: await this.pqsPackageService.fetchPackageRefs(node),
+            };
+        }
+        try {
+            return {
+                source: 'grpc',
+                packageRefs: await this.grpcOperationsService.fetchPackageRefs(node),
+            };
+        }
+        catch {
+            return {
+                source: 'pqs',
+                packageRefs: await this.pqsPackageService.fetchPackageRefs(node),
+            };
+        }
+    }
+    async fetchPackages(node, source, missingPackageIds, missingPackageRefs) {
+        if (node.mode !== 'pqs_with_grpc' || source === 'pqs') {
+            return this.pqsPackageService.fetchPackagesById(node, missingPackageIds);
+        }
+        try {
+            return await this.pqsPackageService.fetchPackagesById(node, missingPackageIds);
+        }
+        catch {
+            return this.grpcOperationsService.fetchPackagesByRefs(node, missingPackageRefs);
+        }
+    }
+};
+exports.PackageSyncService = PackageSyncService;
+exports.PackageSyncService = PackageSyncService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [package_cache_service_1.PackageCacheService,
+        pqs_package_service_1.PqsPackageService,
+        grpc_operations_service_1.GrpcOperationsService])
+], PackageSyncService);
+//# sourceMappingURL=package-sync.service.js.map

package/dist/src/packages/package-sync.service.js.map

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

package/dist/src/packages/pqs-package.service.d.ts

@@ -0,0 +1,9 @@
+import type { NodeConfig } from '../config/node-config.schema';
+import { PqsClientFactory } from '../pqs/pqs-client.factory';
+import type { CachedPackageBlob, CachedPackageRef } from './package-cache.service';
+export declare class PqsPackageService {
+    private readonly clientFactory;
+    constructor(clientFactory: PqsClientFactory);
+    fetchPackageRefs(node: NodeConfig): Promise<CachedPackageRef[]>;
+    fetchPackagesById(node: NodeConfig, packageIds: string[]): Promise<CachedPackageBlob[]>;
+}

package/dist/src/packages/pqs-package.service.js

@@ -0,0 +1,118 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PqsPackageService = void 0;
+const common_1 = require("@nestjs/common");
+const pqs_client_factory_1 = require("../pqs/pqs-client.factory");
+const PACKAGE_REFS_QUERY = `
+  select
+    package_row.package_id::text as package_id,
+    min(package_row.main_package_id)::text as main_package_id,
+    package_row.name::text as name,
+    package_row.version::text as version,
+    package_row.uploaded_at::text as uploaded_at,
+    package_row.package_size::bigint as package_size
+  from (
+    select
+      package_table.package_id,
+      coalesce(dar_table.main_package_id, package_table.package_id) as main_package_id,
+      package_table.name,
+      package_table.version,
+      package_table.uploaded_at,
+      package_table.package_size
+    from participant.par_daml_packages package_table
+    left join participant.par_dar_packages dar_table
+      on dar_table.package_id = package_table.package_id
+  ) package_row
+  group by
+    package_row.package_id,
+    package_row.name,
+    package_row.version,
+    package_row.uploaded_at,
+    package_row.package_size
+  order by package_row.package_id asc
+`;
+let PqsPackageService = class PqsPackageService {
+    clientFactory;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+    }
+    async fetchPackageRefs(node) {
+        const client = this.clientFactory.getClient(node);
+        const result = await client.query(PACKAGE_REFS_QUERY);
+        const rows = result.rows ?? [];
+        return rows.map((row) => ({
+            packageId: row.package_id,
+            mainPackageId: row.main_package_id ?? row.package_id,
+            name: row.name,
+            version: row.version,
+            uploadedAt: normalizeOptionalText(row.uploaded_at),
+            packageSize: normalizeOptionalNumber(row.package_size),
+        }));
+    }
+    async fetchPackagesById(node, packageIds) {
+        if (packageIds.length === 0) {
+            return [];
+        }
+        const client = this.clientFactory.getClient(node);
+        const quotedIds = packageIds.map((packageId) => `'${escapeSqlLiteral(packageId)}'`).join(', ');
+        const result = await client.query(`
+      select
+        package_id::text as package_id,
+        name::text as name,
+        version::text as version,
+        uploaded_at::text as uploaded_at,
+        package_size::bigint as package_size,
+        data
+      from participant.par_daml_packages
+      where package_id in (${quotedIds})
+      order by package_id asc
+    `);
+        const rows = result.rows ?? [];
+        return rows
+            .filter((row) => Buffer.isBuffer(row.data))
+            .map((row) => ({
+            packageId: row.package_id,
+            name: row.name,
+            version: row.version,
+            uploadedAt: normalizeOptionalText(row.uploaded_at),
+            packageSize: normalizeOptionalNumber(row.package_size),
+            data: row.data,
+        }));
+    }
+};
+exports.PqsPackageService = PqsPackageService;
+exports.PqsPackageService = PqsPackageService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [pqs_client_factory_1.PqsClientFactory])
+], PqsPackageService);
+function normalizeOptionalText(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    return null;
+}
+function normalizeOptionalNumber(value) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (typeof value === 'string' && value.length > 0) {
+        return Number(value);
+    }
+    return null;
+}
+function escapeSqlLiteral(value) {
+    return value.replaceAll("'", "''");
+}
+//# sourceMappingURL=pqs-package.service.js.map

package/dist/src/packages/pqs-package.service.js.map

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

package/dist/src/pqs/pqs-client.factory.d.ts

@@ -0,0 +1,7 @@
+import { Pool } from 'pg';
+import type { NodeConfig } from '../config/node-config.schema';
+export declare class PqsClientFactory {
+    private readonly logger;
+    private readonly clients;
+    getClient(node: NodeConfig): Pool;
+}

package/dist/src/pqs/pqs-client.factory.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var PqsClientFactory_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PqsClientFactory = void 0;
+const common_1 = require("@nestjs/common");
+const pg_1 = require("pg");
+let PqsClientFactory = PqsClientFactory_1 = class PqsClientFactory {
+    logger = new common_1.Logger(PqsClientFactory_1.name);
+    clients = new Map();
+    getClient(node) {
+        const existing = this.clients.get(node.id);
+        if (existing) {
+            return existing;
+        }
+        const connectionString = process.env[node.pqs.connectionUriEnv];
+        if (!connectionString) {
+            throw new Error(`Missing PQS connection string env var: ${node.pqs.connectionUriEnv}`);
+        }
+        const client = new pg_1.Pool({ connectionString });
+        client.on('error', (error) => {
+            this.logger.warn(`PQS pool error for ${node.id}: ${error.code ?? 'unknown'} ${error.message}`);
+        });
+        this.clients.set(node.id, client);
+        return client;
+    }
+};
+exports.PqsClientFactory = PqsClientFactory;
+exports.PqsClientFactory = PqsClientFactory = PqsClientFactory_1 = __decorate([
+    (0, common_1.Injectable)()
+], PqsClientFactory);
+//# sourceMappingURL=pqs-client.factory.js.map

package/dist/src/pqs/pqs-client.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pqs-client.factory.js","sourceRoot":"","sources":["../../../src/pqs/pqs-client.factory.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAoD;AACpD,2BAA0B;AAInB,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IACV,MAAM,GAAG,IAAI,eAAM,CAAC,kBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEnD,SAAS,CAAC,IAAgB;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,SAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAgC,EAAE,EAAE;YACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,sBAAsB,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,CAC7E,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAA;AAxBY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;GACA,gBAAgB,CAwB5B"}

package/dist/src/pqs/pqs-summary.service.d.ts

@@ -0,0 +1,229 @@
+import type { NodeConfig } from '../config/node-config.schema';
+import { NodeConfigService } from '../config/node-config.service';
+import type { ActivePartiesResponse, GlobalContractsResponse, GlobalRecentUpdatesResponse, NamespaceDetailResponse, NamespacePartiesResponse, NodeContractsResponse, NodeContractDetailResponse, NodePackagesResponse, PartyDetailResponse, LedgerSummary, PackageDetailResponse, PackageFamilyResponse, NodeUpdateDetailResponse, NodeRecentUpdatesResponse, PartyContractsResponse, SearchResultsResponse, TemplateFilterResponse, TokenDetailResponse, TokenHoldersResponse, TokensResponse, TokenTransferSummary, TokenTransfersResponse } from '../domain/node.types';
+import { PqsClientFactory } from './pqs-client.factory';
+import { DamlValueDecoderService } from '../packages/daml-value-decoder.service';
+import { PackageCacheService } from '../packages/package-cache.service';
+import { PackageRegistryService } from '../packages/package-registry.service';
+import { GrpcOperationsService } from '../grpc/grpc-operations.service';
+import { PackageSyncService } from '../packages/package-sync.service';
+export declare class PqsSummaryService {
+    private readonly clientFactory;
+    private readonly damlValueDecoder?;
+    private readonly packageCacheService?;
+    private readonly packageRegistryService?;
+    private readonly nodeConfigService?;
+    private readonly grpcOperationsService?;
+    private readonly packageSyncService?;
+    private readonly observedTokensByNode;
+    private readonly tokenHoldersByNode;
+    private readonly tokenTransfersByNode;
+    constructor(clientFactory: PqsClientFactory, damlValueDecoder?: DamlValueDecoderService | undefined, packageCacheService?: PackageCacheService | undefined, packageRegistryService?: PackageRegistryService | undefined, nodeConfigService?: NodeConfigService | undefined, grpcOperationsService?: GrpcOperationsService | undefined, packageSyncService?: PackageSyncService | undefined);
+    fetchSummary(node: NodeConfig): Promise<LedgerSummary>;
+    search(query: string): Promise<SearchResultsResponse>;
+    fetchRecentUpdates(node: NodeConfig, options?: number | {
+        limit?: number;
+        before?: string;
+        after?: string;
+        parties?: string[];
+        templates?: string[];
+        partyMode?: string;
+        mode?: string;
+        hideSplice?: boolean;
+    }): Promise<NodeRecentUpdatesResponse>;
+    fetchGlobalRecentUpdates(nodes: NodeConfig[], limit?: number, options?: {
+        before?: string;
+        after?: string;
+        parties?: string[];
+        templates?: string[];
+        partyMode?: string;
+        mode?: string;
+        hideSplice?: boolean;
+    }): Promise<GlobalRecentUpdatesResponse>;
+    private emptySearchGroup;
+    private finalizeSearchGroup;
+    private resolveNodeSearchStatus;
+    private isExactMatch;
+    private hasPrefixMatch;
+    private searchUpdates;
+    private searchUpdatesForNode;
+    private searchContracts;
+    private searchContractsForNode;
+    private searchParties;
+    private searchPackages;
+    private querySearchUpdateMetaRows;
+    private queryRecentUpdateMetaRows;
+    fetchNodeContracts(node: NodeConfig, options?: {
+        limit?: number;
+        before?: string;
+        after?: string;
+        parties?: string[];
+        templates?: string[];
+        partyMode?: string;
+        hideSplice?: boolean;
+    }): Promise<NodeContractsResponse>;
+    fetchActivityBuckets(node: NodeConfig, days?: number, bucketMinutes?: number): Promise<Array<{
+        timestamp: string;
+        activityValue: number;
+        latestOffset: string | null;
+    }>>;
+    fetchPackageDetail(packageId: string): Promise<PackageDetailResponse>;
+    fetchPackagesByName(packageName: string): Promise<PackageFamilyResponse>;
+    fetchNodePackages(node: NodeConfig): Promise<NodePackagesResponse>;
+    fetchTemplates(): Promise<TemplateFilterResponse>;
+    fetchNodeTemplates(node: NodeConfig): Promise<TemplateFilterResponse>;
+    fetchActiveParties(nodes: NodeConfig[]): Promise<ActivePartiesResponse>;
+    fetchPartyDetail(nodes: NodeConfig[], partyId: string): Promise<PartyDetailResponse>;
+    fetchNamespaceDetail(nodes: NodeConfig[], namespaceId: string): Promise<NamespaceDetailResponse>;
+    fetchNamespaceParties(nodes: NodeConfig[], namespaceId: string, options?: {
+        limit?: number;
+        before?: string;
+        after?: string;
+    }): Promise<NamespacePartiesResponse>;
+    fetchPartyUpdates(nodes: NodeConfig[], partyId: string, options?: {
+        limit?: number;
+        before?: string;
+        after?: string;
+        templates?: string[];
+        partyMode?: string;
+        hideSplice?: boolean;
+    }): Promise<GlobalRecentUpdatesResponse>;
+    fetchGlobalContracts(nodes: NodeConfig[], limit?: number, options?: {
+        before?: string;
+        after?: string;
+        parties?: string[];
+        templates?: string[];
+        partyMode?: string;
+        hideSplice?: boolean;
+    }): Promise<GlobalContractsResponse>;
+    fetchPartyContracts(nodes: NodeConfig[], partyId: string, options?: {
+        limit?: number;
+        before?: string;
+        after?: string;
+        templates?: string[];
+        hideSplice?: boolean;
+    }): Promise<PartyContractsResponse>;
+    fetchTokens(nodes: NodeConfig[], limit?: number, options?: {
+        before?: string;
+        after?: string;
+        names?: string[];
+        excludeNames?: string[];
+        issuers?: string[];
+    }): Promise<TokensResponse>;
+    fetchLatestTokenTransfers(nodes: NodeConfig[], limit?: number, options?: {
+        before?: string;
+        after?: string;
+        fromParties?: string[];
+        toParties?: string[];
+        amountGt?: string;
+        amountLt?: string;
+    }): Promise<TokenTransfersResponse>;
+    fetchTokenTransfers(nodes: NodeConfig[], tokenId: string, limit?: number, options?: {
+        before?: string;
+        after?: string;
+        fromParties?: string[];
+        toParties?: string[];
+        amountGt?: string;
+        amountLt?: string;
+    }): Promise<TokenTransfersResponse>;
+    fetchTokenTransferDetail(nodes: NodeConfig[], transferId: string): Promise<TokenTransferSummary>;
+    fetchTokenDetail(nodes: NodeConfig[], tokenId: string): Promise<TokenDetailResponse>;
+    fetchTokenHolders(nodes: NodeConfig[], tokenId: string, limit?: number, options?: {
+        before?: string;
+        after?: string;
+    }): Promise<TokenHoldersResponse>;
+    private paginateTokenHolders;
+    private paginateTokens;
+    private filterTokens;
+    private loadMergedTokenTransfers;
+    private recoverTokenTransfersFromActiveHolders;
+    private paginateTokenTransfers;
+    private filterTokenTransfersByParties;
+    fetchUpdateDetail(node: NodeConfig, eventOffset: string): Promise<NodeUpdateDetailResponse>;
+    fetchContractDetail(node: NodeConfig, contractId: string): Promise<NodeContractDetailResponse>;
+    private querySummary;
+    private fetchPartyRecentUpdatesForNode;
+    private fetchPartyRecentContractsForNode;
+    private fetchPartyContractsForNode;
+    private shouldFallbackToParticipantTables;
+    private shouldFallbackToNormalizedEventTables;
+    private fetchActivePartiesForNode;
+    private fetchPartiesByUpdateId;
+    private loadCachedObservedTokens;
+    private fetchObservedTokensForNode;
+    private findObservedToken;
+    private normalizeObservedTokenRow;
+    private loadCachedTokenHolders;
+    private fetchTokenHoldersForNode;
+    private normalizeTokenHolderRow;
+    private loadCachedTokenTransfers;
+    private fetchTokenTransfersForNode;
+    private normalizeTokenTransferRow;
+    private fetchInferredCip112TransfersForNode;
+    private inferCip112TokenMovements;
+    private buildInferredCip112Movement;
+    private mergeTokenTransfers;
+    private mergeTokenHolders;
+    private buildTokenTransferDedupKey;
+    private normalizeTokenId;
+    private isCip112TemplateId;
+    private isSupportedObservedTokenTemplate;
+    private isShareLikeCip112Template;
+    private isHexTokenMovementUpdateId;
+    private buildTokenMovementRowId;
+    private compareNumericStrings;
+    private addNumericStrings;
+    private numericScale;
+    private parseScaledDecimal;
+    private normalizeUpdateId;
+    private extractTokenMovement;
+    private extractCip56TokenSummary;
+    private extractObservedTokenSummary;
+    private extractCip112TokenSummary;
+    private buildObservedTokenId;
+    private normalizeShareLikeIntrinsicTokenId;
+    private readConfiguredDecodedTokenMetadata;
+    private getTokenMetadataConfig;
+    private fetchEventsByUpdateId;
+    private shouldResolveRewardCoupon;
+    private fetchRewardCouponDetails;
+    private extractRawUpdateId;
+    private extractEventOffset;
+    private extractIsoRecordTime;
+    private extractMeta;
+    private normalizeEventRow;
+    private attachRewardCouponDetails;
+    private decodeRewardCouponContractInstance;
+    private decodeContractData;
+    private decodeExerciseData;
+    private retryContractDecodeAfterPackageRefresh;
+    private retryExerciseDecodeAfterPackageRefresh;
+    private extractPackageRefreshReason;
+    private shouldRetryPackageRefresh;
+    private refreshPackageForNode;
+    private normalizePackageIdentifier;
+    private decodeKnownContractData;
+    private isRecordValue;
+    private findRecordField;
+    private readScalarField;
+    private readNestedScalarField;
+    private readTextMapEntryField;
+    private getFirstLengthDelimitedField;
+    private getAllLengthDelimitedFields;
+    private unwrapScalarVarint;
+    private parseProtobufFields;
+    private readVarint;
+    private buildTemplateFilterResponse;
+    private normalizeOptionalScalar;
+    private fetchNamespaceTopologyByNode;
+    private mergeNamespaceNodeTopologies;
+    private dedupePartyTopologyParticipants;
+    private dedupePartyTopologyKeys;
+    private extractNamespaceIdentifier;
+    private paginateNamespacePartyIds;
+    private normalizeTemplateIdentifier;
+    private normalizeChoiceIdentifier;
+    private normalizeParties;
+    private normalizePartyIdentifier;
+    private defaultRow;
+}