Skip to content

jeevansridharan/arbiter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

45 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

⚑ Arbit

AI-powered PayFi protocol for autonomous payouts

"Stop waiting for approval. Let the AI decide. Let the chain pay."

Built for BCH Hackathon HashKey Chain Groq AI React License: MIT


πŸš€ Introduction

Arbit is a decentralized, AI-driven funding protocol that eliminates human governance from the payout process. Built on HashKey Chain (EVM-compatible) and powered by Groq's LLM, Arbit evaluates submitted work autonomously and releases payments through smart contracts β€” no middlemen, no delays, no bias.

Whether you're a freelancer, an open-source contributor, or a DAO participant, Arbit makes sure your work speaks for itself β€” and the AI + blockchain combination ensures you get paid for it, instantly.

πŸ—οΈ Built for the BCH Hackathon Β· Tracks: PayFi + AI


🧠 How It Works

Arbit follows a clean, 5-step autonomous pipeline:

πŸ“ Submit Work  β†’  πŸ€– AI Evaluation (Groq)  β†’  πŸ“Š Score Generated
       β†’  πŸ“œ Smart Contract Triggered  β†’  πŸ’Έ Auto Payout Released
Step Action Technology
1️⃣ Submit User submits work/milestone React Frontend
2️⃣ Evaluate Groq LLM scores the submission Groq API + Node.js
3️⃣ Score AI generates a quality score (0–100) LLM (llama-3.3-70b)
4️⃣ Execute Smart contract reads score and conditions Solidity on HashKey Chain
5️⃣ Payout Funds released automatically on-chain EVM Transaction

No human approvals. No committees. No waiting.


βš™οΈ Tech Stack

Layer Technology Purpose
🎨 Frontend React.js User interface & wallet integration
πŸ”§ Backend Node.js + Express API gateway & AI orchestration
πŸ€– AI Engine Groq API (LLaMA 3.3 70B) Work evaluation & scoring
⛓️ Blockchain HashKey Chain (EVM) On-chain execution
πŸ“œ Smart Contracts Solidity Autonomous payout logic
πŸ”‘ Wallet EVM-compatible (MetaMask, etc.) User authentication & signing

πŸ”₯ Features

  • πŸ€– AI-Powered Evaluation β€” Submissions are scored by a state-of-the-art LLM (Groq / LLaMA 3.3 70B), removing human subjectivity
  • πŸ’Έ Autonomous Payouts β€” Smart contracts release funds on-chain based on AI scores, zero manual intervention
  • πŸ”’ Trustless by Design β€” No central authority; logic is enforced by code and AI
  • πŸͺͺ Wallet Integration β€” Seamless Web3 wallet connect for users on HashKey Chain
  • 🏁 Milestone-Based Funding β€” Break projects into milestones; each evaluated and paid independently
  • ⚑ Fast Settlement β€” On-chain transactions on HashKey Chain with near-instant finality
  • πŸ“Š Score Transparency β€” AI reasoning and scores are visible to all participants

πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    USER INTERFACE                    β”‚
β”‚               (React + Wallet Connect)               β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚  HTTP / Web3
                         β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  ARBIT BACKEND API                   β”‚
β”‚               (Node.js + Express)                    β”‚
β”‚                                                      β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
β”‚  β”‚   Groq AI Layer β”‚    β”‚  Smart Contract Layerβ”‚    β”‚
β”‚  β”‚  (LLM Scoring)  │───▢│  (HashKey Chain EVM) β”‚    β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
                         β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  HASHKEY CHAIN                       β”‚
β”‚          (Testnet: testnet.hsk.xyz)                  β”‚
β”‚                                                      β”‚
β”‚      Arbit Smart Contract (Solidity)                 β”‚
β”‚      β€’ Holds funds in escrow                         β”‚
β”‚      β€’ Reads AI score via backend oracle             β”‚
β”‚      β€’ Releases payout autonomously                  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ§ͺ How to Run Locally

Prerequisites

  • Node.js v18+
  • npm or yarn
  • MetaMask (or any EVM wallet)
  • A Groq API Key β†’ console.groq.com
  • HashKey Chain Testnet configured in your wallet

1. Clone the Repository

git clone https://github.com/your-username/arbit.git
cd arbit

2. Configure Environment Variables

cp .env.example .env

Edit .env and fill in your values:

# Groq AI
GROQ_API_KEY=your_groq_api_key_here

# HashKey Chain
RPC_URL=https://testnet.hsk.xyz
CHAIN_ID=177

# Smart Contract
CONTRACT_ADDRESS=your_deployed_contract_address

# Backend
PORT=5000

3. Install Dependencies

# Backend
cd backend
npm install

# Frontend
cd ../frontend
npm install

4. Start the App

# Start Backend (from /backend)
npm run dev

# Start Frontend (from /frontend)
npm run dev

5. Connect Your Wallet

Configure MetaMask for HashKey Chain Testnet:

Field Value
Network Name HashKey Chain Testnet
RPC URL https://testnet.hsk.xyz
Chain ID 177
Currency Symbol HSK
Block Explorer https://testnet-explorer.hsk.xyz

πŸ“Έ Screenshots

🚧 Screenshots coming soon β€” UI is live and AI evaluation is functional!

Feature Preview
🏠 Dashboard (coming soon)
πŸ“ Submit Work (coming soon)
πŸ€– AI Score Result (coming soon)
πŸ’Έ Payout Triggered (coming soon)

πŸ›£οΈ Roadmap

βœ… Phase 1 β€” Foundation (Current)

  • React UI scaffolded
  • Groq AI evaluation endpoint live
  • AI scoring pipeline running (0–100 scores)
  • Wallet integration (HashKey Chain Testnet)
  • Smart contract integration (in progress)

πŸ”„ Phase 2 β€” Core Protocol

  • Full on-chain payout via smart contract
  • Milestone-based escrow logic
  • Live deployment on HashKey Chain Mainnet
  • Score audit trail on-chain

πŸš€ Phase 3 β€” Scale & Ecosystem

  • DAO integration for fund pooling
  • Multi-chain support
  • SDK for third-party dApps
  • Reputation system for contributors

🀝 Contributing

Contributions are welcome! If you'd like to improve Arbit:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-feature
  3. Commit your changes: git commit -m 'feat: add your feature'
  4. Push to the branch: git push origin feature/your-feature
  5. Open a Pull Request

Please follow conventional commits and keep PRs focused.


πŸ“œ License

This project is licensed under the MIT License. See LICENSE for full details.


Built with ❀️ for the BCH Hackathon

PayFi + AI Β· HashKey Chain Β· Groq Β· Autonomous Payouts

⭐ Star this repo if you believe AI should replace governance ⭐

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors