# Class BSV::Wallet::WalletWireTransceiver <a id="class-BSV-Wallet-WalletWireTransceiver"></a>

**Inherits:** `Object`
**Includes:** `BSV::Wallet::Interface::BRC100`

Client-side BRC-103 transceiver.

Implements every {Interface::BRC100} method by serialising the call arguments
to a binary request frame, transmitting it over a {WalletWire}, unframing the
result, and deserialising the payload back to a Ruby hash.

Thread safety: each call is independent. The wire transport is the
synchronisation boundary — concurrent calls are serialised only if the
underlying wire implementation serialises them.

**@example In-process loopback (testing / same-process use)**
```ruby
proto     = BSV::Wallet::ProtoWallet.new(key)
processor = BSV::Wallet::WalletWireProcessor.new(proto)
client    = BSV::Wallet::WalletWireTransceiver.new(processor)
client.get_public_key(identity_key: true)
#=> { public_key: "02..." }
```

**@example Over HTTP**
```ruby
wire   = BSV::Wallet::Substrates::HTTPWalletWire.new(base_url: 'https://wallet.example')
client = BSV::Wallet::WalletWireTransceiver.new(wire)
```

## Public Instance Methods
### `abort_action(reference:, originator: = nil)` <a id="method-i-abort_action"></a> <a id="abort_action-instance_method"></a>
Aborts a transaction that has not yet been finalized.
- **@raise** [NotImplementedError]

### `acquire_certificate(type:, certifier:, acquisition_protocol:, fields:, serial_number: = nil, revocation_outpoint: = nil, signature: = nil, certifier_url: = nil, keyring_revealer: = nil, keyring_for_subject: = nil, privileged: = false, privileged_reason: = nil, originator: = nil)` <a id="method-i-acquire_certificate"></a> <a id="acquire_certificate-instance_method"></a>
Acquires an identity certificate from a certifier or by direct receipt.
- **@param** `acquisition_protocol` [Symbol] :direct or :issuance
- **@param** `fields` [Hash{String => String}] certificate field names to values
- **@raise** [NotImplementedError]

### `authenticated?(originator: = nil)` <a id="method-i-authenticated-3F"></a> <a id="authenticated?-instance_method"></a>
Checks whether the user is authenticated.
- **@raise** [NotImplementedError]
- **@return** [Boolean]

### `create_action(description:, input_beef: = nil, inputs: = nil, outputs: = nil, lock_time: = nil, version: = nil, labels: = nil, sign_and_process: = true, accept_delayed_broadcast: = true, trust_self: = nil, known_txids: = nil, return_txid_only: = false, no_send: = false, no_send_change: = nil, send_with: = nil, randomize_outputs: = true, originator: = nil)` <a id="method-i-create_action"></a> <a id="create_action-instance_method"></a>
Creates a new Bitcoin transaction.
- **@param** `description` [String] human-readable description (5-50 chars)
- **@param** `inputs` [Array<Hash>] optional inputs to consume
- :outpoint [String] txid.index being consumed
- :unlocking_script [String] hex unlocking script
- :unlocking_script_length [Integer] length, if script provided later via {#sign_action}
- :input_description [String] what this input consumes (5-50 chars)
- :sequence_number [Integer] optional sequence number
- **@param** `outputs` [Array<Hash>] optional outputs to create
- :locking_script [String] hex locking script
- :satoshis [Integer] output value
- :output_description [String] what this output represents (5-50 chars)
- :basket [String] optional basket name for UTXO tracking
- :custom_instructions [String] application-specific context
- :tags [Array<String>] output tags for filtering
- **@raise** [NotImplementedError]
- **@return** [Hash] BRC-100 spec-mandated keys: :txid (display-order hex), :tx, :no_send_change,
:send_with_results, :signable_transaction

### `create_hmac(data:, protocol_id:, key_id:, privileged: = false, privileged_reason: = nil, counterparty: = nil, seek_permission: = true, originator: = nil)` <a id="method-i-create_hmac"></a> <a id="create_hmac-instance_method"></a>
Creates an HMAC for the provided data.
- **@raise** [NotImplementedError]

### `create_signature(protocol_id:, key_id:, data: = nil, hash_to_directly_sign: = nil, privileged: = false, privileged_reason: = nil, counterparty: = nil, seek_permission: = true, originator: = nil)` <a id="method-i-create_signature"></a> <a id="create_signature-instance_method"></a>
Creates a digital signature (ECDSA) for data or a pre-computed hash.
- **@raise** [NotImplementedError]

### `decrypt(ciphertext:, protocol_id:, key_id:, privileged: = false, privileged_reason: = nil, counterparty: = nil, seek_permission: = true, originator: = nil)` <a id="method-i-decrypt"></a> <a id="decrypt-instance_method"></a>
Decrypts ciphertext using derived keys.
- **@raise** [NotImplementedError]

### `discover_by_attributes(attributes:, limit: = 10, offset: = 0, seek_permission: = true, originator: = nil)` <a id="method-i-discover_by_attributes"></a> <a id="discover_by_attributes-instance_method"></a>
Discovers certificates matching specific attribute values.
- **@param** `attributes` [Hash{String => String}] field name/value pairs to match
- **@raise** [NotImplementedError]

### `discover_by_identity_key(identity_key:, limit: = 10, offset: = 0, seek_permission: = true, originator: = nil)` <a id="method-i-discover_by_identity_key"></a> <a id="discover_by_identity_key-instance_method"></a>
Discovers certificates issued to a given identity key.
- **@raise** [NotImplementedError]

### `encrypt(plaintext:, protocol_id:, key_id:, privileged: = false, privileged_reason: = nil, counterparty: = nil, seek_permission: = true, originator: = nil)` <a id="method-i-encrypt"></a> <a id="encrypt-instance_method"></a>
Encrypts plaintext using derived keys.
- **@raise** [NotImplementedError]

### `get_header_for_height(height:, originator: = nil)` <a id="method-i-get_header_for_height"></a> <a id="get_header_for_height-instance_method"></a>
Returns the 80-byte block header at the given height.
- **@raise** [NotImplementedError]

### `get_height(originator: = nil)` <a id="method-i-get_height"></a> <a id="get_height-instance_method"></a>
Returns the current blockchain height.
- **@raise** [NotImplementedError]

### `get_network(originator: = nil)` <a id="method-i-get_network"></a> <a id="get_network-instance_method"></a>
Returns the network (:mainnet or :testnet).
- **@raise** [NotImplementedError]

### `get_public_key(identity_key: = false, protocol_id: = nil, key_id: = nil, privileged: = false, privileged_reason: = nil, counterparty: = nil, for_self: = false, seek_permission: = true, originator: = nil)` <a id="method-i-get_public_key"></a> <a id="get_public_key-instance_method"></a>
Retrieves a derived or identity public key.
- **@param** `protocol_id` [Array(Integer, String)] security level (0-2) and protocol string
- **@param** `counterparty` [String] public key hex, 'self', or 'anyone'
- **@raise** [NotImplementedError]
- **@return** [Hash] :public_key

### `get_version(originator: = nil)` <a id="method-i-get_version"></a> <a id="get_version-instance_method"></a>
Returns the wallet version string.
- **@raise** [NotImplementedError]

### `initialize(wire)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
- **@param** `wire` [#transmit_to_wallet] any object that includes {WalletWire}
- **@return** [WalletWireTransceiver] a new instance of WalletWireTransceiver

### `internalize_action(tx:, outputs:, description:, labels: = nil, seek_permission: = true, originator: = nil)` <a id="method-i-internalize_action"></a> <a id="internalize_action-instance_method"></a>
Internalizes a transaction — labels it, pays outputs to the wallet balance,
inserts outputs into baskets, and/or tags them.
- **@param** `tx` [Array<Integer>] Atomic BEEF-formatted transaction (byte array)
- **@param** `outputs` [Array<Hash>] metadata per output
- :output_index [Integer] index within the transaction
- :protocol [Symbol] :wallet_payment or :basket_insertion
- :payment_remittance [Hash] for payments: { derivation_prefix:, derivation_suffix:, sender_identity_key: }
- :insertion_remittance [Hash] for insertions: { basket:, custom_instructions:, tags: }
- **@raise** [NotImplementedError]

### `list_actions(labels:, label_query_mode: = :any, include_labels: = false, include_inputs: = false, include_input_source_locking_scripts: = false, include_input_unlocking_scripts: = false, include_outputs: = false, include_output_locking_scripts: = false, limit: = 10, offset: = 0, seek_permission: = true, originator: = nil)` <a id="method-i-list_actions"></a> <a id="list_actions-instance_method"></a>
Lists transactions matching the specified labels.
- **@raise** [NotImplementedError]
- **@return** [Hash] :total_actions, :actions

### `list_certificates(certifiers:, types:, limit: = 10, offset: = 0, privileged: = false, privileged_reason: = nil, originator: = nil)` <a id="method-i-list_certificates"></a> <a id="list_certificates-instance_method"></a>
Lists identity certificates filtered by certifier(s) and type(s).
- **@raise** [NotImplementedError]

### `list_outputs(basket:, tags: = nil, tag_query_mode: = :any, include: = nil, include_custom_instructions: = false, include_tags: = false, include_labels: = false, limit: = 10, offset: = 0, seek_permission: = true, originator: = nil)` <a id="method-i-list_outputs"></a> <a id="list_outputs-instance_method"></a>
Lists spendable outputs in a basket.
- **@param** `include` [Symbol] nil, :locking_scripts, or :entire_transactions
- **@raise** [NotImplementedError]
- **@return** [Hash] :total_outputs, :beef, :outputs

### `prove_certificate(certificate:, fields_to_reveal:, verifier:, privileged: = false, privileged_reason: = nil, originator: = nil)` <a id="method-i-prove_certificate"></a> <a id="prove_certificate-instance_method"></a>
Proves select fields of a certificate to a verifier.
- **@param** `certificate` [Hash] the full certificate (type, subject, serial_number,
certifier, revocation_outpoint, signature, fields)
- **@param** `fields_to_reveal` [Array<String>] field names to disclose
- **@raise** [NotImplementedError]

### `relinquish_certificate(type:, serial_number:, certifier:, originator: = nil)` <a id="method-i-relinquish_certificate"></a> <a id="relinquish_certificate-instance_method"></a>
Removes a certificate from the wallet.
- **@raise** [NotImplementedError]

### `relinquish_output(basket:, output:, originator: = nil)` <a id="method-i-relinquish_output"></a> <a id="relinquish_output-instance_method"></a>
Removes an output from a basket without spending it.
- **@raise** [NotImplementedError]

### `reveal_counterparty_key_linkage(counterparty:, verifier:, privileged: = false, privileged_reason: = nil, originator: = nil)` <a id="method-i-reveal_counterparty_key_linkage"></a> <a id="reveal_counterparty_key_linkage-instance_method"></a>
Reveals key linkage with a counterparty to a verifier, across all
interactions.
- **@raise** [NotImplementedError]

### `reveal_specific_key_linkage(counterparty:, verifier:, protocol_id:, key_id:, privileged: = false, privileged_reason: = nil, originator: = nil)` <a id="method-i-reveal_specific_key_linkage"></a> <a id="reveal_specific_key_linkage-instance_method"></a>
Reveals key linkage for a specific protocol and key interaction.
- **@raise** [NotImplementedError]

### `sign_action(spends:, reference:, accept_delayed_broadcast: = true, return_txid_only: = false, no_send: = false, send_with: = nil, originator: = nil)` <a id="method-i-sign_action"></a> <a id="sign_action-instance_method"></a>
Signs a transaction previously created with {#create_action}.
- **@param** `spends` [Hash{Integer => Hash}] input index => { unlocking_script:, sequence_number: }
- **@param** `reference` [String] reference returned by {#create_action}
- **@raise** [NotImplementedError]

### `verify_hmac(data:, hmac:, protocol_id:, key_id:, privileged: = false, privileged_reason: = nil, counterparty: = nil, seek_permission: = true, originator: = nil)` <a id="method-i-verify_hmac"></a> <a id="verify_hmac-instance_method"></a>
Verifies an HMAC against the provided data.
- **@raise** [NotImplementedError]

### `verify_signature(signature:, protocol_id:, key_id:, data: = nil, hash_to_directly_verify: = nil, privileged: = false, privileged_reason: = nil, counterparty: = nil, for_self: = false, seek_permission: = true, originator: = nil)` <a id="method-i-verify_signature"></a> <a id="verify_signature-instance_method"></a>
Verifies a digital signature against data or a pre-computed hash.
- **@raise** [NotImplementedError]

### `wait_for_authentication(originator: = nil)` <a id="method-i-wait_for_authentication"></a> <a id="wait_for_authentication-instance_method"></a>
Blocks until the user is authenticated.
- **@raise** [NotImplementedError]