hopper-macros 0.2.0

Declarative macros for Hopper zero-copy state framework. Account groups, instruction descriptors, capability tags, layout metadata. All macro_rules!, 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
60
61
62
63
64

# hopper-macros


Declarative macros for the Hopper zero-copy state framework.

All `macro_rules!`. No proc macros. You can build a full Hopper program without
ever touching a derive or attribute macro. These macros cut boilerplate while
leaving the generated account layout and dispatch model visible.

## Macros


| Macro | What it does |
|-------|-------------|
| `hopper_layout!` | Define a zero-copy account layout with auto-generated header, SHA-256 fingerprint, and tiered load methods |
| `hopper_dispatch!` | Route instructions by discriminator byte |
| `hopper_check!` | Composable constraint checks with clear error messages |
| `hopper_validate!` | Validation combinator blocks |
| `hopper_error!` | Define program error codes |
| `hopper_require!` | Assert-or-error shorthand |
| `hopper_init!` | Account initialization with header write |
| `hopper_close!` | Account closure with lamport drain |
| `hopper_register_discs!` | Assert discriminator uniqueness across a program |
| `hopper_verify_pda!` | PDA verification using a layout's cached bump offset |
| `hopper_invariant!` | Inline invariant check runner |
| `hopper_segment!` | Define typed segment regions within an account |
| `hopper_virtual!` | Map state across multiple accounts |
| `hopper_interface!` | Cross-program account reading by fingerprint |
| `hopper_accounts!` | Declare typed account context structs |
| `hopper_manifest!` | Declare a program manifest for schema export |
| `hopper_assert_compatible!` | Compile-time layout compatibility assertion |
| `hopper_assert_fingerprint!` | Compile-time fingerprint equality assertion |

## Usage


These are re-exported through the main `hopper` crate. You don't need to
depend on `hopper-macros` directly.

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

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

hopper_dispatch! {
    match instruction_data {
        0 => process_init(accounts, data),
        1 => process_deposit(accounts, data),
    }
}
```

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

## Support


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

## License


Apache-2.0