@bsv/sdk 1.2.4 → 1.2.5

package/docs/transaction.md

@@ -498,6 +498,7 @@ export default class ARC implements Broadcaster {
     constructor(URL: string, apiKey?: string);
     constructor(URL: string, config?: string | ArcConfig) 
     async broadcast(tx: Transaction): Promise<BroadcastResponse | BroadcastFailure> 
+    async broadcastMany(txs: Transaction[]): Promise<Array<object>> 
 }
 ```
 
@@ -556,6 +557,25 @@ Argument Details
 + **tx**
   + The transaction to be broadcasted.
 
+#### Method broadcastMany
+
+Broadcasts multiple transactions via ARC.
+Handles mixed responses where some transactions succeed and others fail.
+
+```ts
+async broadcastMany(txs: Transaction[]): Promise<Array<object>> 
+```
+See also: [Transaction](#class-transaction)
+
+Returns
+
+A promise that resolves to an array of objects.
+
+Argument Details
+
++ **txs**
+  + Array of transactions to be broadcasted.
+
 </details>
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
@@ -2038,10 +2058,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Function: defaultBroadcaster
 
 ```ts
-export function defaultBroadcaster(): Broadcaster 
+export function defaultBroadcaster(isTestnet: boolean = false, config: ArcConfig = {}): Broadcaster 
 ```
 
-See also: [Broadcaster](#interface-broadcaster)
+See also: [ArcConfig](#interface-arcconfig), [Broadcaster](#interface-broadcaster)
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 

package/docs/wallet.md

@@ -111,8 +111,8 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 export interface CreateActionArgs {
     description: DescriptionString5to50Bytes;
     inputBEEF?: BEEF;
-    inputs?: Array<CreateActionInput>;
-    outputs?: Array<CreateActionOutput>;
+    inputs?: CreateActionInput[];
+    outputs?: CreateActionOutput[];
     lockTime?: PositiveIntegerOrZero;
     version?: PositiveIntegerOrZero;
     labels?: LabelStringUnder300Bytes[];
@@ -188,7 +188,7 @@ export interface CreateActionResult {
     txid?: TXIDHexString;
     tx?: AtomicBEEF;
     noSendChange?: OutpointString[];
-    sendWithResults?: Array<SendWithResult>;
+    sendWithResults?: SendWithResult[];
     signableTransaction?: SignableTransaction;
 }
 ```
@@ -262,7 +262,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ```ts
 export interface DiscoverCertificatesResult {
     totalCertificates: PositiveIntegerOrZero;
-    certificates: Array<IdentityCertificate>;
+    certificates: IdentityCertificate[];
 }
 ```
 
@@ -325,7 +325,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ```ts
 export interface InternalizeActionArgs {
     tx: AtomicBEEF;
-    outputs: Array<InternalizeOutput>;
+    outputs: InternalizeOutput[];
     description: DescriptionString5to50Bytes;
     labels?: LabelStringUnder300Bytes[];
     seekPermission?: BooleanDefaultTrue;
@@ -426,7 +426,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ```ts
 export interface ListActionsResult {
     totalActions: PositiveIntegerOrZero;
-    actions: Array<WalletAction>;
+    actions: WalletAction[];
 }
 ```
 
@@ -458,7 +458,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ```ts
 export interface ListCertificatesResult {
     totalCertificates: PositiveIntegerOrZero;
-    certificates: Array<WalletCertificate>;
+    certificates: WalletCertificate[];
 }
 ```
 
@@ -495,7 +495,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 export interface ListOutputsResult {
     totalOutputs: PositiveIntegerOrZero;
     BEEF?: BEEF;
-    outputs: Array<WalletOutput>;
+    outputs: WalletOutput[];
 }
 ```
 
@@ -657,7 +657,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 export interface SignActionResult {
     txid?: TXIDHexString;
     tx?: AtomicBEEF;
-    sendWithResults?: Array<SendWithResult>;
+    sendWithResults?: SendWithResult[];
 }
 ```
 
@@ -1116,8 +1116,8 @@ export interface WalletAction {
     labels?: LabelStringUnder300Bytes[];
     version: PositiveIntegerOrZero;
     lockTime: PositiveIntegerOrZero;
-    inputs?: Array<WalletActionInput>;
-    outputs?: Array<WalletActionOutput>;
+    inputs?: WalletActionInput[];
+    outputs?: WalletActionOutput[];
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/sdk",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "type": "module",
   "description": "BSV Blockchain Software Development Kit",
   "main": "dist/cjs/mod.js",

package/src/transaction/broadcasters/ARC.ts

@@ -21,7 +21,7 @@ export interface ArcConfig {
   headers?: Record<string, string>
 }
 
-function defaultDeploymentId () {
+function defaultDeploymentId() {
   return `ts-sdk-${toHex(Random(16))}`
 }
 
@@ -43,16 +43,16 @@ export default class ARC implements Broadcaster {
    * @param {string} URL - The URL endpoint for the ARC API.
    * @param {ArcConfig} config - Configuration options for the ARC broadcaster.
    */
-  constructor (URL: string, config?: ArcConfig)
+  constructor(URL: string, config?: ArcConfig)
   /**
    * Constructs an instance of the ARC broadcaster.
    *
    * @param {string} URL - The URL endpoint for the ARC API.
    * @param {string} apiKey - The API key used for authorization with the ARC API.
    */
-  constructor (URL: string, apiKey?: string)
+  constructor(URL: string, apiKey?: string)
 
-  constructor (URL: string, config?: string | ArcConfig) {
+  constructor(URL: string, config?: string | ArcConfig) {
     this.URL = URL
     if (typeof config === 'string') {
       this.apiKey = config
@@ -71,13 +71,43 @@ export default class ARC implements Broadcaster {
     }
   }
 
+  /**
+   * Constructs a dictionary of the default & supplied request headers.
+   */
+  private requestHeaders() {
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'XDeployment-ID': this.deploymentId
+    }
+
+    if (this.apiKey) {
+      headers.Authorization = `Bearer ${this.apiKey}`
+    }
+
+    if (this.callbackUrl) {
+      headers['X-CallbackUrl'] = this.callbackUrl
+    }
+
+    if (this.callbackToken) {
+      headers['X-CallbackToken'] = this.callbackToken
+    }
+
+    if (this.headers) {
+      for (const key in this.headers) {
+        headers[key] = this.headers[key]
+      }
+    }
+
+    return headers
+  }
+
   /**
    * Broadcasts a transaction via ARC.
    *
    * @param {Transaction} tx - The transaction to be broadcasted.
    * @returns {Promise<BroadcastResponse | BroadcastFailure>} A promise that resolves to either a success or failure response.
    */
-  async broadcast (tx: Transaction): Promise<BroadcastResponse | BroadcastFailure> {
+  async broadcast(tx: Transaction): Promise<BroadcastResponse | BroadcastFailure> {
     let rawTx
     try {
       rawTx = tx.toHexEF()
@@ -99,7 +129,7 @@ export default class ARC implements Broadcaster {
       const response = await this.httpClient.request<ArcResponse>(`${this.URL}/v1/tx`, requestOptions)
       if (response.ok) {
         const { txid, extraInfo, txStatus, competingTxs } = response.data
-        let broadcastRes : BroadcastResponse = {
+        let broadcastRes: BroadcastResponse = {
           status: 'success',
           txid,
           message: `${txStatus} ${extraInfo}`
@@ -143,31 +173,46 @@ export default class ARC implements Broadcaster {
     }
   }
 
-  private requestHeaders () {
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-      'XDeployment-ID': this.deploymentId
-    }
-
-    if (this.apiKey) {
-      headers.Authorization = `Bearer ${this.apiKey}`
-    }
+  /**
+   * Broadcasts multiple transactions via ARC.
+   * Handles mixed responses where some transactions succeed and others fail.
+   *
+   * @param {Transaction[]} txs - Array of transactions to be broadcasted.
+   * @returns {Promise<Array<object>>} A promise that resolves to an array of objects.
+   */
+  async broadcastMany(txs: Transaction[]): Promise<Array<object>> {
+    const rawTxs = txs.map(tx => {
+      try {
+        return { rawTx: tx.toHexEF() };
+      } catch (error) {
+        if (error.message === 'All inputs must have source transactions when serializing to EF format') {
+          return { rawTx: tx.toHex() };
+        }
+        throw error;
+      }
+    });
 
-    if (this.callbackUrl) {
-      headers['X-CallbackUrl'] = this.callbackUrl
-    }
+    const requestOptions: HttpClientRequestOptions = {
+      method: 'POST',
+      headers: this.requestHeaders(),
+      data: rawTxs
+    };
 
-    if (this.callbackToken) {
-      headers['X-CallbackToken'] = this.callbackToken
-    }
+    try {
+      const response = await this.httpClient.request<Array<object>>(
+        `${this.URL}/v1/txs`,
+        requestOptions
+      );
 
-    if (this.headers) {
-      for (const key in this.headers) {
-        headers[key] = this.headers[key]
-      }
+      return response.data
+    } catch (error) {
+      const errorResponse: BroadcastFailure = {
+        status: 'error',
+        code: '500',
+        description: error.message || 'Internal Server Error'
+      };
+      return txs.map(() => errorResponse);
     }
-
-    return headers
   }
 }
 

package/src/transaction/broadcasters/DefaultBroadcaster.ts

@@ -1,6 +1,6 @@
 import { Broadcaster } from '../Broadcaster.js'
-import ARC from './ARC.js'
+import ARC, { ArcConfig } from './ARC.js'
 
-export function defaultBroadcaster (): Broadcaster {
-  return new ARC('https://arc.taal.com')
-}
+export function defaultBroadcaster (isTestnet: boolean = false, config: ArcConfig = {}): Broadcaster {
+  return new ARC(isTestnet ? 'https://arc-test.taal.com' : 'https://arc.taal.com', config)
+}