Skip to content

CIP-0010 | Add label-in-use query, clean up update process #1171

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rphair merged 4 commits into from
Mar 31, 2026
Merged

CIP-0010 | Add label-in-use query, clean up update process #1171

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
0609aab
remove unclear language + add Koios query from @katomm
rphair Mar 31, 2026
8524d49
add long time recommentations for CIP-0010 PRs
rphair Mar 31, 2026
6df3978
apply some long-missing transitional punctuation
rphair Mar 31, 2026
4fbda48
change `tag` to `label`, more explicit instructions on process
rphair Mar 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions CIP-0010/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,17 +46,20 @@ transaction_metadata =

### Structure

These are the reserved `transaction_metadatum_label` values
These are the reserved `transaction_metadatum_label` values:

`transaction_metadatum_label` | description
---------------------------- | -----------------------
0 - 15 | reserved\*
0 - 15 | reserved
65536 - 131071 | reserved - private use

For the registry itself, please see [registry.json](./registry.json) in the machine-readable format. Please open your pull request against
this file.
For the registry itself, please see [registry.json](./registry.json). To add or modify a label definition, please open a pull request against this file. For new label numbers, include background information about your project and/or documentation of the label if available (and state your intended usage if not).

\* It's best to avoid using `0` or any a similar number like `1` that other people are very likely to use. Prefer instead to generate a random number
You can check if a label number is already in use with an API query. For instance: to check if label `8414` is in use via Koios (no API key needed for `curl`):

```
curl -s "https://api.koios.rest/api/v1/tx_by_metalabel?_label=8414" -H "accept: application/json"
```

## Rationale: how does this CIP achieve its goals?

Expand Down