How layr-labs/hello-world-avs works
Main Components
a. On-Chain Components (Blockchain Layer)
• Local Anvil Chain (Ethereum JSON-RPC endpoint)
• Core EigenLayer Contracts
– IAVSDirectory
– ECDSAStakeRegistry
– IDelegationManager
• Hello World AVS Contracts
– HelloWorldServiceManager.sol
– HelloWorldServiceManagerFactory (if present)
b. Off-Chain Components (Operator Services & Tools)
• TypeScript Operator (operator/index.ts)
• Rust Operator (operator/rust/crates/operator)
• Rust Challenger (operator/rust/crates/operator/challenger.rs)
• Task-generator / Traffic Script (operator/createNewTasks.ts)
• Distribution Scripts (scripts/*, npm make targets)
• ABI Extraction Utility (utils/abis.js)
c. Developer Tooling & CI/CD
• Foundry (forge, anvil, contracts/foundry.toml)
• npm / ts-node / Rust toolchain
• GitHub Actions workflows (.github/workflows)
• Dockerfile & Makefile for reproducible builds
Relationships & Data Flows
• Consumer (CLI / HTTP client) → invokes HelloWorldServiceManager via JSON-RPC →
contracts emit NewTaskCreated event.
• Off-chain Operators subscribe to events (via ethers.js in TS, web3 in Rust),
generate + sign “Hello World” message, and send tx back to HelloWorldServiceManager.
• HelloWorldServiceManager checks stake (via ECDSAStakeRegistry) and records responses.
• Challenger listens for unresponded tasks past threshold → issues slashOperator tx.
• Distribution scripts read contract state (using ABIs) → build merkle roots → claim distributions.
Architectural Patterns
• Event-driven Architecture: On-chain events trigger off-chain services.
• Separation of Concerns:
– Smart contracts handle staking, task-lifecycle, slashing.
– Off-chain operators handle computation, signing, and monitoring.
• Polyglot Operator Clients:
– TypeScript for rapid prototyping / CI integration.
– Rust for performance / challenger logic.
• Local Devnet CI:
– Anvil snapshotting for deterministic tests (make build-anvil-state-with-deployed-contracts).
Incorporate Key Technologies
• Solidity + Foundry for contracts
• Anvil as local Ethereum node
• ethers.js / ts-node for TypeScript operator
• Rust (tokio, web3 bindings) for challenger & operator
• JSON ABI artifacts (abis/*.json) for off-chain bindings
• Nix / Docker for reproducible environments
• GitHub Actions for CI