{"id":32370252,"url":"https://github.com/hadv/abunfi-contracts","last_synced_at":"2025-10-24T20:25:16.565Z","repository":{"id":312233605,"uuid":"1046689538","full_name":"hadv/abunfi-contracts","owner":"hadv","description":"Abunfi is a micro-savings platform that allows users to deposit small amounts of USDC and automatically allocates funds across multiple DeFi yield strategies. The platform is designed for users in emerging markets who want to earn yield on small amounts of capital.","archived":false,"fork":false,"pushed_at":"2025-09-27T03:07:52.000Z","size":357,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-27T03:20:13.611Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hadv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-29T04:32:05.000Z","updated_at":"2025-09-18T09:54:53.000Z","dependencies_parsed_at":"2025-08-29T12:06:36.081Z","dependency_job_id":"d58c5dd9-45ad-490e-add1-5bc0edfec40f","html_url":"https://github.com/hadv/abunfi-contracts","commit_stats":null,"previous_names":["hadv/abunfi-contracts"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hadv/abunfi-contracts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi-contracts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi-contracts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi-contracts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi-contracts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hadv","download_url":"https://codeload.github.com/hadv/abunfi-contracts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi-contracts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280859967,"owners_count":26403658,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-24T20:25:11.746Z","updated_at":"2025-10-24T20:25:16.556Z","avatar_url":"https://github.com/hadv.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Abunfi Contracts\n\nSmart contracts for the Abunfi micro-savings platform, built with Foundry.\n\n## Overview\n\nAbunfi is a micro-savings platform that allows users to deposit small amounts of USDC and automatically allocates funds across multiple DeFi yield strategies. The platform is designed for users in emerging markets who want to earn yield on small amounts of capital.\n\n## Architecture\n\n### Core Contracts\n\n- **AbunfiVault.sol** - Main vault contract that manages user deposits and shares\n- **StrategyManager.sol** - Manages strategy allocation and rebalancing\n- **IAbunfiStrategy.sol** - Interface for all yield strategies\n\n### Strategy Contracts\n\n- **AaveStrategy.sol** - Aave V3 lending strategy\n- **CompoundStrategy.sol** - Compound V3 strategy  \n- **LiquidStakingStrategy.sol** - Liquid staking (stETH, rETH)\n- **LiquidityProvidingStrategy.sol** - AMM liquidity provision\n\n### Mock Contracts\n\nLocated in `src/mocks/` for testing and development purposes.\n\n## Getting Started\n\n### Prerequisites\n\n- [Foundry](https://getfoundry.sh/)\n- Node.js (for additional tooling)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/hadv/abunfi-contracts.git\ncd abunfi-contracts\n\n# Install dependencies\nforge install\n\n# Build contracts\nforge build\n\n# Run tests\nforge test\n```\n\n## Deployment\n\n### Local Development\n\n```bash\n# Start local node\nanvil\n\n# Deploy to local network\nforge script script/Deploy.s.sol --rpc-url http://localhost:8545 --broadcast\n```\n\n### Testnet Deployment\n\n```bash\n# Deploy to Arbitrum Goerli\nforge script script/Deploy.s.sol --rpc-url arbitrum_goerli --broadcast --verify\n```\n\n### Mainnet Deployment\n\n```bash\n# Deploy to Arbitrum mainnet\nforge script script/Deploy.s.sol --rpc-url arbitrum --broadcast --verify\n```\n\n## Testing\n\n```bash\n# Run all tests\nforge test\n\n# Run tests with verbosity\nforge test -vvv\n\n# Run specific test file\nforge test --match-contract BasicSetupTest\n```\n\n## License\n\nMIT License\n\n## Integration\n\nThis contracts repository is designed to be consumed by the main Abunfi application.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadv%2Fabunfi-contracts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhadv%2Fabunfi-contracts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadv%2Fabunfi-contracts/lists"}