@btc-vision/transaction 1.8.0-beta.3 → 1.8.0-beta.5

package/build/buffer/BinaryReader.js

@@ -3,10 +3,15 @@ import { ExtendedAddressMap } from '../deterministic/ExtendedAddressMap.js';
 import { Address } from '../keypair/Address.js';
 import { ADDRESS_BYTE_LENGTH, EXTENDED_ADDRESS_BYTE_LENGTH, I128_BYTE_LENGTH, I16_BYTE_LENGTH, I32_BYTE_LENGTH, I64_BYTE_LENGTH, I8_BYTE_LENGTH, SCHNORR_SIGNATURE_BYTE_LENGTH, U128_BYTE_LENGTH, U16_BYTE_LENGTH, U256_BYTE_LENGTH, U32_BYTE_LENGTH, U64_BYTE_LENGTH, U8_BYTE_LENGTH, } from '../utils/lengths.js';
 export class BinaryReader {
+    buffer;
+    currentOffset = 0;
     constructor(bytes) {
-        this.currentOffset = 0;
         this.buffer = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
     }
+    get byteLength() {
+        return this.buffer.byteLength;
+    }
+    // Helpers for comparisons; unchanged
     static stringCompare(a, b) {
         return a.localeCompare(b);
     }
@@ -28,71 +33,109 @@ export class BinaryReader {
         this.buffer = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
         this.currentOffset = 0;
     }
-    get byteLength() {
-        return this.buffer.byteLength;
-    }
     length() {
         return this.buffer.byteLength;
     }
     bytesLeft() {
         return this.buffer.byteLength - this.currentOffset;
     }
+    // ------------------- Signed Integer Readers ------------------- //
+    /**
+     * Reads a single signed byte (i8).
+     */
     readI8() {
         this.verifyEnd(this.currentOffset + I8_BYTE_LENGTH);
         const value = this.buffer.getInt8(this.currentOffset);
         this.currentOffset += I8_BYTE_LENGTH;
         return value;
     }
+    /**
+     * Reads a signed 16-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readI16(be = true) {
         this.verifyEnd(this.currentOffset + I16_BYTE_LENGTH);
         const value = this.buffer.getInt16(this.currentOffset, !be);
         this.currentOffset += I16_BYTE_LENGTH;
         return value;
     }
+    /**
+     * Reads a signed 32-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readI32(be = true) {
         this.verifyEnd(this.currentOffset + I32_BYTE_LENGTH);
         const value = this.buffer.getInt32(this.currentOffset, !be);
         this.currentOffset += I32_BYTE_LENGTH;
         return value;
     }
+    /**
+     * Reads a signed 64-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readI64(be = true) {
         this.verifyEnd(this.currentOffset + I64_BYTE_LENGTH);
         const value = this.buffer.getBigInt64(this.currentOffset, !be);
         this.currentOffset += I64_BYTE_LENGTH;
         return value;
     }
+    // ------------------- Unsigned Integer Readers ------------------- //
+    /**
+     * Reads a single unsigned byte (u8).
+     */
     readU8() {
         this.verifyEnd(this.currentOffset + U8_BYTE_LENGTH);
         const value = this.buffer.getUint8(this.currentOffset);
         this.currentOffset += U8_BYTE_LENGTH;
         return value;
     }
+    /**
+     * Reads an unsigned 16-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readU16(be = true) {
         this.verifyEnd(this.currentOffset + U16_BYTE_LENGTH);
         const value = this.buffer.getUint16(this.currentOffset, !be);
         this.currentOffset += U16_BYTE_LENGTH;
         return value;
     }
+    /**
+     * Reads an unsigned 32-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readU32(be = true) {
         this.verifyEnd(this.currentOffset + U32_BYTE_LENGTH);
         const value = this.buffer.getUint32(this.currentOffset, !be);
         this.currentOffset += U32_BYTE_LENGTH;
         return value;
     }
+    /**
+     * Reads an unsigned 64-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readU64(be = true) {
         this.verifyEnd(this.currentOffset + U64_BYTE_LENGTH);
         const value = this.buffer.getBigUint64(this.currentOffset, !be);
         this.currentOffset += U64_BYTE_LENGTH;
         return value;
     }
+    /**
+     * Reads a 128-bit unsigned integer. By default, read big-endian.
+     * @param be - Endianness; true => big-endian (default).
+     */
     readU128(be = true) {
         const raw = this.readBytes(U128_BYTE_LENGTH);
         let bytes = raw;
+        // If data was written in little-endian, we reverse before interpreting
         if (!be) {
             bytes = this.reverseBytes(raw);
         }
         return BigInt('0x' + this.toHexString(bytes));
     }
+    /**
+     * Reads a 256-bit unsigned integer. Same approach as readU128.
+     * @param be - Endianness; true => big-endian (default).
+     */
     readU256(be = true) {
         const raw = this.readBytes(U256_BYTE_LENGTH);
         let bytes = raw;
@@ -101,26 +144,44 @@ export class BinaryReader {
         }
         return BigInt('0x' + this.toHexString(bytes));
     }
+    /**
+     * Reads a 128-bit signed integer. Interpret the sign bit if big-endian.
+     * @param be - Endianness; true => big-endian (default).
+     */
     readI128(be = true) {
         const raw = this.readBytes(I128_BYTE_LENGTH);
         let bytes = raw;
         if (!be) {
             bytes = this.reverseBytes(raw);
         }
+        // Construct as a 128-bit two's complement
         let value = BigInt('0x' + this.toHexString(bytes));
+        // If the top bit is set (sign bit in big-endian), interpret negative
         const signBitMask = 0x80;
         if (bytes[0] & signBitMask) {
+            // (1 << 128)
             const twoTo128 = BigInt(1) << BigInt(128);
+            // 2's complement
             value = value - twoTo128;
         }
         return value;
     }
+    /**
+     * Read a boolean (u8 != 0).
+     */
     readBoolean() {
         return this.readU8() !== 0;
     }
+    /**
+     * Reads 32 bits
+     */
     readSelector() {
         return this.readU32(true);
     }
+    /**
+     * Reads a raw sequence of bytes (length must be known).
+     * If zeroStop = true, stops if we encounter 0x00 early.
+     */
     readBytes(length, zeroStop = false) {
         this.verifyEnd(this.currentOffset + length);
         let bytes = new Uint8Array(length);
@@ -134,35 +195,73 @@ export class BinaryReader {
         }
         return bytes;
     }
+    /**
+     * Reads a string of the given length in raw bytes. By default, do NOT zero-stop
+     * (matching how we wrote the raw bytes).
+     */
     readString(length) {
         const textDecoder = new TextDecoder();
         const bytes = this.readBytes(length, false);
         return textDecoder.decode(bytes);
     }
+    /**
+     * Reads a string that was written as [u16 length][raw bytes].
+     */
     readStringWithLength(be = true) {
         const length = this.readU32(be);
         return this.readString(length);
     }
+    /**
+     * Reads an address (32 bytes MLDSA key hash only).
+     */
     readAddress() {
         const bytes = Array.from(this.readBytes(ADDRESS_BYTE_LENGTH));
         return new Address(bytes);
     }
+    /**
+     * Reads the tweaked public key portion (32 bytes) and returns it as a raw Uint8Array.
+     * Use this when you only need the tweaked key without the full Address object.
+     */
     readTweakedPublicKey() {
         this.verifyEnd(this.currentOffset + ADDRESS_BYTE_LENGTH);
         return this.readBytes(ADDRESS_BYTE_LENGTH);
     }
+    /**
+     * Reads a full address with both MLDSA key hash and tweaked public key (64 bytes total).
+     * Format: [32 bytes tweakedPublicKey][32 bytes MLDSA key hash]
+     *
+     * This is the equivalent of btc-runtime's readExtendedAddress().
+     *
+     * @returns An Address instance with both keys set
+     */
     readExtendedAddress() {
         this.verifyEnd(this.currentOffset + EXTENDED_ADDRESS_BYTE_LENGTH);
+        // Read tweaked public key first (32 bytes)
         const tweakedPublicKey = Array.from(this.readBytes(ADDRESS_BYTE_LENGTH));
+        // Read MLDSA key hash (32 bytes)
         const mldsaKeyHash = Array.from(this.readBytes(ADDRESS_BYTE_LENGTH));
         return new Address(mldsaKeyHash, tweakedPublicKey);
     }
+    /**
+     * Reads a Schnorr signature with its associated full Address.
+     * Format: [64 bytes full Address][64 bytes signature]
+     *
+     * Used for deserializing signed data where both the signer's address
+     * and their Schnorr signature are stored together.
+     *
+     * @returns A SchnorrSignature containing the address and signature
+     */
     readSchnorrSignature() {
         this.verifyEnd(this.currentOffset + EXTENDED_ADDRESS_BYTE_LENGTH + SCHNORR_SIGNATURE_BYTE_LENGTH);
         const address = this.readExtendedAddress();
         const signature = this.readBytes(SCHNORR_SIGNATURE_BYTE_LENGTH);
         return { address, signature };
     }
+    /**
+     * Reads bytes written as [u32 length][bytes].
+     * @param maxLength if > 0, enforces an upper bound
+     * @param be
+     */
     readBytesWithLength(maxLength = 0, be = true) {
         const length = this.readU32(be);
         if (maxLength > 0 && length > maxLength) {
@@ -170,6 +269,7 @@ export class BinaryReader {
         }
         return this.readBytes(length);
     }
+    // ------------------ Array readers ------------------ //
     readArrayOfBuffer(be = true) {
         const length = this.readU16(be);
         const result = new Array(length);
@@ -227,7 +327,7 @@ export class BinaryReader {
         return result;
     }
     readU8Array() {
-        const length = this.readU16(true);
+        const length = this.readU16(true); // by default big-endian
         const result = new Array(length);
         for (let i = 0; i < length; i++) {
             result[i] = this.readU8();
@@ -250,6 +350,9 @@ export class BinaryReader {
         }
         return result;
     }
+    /**
+     * Reads [u16 length][ (address, u256) pairs ].
+     */
     readAddressValueTuple(be = true) {
         const length = this.readU16(be);
         const result = new AddressMap();
@@ -263,6 +366,10 @@ export class BinaryReader {
         }
         return result;
     }
+    /**
+     * Reads an array of full addresses (64 bytes each).
+     * Format: [u16 length][FullAddress 0][FullAddress 1]...
+     */
     readExtendedAddressArray(be = true) {
         const length = this.readU16(be);
         const result = new Array(length);
@@ -271,6 +378,12 @@ export class BinaryReader {
         }
         return result;
     }
+    /**
+     * Reads a map of full Address -> u256 using the tweaked key for map lookup.
+     * Format: [u16 length][FullAddress key][u256 value]...
+     *
+     * This is the equivalent of btc-runtime's readExtendedAddressMapU256().
+     */
     readExtendedAddressMapU256(be = true) {
         const length = this.readU16(be);
         const result = new ExtendedAddressMap();
@@ -284,17 +397,24 @@ export class BinaryReader {
         }
         return result;
     }
+    // --------------------------------------------------- //
     getOffset() {
         return this.currentOffset;
     }
     setOffset(offset) {
         this.currentOffset = offset;
     }
+    /**
+     * Verifies we have enough bytes in the buffer to read up to `size`.
+     */
     verifyEnd(size) {
         if (size > this.buffer.byteLength) {
             throw new Error(`Attempt to read beyond buffer length: requested up to byte offset ${size}, but buffer is only ${this.buffer.byteLength} bytes.`);
         }
     }
+    /**
+     * Utility: reverses a byte array in-place or returns a reversed copy.
+     */
     reverseBytes(bytes) {
         const out = new Uint8Array(bytes.length);
         for (let i = 0; i < bytes.length; i++) {
@@ -302,7 +422,11 @@ export class BinaryReader {
         }
         return out;
     }
+    /**
+     * Utility: turn bytes into a hex string without `0x` prefix.
+     */
     toHexString(bytes) {
         return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
     }
 }
+//# sourceMappingURL=BinaryReader.js.map

package/build/buffer/BinaryReader.js.map

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

package/build/buffer/BinaryWriter.d.ts

@@ -1,9 +1,9 @@
 import { AddressMap } from '../deterministic/AddressMap.js';
 import { ExtendedAddressMap } from '../deterministic/ExtendedAddressMap.js';
 import { Address } from '../keypair/Address.js';
-import { i16, i32, i64, i8, Selector, u16, u32, u64, u8 } from '../utils/types.js';
+import type { i16, i32, i64, i8, Selector, u16, u32, u64, u8 } from '../utils/types.js';
 import { BinaryReader } from './BinaryReader.js';
-export declare class BinaryWriter {
+export declare class BinaryWriter implements Disposable {
     private currentOffset;
     private buffer;
     constructor(length?: number);
@@ -12,9 +12,21 @@ export declare class BinaryWriter {
     writeU16(value: u16, be?: boolean): void;
     writeU32(value: u32, be?: boolean): void;
     writeU64(value: u64, be?: boolean): void;
+    /**
+     * Writes a signed 8-bit integer.
+     */
     writeI8(value: i8): void;
+    /**
+     * Writes a signed 16-bit integer. By default big-endian (be = true).
+     */
     writeI16(value: i16, be?: boolean): void;
+    /**
+     * Writes a signed 32-bit integer. By default big-endian (be = true).
+     */
     writeI32(value: i32, be?: boolean): void;
+    /**
+     * Writes a signed 64-bit integer. By default big-endian (be = true).
+     */
     writeI64(value: i64, be?: boolean): void;
     writeSelector(value: Selector): void;
     writeBoolean(value: boolean): void;
@@ -24,9 +36,35 @@ export declare class BinaryWriter {
     writeBytes(value: Uint8Array | Buffer): void;
     writeString(value: string): void;
     writeStringWithLength(value: string): void;
+    /**
+     * Writes an address (32 bytes MLDSA key hash only).
+     */
     writeAddress(value: Address): void;
+    /**
+     * Writes the tweaked public key from an Address (32 bytes).
+     * @param value - The Address containing the tweaked public key
+     */
     writeTweakedPublicKey(value: Address): void;
+    /**
+     * Writes a full address with both tweaked public key and MLDSA key hash (64 bytes total).
+     * Format: [32 bytes tweakedPublicKey][32 bytes MLDSA key hash]
+     *
+     * This is the equivalent of btc-runtime's writeExtendedAddress().
+     *
+     * @param value - The Address containing both keys
+     */
     writeExtendedAddress(value: Address): void;
+    /**
+     * Writes a Schnorr signature with its associated full Address.
+     * Format: [64 bytes full Address][64 bytes signature]
+     *
+     * Used for serializing signed data where both the signer's address
+     * and their Schnorr signature need to be stored together.
+     *
+     * @param address - The signer's Address (with both MLDSA and tweaked keys)
+     * @param signature - The 64-byte Schnorr signature
+     * @throws {Error} If signature is not exactly 64 bytes
+     */
     writeSchnorrSignature(address: Address, signature: Uint8Array): void;
     getBuffer(clear?: boolean): Uint8Array;
     reset(): void;
@@ -34,12 +72,23 @@ export declare class BinaryWriter {
     getOffset(): u32;
     setOffset(offset: u32): void;
     clear(): void;
+    [Symbol.dispose](): void;
     allocSafe(size: u32): void;
     writeAddressValueTuple(map: AddressMap<bigint>, be?: boolean): void;
+    /**
+     * Writes a map of full Address -> u256 using the tweaked key for map lookup.
+     * Format: [u16 length][FullAddress key][u256 value]...
+     *
+     * This is the equivalent of btc-runtime's writeExtendedAddressMapU256().
+     */
     writeExtendedAddressMapU256(map: ExtendedAddressMap<bigint>, be?: boolean): void;
     writeBytesWithLength(value: Uint8Array): void;
     writeArrayOfBuffer(values: Uint8Array[], be?: boolean): void;
     writeAddressArray(value: Address[]): void;
+    /**
+     * Writes an array of full addresses (64 bytes each).
+     * Format: [u16 length][FullAddress 0][FullAddress 1]...
+     */
     writeExtendedAddressArray(value: Address[]): void;
     writeU32Array(value: u32[], be?: boolean): void;
     writeU256Array(value: bigint[], be?: boolean): void;
@@ -53,3 +102,4 @@ export declare class BinaryWriter {
     private resize;
     private getDefaultBuffer;
 }
+//# sourceMappingURL=BinaryWriter.d.ts.map

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

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

package/build/buffer/BinaryWriter.js

@@ -1,9 +1,13 @@
+import { AddressMap } from '../deterministic/AddressMap.js';
+import { ExtendedAddressMap } from '../deterministic/ExtendedAddressMap.js';
+import { Address } from '../keypair/Address.js';
 import { BufferHelper } from '../utils/BufferHelper.js';
 import { ADDRESS_BYTE_LENGTH, EXTENDED_ADDRESS_BYTE_LENGTH, I128_BYTE_LENGTH, I16_BYTE_LENGTH, I32_BYTE_LENGTH, I64_BYTE_LENGTH, I8_BYTE_LENGTH, SCHNORR_SIGNATURE_BYTE_LENGTH, U128_BYTE_LENGTH, U16_BYTE_LENGTH, U256_BYTE_LENGTH, U32_BYTE_LENGTH, U64_BYTE_LENGTH, U8_BYTE_LENGTH, } from '../utils/lengths.js';
 import { BinaryReader } from './BinaryReader.js';
 export class BinaryWriter {
+    currentOffset = 0;
+    buffer;
     constructor(length = 0) {
-        this.currentOffset = 0;
         this.buffer = this.getDefaultBuffer(length);
     }
     static estimateArrayOfBufferLength(values) {
@@ -11,7 +15,7 @@ export class BinaryWriter {
             throw new Error('Array size is too large');
         let totalLength = U16_BYTE_LENGTH;
         for (let i = 0; i < values.length; i++) {
-            totalLength += U32_BYTE_LENGTH + values[i].length;
+            totalLength += U32_BYTE_LENGTH + values[i].length; // each entry has a u32 length prefix
         }
         return totalLength;
     }
@@ -42,6 +46,10 @@ export class BinaryWriter {
         this.buffer.setBigUint64(this.currentOffset, value, !be);
         this.currentOffset += 8;
     }
+    // ------------------- Signed Integer Writers ------------------- //
+    /**
+     * Writes a signed 8-bit integer.
+     */
     writeI8(value) {
         if (value < -128 || value > 127)
             throw new Error('i8 value is out of range.');
@@ -49,6 +57,9 @@ export class BinaryWriter {
         this.buffer.setInt8(this.currentOffset, value);
         this.currentOffset += I8_BYTE_LENGTH;
     }
+    /**
+     * Writes a signed 16-bit integer. By default big-endian (be = true).
+     */
     writeI16(value, be = true) {
         if (value < -32768 || value > 32767)
             throw new Error('i16 value is out of range.');
@@ -56,6 +67,9 @@ export class BinaryWriter {
         this.buffer.setInt16(this.currentOffset, value, !be);
         this.currentOffset += I16_BYTE_LENGTH;
     }
+    /**
+     * Writes a signed 32-bit integer. By default big-endian (be = true).
+     */
     writeI32(value, be = true) {
         if (value < -2147483648 || value > 2147483647)
             throw new Error('i32 value is out of range.');
@@ -63,6 +77,9 @@ export class BinaryWriter {
         this.buffer.setInt32(this.currentOffset, value, !be);
         this.currentOffset += I32_BYTE_LENGTH;
     }
+    /**
+     * Writes a signed 64-bit integer. By default big-endian (be = true).
+     */
     writeI64(value, be = true) {
         if (value < -9223372036854775808n || value > 9223372036854775807n) {
             throw new Error('i64 value is out of range.');
@@ -71,6 +88,7 @@ export class BinaryWriter {
         this.buffer.setBigInt64(this.currentOffset, value, !be);
         this.currentOffset += I64_BYTE_LENGTH;
     }
+    // ---------------------------------------------------------------- //
     writeSelector(value) {
         this.writeU32(value, true);
     }
@@ -159,20 +177,48 @@ export class BinaryWriter {
         this.writeU32(bytes.length);
         this.writeBytes(bytes);
     }
+    /**
+     * Writes an address (32 bytes MLDSA key hash only).
+     */
     writeAddress(value) {
         this.verifyAddress(value);
         this.writeBytes(value);
     }
+    /**
+     * Writes the tweaked public key from an Address (32 bytes).
+     * @param value - The Address containing the tweaked public key
+     */
     writeTweakedPublicKey(value) {
         const tweakedKey = value.tweakedPublicKeyToBuffer();
         this.allocSafe(ADDRESS_BYTE_LENGTH);
         this.writeBytes(tweakedKey);
     }
+    /**
+     * Writes a full address with both tweaked public key and MLDSA key hash (64 bytes total).
+     * Format: [32 bytes tweakedPublicKey][32 bytes MLDSA key hash]
+     *
+     * This is the equivalent of btc-runtime's writeExtendedAddress().
+     *
+     * @param value - The Address containing both keys
+     */
     writeExtendedAddress(value) {
         this.allocSafe(EXTENDED_ADDRESS_BYTE_LENGTH);
+        // Write tweaked public key first (32 bytes)
         this.writeTweakedPublicKey(value);
+        // Write MLDSA key hash (32 bytes)
         this.writeBytes(value);
     }
+    /**
+     * Writes a Schnorr signature with its associated full Address.
+     * Format: [64 bytes full Address][64 bytes signature]
+     *
+     * Used for serializing signed data where both the signer's address
+     * and their Schnorr signature need to be stored together.
+     *
+     * @param address - The signer's Address (with both MLDSA and tweaked keys)
+     * @param signature - The 64-byte Schnorr signature
+     * @throws {Error} If signature is not exactly 64 bytes
+     */
     writeSchnorrSignature(address, signature) {
         if (signature.length !== SCHNORR_SIGNATURE_BYTE_LENGTH) {
             throw new Error(`Invalid Schnorr signature length: expected ${SCHNORR_SIGNATURE_BYTE_LENGTH}, got ${signature.length}`);
@@ -207,6 +253,9 @@ export class BinaryWriter {
         this.currentOffset = 0;
         this.buffer = this.getDefaultBuffer();
     }
+    [Symbol.dispose]() {
+        this.clear();
+    }
     allocSafe(size) {
         if (this.currentOffset + size > this.buffer.byteLength) {
             this.resize(size);
@@ -226,6 +275,12 @@ export class BinaryWriter {
             this.writeU256(value, be);
         }
     }
+    /**
+     * Writes a map of full Address -> u256 using the tweaked key for map lookup.
+     * Format: [u16 length][FullAddress key][u256 value]...
+     *
+     * This is the equivalent of btc-runtime's writeExtendedAddressMapU256().
+     */
     writeExtendedAddressMapU256(map, be = true) {
         if (map.size > 65535)
             throw new Error('Map size is too large');
@@ -256,6 +311,10 @@ export class BinaryWriter {
             this.writeAddress(value[i]);
         }
     }
+    /**
+     * Writes an array of full addresses (64 bytes each).
+     * Format: [u16 length][FullAddress 0][FullAddress 1]...
+     */
     writeExtendedAddressArray(value) {
         if (value.length > 65535)
             throw new Error('Array size is too large');
@@ -345,3 +404,4 @@ export class BinaryWriter {
         return new DataView(new ArrayBuffer(length));
     }
 }
+//# sourceMappingURL=BinaryWriter.js.map

package/build/buffer/BinaryWriter.js.map

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

package/build/bytecode/Compressor.d.ts

@@ -1,5 +1,17 @@
+/** Compressor class for compressing and decompressing data. */
 export declare class Compressor {
     private static readonly zlibOptions;
+    /**
+     * Compresses the data using gzip.
+     * @param {Uint8Array | Buffer} data The data to compress.
+     * @returns {Buffer} The compressed data.
+     */
     static compress(data: Uint8Array | Buffer): Buffer;
+    /**
+     * Decompresses the data using gunzip.
+     * @param {Uint8Array | Buffer} data The data to decompress.
+     * @returns {Buffer} The decompressed data.
+     */
     static decompress(data: Uint8Array | Buffer): Buffer;
 }
+//# sourceMappingURL=Compressor.d.ts.map