Struct SignedLicenceClient 

pub struct SignedLicenceClient<T: LicenceTransport> { /* private fields */ }

LicenceClient that signs every request with the steward key.

Implementations

impl<T: LicenceTransport> SignedLicenceClient<T>

pub fn new( key: SigningKey, node: impl Into<String>, seed_device_id: impl Into<String>, transport: T, clock: ClockMs, ) -> Arc<Self>

A client for the steward node (its node id) holding key, talking to the Seed seed_device_id (from the binding).

pub fn for_binding( key: SigningKey, binding: &BindingRecord, transport: T, clock: ClockMs, ) -> Arc<Self>

A client for the bound Seed: the audience is the binding’s device_id and the node is its steward_node_id.

Trait Implementations

impl<T: LicenceTransport> LicenceClient for SignedLicenceClient<T>

fn checkout<'life0, 'life1, 'async_trait>( &'life0 self, req: &'life1 CheckoutWire, ) -> Pin<Box<dyn Future<Output = Result<SignedGrant, LicenceClientError>> + Send + 'async_trait>>

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

POST /licence/v1/checkout: the signed grant, with seq persisted by the Seed before release.

fn artifact<'life0, 'life1, 'async_trait>( &'life0 self, blake3_hex: &'life1 str, max_len: u64, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, LicenceClientError>> + Send + 'async_trait>>

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

GET /licence/v1/artifact/<blake3>: the cached binary. At most max_len bytes are accepted.

fn grants_since<'life0, 'async_trait>( &'life0 self, since: u64, ) -> Pin<Box<dyn Future<Output = Result<Vec<SignedGrant>, LicenceClientError>> + Send + 'async_trait>>

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

GET /licence/v1/grants?since=<seq>: renewal batch.

fn grants_page<'life0, 'async_trait>( &'life0 self, since: u64, ) -> Pin<Box<dyn Future<Output = Result<GrantsPage, LicenceClientError>> + Send + 'async_trait>>

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

Self::grants_since with the paging cursor.

fn renew<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<GrantsPage, LicenceClientError>> + Send + 'async_trait>>

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

POST /licence/v1/renew: a new grant (or a withdrawal) for every active checkout, at most one batch. next is the Seed’s issue counter after the renewal (the bound for the catch-up cursor).

fn release<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, cog_id: &'life1 str, version: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<GrantsPage, LicenceClientError>> + Send + 'async_trait>>

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

POST /licence/v1/renew with {"release": [{cog_id, version}]}: the Seed withdraws that checkout (a renewal whose expires_at <= issued_at) and, as for any renewal, renews every other active one.