Skip to content

Commit c17128b

Browse files
authored
CIP-0025 | Adjust preamble and structure w.r.t CIP-0001 (#670)
* first draft remediation of CIP-0025 * spelled NA instead of standard N/A
1 parent 9b87e2c commit c17128b

File tree

1 file changed

+37
-16
lines changed

1 file changed

+37
-16
lines changed

CIP-0025/README.md

Lines changed: 37 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,40 @@
11
---
22
CIP: 25
33
Title: Media Token Metadata Standard
4-
Authors: Alessandro Konrad <[email protected]>, Smaug <[email protected]>
5-
Comments-URI:
64
Status: Active
7-
Type: Informational
5+
Category: Tokens
6+
Authors:
7+
- Alessandro Konrad <[email protected]>
8+
9+
Implementors: N/A
10+
Discussions:
11+
- https://forum.cardano.org/t/cip-nft-metadata-standard/45687
12+
- https://www.reddit.com/r/CardanoDevelopers/comments/mkhlv8/nft_metadata_standard/
13+
- https://github.com/cardano-foundation/CIPs/pull/85
14+
- https://github.com/cardano-foundation/CIPs/pull/267
15+
- https://github.com/cardano-foundation/CIPs/pull/341
16+
- https://github.com/cardano-foundation/CIPs/pull/527
17+
- https://github.com/cardano-foundation/CIPs/pull/593
818
Created: 2021-04-08
9-
Post-History: https://forum.cardano.org/t/cip-nft-metadata-standard/45687 and https://www.reddit.com/r/CardanoDevelopers/comments/mkhlv8/nft_metadata_standard/
1019
License: CC-BY-4.0
1120
---
1221

1322
## Abstract
1423

1524
This proposal defines an Media Token Metadata Standard for Native Tokens.
1625

17-
## Motivation
26+
## Motivation: why is this CIP necessary?
1827

1928
Tokens on Cardano are a part of the ledger. Unlike on Ethereum, where metadata can be attached to a token through a smart contract, this isn't possible on Cardano because tokens are native and Cardano uses a UTxO ledger, which makes it hard to directly attach metadata to a token.
2029
So the link to the metadata needs to be established differently.
21-
Cardano has the ability to send metadata in a transaction, that's the way we can create a link between a token and the metadata. To make the link unique, the metadata should be appended to the same transaction, where the token forge happens:
30+
31+
Cardano has the ability to send metadata in a transaction, allowing the creation of a link between a token and the metadata. To make the link unique, the metadata should be appended to the same transaction, where the token forge happens:
2232

2333
> Given a token in a EUTXOma ledger, we can ask “where did this token come from?” Since tokens
2434
> are always created in specific forging operations, we can always trace them back through their
2535
> transaction graph to their origin.
2636
27-
(Section 4 in the paper: https://iohk.io/en/research/library/papers/utxomautxo-with-multi-asset-support/)
28-
29-
## Considerations
37+
—Section 4 in the paper [UTXOma:UTXO with Multi-Asset Support](https://iohk.io/en/research/library/papers/utxomautxo-with-multi-asset-support/)
3038

3139
That being said, we have unique metadata link to a token and can always prove that with 100% certainty. No one else can manipulate the link except if the policy allows it to ([update mechanism](#update-metadata-link-for-a-specific-token)).
3240

@@ -135,9 +143,18 @@ Optional fields allow to save space in the blockchain. Consequently the minimal
135143
}
136144
```
137145

146+
### References
147+
148+
- Mime types: [RFC6838: Media Type Specifications and Registration Procedures](https://tools.ietf.org/html/rfc6838)
149+
- CIP about reserved labels: [CIP-0010: Transaction Metadata Label Registry](https://github.com/cardano-foundation/CIPs/blob/master/CIP-0010)
150+
- [EIP-721](https://eips.ethereum.org/EIPS/eip-721)
151+
- URI/URL standards: [RFC3986](https://tools.ietf.org/html/rfc3986), [RFC2397](https://tools.ietf.org/html/rfc2397)
152+
153+
## Rationale: how does this CIP achieve its goals?
154+
138155
### Retrieve valid metadata for a specific token
139156

140-
As mentioned above this metadata structure allows to have either one token or multiple tokens with also different policies in a single mint transaction. A third party tool can then fetch the token metadata seamlessly. It doesn't matter if the metadata includes just one token or multiple. The proceedure for the third party is always the same:
157+
As mentioned above this metadata structure allows to have either one token or multiple tokens with also different policies in a single mint transaction. A third party tool can then fetch the token metadata seamlessly. It doesn't matter if the metadata includes just one token or multiple. The procedure for the third party is always the same:
141158

142159
1. Find the latest mint transaction with the label 721 in the metadata of the specific token that mints a positive amount of the token
143160
2. Lookup the 721 key
@@ -151,17 +168,21 @@ Using the latest mint transaction with the label 721 as valid metadata for a tok
151168

152169
Since modern token policies or ledger rules should generally make burning of tokens permissionless, the metadata update is restricted to minting (as in positive amounts) transaction and excludes burning transactions explicitly.
153170

154-
## Backward Compatibility
171+
### Backward Compatibility
155172

156173
To keep token metadata compatible with changes coming up in the future, we use the **`version`** property.
157174
A future version will introduce [schema.org](https://schema.org).
158175

159-
## References
176+
## Path to Active
177+
178+
### Acceptance Criteria
179+
180+
- [x] Support of this NFT definition in a commercially significant number and variety of NFT-related services and wallets.
181+
- [x] Evolution of this document and standard beyond its early adoption and use cases (up through the point when alternative NFT standards have emerged).
182+
183+
### Implementation Plan
160184

161-
- Mime type: https://tools.ietf.org/html/rfc6838.
162-
- CIP about reserved labels: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0010
163-
- EIP-721: https://eips.ethereum.org/EIPS/eip-721
164-
- URI: https://tools.ietf.org/html/rfc3986, https://tools.ietf.org/html/rfc2397
185+
- [x] Promulgation of this standard among NFT creators, minting services, token analytic / query services, and wallets.
165186

166187
## Copyright
167188

0 commit comments

Comments
 (0)