Hermis Protocol

Web3 Crowdsourcing Coordination Layer

Hermis Protocol decentralizes the crowdsourcing marketplace so task publishers, collaborators, and reviewers can coordinate without intermediaries. Smart contracts manage task lifecycles, escrow funds, and enforce programmable policies, while on-chain reputation and arbitration modules keep the ecosystem fair and transparent.

🎯 Overview

Key Features

• 🤝 Decentralized Collaboration: Direct interaction between publishers and contributors secured by smart contracts.
• 🏆 Reputation-Driven Matching: Dynamic scoring system influences eligibility, rewards, and review priority.
• 🛡️ Policy Guards: Composable guard modules enforce access, submission, and review rules per task.
• ⚖️ Transparent Arbitration: Programmable dispute workflows finalize payouts and penalties on-chain.
• 💰 Token Incentives: Treasury-backed payouts and configurable reward strategies align stakeholder interests.
• 🪪 Soulbound Identity: Hermis SBT anchors participant identity, making reputation and penalties non-transferable.

🏗️ Architecture & Monorepo Structure

This project is structured as a Turborepo monorepo using pnpm workspaces. It consists of three main components:

• apps/web: The Next.js 15 frontend web application. Powers the user interface, wallet integration, and dashboards.
• apps/contracts: The Foundry-based smart contract suite. Contains the core logic, guards, strategies, and deployment scripts.
• apps/subgraph: The Graph Protocol indexing service. Indexes blockchain events and provides a GraphQL API for the frontend and analytics.

🚀 Quick Start

Prerequisites

• Node.js (v18+)
• pnpm (v9+)
• Foundry (for smart contract development)

Quick start

1. Install dependencies

pnpm install

2. Run the web app

pnpm dev

3. Build the monorepo

pnpm build

4. Run tests

pnpm test

Common Commands

This monorepo uses Turborepo to orchestrate tasks across all projects:

# Start the web development server
pnpm turbo dev --filter=@hermis/web

# Build all projects
pnpm turbo build

# Run smart contract tests
pnpm turbo test --filter=@hermis/contracts

# Run all linters
pnpm turbo lint

# Format code
pnpm turbo format

Disclaimer

This repository is provided for research, prototyping, and educational purposes.

• The contracts and application have not been presented here as production-audited software.
• Do not assume the system is safe for mainnet value, treasury assets, or public launch in its current form.
• Blockchain interactions are irreversible and may fail because of RPC issues, oracle latency, indexing delay, contract bugs, or configuration mistakes.
• Nothing in this repository is financial advice, investment advice, legal advice, or security assurance.
• If you deploy or use this code, you do so at your own risk.

🤝 Contributing

We welcome community contributions! Please review the individual READMEs in each apps/ directory for module-specific development workflows.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Verify changes pass tests and linting (pnpm turbo build lint test)
5. Push to the branch (git push origin feature/AmazingFeature)
6. Open a Pull Request

📄 License

Hermis Protocol is experimental software. Contracts are licensed under MIT. See individual sub-project licenses for more details.