@bsv/sdk 2.0.0-beta.0 → 2.0.0

package/dist/types/src/primitives/Secp256r1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Secp256r1.d.ts","sourceRoot":"","sources":["../../../../src/primitives/Secp256r1.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA;AAEvD,KAAK,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAAA;AAiBvD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC;;;MAAI;IAEd,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAUrB,eAAe,CAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS;IAMjD;;OAEG;IACH,YAAY,CAAE,GAAG,EAAE,MAAM,GAAG,SAAS;IAkBrC;;OAEG;IACH,UAAU,CAAE,CAAC,EAAE,SAAS,EAAE,UAAU,UAAQ,GAAG,MAAM;IASrD;;OAEG;IACH,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,GAAG,CAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS;IAI7C;;OAEG;IACH,QAAQ,CAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAetD;;OAEG;IACH,YAAY,CAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,SAAS,CAAE,CAAC,EAAE,SAAS,GAAG,OAAO;IASjC;;OAEG;IACH,qBAAqB,IAAK,MAAM;IAIhC,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,QAAQ;IAUhB,oBAAoB,CAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK7D;;;OAGG;IACH,IAAI,CAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IA6BrI;;OAEG;IACH,MAAM,CAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE;QAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO;IAwB/J,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,YAAY;CAGrB"}
+{"version":3,"file":"Secp256r1.d.ts","sourceRoot":"","sources":["../../../../src/primitives/Secp256r1.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA;AAEvD,KAAK,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAAA;AAiBvD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC,SAAI;IACd,QAAQ,CAAC,CAAC;WA9BiB,MAAM;WAAK,MAAM;MA8B9B;IAEd,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAUrB,eAAe,CAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS;IAMjD;;OAEG;IACH,YAAY,CAAE,GAAG,EAAE,MAAM,GAAG,SAAS;IAkBrC;;OAEG;IACH,UAAU,CAAE,CAAC,EAAE,SAAS,EAAE,UAAU,UAAQ,GAAG,MAAM;IASrD;;OAEG;IACH,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,GAAG,CAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS;IAI7C;;OAEG;IACH,QAAQ,CAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAetD;;OAEG;IACH,YAAY,CAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,SAAS,CAAE,CAAC,EAAE,SAAS,GAAG,OAAO;IASjC;;OAEG;IACH,qBAAqB,IAAK,MAAM;IAIhC,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,QAAQ;IAUhB,oBAAoB,CAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK7D;;;OAGG;IACH,IAAI,CAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IA6BrI;;OAEG;IACH,MAAM,CAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE;QAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO;IAwB/J,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,YAAY;CAGrB"}

package/dist/types/src/primitives/TransactionSignature.d.ts

@@ -22,26 +22,38 @@ interface TransactionSignatureFormatParams {
     lockTime: number;
     scope: number;
     cache?: SignatureHashCache;
+    /**
+     * Supports running bitcoin-abc test vectors which reuses the CHRONICLE bit.
+     */
+    ignoreChronicle?: boolean;
 }
 export default class TransactionSignature extends Signature {
     static readonly SIGHASH_ALL = 1;
     static readonly SIGHASH_NONE = 2;
     static readonly SIGHASH_SINGLE = 3;
+    static readonly SIGHASH_CHRONICLE = 32;
     static readonly SIGHASH_FORKID = 64;
     static readonly SIGHASH_ANYONECANPAY = 128;
     scope: number;
     /**
-     * Formats the SIGHASH preimage for the targeted input, optionally using a cache to skip recomputing shared hash prefixes.
-     * @param params - Context for the signing input plus transaction metadata.
-     * @param params.cache - Optional cache storing previously computed `hashPrevouts`, `hashSequence`, or `hashOutputs*` values; it will be populated if present.
+     * Implements the original bitcoin transaction signature digest preimage algorithm (OTDA).
+     * @param params
+     * @returns preimage as a byte array
      */
-    static format(params: TransactionSignatureFormatParams): number[];
+    static formatOTDA(params: TransactionSignatureFormatParams): Uint8Array;
     /**
      * Formats the same SIGHASH preimage bytes as `format`, supporting the optional cache for hash reuse.
      * @param params - Context for the signing operation.
      * @param params.cache - Optional `SignatureHashCache` that may already contain hashed prefixes and is populated during formatting.
      * @returns Bytes for signing.
      */
+    static formatBip143(params: TransactionSignatureFormatParams): Uint8Array;
+    /**
+     * Formats the SIGHASH preimage for the targeted input, optionally using a cache to skip recomputing shared hash prefixes.
+     * @param params - Context for the signing input plus transaction metadata.
+     * @param params.cache - Optional cache storing previously computed `hashPrevouts`, `hashSequence`, or `hashOutputs*` values; it will be populated if present.
+     */
+    static format(params: TransactionSignatureFormatParams): number[];
     static formatBytes(params: TransactionSignatureFormatParams): Uint8Array;
     static fromChecksigFormat(buf: number[]): TransactionSignature;
     constructor(r: BigNumber, s: BigNumber, scope: number);

package/dist/types/src/primitives/TransactionSignature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionSignature.d.ts","sourceRoot":"","sources":["../../../../src/primitives/TransactionSignature.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAGtC,OAAO,MAAM,MAAM,qBAAqB,CAAA;AACxC,OAAO,gBAAgB,MAAM,oCAAoC,CAAA;AACjE,OAAO,iBAAiB,MAAM,qCAAqC,CAAA;AAEnE,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC1C;AAED,UAAU,gCAAgC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B;AAID,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,SAAS;IACzD,gBAAuB,WAAW,KAAa;IAC/C,gBAAuB,YAAY,KAAa;IAChD,gBAAuB,cAAc,KAAa;IAClD,gBAAuB,cAAc,MAAa;IAClD,gBAAuB,oBAAoB,OAAa;IAExD,KAAK,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAE,MAAM,EAAE,gCAAgC,GAAG,MAAM,EAAE;IAIlE;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAE,MAAM,EAAE,gCAAgC,GAAG,UAAU;IAgKzE,MAAM,CAAC,kBAAkB,CAAE,GAAG,EAAE,MAAM,EAAE,GAAG,oBAAoB;gBAclD,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;IAKtD;;;;OAIG;IACI,OAAO,IAAK,OAAO;IAe1B,gBAAgB,IAAK,MAAM,EAAE;CAI9B"}
+{"version":3,"file":"TransactionSignature.d.ts","sourceRoot":"","sources":["../../../../src/primitives/TransactionSignature.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAGtC,OAAO,MAAM,MAAM,qBAAqB,CAAA;AAExC,OAAO,gBAAgB,MAAM,oCAAoC,CAAA;AACjE,OAAO,iBAAiB,MAAM,qCAAqC,CAAA;AAEnE,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC1C;AAED,UAAU,gCAAgC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAID,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,SAAS;IACzD,gBAAuB,WAAW,KAAa;IAC/C,gBAAuB,YAAY,KAAa;IAChD,gBAAuB,cAAc,KAAa;IAClD,gBAAuB,iBAAiB,MAAa;IACrD,gBAAuB,cAAc,MAAa;IAClD,gBAAuB,oBAAoB,OAAa;IAExD,KAAK,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAE,MAAM,EAAE,gCAAgC,GAAG,UAAU;IAoFxE;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAE,MAAM,EAAE,gCAAgC,GAAG,UAAU;IAwK1E;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAE,MAAM,EAAE,gCAAgC,GAAG,MAAM,EAAE;IAIlE,MAAM,CAAC,WAAW,CAAE,MAAM,EAAE,gCAAgC,GAAG,UAAU;IAgBzE,MAAM,CAAC,kBAAkB,CAAE,GAAG,EAAE,MAAM,EAAE,GAAG,oBAAoB;gBAclD,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;IAKtD;;;;OAIG;IACI,OAAO,IAAK,OAAO;IAe1B,gBAAgB,IAAK,MAAM,EAAE;CAI9B"}

package/dist/types/src/primitives/WriterUint8Array.d.ts

@@ -0,0 +1,54 @@
+import BigNumber from './BigNumber.js';
+type WriterChunk = readonly number[] | Uint8Array;
+/**
+ * WriterUint8Array is a utility class for writing binary data into a dynamically
+ * growing Uint8Array buffer. It provides methods to write various integer types
+ * and variable-length integers, similar to the Writer class but optimized for
+ * Uint8Array usage.
+ */
+export declare class WriterUint8Array {
+    private buffer;
+    private pos;
+    private capacity;
+    constructor(bufs?: WriterChunk[], initialCapacity?: number);
+    /**
+     * Returns the current length of written data
+     */
+    getLength(): number;
+    /**
+     * @return the written data as Uint8Array copy of the internal buffer
+     */
+    toUint8Array(): Uint8Array;
+    /**
+     * Legacy compatibility method – returns number[] (Byte[])
+     */
+    toArray(): number[];
+    /**
+     * @return the written data as Uint8Array. CAUTION: This is zero-copy subarray of the internal buffer).
+     */
+    toUint8ArrayZeroCopy(): Uint8Array;
+    private ensureCapacity;
+    write(bytes: WriterChunk): this;
+    writeReverse(buf: WriterChunk): this;
+    writeUInt8(value: number): this;
+    writeInt8(value: number): this;
+    writeUInt16LE(value: number): this;
+    writeUInt16BE(value: number): this;
+    writeInt16LE(value: number): this;
+    writeInt16BE(value: number): this;
+    writeUInt32LE(value: number): this;
+    writeUInt32BE(value: number): this;
+    writeInt32LE(value: number): this;
+    writeInt32BE(value: number): this;
+    writeUInt64BEBn(bn: BigNumber): this;
+    writeUInt64LEBn(bn: BigNumber): this;
+    writeUInt64LE(n: number): this;
+    writeVarIntNum(n: number): this;
+    writeVarIntBn(bn: BigNumber): this;
+    /**
+     * Resets the writer to empty state (reuses the buffer)
+     */
+    reset(): void;
+}
+export {};
+//# sourceMappingURL=WriterUint8Array.d.ts.map

package/dist/types/src/primitives/WriterUint8Array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriterUint8Array.d.ts","sourceRoot":"","sources":["../../../../src/primitives/WriterUint8Array.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAGtC,KAAK,WAAW,GAAG,SAAS,MAAM,EAAE,GAAG,UAAU,CAAA;AAEjD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAQ;gBAEX,IAAI,CAAC,EAAE,WAAW,EAAE,EAAE,eAAe,GAAE,MAAY;IAehE;;OAEG;IACH,SAAS,IAAK,MAAM;IAIpB;;OAEG;IACH,YAAY,IAAK,UAAU;IAI3B;;OAEG;IACH,OAAO,IAAK,MAAM,EAAE;IAIpB;;OAEG;IACH,oBAAoB,IAAK,UAAU;IAInC,OAAO,CAAC,cAAc;IAatB,KAAK,CAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAQhC,YAAY,CAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAUrC,UAAU,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC,SAAS,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B,aAAa,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQnC,aAAa,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQnC,YAAY,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC,YAAY,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC,aAAa,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUnC,aAAa,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUnC,YAAY,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC,YAAY,CAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC,eAAe,CAAE,EAAE,EAAE,SAAS,GAAG,IAAI;IAMrC,eAAe,CAAE,EAAE,EAAE,SAAS,GAAG,IAAI;IAMrC,aAAa,CAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAM/B,cAAc,CAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMhC,aAAa,CAAE,EAAE,EAAE,SAAS,GAAG,IAAI;IAMnC;;OAEG;IACH,KAAK,IAAK,IAAI;CAGf"}

package/dist/types/src/primitives/utils.d.ts

@@ -1,20 +1,33 @@
 import BigNumber from './BigNumber.js';
+import { WriterUint8Array } from './WriterUint8Array.js';
+import { ReaderUint8Array } from './ReaderUint8Array.js';
+export { WriterUint8Array };
+export { ReaderUint8Array };
 /**
  * Prepends a '0' to an odd character length word to ensure it has an even number of characters.
  * @param {string} word - The input word.
  * @returns {string} - The word with a leading '0' if it's an odd character length; otherwise, the original word.
  */
 export declare const zero2: (word: string) => string;
-export declare const toHex: (msg: number[]) => string;
+export declare const toHex: (msg: number[] | Uint8Array) => string;
+/**
+ * Converts various message formats into a Uint8Array.
+ * Supports Uint8Array, arrays of bytes, hexadecimal strings, base64 strings, and UTF-8 strings.
+ *
+ * @param {any} msg - The input message (Uint8Array, number[], Array or string).
+ * @param {('hex' | 'utf8' | 'base64')} enc - Specifies the string encoding, if applicable.
+ * @returns {Uint8Array}
+ */
+export declare const toUint8Array: (msg: any, enc?: "hex" | "utf8" | "base64") => Uint8Array;
 /**
  * Converts various message formats into an array of numbers.
  * Supports arrays, hexadecimal strings, base64 strings, and UTF-8 strings.
  *
- * @param {any} msg - The input message (array or string).
+ * @param {any} msg - The input message (Uint8Array, number[], Array or string).
  * @param {('hex' | 'utf8' | 'base64')} enc - Specifies the string encoding, if applicable.
  * @returns {any[]} - Array representation of the input.
  */
-export declare const toArray: (msg: any, enc?: 'hex' | 'utf8' | 'base64') => any[];
+export declare const toArray: (msg: any, enc?: "hex" | "utf8" | "base64") => any[];
 export declare function base64ToArray(msg: string): number[];
 /**
  * Converts an array of numbers to a UTF-8 encoded string.
@@ -28,7 +41,7 @@ export declare const toUTF8: (arr: number[]) => string;
  * @param {('hex' | 'utf8')} enc - The desired encoding.
  * @returns {string | number[]} - The encoded message as a string (for 'hex' and 'utf8') or the original array.
  */
-export declare const encode: (arr: number[], enc?: 'hex' | 'utf8') => string | number[];
+export declare const encode: (arr: number[], enc?: "hex" | "utf8") => string | number[];
 /**
  * Converts an array of bytes (each between 0 and 255) into a base64 encoded string.
  *
@@ -65,7 +78,7 @@ export declare const toBase58Check: (bin: number[], prefix?: number[]) => string
  * @param prefixLength - The length of the prefix. Optional, defaults to 1.
  * @returns The binary array representation
  */
-export declare const fromBase58Check: (str: string, enc?: 'hex', prefixLength?: number) => {
+export declare const fromBase58Check: (str: string, enc?: "hex", prefixLength?: number) => {
     data: number[] | string;
     prefix: number[] | string;
 };
@@ -77,6 +90,7 @@ export declare class Writer {
     getLength(): number;
     toUint8Array(): Uint8Array;
     toArray(): number[];
+    toHex(): string;
     write(buf: WriterChunk): this;
     writeReverse(buf: number[]): this;
     writeUInt8(n: number): this;
@@ -137,5 +151,4 @@ export declare const minimallyEncode: (buf: number[]) => number[];
  */
 export declare function verifyNotNull<T>(value: T | undefined | null, errorMessage?: string): T;
 export declare function constantTimeEquals(a: Uint8Array | number[], b: Uint8Array | number[]): boolean;
-export {};
 //# sourceMappingURL=utils.d.ts.map

package/dist/types/src/primitives/utils.d.ts.map

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

package/dist/types/src/remittance/CommsLayer.d.ts

@@ -0,0 +1,50 @@
+import type { PeerMessage } from './types.js';
+import type { PubKeyHex } from '../wallet/Wallet.interfaces.js';
+/**
+ * Abstract communications layer.
+ *
+ * This intentionally mirrors the essential subset of message-box-client / MessageBoxClient.
+ * RemittanceManager never talks directly to HTTP/WebSockets – it only uses this interface.
+ */
+export interface CommsLayer {
+    /**
+     * Sends a message over the store-and-forward channel. Returns the transport messageId.
+     */
+    sendMessage: (args: {
+        recipient: PubKeyHex;
+        messageBox: string;
+        body: string;
+    }, hostOverride?: string) => Promise<string>;
+    /**
+     * Sends a message over the live channel (e.g. WebSocket). Returns the transport messageId.
+     * Implementers may throw if live sending is not possible.
+     * RemittanceManager will fall back to sendMessage where appropriate.
+     */
+    sendLiveMessage?: (args: {
+        recipient: PubKeyHex;
+        messageBox: string;
+        body: string;
+    }, hostOverride?: string) => Promise<string>;
+    /**
+     * Lists pending messages for a message box.
+     */
+    listMessages: (args: {
+        messageBox: string;
+        host?: string;
+    }) => Promise<PeerMessage[]>;
+    /**
+     * Acknowledges messages (deletes them from the server / inbox).
+     */
+    acknowledgeMessage: (args: {
+        messageIds: string[];
+    }) => Promise<void>;
+    /**
+     * Optional live listener.
+     */
+    listenForLiveMessages?: (args: {
+        messageBox: string;
+        overrideHost?: string;
+        onMessage: (msg: PeerMessage) => void;
+    }) => Promise<void>;
+}
+//# sourceMappingURL=CommsLayer.d.ts.map

package/dist/types/src/remittance/CommsLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommsLayer.d.ts","sourceRoot":"","sources":["../../../../src/remittance/CommsLayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAEzH;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAE9H;;OAEG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAErF;;OAEG;IACH,kBAAkB,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAErE;;OAEG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE;QAC7B,UAAU,EAAE,MAAM,CAAA;QAClB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAA;KACtC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB"}

package/dist/types/src/remittance/IdentityLayer.d.ts

@@ -0,0 +1,35 @@
+import type { IdentityVerificationRequest, IdentityVerificationResponse, IdentityVerificationAcknowledgment, ThreadId, ModuleContext, Termination } from './types.js';
+import { PubKeyHex } from '../wallet/Wallet.interfaces.js';
+/**
+ * The Identity Layer handles identity certificate exchange and verification.
+ * It is optional and pluggable.
+ * Modules can use it to request/verify identity before accepting settlements.
+ *
+ * The runtime configuration can be used to determine whether and at what point identity
+ * exchange occurs: before invoicing, before settlement, etc.
+ *
+ * Makers and takers can both implement this layer as needed, and request/respond to
+ * identity verification at different points in the protocol.
+ */
+export interface IdentityLayer {
+    /** Determine which certificates to request from a counterparty. */
+    determineCertificatesToRequest: (args: {
+        counterparty: PubKeyHex;
+        threadId: ThreadId;
+    }, ctx: ModuleContext) => Promise<IdentityVerificationRequest>;
+    /** Respond to an incoming identity verification request. */
+    respondToRequest: (args: {
+        counterparty: PubKeyHex;
+        threadId: ThreadId;
+        request: IdentityVerificationRequest;
+    }, ctx: ModuleContext) => Promise<{
+        action: 'respond';
+        response: IdentityVerificationResponse;
+    } | {
+        action: 'terminate';
+        termination: Termination;
+    }>;
+    /** Assess whether received certificates satisfy the requirements for transaction settlement. */
+    assessReceivedCertificateSufficiency: (counterparty: PubKeyHex, received: IdentityVerificationResponse, threadId: ThreadId) => Promise<IdentityVerificationAcknowledgment | Termination>;
+}
+//# sourceMappingURL=IdentityLayer.d.ts.map

package/dist/types/src/remittance/IdentityLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityLayer.d.ts","sourceRoot":"","sources":["../../../../src/remittance/IdentityLayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,kCAAkC,EAClC,QAAQ,EACR,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,8BAA8B,EAAE,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAA;IACnJ,4DAA4D;IAC5D,gBAAgB,EAAE,CAChB,IAAI,EAAE;QAAE,YAAY,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,2BAA2B,CAAA;KAAE,EAC3F,GAAG,EAAE,aAAa,KACf,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,4BAA4B,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;IAC/H,gGAAgG;IAChG,oCAAoC,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,kCAAkC,GAAG,WAAW,CAAC,CAAA;CACzL"}