https://github.com/vectorized/dn404
Implementation of a co-joined ERC20 and ERC721 pair.
https://github.com/vectorized/dn404
Last synced: 9 months ago
JSON representation
Implementation of a co-joined ERC20 and ERC721 pair.
- Host: GitHub
- URL: https://github.com/vectorized/dn404
- Owner: Vectorized
- License: mit
- Created: 2024-02-10T06:34:26.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-19T02:51:43.000Z (11 months ago)
- Last Synced: 2025-05-08T21:17:00.314Z (9 months ago)
- Language: Solidity
- Homepage:
- Size: 888 KB
- Stars: 505
- Watchers: 14
- Forks: 157
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Audit: audits/guardian-audits-report.pdf
Awesome Lists containing this project
README
# DN404 🥜
[![NPM][npm-shield]][npm-url]
[![CI][ci-shield]][ci-url]
DN404 is an implementation of a co-joined ERC20 and ERC721 pair.
To learn more about these dual nature token pairs, you can read the full [ERC-7631 spec](https://eips.ethereum.org/EIPS/eip-7631).
- Full compliance with the ERC20 and ERC721 specifications.
- Transfers on one side will be reflected on the other side.
- Pretty optimized.
## Installation
To install with [**Foundry**](https://github.com/gakonst/foundry):
```sh
forge install vectorized/dn404
```
To install with [**Hardhat**](https://github.com/nomiclabs/hardhat):
```sh
npm install dn404
```
## Contracts
The Solidity smart contracts are located in the `src` directory.
```ml
src
├─ DN404 — "ERC20 contract for DN404"
├─ DN404Mirror — "ERC721 contract for DN404"
├─ DN420 — "Single-contract ERC20 ERC1155 chimera"
└─ example
├─ SimpleDN404 — "Simple DN404 example as ERC20"
└─ NFTMintDN404 — "Simple DN404 example as ERC721"
```
## Contributing
Feel free to make a pull request.
Guidelines same as [Solady's](https://github.com/Vectorized/solady/issues/19).
## Safety
This is **experimental software** and is provided on an "as is" and "as available" basis.
We **do not give any warranties** and **will not be liable for any loss** incurred through any use of this codebase.
While DN404 has been heavily tested, there may be parts that exhibit unexpected emergent behavior when used with other code, or break in future Solidity versions.
Please always include your own thorough tests when using DN404 to make sure it works correctly with your code.
## Upgradability
Most contracts in DN404 are compatible with both upgradeable and non-upgradeable (i.e. regular) contracts.
Please call any required internal initialization methods accordingly.
## Acknowledgments
This repository is inspired by various sources:
- [ERC7647 (a.k.a. SJ741)](https://github.com/SJ741/sj741-token)
- [ERC7651 (a.k.a. "ERC"404)](https://github.com/Pandora-Labs-Org/erc404)
- ["ERC"425](https://github.com/paradox425/ERC425)
- [Solady](https://github.com/vectorized/solady)
- [ERC721A](https://github.com/chiru-labs/ERC721A)
[npm-shield]: https://img.shields.io/npm/v/dn404.svg
[npm-url]: https://www.npmjs.com/package/dn404
[ci-shield]: https://img.shields.io/github/actions/workflow/status/vectorized/dn404/ci.yml?branch=main&label=build
[ci-url]: https://github.com/vectorized/dn404/actions/workflows/ci.yml