DCIPs/EIPS/eip-1948.md

160 lines
5.1 KiB
Markdown
Raw Normal View History

---
eip: 1948
title: Non-fungible Data Token
author: Johann Barbie (@johannbarbie), Ben Bollen <ben@ost.com>, pinkiebell (@pinkiebell)
discussions-to: https://ethereum-magicians.org/t/erc-non-fungible-data-token/3139
status: Stagnant
type: Standards Track
category: ERC
created: 2019-04-18
requires: 721
---
## Simple Summary
Some NFT use-cases require to have dynamic data associated with a non-fungible token that can change during its lifetime. Examples for dynamic data:
- cryptokitties that can change color
- intellectual property tokens that encode rights holders
- tokens that store data to transport them across chains
The existing metadata standard does not suffice as data can only be set at minting time and not modified later.
## Abstract
Non-fungible tokens (NFTs) are extended with the ability to store dynamic data. A 32 bytes data field is added and a read function allows to access it. The write function allows to update it, if the caller is the owner of the token. An event is emitted every time the data updates and the previous and new value is emitted in it.
## Motivation
The proposal is made to standardize on tokens with dynamic data. Interactions with bridges for side-chains like xDAI or Plasma chains will profit from the ability to use such tokens. Protocols that build on data tokens like [distributed breeding](https://ethresear.ch/t/a-distributed-breeding-function/5264) will be enabled.
## Specification
An extension of [ERC-721](./eip-721.md) interface with the following functions and events is suggested:
``` solidity
pragma solidity ^0.5.2;
/**
* @dev Interface of the ERC1948 contract.
*/
interface IERC1948 {
/**
* @dev Emitted when `oldData` is replaced with `newData` in storage of `tokenId`.
*
* Note that `oldData` or `newData` may be empty bytes.
*/
event DataUpdated(uint256 indexed tokenId, bytes32 oldData, bytes32 newData);
/**
* @dev Reads the data of a specified token. Returns the current data in
* storage of `tokenId`.
*
* @param tokenId The token to read the data off.
*
* @return A bytes32 representing the current data stored in the token.
*/
function readData(uint256 tokenId) external view returns (bytes32);
/**
* @dev Updates the data of a specified token. Writes `newData` into storage
* of `tokenId`.
*
* @param tokenId The token to write data to.
* @param newData The data to be written to the token.
*
* Emits a `DataUpdated` event.
*/
function writeData(uint256 tokenId, bytes32 newData) external;
}
```
## Rationale
The suggested data field in the NFT is used either for storing data directly, like a counter or address. If more data is required the implementer should fall back to authenticated data structures, like merkle- or patricia-trees.
The proposal for this ERC stems from the [distributed breeding proposal](https://ethresear.ch/t/a-distributed-breeding-function/5264) to allow better integration of NFTs across side-chains. [ost.com](https://ost.com/), [Skale](https://skalelabs.com/), [POA](https://poa.network/), and [LeapDAO](https://leapdao.org/) have been part of the discussion.
## Backwards Compatibility
🤷‍♂️ No related proposals are known to the author, hence no backwards compatibility to consider.
## Test Cases
Simple happy test:
``` javascript
const ERC1948 = artifacts.require('./ERC1948.sol');
contract('ERC1948', (accounts) => {
const firstTokenId = 100;
const empty = '0x0000000000000000000000000000000000000000000000000000000000000000';
const data = '0x0101010101010101010101010101010101010101010101010101010101010101';
let dataToken;
beforeEach(async () => {
dataToken = await ERC1948.new();
await dataToken.mint(accounts[0], firstTokenId);
});
it('should allow to write and read', async () => {
let rsp = await dataToken.readData(firstTokenId);
assert.equal(rsp, empty);
await dataToken.writeData(firstTokenId, data);
rsp = await dataToken.readData(firstTokenId);
assert.equal(rsp, data);
});
});
```
## Implementation
An example implementation of the interface in solidity would look like this:
``` solidity
/**
* @dev Implementation of ERC721 token and the `IERC1948` interface.
*
* ERC1948 is a non-fungible token (NFT) extended with the ability to store
* dynamic data. The data is a bytes32 field for each tokenId. If 32 bytes
* do not suffice to store the data, an authenticated data structure (hash or
* merkle tree) shall be used.
*/
contract ERC1948 is IERC1948, ERC721 {
mapping(uint256 => bytes32) data;
/**
* @dev See `IERC1948.readData`.
*
* Requirements:
*
* - `tokenId` needs to exist.
*/
function readData(uint256 tokenId) external view returns (bytes32) {
require(_exists(tokenId));
return data[tokenId];
}
/**
* @dev See `IERC1948.writeData`.
*
* Requirements:
*
* - `msg.sender` needs to be owner of `tokenId`.
*/
function writeData(uint256 tokenId, bytes32 newData) external {
require(msg.sender == ownerOf(tokenId));
emit DataUpdated(tokenId, data[tokenId], newData);
data[tokenId] = newData;
}
}
```
## Copyright
Copyright and related rights waived via [CC0](../LICENSE.md).