Practical overview
When it fits
Use the collection as a running-achievement collectible, or consult its repository when studying on-chain audio and run-data-driven NFT metadata.
Who it is for
- Collectors interested in commemorative, activity-based NFTs.
- Developers exploring on-chain audio generation, token metadata, or themed NFT visuals.
Documented uses
- Explore a running achievement represented as a set of NFTs with day-specific run information.
- Inspect an example of audio generated on-chain and included in token metadata.
- Study or adapt the project’s Solidity contracts and repository scripts for an activity-based collectible.
Requirements & limits
The public repository is available under the MIT license. The project README documents deployment on Base.
- The collection is documented as 1,000 tokens, with metadata holding a 24.832-second audio arrangement for each token.
- Run information and a themeable color palette are part of the token presentation.
- The repository’s developer workflow requires Foundry; documented data-generation scripts use Python.
- The README says the main contract requires two public libraries to avoid the Spurious Dragon contract code-size limit.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Generate the audio file with Foundry
Use the repository’s supplied script to generate its audio output file.
Before you start
- Foundry installed
- A clone of the 555 repository and its dependencies installed
Steps
Clone the repository and change into its directory.
Run
forge installto install dependencies.Run
forge script script/GenerateAudioOutput.s.sol:GenerateAudioOutputScript --via-ir --memory-limit="50000000000".
Expected outcome
The script is documented to write `./output/wav/rocky.wav`.
Guide limitations
- The README documents this script and output path but does not establish that the command has been run successfully in another environment.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- fiveoutofnine/555 · Official homepage title · retained in its source language

