Struct Credentials 

pub struct Credentials {
    pub key_id: String,
    /* private fields */
}

API-key authentication material.

Credentials with the same key id share timestamp allocation within this process. The signing protocol has no cross-process nonce, so use one API key per process to avoid duplicate tuples across independent processes.

Fields

key_id: String

Implementations

impl Credentials

pub fn new(key_id: impl Into<String>, private_key_hex: &str) -> Result<Self>

pub fn load( api_key_id: Option<&str>, api_private_key: Option<&str>, from_env: bool, ) -> Result<Option<Self>>

Load credentials from explicit values and/or environment.

pub fn sign_request( &self, method: &str, raw_url: &str, body: &[u8], timestamp_ms: Option<&str>, ) -> Result<BTreeMap<String, String>>

pub fn sign_payload(&self, payload: &[u8]) -> Vec<u8>

Sign exact business-payload bytes with this API key’s Ed25519 key.

This is distinct from HTTP request authentication. Callers must use a protocol-defined deterministic encoding and submit the same bytes’ logical message unchanged.

pub async fn sign_request_async( &self, method: &str, raw_url: &str, body: &[u8], timestamp_ms: Option<&str>, ) -> Result<BTreeMap<String, String>>

Sign a request without blocking an async executor when the timestamp uniqueness window is temporarily full.

All SDK network paths use this method. Callers using Self::sign_request directly receive a retryable capacity error instead of a blocking sleep.

Trait Implementations

impl Clone for Credentials

fn clone(&self) -> Credentials

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Credentials

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.