xpi-ts 0.2.22 → 0.2.24

package/dist/types/lib/bitcore/crypto/bn.d.ts

@@ -1,53 +1,277 @@
+/**
+ * BN (Big Number) wrapper class
+ * Provides a simplified interface to the BN.js library
+ * Migrated from bitcore-lib-xpi with ESM support
+ */
 import { BN } from 'bn.js';
 import type { Buffer } from 'buffer/';
 export interface BNWrapperOptions {
     endian?: 'little' | 'big';
     size?: number;
 }
+/**
+ * Type alias for BN.js instance type
+ * Used for type annotations throughout the codebase
+ */
 type BN = InstanceType<typeof BN>;
+/**
+ * BN (Big Number) wrapper class
+ *
+ * Provides a simplified interface to the BN.js library for arbitrary-precision
+ * integer arithmetic. This class wraps the underlying BN.js implementation and
+ * adds convenience methods for cryptographic operations commonly used in Lotus
+ * and related protocols.
+ *
+ * Features:
+ * - Conversion to/from Buffer, hex strings, and numbers
+ * - Signed magnitude (SM) buffer encoding/decoding
+ * - Arithmetic operations (add, sub, mul, div, mod, pow)
+ * - Comparison operations (eq, lt, gt, lte, gte, cmp)
+ * - Bitwise operations (and, neg)
+ * - Modular arithmetic (umod, invm, modPow)
+ *
+ * @example
+ * ```typescript
+ * // Create from number
+ * const bn1 = new BN(42)
+ *
+ * // Create from hex string
+ * const bn2 = BN.fromString('ff', 'hex')
+ *
+ * // Create from buffer
+ * const bn3 = BN.fromBuffer(BufferUtil.from([0x01, 0x02]))
+ *
+ * // Arithmetic
+ * const sum = bn1.add(bn2)
+ * const product = bn1.mul(bn2)
+ * ```
+ *
+ * @remarks
+ * Migrated from bitcore-lib-xpi with ESM support
+ */
 declare class BNWrapper {
+    /** The number zero (0) */
     static readonly Zero: BNWrapper;
+    /** The number one (1) */
     static readonly One: BNWrapper;
+    /** The number negative one (-1) */
     static readonly Minus1: BNWrapper;
+    /** The underlying BN.js instance */
     private _bn;
+    /**
+     * Create a new BNWrapper instance
+     *
+     * @param n - The value to create the BN from. Can be a number, string, BN instance, or BufferUtil.
+     * @param base - The base for string/buffer parsing. Can be a number (e.g., 10, 16), 'hex', 'le' (little-endian), or 'be' (big-endian).
+     *
+     * @example
+     * ```typescript
+     * // From number
+     * const bn1 = new BN(42)
+     *
+     * // From hex string
+     * const bn2 = new BN('ff', 'hex')
+     *
+     * // From buffer with little-endian
+     * const bn3 = new BN(BufferUtil.from([0x01, 0x02]), 'le')
+     * ```
+     */
     constructor(n: number | string | BN | Buffer, base?: number | 'hex' | 'le' | 'be');
+    /**
+     * Create BN from string
+     */
     static fromString(str: string, base?: 'hex' | number): BNWrapper;
+    /**
+     * Create BN from buffer
+     */
     static fromBuffer(buf: Buffer, opts?: BNWrapperOptions): BNWrapper;
+    /**
+     * Instantiate a BigNumber from a "signed magnitude buffer"
+     * (a buffer where the most significant bit represents the sign (0 = positive, -1 = negative))
+     */
     static fromSM(buf: Buffer, opts?: BNWrapperOptions): BNWrapper;
+    /**
+     * Create a BN from a "ScriptNum":
+     * This is analogous to the constructor for CScriptNum in bitcoind. Many ops in
+     * bitcoind's script interpreter use CScriptNum, which is not really a proper
+     * bignum. Instead, an error is thrown if trying to input a number bigger than
+     * 4 bytes. We copy that behavior here. A third argument, `size`, is provided to
+     * extend the hard limit of 4 bytes, as some usages require more than 4 bytes.
+     */
     static fromScriptNumBuffer(buf: Buffer, fRequireMinimal?: boolean, size?: number): BNWrapper;
+    /**
+     * Reverse buffer byte order
+     */
     static reversebuf(buf: Buffer): Buffer;
+    /**
+     * Trim buffer to natural length
+     */
     static trim(buf: Buffer, natlen: number): Buffer;
+    /**
+     * Pad buffer to specified size
+     */
     static pad(buf: Buffer, natlen: number, size: number): Buffer;
+    /**
+     * Create BN from number
+     */
     static fromNumber(n: number): BNWrapper;
+    /**
+     * Convert to number
+     */
     toNumber(): number;
+    /**
+     * Add another BN
+     */
     add(r: BNWrapper): BNWrapper;
+    /**
+     * Modulo operation
+     */
     mod(r: BNWrapper): BNWrapper;
+    /**
+     * Unsigned modulo operation
+     */
     umod(r: BNWrapper): BNWrapper;
+    /**
+     * Get the underlying BN instance
+     */
     get bn(): BN;
+    /**
+     * Convert to string
+     */
     toString(base?: number): string;
+    /**
+     * Converts the BN value to a Buffer with optional size and endianness control.
+     * By default, returns big-endian format with natural length.
+     *
+     * @param opts - Optional configuration for buffer conversion
+     * @param opts.size - Fixed size for the output buffer (will pad or trim as needed)
+     * @param opts.endian - Byte order: 'little' for little-endian, 'big' for big-endian (default: 'big')
+     * @returns Buffer containing the BN value in the specified format
+     */
     toBuffer(opts?: BNWrapperOptions): Buffer;
+    /**
+     * Multiply by another BN
+     * @param r - The BNWrapper to multiply with
+     * @returns A new BNWrapper containing the product
+     */
     mul(r: BNWrapper): BNWrapper;
+    /**
+     * Subtract another BN
+     * @param r - The BNWrapper to subtract
+     * @returns A new BNWrapper containing the difference
+     */
     sub(r: BNWrapper): BNWrapper;
+    /**
+     * Power operation
+     * @param r - The exponent as a BNWrapper
+     * @returns A new BNWrapper containing this raised to the power of r
+     */
     pow(r: BNWrapper): BNWrapper;
+    /**
+     * Divide by another BN
+     * @param r - The BNWrapper to divide by
+     * @returns A new BNWrapper containing the quotient
+     */
     div(r: BNWrapper): BNWrapper;
+    /**
+     * Modular exponentiation: computes (this^exponent) mod modulus
+     * Uses BN.js red reduction context for efficient modular arithmetic
+     * @param exponent - The exponent to raise this value to
+     * @param modulus - The modulus for the operation
+     * @returns A new BNWrapper containing (this^exponent) mod modulus
+     */
     modPow(exponent: BNWrapper, modulus: BNWrapper): BNWrapper;
+    /**
+     * Bitwise AND operation
+     * @param other - The BNWrapper or number to AND with
+     * @returns A new BNWrapper containing the result
+     */
     and(other: BNWrapper | number): BNWrapper;
+    /**
+     * Negate the BN (return -this)
+     * @returns A new BNWrapper containing the negated value
+     */
     neg(): BNWrapper;
+    /**
+     * Compute the modular multiplicative inverse
+     * Finds x such that (this * x) mod r = 1
+     * @param r - The modulus
+     * @returns A new BNWrapper containing the modular inverse
+     */
     invm(r: BNWrapper): BNWrapper;
+    /**
+     * Check if equal to another BN
+     * @param other - The BNWrapper to compare with
+     * @returns true if this equals other
+     */
     eq(other: BNWrapper): boolean;
+    /**
+     * Check if less than another BN
+     * @param other - The BNWrapper to compare with
+     * @returns true if this < other
+     */
     lt(other: BNWrapper): boolean;
+    /**
+     * Check if greater than another BN
+     * @param other - The BNWrapper to compare with
+     * @returns true if this > other
+     */
     gt(other: BNWrapper): boolean;
+    /**
+     * Check if less than or equal to another BN
+     * @param other - The BNWrapper to compare with
+     * @returns true if this <= other
+     */
     lte(other: BNWrapper): boolean;
+    /**
+     * Check if greater than or equal to another BN
+     * @param other - The BNWrapper to compare with
+     * @returns true if this >= other
+     */
     gte(other: BNWrapper): boolean;
+    /**
+     * Check if the value is zero
+     * @returns true if this equals 0
+     */
     isZero(): boolean;
+    /**
+     * Check if the value is negative
+     * @returns true if this < 0
+     */
     isNeg(): boolean;
+    /**
+     * Check if the value is odd
+     * @returns true if the least significant bit is 1
+     */
     isOdd(): boolean;
+    /**
+     * Check if the value is even
+     * @returns true if the least significant bit is 0
+     */
     isEven(): boolean;
+    /**
+     * Convert to signed magnitude buffer (big endian)
+     */
     toSMBigEndian(): Buffer;
+    /**
+     * Convert to signed magnitude buffer
+     */
     toSM(opts?: BNWrapperOptions): Buffer;
+    /**
+     * Convert to script number buffer
+     */
     toScriptNumBuffer(): Buffer;
+    /**
+     * Compare with another BN
+     */
     cmp(other: BNWrapper): number;
+    /**
+     * Copy value from another BN
+     */
     copy(other: BNWrapper): BNWrapper;
+    /**
+     * Clone the BN
+     */
     clone(): BNWrapper;
 }
 export { BNWrapper as BN };

package/dist/types/lib/bitcore/crypto/bn.d.ts.map

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

package/dist/types/lib/bitcore/crypto/ecdsa.d.ts

@@ -1,3 +1,26 @@
+/**
+ * ECDSA (Elliptic Curve Digital Signature Algorithm) implementation for Lotus
+ *
+ * This implements standard secp256k1 ECDSA as used by Lotus.
+ *
+ * Reference: lotusd/src/pubkey.cpp (lines 173-198)
+ *
+ * Key Requirements:
+ * - Signatures must be DER-encoded (typically 70-72 bytes)
+ * - Signatures must use low-S form (BIP 62)
+ * - Verification automatically normalizes high-S to low-S
+ *
+ * Low-S Requirement:
+ * - S must be <= n/2 where n is the curve order
+ * - If S > n/2, replace with S' = n - S
+ * - Prevents signature malleability (CVE-2013-2292)
+ *
+ * Signature Format:
+ * - DER-encoded ECDSA signature (variable length, typically 70-72 bytes)
+ * - Plus 1-byte sighash type when used in transactions
+ *
+ * Migrated from bitcore-lib-xpi with ESM support
+ */
 import { BN } from './bn';
 import { Signature } from './signature';
 import { PrivateKey } from '../privatekey';
@@ -23,25 +46,124 @@ export declare class ECDSA {
     constructor(obj?: ECDSAData);
     static create(obj?: ECDSAData): ECDSA;
     set(obj: ECDSAData): ECDSA;
+    /**
+     * Derive public key from private key
+     */
     privkey2pubkey(): ECDSA;
+    /**
+     * Calculate recovery factor i
+     */
     calci(): ECDSA;
+    /**
+     * Create ECDSA from JSON string
+     *
+     * @param str - JSON string representation of ECDSA data
+     * @returns New ECDSA instance
+     */
     static fromString(str: string): ECDSA;
+    /**
+     * Generate random k value
+     *
+     * @returns This ECDSA instance for method chaining
+     */
     randomK(): ECDSA;
+    /**
+     * Generate deterministic k value using RFC 6979
+     *
+     * @param badrs - Number of bad r/s values to retry (default: 0)
+     * @returns This ECDSA instance for method chaining
+     */
     deterministicK(badrs?: number): ECDSA;
+    /**
+     * Recover public key from signature
+     *
+     * @returns The recovered public key
+     * @throws {Error} If recovery factor i is invalid (not 0-3)
+     * @throws {Error} If nR is not a valid curve point
+     */
     toPublicKey(): PublicKey;
+    /**
+     * Check for signature errors
+     *
+     * @returns Error message string if verification fails, false if valid
+     */
     sigError(): string | false;
+    /**
+     * Convert to low S value (BIP 62 - Low S signatures)
+     *
+     * To prevent signature malleability, enforce that S <= n/2.
+     * If S > n/2, replace with S' = n - S.
+     *
+     * This matches Lotus behavior where signatures are normalized:
+     * secp256k1_ecdsa_signature_normalize(ctx, &sig, &sig)
+     *
+     * Threshold = 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0
+     * This is (n-1)/2 where n is the secp256k1 curve order
+     */
     static toLowS(s: BN): BN;
+    /**
+     * Find signature values
+     *
+     * @param d - Private key scalar
+     * @param e - Message hash as big number
+     * @returns Signature object with s, r, and compression flag
+     */
     _findSignature(d: BN, e: BN): {
         s: BN;
         r: BN;
         compressed?: boolean;
     };
+    /**
+     * Sign the hash
+     *
+     * @returns This ECDSA instance for method chaining
+     * @throws {Error} If hashbuf is not a 32-byte buffer
+     * @throws {Error} If private key is invalid
+     */
     sign(): ECDSA;
+    /**
+     * Sign with random k
+     *
+     * @returns This ECDSA instance for method chaining
+     */
     signRandomK(): ECDSA;
+    /**
+     * Convert to JSON string
+     *
+     * @returns JSON string representation of ECDSA data
+     */
     toString(): string;
+    /**
+     * Verify signature
+     *
+     * @returns This ECDSA instance for method chaining
+     */
     verify(): ECDSA;
+    /**
+     * Static sign method
+     *
+     * @param hashbuf - 32-byte hash buffer to sign
+     * @param privkey - Private key for signing
+     * @param endian - Byte endianness ('little' or 'big')
+     * @returns ECDSA signature
+     */
     static sign(hashbuf: Buffer, privkey: PrivateKey, endian?: 'little' | 'big'): Signature;
+    /**
+     * Static verify method
+     *
+     * @param hashbuf - 32-byte hash buffer that was signed
+     * @param sig - Signature to verify
+     * @param pubkey - Public key to verify against
+     * @param endian - Byte endianness ('little' or 'big')
+     * @returns True if signature is valid, false otherwise
+     */
     static verify(hashbuf: Buffer, sig: Signature, pubkey: PublicKey, endian?: 'little' | 'big'): boolean;
+    /**
+     * Reverse buffer byte order
+     *
+     * @param buf - Buffer to reverse
+     * @returns Reversed buffer
+     */
     private reverseBuffer;
 }
 //# sourceMappingURL=ecdsa.d.ts.map

package/dist/types/lib/bitcore/crypto/ecdsa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecdsa.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/crypto/ecdsa.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAA;AAEzB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACzB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,CAAC,CAAC,EAAE,EAAE,CAAA;IACN,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qBAAa,KAAK;IAChB,OAAO,EAAG,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACzB,OAAO,EAAG,UAAU,CAAA;IACpB,MAAM,EAAG,SAAS,CAAA;IAClB,GAAG,EAAG,SAAS,CAAA;IACf,CAAC,EAAG,EAAE,CAAA;IACN,QAAQ,EAAG,OAAO,CAAA;gBAEN,GAAG,CAAC,EAAE,SAAS;IAO3B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK;IAIrC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK;IAe1B,cAAc,IAAI,KAAK;IAQvB,KAAK,IAAI,KAAK;IA2Bd,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAUrC,OAAO,IAAI,KAAK;IAgBhB,cAAc,CAAC,KAAK,GAAE,MAAU,GAAG,KAAK;IA6CxC,WAAW,IAAI,SAAS;IAsCxB,QAAQ,IAAI,MAAM,GAAG,KAAK;IA2C1B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE;IAmBxB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG;QAAE,CAAC,EAAE,EAAE,CAAC;QAAC,CAAC,EAAE,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IA+BpE,IAAI,IAAI,KAAK;IAyBb,WAAW,IAAI,KAAK;IAUpB,QAAQ,IAAI,MAAM;IAyBlB,MAAM,IAAI,KAAK;IAiBf,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,GACxB,SAAS;IAmBZ,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,GACxB,OAAO;IAiBV,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"ecdsa.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/crypto/ecdsa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAA;AAEzB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACzB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,CAAC,CAAC,EAAE,EAAE,CAAA;IACN,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qBAAa,KAAK;IAChB,OAAO,EAAG,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACzB,OAAO,EAAG,UAAU,CAAA;IACpB,MAAM,EAAG,SAAS,CAAA;IAClB,GAAG,EAAG,SAAS,CAAA;IACf,CAAC,EAAG,EAAE,CAAA;IACN,QAAQ,EAAG,OAAO,CAAA;gBAEN,GAAG,CAAC,EAAE,SAAS;IAO3B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK;IAIrC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK;IAY1B;;OAEG;IACH,cAAc,IAAI,KAAK;IAKvB;;OAEG;IACH,KAAK,IAAI,KAAK;IAqBd;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAKrC;;;;OAIG;IACH,OAAO,IAAI,KAAK;IAUhB;;;;;OAKG;IACH,cAAc,CAAC,KAAK,GAAE,MAAU,GAAG,KAAK;IAsCxC;;;;;;OAMG;IACH,WAAW,IAAI,SAAS;IAiCxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM,GAAG,KAAK;IA+B1B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE;IAYxB;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG;QAAE,CAAC,EAAE,EAAE,CAAC;QAAC,CAAC,EAAE,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAwBpE;;;;;;OAMG;IACH,IAAI,IAAI,KAAK;IAoBb;;;;OAIG;IACH,WAAW,IAAI,KAAK;IAKpB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAoBlB;;;;OAIG;IACH,MAAM,IAAI,KAAK;IASf;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,GACxB,SAAS;IAUZ;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,GACxB,OAAO;IAWV;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAOtB"}

package/dist/types/lib/bitcore/crypto/hash.d.ts

@@ -1,17 +1,73 @@
+/**
+ * Cryptographic hash functions
+ * Migrated from bitcore-lib-xpi with ESM support
+ *
+ * Uses @noble/hashes for browser compatibility
+ */
 import type { Buffer } from 'buffer/';
+/**
+ * Hash function interface for cryptographic operations
+ * Represents a hash function that can be used with HMAC
+ */
 interface HashFunction {
+    /**
+     * Compute the hash of a buffer
+     * @param buf - Input buffer to hash
+     * @returns Hash result as Buffer
+     */
     (buf: Buffer): Buffer;
+    /**
+     * Block size of the hash function in bits
+     * Used for HMAC padding calculations
+     */
     blocksize: number;
 }
 export declare class Hash {
     static sha1: HashFunction;
     static sha256: HashFunction;
     static sha512: HashFunction;
+    /**
+     * Compute double SHA-256 hash
+     * @param buf - Input buffer to hash
+     * @returns Double SHA-256 hash as Buffer
+     */
     static sha256sha256: (buf: Buffer) => Buffer;
+    /**
+     * Compute RIPEMD-160 hash
+     * @param buf - Input buffer to hash
+     * @returns RIPEMD-160 hash as Buffer
+     */
     static ripemd160: (buf: Buffer) => Buffer;
+    /**
+     * Compute SHA-256 followed by RIPEMD-160 (Hash160)
+     * Commonly used for Bitcoin address generation
+     * @param buf - Input buffer to hash (typically a public key)
+     * @returns SHA-256-RIPEMD-160 hash as Buffer
+     */
     static sha256ripemd160: (buf: Buffer) => Buffer;
+    /**
+     * Compute HMAC (Hash-based Message Authentication Code)
+     * @see http://en.wikipedia.org/wiki/Hash-based_message_authentication_code
+     * @see http://tools.ietf.org/html/rfc4868#section-2
+     * @param hashf - The hash function to use (sha256 or sha512)
+     * @param data - The data to authenticate
+     * @param key - The secret key
+     * @returns The HMAC result
+     */
     static hmac(hashf: HashFunction, data: Buffer, key: Buffer): Buffer;
+    /**
+     * Compute HMAC-SHA256
+     * @param data - The data to authenticate
+     * @param key - The secret key
+     * @returns The HMAC-SHA256 result
+     */
     static sha256hmac(data: Buffer, key: Buffer): Buffer;
+    /**
+     * Compute HMAC-SHA512
+     * @param data - The data to authenticate
+     * @param key - The secret key
+     * @returns The HMAC-SHA512 result
+     */
     static sha512hmac(data: Buffer, key: Buffer): Buffer;
 }
 export {};

package/dist/types/lib/bitcore/crypto/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/crypto/hash.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAMrC,UAAU,YAAY;IAMpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IAKrB,SAAS,EAAE,MAAM,CAAA;CAClB;AA0CD,qBAAa,IAAI;IACf,MAAM,CAAC,IAAI,eAAW;IACtB,MAAM,CAAC,MAAM,eAAa;IAC1B,MAAM,CAAC,MAAM,eAAa;IAO1B,MAAM,CAAC,YAAY,GAAa,KAAK,MAAM,KAAG,MAAM,CAKnD;IAOD,MAAM,CAAC,SAAS,GAAa,KAAK,MAAM,KAAG,MAAM,CAKhD;IAQD,MAAM,CAAC,eAAe,GAAa,KAAK,MAAM,KAAG,MAAM,CAKtD;IAWD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAwDnE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAUpD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAGrD"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/crypto/hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC;;;GAGG;AACH,UAAU,YAAY;IACpB;;;;OAIG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;CAClB;AA0CD,qBAAa,IAAI;IACf,MAAM,CAAC,IAAI,eAAW;IACtB,MAAM,CAAC,MAAM,eAAa;IAC1B,MAAM,CAAC,MAAM,eAAa;IAE1B;;;;OAIG;IACH,MAAM,CAAC,YAAY,GAAa,KAAK,MAAM,KAAG,MAAM,CAKnD;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,GAAa,KAAK,MAAM,KAAG,MAAM,CAKhD;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,GAAa,KAAK,MAAM,KAAG,MAAM,CAKtD;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAkDnE;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIpD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAGrD"}

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

@@ -1,3 +1,7 @@
+/**
+ * Crypto module exports
+ * All cryptographic utilities migrated from bitcore-lib-xpi
+ */
 export { Hash } from './hash.js';
 export { Random } from './random.js';
 export { Point } from './point.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/crypto/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/crypto/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,cAAc,CAAA"}