Proto reference
Generated proto schema for every BitBadges chain module: 396 messages, 15 services, 3 enums, with fields, types and comments.
Every protobuf message, field, enum and RPC the chain defines, read straight from proto/ in the chain repo. Use it when you need the exact wire type, field number, or the comment that ships with the definition.
These pages are generated by site/scripts/gen-proto-reference.ts. Do not edit them by hand. Run bun run gen:proto from site/ after the chain schema changes.
| Module | Files | Messages | Services |
|---|---|---|---|
| x/wasm | 2 | 4 | 0 |
| x/gamm | 10 | 70 | 5 |
| x/ibchooks | 1 | 1 | 0 |
| x/ibc-rate-limit | 4 | 14 | 1 |
| x/managersplitter | 6 | 23 | 2 |
| x/poolmanager | 8 | 77 | 3 |
| x/sendmanager | 5 | 11 | 2 |
| x/tokenization | 23 | 196 | 2 |
Start here
Most readers want x/tokenization. These five files carry it.
| File | Messages | Services | What it defines |
|---|---|---|---|
| tokenization/tx.proto | 62 | 1 | Every message you can broadcast — create, update, transfer, set approvals. |
| tokenization/query.proto | 32 | 1 | Every gRPC query and its REST binding. |
| tokenization/collections.proto | 11 | 0 | The collection itself: timelines, manager, balance type, standards. |
| tokenization/approvals.proto | 4 | 0 | Collection-level and user-level approvals — the transferability rules. |
| tokenization/balances.proto | 3 | 0 | Balances, token ids and ownership times. |
Read the prose first
For x/tokenization, /token-standard/messages and /token-standard/queries are the documented surface. Each page there explains what a message does, when to send it, and shows a working example. This tree is the raw schema behind those pages: field numbers, wire types, and the source comments.
| You want | Go to |
|---|---|
| What a message does and how to send it | Token Standard messages |
| What a query returns and its REST path | Token Standard queries |
| The exact field number, type or comment | The module pages above |
| The module in Go | Chain modules |
What is not here
The chain source keeps a frozen copy of the x/tokenization types for each past consensus version, in proto/tokenization/v27 through proto/tokenization/v32. Those exist only so old blocks stay decodable. This reference documents the current unversioned set. Read the historical copies in the chain repo when you decode pre-upgrade state.
The source also keeps the legacy badges package (proto/badges/params.proto and proto/badges/tx.proto). It predates x/tokenization and is not part of the live surface, so it is not documented here.