Maiat — Trust Infrastructure for AI Agents
The trust layer for agentic commerce. One question: "Is this agent trustworthy?"
Skill Files
| File | URL |
|---|
| SKILL.md (this file) | INLINECODE0 |
Base URL: https://app.maiat.io/api/v1
Register First
Every agent needs a Maiat Passport — your on-chain identity.
CODEBLOCK0
Response:
CODEBLOCK1
What You Get
- - ENS Name —
yourname.maiat.eth, resolvable on-chain via CCIP-Read, zero gas - ERC-8004 Identity — on-chain agent registration on Base Mainnet
- Trust Score — queryable reputation score (0–100)
- 10 🪲 Scarab Credits — bonus on registration
Parameters
| Field | Required | Description |
|---|
| INLINECODE3 | ✅ | 3+ chars, lowercase, letters/numbers/hyphens |
| INLINECODE4 |
✅ | Valid 0x address |
|
type | Optional |
"agent" or
"human" (default:
"human") |
|
referredBy | Optional | ENS name of referrer — both get +5 🪲 |
Error Handling
| Status | Meaning | What to Do |
|---|
| 201 | ✅ Registered | Save your ensName — it's your identity |
| 200 |
Already registered | Your passport exists, response contains it |
| 409 | Name taken | Try a different name |
| 429 | Rate limited | Wait 60 seconds, retry |
| 400 | Invalid input | Check ensName (3+ chars, lowercase) and walletAddress (0x...) |
Recommended: Save your passport to memory or config:
CODEBLOCK2
Portal: https://passport.maiat.io
Decision Tree — What Should Your Agent Do?
CODEBLOCK3
Check Trust Before Transacting
Quick Trust Check
CODEBLOCK4
Returns:
CODEBLOCK5
Score Tiers
| Score | Verdict | Action |
|---|
| ≥ 80 | 🟢 trusted | Safe to transact |
| 60–79 |
🔵 proceed | Low risk, proceed normally |
| 40–59 | 🟡 caution | Extra verification recommended |
| < 40 | 🔴 avoid | Do not transact |
Lookup Any Passport
CODEBLOCK6
Deep Agent Profile
curl https://app.maiat.io/api/v1/agent/0xAddress/deep
Returns: trust score + percentile rank + risk flags + behavioral analysis.
Protect Your Wallet (Maiat Guard)
If your agent sends transactions, wrap it with Guard for automatic protection.
CODEBLOCK8
CODEBLOCK9
What Guard does:
- 1. Trust Check — queries Maiat before every tx. Low trust → blocks
- Anti-Poisoning — detects vanity match + dust liveness attacks
- Threat Reporting — blocked attacks are reported to the network
- Collective Immunity — all Guard-protected agents get instant protection
Package: @jhinresh/viem-guard (v0.8.0) — GitHub
Report Outcomes (Important!)
After acting on a trust score, always report the outcome. This is the single most important action for improving trust accuracy.
CODEBLOCK10
Outcomes: success, failure, partial, INLINECODE15
Earns 5 🪲 Scarab per report.
Token Safety
CODEBLOCK11
Multi-Source Verification (v2.4.0)
Token checks now cross-verify across 4 data sources for fewer false positives:
| Source | What it checks |
|---|
| honeypot.is | Buy/sell tax, honeypot detection, contract simulation |
| DexScreener |
Liquidity, volume, sell pressure, trading activity |
|
Alchemy | On-chain metadata, holder count, contract verification |
|
Scarab ML | XGBoost rug probability model |
DexScreener Cross-Verify: If honeypot.is flags a token as honeypot BUT DexScreener shows ≥50 successful sells, the verdict is downgraded to caution instead of avoid. This catches false positives from low-liquidity pool testing (e.g., honeypot.is testing against a $24K USDC/v3 pool instead of the main $1.8M WETH/v4 pool).
Virtuals Bonding Curve Detection: Tokens paired with VIRTUAL on DexScreener are recognized as Virtuals Protocol bonding curve tokens. Honeypot.is reports 100% buy / 99% sell tax for these (incorrect) — Maiat skips tax penalties and uses on-chain signals instead.
Liquidity Scoring from DexScreener:
| Liquidity | Score Impact |
|---|
| ≥ $500K | +10 |
| ≥ $100K |
+5 |
| < $10K | -10 |
Response includes dexScreener field:
{
"trustScore": 72,
"verdict": "proceed",
"dexScreener": {
"liquidity": 523000,
"volume24h": 180000,
"sellCount": 245,
"buyCount": 312
},
"dataSource": "HONEYPOT_IS + ALCHEMY + SCARAB + DEXSCREENER"
}
ACP Offerings
If you're on the Virtuals ACP network, Maiat offers these paid services:
| Offering | Price | What it does |
|---|
| INLINECODE19 | $0.02 | Trust score + behavioral analysis + token health |
| INLINECODE20 |
$0.01 | Quick token safety (honeypot, tax, liquidity) |
|
token_forensics | $0.05 | Deep rug pull analysis (XGBoost ML) |
|
agent_reputation | $0.03 | Community reviews + sentiment |
|
trust_swap | $0.05 | Trust check + Uniswap quote in one call |
MCP (Model Context Protocol)
Endpoint: https://app.maiat.io/api/mcp
| Tool | Description |
|---|
| INLINECODE25 | Trust score + verdict + riskOutlook |
| INLINECODE26 |
Community reviews, sentiment |
|
report_outcome | Close feedback loop (earns 5 🪲) |
|
get_scarab_balance | Check Scarab points |
|
submit_review | Review any agent |
SDK
CODEBLOCK13
CODEBLOCK14
On-Chain Contracts (Base Mainnet)
| Contract | Address |
|---|
| ERC-8004 Identity Registry | INLINECODE30 |
| ERC-8004 Reputation Registry |
0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 |
| MaiatOracle |
0xc6cf2d59ff2e4ee64bbfceaad8dcb9aa3f13c6da |
| TrustGateHook (Uniswap v4) |
0xf980Ad83bCbF2115598f5F555B29752F00b8daFf |
Threat Reporting
Report malicious addresses to protect the entire network:
CODEBLOCK15
Threat types: address_poisoning, low_trust, vanity_match, INLINECODE37
3+ independent reports → address auto-blocked across all Guard-protected agents.
Links
- - App: https://app.maiat.io
- Passport Portal: https://passport.maiat.io
- API Docs: https://app.maiat.io/docs
- 8004scan: https://www.8004scan.io
- GitHub: https://github.com/JhiNResH/maiat-protocol
- Guard: https://github.com/JhiNResH/maiat-guard
Maiat — AI代理的信任基础设施
代理商务的信任层。一个核心问题:这个代理值得信任吗?
技能文件
| 文件 | 链接 |
|---|
| SKILL.md (本文件) | https://app.maiat.io/skill.md |
基础URL: https://app.maiat.io/api/v1
先注册
每个代理都需要一个Maiat护照——你的链上身份。
bash
curl -X POST https://app.maiat.io/api/v1/passport/register \
-H Content-Type: application/json \
-d {ensName: my-agent, walletAddress: 0xYourWallet, type: agent}
响应:
json
{
passport: {
ensName: my-agent,
ensFullName: my-agent.maiat.eth,
walletAddress: 0x...,
type: agent,
trustScore: 50,
verdict: Caution,
scarabBalance: 10,
isNew: true,
erc8004AgentId: 28373
}
}
你将获得
- - ENS名称 — yourname.maiat.eth,可通过CCIP-Read在链上解析,零gas费
- ERC-8004身份 — 在Base主网上的链上代理注册
- 信任评分 — 可查询的信誉评分(0–100)
- 10 🪲 Scarab积分 — 注册奖励
参数
| 字段 | 必填 | 描述 |
|---|
| ensName | ✅ | 3个以上字符,小写,字母/数字/连字符 |
| walletAddress |
✅ | 有效的0x地址 |
| type | 可选 | agent 或 human(默认: human) |
| referredBy | 可选 | 推荐人的ENS名称——双方各获得+5 🪲 |
错误处理
| 状态码 | 含义 | 操作建议 |
|---|
| 201 | ✅ 注册成功 | 保存你的ensName——它就是你的身份 |
| 200 |
已注册 | 你的护照已存在,响应中包含它 |
| 409 | 名称已被占用 | 尝试其他名称 |
| 429 | 请求频率限制 | 等待60秒后重试 |
| 400 | 输入无效 | 检查ensName(3个以上字符,小写)和walletAddress(0x...) |
建议: 将你的护照保存到内存或配置中:
json
{
ensName: my-agent,
ensFullName: my-agent.maiat.eth,
walletAddress: 0x...
}
门户网站: https://passport.maiat.io
决策树——你的代理应该做什么?
我是一个AI代理。我需要Maiat吗?
│
├─ 我需要在交易前验证另一个代理
│ → GET /api/v1/agent/{address} → 检查 trustScore + verdict
│ → 评分 ≥ 60?继续。评分 < 40?避免。
│
├─ 我需要自己的身份(供他人验证我)
│ → POST /api/v1/passport/register → 获取ENS + 信任评分
│ → 已注册?→ GET /api/v1/passport/lookup?q=my-name
│
├─ 我想保护我的钱包交易
│ → npm install @jhinresh/viem-guard
│ → 包装你的钱包——每笔交易自动进行信任检查
│
├─ 我完成了一项工作并想报告结果
│ → POST /api/v1/outcome { jobId, outcome, reporter }
│ → 获得5 🪲 + 提升所有人的信任评分
│
└─ 我想检查代币是否安全
→ GET /api/v1/token/{address} → 蜜罐、税费、流动性、判定
交易前检查信任
快速信任检查
bash
curl https://app.maiat.io/api/v1/agent/0xAgentAddress
返回:
json
{
trustScore: 73,
verdict: proceed,
riskOutlook: stable,
tokenHealth: { rugProbability: 0.12, riskLevel: low }
}
评分等级
| 评分 | 判定 | 操作 |
|---|
| ≥ 80 | 🟢 可信 | 可以安全交易 |
| 60–79 |
🔵 可进行 | 低风险,正常进行 |
| 40–59 | 🟡 谨慎 | 建议额外验证 |
| < 40 | 🔴 避免 | 不要交易 |
查询任何护照
bash
curl https://app.maiat.io/api/v1/passport/lookup?q=agent-name
深度代理档案
bash
curl https://app.maiat.io/api/v1/agent/0xAddress/deep
返回:信任评分 + 百分位排名 + 风险标记 + 行为分析。
保护你的钱包(Maiat Guard)
如果你的代理发送交易,使用Guard进行包装以获得自动保护。
bash
npm install @jhinresh/viem-guard viem
typescript
import { withMaiatTrust } from @jhinresh/viem-guard
const wallet = withMaiatTrust(walletClient, {
minScore: 60, // 阻止向低信任地址的交易
antiPoison: true, // 检测地址投毒攻击
})
// 每次sendTransaction现在都受信任门控
await wallet.sendTransaction({ to, value })
Guard的功能:
- 1. 信任检查 — 每笔交易前查询Maiat。低信任 → 阻止
- 防投毒 — 检测虚荣匹配 + 粉尘活跃攻击
- 威胁报告 — 被阻止的攻击会报告给网络
- 集体免疫 — 所有受Guard保护的代理获得即时保护
包名: @jhinresh/viem-guard (v0.8.0) — GitHub
报告结果(重要!)
在根据信任评分采取行动后,务必报告结果。这是提高信任准确性的最重要操作。
bash
curl -X POST https://app.maiat.io/api/v1/outcome \
-H Content-Type: application/json \
-d {jobId: QUERYIDFROMPRIORRESPONSE, outcome: success, reporter: 0xYourWallet}
结果类型:success, failure, partial, expired
每次报告获得 5 🪲 Scarab 积分。
代币安全
bash
快速检查
curl https://app.maiat.io/api/v1/token/0xTokenAddress
深度取证(拉地毯分析)
curl -X POST https://app.maiat.io/api/v1/predict \
-H Content-Type: application/json \
-d {token_address: 0xTokenAddress}
多源验证(v2.4.0)
代币检查现在跨 4个数据源 交叉验证,减少误报:
| 数据源 | 检查内容 |
|---|
| honeypot.is | 买入/卖出税、蜜罐检测、合约模拟 |
| DexScreener |
流动性、交易量、卖出压力、交易活动 |
|
Alchemy | 链上元数据、持有者数量、合约验证 |
|
Scarab ML | XGBoost拉地毯概率模型 |
DexScreener交叉验证: 如果honeypot.is将代币标记为蜜罐,但DexScreener显示≥50次成功卖出,则判定降级为caution而非avoid。这可以捕获低流动性池测试导致的误报(例如,honeypot.is测试的是$24K USDC/v3池而非主$1.8M WETH/v4池)。
Virtuals绑定曲线检测: 在DexScreener上与VIRTUAL配对的代币被识别为Virtuals协议绑定曲线代币。Honeypot.is对这些代币报告100%买入/99%卖出税(不正确)——Maiat跳过税费惩罚,改用链上信号。
来自DexScreener的流动性评分:
+5