hopper-systems 0.2.0

Advanced state architecture for Hopper. Layouts, headers, fingerprints, segments, overlays, receipts, migrations, policies, and interface pinning.
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

# hopper-systems


Advanced state architecture for the Hopper zero-copy framework on Solana.

This is the foundation everything else sits on: account headers, ABI types,
typed overlays, phased execution, zero-copy collections, policy enforcement,
state receipts, segment-level borrow enforcement, and cross-program interfaces.
It is `no_std`, `no_alloc`, and does not require proc macros.

## What's in here


- **Account header** - 16-byte self-describing header on every account: discriminator, version, flags, and layout fingerprint.
- **ABI types** - Wire-safe primitives such as `WireU64`, `WireI64`, `WireU128`, `TypedAddress`, and `WireBool`.
- **Overlay system** - Map `#[repr(C)]` structs directly onto account bytes. No copy, no deserialization.
- **Tiered loading** - Five load tiers from full validation down to raw pointer access.
- **Frame** - Resolve, validate, and execute phases enforced through typestate and segment-level borrow tracking.
- **SegmentMap** - Compile-time field-to-offset mapping. No string lookups at runtime.
- **Segment borrows** - Byte-range borrow tracking for partial reads and writes on the same account.
- **Collections** - `FixedVec`, `RingBuffer`, `SlotMap`, `BitSet`, `Journal`, `Slab`, `PackedMap`, and `SortedVec` over account bytes.
- **Policy** - Declare what capabilities an instruction needs and auto-resolve validation requirements.
- **Checks** - Account, PDA, rent, and Instructions sysvar helpers, including the typed `InstructionsSysvar` view.
- **Receipts** - Structured mutation proof with before/after fingerprints, changed fields, byte diffs, segment tracking, and CPI flags.
- **Segments** - Typed segment roles: Core, Extension, Journal, Index, Cache, Audit, and Shard.
- **Virtual state** - Map state across multiple accounts with `hopper_virtual!`.
- **Cross-program reads** - `hopper_interface!` reads foreign accounts by fingerprint without crate dependencies.

## Quick example


```rust
use hopper::systems::*;

hopper_layout! {
    pub struct Vault, disc = 1, version = 1 {
        authority: TypedAddress<Authority>  = 32,
        balance:   WireU64                  = 8,
        bump:      u8                       = 1,
    }
}

// Full validation (Tier A)
let vault = Vault::load(account, program_id)?;

// Pod-level access (Tier B)
let vault = pod_from_bytes::<Vault>(data)?;
```

Docs: <https://docs.rs/crate/hopper-systems/0.2.0>

## Support


Public-goods support and donations can be sent to `solanadevdao.sol` /
`F42ZovBoRJZU4av5MiESVwJWnEx8ZQVFkc1RM29zMxNT`.

## License


Apache-2.0