@btc-vision/transaction 1.8.0-beta.0 → 1.8.0-beta.10

package/build/abi/TupleUtils.d.ts

@@ -0,0 +1,25 @@
+import { ABIDataTypes } from './ABIDataTypes.js';
+import type { AbiType } from './AbiTypes.js';
+/**
+ * Type guard: returns true if the ABI type is a tuple (ordered array of types).
+ */
+export declare function isAbiTuple(type: AbiType): type is AbiType[];
+/**
+ * Type guard: returns true if the ABI type is a struct (named fields).
+ */
+export declare function isAbiStruct(type: AbiType): type is {
+    [field: string]: AbiType;
+};
+/**
+ * Type guard: returns true if the ABI type is a simple ABIDataTypes enum value.
+ */
+export declare function isSimpleAbiType(type: AbiType): type is ABIDataTypes;
+/**
+ * Converts a structured AbiType into a canonical selector string.
+ * - Simple: ABIDataTypes.ADDRESS → "address"
+ * - Struct: { a: ADDRESS, b: UINT256 } → "tuple(address,uint256)" (inline, no [])
+ * - Single-element tuple: [UINT256] → "uint256[]"
+ * - Multi-element tuple: [ADDRESS, UINT256] → "tuple(address,uint256)[]"
+ */
+export declare function abiTypeToSelectorString(type: AbiType): string;
+//# sourceMappingURL=TupleUtils.d.ts.map

package/build/abi/TupleUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TupleUtils.d.ts","sourceRoot":"","sources":["../../src/abi/TupleUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,OAAO,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAwB7D"}

package/build/abi/TupleUtils.js

@@ -0,0 +1,50 @@
+import { ABIDataTypes } from './ABIDataTypes.js';
+import { AbiTypeToStr } from './AbiTypes.js';
+/**
+ * Type guard: returns true if the ABI type is a tuple (ordered array of types).
+ */
+export function isAbiTuple(type) {
+    return Array.isArray(type);
+}
+/**
+ * Type guard: returns true if the ABI type is a struct (named fields).
+ */
+export function isAbiStruct(type) {
+    return typeof type === 'object' && type !== null && !Array.isArray(type);
+}
+/**
+ * Type guard: returns true if the ABI type is a simple ABIDataTypes enum value.
+ */
+export function isSimpleAbiType(type) {
+    return typeof type === 'string';
+}
+/**
+ * Converts a structured AbiType into a canonical selector string.
+ * - Simple: ABIDataTypes.ADDRESS → "address"
+ * - Struct: { a: ADDRESS, b: UINT256 } → "tuple(address,uint256)" (inline, no [])
+ * - Single-element tuple: [UINT256] → "uint256[]"
+ * - Multi-element tuple: [ADDRESS, UINT256] → "tuple(address,uint256)[]"
+ */
+export function abiTypeToSelectorString(type) {
+    if (isSimpleAbiType(type)) {
+        const str = AbiTypeToStr[type];
+        if (!str) {
+            throw new Error(`Unknown ABI type: ${type}`);
+        }
+        return str;
+    }
+    // Struct: inline tuple (no [] suffix)
+    if (isAbiStruct(type)) {
+        const inner = Object.values(type).map((t) => abiTypeToSelectorString(t)).join(',');
+        return `tuple(${inner})`;
+    }
+    // Single-element tuple: unwrap to "type[]"
+    const firstType = type[0];
+    if (type.length === 1 && firstType !== undefined) {
+        return `${abiTypeToSelectorString(firstType)}[]`;
+    }
+    // Multi-element tuple: "tuple(types...)[]"
+    const inner = type.map((t) => abiTypeToSelectorString(t)).join(',');
+    return `tuple(${inner})[]`;
+}
+//# sourceMappingURL=TupleUtils.js.map

package/build/abi/TupleUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TupleUtils.js","sourceRoot":"","sources":["../../src/abi/TupleUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IACzC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAa;IACjD,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,sCAAsC;IACtC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnF,OAAO,SAAS,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,2CAA2C;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC/C,OAAO,GAAG,uBAAuB,CAAC,SAAS,CAAC,IAAI,CAAC;IACrD,CAAC;IAED,2CAA2C;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,SAAS,KAAK,KAAK,CAAC;AAC/B,CAAC"}

package/build/branded/Branded.d.ts

@@ -0,0 +1,4 @@
+import type { Brand } from '@btc-vision/ecpair';
+export type MLDSAHashedPublicKey = Brand<Uint8Array, 'MLDSAHashedPublicKey'>;
+export type HybridPublicKey = Brand<Uint8Array, 'HybridPublicKey'>;
+//# sourceMappingURL=Branded.d.ts.map

package/build/branded/Branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Branded.d.ts","sourceRoot":"","sources":["../../src/branded/Branded.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;AAE7E,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC"}

package/build/branded/Branded.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Branded.js.map

package/build/branded/Branded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Branded.js","sourceRoot":"","sources":["../../src/branded/Branded.ts"],"names":[],"mappings":""}

package/build/buffer/BinaryReader.d.ts

@@ -1,42 +1,138 @@
 import { AddressMap } from '../deterministic/AddressMap.js';
 import { ExtendedAddressMap } from '../deterministic/ExtendedAddressMap.js';
 import { Address } from '../keypair/Address.js';
-import { BufferLike, i16, i32, i64, i8, Selector, u16, u32, u8 } from '../utils/types.js';
+import type { BufferLike, i16, i32, i64, i8, Selector, u16, u32, u8 } from '../utils/types.js';
+/**
+ * Represents a Schnorr signature paired with the signer's Address.
+ * This class bundles a 64-byte Schnorr signature with its associated
+ * full Address (both MLDSA and tweaked keys), providing a complete signed data structure
+ * for Bitcoin Taproot-compatible signatures.
+ */
 export interface SchnorrSignature {
+    /** The signer's Address containing both MLDSA and tweaked public keys */
     readonly address: Address;
+    /** The 64-byte Schnorr signature */
     readonly signature: Uint8Array;
 }
 export declare class BinaryReader {
     private buffer;
     private currentOffset;
     constructor(bytes: BufferLike);
+    get byteLength(): number;
     static stringCompare(a: string, b: string): number;
     static bigintCompare(a: bigint, b: bigint): number;
     static numberCompare(a: number, b: number): number;
     setBuffer(bytes: BufferLike): void;
-    get byteLength(): number;
     length(): number;
     bytesLeft(): number;
+    /**
+     * Reads a single signed byte (i8).
+     */
     readI8(): i8;
+    /**
+     * Reads a signed 16-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readI16(be?: boolean): i16;
+    /**
+     * Reads a signed 32-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readI32(be?: boolean): i32;
+    /**
+     * Reads a signed 64-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readI64(be?: boolean): i64;
+    /**
+     * Reads a single unsigned byte (u8).
+     */
     readU8(): u8;
+    /**
+     * Reads an unsigned 16-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readU16(be?: boolean): u16;
+    /**
+     * Reads an unsigned 32-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readU32(be?: boolean): u32;
+    /**
+     * Reads an unsigned 64-bit integer. By default, big-endian.
+     * @param be - Endianness; true means big-endian (the default).
+     */
     readU64(be?: boolean): bigint;
+    /**
+     * Reads a 128-bit unsigned integer. By default, read big-endian.
+     * @param be - Endianness; true => big-endian (default).
+     */
     readU128(be?: boolean): bigint;
+    /**
+     * Reads a 256-bit unsigned integer. Same approach as readU128.
+     * @param be - Endianness; true => big-endian (default).
+     */
     readU256(be?: boolean): bigint;
+    /**
+     * Reads a 128-bit signed integer. Interpret the sign bit if big-endian.
+     * @param be - Endianness; true => big-endian (default).
+     */
     readI128(be?: boolean): bigint;
+    /**
+     * Read a boolean (u8 != 0).
+     */
     readBoolean(): boolean;
+    /**
+     * Reads 32 bits
+     */
     readSelector(): Selector;
+    /**
+     * Reads a raw sequence of bytes (length must be known).
+     * If zeroStop = true, stops if we encounter 0x00 early.
+     */
     readBytes(length: u32, zeroStop?: boolean): Uint8Array;
+    /**
+     * 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: u32): string;
+    /**
+     * Reads a string that was written as [u16 length][raw bytes].
+     */
     readStringWithLength(be?: boolean): string;
+    /**
+     * Reads an address (32 bytes MLDSA key hash only).
+     */
     readAddress(): Address;
+    /**
+     * 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(): Uint8Array;
+    /**
+     * 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(): Address;
+    /**
+     * 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(): SchnorrSignature;
+    /**
+     * Reads bytes written as [u32 length][bytes].
+     * @param maxLength if > 0, enforces an upper bound
+     * @param be
+     */
     readBytesWithLength(maxLength?: number, be?: boolean): Uint8Array;
     readArrayOfBuffer(be?: boolean): Uint8Array[];
     readAddressArray(be?: boolean): Address[];
@@ -48,12 +144,35 @@ export declare class BinaryReader {
     readU8Array(): u8[];
     readStringArray(be?: boolean): string[];
     readBytesArray(be?: boolean): Uint8Array[];
+    /**
+     * Reads [u16 length][ (address, u256) pairs ].
+     */
     readAddressValueTuple(be?: boolean): AddressMap<bigint>;
+    /**
+     * Reads an array of full addresses (64 bytes each).
+     * Format: [u16 length][FullAddress 0][FullAddress 1]...
+     */
     readExtendedAddressArray(be?: boolean): Address[];
+    /**
+     * 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?: boolean): ExtendedAddressMap<bigint>;
     getOffset(): u16;
     setOffset(offset: u16): void;
+    /**
+     * Verifies we have enough bytes in the buffer to read up to `size`.
+     */
     verifyEnd(size: number): void;
+    /**
+     * Utility: reverses a byte array in-place or returns a reversed copy.
+     */
     private reverseBytes;
+    /**
+     * Utility: turn bytes into a hex string without `0x` prefix.
+     */
     private toHexString;
 }
+//# sourceMappingURL=BinaryReader.d.ts.map

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

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

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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"}