ratify_protocol/
lib.rs

1//! Ratify Protocol v1 — Rust reference SDK.
2//!
3//! A cryptographic trust protocol for human-agent and agent-agent interactions
4//! as agents start to transact. Every signature is hybrid Ed25519 + ML-DSA-65
5//! (FIPS 204): quantum-safe by design.
6//!
7//! See docs/EXPLAINED.md and docs/AGENT_TO_AGENT.md in the repository for
8//! architecture, threat model, and agent-to-agent patterns.
9
10pub mod canonical;
11pub mod constraints;
12pub mod crypto;
13pub mod receipts;
14pub mod scope;
15pub mod types;
16pub mod verify;
17
18pub use canonical::{base64_std_decode, base64_std_encode, canonical_json, hex_decode, hex_encode};
19pub use crypto::{
20    chain_hash, challenge_sign_bytes, challenge_sign_bytes_with_session_context,
21    challenge_sign_bytes_with_stream, delegation_sign_bytes, derive_id, generate_agent,
22    generate_challenge, generate_human_root, generate_hybrid_keypair, issue_delegation,
23    issue_key_rotation_statement, issue_revocation_list, issue_revocation_push,
24    issue_session_token, issue_witness_entry, key_rotation_sign_bytes, revocation_push_sign_bytes,
25    revocation_sign_bytes, session_token_sign_bytes, sign_both, sign_challenge,
26    sign_challenge_with_session_context, sign_challenge_with_stream,
27    sign_transaction_receipt_party, transaction_receipt_sign_bytes, verify_both,
28    verify_challenge_signature, verify_challenge_signature_with_session_context,
29    verify_challenge_signature_with_stream, verify_delegation_signature,
30    verify_delegation_signature_e, verify_key_rotation_statement, verify_revocation_list,
31    verify_revocation_push, verify_session_token, verify_session_token_e, verify_witness_entry,
32    witness_entry_sign_bytes,
33};
34pub use scope::{
35    expand_scopes, has_scope, intersect_scopes, is_sensitive, validate_scopes, CUSTOM_SCOPE_PREFIX,
36    SCOPE_COMMS_CALENDAR_READ, SCOPE_COMMS_CALENDAR_WRITE, SCOPE_COMMS_EMAIL_DELETE,
37    SCOPE_COMMS_EMAIL_READ, SCOPE_COMMS_EMAIL_SEND, SCOPE_COMMS_MESSAGE_DELETE,
38    SCOPE_COMMS_MESSAGE_READ, SCOPE_COMMS_MESSAGE_SEND, SCOPE_CONTRACT_READ, SCOPE_CONTRACT_SIGN,
39    SCOPE_DATA_DELETE, SCOPE_DATA_EXPORT, SCOPE_DATA_READ, SCOPE_DATA_SHARE, SCOPE_DATA_WRITE,
40    SCOPE_EXECUTE_CODE, SCOPE_EXECUTE_TOOL, SCOPE_FILES_READ, SCOPE_FILES_WRITE,
41    SCOPE_GENERATE_CONTENT, SCOPE_GENERATE_DEEPFAKE, SCOPE_IDENTITY_DELEGATE, SCOPE_IDENTITY_PROVE,
42    SCOPE_MEETING_ATTEND, SCOPE_MEETING_CHAT, SCOPE_MEETING_RECORD, SCOPE_MEETING_SHARE_SCREEN,
43    SCOPE_MEETING_SPEAK, SCOPE_MEETING_VIDEO, SCOPE_PAYMENTS_AUTHORIZE, SCOPE_PAYMENTS_RECEIVE,
44    SCOPE_PAYMENTS_SEND, SCOPE_TRANSACT_PURCHASE, SCOPE_TRANSACT_SELL,
45};
46pub use receipts::{
47    bundle_hash, issue_policy_verdict, issue_verification_receipt,
48    policy_verdict_sign_bytes_buf, receipt_hash, verification_receipt_sign_bytes_buf,
49    verifier_context_hash, verify_policy_verdict, verify_verification_receipt,
50};
51pub use types::{
52    AgentIdentity, Anchor, AnchorResolver, AuditProvider, Constraint, ConstraintEvaluator,
53    DelegationCert, HumanRoot, HybridPrivateKey, HybridPublicKey, HybridSignature, IdentityStatus,
54    KeyRotationStatement, PolicyProvider, PolicyVerdict, ProofBundle, ReceiptParty,
55    ReceiptPartySignature, RevocationList, RevocationProvider, RevocationPush, SessionToken,
56    StreamContext, TransactionReceipt, TransactionReceiptResult, VerificationReceipt,
57    VerifierContext, VerifyOptions, VerifyResult, WitnessEntry, CHALLENGE_WINDOW_SECONDS,
58    ED25519_PUBLIC_KEY_SIZE, ED25519_SIGNATURE_SIZE, MAX_DELEGATION_CHAIN_DEPTH,
59    MLDSA65_PUBLIC_KEY_SIZE, MLDSA65_SIGNATURE_SIZE, PROTOCOL_VERSION,
60};
61pub use verify::{verify_bundle, verify_streamed_turn, verify_transaction_receipt};
ratify_protocol/lib.rs

ratify_protocol/
lib.rs
