Skip to content

Module BSV::Wallet::Client::Transaction

Transaction Operations concern — the 7 BRC-100 transaction public methods and all their private helpers.

Included into {Client}; methods share the instance's scope and access all instance variables initialised in {Client#initialize}.

Constants

ANCESTOR_DEPTH_CAP

Maximum ancestor depth to traverse when wiring source transactions.

STALE_CHECK_INTERVAL

Rate-limits stale pending recovery to avoid O(n) scans on every auto-fund call.

Public Instance Methods

abort_action(args, originator: = nil)

Aborts a pending signable transaction. - @option args - @param args [Hash] - @raise [WalletError] - @return [Hash] { aborted: true }

create_action(args, originator: = nil)

Creates a new Bitcoin transaction. - @param args [Hash] transaction parameters - @param _originator [String, nil] FQDN of the originating application - @return [Hash] finalised result or signable_transaction

internalize_action(args, originator: = nil)

Accepts an incoming transaction for wallet internalization. - @option args - @option args - @option args - @param args [Hash] - @return [Hash] { accepted: true }

list_actions(args, originator: = nil)

Lists stored actions matching the given labels. - @option args - @param args [Hash] - @return [Hash] { total_actions: Integer, actions: Array }

list_outputs(args, originator: = nil)

Lists spendable outputs in a basket. - @option args - @param args [Hash] - @return [Hash] { total_outputs: Integer, outputs: Array }

relinquish_output(args, originator: = nil)

Removes an output from basket tracking. - @option args - @option args - @param args [Hash] - @raise [WalletError] - @return [Hash] { relinquished: true }

sign_action(args, originator: = nil)

Signs a previously created signable transaction. - @option args - @option args - @param args [Hash] - @raise [WalletError] - @return [Hash] with :txid and :tx (BEEF bytes)