Struct vls_frontend::external_persist::lss::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. Returns the server hmacs, proving that each backend server persisted the mutations. If a server did not respond in time, their HMAC will be empty. TODO multiple servers

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 from a quorum of backend servers and the matching server HMACs. Unavailable servers will have an empty HMAC.

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

Return server information for each backend server.