# Rust SDK \[The mpp Rust library] ## Overview The `mpp` Rust library provides a typed interface over the Machine Payments Protocol, from high-level abstractions to low-level primitives and building blocks.
## Install ```bash [install.sh] $ cargo add mpp ``` With Tempo blockchain support: ```bash [install-with-tempo.sh] $ cargo add mpp --features tempo,client,server ``` ## Quick start ### Parse a Challenge ```rust use mpp::parse_www_authenticate; let header = r#"Payment id="abc", realm="mpp.dev", method="tempo", intent="charge", request="eyJhbW91bnQiOiIxMDAwIn0""#; let challenge = parse_www_authenticate(header)?; println!("Method: {}", challenge.method); println!("Intent: {}", challenge.intent); ``` ### Create a Credential ```rust use mpp::{PaymentCredential, PaymentPayload, ChallengeEcho}; let credential = PaymentCredential::with_source( ChallengeEcho::new("challenge-id", "tempo", "charge"), PaymentCredential::evm_did(42431, "0xa726a1..."), PaymentPayload::transaction("0xf86c..."), ); let header = mpp::format_authorization(&credential)?; ``` ### Parse a Receipt ```rust use mpp::parse_receipt; let receipt = parse_receipt(receipt_header)?; println!("Status: {:?}", receipt.status); println!("Reference: {}", receipt.reference); ``` ## Feature flags | Feature | Description | |---------|-------------| | `client` | Client-side providers, HTTP extensions | | `server` | Server verification, `ChargeMethod` trait | | `tempo` | Tempo blockchain support | | `middleware` | reqwest-middleware integration | ### Common feature flags ```toml # Client only mpp = { version = "0.1", features = ["tempo", "client"] } # Server only mpp = { version = "0.1", features = ["tempo", "server"] } # Both mpp = { version = "0.1", features = ["tempo", "client", "server"] } # With middleware mpp = { version = "0.1", features = ["tempo", "client", "middleware"] } ``` ## Next steps * [Client](/sdk/rust/client): Handle `402` responses automatically * [Server](/sdk/rust/server): Protect endpoints with payments