@psavelis/enterprise-blockchain 0.1.0 → 1.1.1

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

@@ -0,0 +1,365 @@
+/**
+ * Domain Entities for Aggregated STARK Settlement Layer
+ *
+ * Core types representing the business domain:
+ * - Mirror accounts (custodial balances per asset/chain)
+ * - Ledger transactions (signed state transitions)
+ * - STARK proofs (3-tier recursive aggregation)
+ * - Outbox entries (pending settlements)
+ * - Settlement results (per-chain outcomes)
+ *
+ * All entities are immutable (readonly properties) following DDD patterns.
+ * No external SDK imports - pure domain types.
+ *
+ * @see skills/post-quantum-crypto.md for ML-DSA-65 signature context
+ * @see docs/adr/ADR-0001-hexagonal-architecture.md for design rationale
+ */
+/**
+ * Supported asset types for cross-chain settlement.
+ * Each asset type maps to a specific external chain or rail.
+ */
+export type AssetType = "SOL" | "BTC" | "USD";
+/**
+ * Asset configuration including decimal precision and chain-specific metadata.
+ */
+export interface AssetConfig {
+    readonly type: AssetType;
+    /** Decimal places for human-readable conversion (SOL=9, BTC=8, USD=2) */
+    readonly decimals: number;
+    /** Human-readable name */
+    readonly name: string;
+    /** Chain identifier for external settlement */
+    readonly chainId: string;
+}
+/**
+ * Standard asset configurations.
+ */
+export declare const ASSET_CONFIGS: Record<AssetType, AssetConfig>;
+/**
+ * Custodial mirror account representing an external address's balance
+ * within the ZKP ledger.
+ *
+ * Mirror accounts track:
+ * - Current balance (in atomic units)
+ * - Link to external chain address
+ * - Last STARK proof covering this account
+ */
+export interface MirrorAccount {
+    /** Unique account identifier (UUID v4) */
+    readonly id: string;
+    /** External chain address (Solana pubkey, BTC address, or fiat account) */
+    readonly externalAddress: string;
+    /** Asset type this account holds */
+    readonly assetType: AssetType;
+    /** Current balance in atomic units (lamports, satoshis, cents) */
+    readonly balance: bigint;
+    /** State root of the last STARK proof that included this account */
+    readonly lastProofRoot: string;
+    /** Account creation timestamp (Unix ms) */
+    readonly createdAt: number;
+    /** Last update timestamp (Unix ms) */
+    readonly updatedAt: number;
+    /** Whether this account is active (false = frozen) */
+    readonly isActive: boolean;
+    /** Optional metadata for compliance/audit */
+    readonly metadata: Readonly<Record<string, string>>;
+}
+/**
+ * Transaction types in the ZKP ledger.
+ */
+export type TransactionType = "deposit" | "transfer" | "withdrawal";
+/**
+ * Transaction status in the ledger lifecycle.
+ */
+export type TransactionStatus = "pending" | "proved" | "aggregated" | "finalized" | "settled" | "failed";
+/**
+ * A signed state transition in the ZKP ledger.
+ *
+ * Each transaction:
+ * - Is signed with ML-DSA-65 (post-quantum)
+ * - Has a unique idempotency key
+ * - Generates a base STARK proof upon acceptance
+ */
+export interface LedgerTransaction {
+    /** Unique transaction identifier (UUID v4) */
+    readonly txId: string;
+    /** Transaction type */
+    readonly type: TransactionType;
+    /** Source account ID (null for deposits) */
+    readonly fromAccountId: string | null;
+    /** Destination account ID (null for withdrawals) */
+    readonly toAccountId: string | null;
+    /** Asset type being transferred */
+    readonly assetType: AssetType;
+    /** Amount in atomic units */
+    readonly amount: bigint;
+    /** Unique idempotency key for exactly-once processing */
+    readonly idempotencyKey: string;
+    /** ML-DSA-65 signature over the transaction payload */
+    readonly mlDsaSignature: Uint8Array;
+    /** SHA-256 hash of the signer's ML-DSA-65 public key */
+    readonly mlDsaPublicKeyHash: string;
+    /** Current transaction status */
+    readonly status: TransactionStatus;
+    /** Optional metadata (beneficiary info, reference, etc.) */
+    readonly metadata: Readonly<Record<string, string>>;
+    /** Transaction creation timestamp (Unix ms) */
+    readonly createdAt: number;
+    /** Last status update timestamp (Unix ms) */
+    readonly updatedAt: number;
+}
+/**
+ * Payload structure that is signed by ML-DSA-65.
+ * This is the canonical form for signature verification.
+ */
+export interface TransactionPayload {
+    readonly txId: string;
+    readonly type: TransactionType;
+    readonly fromAccountId: string | null;
+    readonly toAccountId: string | null;
+    readonly assetType: AssetType;
+    readonly amount: string;
+    readonly idempotencyKey: string;
+    readonly createdAt: number;
+}
+/**
+ * Base proof for a single transaction.
+ *
+ * Generated by the STARK proof generator for each ledger transaction.
+ * Contains the proof that a valid state transition occurred.
+ */
+export interface BaseProof {
+    /** Unique proof identifier (UUID v4) */
+    readonly proofId: string;
+    /** Transaction ID this proof covers */
+    readonly txId: string;
+    /** Raw STARK proof bytes */
+    readonly starkProof: Uint8Array;
+    /** Public inputs as field element hex strings */
+    readonly publicInputs: readonly string[];
+    /** Hash of the verification key used */
+    readonly verificationKeyHash: string;
+    /** Pre-state commitment (Merkle root before transition) */
+    readonly preStateRoot: string;
+    /** Post-state commitment (Merkle root after transition) */
+    readonly postStateRoot: string;
+    /** Proof generation timestamp (Unix ms) */
+    readonly createdAt: number;
+}
+/**
+ * Tier-1 aggregated proof combining 128 base proofs.
+ *
+ * Uses recursive STARK verification to prove that all 128 base proofs
+ * are valid within a single succinct proof.
+ */
+export interface Tier1Proof {
+    /** Unique proof identifier (UUID v4) */
+    readonly proofId: string;
+    /** IDs of the 128 base proofs aggregated */
+    readonly baseProofIds: readonly string[];
+    /** Aggregated STARK proof bytes */
+    readonly aggregatedProof: Uint8Array;
+    /** Public inputs for the aggregated proof */
+    readonly publicInputs: readonly string[];
+    /** Idempotency keys propagated from all base transactions */
+    readonly idempotencyKeys: readonly string[];
+    /** Combined pre-state root (first transaction's pre-state) */
+    readonly preStateRoot: string;
+    /** Combined post-state root (last transaction's post-state) */
+    readonly postStateRoot: string;
+    /** Number of transactions covered (128) */
+    readonly txCount: number;
+    /** Proof generation timestamp (Unix ms) */
+    readonly createdAt: number;
+}
+/**
+ * Tier-2 block proof combining 64 Tier-1 proofs.
+ *
+ * Final proof representing up to 8,192 transactions (128 * 64).
+ * This is what gets settled to external chains.
+ */
+export interface Tier2BlockProof {
+    /** Unique block proof identifier (UUID v4) */
+    readonly blockProofId: string;
+    /** IDs of the 64 Tier-1 proofs aggregated */
+    readonly tier1ProofIds: readonly string[];
+    /** Final STARK proof bytes */
+    readonly finalProof: Uint8Array;
+    /** Public inputs for the block proof */
+    readonly publicInputs: readonly string[];
+    /** Final state root after all transactions */
+    readonly stateRoot: string;
+    /** All idempotency keys (for exactly-once settlement) */
+    readonly idempotencyKeys: readonly string[];
+    /** Total transaction count (up to 8192) */
+    readonly txCount: number;
+    /** Block sequence number (monotonically increasing) */
+    readonly blockNumber: bigint;
+    /** Proof generation timestamp (Unix ms) */
+    readonly createdAt: number;
+}
+/**
+ * Status of an outbox entry in the settlement pipeline.
+ */
+export type OutboxEntryStatus = "pending" | "processing" | "settled" | "failed";
+/**
+ * An entry in the settlement outbox queue.
+ *
+ * Created after a Tier-2 block proof is generated.
+ * One entry per asset type per block proof.
+ */
+export interface OutboxEntry {
+    /** Unique entry identifier (UUID v4) */
+    readonly entryId: string;
+    /** Block proof this entry settles */
+    readonly blockProofId: string;
+    /** Asset type for this settlement */
+    readonly assetType: AssetType;
+    /** Net transfers to execute (computed from block transactions) */
+    readonly netTransfers: readonly NetTransfer[];
+    /** Current settlement status */
+    readonly status: OutboxEntryStatus;
+    /** Number of retry attempts */
+    readonly retryCount: number;
+    /** Maximum retries before marking as failed */
+    readonly maxRetries: number;
+    /** Entry creation timestamp (Unix ms) */
+    readonly createdAt: number;
+    /** Settlement completion timestamp (Unix ms, null if not settled) */
+    readonly settledAt: number | null;
+    /** External settlement transaction ID (null if not settled) */
+    readonly settlementTxId: string | null;
+    /** Error message if failed */
+    readonly errorMessage: string | null;
+    /** Outbox offset for exactly-once consumption */
+    readonly offset: bigint;
+}
+/**
+ * A net transfer to an external address.
+ *
+ * Computed by netting all transactions in a block for a given address.
+ * Positive amount = credit, negative = debit.
+ */
+export interface NetTransfer {
+    /** External address to transfer to/from */
+    readonly externalAddress: string;
+    /** Net amount (positive = credit, negative = debit) */
+    readonly netAmount: bigint;
+}
+/**
+ * Result of a Solana settlement transaction.
+ */
+export interface SolanaSettlementResult {
+    /** Transaction signature (base58) */
+    readonly signature: string;
+    /** Slot number where transaction was confirmed */
+    readonly slot: number;
+    /** Address Lookup Table used for compression */
+    readonly lookupTableAddress: string;
+    /** Compute units consumed */
+    readonly computeUnits: number;
+    /** Fee paid (lamports) */
+    readonly fee: bigint;
+    /** Block proof commitment included in memo */
+    readonly proofCommitment: string;
+}
+/**
+ * Result of a Bitcoin settlement transaction.
+ */
+export interface BitcoinSettlementResult {
+    /** Transaction ID (hex) */
+    readonly txid: string;
+    /** Signed PSBT (base64) for audit */
+    readonly psbtBase64: string;
+    /** UTXOs spent in this transaction */
+    readonly utxosSpent: readonly string[];
+    /** Total fee paid (satoshis) */
+    readonly fee: bigint;
+    /** OP_RETURN data with proof commitment */
+    readonly opReturnData: string;
+    /** Number of confirmations (at query time) */
+    readonly confirmations: number;
+}
+/**
+ * Result of a fiat settlement (mock ISO 20022).
+ */
+export interface FiatSettlementResult {
+    /** ISO 20022 message ID */
+    readonly iso20022MessageId: string;
+    /** pain.001 credit transfer XML */
+    readonly pain001Xml: string;
+    /** Settlement date (ISO 8601) */
+    readonly settlementDate: string;
+    /** Total amount (cents) */
+    readonly totalAmount: bigint;
+    /** Number of transactions in batch */
+    readonly transactionCount: number;
+}
+/**
+ * An inbound deposit detected on an external chain.
+ */
+export interface DepositEvent {
+    /** Unique event identifier */
+    readonly eventId: string;
+    /** Asset type */
+    readonly assetType: AssetType;
+    /** External address that received the deposit */
+    readonly externalAddress: string;
+    /** Amount deposited (atomic units) */
+    readonly amount: bigint;
+    /** External transaction ID */
+    readonly externalTxId: string;
+    /** Number of confirmations */
+    readonly confirmations: number;
+    /** Event detection timestamp (Unix ms) */
+    readonly detectedAt: number;
+    /** Whether this deposit has been mirrored to the ledger */
+    readonly mirrored: boolean;
+}
+/**
+ * Raft node state for HA cluster.
+ */
+export type RaftState = "follower" | "candidate" | "leader";
+/**
+ * Raft cluster node information.
+ */
+export interface RaftNode {
+    /** Node identifier */
+    readonly nodeId: string;
+    /** Node state */
+    readonly state: RaftState;
+    /** Current term */
+    readonly term: bigint;
+    /** Voted for in current term (null if not voted) */
+    readonly votedFor: string | null;
+    /** Last log index */
+    readonly lastLogIndex: bigint;
+    /** Commit index */
+    readonly commitIndex: bigint;
+    /** Last heartbeat timestamp (Unix ms) */
+    readonly lastHeartbeat: number;
+}
+/**
+ * Audit record for compliance reporting.
+ */
+export interface AuditRecord {
+    /** Unique record identifier */
+    readonly recordId: string;
+    /** Event type */
+    readonly eventType: "transaction_submitted" | "proof_generated" | "proof_aggregated" | "settlement_initiated" | "settlement_confirmed" | "settlement_failed";
+    /** Related entity ID (txId, proofId, entryId) */
+    readonly entityId: string;
+    /** Entity type */
+    readonly entityType: "transaction" | "base_proof" | "tier1_proof" | "tier2_proof" | "outbox_entry";
+    /** Actor who triggered the event (public key hash) */
+    readonly actor: string;
+    /** Event timestamp (Unix ms) */
+    readonly timestamp: number;
+    /** Additional event data */
+    readonly data: Readonly<Record<string, unknown>>;
+    /** SHA-256 hash of the previous audit record (chain integrity) */
+    readonly previousHash: string;
+    /** SHA-256 hash of this record */
+    readonly recordHash: string;
+}
+//# sourceMappingURL=entities.d.ts.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Domain Entities for Aggregated STARK Settlement Layer
+ *
+ * Core types representing the business domain:
+ * - Mirror accounts (custodial balances per asset/chain)
+ * - Ledger transactions (signed state transitions)
+ * - STARK proofs (3-tier recursive aggregation)
+ * - Outbox entries (pending settlements)
+ * - Settlement results (per-chain outcomes)
+ *
+ * All entities are immutable (readonly properties) following DDD patterns.
+ * No external SDK imports - pure domain types.
+ *
+ * @see skills/post-quantum-crypto.md for ML-DSA-65 signature context
+ * @see docs/adr/ADR-0001-hexagonal-architecture.md for design rationale
+ */
+/**
+ * Standard asset configurations.
+ */
+export const ASSET_CONFIGS = {
+    SOL: { type: "SOL", decimals: 9, name: "Solana", chainId: "solana-devnet" },
+    BTC: {
+        type: "BTC",
+        decimals: 8,
+        name: "Bitcoin",
+        chainId: "bitcoin-testnet",
+    },
+    USD: { type: "USD", decimals: 2, name: "US Dollar", chainId: "fiat-mock" },
+};