@bsv/sdk 1.2.3 → 1.2.4

package/package.json

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

package/src/auth/Certificate.ts

@@ -54,14 +54,14 @@ export default class Certificate {
    * @param {Record<CertificateFieldNameUnder50Bytes, string>} fields - All the fields present in the certificate.
    * @param {HexString} signature - Certificate signature by the certifier's private key, DER encoded hex string.
    */
-  constructor(
+  constructor (
     type: Base64String,
     serialNumber: Base64String,
     subject: PubKeyHex,
     certifier: PubKeyHex,
     revocationOutpoint: OutpointString,
     fields: Record<CertificateFieldNameUnder50Bytes, string>,
-    signature?: HexString,
+    signature?: HexString
   ) {
     this.type = type
     this.serialNumber = serialNumber
@@ -78,7 +78,7 @@ export default class Certificate {
    * @param {boolean} [includeSignature=true] - Whether to include the signature in the serialization.
    * @returns {number[]} - The serialized certificate in binary format.
    */
-  toBin(includeSignature: boolean = true): number[] {
+  toBin (includeSignature: boolean = true): number[] {
     const writer = new Utils.Writer()
 
     // Write type (Base64String, 32 bytes)
@@ -134,7 +134,7 @@ export default class Certificate {
    * @param {number[]} bin - The binary data representing the certificate.
    * @returns {Certificate} - The deserialized Certificate object.
    */
-  static fromBin(bin: number[]): Certificate {
+  static fromBin (bin: number[]): Certificate {
     const reader = new Utils.Reader(bin)
 
     // Read type
@@ -166,7 +166,7 @@ export default class Certificate {
       // Field name
       const fieldNameLength = reader.readVarIntNum()
       const fieldNameBytes = reader.read(fieldNameLength)
-      const fieldName = Utils.toUTF8(fieldNameBytes) as CertificateFieldNameUnder50Bytes
+      const fieldName = Utils.toUTF8(fieldNameBytes)
 
       // Field value
       const fieldValueLength = reader.readVarIntNum()
@@ -177,7 +177,7 @@ export default class Certificate {
     }
 
     // Read signature if present
-    let signature: string | undefined = undefined
+    let signature: string | undefined
     if (!reader.eof()) {
       const signatureLength = reader.readVarIntNum()
       const signatureBytes = reader.read(signatureLength)
@@ -200,7 +200,7 @@ export default class Certificate {
    *
    * @returns {Promise<boolean>} - A promise that resolves to true if the signature is valid.
    */
-  async verify(): Promise<boolean> {
+  async verify (): Promise<boolean> {
     // A verifier can be any wallet capable of verifying signatures
     const verifier = new ProtoWallet('anyone')
     const verificationData = this.toBin(false) // Exclude the signature from the verification data
@@ -221,7 +221,7 @@ export default class Certificate {
    * @param {Wallet} certifier - The wallet representing the certifier.
    * @returns {Promise<void>}
    */
-  async sign(certifier: Wallet): Promise<void> {
+  async sign (certifier: Wallet): Promise<void> {
     const preimage = this.toBin(false) // Exclude the signature when signing
     const { signature } = await certifier.createSignature({
       data: preimage,
@@ -230,4 +230,4 @@ export default class Certificate {
     })
     this.signature = Utils.toHex(signature)
   }
-}
+}

package/src/auth/index.ts

@@ -1 +1 @@
-export { default as Certificate } from './Certificate.js'
+export { default as Certificate } from './Certificate.js'

package/src/overlay-tools/LookupResolver.ts

@@ -70,7 +70,7 @@ export interface OverlayLookupFacilitator {
    * @param url - Overlay Service URL to send the lookup question to.
    * @param question - Lookup question to find an answer to.
    * @param timeout - Specifics how long to wait for a lookup answer in milliseconds.
-   * @returns 
+   * @returns
    */
   lookup: (url: string, question: LookupQuestion, timeout?: number) => Promise<LookupAnswer>
 }
@@ -78,11 +78,11 @@ export interface OverlayLookupFacilitator {
 export class HTTPSOverlayLookupFacilitator implements OverlayLookupFacilitator {
   fetchClient: typeof fetch
 
-  constructor(httpClient = fetch) {
+  constructor (httpClient = fetch) {
     this.fetchClient = httpClient
   }
 
-  async lookup(url: string, question: LookupQuestion, timeout: number = 5000): Promise<LookupAnswer> {
+  async lookup (url: string, question: LookupQuestion, timeout: number = 5000): Promise<LookupAnswer> {
     if (!url.startsWith('https:')) {
       throw new Error('HTTPS facilitator can only use URLs that start with "https:"')
     }
@@ -98,7 +98,7 @@ export class HTTPSOverlayLookupFacilitator implements OverlayLookupFacilitator {
       body: JSON.stringify({ service: question.service, query: question.query })
     })
 
-    const response: Response = await Promise.race([fetchPromise, timeoutPromise]) as unknown as Response
+    const response: Response = await Promise.race([fetchPromise, timeoutPromise]) as Response
 
     if (response.ok) {
       return await response.json()
@@ -117,7 +117,7 @@ export default class LookupResolver {
   private readonly hostOverrides: Record<string, string[]>
   private readonly additionalHosts: Record<string, string[]>
 
-  constructor(config?: LookupResolverConfig) {
+  constructor (config?: LookupResolverConfig) {
     const { facilitator, slapTrackers, hostOverrides, additionalHosts } = config ?? {} as LookupResolverConfig
     this.facilitator = facilitator ?? new HTTPSOverlayLookupFacilitator()
     this.slapTrackers = slapTrackers ?? DEFAULT_SLAP_TRACKERS
@@ -128,7 +128,7 @@ export default class LookupResolver {
   /**
    * Given a LookupQuestion, returns a LookupAnswer. Aggregates across multiple services and supports resiliency.
    */
-  async query(question: LookupQuestion, timeout?: number): Promise<LookupAnswer> {
+  async query (question: LookupQuestion, timeout?: number): Promise<LookupAnswer> {
     let competentHosts: string[] = []
     if (question.service === 'ls_slap') {
       competentHosts = this.slapTrackers
@@ -196,7 +196,7 @@ export default class LookupResolver {
      * @param service Service for which competent hosts are to be returned
      * @returns Array of hosts competent for resolving queries
      */
-  private async findCompetentHosts(service: string): Promise<string[]> {
+  private async findCompetentHosts (service: string): Promise<string[]> {
     const query: LookupQuestion = {
       service: 'ls_slap',
       query: {

package/src/overlay-tools/OverlayAdminTokenTemplate.ts

@@ -15,7 +15,7 @@ export default class OverlayAdminTokenTemplate implements ScriptTemplate {
      * @param script Locking script comprising a SHIP or SLAP token to decode
      * @returns Decoded SHIP or SLAP advertisement
      */
-  static decode(script: LockingScript): { protocol: 'SHIP' | 'SLAP', identityKey: string, domain: string, topicOrService: string } {
+  static decode (script: LockingScript): { protocol: 'SHIP' | 'SLAP', identityKey: string, domain: string, topicOrService: string } {
     const result = PushDrop.decode(script)
     if (result.fields.length < 4) {
       throw new Error('Invalid SHIP/SLAP advertisement!')
@@ -39,7 +39,7 @@ export default class OverlayAdminTokenTemplate implements ScriptTemplate {
      * Constructs a new Overlay Admin template instance
      * @param wallet Wallet to use for locking and unlocking
      */
-  constructor(wallet: Wallet) {
+  constructor (wallet: Wallet) {
     this.pushDrop = new PushDrop(wallet)
   }
 
@@ -50,7 +50,7 @@ export default class OverlayAdminTokenTemplate implements ScriptTemplate {
      * @param topicOrService Topic or service to advertise
      * @returns Locking script comprising the advertisement token
      */
-  async lock(protocol: 'SHIP' | 'SLAP', domain: string, topicOrService: string): Promise<LockingScript> {
+  async lock (protocol: 'SHIP' | 'SLAP', domain: string, topicOrService: string): Promise<LockingScript> {
     const { publicKey: identityKey } = await this.pushDrop.wallet.getPublicKey({ identityKey: true })
     return await this.pushDrop.lock(
       [
@@ -70,7 +70,7 @@ export default class OverlayAdminTokenTemplate implements ScriptTemplate {
      * @param protocol SHIP or SLAP, depending on the token to unlock
      * @returns Script unlocker capable of unlocking the advertisement token
      */
-  unlock(protocol: 'SHIP' | 'SLAP'): {
+  unlock (protocol: 'SHIP' | 'SLAP'): {
     sign: (tx: Transaction, inputIndex: number) => Promise<UnlockingScript>
     estimateLength: (tx: Transaction, inputIndex: number) => Promise<number>
   } {

package/src/overlay-tools/SHIPBroadcaster.ts

@@ -61,11 +61,11 @@ const MAX_SHIP_QUERY_TIMEOUT = 1000
 export class HTTPSOverlayBroadcastFacilitator implements OverlayBroadcastFacilitator {
   httpClient: typeof fetch
 
-  constructor(httpClient = fetch) {
+  constructor (httpClient = fetch) {
     this.httpClient = httpClient
   }
 
-  async send(url: string, taggedBEEF: TaggedBEEF): Promise<STEAK> {
+  async send (url: string, taggedBEEF: TaggedBEEF): Promise<STEAK> {
     if (!url.startsWith('https:')) {
       throw new Error('HTTPS facilitator can only use URLs that start with "https:"')
     }
@@ -102,7 +102,7 @@ export default class SHIPCast implements Broadcaster {
      * @param {string[]} topics - The list of SHIP topic names where transactions are to be sent.
      * @param {SHIPBroadcasterConfig} config - Configuration options for the SHIP broadcaster.
      */
-  constructor(topics: string[], config?: SHIPBroadcasterConfig) {
+  constructor (topics: string[], config?: SHIPBroadcasterConfig) {
     if (topics.length === 0) {
       throw new Error('At least one topic is required for broadcast.')
     }
@@ -129,7 +129,7 @@ export default class SHIPCast implements Broadcaster {
      * @param {Transaction} tx - The transaction to be sent.
      * @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 beef: number[]
     try {
       beef = tx.toBEEF()
@@ -271,7 +271,7 @@ export default class SHIPCast implements Broadcaster {
     }
   }
 
-  private checkAcknowledgmentFromAllHosts(hostAcknowledgments: Record<string, Set<string>>, requiredTopics: string[], require: 'all' | 'any'): boolean {
+  private checkAcknowledgmentFromAllHosts (hostAcknowledgments: Record<string, Set<string>>, requiredTopics: string[], require: 'all' | 'any'): boolean {
     for (const acknowledgedTopics of Object.values(hostAcknowledgments)) {
       if (require === 'all') {
         for (const topic of requiredTopics) {
@@ -295,7 +295,7 @@ export default class SHIPCast implements Broadcaster {
     return true
   }
 
-  private checkAcknowledgmentFromAnyHost(hostAcknowledgments: Record<string, Set<string>>, requiredTopics: string[], require: 'all' | 'any'): boolean {
+  private checkAcknowledgmentFromAnyHost (hostAcknowledgments: Record<string, Set<string>>, requiredTopics: string[], require: 'all' | 'any'): boolean {
     if (require === 'all') {
       // All required topics must be acknowledged by at least one host
       for (const acknowledgedTopics of Object.values(hostAcknowledgments)) {
@@ -324,7 +324,7 @@ export default class SHIPCast implements Broadcaster {
     }
   }
 
-  private checkAcknowledgmentFromSpecificHosts(hostAcknowledgments: Record<string, Set<string>>, requirements: Record<string, 'all' | 'any' | string[]>): boolean {
+  private checkAcknowledgmentFromSpecificHosts (hostAcknowledgments: Record<string, Set<string>>, requirements: Record<string, 'all' | 'any' | string[]>): boolean {
     for (const [host, requiredTopicsOrAllAny] of Object.entries(requirements)) {
       const acknowledgedTopics = hostAcknowledgments[host]
       if (!acknowledgedTopics) {
@@ -370,7 +370,7 @@ export default class SHIPCast implements Broadcaster {
      *
      * @returns A mapping of URLs for hosts interested in this transaction. Keys are URLs, values are which of our topics the specific host cares about.
      */
-  private async findInterestedHosts(): Promise<Record<string, Set<string>>> {
+  private async findInterestedHosts (): Promise<Record<string, Set<string>>> {
     // TODO: cache the list of interested hosts to avoid spamming SHIP trackers.
     // TODO: Monetize the operation of the SHIP tracker system.
     // TODO: Cache ship/slap lookup with expiry (every 5min)
@@ -381,7 +381,7 @@ export default class SHIPCast implements Broadcaster {
       service: 'ls_ship',
       query: {
         topics: this.topics
-      },
+      }
     }, MAX_SHIP_QUERY_TIMEOUT)
     if (answer.type !== 'output-list') {
       throw new Error('SHIP answer is not an output list.')

package/src/overlay-tools/index.ts

@@ -2,4 +2,4 @@ export * from './LookupResolver.js'
 export * from './SHIPBroadcaster.js'
 export { default as OverlayAdminTokenTemplate } from './OverlayAdminTokenTemplate.js'
 export { default as LookupResolver } from './LookupResolver.js'
-export { default as SHIPBroadcaster } from './SHIPBroadcaster.js'
+export { default as SHIPBroadcaster } from './SHIPBroadcaster.js'

package/src/transaction/Beef.ts

@@ -17,12 +17,12 @@ export type BeefVersion = undefined | 'V1' | 'V2'
  *
  * BUMP standard: BRC-74: BSV Unified Merkle Path (BUMP) Format
  * https://github.com/bitcoin-sv/BRCs/blob/master/transactions/0074.md
- * 
+ *
  * BRC-95: Atomic BEEF Transactions
  * https://github.com/bitcoin-sv/BRCs/blob/master/transactions/0095.md
- * 
+ *
  * The Atomic BEEF format is supported by the binary deserialization static method `fromBinary`.
- * 
+ *
  * BRC-96: BEEF V2, Txid Only Extension
  * https://github.com/bitcoin-sv/BRCs/blob/master/transactions/0096.md
  *
@@ -57,7 +57,7 @@ export type BeefVersion = undefined | 'V1' | 'V2'
  *
  * A valid `Beef` is only required when sent to a party with no shared history,
  * such as a transaction processor.
- * 
+ *
  * IMPORTANT NOTE:
  * It is fundamental to the BEEF value proposition that only valid transactions and valid
  * merkle path (BUMP) data be added to it. Merging invalid data breaks the `verify` and `isValid`
@@ -108,14 +108,13 @@ export class Beef {
   /**
    * Finds a Transaction in this `Beef`
    * and adds any missing input SourceTransactions from this `Beef`.
-   * 
+   *
    * The result is suitable for signing.
-   * 
+   *
    * @param txid The id of the target transaction.
    * @returns Transaction with all available input `SourceTransaction`s from this Beef.
    */
   findTransactionForSigning (txid: string): Transaction | undefined {
-
     const beefTx = this.findTxid(txid)
     if (!beefTx) return undefined
 
@@ -130,24 +129,22 @@ export class Beef {
 
     return beefTx.tx
   }
+
   /**
    * Builds the proof tree rooted at a specific `Transaction`.
-   * 
+   *
    * To succeed, the Beef must contain all the required transaction and merkle path data.
-   * 
+   *
    * @param txid The id of the target transaction.
    * @returns Transaction with input `SourceTransaction` and `MerklePath` populated from this Beef.
    */
   findAtomicTransaction (txid: string): Transaction | undefined {
-
     const beefTx = this.findTxid(txid)
     if (!beefTx) return undefined
 
     const addInputProof = (beef: Beef, tx: Transaction) => {
       const mp = beef.findBump(tx.id('hex'))
-      if (mp)
-        tx.merklePath = mp
-      else {
+      if (mp) { tx.merklePath = mp } else {
         for (const i of tx.inputs) {
           if (!i.sourceTransaction) {
             const itx = beef.findTxid(i.sourceTXID)
@@ -159,8 +156,7 @@ export class Beef {
             const mp = beef.findBump(i.sourceTransaction.id('hex'))
             if (mp) {
               i.sourceTransaction.merklePath = mp
-            }
-            else {
+            } else {
               addInputProof(beef, i.sourceTransaction)
             }
           }
@@ -397,7 +393,7 @@ export class Beef {
 
   /**
    * Serializes this data to `writer`
-   * @param writer 
+   * @param writer
    */
   toWriter (writer: Writer) {
     writer.writeUInt32LE(this.magic)
@@ -425,20 +421,18 @@ export class Beef {
 
   /**
    * Serialize this Beef as AtomicBEEF.
-   * 
+   *
    * `txid` must exist and be the last transaction
    * in sorted (dependency) order.
-   * 
-   * @param txid 
+   *
+   * @param txid
    * @returns serialized contents of this Beef with AtomicBEEF prefix.
    */
-  toBinaryAtomic(txid: string) {
+  toBinaryAtomic (txid: string) {
     this.sortTxs()
     const tx = this.findTxid(txid)
-    if (!tx)
-      throw new Error(`${txid} does not exist in this Beef`)
-    if (this.txs[this.txs.length - 1] !== tx)
-      throw new Error(`${txid} is not the last transaction in this Beef`)
+    if (!tx) { throw new Error(`${txid} does not exist in this Beef`) }
+    if (this.txs[this.txs.length - 1] !== tx) { throw new Error(`${txid} is not the last transaction in this Beef`) }
     const writer = new Writer()
     writer.writeUInt32LE(ATOMIC_BEEF)
     writer.write(toArray(txid, 'hex'))
@@ -456,7 +450,7 @@ export class Beef {
 
   static fromReader (br: Reader): Beef {
     let version = br.readUInt32LE()
-    let atomicTxid: string | undefined = undefined
+    let atomicTxid: string | undefined
     if (version === ATOMIC_BEEF) {
       // Skip the txid and re-read the BEEF version
       atomicTxid = toHex(br.read(32))
@@ -527,19 +521,18 @@ export class Beef {
      * - Oldest Tx Anchored by Path
      * - Newer Txs depending on Older parents
      * - Newest Tx
-     * 
+     *
      * with proof (MerklePath) last, longest chain of dependencies first
-     * 
+     *
      * @returns `{ missingInputs, notValid, valid, withMissingInputs }`
      */
-  sortTxs ()
-    : {
-      missingInputs: string[],
-      notValid: string[],
-      valid: string[],
-      withMissingInputs: string[],
-      txidOnly: string[]
-    } {
+  sortTxs (): {
+    missingInputs: string[]
+    notValid: string[]
+    valid: string[]
+    withMissingInputs: string[]
+    txidOnly: string[]
+  } {
     // Hashtable of valid txids (with proof or all inputs chain to proof)
     const validTxids: Record<string, boolean> = {}
 
@@ -560,10 +553,7 @@ export class Beef {
       if (tx.isValid) {
         validTxids[tx.txid] = true
         result.push(tx)
-      } else if (tx.isTxidOnly)
-        txidOnly.push(tx)
-      else
-        queue.push(tx)
+      } else if (tx.isTxidOnly) { txidOnly.push(tx) } else { queue.push(tx) }
     }
 
     // Hashtable of unknown input txids used to fund transactions without their own proof.
@@ -587,10 +577,7 @@ export class Beef {
           }
         }
       }
-      if (hasMissingInput)
-        txsMissingInputs.push(tx)
-      else
-        queue.push(tx)
+      if (hasMissingInput) { txsMissingInputs.push(tx) } else { queue.push(tx) }
     }
 
     // As long as we have unsorted transactions...
@@ -601,11 +588,9 @@ export class Beef {
         if (tx.inputTxids.every(txid => validTxids[txid])) {
           validTxids[tx.txid] = true
           result.push(tx)
-        } else
-          queue.push(tx)
+        } else { queue.push(tx) }
       }
-      if (oldQueue.length === queue.length)
-        break;
+      if (oldQueue.length === queue.length) { break }
     }
 
     // transactions that don't have proofs and don't chain to proofs
@@ -652,7 +637,7 @@ export class Beef {
   /**
    * @returns array of transaction txids that either have a proof or whose inputs chain back to a proven transaction.
    */
-  getValidTxids() : string[] {
+  getValidTxids (): string[] {
     const r = this.sortTxs()
     return r.valid
   }

package/src/transaction/BeefParty.ts

@@ -94,13 +94,13 @@ export class BeefParty extends Beef {
 
   /**
    * Merge a `beef` received from a specific `party`.
-   * 
+   *
    * Updates this `BeefParty` to track all the txids
    * corresponding to transactions for which `party`
    * has raw transaction and validity proof data.
-   * 
-   * @param party 
-   * @param beef 
+   *
+   * @param party
+   * @param beef
    */
   mergeBeefFromParty (party: string, beef: number[] | Beef) {
     const b: Beef = Array.isArray(beef) ? Beef.fromBinary(beef) : beef

package/src/transaction/BeefTx.ts

@@ -20,7 +20,7 @@ export default class BeefTx {
   inputTxids: string[] = []
   /**
    * true if `hasProof` or all inputs chain to `hasProof`.
-   * 
+   *
    * Typically set by sorting transactions by proven dependency chains.
    */
   isValid?: boolean = undefined

package/src/transaction/Transaction.ts

@@ -140,9 +140,9 @@ export default class Transaction {
     const validTxids = new Set<string>()
     // All BUMP level 0 hashes are valid.
     for (const bump of BUMPs) {
-      for (const n of bump.path[0])
-        if (n.hash)
-          validTxids.add(n.hash)
+      for (const n of bump.path[0]) {
+        if (n.hash) { validTxids.add(n.hash) }
+      }
     }
     // To keep track of which transactions were used.
     const unusedTxTxids = new Set<string>()
@@ -524,17 +524,47 @@ export default class Transaction {
     }
 
     // Distribute change among change outputs
+    let distributedChange = 0
     if (changeDistribution === 'random') {
-      // TODO
-      throw new Error('Not yet implemented')
+      // Implement Benford's Law distribution for change outputs
+      const changeOutputs = this.outputs.filter(out => out.change)
+      let changeToUse = change
+
+      // Helper function to generate a number approximating Benford's Law
+      const benfordNumber = (min: number, max: number): number => {
+        const d = Math.floor(Math.random() * 9) + 1
+        return Math.floor(min + (max - min) * Math.log10(1 + 1 / d) / Math.log10(10))
+      }
+
+      const benfordNumbers = Array(changeOutputs.length).fill(1)
+      changeToUse -= changeOutputs.length
+      distributedChange += changeOutputs.length
+      for (let i = 0; i < changeOutputs.length - 1; i++) {
+        const portion = benfordNumber(0, changeToUse)
+        benfordNumbers[i] += portion
+        distributedChange += portion
+        changeToUse -= portion
+      }
+
+      for (let i = 0; i < this.outputs.length; i++) {
+        if (this.outputs[i].change) {
+          const t = benfordNumbers.shift()
+          this.outputs[i].satoshis = t
+        }
+      }
     } else if (changeDistribution === 'equal') {
       const perOutput = Math.floor(change / changeCount)
       for (const out of this.outputs) {
         if (out.change) {
+          distributedChange += perOutput
           out.satoshis = perOutput
         }
       }
     }
+    // if there's any remaining change, add it to the last output
+    if (distributedChange < change) {
+      this.outputs[this.outputs.length - 1].satoshis += (change - distributedChange)
+    }
   }
 
   /**
@@ -868,13 +898,14 @@ export default class Transaction {
 
   /**
    * Serializes this transaction, together with its inputs and the respective merkle proofs, into the BEEF (BRC-62) format. This enables efficient verification of its compliance with the rules of SPV.
-   * 
+   *
    * @param allowPartial If true, error will not be thrown if there are any missing sourceTransactions.
    *
    * @returns The serialized BEEF structure
    * @throws Error if there are any missing sourceTransactions unless `allowPartial` is true.
    */
   toBEEF (allowPartial?: boolean): number[] {
+    this.outputs.length
     const writer = new Writer()
     writer.writeUInt32LE(4022206465)
     const BUMPs: MerklePath[] = []
@@ -919,10 +950,7 @@ export default class Transaction {
       if (!hasProof) {
         for (let i = 0; i < tx.inputs.length; i++) {
           const input = tx.inputs[i]
-          if (typeof input.sourceTransaction === 'object')
-            addPathsAndInputs(input.sourceTransaction)
-          else if (!allowPartial)
-            throw new Error('A required source transaction is missing!')
+          if (typeof input.sourceTransaction === 'object') { addPathsAndInputs(input.sourceTransaction) } else if (!allowPartial) { throw new Error('A required source transaction is missing!') }
         }
       }
     }