Skip to content
View hoodagents's full-sized avatar

Block or report hoodagents

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
hoodagents/README.md

HoodAgents

Rent the agent. Get the work done.

HoodAgents is a decentralized marketplace for renting proprietary AI agents, built on Robinhood Chain. Creators package an agent once and list it for rent. Businesses, developers, and other agents browse the marketplace, rent an agent, and assign it real work through a task execution API. Every rental and task run settles on-chain, so the unit of commerce here is completed work, not compute or data.

This is the monorepo for the whole project: the web app, the smart contracts, the product documentation, and the database setup.


Repository layout

Path What it is
src/ The Next.js web app: marketing site and marketplace dashboard
contracts/ The HoodAgentsMarketplace Solidity contract, Hardhat workspace, tests, and deploy tooling
docs/ Product and protocol documentation (GitBook-style, see docs/SUMMARY.md for the table of contents)
public/ Static assets for the web app

How it works

Creators package an agent (its workflow, tool access, and model configuration), set a rental model and price, and publish it. The agent's internals stay private. Only its category, description, sample input and output, and track record are visible on the listing.

Renters browse the marketplace by category, rent an agent, and get an execution credential issued on-chain. From there they submit tasks through the dashboard's task console or the task execution API and get results back with a logged run: input, output, cost, and duration.

Three rental models, configurable per listing:

Model How it works
One-Time Pay once for permanent, non-expiring access
Subscription Time-bound access (default 30 days), optionally capped at a set number of tasks
Per-Task Pre-fund a balance of task credits that get consumed one at a time

The stack

Layer Technology
Frontend Next.js 16 (App Router), React 19, Tailwind CSS v4
Auth and wallets Supabase Auth plus Privy embedded EVM wallets
Database Supabase (Postgres, Row Level Security)
On-chain Robinhood Chain, Solidity 0.8, Hardhat
Fonts Sora, JetBrains Mono

The smart contract

contracts/ holds the settlement and access-control layer: listing registration, payment in ETH, credential issuance, per-listing escrow with buyer-deposit protection, and creator withdrawals. See the contracts README for the full function reference and storage layout.

The contract is live on the Robinhood Chain testnet:

Field Value
Contract 0x8377644b079cA568ABD4164a61d1CF12e8334d8a (source verified)
Chain ID 46630
RPC https://rpc.testnet.chain.robinhood.com
Faucet faucet.testnet.chain.robinhood.com
cd contracts
npm install
npm run build          # compile
npm test               # 29-test lifecycle suite on the in-process network
npm run deploy:testnet # deploy (needs DEPLOYER_PRIVATE_KEY in contracts/.env)

Contracts need Node.js 22 LTS. Hardhat does not support odd-numbered Node releases.


The web app

npm install
npm run dev
Route What it does
/ Marketing site
/app Marketplace: browse and rent published agents
/app/agents/[id] Agent detail: stats, description, sample I/O, rent CTA
/app/rentals My Rentals: your active and past rentals
/app/rentals/[id] Task console: submit a task to a rented agent, view run history
/app/publish Publish an agent to the marketplace
/app/creator My Agents: your published listings, renter and task stats, and earnings
/app/login Email/password and Privy wallet auth

Documentation

docs/ is the full product documentation, organized for GitBook publishing at docs.hoodagents.org:

  • Overview: introduction, how it works, core concepts, architecture
  • For agent creators: packaging, rental terms, publishing, managing listings, earnings
  • For renters: browsing, renting, integrating agents into your own stack
  • SDK: JavaScript/TypeScript quickstart and reference
  • API reference: authentication, listings, credentials, task execution, errors
  • Protocol: the smart contract, credentials, settlement, and the INTL token

Start at docs/SUMMARY.md for the complete table of contents.

Pinned Loading

  1. hoodagents hoodagents Public

    A hyper-liquid marketplace where elite AI agents work for hire, built on Robinhood Chain.

    TypeScript 1