ERC-6785: ERC-721 Utilities Information Extension

Abstract

---

This specification defines standard functions and an extension of the metadata schema that outlines what a token's utility entails and how the utility may be used and/or accessed. This specification is an optional extension of ERC-721.

Motivation

---

This specification aims to clarify what the utility associated with an NFT is and how to access this utility. Relying on third-party platforms to obtain information regarding the utility of the NFT that one owns can lead to scams, phishing or other forms of fraud.

Currently, utilities that are offered with NFTs are not captured on-chain. We want the utility of an NFT to be part of the metadata of an NFT. The metadata information would include: a) type of utility, b) description of utility, c) frequency and duration of utility, and d) expiration of utility. This will provide transparency as to the utility terms, and greater accountability on the creator to honor these utilities.

As the instructions on how to access a given utility may change over time, there should be a historical record of these changes for transparency.

Specification

---

The keywords “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.

Every contract compliant with ERC-6785 MUST implement the interface defined as follows:

Contract Interface

All functions defined as view MAY be implemented as pure or view

Function setUtilityUri MAY be implemented as public or external. Also, the ability to set the utilityUri SHOULD be restricted to the one who's offering the utility, whether that's the NFT creator or someone else.

The event UpdateUtility MUST be emitted when the setUtilityUri function is called or any other time that the utility of the token is changed, like in batch updates.

The method utilityHistoryOf MUST reflect all changes made to the utilityUri of a tokenId, whether that's done through setUtilityUri or by any other means, such as bulk updates

The supportsInterface method MUST return true when called with ed231d73

The original metadata SHOULD conform to the “ERC-6785 Metadata with utilities JSON Schema” which is a compatible extension of the “ERC-721 Metadata JSON Schema” defined in ERC-721.

“ERC-6785 Metadata with utilities JSON Schema” :

Rationale

---

Since the utilityUri could contain information that has to be restricted to some level and could be dependent on an off-chain tool for displaying said information, the creator needs the ability to modify it in the event the off-chain tool or platform becomes unavailable or inaccessible.

For transparency purposes, having a utilityHistoryOf method will make it clear how the utilityUri has changed over time.

For example, if a creator sells an NFT that gives holders a right to a video call with the creator, the metadata for this utility NFT would read as follows:

In order to get access to the details needed to enter the video call, the owner would access the URI returned by the getUtilityUri method for the NFT that they own. Additionally, access to the details could be conditioned by the authentication with the wallet that owns the NFT.

The current status of the utility would also be included in the URI (eg: how many sessions are still available, etc.)

Backwards Compatibility

---

This standard is compatible with current ERC-721 standard. There are no other standards that define similar methods for NFTs and the method names are not used by other ERC-721 related standards.

Test Cases

---

Test cases are available here

Reference Implementation

---

The reference implementation can be found here.

Security Considerations

---

There are no security considerations related directly to the implementation of this standard.

Copyright

---

Copyright and related rights waived via CC0-1.0.