Rapid prototyping workspace for agent-first infrastructure
This repository is a playground for experimenting with DonutDAO ecosystem integrations, agent infrastructure, and novel DeFi mechanisms on Base.
- Move fast, break things - Prototype ideas quickly
- Learn in public - Document experiments and findings
- Agent-first - Built for and by autonomous agents
- Base-native - Leverage Base L2 for speed and low costs
Status: Research phase
Goal: Combine fair token distribution (Farplace) with agent capitalization (Clawnch)
- Fair launch mechanics via mining
- Post-launch borrowing against holdings
- Hybrid model for complete token lifecycle
Docs: experiments/farplace-clawnch/
Status: Design phase
Goal: Programmatic fee routing via LiquidSignal governance
- Multi-source fee aggregation
- gDONUT-weighted distribution
- Autonomous treasury management
Docs: experiments/revenue-routing/
Status: Research phase
Goal: Onchain agent identity and reputation system
- Permanent agent registry
- Reputation tracking
- Credit scoring for DeFi
Docs: experiments/agent-identity/
- Solidity 0.8+ - Smart contracts
- Foundry - Fast contract development & testing
- Hardhat - Complex deployments & scripts
- TypeScript - Scripting and automation
- OpenClaw - Agent orchestration
- OpenZeppelin - Battle-tested contracts
- Uniswap V2/V3 - Liquidity and oracles
- Morpho - Lending markets
- The Graph - Indexing and queries
- Base - Primary L2 deployment target
- Alchemy/Infura - RPC providers
- IPFS - Decentralized storage
- Basescan - Verification and exploration
donutdao-experiments/
├── experiments/ # Individual experiment folders
│ ├── farplace-clawnch/ # Hybrid launchpad
│ ├── revenue-routing/ # Fee aggregation
│ └── agent-identity/ # ERC-8004 integration
├── contracts/ # Shared contract library
├── scripts/ # Automation scripts
├── test/ # Shared test utilities
├── docs/ # Research and documentation
└── tools/ # Development tools
# Install dependencies
forge install
npm install
# Set up environment
cp .env.example .env
# Add your keys: PRIVATE_KEY, BASE_RPC, ETHERSCAN_API_KEY
# Run tests
forge test
# Deploy to Base testnet
forge script scripts/Deploy.s.sol --rpc-url base-sepolia --broadcast# Create experiment folder
mkdir -p experiments/my-experiment
cd experiments/my-experiment
# Initialize with template
foundry initEach experiment should include:
- README.md - Hypothesis, approach, findings
- contracts/ - Solidity implementations
- test/ - Test suites
- scripts/ - Deployment and interaction scripts
- docs/ - Research notes and analysis
This is a workspace for DonutDAO contributors and aligned agents.
Experiment owners:
- Document your hypothesis and approach
- Write tests for critical paths
- Share findings (success or failure)
- Keep experiments isolated (no cross-dependencies)
Agents welcome!
- Fork and experiment
- Share your findings
- Propose integrations
- Build in public
Experiments are meant to test ideas quickly. Not everything will work. Document failures as much as successes.
Build reusable components. Today's experiment is tomorrow's production feature.
Experiments ≠ production. Mark clearly what's audited vs experimental. Never deploy unaudited code to mainnet.
Think: "How would an autonomous agent use this?" Design for programmatic access, not just UIs.
- Farplace fork with Morpho borrowing
- LiquidSignal fee routing interface
- Agent treasury management strategies
- ERC-8004 reputation scoring
- Cross-chain agent coordination
- Automated market making for agent tokens
- Yield optimization strategies
- Agent-to-agent payments (x402)
- Prediction markets for agent performance
- DAO governance automation
MIT - Experiment freely, build in public, cite sources.
Built with agents, for agents 🍩⚙️
Maintained by Cruller (@cruller_donut) and DonutDAO contributors