@btc-vision/bitcoin 6.5.6 → 7.0.0-alpha.0

package/build/io/BinaryReader.js.map

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

package/build/io/BinaryWriter.d.ts

@@ -0,0 +1,391 @@
+/**
+ * Stateful binary writer with a single DataView instance.
+ *
+ * Zero allocations during write operations. The DataView is created once
+ * in the constructor and reused for all writes.
+ *
+ * @packageDocumentation
+ */
+/**
+ * High-performance binary writer for serializing binary data.
+ *
+ * Creates exactly ONE DataView instance that is reused for all write operations.
+ * This eliminates garbage collection pressure from repeated DataView allocations.
+ *
+ * Methods return `this` for chaining.
+ *
+ * @example
+ * ```typescript
+ * import { BinaryWriter } from '@btc-vision/bitcoin';
+ *
+ * // Serialize a simple structure
+ * const writer = new BinaryWriter(16);
+ * writer
+ *     .writeInt32LE(1)        // version
+ *     .writeUInt32LE(0)       // input count
+ *     .writeUInt32LE(0)       // output count
+ *     .writeUInt32LE(0);      // locktime
+ *
+ * const bytes = writer.finish();
+ * ```
+ */
+export declare class BinaryWriter {
+    #private;
+    /**
+     * Creates a new BinaryWriter with a pre-allocated buffer.
+     *
+     * @param size - Size of the buffer in bytes
+     *
+     * @example
+     * ```typescript
+     * import { BinaryWriter } from '@btc-vision/bitcoin';
+     *
+     * const writer = new BinaryWriter(1024);
+     * writer.writeUInt32LE(42);
+     * ```
+     */
+    constructor(size: number);
+    /**
+     * Creates a new BinaryWriter wrapping an existing buffer.
+     *
+     * @param buffer - Existing buffer to write into
+     * @param offset - Initial write position (default 0)
+     *
+     * @example
+     * ```typescript
+     * import { BinaryWriter } from '@btc-vision/bitcoin';
+     *
+     * const buffer = new Uint8Array(1024);
+     * const writer = new BinaryWriter(buffer, 10); // Start at offset 10
+     * writer.writeUInt32LE(42);
+     * ```
+     */
+    constructor(buffer: Uint8Array, offset?: number);
+    /**
+     * Creates a BinaryWriter with automatic capacity management.
+     *
+     * Initial capacity is 256 bytes, grows as needed.
+     *
+     * @returns A new GrowableBinaryWriter instance
+     *
+     * @example
+     * ```typescript
+     * import { BinaryWriter } from '@btc-vision/bitcoin';
+     *
+     * const writer = BinaryWriter.growable();
+     * writer.writeUInt32LE(1);
+     * writer.writeBytes(new Uint8Array(1000)); // Automatically grows
+     * ```
+     */
+    static growable(initialCapacity?: number): GrowableBinaryWriter;
+    /**
+     * Current write position in the buffer.
+     */
+    get offset(): number;
+    /**
+     * Sets the write position.
+     *
+     * @param value - New offset value
+     * @throws RangeError if offset is negative or beyond buffer length
+     */
+    set offset(value: number);
+    /**
+     * Total capacity of the underlying buffer.
+     */
+    get capacity(): number;
+    /**
+     * Number of bytes remaining in the buffer.
+     */
+    get remaining(): number;
+    /**
+     * The underlying data buffer.
+     */
+    get data(): Uint8Array;
+    /**
+     * Writes an 8-bit unsigned integer.
+     *
+     * @param value - Value to write (0-255)
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeUInt8(255);
+     * ```
+     */
+    writeUInt8(value: number): this;
+    /**
+     * Writes an 8-bit signed integer.
+     *
+     * @param value - Value to write (-128 to 127)
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     */
+    writeInt8(value: number): this;
+    /**
+     * Writes a 16-bit unsigned integer in little-endian format.
+     *
+     * @param value - Value to write (0-65535)
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeUInt16LE(1); // Writes 01 00
+     * ```
+     */
+    writeUInt16LE(value: number): this;
+    /**
+     * Writes a 16-bit signed integer in little-endian format.
+     *
+     * @param value - Value to write (-32768 to 32767)
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     */
+    writeInt16LE(value: number): this;
+    /**
+     * Writes a 32-bit unsigned integer in little-endian format.
+     *
+     * @param value - Value to write (0 to 4294967295)
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeUInt32LE(1); // Writes 01 00 00 00
+     * ```
+     */
+    writeUInt32LE(value: number): this;
+    /**
+     * Writes a 32-bit signed integer in little-endian format.
+     *
+     * @param value - Value to write (-2147483648 to 2147483647)
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeInt32LE(-1); // Writes ff ff ff ff
+     * ```
+     */
+    writeInt32LE(value: number): this;
+    /**
+     * Writes a 64-bit unsigned integer in little-endian format.
+     *
+     * @param value - Value to write as bigint
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeUInt64LE(50000n); // Writes 50 c3 00 00 00 00 00 00
+     * ```
+     */
+    writeUInt64LE(value: bigint): this;
+    /**
+     * Writes a 64-bit signed integer in little-endian format.
+     *
+     * @param value - Value to write as bigint
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     */
+    writeInt64LE(value: bigint): this;
+    /**
+     * Writes raw bytes.
+     *
+     * @param bytes - Bytes to write
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeBytes(new Uint8Array([0xde, 0xad, 0xbe, 0xef]));
+     * ```
+     */
+    writeBytes(bytes: Uint8Array): this;
+    /**
+     * Writes a Bitcoin CompactSize variable-length integer.
+     *
+     * CompactSize encoding:
+     * - 0x00-0xFC: 1 byte (value as-is)
+     * - 0xFD-0xFFFF: 3 bytes (0xFD + 2-byte LE uint16)
+     * - 0x10000-0xFFFFFFFF: 5 bytes (0xFE + 4-byte LE uint32)
+     * - Larger: 9 bytes (0xFF + 8-byte LE uint64)
+     *
+     * @param value - Value to write
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeVarInt(252);    // Writes fc
+     * writer.writeVarInt(253);    // Writes fd fd 00
+     * writer.writeVarInt(65535);  // Writes fd ff ff
+     * writer.writeVarInt(65536);  // Writes fe 00 00 01 00
+     * ```
+     */
+    writeVarInt(value: number): this;
+    /**
+     * Writes a Bitcoin CompactSize variable-length integer from bigint.
+     *
+     * @param value - Value to write as bigint
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     */
+    writeVarIntBig(value: bigint): this;
+    /**
+     * Writes a length-prefixed byte array (VarInt length + bytes).
+     *
+     * @param bytes - Bytes to write
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     *
+     * @example
+     * ```typescript
+     * writer.writeVarBytes(new Uint8Array([0xde, 0xad])); // Writes 02 de ad
+     * ```
+     */
+    writeVarBytes(bytes: Uint8Array): this;
+    /**
+     * Writes an array of length-prefixed byte arrays.
+     *
+     * Format: VarInt count + (VarInt length + bytes) for each item.
+     *
+     * @param vector - Array of byte arrays to write
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     */
+    writeVector(vector: readonly Uint8Array[]): this;
+    /**
+     * Fills a region with a specific byte value.
+     *
+     * @param value - Byte value to fill with
+     * @param length - Number of bytes to fill
+     * @returns This writer for chaining
+     * @throws RangeError if writing past end of buffer
+     */
+    fill(value: number, length: number): this;
+    /**
+     * Skips a specified number of bytes (leaves them unchanged).
+     *
+     * @param length - Number of bytes to skip
+     * @returns This writer for chaining
+     * @throws RangeError if skipping past end of buffer
+     */
+    skip(length: number): this;
+    /**
+     * Resets the write position to the beginning.
+     *
+     * @returns This writer for chaining
+     */
+    reset(): this;
+    /**
+     * Verifies the buffer was fully written and returns it.
+     *
+     * Unlike {@link finish}, this method throws if the writer has not
+     * written exactly to the end of the buffer.
+     *
+     * @returns The underlying buffer
+     * @throws Error if the buffer was not fully written
+     *
+     * @example
+     * ```typescript
+     * const writer = new BinaryWriter(8);
+     * writer.writeUInt32LE(1);
+     * writer.writeUInt32LE(2);
+     * const bytes = writer.end(); // OK: wrote exactly 8 bytes
+     *
+     * const writer2 = new BinaryWriter(8);
+     * writer2.writeUInt32LE(1);
+     * writer2.end(); // throws: buffer size 8, offset 4
+     * ```
+     */
+    end(): Uint8Array;
+    /**
+     * Returns the written portion of the buffer.
+     *
+     * If the entire buffer was written, returns the buffer directly (no copy).
+     * Otherwise, returns a subarray view.
+     *
+     * @returns Uint8Array containing the written data
+     *
+     * @example
+     * ```typescript
+     * const writer = new BinaryWriter(100);
+     * writer.writeUInt32LE(42);
+     * const bytes = writer.finish(); // 4 bytes
+     * ```
+     */
+    finish(): Uint8Array;
+    /**
+     * Returns the written portion as a hex string.
+     *
+     * @returns Hex string representation
+     *
+     * @example
+     * ```typescript
+     * const writer = new BinaryWriter(4);
+     * writer.writeUInt32LE(1);
+     * writer.toHex(); // '01000000'
+     * ```
+     */
+    toHex(): string;
+}
+/**
+ * A BinaryWriter that automatically grows its buffer as needed.
+ *
+ * Use when the final size is unknown.
+ *
+ * @example
+ * ```typescript
+ * const writer = BinaryWriter.growable();
+ * writer.writeBytes(largeData); // Automatically grows
+ * const bytes = writer.finish();
+ * ```
+ */
+export declare class GrowableBinaryWriter {
+    #private;
+    /**
+     * Creates a new GrowableBinaryWriter.
+     *
+     * @param initialCapacity - Initial buffer size (default 256)
+     */
+    constructor(initialCapacity?: number);
+    /**
+     * Current write position.
+     */
+    get offset(): number;
+    /**
+     * Sets the write position.
+     *
+     * @param value - New offset value
+     * @throws RangeError if offset is negative
+     */
+    set offset(value: number);
+    /**
+     * Current buffer capacity.
+     */
+    get capacity(): number;
+    writeUInt8(value: number): this;
+    writeUInt16LE(value: number): this;
+    writeUInt32LE(value: number): this;
+    writeInt32LE(value: number): this;
+    writeUInt64LE(value: bigint): this;
+    writeBytes(bytes: Uint8Array): this;
+    writeVarInt(value: number): this;
+    writeVarBytes(bytes: Uint8Array): this;
+    writeVector(vector: readonly Uint8Array[]): this;
+    /**
+     * Returns the written data as a new Uint8Array.
+     *
+     * @returns Copy of the written data
+     */
+    finish(): Uint8Array;
+    /**
+     * Returns the written data as a hex string.
+     *
+     * @returns Hex string representation
+     */
+    toHex(): string;
+}
+//# sourceMappingURL=BinaryWriter.d.ts.map

package/build/io/BinaryWriter.d.ts.map

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