issue

This action can be used to issue tokens by factory managers or authorized minters

WARNING

Deprecated. Use issue.b instead

Technical Behavior

Upon the usage of the issue action, the action will verify that the parameters supplied in the action have values, such as to, token_configs, and memo. The memo specifically has a 256-byte limitation. The required authorization is the token_factory_manager user for each token specified in token_configs. The token_configs vector is verified to not be empty and each token_config is verified to have an amount specified and a valid token_factory_id in order to begin the minting process of a token.

It will retrieve the token_factory from the token factory table. It will validate that the token_factory is currently allowing tokens to be issued and will check if the token can currently be minted based on the minting window specified by the token_factory. It will also check if there is a max_mintable_tokens and ensure that additional token combined with existed token does not exceed that count.

When max_mintable_tokens amount of tokens has been minted token factory will NOT transition to inactive or shutdown state automatically, this step needs to be done manually.

The token_factory manager is required to authorize the minting of the tokens.

The token is then created and whoever the to user is the token is emplaced into their token list.

Token Id

Upon issue, each token will be assigned with 1 unique token id

A singleton is used to track the global token ID.

Minting Limit

Minting limit is a new concept that was introduced in Release 27. It allows for uniq factories to limit the amount of tokens that can be minted to an individual account. Meaning, that if the account_minting_limit of a token factory is set to 5. Then users may not purchase more than 5 Tokens under that specific account.

• account_minting_limit of a token factory can be set/reset by calling limitmint action. It is null by default, which means minting limit function is not applied to the factory.

• When a token factory has account_minting_limit specified it will automatically create entries in the mintstat.a table with the scope of the token_factory_id, where the number of minted tokens for each issued account is recorded.

• When the limit for the token factory is reached it will prevent the user from purchasing any more tokens.

• If the account_minting_limit is set to null it will automatically allow users to purchase infinite tokens.

• An optional parameter, authorizer, can be specified to issue tokens by an authorized minter instead of token factory manager (asset_manager). In this case:

  • authorizer's permission is required instead of token factory manager's one.

  • authorizer's minting quota stored in authorized minter info table is reduced by the number of minted tokens, and if it reaches zero, their authorized minter info record is removed from the table.

• ram used to mint NFTs is covered by eosio.nft.ft account, will also be changed to eosio.nftram account

Redirect to issue.b (issue v1) action

After v1 is activated by activers action, calls to issue action will be redirected to issue.b (issue v1) action .

Action Parameters

Try to think of the action parameters as a JSON Object when reading this table. There will be a JavaScript example of the action below this table.

Fields	Type	Description
to	eosio::name	The receiver Account
token_configs	std::vector<token_config>	An array of token configs described below.
memo	std::string	A short operation description.
authorizer	std::binary_extension<std::name>	The account that authorizes this issue of NFTs.

Token Config Interface

Fields	Type	Description
token_factory_id	uint64_t	The issuing token factory ID
amount	uint64_t	The number of tokens to mint
custom_data	std::string	A short operation description.

CLI - cleos

cleos push action eosio.nft.ft issue '[{ "to": "to.user.acc", "token_configs": [{"token_factory_id": 5, "amount": 1, "custom_data": ""}], "memo": "token time" }]' -p factory.manager@active

• with authorizer

cleos push action eosio.nft.ft issue '[{ "to": "to.user.acc", "token_configs": [{"token_factory_id": 2, "amount": 1, "custom_data": ""}], "memo": "token time", "authorizer": "auth.minter.account" }]' -p auth.minter.account@active

JavaScript - eosjs

await api.transact(
    {
        actions: [
            {
                account: 'eosio.nft.ft',
                name: 'issue',
                authorization: [{ actor: 'factory.manager', permission: 'active' }],
                data: {
                    issue: {
                        to: 'to.user.acc',
                        token_configs: [
                            {
                                token_factory_id: 5,
                                amount: 1,
                                custom_data: '',
                            },
                        ],
                        memo: 'token time',
                    },
                },
            },
        ],
    },
    {
        blocksBehind: 3,
        expireSeconds: 30,
    }
);

• with authorizer

await api.transact(
    {
        actions: [
            {
                account: 'eosio.nft.ft',
                name: 'issue',
                authorization: [{ actor: 'auth.minter.account', permission: 'active' }],
                data: {
                    issue: {
                        to: 'to.user.acc',
                        token_configs: [
                            {
                                token_factory_id: 5,
                                amount: 1,
                                custom_data: '',
                            },
                        ],
                        memo: 'token time',
                        authorizer: 'auth.minter.account',
                    },
                },
            },
        ],
    },
    {
        blocksBehind: 3,
        expireSeconds: 30,
    }
);