Skip to main content

OfflineClient

Struct OfflineClient 

Source
pub struct OfflineClient<B, W, S, K> {
    pub name: String,
    /* private fields */
}
Expand description

A client to interact with Ark Server

§Example


struct MyBlockchain {}

struct MyWallet {}

struct InMemoryDb {}
// Initialize the client with a static keypair
async fn init_client_with_keypair() -> Result<Client<MyBlockchain, MyWallet, InMemorySwapStorage, ark_client::StaticKeyProvider>, ark_client::Error> {
    // Create a keypair for signing transactions
    let secp = bitcoin::key::Secp256k1::new();
    let secret_key = SecretKey::from_str("your_private_key_here").unwrap();
    let keypair = Keypair::from_secret_key(&secp, &secret_key);

    // Initialize blockchain and wallet implementations
    let blockchain = Arc::new(MyBlockchain::new("https://esplora.example.com"));
    let wallet = Arc::new(MyWallet {});
    let timeout = Duration::from_secs(30);

    // Create the offline client (backward compatible method)
    let offline_client = OfflineClient::<MyBlockchain, MyWallet, InMemorySwapStorage, StaticKeyProvider>::new_with_keypair(
        "my-ark-client".to_string(),
        keypair,
        blockchain,
        wallet,
        "https://ark-server.example.com".to_string(),
        Arc::new(InMemorySwapStorage::default()),
        "http://boltz.example.com".to_string(),
        timeout
    );

    // Connect to the Ark server and get server info
    let client = offline_client.connect().await?;

    Ok(client)
}

// Initialize the client with a BIP32 HD wallet
async fn init_client_with_bip32() -> Result<Client<MyBlockchain, MyWallet, InMemorySwapStorage, ark_client::Bip32KeyProvider>, ark_client::Error> {
    // Create a BIP32 master key and derivation path
    let master_key = Xpriv::from_str("xprv...").unwrap();
    let derivation_path = DerivationPath::from_str("m/84'/0'/0'/0/0").unwrap();

    let key_provider = Arc::new(ark_client::Bip32KeyProvider::new(master_key, derivation_path));

    // Initialize blockchain and wallet implementations
    let blockchain = Arc::new(MyBlockchain::new("https://esplora.example.com"));
    let wallet = Arc::new(MyWallet {});
    let timeout = Duration::from_secs(30);

    // Create the offline client with BIP32 key provider
    let offline_client = OfflineClient::new(
        "my-ark-client".to_string(),
        key_provider,
        blockchain,
        wallet,
        "https://ark-server.example.com".to_string(),
        Arc::new(InMemorySwapStorage::default()),
        "http://boltz.example.com".to_string(),
        timeout
    );

    // Connect to the Ark server and get server info
    let client = offline_client.connect().await?;

    Ok(client)
}

Fields§

§name: String

Implementations§

Source§

impl<B, W, S, K> OfflineClient<B, W, S, K>

Source

pub fn new( name: String, key_provider: Arc<K>, blockchain: Arc<B>, wallet: Arc<W>, ark_server_url: String, swap_storage: Arc<S>, boltz_url: String, timeout: Duration, ) -> Self

Create a new offline client with a generic key provider

§Arguments
  • name - Client identifier
  • key_provider - Implementation of KeyProvider trait (StaticKeyProvider, Bip32KeyProvider, etc.)
  • blockchain - Blockchain interface implementation
  • wallet - Wallet implementation
  • ark_server_url - URL of the Ark server
  • swap_storage - Storage implementation for swap data
  • boltz_url - URL of the Boltz server
  • timeout - Timeout duration for network operations
Source

pub fn new_with_keypair( name: String, kp: Keypair, blockchain: Arc<B>, wallet: Arc<W>, ark_server_url: String, swap_storage: Arc<S>, boltz_url: String, timeout: Duration, ) -> OfflineClient<B, W, S, StaticKeyProvider>

Create a new offline client with a static keypair (backward compatible)

This is a convenience method that wraps a single keypair in a StaticKeyProvider.

§Arguments
  • name - Client identifier
  • kp - Static keypair for signing
  • blockchain - Blockchain interface implementation
  • wallet - Wallet implementation
  • ark_server_url - URL of the Ark server
  • swap_storage - Storage implementation for swap data
  • boltz_url - URL of the Boltz server
  • timeout - Timeout duration for network operations
Source

pub fn new_with_bip32( name: String, xpriv: Xpriv, path: Option<DerivationPath>, blockchain: Arc<B>, wallet: Arc<W>, ark_server_url: String, swap_storage: Arc<S>, boltz_url: String, timeout: Duration, ) -> OfflineClient<B, W, S, Bip32KeyProvider>

Create a new offline client with an Xpriv

§Arguments
  • name - Client identifier
  • xpriv - BIP32 Xpriv
  • blockchain - Blockchain interface implementation
  • wallet - Wallet implementation
  • ark_server_url - URL of the Ark server
  • swap_storage - Storage implementation for swap data
  • boltz_url - URL of the Boltz server
  • timeout - Timeout duration for network operations
Source

pub async fn connect(self) -> Result<Client<B, W, S, K>, Error>

Connects to the Ark server and retrieves server information.

§Errors

Returns an error if the connection fails or times out.

Source

pub async fn connect_with_retries( self, max_retries: usize, ) -> Result<Client<B, W, S, K>, Error>

Connects to the Ark server and retrieves server information.

If it encounters errors, it will retry max_retries.

§Errors

Returns an error if the connection fails or times out.

Trait Implementations§

Source§

impl<B: Clone, W: Clone, S: Clone, K: Clone> Clone for OfflineClient<B, W, S, K>

Source§

fn clone(&self) -> OfflineClient<B, W, S, K>

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Auto Trait Implementations§

§

impl<B, W, S, K> !Freeze for OfflineClient<B, W, S, K>

§

impl<B, W, S, K> !RefUnwindSafe for OfflineClient<B, W, S, K>

§

impl<B, W, S, K> Send for OfflineClient<B, W, S, K>
where K: Sync + Send, B: Sync + Send, W: Sync + Send, S: Sync + Send,

§

impl<B, W, S, K> Sync for OfflineClient<B, W, S, K>
where K: Sync + Send, B: Sync + Send, W: Sync + Send, S: Sync + Send,

§

impl<B, W, S, K> Unpin for OfflineClient<B, W, S, K>

§

impl<B, W, S, K> UnsafeUnpin for OfflineClient<B, W, S, K>

§

impl<B, W, S, K> !UnwindSafe for OfflineClient<B, W, S, K>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AnyExt for T
where T: Any + ?Sized,

Source§

fn downcast_ref<T>(this: &Self) -> Option<&T>
where T: Any,

Attempts to downcast this to T behind reference
Source§

fn downcast_mut<T>(this: &mut Self) -> Option<&mut T>
where T: Any,

Attempts to downcast this to T behind mutable reference
Source§

fn downcast_rc<T>(this: Rc<Self>) -> Result<Rc<T>, Rc<Self>>
where T: Any,

Attempts to downcast this to T behind Rc pointer
Source§

fn downcast_arc<T>(this: Arc<Self>) -> Result<Arc<T>, Arc<Self>>
where T: Any,

Attempts to downcast this to T behind Arc pointer
Source§

fn downcast_box<T>(this: Box<Self>) -> Result<Box<T>, Box<Self>>
where T: Any,

Attempts to downcast this to T behind Box pointer
Source§

fn downcast_move<T>(this: Self) -> Option<T>
where T: Any, Self: Sized,

Attempts to downcast owned Self to T, useful only in generic context as a workaround for specialization
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T, X> CoerceTo<T> for X
where T: CoerceFrom<X> + ?Sized,

Source§

fn coerce_rc_to(self: Rc<X>) -> Rc<T>

Source§

fn coerce_box_to(self: Box<X>) -> Box<T>

Source§

fn coerce_ref_to(&self) -> &T

Source§

fn coerce_mut_to(&mut self) -> &mut T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FromRef<T> for T
where T: Clone,

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoRequest<T> for T

Source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
Source§

impl<L> LayerExt<L> for L

Source§

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more