cherylpinto/HI.FI

โ˜… 0Forks 0GitHub โ†—Compare

Project website โ†—

README

HI.FI - Non-Custodial Agentic Treasury ๐ŸŽฏ

Trust the Bounds. Automate the Yield.

HI.FI is a decentralized treasury pooling platform that bridges the gap between AI-driven strategy and DeFi execution. By separating advice from execution, HI.FI allows users to define risk parameters once and let a deterministic on-chain agent manage capital within those strict bounds. It leverages Arc Protocol for yield infrastructure and Circle's cross-chain USDC gateway to provide a seamless, chain-abstracted experience.

๐Ÿค– "The agent can execute. But only YOU define the bounds."


๐Ÿš€ Live Links


๐Ÿ—๏ธ System Architecture / User Flow Diagram

HI.FI Architecture


๐Ÿงฉ Partner Integrations

HI.FI integrates with Arc (Circle) and ENS to create a transparent, agentic treasury ecosystem.

๐Ÿ”ต Arc (Circle) Integrations

Track What the Track Looks For How HI.FI Satisfies
Best Chain-Abstracted USDC App Applications treating multiple chains as one liquidity surface using Arc and USDC. HI.FI uses Arc as a liquidity coordination layer. Users deposit USDC from Ethereum, Base, or Arbitrum while Arc handles routing, settlement, and treasury execution behind the scenes.
Build Global Payouts & Treasury Systems Automated treasury systems with multi-user deposits, withdrawals, and payouts. HI.FI functions as a pooled USDC treasury with deterministic execution, automated allocation, and transparent withdrawal logic.
Best Agentic Commerce App Autonomous agents executing USDC-denominated logic. HI.FI implements a deterministic on-chain agent that executes user-approved treasury strategies using USDC, enforcing risk policies at the contract level.

๐ŸŸฃ ENS Integrations

Track What the Track Looks For How HI.FI Satisfies
Integrate ENS Functional ENS resolution beyond wallet UI libraries. HI.FI resolves ENS names on login and displays human-readable identities across dashboards, transaction history, and pool participation.
Most Creative Use of ENS in DeFi ENS used as a meaningful protocol-level primitive. HI.FI uses ENS as an identity layer for treasury participation, allowing pooled finance activity to be attributed to human identities instead of raw addresses.

๐Ÿš€ Key Features

Feature Description On-Chain/Off-Chain
Non-Custodial Pooling Users maintain ownership via ERC-4626 inspired share mechanics; the vault owns the assets. On-Chain
Deterministic Agent The StrategyExecutor acts as an agent, making decisions based on pre-set risk policies (Low/Med/High). On-Chain
Chain Abstraction Users deposit any token from any chain; Circle Gateway handles the conversion to USDC automatically. On-Chain
Gasless UX Integrated with Circle Programmable Wallets (SCA) to provide gasless transactions for users. On-Chain
Scheduled Exits Prevents "bank runs" by using controlled withdrawal windows and batch processing. On-Chain

๐Ÿ› ๏ธ Technology Stack

Component Technology Description
Frontend Next.js 15, TypeScript, TailwindCSS User dashboard and risk profiling UI.
Smart Contracts Solidity 0.8.28, Hardhat Core logic for the agent, vault, and risk registry.
Cross-Chain Circle Gateway Handles seamless bridging and cross-chain deposits.
Yield Infrastructure Arc Protocol Primary layer for yield generation and arcUSDC.
Identity Layer ENS Human-readable attribution for pool participation.
Authentication MetaMask Signature-based authentication (No passwords).

๐Ÿ—๏ธ Smart Contract Architecture

The core functionality is managed by modular Solidity contracts that separate user policy from capital deployment.

Contract Purpose Key Roles
PoolVault.sol Base treasury contract handling deposits, shares, and pool lifecycle. Owner, User
StrategyExecutor.sol THE AGENT โ€” Executes allocations based on deterministic policy-based logic. Agent
RiskPolicyRegistry.sol Stores user-defined risk levels (Low, Medium, High) that cap the agent's actions. User
ArcUSDC.sol Wrapped yield-bearing token used for primary yield accrual within the vault. Protocol

Risk โ†’ Allocation Logic

Risk Level Agent Behavior Description
LOW 100% Vault-only strategies Agent execution is explicitly disabled.
MEDIUM Balanced exposure Agent can allocate a capped percentage to stable yield pools.
HIGH Aggressive optimization Higher caps for the agent to move funds within Arc strategies.

๐Ÿง‘โ€๐Ÿ’ป Getting Started (Development)

The project is structured into multiple directories: contracts/, hifi/, and gateway/.

1. Smart Contracts Setup (contracts/)

  1. Install Dependencies:

    cd contracts
    npm install
  2. Configure: Set up your .env file with your RPC URLs and private keys for Base Sepolia and Ethereum Sepolia.

  3. Compile Contracts:

    npx hardhat compile
  4. Deploy Contracts:

    npx hardhat run scripts/deploy-v2-pools.js --network baseSepolia

2. Frontend Setup (hifi/)

  1. Install Dependencies:

    cd hifi
    npm install
  2. Configure: Create a .env.local file with the following:

    NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your_project_id
    MONGODB_URI=your_mongodb_uri
    CIRCLE_API_KEY=your_circle_api_key
  3. Run Development Server:

    npm run dev
  4. Open: Navigate to http://localhost:3000

3. Gateway Setup (gateway/unified-balance-quickstart/)

  1. Install Dependencies:

    cd gateway/unified-balance-quickstart
    npm install
  2. Configure: Set up your Circle API credentials in the environment.

  3. Run Setup:

    node setup.js

๐Ÿ“ Learn More

To learn more about the technologies used in HI.FI:


๐Ÿš€ Deploy on Vercel

The easiest way to deploy the HI.FI frontend is to use the Vercel Platform:

cd hifi
vercel deploy

Make sure to configure your environment variables in the Vercel dashboard before deploying.


๐Ÿ“„ License

This project is open-source and available under the MIT License.


Built with โค๏ธ by Team Big(O)

Contributors

Craig-RosariocherylpintoSaishKorgaonkardhanush-shetty1OmLanke

Issues