Skip to content

Latest commit

 

History

History
51 lines (42 loc) · 2.74 KB

README.md

File metadata and controls

51 lines (42 loc) · 2.74 KB

ERC721H

Most optimized batch minting ERC721 implementation in the EVM ecosystem. Rewrite of ERC721A in Huff.

Gas Comparison (ERC721H vs ERC721A vs OpenZeppelin's ERC721)

Tests Huff Azuki Azuki (delta vs. Huff) OZ OZ (delta vs. Huff)
Mint 200 437,232 447,020 -9,788 4,999,553 -4,562,321
Mint 50 149,382 152,120 -2,738 1,273,403 -1,124,021
Safe Transfer To Receiver 63,550 65,436 -1,886 66,160 -2,610
Simple Burn 1 In 60,503 82,611 -22,108 38,893 +21,610
Simple Burn 38,342 60,214 -21,872 38,893 -551
Simple Safe Transfer To EOA 62,379 63,364 -985 64,151 -1,772
Simple Transfer 1 In 81,987 82,958 -971 61,271 +20,716
Simple Transfer 20 In 115,306 119,835 -4,529 61,271 +54,035
Simple Transfer 59,817 60,561 -744 61,271 -1,454

Gas Comparison - Methodology

General Approach:

  1. Create minimal reference implementations using the ERC721A and OpenZeppelin libraries respectively, viewable under src/refs/
  2. Created comparison test contract with identical tests for all 3 versions test/CompareERC721.t.sol
  3. Wrote and ran script that extracts the gas use of the actual main call in each test and adds the 21k base transaction stipend to the total cost of all calls

Table Generation:

To generate the above table run the following commands

forge build # necessary to ensure no warnings in `forge test` output
forge test --match-contract CompareERC721Test --ffi -vvvv > gas-compare.txt
python script/extract_gas_cost_comparison.py

Using ERC721H

Using ERC721H - Security Considerations

  • Excessively large, arbitrary ERC721H__START_TOKEN_ID values may lead to owner data storage slots colliding with other variables, leading to a suite of bugs / vulnerabilities

Naming Convention

  • prefix all macros / constants / labels with {FileName}__ e.g. ERC721H__MY_MACRO
  • exceptions to above rule
    • prefix storage slot constants with {FileName}_SLOT__
    • name the constructor and selector switch {FileName}_CONSTRUCTOR / {FileName}_SELECTOR_SWITCH respectively
    • function signature constants do not require a prefix
  • prefix macros / labels / constants that are only meant for internal use (quasi private) with a double underscore e.g. __ERC721H__selectorSwitchEnd
  • use camel case for labels / custom function signatures
  • use snake case for macros / constants