@btc-vision/transaction 1.8.0-beta.1 → 1.8.0-beta.4

package/browser/transaction/interfaces/Tap.d.ts

@@ -1,8 +1,8 @@
-import { PsbtInput as _PsbtInput, PsbtInputUpdate as _PsbtInputUpdate, PsbtOutput as _PsbtOutput, TapBip32Derivation as _TapBip32Derivation, TapInternalKey as _TapInternalKey, TapKeySig as _TapKeySig, TapLeaf as _TapLeaf, TapLeafScript as _TapLeafScript, TapMerkleRoot as _TapMerkleRoot, TapScriptSig as _TapScriptSig, TapTree as _TapTree } from '../../../node_modules/@btc-vision/bitcoin/build/index.js';
+import { PsbtInput as _PsbtInput, PsbtInputUpdate as _PsbtInputUpdate, PsbtOutput as _PsbtOutput, TapBip32Derivation as _TapBip32Derivation, TapInternalKey as _TapInternalKey, TapKeySig as _TapKeySig, TapLeaf as _TapLeaf, TapLeafScript as _TapLeafScript, TapMerkleRoot as _TapMerkleRoot, TapScriptSig as _TapScriptSig, TapTree as _TapTree } from '../../../node_modules/@btc-vision/bitcoin/browser/index.js';
 export interface TapLeafScript {
     readonly leafVersion: number;
-    readonly controlBlock: Buffer;
-    readonly script: Buffer;
+    readonly controlBlock: Uint8Array;
+    readonly script: Uint8Array;
 }
 export interface UpdateInput {
     tapLeafScript: TapLeafScript[];
@@ -29,3 +29,4 @@ export interface TapBip32Derivation extends _TapBip32Derivation {
 }
 export interface PsbtInputUpdate extends _PsbtInputUpdate {
 }
+//# sourceMappingURL=Tap.d.ts.map

package/browser/transaction/interfaces/Tap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tap.d.ts","sourceRoot":"","sources":["../../../src/transaction/interfaces/Tap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,IAAI,UAAU,EACvB,eAAe,IAAI,gBAAgB,EACnC,UAAU,IAAI,WAAW,EACzB,kBAAkB,IAAI,mBAAmB,EACzC,cAAc,IAAI,eAAe,EACjC,SAAS,IAAI,UAAU,EACvB,OAAO,IAAI,QAAQ,EACnB,aAAa,IAAI,cAAc,EAC/B,aAAa,IAAI,cAAc,EAC/B,YAAY,IAAI,aAAa,EAC7B,OAAO,IAAI,QAAQ,EACtB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IACxB,aAAa,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;CAAG;AAEhD,MAAM,WAAW,UAAW,SAAQ,WAAW;CAAG;AAElD,MAAM,WAAW,cAAe,SAAQ,eAAe;CAAG;AAE1D,MAAM,WAAW,OAAQ,SAAQ,QAAQ;CAAG;AAE5C,MAAM,WAAW,YAAa,SAAQ,aAAa;CAAG;AAEtD,MAAM,WAAW,SAAU,SAAQ,UAAU;CAAG;AAEhD,MAAM,WAAW,OAAQ,SAAQ,QAAQ;CAAG;AAE5C,MAAM,WAAW,aAAc,SAAQ,cAAc;CAAG;AAExD,MAAM,WAAW,aAAc,SAAQ,cAAc;CAAG;AAExD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;CAAG;AAElE,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;CAAG"}

package/browser/transaction/mineable/IP2WSHAddress.d.ts

@@ -1,4 +1,5 @@
 export interface IP2WSHAddress {
     address: string;
-    witnessScript: Buffer;
+    witnessScript: Uint8Array;
 }
+//# sourceMappingURL=IP2WSHAddress.d.ts.map

package/browser/transaction/mineable/IP2WSHAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IP2WSHAddress.d.ts","sourceRoot":"","sources":["../../../src/transaction/mineable/IP2WSHAddress.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,UAAU,CAAC;CAC7B"}

package/browser/transaction/mineable/TimelockGenerator.d.ts

@@ -1,9 +1,18 @@
-import { Network } from '../../../node_modules/@btc-vision/bitcoin/build/index.js';
+import { Network, PublicKey, XOnlyPublicKey } from '../../../node_modules/@btc-vision/bitcoin/browser/index.js';
 import { IP2WSHAddress } from './IP2WSHAddress.js';
 export declare class TimeLockGenerator {
     private static readonly UNSPENDABLE_INTERNAL_KEY;
     private static readonly CSV_BLOCKS;
-    static generateTimeLockAddress(publicKey: Buffer, network?: Network, csvBlocks?: number): IP2WSHAddress;
-    static generateTimeLockAddressP2TR(publicKey: Buffer, network?: Network, csvBlocks?: number): string;
+    /**
+     * Generate a P2WSH address with CSV timelock
+     * Note: This uses ECDSA, not Schnorr (Schnorr only available in Taproot)
+     */
+    static generateTimeLockAddress(publicKey: PublicKey, network?: Network, csvBlocks?: number): IP2WSHAddress;
+    /**
+     * Generate a P2TR address with CSV time lock
+     * Note: This uses Schnorr signatures
+     */
+    static generateTimeLockAddressP2TR(publicKey: XOnlyPublicKey, network?: Network, csvBlocks?: number): string;
     private static generateTimeLockScript;
 }
+//# sourceMappingURL=TimelockGenerator.d.ts.map

package/browser/transaction/mineable/TimelockGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimelockGenerator.d.ts","sourceRoot":"","sources":["../../../src/transaction/mineable/TimelockGenerator.ts"],"names":[],"mappings":"AAAA,OAAgB,EAEZ,KAAK,OAAO,EAGZ,KAAK,SAAS,EAGd,KAAK,cAAc,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAE9C;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAM;IAExC;;;OAGG;WACW,uBAAuB,CACjC,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,OAA0B,EACnC,SAAS,GAAE,MAAqC,GACjD,aAAa;IAkBhB;;;OAGG;WACW,2BAA2B,CACrC,SAAS,EAAE,cAAc,EACzB,OAAO,GAAE,OAA0B,EACnC,SAAS,GAAE,MAAqC,GACjD,MAAM;IAmBT,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAYxC"}

package/browser/transaction/offline/OfflineTransactionManager.d.ts

@@ -1,27 +1,80 @@
-import { Signer } from '../../../node_modules/@btc-vision/bitcoin/build/index.js';
-import { ECPairInterface } from 'ecpair';
+import { Signer } from '../../../node_modules/@btc-vision/bitcoin/browser/index.js';
+import { UniversalSigner } from '@btc-vision/ecpair';
 import { TransactionType } from '../enums/TransactionType.js';
 import { TransactionBuilder } from '../builders/TransactionBuilder.js';
 import { ISerializableTransactionState, PrecomputedData } from './interfaces/ISerializableState.js';
 import { ReconstructionOptions } from './TransactionReconstructor.js';
 import { IDeploymentParameters, IFundingTransactionParameters, IInteractionParameters, ITransactionParameters } from '../interfaces/ITransactionParameters.js';
+/**
+ * Export options for offline transaction signing
+ */
 export interface ExportOptions {
+    /** The original transaction parameters */
     params: ITransactionParameters;
+    /** Transaction type */
     type: TransactionType;
+    /** Precomputed data from the builder */
     precomputed?: Partial<PrecomputedData>;
 }
+/**
+ * Main entry point for offline transaction signing workflow.
+ *
+ * This class provides a complete API for:
+ * 1. Phase 1 (Online): Building transactions and exporting state for offline signing
+ * 2. Phase 2 (Offline): Importing state, providing signers, and signing transactions
+ *
+ * Also supports fee bumping by allowing reconstruction with new fee parameters.
+ *
+ * @example
+ * ```typescript
+ * // Phase 1 (Online environment)
+ * const params: IFundingTransactionParameters = { ... };
+ * const state = OfflineTransactionManager.exportFunding(params);
+ * // Send state to offline environment
+ *
+ * // Phase 2 (Offline environment)
+ * const signedTxHex = await OfflineTransactionManager.importSignAndExport(state, {
+ *     signer: offlineSigner,
+ * });
+ * // Send signedTxHex back to online environment for broadcast
+ * ```
+ */
 export declare class OfflineTransactionManager {
+    /**
+     * Export a FundingTransaction for offline signing
+     * @param params - Funding transaction parameters
+     * @param precomputed - Optional precomputed data
+     * @returns Base64-encoded serialized state
+     */
     static exportFunding(params: IFundingTransactionParameters, precomputed?: Partial<PrecomputedData>): string;
+    /**
+     * Export a DeploymentTransaction for offline signing
+     * @param params - Deployment transaction parameters
+     * @param precomputed - Required precomputed data (randomBytes, compiledTargetScript)
+     * @returns Base64-encoded serialized state
+     */
     static exportDeployment(params: IDeploymentParameters, precomputed: Partial<PrecomputedData> & {
         compiledTargetScript: string;
         randomBytes: string;
     }): string;
+    /**
+     * Export an InteractionTransaction for offline signing
+     * @param params - Interaction transaction parameters
+     * @param precomputed - Required precomputed data (randomBytes, compiledTargetScript)
+     * @returns Base64-encoded serialized state
+     */
     static exportInteraction(params: IInteractionParameters, precomputed: Partial<PrecomputedData> & {
         compiledTargetScript: string;
         randomBytes: string;
     }): string;
+    /**
+     * Export a MultiSignTransaction for offline signing
+     * @param params - MultiSig transaction parameters
+     * @param precomputed - Optional precomputed data
+     * @returns Base64-encoded serialized state
+     */
     static exportMultiSig(params: ITransactionParameters & {
-        pubkeys: Buffer[];
+        pubkeys: Uint8Array[];
         minimumSignatures: number;
         receiver: string;
         requestedAmount: bigint;
@@ -29,41 +82,169 @@ export declare class OfflineTransactionManager {
         originalInputCount?: number;
         existingPsbtBase64?: string;
     }, precomputed?: Partial<PrecomputedData>): string;
+    /**
+     * Export a CustomScriptTransaction for offline signing
+     * @param params - Custom script transaction parameters
+     * @param precomputed - Optional precomputed data
+     * @returns Base64-encoded serialized state
+     */
     static exportCustomScript(params: ITransactionParameters & {
-        scriptElements: (Buffer | number)[];
-        witnesses: Buffer[];
-        annex?: Buffer;
+        scriptElements: (Uint8Array | number)[];
+        witnesses: Uint8Array[];
+        annex?: Uint8Array;
     }, precomputed?: Partial<PrecomputedData>): string;
+    /**
+     * Export a CancelTransaction for offline signing
+     * @param params - Cancel transaction parameters
+     * @param precomputed - Optional precomputed data
+     * @returns Base64-encoded serialized state
+     */
     static exportCancel(params: ITransactionParameters & {
-        compiledTargetScript: Buffer | string;
+        compiledTargetScript: Uint8Array | string;
     }, precomputed?: Partial<PrecomputedData>): string;
+    /**
+     * Export transaction state from a builder instance.
+     * The builder must have been built but not yet signed.
+     * @param builder - Transaction builder instance
+     * @param params - Original construction parameters
+     * @param precomputed - Precomputed data from the builder
+     * @returns Base64-encoded serialized state
+     */
     static exportFromBuilder<T extends TransactionType>(builder: TransactionBuilder<T>, params: ITransactionParameters, precomputed?: Partial<PrecomputedData>): string;
+    /**
+     * Import and reconstruct transaction for signing
+     * @param serializedState - Base64-encoded state from Phase 1
+     * @param options - Signer(s) and optional fee overrides
+     * @returns Reconstructed transaction builder ready for signing
+     */
     static importForSigning(serializedState: string, options: ReconstructionOptions): TransactionBuilder<TransactionType>;
+    /**
+     * Complete signing and export signed transaction
+     * @param builder - Reconstructed builder from importForSigning
+     * @returns Signed transaction hex ready for broadcast
+     */
     static signAndExport(builder: TransactionBuilder<TransactionType>): Promise<string>;
+    /**
+     * Convenience: Full Phase 2 in one call - import, sign, and export
+     * @param serializedState - Base64-encoded state
+     * @param options - Signer(s) and optional fee overrides
+     * @returns Signed transaction hex ready for broadcast
+     */
     static importSignAndExport(serializedState: string, options: ReconstructionOptions): Promise<string>;
+    /**
+     * Rebuild transaction with new fee rate (fee bumping)
+     * @param serializedState - Original state
+     * @param newFeeRate - New fee rate in sat/vB
+     * @returns New serialized state with updated fees (not signed yet)
+     */
     static rebuildWithNewFees(serializedState: string, newFeeRate: number): string;
+    /**
+     * Rebuild and immediately sign with new fee rate
+     * @param serializedState - Original state
+     * @param newFeeRate - New fee rate in sat/vB
+     * @param options - Signer options
+     * @returns Signed transaction hex with new fees
+     */
     static rebuildSignAndExport(serializedState: string, newFeeRate: number, options: ReconstructionOptions): Promise<string>;
+    /**
+     * Inspect serialized state without signing
+     * @param serializedState - Base64-encoded state
+     * @returns Parsed state object for inspection
+     */
     static inspect(serializedState: string): ISerializableTransactionState;
+    /**
+     * Validate serialized state integrity
+     * @param serializedState - Base64-encoded state
+     * @returns True if checksum and format are valid
+     */
     static validate(serializedState: string): boolean;
+    /**
+     * Get transaction type from serialized state
+     * @param serializedState - Base64-encoded state
+     * @returns Transaction type enum value
+     */
     static getType(serializedState: string): TransactionType;
+    /**
+     * Parse base64-encoded state into state object
+     * @param base64State - Base64-encoded state
+     * @returns Parsed state object
+     */
     static fromBase64(base64State: string): ISerializableTransactionState;
+    /**
+     * Serialize state object to base64
+     * @param state - State object to serialize
+     * @returns Base64-encoded state
+     */
     static toBase64(state: ISerializableTransactionState): string;
+    /**
+     * Convert serialized state to hex format
+     * @param serializedState - Base64-encoded state
+     * @returns Hex-encoded state
+     */
     static toHex(serializedState: string): string;
+    /**
+     * Convert hex format back to base64
+     * @param hexState - Hex-encoded state
+     * @returns Base64-encoded state
+     */
     static fromHex(hexState: string): string;
-    static multiSigAddSignature(serializedState: string, signer: Signer | ECPairInterface): Promise<{
+    /**
+     * Add a partial signature to a multisig transaction state.
+     * This method signs the transaction with the provided signer and returns
+     * updated state with the new signature included.
+     *
+     * @param serializedState - Base64-encoded multisig state
+     * @param signer - The signer to add a signature with
+     * @returns Updated state with new signature, and signing result
+     */
+    static multiSigAddSignature(serializedState: string, signer: Signer | UniversalSigner): Promise<{
         state: string;
         signed: boolean;
         final: boolean;
         psbtBase64: string;
     }>;
-    static multiSigHasSigned(serializedState: string, signerPubKey: Buffer | string): boolean;
+    /**
+     * Check if a public key has already signed a multisig transaction
+     *
+     * @param serializedState - Base64-encoded multisig state
+     * @param signerPubKey - Public key to check (Buffer or hex string)
+     * @returns True if the public key has already signed
+     */
+    static multiSigHasSigned(serializedState: string, signerPubKey: Uint8Array | string): boolean;
+    /**
+     * Get the current signature count for a multisig transaction
+     *
+     * @param serializedState - Base64-encoded multisig state
+     * @returns Object with signature count info
+     */
     static multiSigGetSignatureStatus(serializedState: string): {
         required: number;
         collected: number;
         isComplete: boolean;
         signers: string[];
     };
+    /**
+     * Finalize a multisig transaction and extract the signed transaction hex.
+     * Only call this when all required signatures have been collected.
+     *
+     * @param serializedState - Base64-encoded multisig state with all signatures
+     * @returns Signed transaction hex ready for broadcast
+     */
     static multiSigFinalize(serializedState: string): string;
+    /**
+     * Get the PSBT from a multisig state (for external signing tools)
+     *
+     * @param serializedState - Base64-encoded multisig state
+     * @returns PSBT in base64 format, or null if not yet built
+     */
     static multiSigGetPsbt(serializedState: string): string | null;
+    /**
+     * Update the PSBT in a multisig state (after external signing)
+     *
+     * @param serializedState - Base64-encoded multisig state
+     * @param psbtBase64 - New PSBT with additional signatures
+     * @returns Updated state
+     */
     static multiSigUpdatePsbt(serializedState: string, psbtBase64: string): string;
 }
+//# sourceMappingURL=OfflineTransactionManager.d.ts.map

package/browser/transaction/offline/OfflineTransactionManager.d.ts.map

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

package/browser/transaction/offline/TransactionReconstructor.d.ts

@@ -1,28 +1,78 @@
-import { Signer } from '../../../node_modules/@btc-vision/bitcoin/build/index.js';
-import { ECPairInterface } from 'ecpair';
+import { Signer } from '../../../node_modules/@btc-vision/bitcoin/browser/index.js';
+import { UniversalSigner } from '@btc-vision/ecpair';
 import { QuantumBIP32Interface } from '../../../node_modules/@btc-vision/bip32/src/cjs/index.cjs';
 import { SignerMap } from '../../signer/AddressRotation.js';
 import { TransactionType } from '../enums/TransactionType.js';
 import { TransactionBuilder } from '../builders/TransactionBuilder.js';
 import { ISerializableTransactionState } from './interfaces/ISerializableState.js';
+/**
+ * Options for reconstructing a transaction from serialized state
+ */
 export interface ReconstructionOptions {
-    signer: Signer | ECPairInterface;
+    /** Primary signer (used for normal mode or as default in rotation mode) */
+    signer: Signer | UniversalSigner;
+    /** Optional: Override fee rate for fee bumping */
     newFeeRate?: number;
+    /** Optional: Override priority fee */
     newPriorityFee?: bigint;
+    /** Optional: Override gas sat fee */
     newGasSatFee?: bigint;
+    /** Signer map for address rotation mode (keyed by address) */
     signerMap?: SignerMap;
+    /** MLDSA signer (for quantum-resistant features) */
     mldsaSigner?: QuantumBIP32Interface | null;
 }
+/**
+ * Reconstructs transaction builders from serialized state.
+ * Supports fee bumping by allowing parameter overrides during reconstruction.
+ */
 export declare class TransactionReconstructor {
+    /**
+     * Reconstruct and optionally rebuild transaction with new parameters
+     * @param state - Serialized transaction state
+     * @param options - Signer(s) and optional fee overrides
+     * @returns Reconstructed transaction builder ready for signing
+     */
     static reconstruct(state: ISerializableTransactionState, options: ReconstructionOptions): TransactionBuilder<TransactionType>;
+    /**
+     * Reconstruct a FundingTransaction
+     */
     private static reconstructFunding;
+    /**
+     * Reconstruct a DeploymentTransaction
+     */
     private static reconstructDeployment;
+    /**
+     * Reconstruct an InteractionTransaction
+     */
     private static reconstructInteraction;
+    /**
+     * Reconstruct a MultiSignTransaction
+     */
     private static reconstructMultiSig;
+    /**
+     * Reconstruct a CustomScriptTransaction
+     */
     private static reconstructCustomScript;
+    /**
+     * Reconstruct a CancelTransaction
+     */
     private static reconstructCancel;
+    /**
+     * Build address rotation config from options
+     */
     private static buildAddressRotationConfig;
+    /**
+     * Deserialize UTXOs from serialized format
+     */
     private static deserializeUTXOs;
+    /**
+     * Deserialize outputs from serialized format
+     */
     private static deserializeOutputs;
+    /**
+     * Convert network name to Network object
+     */
     private static nameToNetwork;
 }
+//# sourceMappingURL=TransactionReconstructor.d.ts.map

package/browser/transaction/offline/TransactionReconstructor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionReconstructor.d.ts","sourceRoot":"","sources":["../../../src/transaction/offline/TransactionReconstructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAMH,KAAK,MAAM,EAGd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAExF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAOvE,OAAO,KAAK,EACR,6BAA6B,EAGhC,MAAM,oCAAoC,CAAC;AAuB5C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAEjC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC9C;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACjC;;;;;OAKG;WACW,WAAW,CACrB,KAAK,EAAE,6BAA6B,EACpC,OAAO,EAAE,qBAAqB,GAC/B,kBAAkB,CAAC,eAAe,CAAC;IA4DtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAajC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAoBpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA4BrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA4ClC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAgCtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAYhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAoBzC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAkB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAiBjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAY/B"}

package/browser/transaction/offline/TransactionSerializer.d.ts

@@ -1,10 +1,45 @@
 import { ISerializableTransactionState } from './interfaces/ISerializableState.js';
+/**
+ * Serializes and deserializes transaction state for offline signing.
+ * Uses binary format for compact size.
+ */
 export declare class TransactionSerializer {
-    static serialize(state: ISerializableTransactionState): Buffer;
-    static deserialize(data: Buffer): ISerializableTransactionState;
+    /**
+     * Serialize transaction state to binary format
+     * @param state - The transaction state to serialize
+     * @returns Uint8Array containing serialized state with checksum
+     */
+    static serialize(state: ISerializableTransactionState): Uint8Array;
+    /**
+     * Deserialize binary format to transaction state
+     * @param data - Uint8Array containing serialized state
+     * @returns Deserialized transaction state
+     * @throws Error if checksum validation fails or format is invalid
+     */
+    static deserialize(data: Uint8Array): ISerializableTransactionState;
+    /**
+     * Export state as base64 string (for transport)
+     * @param state - Transaction state to export
+     * @returns Base64-encoded string
+     */
     static toBase64(state: ISerializableTransactionState): string;
+    /**
+     * Import state from base64 string
+     * @param base64 - Base64-encoded state
+     * @returns Deserialized transaction state
+     */
     static fromBase64(base64: string): ISerializableTransactionState;
+    /**
+     * Export state as hex string
+     * @param state - Transaction state to export
+     * @returns Hex-encoded string
+     */
     static toHex(state: ISerializableTransactionState): string;
+    /**
+     * Import state from hex string
+     * @param hex - Hex-encoded state
+     * @returns Deserialized transaction state
+     */
     static fromHex(hex: string): ISerializableTransactionState;
     private static writeHeader;
     private static readHeader;
@@ -44,7 +79,23 @@ export declare class TransactionSerializer {
     private static readLoadedStorage;
     private static writePrecomputedData;
     private static readPrecomputedData;
+    /**
+     * Calculate double SHA256 checksum (Bitcoin standard)
+     */
     private static calculateChecksum;
+    /**
+     * Compare two Uint8Arrays for equality
+     */
+    private static bytesEqual;
+    /**
+     * Encode Uint8Array to base64 string
+     */
+    private static uint8ArrayToBase64;
+    /**
+     * Decode base64 string to Uint8Array
+     */
+    private static base64ToUint8Array;
     private static networkNameToU8;
     private static u8ToNetworkName;
 }
+//# sourceMappingURL=TransactionSerializer.d.ts.map

package/browser/transaction/offline/TransactionSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionSerializer.d.ts","sourceRoot":"","sources":["../../../src/transaction/offline/TransactionSerializer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,6BAA6B,EAOhC,MAAM,oCAAoC,CAAC;AAsB5C;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B;;;;OAIG;WACW,SAAS,CAAC,KAAK,EAAE,6BAA6B,GAAG,UAAU;IAqCzE;;;;;OAKG;WACW,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,6BAA6B;IAyD1E;;;;OAIG;WACW,QAAQ,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM;IAKpE;;;;OAIG;WACW,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,6BAA6B;IAIvE;;;;OAIG;WACW,KAAK,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM;IAIjE;;;;OAIG;WACW,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,6BAA6B;IAIjE,OAAO,CAAC,MAAM,CAAC,WAAW;IAS1B,OAAO,CAAC,MAAM,CAAC,UAAU;IAiBzB,OAAO,CAAC,MAAM,CAAC,eAAe;IAmB9B,OAAO,CAAC,MAAM,CAAC,cAAc;IA8B7B,OAAO,CAAC,MAAM,CAAC,cAAc;IAO7B,OAAO,CAAC,MAAM,CAAC,SAAS;IA8BxB,OAAO,CAAC,MAAM,CAAC,aAAa;IAS5B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAoCvB,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAO/B,OAAO,CAAC,MAAM,CAAC,WAAW;IAmB1B,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B,OAAO,CAAC,MAAM,CAAC,UAAU;IAwBzB,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAclC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAejC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAyBpC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAuBnC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAK/B,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAelC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA0BjC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAqBnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA+BlC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAgBhC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA2B/B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAkBpC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAYjC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAwBnC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAgBhC,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B,OAAO,CAAC,MAAM,CAAC,cAAc;IAO7B,OAAO,CAAC,MAAM,CAAC,cAAc;IAgC7B,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAkBzC,OAAO,CAAC,MAAM,CAAC,aAAa;IA6C5B,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAwBxC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAYjC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAUhC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA2BnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA6BlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAKhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAQzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAQjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IASjC,OAAO,CAAC,MAAM,CAAC,eAAe;IAa9B,OAAO,CAAC,MAAM,CAAC,eAAe;CAYjC"}

package/browser/transaction/offline/TransactionStateCapture.d.ts

@@ -1,23 +1,45 @@
 import { TransactionType } from '../enums/TransactionType.js';
 import { ISerializableTransactionState, PrecomputedData } from './interfaces/ISerializableState.js';
 import { IDeploymentParameters, IFundingTransactionParameters, IInteractionParameters, ITransactionParameters } from '../interfaces/ITransactionParameters.js';
+/**
+ * Parameters required to capture state from any transaction builder
+ */
 export interface CaptureParams {
+    /** The original transaction parameters */
     params: ITransactionParameters;
+    /** The transaction type */
     type: TransactionType;
+    /** Pre-computed data from the builder */
     precomputed?: Partial<PrecomputedData>;
 }
+/**
+ * Captures transaction state from builders for offline signing.
+ * This class creates serializable state objects from transaction parameters.
+ */
 export declare class TransactionStateCapture {
+    /**
+     * Capture state from a FundingTransaction
+     */
     static fromFunding(params: IFundingTransactionParameters, precomputed?: Partial<PrecomputedData>): ISerializableTransactionState;
+    /**
+     * Capture state from a DeploymentTransaction
+     */
     static fromDeployment(params: IDeploymentParameters, precomputed: Partial<PrecomputedData> & {
         compiledTargetScript: string;
         randomBytes: string;
     }): ISerializableTransactionState;
+    /**
+     * Capture state from an InteractionTransaction
+     */
     static fromInteraction(params: IInteractionParameters, precomputed: Partial<PrecomputedData> & {
         compiledTargetScript: string;
         randomBytes: string;
     }): ISerializableTransactionState;
+    /**
+     * Capture state from a MultiSignTransaction
+     */
     static fromMultiSig(params: ITransactionParameters & {
-        pubkeys: Buffer[];
+        pubkeys: Uint8Array[];
         minimumSignatures: number;
         receiver: string;
         requestedAmount: bigint;
@@ -25,18 +47,39 @@ export declare class TransactionStateCapture {
         originalInputCount?: number;
         existingPsbtBase64?: string;
     }, precomputed?: Partial<PrecomputedData>): ISerializableTransactionState;
+    /**
+     * Capture state from a CustomScriptTransaction
+     */
     static fromCustomScript(params: ITransactionParameters & {
-        scriptElements: (Buffer | number)[];
-        witnesses: Buffer[];
-        annex?: Buffer;
+        scriptElements: (Uint8Array | number)[];
+        witnesses: Uint8Array[];
+        annex?: Uint8Array;
     }, precomputed?: Partial<PrecomputedData>): ISerializableTransactionState;
+    /**
+     * Capture state from a CancelTransaction
+     */
     static fromCancel(params: ITransactionParameters & {
-        compiledTargetScript: Buffer | string;
+        compiledTargetScript: Uint8Array | string;
     }, precomputed?: Partial<PrecomputedData>): ISerializableTransactionState;
+    /**
+     * Main state capture method
+     */
     private static captureState;
+    /**
+     * Create serialization header
+     */
     private static createHeader;
+    /**
+     * Extract base parameters common to all transaction types
+     */
     private static extractBaseParams;
+    /**
+     * Extract signer mappings for address rotation mode
+     */
     private static extractSignerMappings;
+    /**
+     * Extract type-specific data based on transaction type
+     */
     private static extractTypeSpecificData;
     private static extractFundingData;
     private static extractDeploymentData;
@@ -44,9 +87,25 @@ export declare class TransactionStateCapture {
     private static extractMultiSigData;
     private static extractCustomScriptData;
     private static extractCancelData;
+    /**
+     * Build precomputed data object
+     */
     private static buildPrecomputedData;
+    /**
+     * Serialize UTXOs array
+     */
     private static serializeUTXOs;
+    /**
+     * Serialize outputs array
+     */
     private static serializeOutputs;
+    /**
+     * Convert network to name string
+     */
     private static networkToName;
+    /**
+     * Convert network to chain ID
+     */
     private static networkToChainId;
 }
+//# sourceMappingURL=TransactionStateCapture.d.ts.map

package/browser/transaction/offline/TransactionStateCapture.d.ts.map

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