BAMFS (Blockchain Addressable Merkle File System) was the working name of ABX FS, Art Blocks' permissionless, content-addressed, immutable file system on EVM chains. Its contracts, SDK, CLI, gateway, specs and documentation live in ArtBlocks/abxfs, and the user documentation is at docs.fs.abx.io.
This repository holds no code. It is kept so that references to github.com/ArtBlocks/bamfs, including the two
defensive publications below, lead to the right place.
Published on Technical Disclosure Commons by Art Blocks, Inc. on 2026-08-26 (CC BY 4.0). Each names this repository as its reference implementation, which was private when they were published:
- Disclosure 11507: On-Chain Reconstruction of IPFS Content Identifiers from EVM-Resident Content-Addressed Data
- Disclosure 11508: Trustless Cross-Chain Derivation of IPFS Content Identifiers via Zero-Knowledge Proofs
| Disclosure | Path it cites | Now |
|---|---|---|
| 11507 | packages/contracts-companion/src/IpfsCidResolver.sol |
The same path in ArtBlocks/abxfs: IpfsCidResolver.sol. Deployed at 0x7CE58c2945CbE3C2bDb0D3d276Ba3b9bD294008d on every network ABX FS supports, with its source verified (deployments). |
| 11507 | packages/contracts-companion/src/interfaces/IIpfsCidResolver.sol |
The same path in ArtBlocks/abxfs: IIpfsCidResolver.sol. |
| 11507 | specs/bamfs-companion-spec.md |
Replaced by specs/abx-fs.md §8, IPFS CID derivation, the import profile as shipped. |
| 11508 | packages/zk-circuit/, packages/zk-prover/, specs/bamfs-zk-spec.md |
Not carried forward. The cross-chain verifier was at the specification stage when it was disclosed and is not part of ABX FS; Disclosure 11508 describes the method in full. |
Each of those paths also holds a short file here that points to the same place. The deployed build of the contracts
is the abx-fs-freeze-3 tag of ArtBlocks/abxfs.