GrindURUS Frontend ICP

This repository contains the frontend of the GrindURUS Protocol, deployed on the Internet Computer (ICP) using a frontend canister. The frontend is built with TypeScript and leverages dfx for canister management and deployment.

🚀 Overview

GrindURUS is a decentralized protocol with multiple components. This frontend provides an interface for interacting with various parts of the protocol, including minting, burning, depositing tokens, and accessing AI-powered tools.

📁 Structure

• src/grindurus-frontend — Source files for the frontend canister.
• package.json — Dependencies and scripts for the frontend.
• dfx.json — Configuration file for canisters on the Internet Computer.

🌐 Pages

🏠 Dashboard (Completed/Continue Development)

• Panel Section:
  • Displays main protocol features.
  • Includes:
    • TotalInfo: Shows total agents created, funds deposited, pools minted, grETH grinded
    • IntentNFT Form: Allows users to mint an IntentNFT which allow to auto grinds pools.
    • Create Form: Enables users to deposit tokens and mint a new isolated pool or agent.
• Tables Section:
  • Allow to choose and view table
  • Includes:
    • Pools: Shows all minted pools, allow user to search by pool id
    • Intents: Shows all minted intents, allow user to search by token id
    • Agents: Shows all created agents, allow user to search by agent id

🧪 grETH (Completed)

• Burn grETH and receive tokens.
• Mint new grETH at a 1:1 ratio with ETH.

🧠 grAI (Completed)

• Interface for the bridge grAI token.
• Functionality under development.

🔁 Grind (Completed.Continue Development)

• Allows to grind pool choosen by GrinderAI.

📦 Pool (Completed)

• Panel Section:
  • Displays main pool features.
  • Includes:
    • PoolInfo: Shows addresses of oracles, tokens, pool owner and royalty receiver
    • Interaction: Allows to interact with pool: desposit, withdraw, exist, buy royalty.
    • Configuration: Enables users to configure pool parameters.
• Tables Section:
  • Shows tables that include pool configs.
  • Includes:
    • Positions: Shows positions info
    • Thresholds: Shows thresholds info

⚙️ Agent (In Progress)

• Interface to interation with agent

🤖 Grinder AI (Demo Completed/Feature Disabled)

• AI-powered assistant chat.
• Helps users navigate the protocol and get pool-related info.

🛠️ Development

Requirements

• Node.js
• dfx

🎞 Installation & Deployment

First, install the project dependencies:

npm install

---

🚀 Local Deployment (IC Local Replica)

1. Start the local replica:

   dfx start --background

2. Deploy the frontend canister locally:

   dfx deploy

3. Access the frontend:

   After deployment, open the local frontend in your browser. The URL will look like:

   http://<canister_id>.localhost:4943
   

   You can find the canister ID in .dfx/local/canister_ids.json.

---

🌐 Deployment to ICP Mainnet

Make sure you're authenticated with your Internet Identity or have access to a wallet that can sign deployments.

1. Deploy to the Internet Computer mainnet:

   dfx deploy --network ic

2. Access the frontend:

   After a successful deployment, you'll get a public URL like:

   https://<canister_id>.icp0.io
   

---

💡 You can edit environment-specific configurations in dfx.json and optionally use .env files to manage variables.