hopper-runtime 0.2.0

Canonical low-level runtime surface for Hopper. Hopper Native is the primary backend; legacy Pinocchio and solana-program compatibility are explicit opt-ins.
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

# hopper-runtime


Canonical low-level runtime surface for [Hopper](https://hopperzero.dev).
Hopper Native is the primary backend. Pinocchio is available only through the
explicit `legacy-pinocchio-compat` migration and benchmark feature;
`solana-program` compatibility is a separate opt-in backend.

## What this crate owns


- **Typed AccountView** with checked and unchecked borrow paths.
- **`Context<'a>`** - the raw runtime context that proc macros bind into typed
  handler contexts.
- **CPI** - `invoke`, `invoke_signed`, plus the unchecked Tier C variants
  with seven-item `# Safety` invariants documented inline.
- **PDA helpers** - `find_program_address`, `create_program_address`, plus
  Hopper's verify-only sha256 path that skips `curve_validate` for stored-bump
  PDA verification.
- **Layout contract** - `LayoutContract` trait, header read/write, layout
  fingerprint comparison.
- **Guard macros** - full Anchor-parity family (`require!`, `require_eq!`,
  `require_neq!`, `require_keys_eq!`, `require_keys_neq!`, `require_gt!`,
  `require_gte!`, `require_lt!`, `require_lte!`), plus `err!` / `error!`
  short-form aliases.
- **Backend bridge** - feature-gated routing to `hopper-native` (primary),
  `legacy-pinocchio-compat` migration shims, or `solana-program` substrates.
- **System Program builders** - `Transfer`, `CreateAccount`, `Allocate`,
  `Assign`.
- **Rent-exemption helper** - `rent::check_rent_exempt(account)` backing the
  `#[account(rent_exempt = enforce)]` field keyword.
- **Remaining accounts** - strict, passthrough, and raw remaining-account views
  plus bounded account/signer parsing helpers.
- **Token / Token-2022 readers** - base-layout readers for Mint and
  TokenAccount, plus the TLV scanner that powers the `extensions::*`
  constraints.

Most users touch this crate transitively through the `hopper` umbrella crate
and `hopper::prelude::*`. Reach for `hopper-runtime` directly when writing a
crate that needs the runtime surface without the higher-level framework
features.

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

## Support


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

## License


Apache-2.0. See [LICENSE](../../LICENSE).