@bsv/sdk 2.0.9 → 2.0.10

package/docs/reference/script.md

@@ -6,6 +6,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 | |
 | --- |
+| [FormatPreimageParams](#interface-formatpreimageparams) |
 | [ScriptChunk](#interface-scriptchunk) |
 | [ScriptTemplate](#interface-scripttemplate) |
 | [ScriptTemplateUnlock](#interface-scripttemplateunlock) |
@@ -14,6 +15,28 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 ---
 
+### Interface: FormatPreimageParams
+
+Parameters for formatting the transaction preimage
+
+```ts
+export interface FormatPreimageParams {
+    tx: Transaction;
+    inputIndex: number;
+    signatureScope: number;
+    sourceTXID: string;
+    sourceSatoshis: number;
+    lockingScript: Script;
+    otherInputs: Transaction["inputs"];
+    inputSequence?: number;
+}
+```
+
+See also: [Script](./script.md#class-script), [Transaction](./transaction.md#class-transaction)
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---
 ### Interface: ScriptChunk
 
 A representation of a chunk of a script, which includes an opcode. For push operations, the associated data to push onto the stack is also included.
@@ -942,6 +965,59 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ---
 ## Functions
 
+| |
+| --- |
+| [computeSignatureScope](#function-computesignaturescope) |
+| [formatPreimage](#function-formatpreimage) |
+| [resolveSourceDetails](#function-resolvesourcedetails) |
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---
+
+### Function: computeSignatureScope
+
+Computes the signature scope flags from the given signing parameters.
+
+```ts
+export function computeSignatureScope(signOutputs: "all" | "none" | "single", anyoneCanPay: boolean): number 
+```
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---
+### Function: formatPreimage
+
+Formats the transaction preimage for signing.
+
+```ts
+export function formatPreimage(params: FormatPreimageParams): number[] 
+```
+
+See also: [FormatPreimageParams](./script.md#interface-formatpreimageparams)
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---
+### Function: resolveSourceDetails
+
+Resolves and validates the source transaction details needed for signing.
+Returns the resolved sourceTXID, sourceSatoshis, lockingScript, and otherInputs.
+
+```ts
+export function resolveSourceDetails(tx: Transaction, inputIndex: number, providedSourceSatoshis?: number, providedLockingScript?: Script): {
+    sourceTXID: string;
+    sourceSatoshis: number;
+    lockingScript: Script;
+    otherInputs: typeof tx.inputs;
+} 
+```
+
+See also: [Script](./script.md#class-script), [Transaction](./transaction.md#class-transaction)
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---
 ## Types
 
 ## Enums

package/docs/reference/transaction.md

@@ -6,14 +6,15 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 | | |
 | --- | --- |
-| [ArcConfig](#interface-arcconfig) | [HttpClientRequestOptions](#interface-httpclientrequestoptions) |
+| [ArcConfig](#interface-arcconfig) | [HttpsModuleLike](#interface-httpsmodulelike) |
 | [BroadcastFailure](#interface-broadcastfailure) | [HttpsNodejs](#interface-httpsnodejs) |
 | [BroadcastResponse](#interface-broadcastresponse) | [MerklePathLeaf](#interface-merklepathleaf) |
 | [Broadcaster](#interface-broadcaster) | [NodejsHttpClientRequest](#interface-nodejshttpclientrequest) |
-| [ChainTracker](#interface-chaintracker) | [TransactionInput](#interface-transactioninput) |
-| [FeeModel](#interface-feemodel) | [TransactionOutput](#interface-transactionoutput) |
-| [FetchOptions](#interface-fetchoptions) | [WhatsOnChainConfig](#interface-whatsonchainconfig) |
-| [HttpClient](#interface-httpclient) |  |
+| [ChainTracker](#interface-chaintracker) | [NodejsRequestLike](#interface-nodejsrequestlike) |
+| [FeeModel](#interface-feemodel) | [TransactionInput](#interface-transactioninput) |
+| [FetchOptions](#interface-fetchoptions) | [TransactionOutput](#interface-transactionoutput) |
+| [HttpClient](#interface-httpclient) | [WhatsOnChainConfig](#interface-whatsonchainconfig) |
+| [HttpClientRequestOptions](#interface-httpclientrequestoptions) |  |
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
@@ -297,6 +298,21 @@ signal?: AbortSignal
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
+---
+### Interface: HttpsModuleLike
+
+Common interface for Node.js https modules
+
+```ts
+export interface HttpsModuleLike {
+    request: (url: string, options: HttpClientRequestOptions, callback: (res: any) => void) => NodejsRequestLike;
+}
+```
+
+See also: [HttpClientRequestOptions](./transaction.md#interface-httpclientrequestoptions), [NodejsRequestLike](./transaction.md#interface-nodejsrequestlike)
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
 ---
 ### Interface: HttpsNodejs
 
@@ -335,7 +351,22 @@ Nodejs result of the Node https.request call limited to options needed by ts-sdk
 export interface NodejsHttpClientRequest {
     write: (chunk: string) => void;
     on: (event: string, callback: (data: any) => void) => void;
-    end: (() => void) & (() => void);
+    end: () => void;
+}
+```
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---
+### Interface: NodejsRequestLike
+
+Common interface for Node.js https module request objects
+
+```ts
+export interface NodejsRequestLike {
+    write: (chunk: any) => void;
+    on: (event: string, callback: (data: any) => void) => void;
+    end: () => void;
 }
 ```
 
@@ -2351,6 +2382,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 | [defaultBroadcaster](#function-defaultbroadcaster) |
 | [defaultChainTracker](#function-defaultchaintracker) |
 | [defaultHttpClient](#function-defaulthttpclient) |
+| [executeNodejsRequest](#function-executenodejsrequest) |
 | [isBroadcastFailure](#function-isbroadcastfailure) |
 | [isBroadcastResponse](#function-isbroadcastresponse) |
 
@@ -2394,6 +2426,31 @@ See also: [HttpClient](./transaction.md#interface-httpclient)
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
+---
+### Function: executeNodejsRequest
+
+Shared implementation for handling Node.js HTTP requests.
+Used by both NodejsHttpClient and BinaryNodejsHttpClient.
+
+```ts
+export function executeNodejsRequest(https: HttpsModuleLike, url: string, requestOptions: HttpClientRequestOptions, serializeData: (data: any) => any): Promise<HttpClientResponse> 
+```
+
+See also: [HttpClientRequestOptions](./transaction.md#interface-httpclientrequestoptions), [HttpClientResponse](./transaction.md#type-httpclientresponse), [HttpsModuleLike](./transaction.md#interface-httpsmodulelike)
+
+Argument Details
+
++ **https**
+  + The Node.js https module (or compatible)
++ **url**
+  + The URL to make the request to
++ **requestOptions**
+  + The request configuration
++ **serializeData**
+  + Function to serialize the request data for writing
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
 ---
 ### Function: isBroadcastFailure