v0.4.0
Canonical implementations of ERCs with real on-chain traction. Foundry-native, Solidity-tested.
OpenZeppelin covers the core 10 standards (ERC-20, 721, 1155, etc.) thoroughly. The next 30 ERCs — standards with thousands of deployments, millions in TVL, and active protocol adoption — have no audited, library-grade implementations. Developers copy from unaudited repos or roll their own.
Curated ERC Contracts fills that gap.
- Foundry-native, Solidity-tested — no JS test harness, no Hardhat dependency
- Non-upgradeable + Upgradeable — both variants in one repo, upgradeable versions use ERC-7201 namespaced storage
- OZ-grade quality — NatSpec docs, custom errors, fuzz tests, internal security audits per contract
- Curated, not exhaustive — only ERCs with demonstrated on-chain adoption
| ERC | Name | Category |
|---|---|---|
| 1363 | Payable Token | Token (ERC-20 extension) |
| 5192 | Minimal Soulbound NFT | Token (ERC-721 extension) |
| 4907 | Rental NFT | Token (ERC-721 extension) |
| 4906 | Metadata Update Extension | Token (ERC-721 extension) |
| 5484 | Consensual Soulbound Tokens | Token (ERC-721 extension) |
| 2309 | Consecutive Transfer (Batch Mint) | Token (ERC-721 extension) |
| 3525 | Semi-Fungible Token | Token (ERC-721 compatible) |
| 1271 | Signature Validation for Contracts | Cryptography |
| 6492 | Predeploy Signature Validation | Cryptography |
| 2771 | Meta Transactions | Context / Gasless UX |
| 3156 | Flash Loans | DeFi / Finance |
| 7201 | Namespaced Storage Layout | Utils / Upgrades |
| 2535 | Diamonds (Multi-Facet Proxy) | Proxy / Upgrades |
| 4361 | Sign-In with Ethereum | Auth / Identity |
| 8004 | Trustless Agents | AI Agents (identity, reputation, validation) |
15 standards implemented (non-upgradeable + upgradeable where applicable). Full plan across 40+ ERCs in ROADMAP.md. Release history in CHANGELOG.md.
src/
├── token/
│ ├── ERC1363/ # Payable Token (transfer/approve with callbacks)
│ ├── ERC2309/ # Consecutive Transfer (batch minting)
│ ├── ERC4906/ # Metadata Update Extension
│ ├── ERC3525/ # Semi-Fungible Token (slot + value model)
│ ├── ERC4907/ # Rental NFT (user/owner split with expiry)
│ ├── ERC5192/ # Soulbound NFT (non-transferable)
│ └── ERC5484/ # Consensual Soulbound Tokens (burn authorization)
├── metatx/ # ERC-2771 Trusted Forwarder context
├── finance/ # ERC-3156 Flash Loan lender
├── diamond/ # ERC-2535 Diamonds (multi-facet proxy)
├── auth/ # ERC-4361 Sign-In with Ethereum
│ ├── SIWE.sol # Library: ERC-191 hash, verify, parse address
│ └── SIWEVerifier.sol # Stateless on-chain verifier contract
├── agent/ # ERC-8004 Trustless Agents
│ ├── ERC8004IdentityRegistry(.sol|Upgradeable.sol)
│ ├── ERC8004ReputationRegistry(.sol|Upgradeable.sol)
│ └── ERC8004ValidationRegistry(.sol|Upgradeable.sol)
└── utils/
├── cryptography/ # ERC-1271 + ERC-6492 Signature validation
└── StorageSlot7201.sol
Each ERC typically ships as:
IERC*.sol— Standard interfaceERC*.sol— Non-upgradeable implementation (abstract base or deployable contract)ERC*Upgradeable.sol— Upgradeable (Initializable + ERC-7201 namespaced storage)
Exceptions: ERC-4361 exposes a library (SIWE) plus SIWEVerifier; ERC-6492 and ERC-7201 are libraries/utilities; ERC-8004 ships three deployable registry contracts per variant.
forge install jose-blockchain/curated-ercAdd the remapping to your remappings.txt:
curated-erc/=lib/curated-erc/src/
Then import and extend:
import {ERC1363} from "curated-erc/token/ERC1363/ERC1363.sol";
import {ERC3525} from "curated-erc/token/ERC3525/ERC3525.sol";
import {ERC5192} from "curated-erc/token/ERC5192/ERC5192.sol";
import {ERC4907} from "curated-erc/token/ERC4907/ERC4907.sol";
contract MySFT is ERC3525 {
constructor() ERC3525("MySFT", "MSFT", 18) {}
function mint(address to, uint256 slot, uint256 value) external returns (uint256) {
return _mint(to, slot, value);
}
}
contract MyPayableToken is ERC1363 {
constructor() ERC20("MyToken", "MTK") {
_mint(msg.sender, 1_000_000e18);
}
}ERC-4361 (SIWE) — verify a signed login message on-chain:
import {SIWE} from "curated-erc/auth/SIWE.sol";
import {SIWEVerifier} from "curated-erc/auth/SIWEVerifier.sol";
// Library (inline in your contract)
SIWE.VerificationParams memory params = SIWE.VerificationParams({
message: siweMessage,
signature: sig,
signer: address(0), // parse address from message
chainId: block.chainid,
domain: "app.example.com",
nonce: expectedNonce,
issuedAt: 0,
expirationTime: expiry,
notBefore: 0
});
address user = SIWE.verify(params);
// Or use the standalone verifier (emits SIWEVerified)
SIWEVerifier verifier = new SIWEVerifier();
address user = verifier.verify(params);ERC-8004 (Trustless Agents) — deploy the three registries as chain singletons:
import {ERC8004IdentityRegistry} from "curated-erc/agent/ERC8004IdentityRegistry.sol";
import {ERC8004ReputationRegistry} from "curated-erc/agent/ERC8004ReputationRegistry.sol";
import {ERC8004ValidationRegistry} from "curated-erc/agent/ERC8004ValidationRegistry.sol";
ERC8004IdentityRegistry identity = new ERC8004IdentityRegistry();
ERC8004ReputationRegistry reputation =
new ERC8004ReputationRegistry(address(identity), msg.sender);
ERC8004ValidationRegistry validation =
new ERC8004ValidationRegistry(address(identity), msg.sender);
uint256 agentId = identity.register("ipfs://agent-registration.json");The recommended path is the @nomicfoundation/hardhat-foundry plugin, which lets Hardhat read remappings.txt and resolve imports from the lib/ folder directly — no duplicate OpenZeppelin installs.
- Install the plugin:
npm install --save-dev @nomicfoundation/hardhat-foundry- Add it to your
hardhat.config.ts:
import "@nomicfoundation/hardhat-foundry";- Clone curated-erc as a git submodule (same as Foundry):
forge install <your-github-user>/curated-erc- Add the remapping to
remappings.txt:
curated-erc/=lib/curated-erc/src/
The plugin picks up remappings automatically. Imports work the same way as in Foundry:
import {ERC4907} from "curated-erc/token/ERC4907/ERC4907.sol";
import {SIWEVerifier} from "curated-erc/auth/SIWEVerifier.sol";
import {ERC8004IdentityRegistry} from "curated-erc/agent/ERC8004IdentityRegistry.sol";If you use Hardhat without Foundry, install from npm and add OpenZeppelin as dependencies:
- Install the library and its peer dependencies:
npm install curated-erc @openzeppelin/contracts@5.5.0 @openzeppelin/contracts-upgradeable@5.5.0- Import and extend in your contracts:
import {ERC1363} from "curated-erc/token/ERC1363/ERC1363.sol";
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
contract MyPayableToken is ERC1363 {
constructor() ERC20("MyToken", "MTK") {
_mint(msg.sender, 1_000_000e18);
}
}Hardhat will compile the contracts in node_modules/curated-erc when resolving these imports; no extra config is needed. Use Solidity ^0.8.20 (e.g. 0.8.24) in your hardhat.config to match the library.
forge install
forge build # via-ir enabled for stack-heavy registry contracts
forge test -vv # 261+ tests (unit + fuzz)- OpenZeppelin Contracts v5.5.0
- OpenZeppelin Contracts Upgradeable v5.5.0
- Forge Std v1.15.0
MIT