All notable changes to Sweep will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Documentation: DEVELOPMENT.md - Local development guide
- Documentation: DEPLOYMENT.md - Production deployment guide
- Documentation: DATABASE.md - Database schema documentation
- Documentation: QUEUE_WORKERS.md - Background job documentation
- Documentation: TESTING.md - Comprehensive testing guide
- Documentation: MONITORING.md - Observability guide
- Documentation: CONTRIBUTING.md - Contribution guidelines
- Updated docs/README.md with links to all documentation
- None
0.1.0 - 2026-01-22
- Multi-chain dust sweeper supporting Ethereum, Base, Arbitrum, Polygon, BSC, Optimism, Linea
- Gasless transactions via ERC-4337 account abstraction
- Permit2 integration for gasless token approvals
- DeFi routing to Aave V3, Yearn V3, Beefy, Lido
SweepDustSweeper- Main entry point contractSweepBatchSwap- Batch swap executionSweepPermit2Batcher- Permit2 integrationSweepVaultRouter- DeFi vault routingSweepFeeCollector- Protocol fee management
- REST API with Hono framework
- SIWE (Sign-In with Ethereum) authentication
- Wallet scanning endpoint (
POST /api/wallet/scan) - Quote generation endpoint (
POST /api/quote) - Sweep execution endpoint (
POST /api/sweep/execute) - Status tracking endpoint (
GET /api/status/:id) - DeFi destinations endpoint (
GET /api/defi/vaults) - Bridge routes endpoint (
GET /api/bridge/routes) - Health check endpoints (
/health,/health/live,/health/ready)
- Wallet scan worker
- Price update worker
- Sweep execution worker
- Sweep tracking worker
- Bridge execution worker
- Bridge tracking worker
- Subscription monitoring worker
- PostgreSQL 16 with Drizzle ORM
- Users, tokens, sweeps, quotes tables
- Subscriptions and auto-sweep tables
- API payments and credits tables
- Price cache with multi-source validation
- Next.js 14 App Router
- Wallet connection with wagmi v2
- Chain selector component
- Dust token list with selection
- Sweep preview and execution
- Transaction status tracking
- Docker and Docker Compose setup
- Kubernetes manifests for deployment
- Prometheus metrics and Grafana dashboards
- GitHub Actions CI/CD pipeline
- Multi-oracle price validation
- Token whitelist/blacklist registry
- Rate limiting and input validation
- Reentrancy protection on all contracts
- Emergency pause mechanism
- Initial security review completed
- Threat model documented in SECURITY.md
We use Semantic Versioning:
- MAJOR (1.0.0): Breaking changes to API or contracts
- MINOR (0.1.0): New features, backward compatible
- PATCH (0.0.1): Bug fixes, backward compatible
- Create release branch:
release/vX.Y.Z - Update CHANGELOG.md
- Update package.json version
- Create GitHub release with tag
- CI deploys to production