xpi-ts 0.2.23 → 0.2.24

package/dist/cjs/lib/bitcore/crypto/point.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Point = exports.PREFIX_Y_EVEN = exports.PREFIX_Y_ODD = void 0;
-const elliptic_1 = require("elliptic");
+const elliptic = require("elliptic");
 const bn_1 = require("./bn");
 const util_1 = require("../util");
-const ecInstance = new elliptic_1.ec('secp256k1');
+const ecInstance = new (elliptic.default || elliptic).ec('secp256k1');
 const ecPoint = ecInstance.curve.point.bind(ecInstance.curve);
 const ecPointFromX = ecInstance.curve.pointFromX.bind(ecInstance.curve);
 exports.PREFIX_Y_ODD = 0x03;

package/dist/esm/lib/bitcore/crypto/point.js

@@ -1,7 +1,7 @@
-import { ec } from 'elliptic';
+import * as elliptic from 'elliptic';
 import { BN } from './bn';
 import { BufferUtil } from '../util';
-const ecInstance = new ec('secp256k1');
+const ecInstance = new (elliptic.default || elliptic).ec('secp256k1');
 const ecPoint = ecInstance.curve.point.bind(ecInstance.curve);
 const ecPointFromX = ecInstance.curve.pointFromX.bind(ecInstance.curve);
 export const PREFIX_Y_ODD = 0x03;

package/dist/types/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Copyright 2025 The Lotusia Stewardship
+ * Github: https://github.com/LotusiaStewardship
+ * License: MIT
+ */
 export * from './lib/rpc.js';
 export * as Bitcore from './lib/bitcore/index.js';
 export * as LOKAD from './lib/lokad.js';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAKA,cAAc,cAAc,CAAA;AAC5B,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AACjD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,cAAc,CAAA;AAC5B,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AACjD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}

package/dist/types/lib/bitcore/address.d.ts

@@ -27,41 +27,157 @@ export declare class Address {
     readonly type: string;
     constructor(data?: AddressInput, network?: Network | NetworkName, type?: string);
     private _classifyArguments;
+    /**
+     * Internal function to discover the network and type based on the first data byte
+     */
     private static _classifyFromVersion;
+    /**
+     * Internal function to transform a Lotus address string
+     */
     private static _transformString;
+    /**
+     * Internal function to transform a legacy bitcoin address string
+     */
     private static _transformLegacyString;
+    /**
+     * Check if a string is an XAddress format
+     */
     private static _isXAddress;
+    /**
+     * Internal function to transform an XAddress string
+     */
     private static _transformXAddressString;
+    /**
+     * Internal function to transform a hash buffer (20 bytes)
+     */
     private static _transformHash;
+    /**
+     * Internal function to transform a bitcoin address buffer (21 bytes)
+     */
     private static _transformBuffer;
+    /**
+     * Internal function to transform a public key
+     */
     private static _transformPublicKey;
+    /**
+     * Internal function to transform a Script into an info object
+     */
     private static _transformScript;
+    /**
+     * Deserializes an address serialized through `Address#toObject()`
+     */
     private static _transformObject;
+    /**
+     * Create a multisig address
+     */
     static createMultisig(publicKeys: PublicKey[], threshold: number, network?: Network | NetworkName): Address;
+    /**
+     * Create address from public key
+     */
     static fromPublicKey(data: PublicKey, network?: Network | NetworkName): Address;
+    /**
+     * Create address from public key hash
+     */
     static fromPublicKeyHash(hash: Buffer, network?: Network | NetworkName): Address;
+    /**
+     * Create address from script hash
+     */
     static fromScriptHash(hash: Buffer, network?: Network | NetworkName): Address;
+    /**
+     * Create Taproot address from commitment public key
+     *
+     * For Taproot, the "hash" is actually the 33-byte commitment public key.
+     *
+     * @param commitment - 33-byte commitment public key (tweaked)
+     * @param network - Network (livenet, testnet, regtest)
+     * @returns Taproot address
+     */
     static fromTaprootCommitment(commitment: PublicKey | Buffer, network: Network | NetworkName): Address;
+    /**
+     * Create address from buffer
+     */
     static fromBuffer(buffer: Buffer, network?: Network | NetworkName, type?: string): Address;
+    /**
+     * Takes an address string and transforms it into an `AddressData` object which
+     * contains the `hashBuffer`, `network`, and `type` parameters to instantiate the
+     * new `Address` object.
+     */
     static fromString(str: string, network?: Network | NetworkName): Address;
+    /**
+     * Create address from object
+     */
     static fromObject(obj: AddressObject): Address;
+    /**
+     * Extract address from a Script. The script must be of one
+     * of the following types: p2pkh input, p2pkh output, p2sh input
+     * or p2sh output.
+     */
     static fromScript(script: Script, network?: Network | NetworkName): Address;
+    /**
+     * Builds a p2sh address paying to script. This will hash the script and
+     * use that to create the address.
+     */
     static payingTo(script: Script, network?: Network | NetworkName): Address;
+    /**
+     * Will return a validation error if exists
+     */
     static getValidationError(data: AddressInput, network?: Network | NetworkName, type?: string): Error | null;
+    /**
+     * Will return a boolean if an address is valid
+     */
     static isValid(data: AddressInput, network?: Network | NetworkName, type?: string): boolean;
+    /**
+     * Check if address is pay to public key hash
+     */
     isPayToPublicKeyHash(): boolean;
+    /**
+     * Check if address is pay to script hash
+     */
     isPayToScriptHash(): boolean;
+    /**
+     * Check if address is pay to taproot
+     */
     isPayToTaproot(): boolean;
+    /**
+     * Will return a buffer representation of the address (hash buffer only)
+     */
     toBuffer(): Buffer;
+    /**
+     * Will return a full buffer representation of the address (version + hash)
+     */
     toFullBuffer(): Buffer;
+    /**
+     * Will return a cash address buffer representation
+     */
     toCashBuffer(): Buffer;
+    /**
+     * Returns a plain object with the address information
+     */
     toObject(): AddressObject;
     toJSON(): AddressObject;
+    /**
+     * Wrapper method for `Address.toXAddress` method
+     */
     toString(network?: Network | NetworkName): string;
+    /**
+     * Will return a legacy address string
+     */
     toLegacyAddress(): string;
+    /**
+     * Will return a cash address string
+     */
     toCashAddress(): string;
+    /**
+     * Will return an X address string
+     */
     toXAddress(network?: Network | NetworkName): string;
+    /**
+     * Decode cash address
+     */
     static decodeCashAddress(address: string): CashAddressDecoding;
+    /**
+     * Inspect method for debugging
+     */
     inspect(): string;
 }
 //# sourceMappingURL=address.d.ts.map

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

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

package/dist/types/lib/bitcore/block/block.d.ts

@@ -1,49 +1,263 @@
+/**
+ * Block implementation for the Lotus blockchain
+ *
+ * Represents a complete Lotus block (CBlock in lotusd) containing a header,
+ * extended metadata fields, and transactions.
+ *
+ * Serialization order:
+ *   CBlockHeader(160 bytes) + varint(metadata count) + metadata fields +
+ *   varint(tx count) + transactions
+ *
+ * Lotus merkle tree construction:
+ *   Each transaction contributes two leaves: txhash (SHA256d of serialized tx)
+ *   and txid (merkle-based identifier). These are combined per-transaction as
+ *   SHA256d(txhash || txid) before building the merkle tree.
+ *
+ * @see lotusd: src/primitives/block.h, src/primitives/block.cpp
+ */
 import { Buffer } from 'buffer/';
 import { BufferReader } from '../encoding/bufferreader.js';
 import { BufferWriter } from '../encoding/bufferwriter.js';
 import { Transaction } from '../transaction/index.js';
 import { BlockHeader, type BlockHeaderData, type BlockHeaderObject } from './blockheader.js';
 import { MerkleBlock } from './merkleblock.js';
+/**
+ * Block data interface for construction (internal format).
+ * Used when creating a Block from deserialized data or objects.
+ */
 export interface BlockData {
+    /** Block header (BlockHeader instance or BlockHeaderData) */
     header?: BlockHeader | BlockHeaderData;
+    /** Array of transactions in this block */
     transactions?: Transaction[];
 }
+/**
+ * Block object interface for serialization/JSON.
+ * All values converted to serializable formats.
+ */
 export interface BlockObject {
+    /** Block hash (big-endian hex) */
     id: string;
+    /** Block hash (big-endian hex, alias for id) */
     hash: string;
+    /** Serialized block header object */
     header: BlockHeaderObject;
+    /** Array of serialized transaction objects */
     transactions: unknown[];
 }
+/**
+ * Represents a complete Lotus blockchain block.
+ *
+ * A Block extends the BlockHeader with metadata and transactions, providing
+ * methods for serialization, merkle tree computation, and validation.
+ *
+ * @example
+ * ```typescript
+ * // Create from hex string
+ * const block = Block.fromString(hexString)
+ *
+ * // Create from buffer
+ * const block = Block.fromBuffer(buffer)
+ *
+ * // Access block hash
+ * console.log(block.id)
+ *
+ * // Validate merkle root
+ * if (block.validMerkleRoot()) {
+ *   console.log('Merkle root is valid')
+ * }
+ *
+ * // Create SPV proof for specific transactions
+ * const merkleBlock = block.toMerkleBlock(['txid1...'])
+ * ```
+ */
 export declare class Block {
+    /** Maximum block size (32 MiB) */
     static readonly MAX_BLOCK_SIZE: number;
+    /** 32-byte zero hash constant */
     static readonly NULL_HASH: Buffer;
+    /** Block header */
     header: BlockHeader;
+    /** Transactions in this block */
     transactions: Transaction[];
+    /** Cached block hash */
     private _id?;
+    /**
+     * Create a new Block
+     *
+     * @param serialized - Input data: BlockData object, Block instance,
+     *                     Buffer, or hex string
+     *
+     * @example
+     * ```typescript
+     * // From hex string
+     * const block = new Block(hexString)
+     *
+     * // From object
+     * const block = new Block({ header: headerData, transactions: [] })
+     *
+     * // Empty block
+     * const block = new Block()
+     * ```
+     */
     constructor(serialized?: BlockData | Block | Buffer | string);
+    /**
+     * Create a shallow copy of a block by serializing and deserializing it.
+     *
+     * @param block - Block to copy
+     * @returns New Block instance with the same data
+     */
     static shallowCopy(block: Block): Block;
+    /**
+     * Create a Block from an object containing header and transactions.
+     *
+     * @param obj - BlockData object
+     * @returns New Block instance
+     */
     static fromObject(obj: BlockData): Block;
+    /**
+     * Create a Block from a BufferReader.
+     *
+     * @param br - BufferReader positioned at block data
+     * @returns New Block instance
+     */
     static fromBufferReader(br: BufferReader): Block;
+    /**
+     * Create a Block from a Buffer.
+     *
+     * @param buf - Buffer containing serialized block data
+     * @returns New Block instance
+     */
     static fromBuffer(buf: Buffer): Block;
+    /**
+     * Create a Block from a hex string.
+     *
+     * @param str - Hex-encoded serialized block
+     * @returns New Block instance
+     */
     static fromString(str: string): Block;
+    /**
+     * Create a Block from raw block data (e.g., from disk or network).
+     *
+     * @param data - Raw block data as Buffer or binary string
+     * @returns New Block instance
+     */
     static fromRawBlock(data: Buffer | string): Block;
+    /**
+     * Convert to a plain JavaScript object.
+     *
+     * @returns BlockObject with all values serialized
+     */
     toObject(): BlockObject;
+    /**
+     * Convert to JSON (alias for toObject)
+     */
     toJSON(): BlockObject;
+    /**
+     * Serialize the block to a Buffer.
+     *
+     * Format: header + varint(0 metadata) + varint(tx count) + transactions
+     *
+     * @returns Buffer containing serialized block data
+     */
     toBuffer(): Buffer;
+    /**
+     * Serialize the block to a hex string.
+     *
+     * @returns Hex-encoded serialized block
+     */
     toString(): string;
+    /**
+     * Write block data to a BufferWriter.
+     *
+     * Serializes header, metadata vector (currently empty), and transactions
+     * to match lotusd CBlock serialization format.
+     *
+     * @param bw - Optional BufferWriter to reuse
+     * @returns BufferWriter containing the serialized block data
+     */
     toBufferWriter(bw?: BufferWriter): BufferWriter;
+    /**
+     * Compute combined transaction hashes for merkle tree construction.
+     *
+     * In Lotus, each transaction contributes two identifiers:
+     * - **hash**: SHA256d of the serialized transaction data
+     * - **txid**: Merkle-based identifier (inputs/outputs merkle roots)
+     *
+     * These are combined as SHA256d(hash || txid) per transaction.
+     *
+     * @returns Array of 32-byte hash buffers, one per transaction.
+     *          Returns [NULL_HASH] if the block has no transactions.
+     */
     getTransactionHashes(): Buffer[];
+    /**
+     * Build the full merkle tree from transaction hashes.
+     *
+     * Constructs the tree by iteratively hashing pairs of nodes. If a level
+     * has an odd number of elements, a null hash is appended to make it even.
+     *
+     * @returns Array of Buffers representing all tree nodes.
+     *          The merkle root is the last element.
+     */
     getMerkleTree(): Buffer[];
+    /**
+     * Compute the merkle root from the transactions in this block.
+     *
+     * @returns 32-byte merkle root buffer
+     */
     getMerkleRoot(): Buffer;
+    /**
+     * Verify that the computed merkle root matches the header merkle root.
+     *
+     * @returns True if the merkle roots match
+     */
     validMerkleRoot(): boolean;
+    /**
+     * Create a MerkleBlock containing a partial merkle tree for specific
+     * transactions. Used for SPV (Simplified Payment Verification).
+     *
+     * @param txids - Array of transaction IDs to include in the proof
+     * @returns MerkleBlock with partial merkle tree
+     *
+     * @throws {TypeError} If txids is empty or contains invalid format
+     * @throws {Error} If block has no transactions
+     */
     toMerkleBlock(txids: string[]): MerkleBlock;
+    /**
+     * Block hash in display format (big-endian hex).
+     * Delegates to the header hash computation.
+     */
     get hash(): string;
+    /**
+     * Block ID (alias for hash)
+     */
     get id(): string;
+    /**
+     * String representation for console/debugging
+     */
     inspect(): string;
+    /**
+     * Dispatch construction from Buffer or object.
+     */
     private static _from;
+    /**
+     * Create BlockData from an object, normalizing header and transactions.
+     */
     private static _fromObject;
+    /**
+     * Read a complete block from a BufferReader.
+     *
+     * Reads: header + metadata vector + transaction vector
+     * (matches lotusd CBlock serialization)
+     */
     private static _readFromBuffer;
+    /**
+     * Initialize an empty block with default header and no transactions.
+     */
     private _initEmpty;
+    /**
+     * Deserialize block from a hex string (instance method).
+     */
     private _fromString;
 }
 //# sourceMappingURL=block.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/block/block.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAM9C,MAAM,WAAW,SAAS;IAExB,MAAM,CAAC,EAAE,WAAW,GAAG,eAAe,CAAA;IAEtC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;CAC7B;AAMD,MAAM,WAAW,WAAW;IAE1B,EAAE,EAAE,MAAM,CAAA;IAEV,IAAI,EAAE,MAAM,CAAA;IAEZ,MAAM,EAAE,iBAAiB,CAAA;IAEzB,YAAY,EAAE,OAAO,EAAE,CAAA;CACxB;AA4BD,qBAAa,KAAK;IAEhB,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAmB;IAEjD,MAAM,CAAC,QAAQ,CAAC,SAAS,SAAY;IAGrC,MAAM,EAAG,WAAW,CAAA;IAGpB,YAAY,EAAG,WAAW,EAAE,CAAA;IAG5B,OAAO,CAAC,GAAG,CAAC,CAAQ;gBAoBR,UAAU,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM;IA2B5D,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAUvC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK;IAWxC,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,KAAK;IAYhD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAUrC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAUrC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK;IAkBjD,QAAQ,IAAI,WAAW;IAavB,MAAM,IAAI,WAAW;IAWrB,QAAQ,IAAI,MAAM;IASlB,QAAQ,IAAI,MAAM;IAalB,cAAc,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY;IA8B/C,oBAAoB,IAAI,MAAM,EAAE;IAsBhC,aAAa,IAAI,MAAM,EAAE;IAwBzB,aAAa,IAAI,MAAM;IAUvB,eAAe,IAAI,OAAO;IAgB1B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW;IAoE3C,IAAI,IAAI,IAAI,MAAM,CAKjB;IAKD,IAAI,EAAE,IAAI,MAAM,CAEf;IAKD,OAAO,IAAI,MAAM;IAWjB,OAAO,CAAC,MAAM,CAAC,KAAK;IAYpB,OAAO,CAAC,MAAM,CAAC,WAAW;IA0B1B,OAAO,CAAC,MAAM,CAAC,eAAe;IA2B9B,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,WAAW;CAMpB"}
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../../../lib/bitcore/block/block.ts"],"names":[],"mappings":"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"}