@psavelis/enterprise-blockchain 0.1.0 → 1.1.1

package/dist/stark-settlement/domain/ports.d.ts

@@ -0,0 +1,485 @@
+/**
+ * Port Interfaces for Aggregated STARK Settlement Layer (Hexagonal Architecture)
+ *
+ * Ports define the boundaries of the domain:
+ * - Input ports: How the application receives requests
+ * - Output ports: How the application interacts with external systems
+ *
+ * All ports are pure interfaces with no implementation details.
+ * Adapters in the infrastructure layer implement these ports.
+ *
+ * @see modules/p2mr/src/ports.ts for similar hexagonal pattern
+ * @see docs/adr/ADR-0001-hexagonal-architecture.md
+ */
+import type { AssetType, MirrorAccount, LedgerTransaction, TransactionPayload, BaseProof, Tier1Proof, Tier2BlockProof, OutboxEntry, NetTransfer, SolanaSettlementResult, BitcoinSettlementResult, FiatSettlementResult, DepositEvent, AuditRecord, RaftNode } from "./entities.js";
+/**
+ * Port for STARK proof generation and verification.
+ *
+ * Implementations:
+ * - StarknetProofAdapter: Real proof generation via starknet.js
+ * - MockProofAdapter: Simulated proofs for testing
+ */
+export interface StarkProofGeneratorPort {
+    /**
+     * Generate a base proof for a single transaction.
+     *
+     * @param tx - The ledger transaction to prove
+     * @param preStateRoot - State root before the transaction
+     * @param postStateRoot - State root after the transaction
+     * @returns Base proof with STARK data and public inputs
+     */
+    generateBaseProof(tx: LedgerTransaction, preStateRoot: string, postStateRoot: string): Promise<BaseProof>;
+    /**
+     * Aggregate 128 base proofs into a Tier-1 proof using recursive verification.
+     *
+     * @param baseProofs - Exactly 128 base proofs to aggregate
+     * @returns Aggregated Tier-1 proof
+     * @throws If baseProofs.length !== 128
+     */
+    aggregateTier1(baseProofs: readonly BaseProof[]): Promise<Tier1Proof>;
+    /**
+     * Aggregate 64 Tier-1 proofs into a final Tier-2 block proof.
+     *
+     * @param tier1Proofs - Exactly 64 Tier-1 proofs to aggregate
+     * @returns Final block proof ready for settlement
+     * @throws If tier1Proofs.length !== 64
+     */
+    aggregateTier2(tier1Proofs: readonly Tier1Proof[]): Promise<Tier2BlockProof>;
+    /**
+     * Verify a Tier-2 block proof off-chain.
+     *
+     * @param blockProof - The block proof to verify
+     * @returns true if proof is valid
+     */
+    verifyBlockProof(blockProof: Tier2BlockProof): Promise<boolean>;
+    /**
+     * Get the verification key hash for the current proof system.
+     */
+    getVerificationKeyHash(): Promise<string>;
+}
+/**
+ * Port for ledger state persistence.
+ *
+ * Implementations:
+ * - InMemoryLedgerStore: For testing and demos
+ * - PostgresLedgerStore: For production (future)
+ */
+export interface LedgerPersistencePort {
+    /**
+     * Create a new mirror account.
+     */
+    createAccount(account: MirrorAccount): Promise<void>;
+    /**
+     * Get an account by ID.
+     */
+    getAccount(accountId: string): Promise<MirrorAccount | null>;
+    /**
+     * Get an account by external address and asset type.
+     */
+    getAccountByAddress(externalAddress: string, assetType: AssetType): Promise<MirrorAccount | null>;
+    /**
+     * Update an account's balance.
+     *
+     * @param accountId - Account to update
+     * @param delta - Amount to add (positive) or subtract (negative)
+     * @param newProofRoot - Updated proof root
+     */
+    updateAccountBalance(accountId: string, delta: bigint, newProofRoot: string): Promise<void>;
+    /**
+     * Get all accounts for an asset type.
+     */
+    getAccountsByAssetType(assetType: AssetType): Promise<readonly MirrorAccount[]>;
+    /**
+     * Append a transaction to the ledger (append-only).
+     */
+    appendTransaction(tx: LedgerTransaction): Promise<void>;
+    /**
+     * Get a transaction by ID.
+     */
+    getTransaction(txId: string): Promise<LedgerTransaction | null>;
+    /**
+     * Get transactions by idempotency key (for duplicate detection).
+     */
+    getTransactionsByIdempotencyKey(idempotencyKey: string): Promise<readonly LedgerTransaction[]>;
+    /**
+     * Get pending transactions (not yet proved).
+     */
+    getPendingTransactions(limit: number): Promise<readonly LedgerTransaction[]>;
+    /**
+     * Update transaction status.
+     */
+    updateTransactionStatus(txId: string, status: LedgerTransaction["status"]): Promise<void>;
+    /**
+     * Save a base proof.
+     */
+    saveBaseProof(proof: BaseProof): Promise<void>;
+    /**
+     * Get a base proof by ID.
+     */
+    getBaseProof(proofId: string): Promise<BaseProof | null>;
+    /**
+     * Get base proofs that haven't been aggregated into Tier-1.
+     */
+    getUnaggregatedBaseProofs(limit: number): Promise<readonly BaseProof[]>;
+    /**
+     * Save a Tier-1 proof.
+     */
+    saveTier1Proof(proof: Tier1Proof): Promise<void>;
+    /**
+     * Get a Tier-1 proof by ID.
+     */
+    getTier1Proof(proofId: string): Promise<Tier1Proof | null>;
+    /**
+     * Get Tier-1 proofs that haven't been aggregated into Tier-2.
+     */
+    getUnaggregatedTier1Proofs(limit: number): Promise<readonly Tier1Proof[]>;
+    /**
+     * Save a Tier-2 block proof.
+     */
+    saveTier2Proof(proof: Tier2BlockProof): Promise<void>;
+    /**
+     * Get a Tier-2 proof by ID.
+     */
+    getTier2Proof(blockProofId: string): Promise<Tier2BlockProof | null>;
+    /**
+     * Get the latest block proof.
+     */
+    getLatestBlockProof(): Promise<Tier2BlockProof | null>;
+}
+/**
+ * Port for the settlement outbox queue.
+ *
+ * Implements append-only queue with exactly-once consumption semantics.
+ */
+export interface OutboxPort {
+    /**
+     * Append an entry to the outbox.
+     * Returns the stored entry with the assigned sequential offset.
+     */
+    appendEntry(entry: OutboxEntry): Promise<OutboxEntry>;
+    /**
+     * Get pending entries for an asset type.
+     */
+    getPendingEntries(assetType: AssetType, limit: number): Promise<readonly OutboxEntry[]>;
+    /**
+     * Get an entry by ID.
+     */
+    getEntry(entryId: string): Promise<OutboxEntry | null>;
+    /**
+     * Mark an entry as processing (in-flight).
+     */
+    markProcessing(entryId: string): Promise<void>;
+    /**
+     * Mark an entry as settled.
+     */
+    markSettled(entryId: string, settlementTxId: string): Promise<void>;
+    /**
+     * Mark an entry as failed.
+     */
+    markFailed(entryId: string, errorMessage: string): Promise<void>;
+    /**
+     * Get entries that need retry (failed but under max retries).
+     */
+    getRetryableEntries(assetType: AssetType, limit: number): Promise<readonly OutboxEntry[]>;
+}
+/**
+ * Port for tracking consumer offsets in the outbox.
+ *
+ * Enables exactly-once processing by tracking the last processed offset.
+ */
+export interface OffsetTrackingPort {
+    /**
+     * Get the current offset for a consumer.
+     */
+    getOffset(consumerId: string, assetType: AssetType): Promise<bigint>;
+    /**
+     * Commit a new offset (atomically).
+     */
+    commitOffset(consumerId: string, assetType: AssetType, offset: bigint): Promise<void>;
+    /**
+     * Get all consumer offsets for an asset type.
+     */
+    getConsumerOffsets(assetType: AssetType): Promise<ReadonlyMap<string, bigint>>;
+}
+/**
+ * Port for Solana settlement operations.
+ */
+export interface SolanaSettlementPort {
+    /**
+     * Execute a batched transfer using VersionedTransaction with lookup tables.
+     *
+     * @param transfers - Net transfers to execute
+     * @param blockProof - Block proof for commitment
+     * @returns Settlement result with signature
+     */
+    executeBatchedTransfer(transfers: readonly NetTransfer[], blockProof: Tier2BlockProof): Promise<SolanaSettlementResult>;
+    /**
+     * Subscribe to deposit events on specified addresses.
+     */
+    subscribeDeposits(addresses: readonly string[], callback: (deposit: DepositEvent) => void): Promise<{
+        unsubscribe: () => void;
+    }>;
+    /**
+     * Get the current slot for health checks.
+     */
+    getHealth(): Promise<{
+        healthy: boolean;
+        slot: number;
+    }>;
+    /**
+     * Get or create an address lookup table for batch optimization.
+     */
+    getOrCreateLookupTable(addresses: readonly string[]): Promise<string>;
+}
+/**
+ * Port for Bitcoin settlement operations.
+ */
+export interface BitcoinSettlementPort {
+    /**
+     * Execute a batched UTXO spend using PSBT.
+     *
+     * @param transfers - Net transfers to execute
+     * @param blockProof - Block proof for OP_RETURN commitment
+     * @returns Settlement result with txid
+     */
+    executeBatchedSpend(transfers: readonly NetTransfer[], blockProof: Tier2BlockProof): Promise<BitcoinSettlementResult>;
+    /**
+     * Watch addresses for incoming deposits.
+     */
+    watchAddresses(addresses: readonly string[], callback: (deposit: DepositEvent) => void): Promise<{
+        unwatch: () => void;
+    }>;
+    /**
+     * Get the current block height for health checks.
+     */
+    getHealth(): Promise<{
+        healthy: boolean;
+        blockHeight: number;
+    }>;
+    /**
+     * Get UTXOs for an address.
+     */
+    getUtxos(address: string): Promise<readonly {
+        txid: string;
+        vout: number;
+        value: bigint;
+        confirmed: boolean;
+    }[]>;
+}
+/**
+ * Port for fiat settlement operations (mock ISO 20022).
+ */
+export interface FiatSettlementPort {
+    /**
+     * Execute a credit transfer via ISO 20022 pain.001.
+     *
+     * @param transfers - Net transfers to execute
+     * @param blockProof - Block proof for remittance info
+     * @returns Settlement result with message ID
+     */
+    executeTransfer(transfers: readonly NetTransfer[], blockProof: Tier2BlockProof): Promise<FiatSettlementResult>;
+    /**
+     * Get the health status of the fiat rail.
+     */
+    getHealth(): Promise<{
+        healthy: boolean;
+    }>;
+}
+/**
+ * Port for bidirectional gRPC streaming of outbox entries.
+ */
+export interface OutboxListenerPort {
+    /**
+     * Start streaming outbox entries for an asset type.
+     *
+     * @param assetType - Asset type to stream
+     * @param onEntry - Callback for each entry
+     * @param onError - Error callback
+     * @returns Control object to stop streaming
+     */
+    startStreaming(assetType: AssetType, onEntry: (entry: OutboxEntry) => Promise<void>, onError: (error: Error) => void): Promise<{
+        stop: () => void;
+    }>;
+    /**
+     * Acknowledge processing of an entry (commits offset).
+     */
+    acknowledge(entryId: string, offset: bigint): Promise<void>;
+}
+/**
+ * Port for ML-DSA-65 (Dilithium) signing operations.
+ *
+ * Reuses the existing MPC module's ML-DSA implementation.
+ */
+export interface DilithiumSigningPort {
+    /**
+     * Generate an ML-DSA-65 keypair.
+     */
+    generateKeyPair(): {
+        publicKey: Uint8Array;
+        secretKey: Uint8Array;
+    };
+    /**
+     * Sign a message with ML-DSA-65.
+     */
+    sign(message: Uint8Array, secretKey: Uint8Array): Uint8Array;
+    /**
+     * Verify an ML-DSA-65 signature.
+     */
+    verify(message: Uint8Array, signature: Uint8Array, publicKey: Uint8Array): boolean;
+    /**
+     * Get the SHA-256 hash of a public key.
+     */
+    hashPublicKey(publicKey: Uint8Array): string;
+}
+/**
+ * Port for signing transaction payloads.
+ *
+ * Combines serialization and ML-DSA signing.
+ */
+export interface TransactionSigningPort {
+    /**
+     * Sign a transaction payload.
+     *
+     * @param payload - Transaction payload to sign
+     * @param secretKey - ML-DSA-65 secret key
+     * @returns Signature bytes
+     */
+    signPayload(payload: TransactionPayload, secretKey: Uint8Array): Uint8Array;
+    /**
+     * Verify a transaction signature.
+     *
+     * @param payload - Original payload
+     * @param signature - Signature to verify
+     * @param publicKey - Signer's public key
+     * @returns true if valid
+     */
+    verifyPayload(payload: TransactionPayload, signature: Uint8Array, publicKey: Uint8Array): boolean;
+    /**
+     * Serialize a payload to canonical bytes for signing.
+     */
+    serializePayload(payload: TransactionPayload): Uint8Array;
+}
+/**
+ * Port for audit logging (compliance).
+ */
+export interface AuditPort {
+    /**
+     * Append an audit record.
+     */
+    append(record: Omit<AuditRecord, "recordId" | "previousHash" | "recordHash">): Promise<AuditRecord>;
+    /**
+     * Get audit records for an entity.
+     */
+    getRecordsForEntity(entityId: string): Promise<readonly AuditRecord[]>;
+    /**
+     * Verify the integrity of the audit chain.
+     */
+    verifyChainIntegrity(): Promise<{
+        valid: boolean;
+        lastValidRecord: string | null;
+        errorMessage: string | null;
+    }>;
+    /**
+     * Get the latest audit record.
+     */
+    getLatestRecord(): Promise<AuditRecord | null>;
+}
+/**
+ * Port for Raft consensus operations (HA cluster).
+ */
+export interface RaftPort {
+    /**
+     * Get the current node state.
+     */
+    getNodeState(): Promise<RaftNode>;
+    /**
+     * Check if this node is the leader.
+     */
+    isLeader(): Promise<boolean>;
+    /**
+     * Get the current leader ID (null if no leader).
+     */
+    getLeaderId(): Promise<string | null>;
+    /**
+     * Propose a value to the cluster (must be leader).
+     */
+    propose<T>(value: T): Promise<{
+        accepted: boolean;
+        term: bigint;
+    }>;
+    /**
+     * Wait for leadership (blocks until this node becomes leader).
+     */
+    waitForLeadership(timeoutMs: number): Promise<boolean>;
+}
+/**
+ * Port for time operations (enables deterministic testing).
+ */
+export interface ClockPort {
+    /**
+     * Get the current timestamp in milliseconds.
+     */
+    now(): number;
+    /**
+     * Generate a UUID v4.
+     */
+    uuid(): string;
+}
+/**
+ * Domain events emitted by the settlement layer.
+ */
+export type SettlementEvent = {
+    type: "transaction:submitted";
+    tx: LedgerTransaction;
+} | {
+    type: "proof:base:generated";
+    proof: BaseProof;
+} | {
+    type: "proof:tier1:generated";
+    proof: Tier1Proof;
+} | {
+    type: "proof:tier2:generated";
+    proof: Tier2BlockProof;
+} | {
+    type: "settlement:initiated";
+    entry: OutboxEntry;
+} | {
+    type: "settlement:completed";
+    entry: OutboxEntry;
+    result: SolanaSettlementResult | BitcoinSettlementResult | FiatSettlementResult;
+} | {
+    type: "settlement:failed";
+    entry: OutboxEntry;
+    error: string;
+} | {
+    type: "deposit:detected";
+    event: DepositEvent;
+} | {
+    type: "deposit:mirrored";
+    event: DepositEvent;
+    tx: LedgerTransaction;
+};
+/**
+ * Port for domain event emission (observable pattern).
+ */
+export interface EventEmitterPort {
+    /**
+     * Emit a domain event.
+     */
+    emit(event: SettlementEvent): void;
+    /**
+     * Subscribe to domain events.
+     */
+    subscribe(handler: (event: SettlementEvent) => void): {
+        unsubscribe: () => void;
+    };
+    /**
+     * Subscribe to a specific event type.
+     */
+    on<T extends SettlementEvent["type"]>(eventType: T, handler: (event: Extract<SettlementEvent, {
+        type: T;
+    }>) => void): {
+        unsubscribe: () => void;
+    };
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/stark-settlement/domain/ports.d.ts.map

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

package/dist/stark-settlement/domain/ports.js

@@ -0,0 +1,14 @@
+/**
+ * Port Interfaces for Aggregated STARK Settlement Layer (Hexagonal Architecture)
+ *
+ * Ports define the boundaries of the domain:
+ * - Input ports: How the application receives requests
+ * - Output ports: How the application interacts with external systems
+ *
+ * All ports are pure interfaces with no implementation details.
+ * Adapters in the infrastructure layer implement these ports.
+ *
+ * @see modules/p2mr/src/ports.ts for similar hexagonal pattern
+ * @see docs/adr/ADR-0001-hexagonal-architecture.md
+ */
+export {};