csv-adapter-core 0.1.0

Chain-agnostic core traits and types for CSV (Client-Side Validation) adapters
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! CSV Core — Client-Side Validation for Cross-Chain Rights
//!
//! This crate provides the foundational types and traits for the CSV protocol:
//!
//! - **[`Right`]** — A verifiable, single-use digital right that can be
//!   transferred cross-chain
//! - **[`struct@Hash`]** — A 32-byte cryptographic hash (SHA-256 based)
//! - **[`Commitment`]** — A binding between a right's state and its anchor
//!   on a blockchain
//! - **[`SealRef`]** / **[`AnchorRef`]** — References to consumed seals
//!   and published anchors
//! - **[`InclusionProof`]** / **[`FinalityProof`]** / **[`ProofBundle`]** —
//!   Cryptographic proofs that a right was locked on the source chain
//! - **[`AnchorLayer`]** — The core trait each blockchain adapter implements
//! - **[`SignatureScheme`]** — Supported signing algorithms (secp256k1, ed25519)
//!
//! ## Stability
//!
//! The types re-exported from this module are considered **stable API**.
//! They will not change without a semver-major version bump. Internal modules
//! (state machine, VM, MPC) may evolve as the protocol matures.

#![cfg_attr(not(feature = "std"), no_std)]
#![warn(missing_docs)]
#![warn(rustdoc::broken_intra_doc_links)]

extern crate alloc;

// Core types
pub mod commitment;
pub mod hash;
pub mod right;
pub mod seal;
pub mod tagged_hash;

// Production hardening
pub mod hardening;

// State machine types (Phase 1: Consignment Wire Format)
pub mod consignment;
pub mod genesis;
pub mod schema;
pub mod state;
pub mod transition;

// MPC Tree (Phase 2)
pub mod mpc;

// Deterministic VM (Phase 3)
pub mod vm;

// DAG and proof types
pub mod dag;
pub mod proof;
pub mod proof_verify;
pub mod signature;

// Error handling and traits
pub mod error;
pub mod traits;

// Cross-cutting (Phase 10)
pub mod monitor;
pub mod store;

// Client-side validation (Sprint 2)
pub mod client;
pub mod commitment_chain;
pub mod seal_registry;
pub mod state_store;
pub mod validator;

// Cross-chain transfer (Sprint 4 - NORTH STAR)
pub mod cross_chain;

// RGB protocol compatibility (Sprint 5)
pub mod rgb_compat;

// Tapret verification (Sprint 0.5) - requires bitcoin dependency
#[cfg(feature = "tapret")]
pub mod tapret_verify;

// Re-exports: core
pub use commitment::Commitment;
pub use hardening::{
    BoundedQueue, CircuitBreaker, CircuitState, MemoryLimits, TimeoutConfig,
    DEFAULT_CIRCUIT_MAX_FAILURES, DEFAULT_CIRCUIT_RESET_TIMEOUT, DEFAULT_HEALTH_CHECK_TIMEOUT,
    DEFAULT_RPC_TIMEOUT, MAX_CACHE_SIZE, MAX_REGISTRY_SIZE, MAX_SEAL_REGISTRY_SIZE,
};
pub use hash::Hash;
pub use right::{OwnershipProof, Right, RightError, RightId};
pub use seal::{AnchorRef, SealRef};

// Re-exports: state machine (Phase 1)
pub use consignment::CONSIGNMENT_VERSION;
pub use consignment::{Anchor as ConsignmentAnchor, Consignment, ConsignmentError, SealAssignment};
pub use genesis::Genesis;
pub use schema::SCHEMA_VERSION;
pub use schema::{
    GlobalStateType, OwnedStateType, Schema, SchemaError, StateDataType, TransitionDef,
    TransitionValidationError,
};
pub use state::{GlobalState, Metadata, OwnedState, StateAssignment, StateRef, StateTypeId};
pub use transition::Transition;

// Re-exports: MPC (Phase 2)
pub use mpc::{MerkleBranchNode, MpcLeaf, MpcProof, MpcTree, ProtocolId};

// Re-exports: VM (Phase 3)
pub use vm::{execute_transition, DeterministicVM, PassthroughVM, VMError, VMInputs, VMOutputs};

// Re-exports: DAG and proofs
pub use dag::{DAGNode, DAGSegment};
pub use proof::{FinalityProof, InclusionProof, ProofBundle};
pub use proof_verify::verify_proof;
pub use signature::{parse_signatures_from_bytes, verify_signatures, Signature, SignatureScheme};

// Re-exports: errors and traits
pub use error::{AdapterError, Result};
pub use traits::AnchorLayer;

// Re-exports: cross-cutting (Phase 10)
pub use monitor::{PendingPublication, PublicationTracker, ReorgEvent, ReorgMonitor};
pub use store::{AnchorRecord, InMemorySealStore, SealRecord, SealStore, StoreError};