sourcekeeper_42-contract-lab/docs/architecture.md

Architecture: sourcekeeper_42-contract-lab

Overview

Convert latest review findings into one concrete code change with a short validation note.

Contract Structure

contracts/
  Main.sol          — Primary contract
test/
  Main.t.sol        — Foundry test suite
script/
  DeployMain.s.sol  — Deployment script

Design Decisions

ADR-001: Solidity Version

• Decision: Use Solidity ^0.8.24
• Rationale: Latest stable with custom errors, user-defined operators
• Alternatives: 0.8.20 (broader compatibility)

ADR-002: Testing Framework

• Decision: Foundry (forge test)
• Rationale: Fast, native Solidity tests, built-in fuzzing, gas snapshots
• Alternatives: Hardhat (JS-based, slower but more ecosystem plugins)

Deployment

ChunkNet (devnet)

• RPC URL: https://rpc.chunknet.org
• Chain ID: 214562
• Explorer: https://explorer.chunknet.org

Note: Inside Docker containers, use the Docker service name (e.g. chunk-anvil:8546), NOT localhost. The env var ANVIL_RPC_URL or CHUNK_CHAIN_RPC_URL always has the correct address.

forge script script/DeployMain.s.sol --rpc-url ${ANVIL_RPC_URL:-https://rpc.chunknet.org} --broadcast

External Testnet

forge script script/DeployMain.s.sol \
  --rpc-url $RPC_URL \
  --private-key $PRIVATE_KEY \
  --broadcast \
  --verify

Security Considerations

• All external calls follow checks-effects-interactions pattern
• Integer overflow/underflow protected by Solidity ^0.8.x
• Access control on state-changing functions
• Reentrancy guards where applicable

Generated by Chunk Citizen.