@odatano/core 0.3.1

package/srv/blockchain/cardano-tx-builder.js

@@ -0,0 +1,232 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardanoTransactionBuilder = void 0;
+const cds_1 = __importDefault(require("@sap/cds"));
+const tx_builder_registry_1 = require("./transaction-building/tx-builder-registry");
+const logger = cds_1.default.log('CardanoTransactionBuilder');
+/**
+ * CardanoTransactionBuilder - High-level transaction builder that utilizes specific CardanoTxBuilder implementations
+ * to build various types of Cardano transactions.
+ */
+class CardanoTransactionBuilder {
+    client;
+    txBuilder;
+    initialized = false;
+    /**
+     * Create a new CardanoTransactionBuilder instance
+     * @param client - The CardanoClient instance for UTxO fetching
+     */
+    constructor(client) {
+        this.client = client;
+        logger.info('CardanoTransactionBuilder instance created');
+    }
+    /**
+     * Initialize the transaction builder
+     * @param protocolParams - Optional protocol parameters (if not provided, fetched from backend)
+     */
+    async init(protocolParams) {
+        if (this.initialized && this.txBuilder)
+            return;
+        // Create transaction builder from registry
+        this.txBuilder = tx_builder_registry_1.TxBuilderRegistry.createDefault();
+        await this.txBuilder.init(this.client, protocolParams);
+        this.initialized = true;
+        logger.info(`Initialized with builder: ${this.txBuilder.name}`);
+    }
+    /**
+     * Ensure the builder is initialized and return it (lazy init)
+     * @returns {Promise<CardanoTxBuilder>} initialized builder
+     * @throws {Error} if builder cannot be initialized
+     */
+    async ensureInitialized() {
+        if (!this.initialized || !this.txBuilder) {
+            await this.init();
+        }
+        if (!this.txBuilder) {
+            throw new Error('Transaction builder failed to initialize');
+        }
+        return this.txBuilder;
+    }
+    /**
+     * Reset the transaction builder (useful for testing)
+     */
+    reset() {
+        this.txBuilder = undefined;
+        this.initialized = false;
+        logger.debug(`Builder reset`);
+    }
+    /**
+     * Set the transaction builder directly (for testing)
+     * @param builder - The builder to set
+     */
+    setBuilder(builder) {
+        this.txBuilder = builder;
+        this.initialized = true;
+    }
+    /**
+     * Build a simple ADA transfer transaction
+     * @param req transaction build request
+     * @param protocolParameters current protocol parameters
+     * @returns {Promise<TxBuildResult>} transaction build result
+     */
+    async buildSimpleAdaTransaction(req, protocolParameters) {
+        const builder = await this.ensureInitialized();
+        // Prepare the transaction build context
+        const txContext = {
+            utxos: await this._fetchUtxosForAddress(req.senderAddress),
+            protocolParameters: protocolParameters
+        };
+        // Build the unsigned ADA transfer transaction
+        const txBuildResult = await builder.buildUnsignedAdaTransfer(req, txContext);
+        logger.info(`Built simple ADA transaction successfully.`);
+        // Return the transaction build result
+        return txBuildResult;
+    }
+    async buildTransactionWithMetadata(req, protocolParameters) {
+        const builder = await this.ensureInitialized();
+        // Prepare the transaction build context
+        const txContext = {
+            utxos: await this._fetchUtxosForAddress(req.senderAddress),
+            protocolParameters: protocolParameters
+        };
+        // Build the unsigned transaction with metadata
+        const txBuildResult = await builder.buildUnsignedTransactionWithMetadata(req, txContext);
+        logger.info(`Built transaction with metadata successfully.`);
+        // Return the transaction build result
+        return txBuildResult;
+    }
+    /**
+     * Build a multi-asset transaction
+     * @param req transaction build request
+     * @param protocolParameters current protocol parameters
+     * @returns {Promise<TxBuildResult>} transaction build result
+     */
+    async buildMultiAssetTransaction(req, protocolParameters) {
+        const builder = await this.ensureInitialized();
+        // Prepare the transaction build context
+        const utxos = await this._fetchUtxosForAddress(req.senderAddress);
+        logger.info(`Fetched ${utxos.length} UTxOs for multi-asset transaction`);
+        for (const u of utxos) {
+            logger.info(`UTxO ${u.txHash}:${u.outputIndex} amounts: ${JSON.stringify(u.amount)}`);
+        }
+        const txContext = {
+            utxos,
+            protocolParameters: protocolParameters
+        };
+        // Build the unsigned multi-asset transaction
+        const txBuildResult = await builder.buildUnsignedMultiAssetTransaction(req, txContext);
+        logger.info(`Built multi-asset transaction successfully.`);
+        // Return the transaction build result
+        return txBuildResult;
+    }
+    /**
+     * Build a minting transaction
+     * @param req transaction build request
+     * @param protocolParameters current protocol parameters
+     * @returns {Promise<TxBuildResult>} transaction build result
+     */
+    async buildMintTransaction(req, protocolParameters) {
+        // Validate mint-specific required fields
+        if (!req.mintActions || req.mintActions.length === 0) {
+            throw new Error('[CardanoTransactionBuilder] buildMintTransaction requires mintActions to be specified');
+        }
+        if (!req.mintingPolicyScript) {
+            throw new Error('[CardanoTransactionBuilder] buildMintTransaction requires mintingPolicyScript to be specified');
+        }
+        // Type is now narrowed to TxBuildMintRequest
+        const mintReq = req;
+        const builder = await this.ensureInitialized();
+        const cardanoClient = this.client;
+        // Prepare the transaction build context
+        const txContext = {
+            utxos: await this._fetchUtxosForAddress(req.senderAddress),
+            protocolParameters: protocolParameters,
+            // Pass evaluator if Ogmios is available for dynamic execution unit calculation
+            evaluateTransaction: cardanoClient.hasOgmiosBackend()
+                ? (cbor) => cardanoClient.evaluateTransaction(cbor)
+                : undefined
+        };
+        if (txContext.evaluateTransaction) {
+            logger.info(`Ogmios available - will use dynamic script evaluation`);
+        }
+        else {
+            logger.info(`Ogmios not available - using default execution units`);
+        }
+        // Build the unsigned minting transaction
+        const txBuildResult = await builder.buildUnsignedMintTransaction(mintReq, txContext);
+        logger.info(`Built minting transaction successfully.`);
+        // Return the transaction build result
+        return txBuildResult;
+    }
+    /**
+     * Build a Plutus spending transaction (consume UTxO at script address)
+     * @param req transaction build request
+     * @param protocolParameters current protocol parameters
+     * @returns {Promise<TxBuildResult>} transaction build result
+     */
+    async buildPlutusSpendTransaction(req, protocolParameters) {
+        if (!req.plutusScriptExecution) {
+            throw new Error('[CardanoTransactionBuilder] buildPlutusSpendTransaction requires plutusScriptExecution to be specified');
+        }
+        const spendReq = req;
+        const builder = await this.ensureInitialized();
+        const cardanoClient = this.client;
+        // Fetch sender UTxOs for fee payment
+        const senderUtxos = await this._fetchUtxosForAddress(req.senderAddress);
+        // Fetch the script UTxO separately (it's at the script address, not sender address)
+        // We include it in the UTxO set so the builder can find it
+        const scriptRef = spendReq.plutusScriptExecution.scriptUtxo;
+        const allUtxos = [...senderUtxos];
+        // Check if the script UTxO is already in sender UTxOs (unlikely but possible)
+        const alreadyIncluded = senderUtxos.some(u => u.txHash === scriptRef.txHash && u.outputIndex === scriptRef.outputIndex);
+        if (!alreadyIncluded) {
+            // Fetch script UTxO via transaction lookup - the backend needs to provide it
+            // For now, we create a minimal UTxO entry from what we know
+            // The actual UTxO data will be resolved by the backend during tx building
+            logger.info(`Script UTxO ${scriptRef.txHash}#${scriptRef.outputIndex} not in sender UTxOs - fetching from backend`);
+            const tx = await cardanoClient.getTransaction(scriptRef.txHash);
+            const scriptOutput = tx.outputs?.find(o => o.outputIndex === scriptRef.outputIndex);
+            if (!scriptOutput) {
+                throw new Error(`[CardanoTransactionBuilder] Script UTxO output ${scriptRef.txHash}#${scriptRef.outputIndex} not found in transaction`);
+            }
+            allUtxos.push({
+                txHash: scriptRef.txHash,
+                outputIndex: scriptRef.outputIndex,
+                address: scriptOutput.address,
+                amount: scriptOutput.amount,
+            });
+        }
+        const txContext = {
+            utxos: allUtxos,
+            protocolParameters: protocolParameters,
+            evaluateTransaction: cardanoClient.hasOgmiosBackend()
+                ? (cbor) => cardanoClient.evaluateTransaction(cbor)
+                : undefined
+        };
+        if (txContext.evaluateTransaction) {
+            logger.info(`Ogmios available - will use dynamic script evaluation`);
+        }
+        else {
+            logger.info(`Ogmios not available - using default execution units`);
+        }
+        const txBuildResult = await builder.buildUnsignedPlutusSpendTransaction(spendReq, txContext);
+        logger.info(`Built Plutus spending transaction successfully.`);
+        return txBuildResult;
+    }
+    /**
+     * Fetch UTxOs for a given address
+     * @param address bech32 address
+     * @returns {Promise<UTxO[]>} list of UTxOs
+     */
+    async _fetchUtxosForAddress(address) {
+        // fetch UTxOs directly using cardano client
+        logger.debug(`Fetching UTxOs for address: ${address}`);
+        const utxos = await this.client.getAddressUtxos(address);
+        return utxos;
+    }
+}
+exports.CardanoTransactionBuilder = CardanoTransactionBuilder;
+//# sourceMappingURL=cardano-tx-builder.js.map

package/srv/blockchain/cardano-tx-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardano-tx-builder.js","sourceRoot":"","sources":["cardano-tx-builder.ts"],"names":[],"mappings":"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"}

package/srv/blockchain/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["circuit-breaker.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;CACxB;AAeD;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAIlD;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAqB3C,6CAA6C;IAC7C,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAkBxC,yCAAyC;IACzC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAqBxC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;IAY3C,8CAA8C;IAC9C,KAAK,IAAI,IAAI;CAGd"}

package/srv/blockchain/circuit-breaker.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerManager = void 0;
+const cds_1 = __importDefault(require("@sap/cds"));
+const logger = cds_1.default.log('CircuitBreaker');
+const DEFAULT_CONFIG = {
+    failureThreshold: 5,
+    successThreshold: 2,
+    resetTimeoutMs: 30_000,
+};
+/**
+ * Circuit Breaker for backend failover.
+ * Tracks per-backend failure counts and prevents hammering unhealthy backends.
+ *
+ * States:
+ *   closed    → normal operation, requests pass through
+ *   open      → backend is unhealthy, requests are skipped
+ *   half-open → probe period, limited requests allowed to test recovery
+ */
+class CircuitBreakerManager {
+    circuits = new Map();
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Check if a backend should be attempted.
+     * Transitions open → half-open if reset timeout has elapsed.
+     */
+    shouldAttempt(backendName) {
+        const entry = this.circuits.get(backendName);
+        if (!entry)
+            return true; // no history = closed
+        if (entry.state === 'closed')
+            return true;
+        if (entry.state === 'open') {
+            const elapsed = Date.now() - entry.lastFailureTime;
+            if (elapsed >= this.config.resetTimeoutMs) {
+                entry.state = 'half-open';
+                entry.successes = 0;
+                logger.debug(`Circuit half-open for ${backendName} after ${elapsed}ms`);
+                return true;
+            }
+            return false;
+        }
+        // half-open: allow probe requests
+        return true;
+    }
+    /** Record a successful call to a backend. */
+    recordSuccess(backendName) {
+        const entry = this.circuits.get(backendName);
+        if (!entry)
+            return;
+        if (entry.state === 'half-open') {
+            entry.successes++;
+            if (entry.successes >= this.config.successThreshold) {
+                entry.state = 'closed';
+                entry.failures = 0;
+                entry.successes = 0;
+                logger.info(`Circuit closed for ${backendName} (recovered)`);
+            }
+        }
+        else if (entry.state === 'closed') {
+            // Reset failure count on success
+            entry.failures = 0;
+        }
+    }
+    /** Record a failed call to a backend. */
+    recordFailure(backendName) {
+        let entry = this.circuits.get(backendName);
+        if (!entry) {
+            entry = { state: 'closed', failures: 0, successes: 0, lastFailureTime: 0 };
+            this.circuits.set(backendName, entry);
+        }
+        entry.failures++;
+        entry.lastFailureTime = Date.now();
+        if (entry.state === 'half-open') {
+            // Any failure in half-open reopens the circuit
+            entry.state = 'open';
+            entry.successes = 0;
+            logger.warn(`Circuit re-opened for ${backendName} (failed during probe)`);
+        }
+        else if (entry.state === 'closed' && entry.failures >= this.config.failureThreshold) {
+            entry.state = 'open';
+            logger.warn(`Circuit opened for ${backendName} after ${entry.failures} failures`);
+        }
+    }
+    /** Get the current state of a backend's circuit. */
+    getState(backendName) {
+        const entry = this.circuits.get(backendName);
+        if (!entry)
+            return 'closed';
+        // Check for auto-transition to half-open
+        if (entry.state === 'open') {
+            const elapsed = Date.now() - entry.lastFailureTime;
+            if (elapsed >= this.config.resetTimeoutMs)
+                return 'half-open';
+        }
+        return entry.state;
+    }
+    /** Reset all circuit states (for testing). */
+    reset() {
+        this.circuits.clear();
+    }
+}
+exports.CircuitBreakerManager = CircuitBreakerManager;
+//# sourceMappingURL=circuit-breaker.js.map

package/srv/blockchain/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["circuit-breaker.ts"],"names":[],"mappings":"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"}

package/srv/blockchain/signing/external-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-signer.d.ts","sourceRoot":"","sources":["external-signer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EACL,kBAAkB,EAGlB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAS3B;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAK/C;;;;;;;;;;;;;OAaG;IACI,oBAAoB,CACzB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,cAAc,CAAC,EAAE,kBAAkB,CAAC;KACrC,GACA,uBAAuB;IAmC1B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAiBnC;;;;;;;;;;OAUG;IACI,uBAAuB,CAC5B,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACjF,2BAA2B;IAqC9B;;;;;;;OAOG;IACI,aAAa,CAClB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,GACxD,2BAA2B;IAY9B;;;;;;;;OAQG;IACI,mBAAmB,CAAC,cAAc,EAAE,uBAAuB,GAAG,oBAAoB;IAUzF;;;;;;OAMG;IACI,YAAY,CAAC,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,GAAG,oBAAoB;IAY5F;;;;;;OAMG;IACI,cAAc,CACnB,KAAK,EAAE,oBAAoB,EAC3B,kBAAkB,EAAE,2BAA2B,GAC9C,oBAAoB;IAgBvB;;;;;;OAMG;IACI,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB;IAYzF;;;;;;OAMG;IACI,YAAY,CAAC,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,GAAG,oBAAoB;IAY5F;;;;;OAKG;IACI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;;;;;;;;;OAYG;IACI,qBAAqB,CAC1B,OAAO,EAAE,eAAe,EACxB,uBAAuB,EAAE,MAAM,GAC9B,2BAA2B;IAiB9B;;OAEG;IACI,WAAW,IAAI,iBAAiB;CAGxC;AAKD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAK9D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,oBAAoB,CAEvB"}

package/srv/blockchain/signing/external-signer.js

@@ -0,0 +1,302 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalSignerModule = void 0;
+exports.getExternalSignerModule = getExternalSignerModule;
+exports.createExternalSignerModule = createExternalSignerModule;
+const cds_1 = __importDefault(require("@sap/cds"));
+const signature_verifier_1 = require("./signature-verifier");
+const errors_1 = require("../../utils/errors");
+const types_1 = require("../../utils/types");
+const logger = cds_1.default.log('ExternalSigner');
+/**
+ * Default TTL for signing requests (30 minutes)
+ */
+const DEFAULT_SIGNING_TTL_MS = 30 * 60 * 1000;
+/**
+ * ExternalSignerModule - Manages the external signing workflow
+ *
+ * This module orchestrates the complete flow:
+ * 1. Create signing request from build result
+ * 2. Export unsigned transaction for external signing
+ * 3. Receive and verify signed transaction
+ * 4. Prepare for submission
+ *
+ * Key security principles:
+ * - NO private keys are ever handled by this service
+ * - Signature verification ensures transaction integrity
+ * - Complete audit trail of the signing workflow
+ */
+class ExternalSignerModule {
+    verifier;
+    signingTtlMs;
+    constructor(options) {
+        this.verifier = (0, signature_verifier_1.getSignatureVerifier)();
+        this.signingTtlMs = options?.signingTtlMs ?? DEFAULT_SIGNING_TTL_MS;
+    }
+    /**
+     * Create an unsigned transaction export payload for external signing
+     *
+     * This is the entry point for the external signing workflow.
+     * Call this after building a transaction to get a standardized
+     * payload that external signers can use.
+     *
+     * @param buildId - The build ID from TransactionBuilds
+     * @param unsignedTxCbor - The unsigned transaction CBOR
+     * @param txBodyHash - The transaction body hash
+     * @param network - The Cardano network
+     * @param options - Additional options
+     * @returns Unsigned transaction export payload
+     */
+    createSigningRequest(buildId, unsignedTxCbor, txBodyHash, network, message, options) {
+        const signingRequestId = cds_1.default.utils.uuid();
+        const now = new Date();
+        const expiresAt = new Date(now.getTime() + this.signingTtlMs);
+        const signerTypeHint = options?.signerTypeHint ?? types_1.ExternalSignerType.CARDANO_CLI;
+        const payload = {
+            signingRequestId,
+            buildId,
+            txBodyHash,
+            unsignedTxCbor,
+            network,
+            createdAt: now.toISOString(),
+            expiresAt: expiresAt.toISOString(),
+            requiredSigners: options?.requiredSigners,
+            signingInstructions: this.generateSigningInstructions(unsignedTxCbor, network, message, signerTypeHint),
+        };
+        logger.info({
+            signingRequestId,
+            buildId,
+            txBodyHash,
+            network,
+            expiresAt: expiresAt.toISOString(),
+        }, 'Created signing request');
+        return payload;
+    }
+    /**
+     * Generate signing instructions for different signer types
+     */
+    generateSigningInstructions(unsignedTxCbor, network, message, signerTypeHint) {
+        return {
+            signerTypeHint,
+            message: message,
+            network,
+            cip30SigningRequest: {
+                txCbor: unsignedTxCbor,
+                partialSign: false,
+            },
+        };
+    }
+    /**
+     * Verify a signed transaction
+     *
+     * Call this after receiving a signed transaction from an external signer.
+     * This verifies the signature integrity before submission.
+     *
+     * @param signedTxCbor - The signed transaction CBOR
+     * @param expectedTxBodyHash - The expected transaction body hash (from the build)
+     * @param options - Additional verification options
+     * @returns Verification result
+     */
+    verifySignedTransaction(signedTxCbor, expectedTxBodyHash, options) {
+        logger.debug({ expectedTxBodyHash }, 'Verifying signed transaction');
+        // Enforce signing TTL if expiresAt is provided
+        if (options?.expiresAt && this.isExpired(options.expiresAt)) {
+            return {
+                isValid: false,
+                txBodyHash: '',
+                witnessCount: 0,
+                signerKeyHashes: [],
+                warnings: [],
+                errorMessage: 'Signing request has expired',
+            };
+        }
+        const result = this.verifier.verify(signedTxCbor, {
+            ...options,
+            expectedTxBodyHash,
+            requireSignature: true,
+        });
+        if (result.isValid) {
+            logger.info({
+                txBodyHash: result.txBodyHash,
+                witnessCount: result.witnessCount,
+                signers: result.signerKeyHashes,
+            }, 'Signature verification successful');
+        }
+        else {
+            logger.warn({
+                error: result.errorMessage,
+                warnings: result.warnings,
+            }, 'Signature verification failed');
+        }
+        return result;
+    }
+    /**
+     * Verify signed transaction and throw on failure
+     *
+     * @param signedTxCbor - The signed transaction CBOR
+     * @param expectedTxBodyHash - The expected transaction body hash
+     * @param options - Additional verification options
+     * @throws {TransactionValidationError} if verification fails
+     */
+    verifyOrThrow(signedTxCbor, expectedTxBodyHash, options) {
+        const result = this.verifySignedTransaction(signedTxCbor, expectedTxBodyHash, options);
+        if (!result.isValid) {
+            throw new errors_1.TransactionValidationError(result.errorMessage || 'Signature verification failed');
+        }
+        return result;
+    }
+    /**
+     * Create a complete signing workflow state
+     *
+     * This creates a trackable workflow state that can be stored
+     * and updated throughout the signing process.
+     *
+     * @param signingRequest - The unsigned transaction export payload
+     * @returns Initial workflow state
+     */
+    createWorkflowState(signingRequest) {
+        return {
+            status: types_1.SigningStatus.PENDING,
+            request: signingRequest,
+            timestamps: {
+                created: signingRequest.createdAt,
+            },
+        };
+    }
+    /**
+     * Update workflow state after signing
+     *
+     * @param state - Current workflow state
+     * @param signedTxCbor - The signed transaction CBOR
+     * @returns Updated workflow state
+     */
+    markAsSigned(state, signedTxCbor) {
+        return {
+            ...state,
+            status: types_1.SigningStatus.SIGNED,
+            signedTxCbor,
+            timestamps: {
+                ...state.timestamps,
+                signed: new Date().toISOString(),
+            },
+        };
+    }
+    /**
+     * Update workflow state after verification
+     *
+     * @param state - Current workflow state
+     * @param verificationResult - The verification result
+     * @returns Updated workflow state
+     */
+    markAsVerified(state, verificationResult) {
+        if (!verificationResult.isValid) {
+            return this.markAsFailed(state, String(verificationResult.errorMessage));
+        }
+        return {
+            ...state,
+            status: types_1.SigningStatus.VERIFIED,
+            verificationResult,
+            timestamps: {
+                ...state.timestamps,
+                verified: new Date().toISOString(),
+            },
+        };
+    }
+    /**
+     * Update workflow state after submission
+     *
+     * @param state - Current workflow state
+     * @param txHash - The submitted transaction hash
+     * @returns Updated workflow state
+     */
+    markAsSubmitted(state, txHash) {
+        return {
+            ...state,
+            status: types_1.SigningStatus.SUBMITTED,
+            txHash,
+            timestamps: {
+                ...state.timestamps,
+                submitted: new Date().toISOString(),
+            },
+        };
+    }
+    /**
+     * Update workflow state on failure
+     *
+     * @param state - Current workflow state
+     * @param errorMessage - The error message
+     * @returns Updated workflow state
+     */
+    markAsFailed(state, errorMessage) {
+        return {
+            ...state,
+            status: types_1.SigningStatus.FAILED,
+            errorMessage,
+            timestamps: {
+                ...state.timestamps,
+                failed: new Date().toISOString(),
+            },
+        };
+    }
+    /**
+     * Check if a signing request has expired
+     *
+     * @param expiresAt - The expiration timestamp (ISO 8601)
+     * @returns true if expired
+     */
+    isExpired(expiresAt) {
+        return new Date(expiresAt) < new Date();
+    }
+    /**
+     * Validate a signed transaction payload before submission
+     *
+     * This performs all pre-submission checks:
+     * 1. Verify the signature
+     * 2. Check transaction hasn't been tampered with
+     * 3. Ensure the build ID matches
+     *
+     * @param payload - The signed transaction payload
+     * @param originalBuildTxBodyHash - The original transaction body hash from the build
+     * @returns Validation result with verification details
+     * @throws {TransactionValidationError} if validation fails
+     */
+    validateForSubmission(payload, originalBuildTxBodyHash) {
+        // Verify the signature and transaction integrity
+        const result = this.verifyOrThrow(payload.signedTxCbor, originalBuildTxBodyHash);
+        logger.info({
+            signingRequestId: payload.signingRequestId,
+            buildId: payload.buildId,
+            signerType: payload.signerType,
+            witnessCount: result.witnessCount,
+        }, 'Transaction validated for submission');
+        return result;
+    }
+    /**
+     * Get the signature verifier instance
+     */
+    getVerifier() {
+        return this.verifier;
+    }
+}
+exports.ExternalSignerModule = ExternalSignerModule;
+// Singleton instance
+let moduleInstance = null;
+/**
+ * Get the singleton ExternalSignerModule instance
+ */
+function getExternalSignerModule() {
+    if (!moduleInstance) {
+        moduleInstance = new ExternalSignerModule();
+    }
+    return moduleInstance;
+}
+/**
+ * Create a new ExternalSignerModule instance with custom options
+ */
+function createExternalSignerModule(options) {
+    return new ExternalSignerModule(options);
+}
+//# sourceMappingURL=external-signer.js.map