Skip to content

JhiNResH/maiat-protocol

Repository files navigation

Maiat

Maiat Protocol

The trust layer for agentic commerce.
Trust oracle for AI agents and tokens — powered by on-chain behavioral data, community reviews, and EAS attestations.

Live App · API Docs · ACP Agent #18281


Monorepo Structure

maiat-protocol/
├── apps/
│   └── web/                    # Next.js dashboard + API (app.maiat.io)
│       ├── src/
│       │   ├── app/            # Pages + API routes (/api/v1/*)
│       │   ├── components/     # React components
│       │   ├── hooks/          # React hooks
│       │   └── lib/            # Utilities (scoring, eas, uniswap, etc.)
│       ├── public/             # Static assets
│       ├── prisma/             # Database schema + migrations
│       ├── package.json        # Web app dependencies
│       └── tsconfig.json       # TypeScript config
├── contracts/                  # Solidity smart contracts (Foundry)
│   ├── src/                    # Contract source
│   ├── test/                   # Forge tests
│   └── foundry.toml            # Foundry config
├── packages/                   # SDKs and plugins
│   ├── sdk/                    # @jhinresh/maiat-sdk
│   ├── guard/                  # @jhinresh/viem-guard
│   ├── mcp-server/             # @jhinresh/mcp-server
│   ├── elizaos-plugin/         # ElizaOS integration
│   ├── agentkit-plugin/        # Coinbase AgentKit integration
│   ├── game-plugin/            # GAME SDK plugin
│   ├── virtuals-plugin/        # Virtuals GAME SDK plugin
│   ├── maiat-evaluator-node/   # @jhinresh/maiat-evaluator
│   ├── maiat-evaluator-py/     # Python evaluator
│   └── wadjet/                 # Rug prediction engine
├── docs/                       # Documentation
├── scripts/                    # Utility scripts (indexer, etc.)
├── tests/                      # Root-level integration tests
├── package.json                # Workspace config
├── tsconfig.json               # Root TypeScript config
└── LICENSE

Quick Start

git clone https://github.com/JhiNResH/maiat-protocol.git
cd maiat-protocol
npm install

# Run the web app
npm run dev

# Or run from the apps/web directory
cd apps/web
npm run dev

Smart Contracts (Base Mainnet)

Contract Address
MaiatOracle 0xc6cf2d59ff2e4ee64bbfceaad8dcb9aa3f13c6da
MaiatReceiptResolver 0xda696009655825124bcbfdd5755c0657d6d841c0
TrustGateHook 0xf980Ad83bCbF2115598f5F555B29752F00b8daFf

EAS Schema UID: 0x24b0db687434f15057bef6011b95f1324f2c38af06d0e636aea1c58bf346d802


API Endpoints

Route Method Description
/api/v1/agent/:address GET Agent trust score
/api/v1/agent/:address/deep GET Deep analysis
/api/v1/agents GET Browse all 2,292+ agents
/api/v1/token/:address GET Token honeypot check
/api/v1/swap/quote POST Trust-gated Uniswap quote
/api/v1/review POST Submit review (costs 2 Scarab)
/api/v1/wallet/:address/passport GET Trust Passport
/api/v1/scarab GET Scarab balance
/api/v1/markets GET Prediction markets

Packages

Package Description
@jhinresh/maiat-sdk Core SDK — trust scores, token safety, swap verification
@jhinresh/viem-guard Viem middleware — auto-checks trust before transactions
@jhinresh/mcp-server MCP Server for Claude, GPT, and MCP-compatible AIs
@jhinresh/elizaos-plugin ElizaOS plugin — trust-gate actions and evaluators
@jhinresh/agentkit-plugin Coinbase AgentKit plugin
@jhinresh/game-maiat-plugin GAME SDK plugin
@jhinresh/virtuals-plugin Virtuals GAME SDK plugin
@jhinresh/maiat-evaluator Drop-in ACP evaluator

Contributing

Pull requests are welcome. For major changes, open an issue first.

We use Conventional Commits and squash-merge all PRs.


License

MIT

About

The trust layer for agentic commerce. Trust oracle for AI agents and tokens — powered by on-chain behavioral data, community reviews, and EAS attestations.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors