r402-core 0.17.1

Core types, traits, and wire formats for the x402 payment protocol.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

#![cfg_attr(docsrs, feature(doc_cfg))]
#![doc = include_str!("../README.md")]
// Tests exercise serde_json values via `value["key"]` indexing which is the
// idiomatic way to write assertions; the panic-on-missing-key behaviour is
// desirable there. Production code never uses `IndexMut` on arbitrary JSON.
#![cfg_attr(
    test,
    allow(
        clippy::indexing_slicing,
        clippy::panic,
        reason = "tests rely on panic-on-failure for simpler assertions"
    )
)]

// These crates are re-exported behind feature flags and consumed indirectly
// by tracing macros / telemetry instrumentation; the linter cannot see those
// references, so we suppress the unused-crate warning.
#[cfg(feature = "telemetry")]
use tracing as _;
#[cfg(feature = "telemetry")]
use tracing_core as _;

pub mod amount;
pub mod chain;
pub mod client;
pub mod error;
pub mod extensions;
pub mod facilitator;
pub mod resource_server;
pub mod scheme;
pub mod wire;

pub use resource_server::{
    AfterVerifyDecision, BeforeOpDecision, CancelReason, CancellationGuard, DynResourceServerHooks,
    PaymentHookContext, ResourceServer, ResourceServerHooks, SettleResultContext,
    SkipHandlerDirective, VerifiedPaymentCanceledContext, VerifyPaymentOutcome,
    VerifyResultContext, WirePaymentPayload,
};

#[cfg(feature = "cache")]
#[cfg_attr(docsrs, doc(cfg(feature = "cache")))]
pub mod cache;

#[cfg(feature = "metrics")]
#[cfg_attr(docsrs, doc(cfg(feature = "metrics")))]
pub mod metrics;

// `proptest` is consumed by integration tests under `tests/`, but the
// lib's own test target also links every dev-dep and would otherwise
// trip `unused_crate_dependencies` because no unit test references it.
// The empty re-import silences that lint without affecting binary size.
pub use client::{
    ClientHooks, CreatedPayment, DynClientHooks, PaymentClient, PaymentCreationContext,
    PaymentResponseContext, PaymentResponseResult,
};
pub use error::{
    AsPaymentProblem, ClientError, ErrorReason, FacilitatorError, PaymentProblem, SettlementError,
    VerificationError,
};
pub use facilitator::{
    BoxFuture, DynFacilitator, DynFacilitatorHooks, Facilitator, FacilitatorHooks, FailureRecovery,
    HookDecision, HookedFacilitator,
};
#[cfg(test)]
use proptest as _;
pub use wire::{
    DEFAULT_ASSET_DECIMALS, SettlementOverrideError, SettlementOverrides,
    asset_decimals_from_extra, resolve_settlement_override_amount,
};