How nurnberg-meistersinger/cicada-test-task works
Project type and purpose
• This is a blockchain security‐audit/test environment combined with a research deliverable. It is not a web app or microservice stack, but rather a Foundry‐based smart‐contract testing suite (“Audit/”) plus a complementary research report and assets (“Research/”).
File structure
• Top level:
• .gitmodules (submodules for forge‐std & OpenZeppelin)
• Audit/ (smart‐contract tests & interfaces)
• Research/ (risk‐report.md + images)
• Audit/ components:
• src/ – contract interfaces and helper contracts
• lib/ – submodules: forge‐std, openzeppelin-contracts
• test/ – unit tests, forked‐chain tests, ACL checks
• foundry.toml – Foundry configuration
• Research/ components:
• risk-report.md – main document with methodology and findings
README
• Describes the audit focus (Solera Markets on Plume Network)
• Lists dependencies: Foundry (forge+cast), jq, Plume RPC
• Guides the reader through the report, tests, and images
Main components
a. Developer Environment
– Foundry toolchain (forge, cast)
– jq
– local filesystem with Audit/ and Research/
b. On‐chain Data Source
– Plume Network RPC endpoint (forked node)
c. Audit Codebase
– Interfaces (src/)
– Helper contracts (src/)
– OpenZeppelin & forge‐std libraries (lib/)
– Test suite (test/)
d. Research Artifacts
– risk-report.md (Markdown)
Relationships and interactions
• Developer invokes “forge test” → Foundry compiles src/ + lib/ → deploys to forked Plume RPC → runs test scripts against live state → outputs JSON/logs → optionally piped through jq for analysis
• Research materials reference test results and on‐chain snapshots produced by cast (Tenderly traces, DefiLlama data).
• risk-report.md aggregates findings, embeds images from Research/images.
Architectural patterns and design principles
• Clear separation between on‐chain testing layer (Audit/) and documentation layer (Research/)
• Reuse of battle‐tested libraries (OpenZeppelin, forge‐std)
• Forked‐chain testing allows deterministic reproduction without a live network