Browse and upload on-chain files at ethfs.xyz
dhof's on-chain 3D rose NFT inspired tons of fun conversations and projects. It surfaced many examples and use cases for highly reusable on-chain assets (JS libraries, fonts, gifs).
EthFS is an effort to consolidate these assets into a public, durable on-chain repository with ergonomic, gas-optimized methods for reading and writing files.
EthFS leans on SSTORE2's strategy to efficiently read and write data in the form of contract bytecode. The frontend splits files into 24kb chunks (max contract size) and writes them to deterministic content addresses via Safe Singleton Factory. This means the content address can be computed ahead of time and is the same across EVM chains.
A File struct wraps a set of bytecode slices that, when concatenated, represent the full file contents. It also holds the logic for reading/unwrapping the file contents into a single string in a very gas-efficient way.
The FileStore contract acts as a minimum viable registry, a global namespace of human-readable filenames for more ergonomic use within consumer contracts and the frontend's file browser. A CDN of sorts.
-
forge install holic/ethfs -
Go into your
foundry.tomland add"@holic/ethfs/"to yourremappingsarray -
Go into your
.solfile and addimport "@holic/ethfs/contracts/src/FileStore.sol"; -
Have fun!
| Ethereum | |
|---|---|
| Ethereum Mainnet | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Ethereum Sepolia | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Ethereum Holesky | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Base | |
| Base Mainnet | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Base Sepolia | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Optimism | |
| Optimism Mainnet | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Optimism Sepolia | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Zora | |
| Zora Mainnet | 0xFe1411d6864592549AdE050215482e4385dFa0FB |
| Zora Sepolia | 0xFe1411d6864592549AdE050215482e4385dFa0FB |