@distrohelena/canton-explorer 0.1.0

package/dist/src/config/node-config.service.js

@@ -0,0 +1,36 @@
+"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.NodeConfigService = void 0;
+const common_1 = require("@nestjs/common");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_config_schema_1 = require("./node-config.schema");
+let NodeConfigService = class NodeConfigService {
+    config;
+    constructor() {
+        const configPath = process.env.NODE_CONFIG_PATH ?? (0, node_path_1.resolve)(process.cwd(), 'config', 'nodes.local.json');
+        const fileContents = (0, node_fs_1.readFileSync)(configPath, 'utf8');
+        this.config = (0, node_config_schema_1.parseNodeConfigFile)(JSON.parse(fileContents));
+    }
+    list() {
+        return this.config.nodes;
+    }
+    getTokenMetadataConfig() {
+        return this.config.tokenMetadata;
+    }
+};
+exports.NodeConfigService = NodeConfigService;
+exports.NodeConfigService = NodeConfigService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], NodeConfigService);
+//# sourceMappingURL=node-config.service.js.map

package/dist/src/config/node-config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-config.service.js","sourceRoot":"","sources":["../../../src/config/node-config.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,qCAAuC;AACvC,yCAAoC;AACpC,6DAK8B;AAGvB,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IACX,MAAM,CAAiB;IAExC;QACE,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QACvF,MAAM,YAAY,GAAG,IAAA,sBAAY,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAA,wCAAmB,EAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,sBAAsB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;IACnC,CAAC;CACF,CAAA;AAjBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;;GACA,iBAAiB,CAiB7B"}

package/dist/src/domain/node-health.d.ts

@@ -0,0 +1,9 @@
+import type { NodeStatus } from './node.types';
+export interface ComputeNodeStatusArgs {
+    pqsOk: boolean;
+    grpcRequired: boolean;
+    grpcOk: boolean;
+    isStale: boolean;
+    hasUsableSnapshot: boolean;
+}
+export declare function computeNodeStatus(args: ComputeNodeStatusArgs): NodeStatus;

package/dist/src/domain/node-health.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeNodeStatus = computeNodeStatus;
+function computeNodeStatus(args) {
+    if (!args.pqsOk && !args.hasUsableSnapshot) {
+        return 'down';
+    }
+    if (args.isStale) {
+        return 'degraded';
+    }
+    if (args.grpcRequired && !args.grpcOk) {
+        return 'degraded';
+    }
+    return args.pqsOk ? 'healthy' : 'degraded';
+}
+//# sourceMappingURL=node-health.js.map

package/dist/src/domain/node-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-health.js","sourceRoot":"","sources":["../../../src/domain/node-health.ts"],"names":[],"mappings":";;AAUA,8CAcC;AAdD,SAAgB,iBAAiB,CAAC,IAA2B;IAC3D,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAC7C,CAAC"}

package/dist/src/domain/node.types.d.ts

@@ -0,0 +1,563 @@
+export type NodeRole = 'participant';
+export type NodeMode = 'pqs_only' | 'pqs_with_grpc';
+export type NodeStatus = 'healthy' | 'degraded' | 'down';
+export interface SourceStatus {
+    ok: boolean;
+    checkedAt: string;
+    latencyMs: number | null;
+    message: string | null;
+}
+export interface LedgerSummary {
+    ledgerLabel: string;
+    pqsDatabase: string;
+    activeContractCount: number;
+    latestOffset: string | null;
+    latestEventAt: string | null;
+    totalUpdateCount: number;
+}
+export interface ServiceInfo {
+    target: string | null;
+    reachable: boolean;
+    healthCheckImplemented: boolean;
+    servingStatus: string | null;
+}
+export interface NodeActivitySample {
+    timestamp: string;
+    activityValue: number;
+    activeContractCount: number;
+    latestOffset: string | null;
+}
+export interface NodeActivitySeries {
+    nodeId: string;
+    label: string;
+    status: NodeStatus;
+    latestActiveContractCount: number;
+    samples: NodeActivitySample[];
+}
+export interface NodeActivityHistoryResponse {
+    generatedAt: string;
+    windowMinutes: number;
+    nodes: NodeActivitySeries[];
+}
+export interface NodeRecentUpdate {
+    eventOffset: string;
+    updateId: string;
+    recordTime: string | null;
+    parties: string[];
+}
+export interface NodeRecentUpdatesResponse {
+    nodeId: string;
+    label: string;
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    updates: NodeRecentUpdate[];
+}
+export interface GlobalRecentUpdate extends NodeRecentUpdate {
+    nodeId: string;
+    label: string;
+}
+export interface GlobalRecentUpdatesResponse {
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    updates: GlobalRecentUpdate[];
+}
+export interface SearchResultGroup<T> {
+    items: T[];
+    displayedCount: number;
+    truncated: boolean;
+    status: 'ok' | 'partial' | 'failed';
+    warnings: string[];
+}
+export interface SearchUpdateResult {
+    nodeId: string;
+    label: string;
+    eventOffset: string;
+    updateId: string;
+    recordTime: string | null;
+    parties: string[];
+}
+export interface SearchContractResult {
+    nodeId: string;
+    label: string;
+    contractId: string;
+    templateId: string | null;
+    createdRecordTime: string | null;
+}
+export interface SearchPartyResult {
+    partyId: string;
+    nodeIds: string[];
+}
+export interface SearchPackageIdResult {
+    packageId: string;
+    name: string | null;
+    version: string | null;
+}
+export interface SearchPackageNameResult {
+    name: string;
+    packages: Array<{
+        packageId: string;
+        version: string | null;
+    }>;
+}
+export interface SearchResultsResponse {
+    query: string;
+    updates: SearchResultGroup<SearchUpdateResult>;
+    contracts: SearchResultGroup<SearchContractResult>;
+    parties: SearchResultGroup<SearchPartyResult>;
+    packages: {
+        packageIds: SearchResultGroup<SearchPackageIdResult>;
+        packageNames: SearchResultGroup<SearchPackageNameResult>;
+    };
+}
+export interface NodeActiveContractSummary {
+    contractId: string;
+    templateId: string | null;
+    createdRecordTime: string | null;
+}
+export interface NodeContractsResponse {
+    nodeId: string;
+    label: string;
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    contracts: NodeActiveContractSummary[];
+}
+export interface GlobalContractSummary {
+    nodeId: string;
+    label: string;
+    contractId: string;
+    templateId: string | null;
+    recordTime: string | null;
+}
+export interface GlobalContractsResponse {
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    contracts: GlobalContractSummary[];
+}
+export interface TokenSummary {
+    tokenId: string;
+    name: string;
+    symbol: string | null;
+    issuer: string | null;
+    source: 'pqs' | 'grpc';
+}
+export interface TokensResponse {
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    tokens: TokenSummary[];
+}
+export interface TokenDetailResponse {
+    token: TokenSummary;
+    transfers: TokenTransferSummary[];
+}
+export interface TokenHolderObservedNode {
+    nodeId: string;
+    label: string;
+}
+export interface TokenHolderSummary {
+    partyId: string;
+    amount: string | null;
+    nodes: TokenHolderObservedNode[];
+}
+export interface TokenHoldersResponse {
+    tokenId: string;
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    holders: TokenHolderSummary[];
+}
+export interface TokenTransferObservedNode {
+    nodeId: string;
+    label: string;
+    eventOffset: string;
+}
+export interface TokenTransferSummary {
+    rowId?: string;
+    movementType?: string | null;
+    source?: 'pqs' | 'pqs_inferred_holding_v2';
+    tokenId: string;
+    tokenName: string;
+    amount: string | null;
+    sender: string | null;
+    receiver: string | null;
+    updateId: string;
+    recordTime: string | null;
+    nodes: TokenTransferObservedNode[];
+}
+export interface TokenTransfersResponse {
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    transfers: TokenTransferSummary[];
+}
+export interface NodeUpdateDetailMeta {
+    update_id: string;
+    record_time: string | number | null;
+    [key: string]: unknown;
+}
+export type NodeDecodeFailureReason = 'missing_package' | 'invalid_package' | 'unknown_template' | 'unknown_choice' | 'unknown_data_type' | 'decode_failure';
+export type NodeDecodedDamlValue = string | number | boolean | {
+    kind: 'contract_id';
+    value: string;
+} | {
+    kind: 'record';
+    fields: Array<{
+        label: string;
+        value: NodeDecodedDamlValue;
+    }>;
+} | {
+    kind: 'variant';
+    constructor: string;
+    value: NodeDecodedDamlValue | null;
+} | {
+    kind: 'enum';
+    constructor: string;
+} | {
+    kind: 'list';
+    items: NodeDecodedDamlValue[];
+} | {
+    kind: 'optional';
+    value: NodeDecodedDamlValue | null;
+} | {
+    kind: 'text_map';
+    entries: Array<{
+        key: string;
+        value: NodeDecodedDamlValue;
+    }>;
+} | {
+    kind: 'gen_map';
+    entries: Array<{
+        key: NodeDecodedDamlValue;
+        value: NodeDecodedDamlValue;
+    }>;
+} | {
+    kind: 'unit';
+};
+export type NodeDecodeState<T> = {
+    status: 'decoded';
+    value: T;
+} | {
+    status: 'invalid_data';
+    reason: NodeDecodeFailureReason;
+} | {
+    status: 'not_available';
+};
+export interface NodeExerciseDecodeState {
+    argument: NodeDecodeState<NodeDecodedDamlValue>;
+    result: NodeDecodeState<NodeDecodedDamlValue>;
+}
+export interface NodeUpdateDetailEvent {
+    eventKind: 'create' | 'consuming_exercise' | 'non_consuming_exercise';
+    eventId: string | null;
+    contractId: string | null;
+    packageId?: string | null;
+    templateId: string | null;
+    choice: string | null;
+    witnesses: string[];
+    createData?: NodeDecodeState<NodeDecodedDamlValue> | null;
+    exerciseData?: NodeExerciseDecodeState | null;
+    raw: Record<string, unknown>;
+}
+export interface NodeUpdateDetailResponse {
+    nodeId: string;
+    label: string;
+    eventOffset: string;
+    updateId: string;
+    recordTime: string | null;
+    parties: string[];
+    meta: NodeUpdateDetailMeta;
+    events: NodeUpdateDetailEvent[];
+}
+export interface NodeContractDetailResponse {
+    nodeId: string;
+    label: string;
+    contractId: string;
+    templateId: string | null;
+    packageId: string | null;
+    packageName: string | null;
+    packageVersion: string | null;
+    createdUpdateId: string | null;
+    createdEventOffset: string | null;
+    createdRecordTime: string | null;
+    archivedUpdateId: string | null;
+    archivedEventOffset: string | null;
+    archivedRecordTime: string | null;
+    contractData: NodeDecodeState<NodeDecodedDamlValue> | null;
+}
+export interface PackageSeenOnNode {
+    nodeId: string;
+    packageName: string | null;
+    packageVersion: string | null;
+    seenAt: string;
+}
+export interface PackageTypeField {
+    name: string;
+    type: PackageTypeNode;
+}
+export interface PackageTypeConstructor {
+    name: string;
+    type: PackageTypeNode | null;
+}
+export interface PackageInterfaceMethod {
+    name: string;
+    type: PackageTypeNode | null;
+}
+export interface PackageInterfaceChoice {
+    name: string;
+    consuming: boolean;
+    argumentType: PackageTypeNode | null;
+    resultType: PackageTypeNode | null;
+}
+export interface PackageTypeNode {
+    kind: 'builtin' | 'type_var' | 'type_con' | 'record' | 'variant' | 'enum' | 'interface' | 'struct' | 'forall' | 'nat' | 'synonym' | 'unknown';
+    label: string;
+    packageId?: string | null;
+    typeId?: string | null;
+    arguments?: PackageTypeNode[];
+    typeParameters?: string[];
+    fields?: PackageTypeField[];
+    constructors?: PackageTypeConstructor[];
+    view?: PackageTypeNode | null;
+    requires?: PackageTypeNode[];
+    methods?: PackageInterfaceMethod[];
+    choices?: PackageInterfaceChoice[];
+    body?: PackageTypeNode | null;
+    definition?: PackageTypeNode | null;
+    note?: 'recursive_reference' | 'missing_definition' | 'unsupported';
+}
+export interface PackageTemplateSummary {
+    templateId: string;
+    moduleName: string;
+    entityName: string;
+    createType: PackageTypeNode | null;
+}
+export interface PackageDataTypeSummary {
+    typeId: string;
+    moduleName: string;
+    entityName: string;
+    definition: PackageTypeNode | null;
+}
+export interface PackageDetailResponse {
+    packageId: string;
+    name: string | null;
+    version: string | null;
+    uploadedAt: string | null;
+    packageSize: number | null;
+    status: 'decoded' | 'invalid_package' | 'missing_package';
+    seenOnNodes: PackageSeenOnNode[];
+    moduleCount: number;
+    templateCount: number;
+    dataTypeCount: number;
+    modules: string[];
+    templates: PackageTemplateSummary[];
+    dataTypes: PackageDataTypeSummary[];
+}
+export interface PackageFamilyEntry {
+    packageId: string;
+    name: string | null;
+    version: string | null;
+    uploadedAt: string | null;
+    packageSize: number | null;
+}
+export interface PackageFamilyResponse {
+    name: string;
+    packages: PackageFamilyEntry[];
+}
+export interface TemplateFilterEntry {
+    templateId: string;
+}
+export interface TemplateFilterResponse {
+    templates: TemplateFilterEntry[];
+}
+export interface NodeInstalledPackageEntry {
+    packageId: string;
+    version: string | null;
+    uploadedAt: string | null;
+    seenAt: string;
+}
+export interface NodeInstalledPackageGroup {
+    packageName: string;
+    packages: NodeInstalledPackageEntry[];
+}
+export type NodeParticipantStatusState = 'ok' | 'not_initialized' | 'grpc_not_configured' | 'grpc_error';
+export type NodeParticipantStatusComponentSeverity = 'ok' | 'degraded' | 'failed' | 'fatal';
+export type NodeParticipantSynchronizerHealth = 'unspecified' | 'healthy' | 'unhealthy';
+export type NodeParticipantWaitingForExternalInput = 'unspecified' | 'id' | 'node_topology' | 'initialization';
+export interface NodeParticipantStatusComponent {
+    name: string;
+    severity: NodeParticipantStatusComponentSeverity;
+    description: string | null;
+}
+export interface NodeParticipantTopologyQueues {
+    manager: number;
+    dispatcher: number;
+    clients: number;
+}
+export interface NodeParticipantConnectedSynchronizer {
+    physicalSynchronizerId: string | null;
+    health: NodeParticipantSynchronizerHealth;
+}
+export interface NodeParticipantStatusSummary {
+    uid: string | null;
+    uptime: string | null;
+    ports: Record<string, number>;
+    active: boolean;
+    commonStatusActive: boolean | null;
+    version: string | null;
+    supportedProtocolVersions: number[];
+    topologyQueues: NodeParticipantTopologyQueues | null;
+    components: NodeParticipantStatusComponent[];
+    connectedSynchronizers: NodeParticipantConnectedSynchronizer[];
+}
+export interface NodeParticipantNotInitializedSummary {
+    active: boolean;
+    waitingForExternalInput: NodeParticipantWaitingForExternalInput;
+    version: string | null;
+}
+export interface NodeParticipantStatusResponse {
+    nodeId: string;
+    label: string;
+    mode: NodeMode;
+    participantStatusStatus: NodeParticipantStatusState;
+    participantStatus: NodeParticipantStatusSummary | null;
+    notInitialized: NodeParticipantNotInitializedSummary | null;
+    participantStatusError: string | null;
+    participantStatusErrorCode: string | null;
+    participantStatusErrorDetails: string | null;
+    participantStatusErrorTid: string | null;
+}
+export interface NodePackagesResponse {
+    nodeId: string;
+    label: string;
+    packagesByName: NodeInstalledPackageGroup[];
+}
+export interface ActivePartiesNodeEntry {
+    nodeId: string;
+    label: string;
+    mode: NodeMode;
+    parties: string[];
+    localPartiesStatus?: 'ok' | 'grpc_not_configured' | 'grpc_error';
+    localPartiesError?: string | null;
+    localPartiesErrorCode?: string | null;
+    localPartiesErrorDetails?: string | null;
+    localPartiesErrorTid?: string | null;
+}
+export interface ActivePartiesResponse {
+    nodes: ActivePartiesNodeEntry[];
+}
+export interface NodePartyFingerprintsEntry {
+    nodeId: string;
+    label: string;
+    mode: NodeMode;
+    source: 'pqs' | 'grpc';
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    fingerprints: string[];
+}
+export interface PartyFingerprintsResponse {
+    source: 'pqs' | 'grpc';
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    fingerprints: string[];
+}
+export interface PartyNodeSummary {
+    nodeId: string;
+    label: string;
+    recentUpdateCount: number;
+    recentContractCount: number;
+}
+export interface PartyRecentUpdate {
+    nodeId: string;
+    label: string;
+    eventOffset: string;
+    updateId: string;
+    recordTime: string | null;
+    parties: string[];
+}
+export interface PartyRecentContract {
+    nodeId: string;
+    label: string;
+    contractId: string;
+    templateId: string | null;
+    packageId: string | null;
+    packageName: string | null;
+    packageVersion: string | null;
+    recordTime: string | null;
+}
+export interface PartyContractsResponse {
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    contracts: PartyRecentContract[];
+}
+export interface PartyTopologyParticipantMapping {
+    participantId: string | null;
+    participantUid: string | null;
+    permission: string | null;
+    threshold: number | null;
+    synchronizerIds: string[];
+}
+export interface PartyTopologyKeyMapping {
+    keyFingerprint: string | null;
+    publicKey: string | null;
+    purpose: string | null;
+    keyType: string | null;
+    keyFormat: string | null;
+    keySpec: string | null;
+    threshold: number | null;
+    synchronizerIds: string[];
+}
+export type PartyTopologyNodeStatus = 'ok' | 'grpc_not_configured' | 'grpc_error';
+export interface PartyTopologyNodeEntry {
+    nodeId: string;
+    label: string;
+    status: PartyTopologyNodeStatus;
+    errorMessage: string | null;
+    isLocalParty?: boolean | null;
+    partyToParticipants: PartyTopologyParticipantMapping[];
+    partyToKeyMappings: PartyTopologyKeyMapping[];
+}
+export interface PartyDetailResponse {
+    partyId: string;
+    nodeCount: number;
+    recentUpdateCount: number;
+    recentContractCount: number;
+    nodes: PartyNodeSummary[];
+    recentUpdates: PartyRecentUpdate[];
+    recentContracts: PartyRecentContract[];
+    partyTopologyByNode: PartyTopologyNodeEntry[];
+}
+export interface NamespacePartySummary {
+    partyId: string;
+}
+export interface NamespacePartiesResponse {
+    namespaceId: string;
+    partyCount: number;
+    limit: number;
+    nextBefore: string | null;
+    nextAfter: string | null;
+    parties: NamespacePartySummary[];
+}
+export interface NamespaceNodeSummary {
+    nodeId: string;
+    label: string;
+    recentUpdateCount: number;
+    recentContractCount: number;
+}
+export interface NamespaceDetailResponse {
+    namespaceId: string;
+    partyCount: number;
+    nodeCount: number;
+    recentUpdateCount: number;
+    recentContractCount: number;
+    nodes: NamespaceNodeSummary[];
+    recentUpdates: PartyRecentUpdate[];
+    recentContracts: PartyRecentContract[];
+    topologyByNode: PartyTopologyNodeEntry[];
+}

package/dist/src/domain/node.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=node.types.js.map

package/dist/src/domain/node.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.types.js","sourceRoot":"","sources":["../../../src/domain/node.types.ts"],"names":[],"mappings":""}