Struct BitcoinAnchorLayer 

pub struct BitcoinAnchorLayer { /* private fields */ }

Bitcoin implementation of the AnchorLayer trait with HD wallet support

Implementations

impl BitcoinAnchorLayer

pub fn with_wallet( config: BitcoinConfig, wallet: SealWallet, ) -> BitcoinResult<Self>

Create with an existing HD wallet.

pub fn from_xpub(config: BitcoinConfig, xpub: &str) -> BitcoinResult<Self>

Create a new adapter with an HD wallet from an xpub key

pub fn signet() -> BitcoinResult<Self>

Create with default config for signet (random wallet)

pub fn with_rpc(self, rpc: Box<dyn BitcoinRpc + Send + Sync>) -> Self

Attach a real RPC client for broadcasting transactions

pub fn wallet(&self) -> &SealWallet

Get a reference to the wallet

pub fn tx_builder_mut(&mut self) -> &mut CommitmentTxBuilder

Get a mutable reference to the tx_builder

pub fn fund_seal( &self, outpoint: OutPoint, ) -> Result<(BitcoinSealRef, Bip86Path), AdapterError>

Create a seal backed by a real on-chain UTXO

This method creates a seal from an existing UTXO in the wallet. The UTXO must have been previously added to the wallet via add_utxo() or discovered via scan_wallet_for_utxos().

Arguments

• outpoint - The outpoint of the UTXO to use as the seal

Returns

A seal reference and the derivation path, or an error if the UTXO is not found

pub fn scan_wallet_for_utxos( &self, account: u32, gap_limit: usize, ) -> Result<usize, AdapterError>

Scan the wallet’s addresses for on-chain UTXOs

This method requires an RPC client to be attached. It will scan addresses and populate the wallet with any discovered UTXOs.

Arguments

• account - The account number to scan (typically 0)
• gap_limit - Number of consecutive empty addresses before stopping (typically 20)

Returns

The number of UTXOs discovered

pub fn build_commitment_data( &self, commitment: Hash, protocol_id: [u8; 32], ) -> Result<CommitmentData, AdapterError>

Build commitment data for a commitment transaction

pub fn get_current_height_for_test(&self) -> u64

Get current block height (public, for testing)

pub fn get_funding_address( &self, account: u32, index: u32, ) -> Result<Address, AdapterError>

Get the funding address for a specific account and index

pub fn add_utxo( &self, outpoint: OutPoint, amount_sat: u64, account: u32, index: u32, )

Add a UTXO to the wallet from a known outpoint

Trait Implementations

impl AnchorLayer for BitcoinAnchorLayer

type SealRef = BitcoinSealRef

Chain-specific seal reference type

type AnchorRef = BitcoinAnchorRef

Chain-specific anchor reference type

type InclusionProof = BitcoinInclusionProof

Chain-specific inclusion proof type

type FinalityProof = BitcoinFinalityProof

Chain-specific finality proof type

fn publish( &self, commitment: Hash, seal: Self::SealRef, ) -> CoreResult<Self::AnchorRef>

Publish a commitment under a single-use seal.

fn verify_inclusion( &self, anchor: Self::AnchorRef, ) -> CoreResult<Self::InclusionProof>

Extract inclusion proof from the base layer.

fn verify_finality( &self, anchor: Self::AnchorRef, ) -> CoreResult<Self::FinalityProof>

Verify finality according to base-layer rules.

fn enforce_seal(&self, seal: Self::SealRef) -> CoreResult<()>

Enforce that the seal is single-use and non-replayable.

fn create_seal(&self, value: Option<u64>) -> CoreResult<Self::SealRef>

Create a new seal for authorizing state transitions.

fn hash_commitment( &self, contract_id: Hash, previous_commitment: Hash, transition_payload_hash: Hash, seal_ref: &Self::SealRef, ) -> Hash

Compute a commitment hash from components.

fn build_proof_bundle( &self, anchor: Self::AnchorRef, transition_dag: DAGSegment, ) -> CoreResult<ProofBundle>

Build a complete proof bundle for peer-to-peer verification.

fn rollback(&self, anchor: Self::AnchorRef) -> CoreResult<()>

Handle rollback of an anchor due to chain reorg.

fn domain_separator(&self) -> [u8; 32]

Get the domain separator for this adapter.

fn signature_scheme(&self) -> SignatureScheme

Get the signature scheme used by this chain.