Struct AuthenticatedOpenPaymentsClient 

pub struct AuthenticatedOpenPaymentsClient {
    pub http_client: Client,
    pub config: ClientConfig,
    pub signing_key: SigningKey,
}

An authenticated Open Payments client that can make signed HTTP requests.

This client automatically handles HTTP message signature creation for all requests using the configured private key. It’s used for operations that require authentication such as creating payments, quotes and managing access tokens.

Example

use open_payments::client::{AuthenticatedClient, ClientConfig, AuthenticatedResources, UnauthenticatedResources};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // In a real application, you would use actual file paths
    let config = ClientConfig {
        private_key_path: "path/to/private-key.pem".into(),
        key_id: "my-key-id".to_string(),
        jwks_path: Some("path/to/jwks.json".into()),
        wallet_address_url: "https://rafiki.money/alice".into(),
    };

    // This would fail in a real scenario if the files don't exist
    // but demonstrates the API usage
    let _client = AuthenticatedClient::new(config)?;
    Ok(())
}

Fields

http_client: Client

The underlying HTTP client for making requests.

config: ClientConfig

Client configuration including key paths and identifiers.

signing_key: SigningKey

The signing key used for HTTP message signatures.

Implementations

impl AuthenticatedOpenPaymentsClient

pub fn new(config: ClientConfig) -> Result<Self>

Creates a new authenticated client with the given configuration.

This method will:

1. Load or generate the signing key from the specified path
2. Generate and save JWKS if a JWKS path is provided
3. Create an HTTP client for making requests

Arguments

• config - The client configuration containing key paths and identifiers

Returns

Returns a configured authenticated client or an error if key loading fails.

Errors

Returns an OpClientError with:

• description: Human-readable error message
• status: HTTP status text (for HTTP errors)
• code: HTTP status code (for HTTP errors)
• validation_errors: List of validation errors (if applicable)
• details: Additional error details (if applicable)

pub fn public_jwk(&self) -> JsonWebKey

Returns the public JsonWebKey corresponding to this client’s signing key.

Useful for directed-identity grant requests via grant().request(..., Some(&jwk)).

Trait Implementations

impl AuthenticatedResources for AuthenticatedOpenPaymentsClient

fn quotes(&self) -> QuoteResource<'_>

fn incoming_payments(&self) -> IncomingPaymentResource<'_>

fn outgoing_payments(&self) -> OutgoingPaymentResource<'_>

fn grant(&self) -> Grant<'_>

fn token(&self) -> Token<'_>

impl BaseClient for AuthenticatedOpenPaymentsClient

fn http_client(&self) -> &ReqwestClient

Returns a reference to the underlying reqwest HTTP client.