♻️Recycling Protocol

A modular token utility extension protocol.

Recyclable Token

A Recyclable Token is a standard ERC20 extended for the purpose of allowing a relatively infinite number of modularly connected utility contracts to recycle the token's supply with inflationary and deflationary mechanisms.

A Recyclable Token is a standard ERC20 token, with token utility extensions.

Recyclable Token Utility Roles

Standard Access Control is used to allow a primary Admin role to grant minting and burning roles and token allocation to token utility contracts. A token utility contract that requires minting new tokens must be granted Minter role, and allocated an amount of tokens to mint. In order for a utility contract to burn tokens, it must own all tokens burned and granted Burner role. A third utility role, Recycler role, grants a utility contract both Minter and Burner roles on the token.

• Admin role - Account, with ability to add new token utilities and adjust utility token allocation.

• Minter role - Contract, with allocation controlled access to mint new tokes to an account.

• Burner role - Contract, with allocation controlled access to burn any owned tokes.

• Recycler role - Contract, with both Minter role and Burner role access, able to mint and burn tokens.

Recyclable Token Utility Allocation

Token minting and burning utility roles are regulated by an amount of tokens allocated to each utility contract, controlled by the Admin role account. A Minter or Recycler utility contract is allocated an initial amount of the token, and all tokens minted are minted reduce that allocated amount. Once a utility contract's allocation reaches zero, the utility contract can no longer mint tokens until allocation is increased. Allocation of a Burner or Recycler utility contract is able to burn any tokens it owns, and therefore able to increase a utility contract's allocation.

Utility minting increases token circulating supply (inflation), while equally decreasing the utility's token allocation. Utility burning decreases the token's circulating supply (deflation), while equally increasing the utility's token allocation.

$$Maximum Supply = Circulating Supply + Allocated Supply + Unallocated Supply$$

Total token allocation to all token utilities cannot exceed maximum token supply.

Recyclable Token Write Functions

Write Function	Role	Description
setMinter(address, active)	Admin	Grant utility contract address Minter role.
setBurner(address, active)	Admin	Grant utility contract address Burner role.
setRecycler(address, active)	Admin	Grant utility contract address, Minter and Burner role.
allocate(address, amount)	Admin	Increase utility contract allocation by amount.
release(address, amount)	Admin	Decrease utility contract allocation by amount.
mint(address, amount)	Minter	Mint address amount of tokens, reduce utility's allocation by amount.
burn(amount)	Burner	Burn amount of owned tokens, increase utility's allocation by amount.
*plus ERC20 write functions

Recyclable Token Read Functions

Read Functions	Description
isMinter(address)	Check utility contract address for Minter role.
isBurner(address)	Check utility contract address for Burner role.
isRecycler(address)	Check utility contract address for Minter and Burner role.
maxSupply	Maximum token supply.
totalAllocation	Total token utility supply allocation.
allocationOf(address)	Current token utility supply allocation for utility contract address.
*plus ERC20 read functions

Recycling Utilities

Utility contracts created for the purpose of providing utility extension to Recyclable Tokens

• NFT Harvest Protocol

• Staked NFT Protocol