hopper-framework 0.1.0

Zero-copy state framework for Solana. Typed account architecture, phased execution, validation graphs, zero-copy collections, layout evolution, and cross-program interfaces. Built on Hopper Native. no_std, no_alloc, no proc macros required.
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

# Hopper Examples

These examples teach Hopper in order. Start with showcase, move to vault for
something simpler, then explore the advanced patterns as you need them.

## Learning Order

### Tier 1: Start Here

1. **[hopper-showcase](hopper-showcase/src/lib.rs)** - The canonical Hopper
   program. Uses every layer of the pipeline: layout, dispatch, phased frame,
   policy, receipts, invariants, segment roles, state diffs. Read this first.
   Companion guide: [hopper-showcase/README.md](hopper-showcase/README.md)

2. **[hopper-vault](hopper-vault/src/lib.rs)** - A simple SOL vault. Three
   instructions (init, deposit, withdraw). Good for seeing the basics without
   the advanced stuff. Companion guide: [hopper-vault/README.md](hopper-vault/README.md)

3. **[hopper-escrow](hopper-escrow/src/lib.rs)** - Token escrow with authority
   checks and SPL Token integration. Companion guide: [hopper-escrow/README.md](hopper-escrow/README.md)

### Tier 2: Advanced Patterns

4. **[hopper-treasury](hopper-treasury/src/lib.rs)** - Multi-segment treasury
   with permissions and budget controls.

5. **[hopper-registry](hopper-registry/src/lib.rs)** - Segmented account with
   journal, virtual state, and named segment lookup.

6. **[hopper-migration](hopper-migration/src/lib.rs)** - V1 to V2 layout
   evolution. Shows how append-only versioning and the migration planner work
   together. Companion guide: [hopper-migration/README.md](hopper-migration/README.md)

7. **[hopper-virtual-state](hopper-virtual-state/src/lib.rs)** - Multi-account
   entities with VirtualState and ShardedAccess. For when your state is too big
   for one account.

8. **[hopper-token-2022-vault](hopper-token-2022-vault/src/lib.rs)** - Hopper-owned
   Token-2022 vault flow with a local `hopper.manifest.json`, so the CLI can
   infer the package manifest and emit lowered accessors directly from the
   example directory.

9. **[cross-program-read](cross-program-read/)** - Two separate programs reading
   each other's accounts via `hopper_interface!`. No shared crate dependency.
   Companion guide: [cross-program-read/README.md](cross-program-read/README.md)

10. **[hopper-policy-vault](hopper-policy-vault/src/lib.rs)** - Three sibling
    programs (`strict`, `sealed`, `raw`) demonstrating the policy-driven runtime
    plus the `#[instruction(N, unsafe_memory, skip_token_checks)]` per-handler
    overrides. Companion guide:
    [hopper-policy-vault/README.md](hopper-policy-vault/README.md)

### Tier 3: Escape Hatch

Every example uses the standard Hopper path. When you need to go lower, the
framework provides `load_unchecked`, raw `overlay_mut`, manual `write_header`,
and `segment_data_mut_unchecked`. These are documented in the API but not
demonstrated in a dedicated example because the whole point is that you
should not need them often.