Crate fly402_core 

402fly Core

Core library for the 402fly payment protocol with Solana blockchain integration.

This library provides the fundamental types, error handling, and payment processing capabilities for implementing the 402fly protocol - an open standard enabling AI agents to autonomously pay for API access using Solana blockchain micropayments.

Features

• Payment Models: PaymentRequest and PaymentAuthorization for structured payment flow
• Error Handling: Comprehensive error types for all 402fly operations
• Solana Integration: SolanaPaymentProcessor for blockchain transactions
• Serialization: Base64-encoded JSON for HTTP headers

Example

use fly402_core::{PaymentRequest, SolanaPaymentProcessor};
use solana_sdk::signature::Keypair;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Parse payment request from API response
    let payment_request = PaymentRequest::from_json(r#"{
        "max_amount_required": "0.10",
        "asset_type": "SPL",
        "asset_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "payment_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "network": "solana-devnet",
        "expires_at": "2025-10-31T12:00:00Z",
        "nonce": "abc123",
        "payment_id": "pay_123",
        "resource": "/api/premium-data"
    }"#)?;

    // Create payment processor
    let processor = SolanaPaymentProcessor::new(
        "https://api.devnet.solana.com",
        None
    );

    // Create and send payment
    let keypair = Keypair::new(); // Use your actual keypair
    let authorization = processor.create_payment(&payment_request, &keypair).await?;

    // Use authorization in retry request
    let header_value = authorization.to_header_value()?;
    println!("X-Payment-Authorization: {}", header_value);

    Ok(())
}

Re-exports

pub use errors::X402Error;

pub use errors::X402Result;

pub use models::PaymentAuthorization;

pub use models::PaymentRequest;

pub use payment_processor::SolanaPaymentProcessor;

Modules

errors

models

payment_processor

Constants

VERSION

Library version