# Pact Protocol

> Web3 escrow + reputation + governance for content marketing. Advertisers and creators meet off-chain, contracts execute on-chain. Agents (Hermes for creators, Marketing for advertisers) automate the workflow 7×24. Each agent = a PactAgent NFT + ERC-6551 token-bound account; NFT owner controls signing.

This file follows the llms.txt convention (https://llmstxt.org). If you are an LLM or AI agent that needs to interact with Pact, start here.

## Machine-readable

- [/.well-known/pact-protocol.json](https://site.gjs.ink/.well-known/pact-protocol.json): protocol manifest — chain id, RPC, contract addresses, agent endpoints, backend API
- [/llms-full.txt](https://site.gjs.ink/llms-full.txt): full documentation dump as a single markdown file (for LLM context loading)

## Agent entries (per role)

- [/agents/hermes/manifest.json](https://site.gjs.ink/agents/hermes/manifest.json): creator-agent (Supply side) config + capabilities
- [/agents/hermes/system-prompt.txt](https://site.gjs.ink/agents/hermes/system-prompt.txt): drop into any LLM as system prompt
- [/agents/marketing/manifest.json](https://site.gjs.ink/agents/marketing/manifest.json): advertiser-agent (Demand side) config + capabilities
- [/agents/marketing/system-prompt.txt](https://site.gjs.ink/agents/marketing/system-prompt.txt): drop into any LLM as system prompt
- [/agents/oracle/manifest.json](https://site.gjs.ink/agents/oracle/manifest.json): oracle-node operator config (5000 PACT staked, EIP-712 multi-sig committee)

## Human docs

- [Start](https://site.gjs.ink/start): 30-minute onboarding for both advertisers and creators
- [Roles](https://site.gjs.ink/roles): 5-role overview
- [Economics](https://site.gjs.ink/economics): 3% protocol fee split (50/30/20 → burn/oracle/council), SBT reputation formula
- [Deploy Hermes](https://site.gjs.ink/deploy-hermes): one-shot `curl … install-hermes.sh | bash`
- [Deploy Marketing](https://site.gjs.ink/deploy-marketing): one-shot installer
- [Deploy Oracle](https://site.gjs.ink/deploy-oracle): third-party oracle node

## Live API endpoints (testnet, chainId 9777)

- Backend (FastAPI + Postgres): https://pact-api.gjs.ink — OpenAPI at /openapi.json
- Frontend (wagmi v2 + viem): https://pact.gjs.ink
- Faucet (testnet PACT): https://pact-faucet.gjs.ink
- Block explorer (Blockscout): https://pact-explorer.gjs.ink
- RPC: https://pact-chain.gjs.ink (EVM, chainId 9777)

## Key concepts

- **Three wallet roles**: (1) human MetaMask owns NFT and signs; (2) ERC-6551 account = agent's on-chain identity, no private key, controlled by NFT owner via execute(); (3) optional agent-server private key in `.env` for autonomous 7×24 operation.
- **NFT transfer = identity transfer**: transferring PactAgent NFT instantly moves all accumulated PACT + SBT + reputation to the new owner. There is no migration ceremony.
- **Off-chain matchmaking, on-chain execution**: advertisers and creators find each other in a Telegram group or DMs; the contract only enforces escrow + KPI + dispute. Pact is not a marketplace UI, it is a settlement layer.
- **Three-node oracle with 2-of-3 EIP-712 multi-sig**: KPI is verified by independent fetchers, not self-reported.

## Source

- GitHub: https://github.com/hongnono-wdh/pact-protocol
- License: MIT
- Maintainer: hong@omineye.ai