doc

Author: ty-everett

docs/reference/primitives.md

@@ -4716,6 +4716,40 @@ export default class TransactionSignature extends Signature {
 
 See also: [BigNumber](./primitives.md#class-bignumber), [Signature](./primitives.md#class-signature)
 
+#### Method format
+
+Formats the SIGHASH preimage for the targeted input, optionally using a cache to skip recomputing shared hash prefixes.
+
+```ts
+static format(params: TransactionSignatureFormatParams): number[] 
+```
+
+Argument Details
+
++ **params**
+  + Context for the signing input plus transaction metadata.
++ **params.cache**
+  + Optional cache storing previously computed `hashPrevouts`, `hashSequence`, or `hashOutputs*` values; it will be populated if present.
+
+#### Method formatBytes
+
+Formats the same SIGHASH preimage bytes as `format`, supporting the optional cache for hash reuse.
+
+```ts
+static formatBytes(params: TransactionSignatureFormatParams): Uint8Array 
+```
+
+Returns
+
+Bytes for signing.
+
+Argument Details
+
++ **params**
+  + Context for the signing operation.
++ **params.cache**
+  + Optional `SignatureHashCache` that may already contain hashed prefixes and is populated during formatting.
+
 #### Method hasLowS
 
 Compares to bitcoind's IsLowDERSignature

docs/reference/script.md

@@ -457,6 +457,12 @@ Argument Details
 
 + **chunks**
   + =[] - An array of script chunks to directly initialize the script.
++ **rawBytesCache**
+  + Optional serialized bytes that can be reused instead of reserializing `chunks`.
++ **hexCache**
+  + Optional lowercase hex string that matches the serialized bytes, used to satisfy `toHex` quickly.
++ **parsed**
+  + When false the script defers parsing `rawBytesCache` until `chunks` is accessed; defaults to true.
 
 #### Method findAndDelete
 

src/primitives/TransactionSignature.ts

@@ -39,10 +39,21 @@ export default class TransactionSignature extends Signature {
 
   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.
+   */
   static format (params: TransactionSignatureFormatParams): number[] {
     return Array.from(this.formatBytes(params))
   }
 
+  /**
+   * 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 formatBytes (params: TransactionSignatureFormatParams): Uint8Array {
     const cache = params.cache
     const currentInput = {

src/script/Script.ts

@@ -138,6 +138,9 @@ export default class Script {
    * @constructor
    * Constructs a new Script object.
    * @param chunks=[] - An array of script chunks to directly initialize the script.
+   * @param rawBytesCache - Optional serialized bytes that can be reused instead of reserializing `chunks`.
+   * @param hexCache - Optional lowercase hex string that matches the serialized bytes, used to satisfy `toHex` quickly.
+   * @param parsed - When false the script defers parsing `rawBytesCache` until `chunks` is accessed; defaults to true.
    */
   constructor (chunks: ScriptChunk[] = [], rawBytesCache?: Uint8Array, hexCache?: string, parsed: boolean = true) {
     this._chunks = chunks