@bsv/sdk 1.5.1 → 1.5.3

package/docs/transaction.md

@@ -573,6 +573,10 @@ export class Beef {
     mergeBeef(beef: number[] | Beef): void 
     isValid(allowTxidOnly?: boolean): boolean 
     async verify(chainTracker: ChainTracker, allowTxidOnly?: boolean): Promise<boolean> 
+    verifyValid(allowTxidOnly?: boolean): {
+        valid: boolean;
+        roots: Record<number, string>;
+    } 
     toWriter(writer: Writer): void 
     toBinary(): number[] 
     toBinaryAtomic(txid: string): number[] 
@@ -950,6 +954,36 @@ Argument Details
 + **allowTxidOnly**
   + optional. If true, transaction txid is assumed valid
 
+#### Method verifyValid
+
+Sorts `txs` and confirms validity of transaction data contained in beef
+by validating structure of this beef.
+
+Returns block heights and merkle root values to be confirmed by a chaintracker.
+
+Validity requirements:
+1. No 'known' txids, unless `allowTxidOnly` is true.
+2. All transactions have bumps or their inputs chain back to bumps (or are known).
+3. Order of transactions satisfies dependencies before dependents.
+4. No transactions with duplicate txids.
+
+```ts
+verifyValid(allowTxidOnly?: boolean): {
+    valid: boolean;
+    roots: Record<number, string>;
+} 
+```
+
+Returns
+
+`valid` is true iff this Beef is structuraly valid.
+`roots` is a record where keys are block heights and values are the corresponding merkle roots to be validated.
+
+Argument Details
+
++ **allowTxidOnly**
+  + optional. If true, transaction txid is assumed valid
+
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
 ---

package/docs/wallet.md

@@ -2610,7 +2610,7 @@ The SDK is how applications communicate with wallets over a communications subst
 export default class WalletClient implements WalletInterface {
     public substrate: "auto" | WalletInterface;
     originator?: OriginatorDomainNameStringUnder250Bytes;
-    constructor(substrate: "auto" | "Cicada" | "XDM" | "window.CWI" | "json-api" | WalletInterface = "auto", originator?: OriginatorDomainNameStringUnder250Bytes) 
+    constructor(substrate: "auto" | "Cicada" | "XDM" | "window.CWI" | "json-api" | "react-native" | WalletInterface = "auto", originator?: OriginatorDomainNameStringUnder250Bytes) 
     async connectToSubstrate(): Promise<void> 
     async createAction(args: CreateActionArgs): Promise<CreateActionResult> 
     async signAction(args: SignActionArgs): Promise<SignActionResult> 

package/package.json

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

package/src/transaction/Beef.ts

@@ -391,7 +391,24 @@ export class Beef {
     return true
   }
 
-  private verifyValid (allowTxidOnly?: boolean): {
+  /**
+   * Sorts `txs` and confirms validity of transaction data contained in beef
+   * by validating structure of this beef.
+   *
+   * Returns block heights and merkle root values to be confirmed by a chaintracker.
+   *
+   * Validity requirements:
+   * 1. No 'known' txids, unless `allowTxidOnly` is true.
+   * 2. All transactions have bumps or their inputs chain back to bumps (or are known).
+   * 3. Order of transactions satisfies dependencies before dependents.
+   * 4. No transactions with duplicate txids.
+   *
+   * @param allowTxidOnly optional. If true, transaction txid is assumed valid
+   * @returns {{valid: boolean, roots: Record<number, string>}}
+   * `valid` is true iff this Beef is structuraly valid.
+   * `roots` is a record where keys are block heights and values are the corresponding merkle roots to be validated.
+   */
+  verifyValid (allowTxidOnly?: boolean): {
     valid: boolean
     roots: Record<number, string>
   } {

package/src/wallet/WalletClient.ts

@@ -57,6 +57,7 @@ export default class WalletClient implements WalletInterface {
     | 'XDM'
     | 'window.CWI'
     | 'json-api'
+    | 'react-native'
     | WalletInterface = 'auto',
     originator?: OriginatorDomainNameStringUnder250Bytes
   ) {
@@ -66,6 +67,7 @@ export default class WalletClient implements WalletInterface {
     if (substrate === 'window.CWI') substrate = new WindowCWISubstrate()
     if (substrate === 'XDM') substrate = new XDMSubstrate()
     if (substrate === 'json-api') substrate = new HTTPWalletJSON(originator)
+    if (substrate === 'react-native') substrate = new ReactNativeWebView(originator)
     this.substrate = substrate
     this.originator = originator
   }
@@ -92,7 +94,6 @@ export default class WalletClient implements WalletInterface {
       }
     }
     try {
-      console.log('Connecting to substrate...')
       sub = new WindowCWISubstrate()
       await checkSub()
       this.substrate = sub
@@ -109,7 +110,7 @@ export default class WalletClient implements WalletInterface {
           await checkSub()
           this.substrate = sub
         } catch (e) {
-          // HTTP JSON failed, attempt the next...
+          // HTTP Wire failed, attempt the next...
           try {
             sub = new HTTPWalletJSON(this.originator)
             await checkSub()