hopper-schema 0.1.0

Schema export and ABI fingerprinting for Hopper zero-copy state framework. Layout manifests, schema diff, migration checks.
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

# hopper-schema

Schema export, ABI fingerprinting, and migration tooling for Hopper.

Part of the **[Hopper](https://hopperzero.dev)** framework.

This crate is how Hopper programs talk to the outside world. It turns layout
definitions into manifests, IDLs, and Codama-compatible schema that clients,
CLIs, and explorers can consume. It also handles version diffing and migration
planning between layout versions.

`no_std`, `no_alloc`.

## What's in here

- **Layout manifests** - Full schema for every account type, field, segment, and compatibility pair.
- **Program manifests** - Program-level metadata: instructions, events, policies, and layouts.
- **Manager metadata** - `SchemaExport` and `ManagerMetadata` bridge runtime layout identity into tooling metadata.
- **IDL projection** - Public-facing IDL with instructions, accounts, events, and PDA seed hints.
- **Codama projection** - Ecosystem-compatible format for Kinobi/Umi client generators.
- **Schema diff** - Field-level diffing between layout versions.
- **Compatibility classification** - Identical, WireCompatible, AppendSafe, MigrationRequired, or Incompatible.
- **Migration planner** - Segment-role-aware migration steps between layout versions.
- **Client generation** - TypeScript, Kotlin (`org.sol4k`), Python, and Rust SDK generators from program manifests.
- **Field intents** - Semantic annotations such as Balance, Authority, Timestamp, and Counter.
- **Account decoding** - Header and field-level decode from raw bytes using manifest metadata.

## Schema layering

```
ProgramManifest      Full truth (layouts, instructions, events, policies)
   |
   v
ProgramIdl           Public-facing (instructions, accounts, events, fingerprints)
   |
   v
CodamaProjection     Ecosystem interop (Codama-shaped for client generators)
```

Code is the source of truth. Schema is always derived, never hand-written.

Docs: <https://docs.rs/crate/hopper-schema/0.1.0>

## License

Apache-2.0