@bsv/sdk 1.4.20 → 1.4.23

package/docs/auth.md

@@ -1106,11 +1106,12 @@ export class VerifiableCertificate extends Certificate {
     keyring: Record<CertificateFieldNameUnder50Bytes, string>;
     decryptedFields?: Record<CertificateFieldNameUnder50Bytes, Base64String>;
     constructor(type: Base64String, serialNumber: Base64String, subject: PubKeyHex, certifier: PubKeyHex, revocationOutpoint: OutpointString, fields: Record<CertificateFieldNameUnder50Bytes, string>, keyring: Record<CertificateFieldNameUnder50Bytes, string>, signature?: HexString, decryptedFields?: Record<CertificateFieldNameUnder50Bytes, Base64String>) 
+    static fromCertificate(certificate: WalletCertificate, keyring: Record<CertificateFieldNameUnder50Bytes, string>): VerifiableCertificate 
     async decryptFields(verifierWallet: ProtoWallet, privileged?: boolean, privilegedReason?: string): Promise<Record<CertificateFieldNameUnder50Bytes, string>> 
 }
 ```
 
-See also: [Base64String](./wallet.md#type-base64string), [Certificate](./auth.md#class-certificate), [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [HexString](./wallet.md#type-hexstring), [OutpointString](./wallet.md#type-outpointstring), [ProtoWallet](./wallet.md#class-protowallet), [PubKeyHex](./wallet.md#type-pubkeyhex)
+See also: [Base64String](./wallet.md#type-base64string), [Certificate](./auth.md#class-certificate), [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [HexString](./wallet.md#type-hexstring), [OutpointString](./wallet.md#type-outpointstring), [ProtoWallet](./wallet.md#class-protowallet), [PubKeyHex](./wallet.md#type-pubkeyhex), [WalletCertificate](./wallet.md#interface-walletcertificate)
 
 #### Method decryptFields
 
@@ -1138,6 +1139,25 @@ Throws
 
 Throws an error if any of the decryption operations fail, with a message indicating the failure context.
 
+#### Method fromCertificate
+
+```ts
+static fromCertificate(certificate: WalletCertificate, keyring: Record<CertificateFieldNameUnder50Bytes, string>): VerifiableCertificate 
+```
+See also: [CertificateFieldNameUnder50Bytes](./wallet.md#type-certificatefieldnameunder50bytes), [VerifiableCertificate](./auth.md#class-verifiablecertificate), [WalletCertificate](./wallet.md#interface-walletcertificate)
+
+Returns
+
+– A fully-formed instance containing the
+original certificate data plus the supplied keyring.
+
+Argument Details
+
++ **certificate**
+  + – The source certificate that was issued and signed by the certifier.
++ **keyring**
+  + – A allows the verifier to decrypt selected certificate fields.
+
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
 ---

package/docs/script.md

@@ -756,6 +756,9 @@ export default class Spend {
     stack: number[][];
     altStack: number[][];
     ifStack: boolean[];
+    memoryLimit: number;
+    stackMem: number;
+    altStackMem: number;
     constructor(params: {
         sourceTXID: string;
         sourceOutputIndex: number;
@@ -768,9 +771,10 @@ export default class Spend {
         inputSequence: number;
         inputIndex: number;
         lockTime: number;
+        memoryLimit?: number;
     }) 
     reset(): void 
-    step(): void 
+    step(): boolean 
     validate(): boolean 
 }
 ```
@@ -792,6 +796,7 @@ constructor(params: {
     inputSequence: number;
     inputIndex: number;
     lockTime: number;
+    memoryLimit?: number;
 }) 
 ```
 See also: [LockingScript](./script.md#class-lockingscript), [TransactionInput](./transaction.md#interface-transactioninput), [TransactionOutput](./transaction.md#interface-transactionoutput), [UnlockingScript](./script.md#class-unlockingscript)
@@ -837,6 +842,7 @@ const spend = new Spend({
   inputIndex: 0, // inputIndex
   unlockingScript: UnlockingScript.fromASM("3045... 02ab..."),
   inputSequence: 0xffffffff // inputSequence
+  memoryLimit: 100000 // memoryLimit
 });
 ```
 

package/docs/transaction.md

@@ -1491,7 +1491,7 @@ export default class Transaction {
     id(): number[];
     id(enc: "hex"): string;
     id(enc?: "hex"): number[] | string 
-    async verify(chainTracker: ChainTracker | "scripts only" = defaultChainTracker(), feeModel?: FeeModel): Promise<boolean> 
+    async verify(chainTracker: ChainTracker | "scripts only" = defaultChainTracker(), feeModel?: FeeModel, memoryLimit?: number): Promise<boolean> 
     toBEEF(allowPartial?: boolean): number[] 
     toAtomicBEEF(allowPartial?: boolean): number[] 
 }
@@ -1974,7 +1974,7 @@ Argument Details
 Verifies the legitimacy of the Bitcoin transaction according to the rules of SPV by ensuring all the input transactions link back to valid block headers, the chain of spends for all inputs are valid, and the sum of inputs is not less than the sum of outputs.
 
 ```ts
-async verify(chainTracker: ChainTracker | "scripts only" = defaultChainTracker(), feeModel?: FeeModel): Promise<boolean> 
+async verify(chainTracker: ChainTracker | "scripts only" = defaultChainTracker(), feeModel?: FeeModel, memoryLimit?: number): Promise<boolean> 
 ```
 See also: [ChainTracker](./transaction.md#interface-chaintracker), [FeeModel](./transaction.md#interface-feemodel), [defaultChainTracker](./transaction.md#function-defaultchaintracker)
 
@@ -1986,6 +1986,10 @@ Argument Details
 
 + **chainTracker**
   + An instance of ChainTracker, a Bitcoin block header tracker. If the value is set to 'scripts only', headers will not be verified. If not provided then the default chain tracker will be used.
++ **feeModel**
+  + An instance of FeeModel, a fee model to use for fee calculation. If not provided then the default fee model will be used.
++ **memoryLimit**
+  + The maximum memory in bytes usage allowed for script evaluation. If not provided then the default memory limit will be used.
 
 Example
 

package/package.json

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

package/src/auth/certificates/VerifiableCertificate.ts

@@ -4,6 +4,7 @@ import type {
   CertificateFieldNameUnder50Bytes,
   HexString,
   OutpointString,
+  WalletCertificate,
 } from '../../wallet/Wallet.interfaces.js'
 import SymmetricKey from '../../primitives/SymmetricKey.js'
 import * as Utils from '../../primitives/utils.js'
@@ -50,6 +51,29 @@ export class VerifiableCertificate extends Certificate {
     this.decryptedFields = decryptedFields
   }
 
+  /**
+   *
+   * @param {WalletCertificate} certificate – The source certificate that was issued and signed by the certifier.
+   * @param {Record<CertificateFieldNameUnder50Bytes, string>} keyring – A allows the verifier to decrypt selected certificate fields.
+   * @returns {VerifiableCertificate} – A fully-formed instance containing the
+   *   original certificate data plus the supplied keyring.
+   */
+  static fromCertificate(
+    certificate: WalletCertificate,
+    keyring: Record<CertificateFieldNameUnder50Bytes, string>
+  ): VerifiableCertificate {
+    return new VerifiableCertificate(
+      certificate.type,
+      certificate.serialNumber,
+      certificate.subject,
+      certificate.certifier,
+      certificate.revocationOutpoint,
+      certificate.fields,
+      keyring,
+      certificate.signature
+    )
+  }
+
   /**
    * Decrypts selectively revealed certificate fields using the provided keyring and verifier wallet
    * @param {ProtoWallet} verifierWallet - The wallet instance of the certificate's verifier, used to decrypt field keys.

package/src/auth/certificates/__tests/VerifiableCertificate.test.ts

@@ -1,8 +1,9 @@
 import { VerifiableCertificate } from '../../../auth/certificates/VerifiableCertificate'
+import Certificate from '../../../auth/certificates/Certificate'
 import { PrivateKey, Utils } from '../../../../mod'
 import { CompletedProtoWallet } from '../../../auth/certificates/__tests/CompletedProtoWallet'
 import { MasterCertificate } from '../../../auth/certificates/MasterCertificate'
-import { ProtoWallet } from '../../../wallet/index'
+import { ProtoWallet, WalletCertificate } from '../../../wallet/index'
 
 describe('VerifiableCertificate', () => {
   const subjectPrivateKey = PrivateKey.fromRandom()
@@ -149,4 +150,30 @@ describe('VerifiableCertificate', () => {
       expect(decrypted).toEqual(plaintextFields)
     })
   })
+  
+  describe('fromCertificate', () => {
+    it('should create an equivalent VerifiableCertificate and decrypt correctly', async () => {
+      const baseCert = new Certificate(
+        verifiableCert.type,
+        verifiableCert.serialNumber,
+        verifiableCert.subject,
+        verifiableCert.certifier,
+        verifiableCert.revocationOutpoint,
+        verifiableCert.fields,
+        verifiableCert.signature        
+      ) as WalletCertificate
+
+      const verifiable = VerifiableCertificate.fromCertificate(
+        baseCert,
+        verifiableCert.keyring
+      )
+
+      expect(verifiable).toBeInstanceOf(VerifiableCertificate)
+      expect(verifiable.serialNumber).toEqual(sampleSerialNumber)
+      expect(verifiable.keyring).toEqual(verifiableCert.keyring)
+
+      const decrypted = await verifiable.decryptFields(verifierWallet)
+      expect(decrypted).toEqual(plaintextFields)
+    })
+  })
 })

package/src/auth/clients/AuthFetch.ts

@@ -495,6 +495,8 @@ export class AuthFetch {
       }
     })
 
+
+
     // Attach the payment to the request headers
     config.headers = config.headers || {}
     config.headers['x-bsv-payment'] = JSON.stringify({