DCIPs/EIPS/eip-5560.md

4.3 KiB

eip title description author discussions-to status type category created requires
5560 Redeemable NFTs Makes an NFT redeemable for a physical object Olivier Fernandez (@fernandezOli), Frédéric Le Coidic (@FredLC29), Julien Béranger (@julienbrg) https://ethereum-magicians.org/t/eip-redeemable-nft-extension/10589 Stagnant Standards Track ERC 2022-08-30 165, 721

Abstract

The EIP is a Redeemable NFT extension which adds a redeem function to EIP-721. It can be implemented when an NFT issuer wants his/her NFT to be redeemed for a physical object.

Motivation

An increasing amount of NFT issuers such as artists, fine art galeries, auction houses, brands and others want to offer a physical object to the holder of a given NFT. This standard allows EIP-721 NFTs to signal reedemability.

Specification

The key words “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.

EIP-721 compliant contracts MAY implement this EIP to provide a standard method of receiving information on redeemability.

The NFT issuer MUST decide who is allowed to redeem the NFT, and restrict access to the redeem() function accordingly.

Anyone MAY access the isRedeemable() function to check the redeemability status: it returns true when the NFT redeemable, and false when already redeemed.

Third-party services that support this standard MAY use the Redeem event to listen to changes on the redeemable status of the NFT.

Implementers of this standard MUST have all of the following functions:

import '@openzeppelin/contracts/utils/introspection/ERC165.sol';

/**
 * @dev Implementation of Redeemable for ERC-721s
 *
 */

interface IRedeemable is ERC165 {
	/*
	 * ERC165 bytes to add to interface array - set in parent contract implementing this standard
	 *
	 * bytes4 private constant _INTERFACE_ID_ERC721REDEEM = 0x2f8ca953;
	 */
	 
	/// @dev This event emits when a token is redeemed.
	event Redeem(address indexed from, uint256 indexed tokenId);
	 
	/// @notice Returns the redeem status of a token
	/// @param tokenId Identifier of the token.
	function isRedeemable(uint256 _tokenId) external view returns (bool);

	/// @notice Redeeem a token
	/// @param tokenId Identifier of the token to redeeem
	function redeem(uint256 _tokenId) external;
}

The Redeem event is emitted when the redeem() function is called.

The supportsInterface method MUST return true when called with 0x2f8ca953.

Rationale

When the NFT contract is deployed, the isRedeemable() function returns true by default.

By default, the redeem() function visibility is public, so anyone can trigger it. It is RECOMMENDED to add a require to restrict the access:

require(ownerOf(tokenId) == msg.sender, "ERC721Redeemable: You are not the owner of this token");

After the redeem() function is triggered, isRedeemable() function returns false.

Redeem event

When the redeem() function is triggered, the following event MUST be emitted:

event Redeem(address indexed from, uint256 indexed tokenId);

Backwards Compatibility

This standard is compatible with EIP-721.

Reference Implementation

Here's an example of an EIP-721 that includes the Redeemable extension:

contract ERC721Redeemable is ERC721, Redeemable {

	constructor(string memory name, string memory symbol) ERC721(name, symbol) {
	}

	function isRedeemable(uint256 tokenId) public view virtual override returns (bool) {
		require(_exists(tokenId), "ERC721Redeemable: Redeem query for nonexistent token");
		return super.isRedeemable(tokenId);
	}

	function redeem(uint256 tokenId) public virtual override {
		require(_exists(tokenId), "ERC721Redeemable: Redeem query for nonexistent token");
		require(ownerOf(tokenId) == msg.sender, "ERC721Redeemable: You are not the owner of this token");
		super.redeem(tokenId);
	}

	function supportsInterface(bytes4 interfaceId) public view override(ERC721, Redeemable) returns (bool) {
		return super.supportsInterface(interfaceId);
	}
}

Security Considerations

Needs discussion.

Copyright and related rights waived via CC0.