@btc-vision/transaction 1.7.19 → 1.7.23

package/src/transaction/interfaces/IConsolidatedTransactionParameters.ts

@@ -0,0 +1,78 @@
+import { IInteractionParameters } from './ITransactionParameters.js';
+import { IP2WSHAddress } from '../mineable/IP2WSHAddress.js';
+
+/**
+ * Extended P2WSH address with hash commitments for CHCT system.
+ * Each output commits to multiple data chunk hashes (up to 98 chunks per output).
+ *
+ * Witness script structure:
+ * OP_HASH160 <hash_N> OP_EQUALVERIFY ... OP_HASH160 <hash_1> OP_EQUALVERIFY <pubkey> OP_CHECKSIG
+ *
+ * Witness stack when spending:
+ * [signature, data_1, data_2, ..., data_N, witnessScript]
+ */
+export interface IHashCommittedP2WSH extends IP2WSHAddress {
+    /** The HASH160 values of all data chunks this output commits to (in order) */
+    readonly dataHashes: Buffer[];
+    /** The actual data chunks (stored for later reveal, in order) */
+    readonly dataChunks: Buffer[];
+    /** The starting index of this output's chunks in the overall data sequence */
+    readonly chunkStartIndex: number;
+    /** The P2WSH scriptPubKey (OP_0 <32-byte-hash>) */
+    readonly scriptPubKey: Buffer;
+}
+
+/**
+ * Parameters for ConsolidatedInteractionTransaction.
+ * Uses the same parameters as InteractionTransaction plus optional maxChunkSize.
+ */
+export interface IConsolidatedInteractionParameters extends IInteractionParameters {
+    /** Maximum bytes per stack item (default: 80, policy limit) */
+    readonly maxChunkSize?: number;
+}
+
+/**
+ * Result from the setup transaction.
+ */
+export interface ISetupTransactionResult {
+    /** The signed transaction hex */
+    readonly txHex: string;
+    /** Transaction ID */
+    readonly txId: string;
+    /** All P2WSH outputs created (with metadata for reveal) */
+    readonly outputs: IHashCommittedP2WSH[];
+    /** Fees paid in satoshis */
+    readonly feesPaid: bigint;
+    /** Number of data chunks */
+    readonly chunkCount: number;
+    /** Total data size in bytes (compiled) */
+    readonly totalDataSize: number;
+}
+
+/**
+ * Result from the reveal transaction.
+ */
+export interface IRevealTransactionResult {
+    /** The signed transaction hex */
+    readonly txHex: string;
+    /** Transaction ID */
+    readonly txId: string;
+    /** Total data revealed in bytes */
+    readonly dataSize: number;
+    /** Fees paid in satoshis */
+    readonly feesPaid: bigint;
+    /** Number of inputs spent */
+    readonly inputCount: number;
+}
+
+/**
+ * Complete result from the consolidated interaction transaction.
+ */
+export interface IConsolidatedInteractionResult {
+    /** Setup transaction result */
+    readonly setup: ISetupTransactionResult;
+    /** Reveal transaction result */
+    readonly reveal: IRevealTransactionResult;
+    /** Total fees across both transactions in satoshis */
+    readonly totalFees: bigint;
+}

package/src/transaction/interfaces/ITransactionParameters.ts

@@ -3,6 +3,7 @@ import { ITweakedTransactionData } from '../shared/TweakedTransaction.js';
 import { ChainId } from '../../network/ChainId.js';
 import { PsbtOutputExtended } from '@btc-vision/bitcoin';
 import { ChallengeSolution } from '../../epoch/ChallengeSolution.js';
+import { AddressRotationConfig } from '../../signer/AddressRotation.js';
 
 export interface LoadedStorage {
     [key: string]: string[];
@@ -42,6 +43,13 @@ export interface ITransactionParameters extends ITweakedTransactionData {
     readonly gasSatFee: bigint;
 
     readonly compiledTargetScript?: Buffer | string;
+
+    /**
+     * Address rotation configuration.
+     * When enabled, allows different signers to sign different UTXOs based on their addresses.
+     * This supports proper Bitcoin privacy practices where each UTXO has its own key.
+     */
+    readonly addressRotation?: AddressRotationConfig;
 }
 
 export interface IFundingTransactionParameters extends ITransactionParameters {