xpi-ts 0.2.22 → 0.2.24

package/dist/types/lib/bitcore/mnemonic/mnemonic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mnemonic.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/mnemonic/mnemonic.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAerC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;AAuB/D,qBAAa,QAAQ;IACnB,SAAgB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClC,SAAgB,MAAM,EAAE,MAAM,CAAA;gBAElB,IAAI,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE;IAuDrD,MAAM,CAAC,KAAK;;;MAAQ;IAcpB,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO;IAmC9D,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;IAexE,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAoB9D,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAiBnC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ;IAuB5D,cAAc,CACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,GAC9B,YAAY;IAUf,QAAQ,IAAI,MAAM;IASlB,OAAO,IAAI,MAAM;IAWjB,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAYzD,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAiCrE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAiBjD;AAED,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"mnemonic.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/mnemonic/mnemonic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAYrC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,QAAQ;IACnB,SAAgB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClC,SAAgB,MAAM,EAAE,MAAM,CAAA;gBAElB,IAAI,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE;IAuDrD,MAAM,CAAC,KAAK;;;MAAQ;IAEpB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO;IA4B9D;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;IASxE;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAc9D;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAUnC;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ;IAc5D;;;;;;;;OAQG;IACH,cAAc,CACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,GAC9B,YAAY;IAKf;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAKzD;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IA0BrE;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAiBjD;AAED,eAAe,QAAQ,CAAA"}

package/dist/types/lib/bitcore/mnemonic/pbkdf2.d.ts

@@ -1,3 +1,16 @@
+/**
+ * PBKDF2 implementation for mnemonic seed generation
+ * Migrated from @abcpros/bitcore-mnemonic with ESM support and TypeScript
+ *
+ * Uses @noble/hashes for browser compatibility
+ */
 import type { Buffer } from 'buffer/';
+/**
+ * PBKDF2 implementation using SHA512
+ * Uses @noble/hashes for browser compatibility
+ *
+ * Credit to: https://github.com/stayradiated/pbkdf2-sha512
+ * Copyright (c) 2014, JP Richardson Copyright (c) 2010-2011 Intalio Pte, All Rights Reserved
+ */
 export declare function pbkdf2(key: string | Buffer, salt: string | Buffer, iterations: number, dkLen: number): Buffer;
 //# sourceMappingURL=pbkdf2.d.ts.map

package/dist/types/lib/bitcore/mnemonic/pbkdf2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pbkdf2.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/mnemonic/pbkdf2.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AASrC,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,CA+BR"}
+{"version":3,"file":"pbkdf2.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/mnemonic/pbkdf2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,CA+BR"}

package/dist/types/lib/bitcore/mnemonic/words/english.d.ts

@@ -1,2 +1,6 @@
+/**
+ * English word list for BIP39 mnemonic generation
+ * Migrated from @abcpros/bitcore-mnemonic with ESM support and TypeScript
+ */
 export declare const english: string[];
 //# sourceMappingURL=english.d.ts.map

package/dist/types/lib/bitcore/mnemonic/words/english.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"english.d.ts","sourceRoot":"","sources":["../../../../../../lib/bitcore/mnemonic/words/english.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,UAigEnB,CAAA"}
+{"version":3,"file":"english.d.ts","sourceRoot":"","sources":["../../../../../../lib/bitcore/mnemonic/words/english.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,UAigEnB,CAAA"}

package/dist/types/lib/bitcore/mnemonic/words/french.d.ts

@@ -1,2 +1,7 @@
+/**
+ * French word list for BIP39 mnemonic generation
+ * Source: https://github.com/bitcoin/bips/blob/master/bip-0039/french.txt
+ * Credits: @Kirvx @NicolasDorier @ecdsa @EricLarch
+ */
 export declare const french: string[];
 //# sourceMappingURL=french.d.ts.map

package/dist/types/lib/bitcore/mnemonic/words/french.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"french.d.ts","sourceRoot":"","sources":["../../../../../../lib/bitcore/mnemonic/words/french.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,MAAM,UAigElB,CAAA"}
+{"version":3,"file":"french.d.ts","sourceRoot":"","sources":["../../../../../../lib/bitcore/mnemonic/words/french.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,MAAM,UAigElB,CAAA"}

package/dist/types/lib/bitcore/mnemonic/words/index.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Word lists for BIP39 mnemonic generation
+ * Migrated from @abcpros/bitcore-mnemonic with ESM support and TypeScript
+ */
 export declare const Words: {
     ENGLISH: string[];
     FRENCH: string[];

package/dist/types/lib/bitcore/mnemonic/words/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../lib/bitcore/mnemonic/words/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,KAAK;;;CAQjB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../lib/bitcore/mnemonic/words/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,eAAO,MAAM,KAAK;;;CAQjB,CAAA"}

package/dist/types/lib/bitcore/musig2/index.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Copyright 2025 The Lotusia Stewardship
+ * Github: https://github.com/LotusiaStewardship
+ * License: MIT
+ */
+/**
+ * MuSig2 High-Level API
+ *
+ * This module provides simplified, developer-friendly wrappers for common
+ * MuSig2 operations, making it easier for new developers to implement
+ * multi-signature functionality.
+ *
+ * @module MuSig2
+ */
 export { MuSig2Signer, createMuSig2Signer, type MuSig2SignerConfig, type MuSig2PrepareResult, type MuSig2SignResult, type MuSig2TaprootSignResult, } from './signer.js';
 export { MuSigSessionManager, MuSigSessionPhase, type MuSigSession, } from './session.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/lib/bitcore/musig2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/musig2/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/musig2/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAA"}

package/dist/types/lib/bitcore/musig2/session.d.ts

@@ -1,57 +1,223 @@
+/**
+ * Copyright 2025 The Lotusia Stewardship
+ * Github: https://github.com/LotusiaStewardship
+ * License: MIT
+ */
+/**
+ * MuSig2 Session Management
+ *
+ * Provides stateful session management for multi-party MuSig2 signing.
+ * Handles nonce exchange, partial signature collection, and finalization.
+ *
+ * This is a general-purpose session manager that can be used for any
+ * MuSig2 signing scenario, not just Taproot transactions.
+ *
+ * @module MuSig2Session
+ */
 import { PublicKey } from '../publickey';
 import { PrivateKey } from '../privatekey';
 import { Point, BN, Signature } from '../crypto/index';
 import { type MuSig2KeyAggContext, type MuSig2Nonce, type MuSig2AggregatedNonce } from '../crypto/musig2';
 import type { Buffer } from 'buffer/';
+/**
+ * Session phases in the MuSig2 protocol
+ */
 export declare enum MuSigSessionPhase {
+    /** Initial state - session created but not started */
     INIT = "init",
+    /** Round 1 - collecting public nonces from all signers */
     NONCE_EXCHANGE = "nonce-exchange",
+    /** Round 2 - collecting partial signatures from all signers */
     PARTIAL_SIG_EXCHANGE = "partial-sig-exchange",
+    /** Final state - signature has been aggregated */
     COMPLETE = "complete",
+    /** Error state - session aborted due to validation failure */
     ABORTED = "aborted"
 }
+/**
+ * Result type for session manager operations
+ * Enables clean interface between session manager and P2P coordinator
+ */
 export interface SessionManagerResult {
+    /** Next phase to transition to (if any) */
     shouldTransitionTo?: MuSigSessionPhase;
+    /** Whether nonces should be revealed to other participants */
     shouldRevealNonces?: boolean;
+    /** Nonces to broadcast (if revealing) */
     broadcastNonces?: [Point, Point];
+    /** Whether partial signature should be created */
     shouldCreatePartialSig?: boolean;
+    /** Whether partial signature should be broadcast */
     shouldBroadcastPartialSig?: boolean;
+    /** Partial signature to broadcast */
     broadcastPartialSig?: BN;
+    /** Whether signature should be finalized */
     shouldFinalize?: boolean;
+    /** Final aggregated signature */
     finalSignature?: Signature;
+    /** Error message if operation failed */
     error?: string;
 }
+/**
+ * MuSig2 Signing Session
+ *
+ * Represents a single multi-party signing session with all necessary state.
+ */
 export interface MuSigSession {
+    /** Unique session identifier */
     sessionId: string;
+    /** All participating signers' public keys (in order) */
     signers: PublicKey[];
+    /** Index of this signer in the signers array */
     myIndex: number;
+    /** Key aggregation context (computed once) */
     keyAggContext: MuSig2KeyAggContext;
+    /** Message to be signed */
     message: Buffer;
+    /** Optional: Session metadata */
     metadata?: Record<string, unknown>;
+    /** This signer's secret nonce (NEVER share!) */
     mySecretNonce?: MuSig2Nonce;
+    /** This signer's public nonce */
     myPublicNonce?: [Point, Point];
+    /** Received public nonces from other signers (index -> nonce) */
     receivedPublicNonces: Map<number, [Point, Point]>;
+    /** Aggregated nonce (computed when all public nonces received) */
     aggregatedNonce?: MuSig2AggregatedNonce;
+    /** This signer's partial signature */
     myPartialSig?: BN;
+    /** Received partial signatures from other signers (index -> sig) */
     receivedPartialSigs: Map<number, BN>;
+    /** Final aggregated signature (if complete) */
     finalSignature?: Signature;
+    /** Current phase of the session */
     phase: MuSigSessionPhase;
+    /** Creation timestamp */
     createdAt: number;
+    /** Last updated timestamp */
     updatedAt: number;
+    /** Optional: Abort reason if phase is ABORTED */
     abortReason?: string;
+    /** Election method used for coordinator selection */
     electionMethod?: string;
+    /** Index of elected coordinator in sorted signers array */
     coordinatorIndex?: number;
+    /** Election proof hash for verification */
     electionProof?: string;
+    /** Backup coordinator priority list */
     backupCoordinators?: number[];
 }
+/**
+ * MuSig2 Session Manager
+ *
+ * Manages the lifecycle of MuSig2 signing sessions including:
+ * - Session creation and initialization
+ * - Nonce generation and exchange
+ * - Partial signature creation and collection
+ * - Signature aggregation and finalization
+ * - Validation and error handling
+ */
 export declare class MuSigSessionManager {
+    /**
+     * Create a new MuSig2 signing session
+     *
+     * @param signers - All participating signers' public keys (in order)
+     * @param myPrivateKey - This signer's private key
+     * @param message - Message to be signed
+     * @param metadata - Optional session metadata
+     * @returns Initialized session
+     * @throws Error if signers array is empty or doesn't contain myPrivateKey's public key
+     */
     createSession(signers: PublicKey[], myPrivateKey: PrivateKey, message: Buffer, metadata?: Record<string, unknown>): MuSigSession;
+    /**
+     * Generate and store public nonces for this signer
+     *
+     * This begins Round 1 of the MuSig2 protocol. The returned public nonces
+     * must be shared with all other signers.
+     *
+     * 🔒 PRODUCTION SECURITY: This method automatically adds 32 bytes of random
+     * entropy to nonce generation for defense-in-depth. The underlying nonce
+     * generation uses RFC6979 deterministic generation, and this random layer
+     * provides additional protection against implementation bugs or hardware failures.
+     *
+     * If you need deterministic nonces (e.g., for testing with known vectors),
+     * pass BufferUtil.alloc(32) as extraInput to disable the random layer.
+     *
+     * WARNING: Do not call this multiple times for the same session!
+     * Nonce reuse reveals the private key!
+     *
+     * @param session - The signing session
+     * @param privateKey - This signer's private key
+     * @param extraInput - Optional extra randomness. If not provided, 32 random bytes are automatically added for production security.
+     * @returns Public nonces to share with other signers
+     * @throws Error if session is not in INIT phase or nonces already generated
+     *
+     * @example Production usage (automatic randomness)
+     * ```typescript
+     * const nonces = manager.generateNonces(session, privateKey)
+     * // Automatically includes 32 random bytes for security
+     * ```
+     *
+     * @example Testing with deterministic nonces
+     * ```typescript
+     * const nonces = manager.generateNonces(session, privateKey, BufferUtil.alloc(32))
+     * // Uses only RFC6979 deterministic generation (reproducible)
+     * ```
+     */
     generateNonces(session: MuSigSession, privateKey: PrivateKey, extraInput?: Buffer): [Point, Point];
+    /**
+     * Receive and validate a public nonce from another signer
+     *
+     * @param session - The signing session
+     * @param signerIndex - Index of the signer who sent this nonce
+     * @param publicNonce - The public nonce to receive
+     * @throws Error if validation fails or duplicate nonce received
+     */
     receiveNonces(session: MuSigSession, signerIndex: number, publicNonces: [Point, Point]): void;
+    /**
+     * Create this signer's partial signature
+     *
+     * This begins Round 2 of the MuSig2 protocol. Can only be called after
+     * all nonces have been collected and aggregated.
+     *
+     * @param session - The signing session
+     * @param privateKey - This signer's private key
+     * @returns Partial signature to share with other signers
+     * @throws Error if not ready to sign
+     */
     createPartialSignature(session: MuSigSession, privateKey: PrivateKey): BN;
+    /**
+     * Receive and verify a partial signature from another signer
+     *
+     * @param session - The signing session
+     * @param signerIndex - Index of the signer who sent this signature
+     * @param partialSig - The partial signature to receive
+     * @throws Error if validation fails or duplicate signature received
+     */
     receivePartialSignature(session: MuSigSession, signerIndex: number, partialSig: BN): void;
+    /**
+     * Get the final aggregated signature
+     *
+     * Can only be called after all partial signatures have been collected.
+     *
+     * @param session - The signing session
+     * @returns The final Schnorr signature
+     * @throws Error if signature not yet finalized
+     */
     getFinalSignature(session: MuSigSession): Signature;
+    /**
+     * Abort a session with an error reason
+     *
+     * @param session - The signing session
+     * @param reason - Reason for abortion
+     */
     abortSession(session: MuSigSession, reason: string): void;
+    /**
+     * Get session status summary
+     *
+     * @param session - The signing session
+     * @returns Human-readable status information
+     */
     getSessionStatus(session: MuSigSession): {
         phase: MuSigSessionPhase;
         noncesCollected: number;
@@ -62,19 +228,107 @@ export declare class MuSigSessionManager {
         isAborted: boolean;
         abortReason?: string;
     };
+    /**
+     * Generate a unique session ID with entropy
+     *
+     * Session IDs now include:
+     * - All signer public keys (sorted)
+     * - Message being signed
+     * - Creation timestamp
+     * - Random entropy (16 bytes)
+     *
+     * This prevents session ID collisions when signing the same message
+     * with the same signers multiple times.
+     *
+     * @param signers - Sorted list of signer public keys
+     * @param message - Message to be signed
+     * @param createdAt - Creation timestamp (defaults to Date.now())
+     * @param entropy - Random entropy (defaults to 16 random bytes)
+     * @returns Unique session ID (32 hex characters)
+     */
     private _generateSessionId;
+    /**
+     * Regenerate session ID with new entropy
+     *
+     * Used when a session ID collision is detected.
+     *
+     * @param session - The session to regenerate ID for
+     * @returns New unique session ID
+     */
     regenerateSessionId(session: MuSigSession): string;
+    /**
+     * TESTING ONLY: Manually transition session phase
+     *
+     * This method is only for testing purposes to simulate phase transitions
+     * that would normally be handled by the P2P coordinator's state machine.
+     *
+     * @param session - The session to transition
+     * @param newPhase - The new phase to transition to
+     * @internal
+     */
     _transitionPhaseForTesting(session: MuSigSession, newPhase: MuSigSessionPhase): void;
+    /**
+     * Aggregate all received nonces
+     */
     private _aggregateNonces;
+    /**
+     * Finalize the signature
+     */
     private _finalizeSignature;
+    /**
+     * Clear secret nonce from memory
+     */
     private _clearSecretNonce;
+    /**
+     * Abort the session
+     */
     private _abortSession;
+    /**
+     * Check if all nonces received from other signers (PUBLIC)
+     * Used by P2P coordinator to check completion status
+     */
     hasAllNonces(session: MuSigSession): boolean;
+    /**
+     * Check if all partial signatures received from other signers (PUBLIC)
+     * Used by P2P coordinator to check completion status
+     */
     hasAllPartialSignatures(session: MuSigSession): boolean;
+    /**
+     * Check if local participant is coordinator
+     */
     isCoordinator(session: MuSigSession): boolean;
+    /**
+     * Validate MuSig2 BIP327 compliance
+     * Ensures the session follows BIP327 specification requirements
+     *
+     * @param session - The signing session
+     * @throws Error if session violates BIP327 requirements
+     */
     validateBIP327Compliance(session: MuSigSession): void;
+    /**
+     * Check if keys are sorted lexicographically
+     * BIP327 requires deterministic key ordering
+     *
+     * @param signers - Array of public keys
+     * @returns True if keys are sorted
+     */
     private areKeysSorted;
+    /**
+     * Validate MuSig2 round progression
+     * Ensures phase transitions follow BIP327 protocol
+     *
+     * @param session - The signing session
+     * @throws Error if phase transition is invalid
+     */
     private validateMuSig2Rounds;
+    /**
+     * Initiate Round 1 of MuSig2 protocol (DIRECT NONCE EXCHANGE)
+     * Validates protocol compliance and prepares for nonce exchange
+     *
+     * @param session - The signing session
+     * @param privateKey - This signer's private key
+     * @returns Session manager result with nonce generation instructions
+     */
     initiateRound1(session: MuSigSession, privateKey: PrivateKey): SessionManagerResult;
 }
 //# sourceMappingURL=session.d.ts.map

package/dist/types/lib/bitcore/musig2/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/musig2/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/musig2/session.ts"],"names":[],"mappings":"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"}