@psavelis/enterprise-blockchain 0.1.0 → 1.1.1

package/dist/shared/store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Port interface for key-value storage.
+ *
+ * Domain services depend on this abstraction rather than on concrete Map
+ * instances, keeping infrastructure concerns (persistence, caching, replication)
+ * out of the domain layer.
+ */
+export interface ReadonlyStore<K, V> {
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    values(): IterableIterator<V>;
+    entries(): IterableIterator<[K, V]>;
+}
+export interface Store<K, V> extends ReadonlyStore<K, V> {
+    set(key: K, value: V): void;
+}
+export declare class InMemoryStore<K, V> implements Store<K, V> {
+    private readonly data;
+    set(key: K, value: V): void;
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    values(): IterableIterator<V>;
+    entries(): IterableIterator<[K, V]>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/shared/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/shared/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC;IACjC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;IACrB,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,aAAa,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IAExC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAI3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI7B,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAGpC"}

package/dist/shared/store.js

@@ -0,0 +1,18 @@
+export class InMemoryStore {
+    data = new Map();
+    set(key, value) {
+        this.data.set(key, value);
+    }
+    get(key) {
+        return this.data.get(key);
+    }
+    has(key) {
+        return this.data.has(key);
+    }
+    values() {
+        return this.data.values();
+    }
+    entries() {
+        return this.data.entries();
+    }
+}

package/dist/shared/telemetry-sdk.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OpenTelemetry SDK initialization.
+ *
+ * This module should be imported at application startup BEFORE any other
+ * imports to ensure proper instrumentation:
+ *
+ *   import "@psavelis/enterprise-blockchain/shared/telemetry-sdk";
+ *
+ * The SDK is configured via standard OpenTelemetry environment variables:
+ * - OTEL_SERVICE_NAME: Service name (default: "enterprise-blockchain")
+ * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP collector endpoint (e.g., "http://localhost:4318")
+ * - OTEL_TRACES_EXPORTER: Trace exporter type (default: "otlp" if endpoint set)
+ * - OTEL_METRICS_EXPORTER: Metrics exporter type (default: "otlp" if endpoint set)
+ *
+ * Additional configuration:
+ * - OTEL_LOG_LEVEL: Set to "silent" to suppress console output
+ * - OTEL_REGISTER_SIGNAL_HANDLERS: Set to "false" to disable SIGTERM/SIGINT handlers
+ *
+ * If OTEL_EXPORTER_OTLP_ENDPOINT is not set, telemetry is disabled (no-op).
+ *
+ * Ref: https://opentelemetry.io/docs/languages/js/getting-started/nodejs/
+ */
+import { NodeSDK } from "@opentelemetry/sdk-node";
+declare let sdk: NodeSDK | null;
+export { sdk };
+//# sourceMappingURL=telemetry-sdk.d.ts.map

package/dist/shared/telemetry-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-sdk.d.ts","sourceRoot":"","sources":["../../src/shared/telemetry-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAgClD,QAAA,IAAI,GAAG,EAAE,OAAO,GAAG,IAAW,CAAC;AA0D/B,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/shared/telemetry-sdk.js

@@ -0,0 +1,97 @@
+/**
+ * OpenTelemetry SDK initialization.
+ *
+ * This module should be imported at application startup BEFORE any other
+ * imports to ensure proper instrumentation:
+ *
+ *   import "@psavelis/enterprise-blockchain/shared/telemetry-sdk";
+ *
+ * The SDK is configured via standard OpenTelemetry environment variables:
+ * - OTEL_SERVICE_NAME: Service name (default: "enterprise-blockchain")
+ * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP collector endpoint (e.g., "http://localhost:4318")
+ * - OTEL_TRACES_EXPORTER: Trace exporter type (default: "otlp" if endpoint set)
+ * - OTEL_METRICS_EXPORTER: Metrics exporter type (default: "otlp" if endpoint set)
+ *
+ * Additional configuration:
+ * - OTEL_LOG_LEVEL: Set to "silent" to suppress console output
+ * - OTEL_REGISTER_SIGNAL_HANDLERS: Set to "false" to disable SIGTERM/SIGINT handlers
+ *
+ * If OTEL_EXPORTER_OTLP_ENDPOINT is not set, telemetry is disabled (no-op).
+ *
+ * Ref: https://opentelemetry.io/docs/languages/js/getting-started/nodejs/
+ */
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+const serviceName = process.env.OTEL_SERVICE_NAME ?? "enterprise-blockchain";
+// Configuration flags for library-friendly behavior
+const isSilent = process.env.OTEL_LOG_LEVEL === "silent";
+const registerSignalHandlers = process.env.OTEL_REGISTER_SIGNAL_HANDLERS !== "false";
+/**
+ * Internal logger that respects OTEL_LOG_LEVEL=silent.
+ * This prevents unwanted console output in tests, serverless, or CLI environments.
+ */
+const log = {
+    info: (message) => {
+        if (!isSilent) {
+            console.log(message);
+        }
+    },
+    error: (message, error) => {
+        if (!isSilent) {
+            console.error(message, error);
+        }
+    },
+};
+let sdk = null;
+if (endpoint) {
+    const resource = resourceFromAttributes({
+        [ATTR_SERVICE_NAME]: serviceName,
+    });
+    const traceExporter = new OTLPTraceExporter({
+        url: `${endpoint}/v1/traces`,
+    });
+    const metricExporter = new OTLPMetricExporter({
+        url: `${endpoint}/v1/metrics`,
+    });
+    const metricReader = new PeriodicExportingMetricReader({
+        exporter: metricExporter,
+        exportIntervalMillis: 10_000, // Export metrics every 10 seconds
+    });
+    sdk = new NodeSDK({
+        resource,
+        traceExporter,
+        metricReader,
+    });
+    // Start the SDK. NodeSDK.start() is synchronous and returns void.
+    // Errors during startup will throw, so we wrap in try-catch for safety.
+    try {
+        sdk.start();
+    }
+    catch (err) {
+        log.error("OpenTelemetry SDK failed to start:", err);
+    }
+    // Graceful shutdown handler - only register if enabled
+    if (registerSignalHandlers) {
+        const shutdown = () => {
+            sdk
+                ?.shutdown()
+                .then(() => {
+                log.info("OpenTelemetry SDK shut down successfully");
+            })
+                .catch((err) => {
+                log.error("Error shutting down OpenTelemetry SDK:", err);
+            });
+        };
+        process.on("SIGTERM", shutdown);
+        process.on("SIGINT", shutdown);
+    }
+    log.info(`OpenTelemetry SDK initialized: service=${serviceName}, endpoint=${endpoint}`);
+}
+// When endpoint is not set, telemetry is a no-op - stay completely silent.
+// This aligns with the module doc comment and prevents console noise in tests/apps.
+export { sdk };

package/dist/shared/telemetry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * OpenTelemetry instrumentation for distributed tracing and metrics.
+ *
+ * Provides tracer and meter factories that integrate with the OpenTelemetry
+ * SDK. When OTEL_EXPORTER_OTLP_ENDPOINT is set, telemetry is exported to
+ * the configured collector; otherwise, telemetry is a no-op.
+ *
+ * Usage:
+ *   // First, initialize the SDK at application startup (side-effect import):
+ *   import "@psavelis/enterprise-blockchain/shared/telemetry-sdk";
+ *
+ *   // Then import helpers from this module:
+ *   import { createTracer, createMeter } from "@psavelis/enterprise-blockchain/shared/telemetry";
+ *   const tracer = createTracer("my-service");
+ *   const meter = createMeter("my-service");
+ *
+ * NOTE: This module requires @opentelemetry/api as a peer dependency.
+ * It is NOT re-exported from the main shared index to preserve optional deps.
+ *
+ * Ref: OpenTelemetry Specification — https://opentelemetry.io/docs/specs/otel/
+ */
+import { context, propagation, SpanStatusCode, type Tracer, type Meter, type Span, type SpanOptions, type Context } from "@opentelemetry/api";
+export type { Tracer, Meter, Span, SpanOptions, Context };
+export { SpanStatusCode, context, propagation };
+/**
+ * Service name for telemetry, read from OTEL_SERVICE_NAME or defaulting
+ * to "enterprise-blockchain".
+ */
+export declare const SERVICE_NAME: string;
+/**
+ * Whether telemetry export is enabled (OTEL_EXPORTER_OTLP_ENDPOINT is set).
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Create a tracer for distributed tracing.
+ *
+ * @param name - The name of the instrumentation scope (e.g., "fabric-gateway")
+ * @param version - Optional version string for the instrumentation
+ */
+export declare function createTracer(name: string, version?: string): Tracer;
+/**
+ * Create a meter for metrics collection.
+ *
+ * @param name - The name of the instrumentation scope (e.g., "circuit-breaker")
+ * @param version - Optional version string for the instrumentation
+ */
+export declare function createMeter(name: string, version?: string): Meter;
+/**
+ * Attribute keys for telemetry following OpenTelemetry semantic conventions.
+ */
+export declare const TelemetryAttributes: {
+    readonly SERVICE_NAME: "service.name";
+    readonly RETRY_ATTEMPT: "retry.attempt";
+    readonly RETRY_MAX_ATTEMPTS: "retry.max_attempts";
+    readonly RETRY_ERROR_CODE: "retry.error_code";
+    readonly RETRY_DELAY_MS: "retry.delay_ms";
+    readonly CIRCUIT_BREAKER_STATE: "circuit_breaker.state";
+    readonly CIRCUIT_BREAKER_FAILURES: "circuit_breaker.consecutive_failures";
+    readonly CIRCUIT_BREAKER_COOLDOWN_MS: "circuit_breaker.cooldown_ms";
+    readonly BLOCKCHAIN_PLATFORM: "blockchain.platform";
+    readonly BLOCKCHAIN_CHANNEL: "blockchain.channel";
+    readonly BLOCKCHAIN_CHAINCODE: "blockchain.chaincode";
+    readonly BLOCKCHAIN_TX_ID: "blockchain.transaction_id";
+    readonly BLOCKCHAIN_BLOCK_NUMBER: "blockchain.block_number";
+    readonly ERROR_TYPE: "error.type";
+    readonly ERROR_MESSAGE: "error.message";
+};
+/**
+ * Helper to run a function within a new span.
+ *
+ * @param tracer - The tracer to use
+ * @param name - Span name
+ * @param fn - Function to execute within the span
+ * @param options - Optional span options
+ */
+export declare function withSpan<T>(tracer: Tracer, name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+/**
+ * Helper to run a synchronous function within a new span.
+ *
+ * @param tracer - The tracer to use
+ * @param name - Span name
+ * @param fn - Function to execute within the span
+ * @param options - Optional span options
+ */
+export declare function withSpanSync<T>(tracer: Tracer, name: string, fn: (span: Span) => T, options?: SpanOptions): T;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/shared/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/shared/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,OAAO,EACP,WAAW,EACX,cAAc,EACd,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,KAAK,OAAO,EACb,MAAM,oBAAoB,CAAC;AAI5B,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,YAAY,QACiC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAEjE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;CAyBtB,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC,CAmBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,CAAC,CAkBH"}

package/dist/shared/telemetry.js

@@ -0,0 +1,137 @@
+/**
+ * OpenTelemetry instrumentation for distributed tracing and metrics.
+ *
+ * Provides tracer and meter factories that integrate with the OpenTelemetry
+ * SDK. When OTEL_EXPORTER_OTLP_ENDPOINT is set, telemetry is exported to
+ * the configured collector; otherwise, telemetry is a no-op.
+ *
+ * Usage:
+ *   // First, initialize the SDK at application startup (side-effect import):
+ *   import "@psavelis/enterprise-blockchain/shared/telemetry-sdk";
+ *
+ *   // Then import helpers from this module:
+ *   import { createTracer, createMeter } from "@psavelis/enterprise-blockchain/shared/telemetry";
+ *   const tracer = createTracer("my-service");
+ *   const meter = createMeter("my-service");
+ *
+ * NOTE: This module requires @opentelemetry/api as a peer dependency.
+ * It is NOT re-exported from the main shared index to preserve optional deps.
+ *
+ * Ref: OpenTelemetry Specification — https://opentelemetry.io/docs/specs/otel/
+ */
+import { trace, metrics, context, propagation, SpanStatusCode, } from "@opentelemetry/api";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+export { SpanStatusCode, context, propagation };
+/**
+ * Service name for telemetry, read from OTEL_SERVICE_NAME or defaulting
+ * to "enterprise-blockchain".
+ */
+export const SERVICE_NAME = process.env.OTEL_SERVICE_NAME ?? "enterprise-blockchain";
+/**
+ * Whether telemetry export is enabled (OTEL_EXPORTER_OTLP_ENDPOINT is set).
+ */
+export function isTelemetryEnabled() {
+    return Boolean(process.env.OTEL_EXPORTER_OTLP_ENDPOINT);
+}
+/**
+ * Create a tracer for distributed tracing.
+ *
+ * @param name - The name of the instrumentation scope (e.g., "fabric-gateway")
+ * @param version - Optional version string for the instrumentation
+ */
+export function createTracer(name, version) {
+    return trace.getTracer(name, version);
+}
+/**
+ * Create a meter for metrics collection.
+ *
+ * @param name - The name of the instrumentation scope (e.g., "circuit-breaker")
+ * @param version - Optional version string for the instrumentation
+ */
+export function createMeter(name, version) {
+    return metrics.getMeter(name, version);
+}
+/**
+ * Attribute keys for telemetry following OpenTelemetry semantic conventions.
+ */
+export const TelemetryAttributes = {
+    // Service attributes
+    SERVICE_NAME: ATTR_SERVICE_NAME,
+    // Retry attributes
+    RETRY_ATTEMPT: "retry.attempt",
+    RETRY_MAX_ATTEMPTS: "retry.max_attempts",
+    RETRY_ERROR_CODE: "retry.error_code",
+    RETRY_DELAY_MS: "retry.delay_ms",
+    // Circuit breaker attributes
+    CIRCUIT_BREAKER_STATE: "circuit_breaker.state",
+    CIRCUIT_BREAKER_FAILURES: "circuit_breaker.consecutive_failures",
+    CIRCUIT_BREAKER_COOLDOWN_MS: "circuit_breaker.cooldown_ms",
+    // Blockchain attributes
+    BLOCKCHAIN_PLATFORM: "blockchain.platform",
+    BLOCKCHAIN_CHANNEL: "blockchain.channel",
+    BLOCKCHAIN_CHAINCODE: "blockchain.chaincode",
+    BLOCKCHAIN_TX_ID: "blockchain.transaction_id",
+    BLOCKCHAIN_BLOCK_NUMBER: "blockchain.block_number",
+    // Error attributes
+    ERROR_TYPE: "error.type",
+    ERROR_MESSAGE: "error.message",
+};
+/**
+ * Helper to run a function within a new span.
+ *
+ * @param tracer - The tracer to use
+ * @param name - Span name
+ * @param fn - Function to execute within the span
+ * @param options - Optional span options
+ */
+export async function withSpan(tracer, name, fn, options) {
+    return tracer.startActiveSpan(name, options ?? {}, async (span) => {
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err instanceof Error ? err.message : String(err),
+            });
+            if (err instanceof Error) {
+                span.recordException(err);
+            }
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+/**
+ * Helper to run a synchronous function within a new span.
+ *
+ * @param tracer - The tracer to use
+ * @param name - Span name
+ * @param fn - Function to execute within the span
+ * @param options - Optional span options
+ */
+export function withSpanSync(tracer, name, fn, options) {
+    const span = tracer.startSpan(name, options);
+    try {
+        const result = fn(span);
+        span.setStatus({ code: SpanStatusCode.OK });
+        return result;
+    }
+    catch (err) {
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: err instanceof Error ? err.message : String(err),
+        });
+        if (err instanceof Error) {
+            span.recordException(err);
+        }
+        throw err;
+    }
+    finally {
+        span.end();
+    }
+}

package/dist/stark-settlement/application/aggregator-service.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Aggregator Service
+ *
+ * Orchestrates the tiered recursive STARK proof aggregation:
+ * - Tier-1: Aggregates 128 base proofs into a single Tier-1 proof
+ * - Tier-2: Aggregates 64 Tier-1 proofs into a final Block Proof
+ *
+ * The aggregator maintains idempotency keys through all tiers
+ * for exactly-once settlement semantics.
+ *
+ * @see domain/ports.ts for StarkProofGeneratorPort interface
+ */
+import type { BaseProof, Tier1Proof, Tier2BlockProof, AssetType, OutboxEntry, NetTransfer } from "../domain/entities.js";
+import type { SettlementContext } from "../index.js";
+/**
+ * Result of the aggregation process.
+ */
+export interface AggregationResult {
+    /** The generated block proof (null if not enough proofs) */
+    blockProof: Tier2BlockProof | null;
+    /** Number of base proofs processed */
+    baseProofsProcessed: number;
+    /** Number of Tier-1 proofs generated */
+    tier1ProofsGenerated: number;
+    /** Whether a block proof was generated */
+    blockGenerated: boolean;
+}
+/**
+ * Configuration for the aggregator service.
+ */
+export interface AggregatorConfig {
+    /** Number of base proofs per Tier-1 aggregation (default: 128) */
+    tier1BatchSize: number;
+    /** Number of Tier-1 proofs per Tier-2 block (default: 64) */
+    tier2BatchSize: number;
+}
+/**
+ * Aggregator service for recursive STARK proof composition.
+ */
+export declare class AggregatorService {
+    private readonly ctx;
+    private readonly config;
+    constructor(ctx: SettlementContext, config?: Partial<AggregatorConfig>);
+    /**
+     * Get the current batch sizes.
+     */
+    getBatchSizes(): {
+        tier1: number;
+        tier2: number;
+        totalTxsPerBlock: number;
+    };
+    /**
+     * Process available proofs through the aggregation pipeline.
+     *
+     * Attempts to:
+     * 1. Aggregate base proofs into Tier-1 proofs
+     * 2. Aggregate Tier-1 proofs into a Tier-2 block proof
+     *
+     * @returns Aggregation result with statistics
+     */
+    processAggregation(): Promise<AggregationResult>;
+    /**
+     * Aggregate base proofs into a Tier-1 proof.
+     */
+    aggregateTier1(baseProofs: readonly BaseProof[]): Promise<Tier1Proof>;
+    /**
+     * Aggregate Tier-1 proofs into a Tier-2 block proof.
+     */
+    aggregateTier2(tier1Proofs: readonly Tier1Proof[]): Promise<Tier2BlockProof>;
+    /**
+     * Process proofs until a block is generated or no more proofs are available.
+     *
+     * Convenience method for demo/testing - processes multiple batches.
+     */
+    processToBlockProof(): Promise<Tier2BlockProof | null>;
+    /**
+     * Create outbox entries for a block proof.
+     *
+     * Computes net transfers per asset type and creates outbox entries
+     * for settlement.
+     *
+     * @param blockProof - The block proof to create entries for
+     * @param netTransfersByAsset - Pre-computed net transfers by asset type
+     */
+    createOutboxEntries(blockProof: Tier2BlockProof, netTransfersByAsset: Map<AssetType, NetTransfer[]>): Promise<OutboxEntry[]>;
+    /**
+     * Compute net transfers from transaction history.
+     *
+     * Groups transactions by external address and computes the net
+     * amount change for each address.
+     */
+    computeNetTransfers(transactions: ReadonlyArray<{
+        type: "deposit" | "transfer" | "withdrawal";
+        fromAccountId: string | null;
+        toAccountId: string | null;
+        amount: bigint;
+    }>, accountAddresses: Map<string, string>): Map<string, bigint>;
+    /**
+     * Verify a block proof.
+     */
+    verifyBlockProof(blockProof: Tier2BlockProof): Promise<boolean>;
+    /**
+     * Get aggregation statistics.
+     */
+    getStats(): Promise<{
+        pendingBaseProofs: number;
+        pendingTier1Proofs: number;
+        latestBlockNumber: bigint | null;
+        totalTxsPerBlock: number;
+    }>;
+}
+//# sourceMappingURL=aggregator-service.d.ts.map

package/dist/stark-settlement/application/aggregator-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator-service.d.ts","sourceRoot":"","sources":["../../../src/stark-settlement/application/aggregator-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,SAAS,EACT,WAAW,EACX,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,sCAAsC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAGvB,GAAG,EAAE,iBAAiB,EACvC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAcpC;;OAEG;IACH,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAY3E;;;;;;;;OAQG;IACG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAoDtD;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAsC3E;;OAEG;IACG,cAAc,CAClB,WAAW,EAAE,SAAS,UAAU,EAAE,GACjC,OAAO,CAAC,eAAe,CAAC;IAiC3B;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAa5D;;;;;;;;OAQG;IACG,mBAAmB,CACvB,UAAU,EAAE,eAAe,EAC3B,mBAAmB,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,GACjD,OAAO,CAAC,WAAW,EAAE,CAAC;IAoCzB;;;;;OAKG;IACH,mBAAmB,CACjB,YAAY,EAAE,aAAa,CAAC;QAC1B,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;QAC5C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,EACF,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAiCtB;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CAgBH"}