Struct Client

pub struct Client { /* private fields */ }

An external persistence implementation using lightning-storage-server.

Implementations

impl Client

pub async fn get_server_pubkey(uri: &str) -> Result<PublicKey, Error>

Get the server’s public key.

This will be needed later when calling new. It is also used in the signer to create a shared secret with the server.

In a production system, this should be verified and cached.

pub async fn new( uri: &str, server_public_key: &PublicKey, auth: LssAuth, ) -> Result<Self, Error>

Create a new client.

uri is the URI of the server. server_public_key is the server’s public key as previously obtained via get_server_pubkey. auth is the authentication token to use. It includes the client public key.

Note that the client public key is used to locate the client’s data on the server.

Trait Implementations

impl ExternalPersist for Client

fn put<'life0, 'life1, 'async_trait>( &'life0 self, mutations: Mutations, client_hmac: &'life1 [u8], ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Store the mutations.

fn get<'life0, 'life1, 'async_trait>( &'life0 self, key_prefix: String, nonce: &'life1 [u8], ) -> Pin<Box<dyn Future<Output = Result<(Mutations, Vec<u8>), Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get the full state.

fn info<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Info, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Return server information, including public key and version.