This repository provides a means to register off-chain token metadata that can map to on-chain identifiers (typically hashes representing asset IDs, output locking scripts, or token forging policies).
A server exposes the functionality of a key-value store, allowing users and applications to query registry entries through a RESTful API.
While this registry is limited in scope to handle native tokens only, it will also serve to facilitate a discussion and introduce a standard for a metadata distribution system that will be put forward as a CIP.
Use of this registry is subject to the Registry Terms of Use.
Use of the public API is subject to the API Terms of Use.
New submissions to this registry will take the form of a GitHub Pull Request with the addition of one or more JSON files to the mappings/ folder. Submissions will be subject to automated checking for well-formedness and human vetting before being merged to the registry.
Modification of entries in this registry will take the form of a GitHub Pull Request with the modification of one or more JSON files in the mappings/ folder. Submissions will be subject to automated checking for well-formedness and human vetting before being merged to the registry.
Each entry contains the following information:
Name | Required/Optional | Description |
---|---|---|
subject |
Required | The base16-encoded policyId + base16-encoded assetName |
policy |
Required | The script that hashes to the policyId |
name |
Required | A human-readable name for the subject, suitable for use in an interface |
description |
Required | A human-readable description for the subject, suitable for use in an interface |
ticker |
Optional | A human-readable ticker name for the subject, suitable for use in an interface |
url |
Optional | A HTTPS URL (web page relating to the token) |
logo |
Optional | A PNG image file as a byte string |
For a comprehensive description of all fields and how to generate them, please see cardano-metadata-submitter.
-
Submissions to the registry must consist of a single commit, directly off the master branch of the cardano-token-registry repository.
-
Submissions must add or modify files in the mappings/ folder.
-
The file name must match the encoded
"subject"
key of the entry, all lowercase. -
The maximum file size of a single metadata entry is 370KB.
Users and applications can query this registry through an API at https://tokens.cardano.org/metadata
.
The API documentation can be generated from the OpenAPI specification.
Use of this API is subject to the API Terms of Use.
See Wiki.