DCIPs/EIPS/eip-4944.md

3.2 KiB

eip title description author discussions-to status type category created requires
4944 Contract with Exactly One Non-fungible Token An ERC-721 compatible single-token NFT Víctor Muñoz (@victormunoz), Josep Lluis de la Rosa (@peplluis7), Andres El-Fakdi (@Bluezfish) https://ethereum-magicians.org/t/erc721-minting-only-one-token/8602/2 Draft Standards Track ERC 2022-03-25 721

Abstract

The following describes standard functions for an ERC-721 compatible contract with a total supply of one. This allows an NFT to be associated uniquely with a single contract address.

Motivation

If the ERC-721 was modified to mint only 1 token (per contract), then the contract address could be identified uniquely with that minted token (instead of the tuple contract address + token id, as ERC-721 requires). This change would enable automatically all the capabilities of composable tokens ERC-998 (own other ERC-721 or ERC-20) natively without adding any extra code, just forbidding to mint more than one token per deployed contract. Then the NFT minted with this contract could operate with his "budget" (the ERC-20 he owned) and also trade with the other NFTs he could own. Just like an autonomous agent, that could decide what to do with his properties (sell his NFTs, buy other NFTs, etc).

The first use case that is devised is for value preservation. Digital assets, as NFTs, have value that has to be preserved in order to not be lost. If the asset has its own budget (in other ERC-20 coins), could use it to autopreserve itself.

Specification

The constructor should mint the unique token of the contract, and then the mint function should add a restriction to avoid further minting.

Also, a tokenTransfer function should be added in order to allow the contract owner to transact with the ERC-20 tokens owned by the contract/NFT itself. So that if the contract receives a transfer of ERC-20 tokens, the owner of the NFT could spend it from the contract wallet.

Rationale

The main motivation is to keep the contract compatible with current ERC-721 platforms.

Backwards Compatibility

There are no backwards compatibility issues.

Reference Implementation

Add the variable _minted in the contract:

    bool private _minted;

In the constructor, automint the first token and set the variable to true:

    constructor(string memory name, string memory symbol, string memory base_uri) ERC721(name, symbol) {
        baseUri = base_uri;
        mint(msg.sender,0);
        _minted = true;
    }

Add additional functions to interact with the NFT properties (for instance, ERC-20):

    modifier onlyOwner() {
        require(balanceOf(msg.sender) > 0, "Caller is not the owner of the NFT");
        _;
    }

    function transferTokens(IERC20 token, address recipient, uint256 amount) public virtual onlyOwner {
        token.transfer(recipient, amount);
    }
	
    function balanceTokens(IERC20 token) public view virtual returns (uint256) {
        return token.balanceOf(address(this));
    }

Security Considerations

No security issues found.

Copyright and related rights waived via CC0.