my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	# 🤖 Solana Clawd Agents — Hub, Catalog, and Deploy API
#2
#3	> 134 production-ready AI agents for the Solana ecosystem — DeFi, payments, trading, governance, security, tools, analytics, research, infrastructure, NFT, and programming. The generated x402 catalog currently exposes 43 one-shot deploys, 23 featured agents, 5 templates, the REST catalog, the registry API, and the skills hub.
#4
#5	A discoverable, self-hosting hub for Solana-native AI agents. Every agent in the [`src/`](./src/) directory is automatically indexed into a catalog ([`agents-catalog.json`](./agents-catalog.json)), served via REST and MCP, and surfaced at [x402.wtf/agents](https://x402.wtf/agents) with install / chat / mint buttons. Works with any MCP-compatible client — Clawd Desktop, Cursor, ClawdOS, Windsurf.
#6
#7	## 🦞 Verification Layer
#8
#9	The agent hub now sits directly on top of the new [`../attestation/README.md`](../attestation/README.md) verification surface.
#10
#11	That layer is what turns OpenClawd from a plain JSON catalog into a trust-bearing system:
#12
#13	- skills can carry formal proof hashes
#14	- agents can be born with attested identity records
#15	- plugins can be published with audit-backed attestation metadata
#16	- MCP servers can eventually advertise verified tool-surface receipts
#17
#18	Key local verification surfaces:
#19
#20	- [`../attestation/README.md`](../attestation/README.md)
#21	- [`./skills/solana-attestation-skill/`](./skills/solana-attestation-skill/)
#22	- [`./agent-template-attested.json`](./agent-template-attested.json)
#23	- [`../plugin.delivery/plugin-template-attested.json`](../plugin.delivery/plugin-template-attested.json)
#24	- [`./templates/solana-attestation-agent.template.json`](./templates/solana-attestation-agent.template.json)
#25
#26	```text
#27	skill → proof → attestation → registry → deploy rail
#28	```
#29
#30	## 🔗 openclawd Ecosystem
#31
#32	\| Surface \| URL \| Status \|
#33	\| -------------------- \| ----------------------------------------------------------------------------- \| ------------------ \|
#34	\| Agents hub \| [x402.wtf/agents](https://x402.wtf/agents) \| live \|
#35	\| Mint page \| [x402.wtf/agents/mint](https://x402.wtf/agents/mint) \| live (MPL Core) \|
#36	\| Agent staking \| [x402.wtf/agents/stake](https://x402.wtf/agents/stake) \| live (MPL Core FreezeDelegate) \|
#37	\| Registry \| [x402.wtf/agents/registry](https://x402.wtf/agents/registry) \| live \|
#38	\| Terminal \| [x402.wtf/terminal](https://x402.wtf/terminal) \| drops today \|
#39	\| Studio (Vibe) \| [vibe.x402.wtf](https://vibe.x402.wtf) \| live for holders \|
#40	\| DEX \| [dex.x402.wtf](https://dex.x402.wtf) \| live \|
#41	\| Telegram \| [t.me/clawdtoken](https://t.me/clawdtoken) \| live \|
#42	\| Solana OS Hub \| [openclawd.net](https://openclawd.net) \| live \|
#43	\| Mobile (Seeker) \| [seeker.openclawd.net](https://seeker.openclawd.net) \| live \|
#44
#45	---
#46
#47	## Agent Staking Is Part Of The Agent Hub
#48
#49	The agent hub does not stop at minting and catalog discovery. `/staking` is the
#50	commitment layer for the same Metaplex Core assets minted through
#51	`/agents/mint` and indexed through `/agents/registry`.
#52
#53	The platform now treats staking as a first-class agent lifecycle state:
#54
#55	1. Mint an agent as a Metaplex Core asset with Agent Registry identity.
#56	2. Register its A2A, MCP, web, payment, and service endpoints.
#57	3. Stake the agent at `/staking` to freeze transfers without moving custody.
#58	4. Index stake state for the hub, dashboards, paid APIs, and future rewards.
#59	5. Route phase-2 gacha fees and CLAWD emissions through the reward protocol.
#60
#61	Current layers:
#62
#63	\| Layer \| Status \| Files \|
#64	\|---\|---\|---\|
#65	\| Live Core lock/unlock \| devnet live \| `client/src/pages/AgentStake.tsx`, `client/src/lib/agentStaking.ts` \|
#66	\| Reward/position protocol \| repo-ready, pre-mainnet \| `programs/clawd-stake/`, `server/_core/clawdStakeRoutes.ts`, `convex/clawdStake.ts` \|
#67	\| Gacha fee share \| planned \| `programs/clawd-gacha/` will deposit SOL into `clawd-stake` \|
#68
#69	---
#70
#71	## OpenClawd Agent Staking Docs
#72
#73	Use these local references when working on Metaplex Agent staking, pay-gated agent APIs, and terminal operator flows:
#74
#75	- Main app README: `/Users/8bit/Downloads/clawd-terminal/README.md`
#76	- Agents catalog README: `/Users/8bit/Downloads/clawd-terminal/agents/README.md`
#77	- Pay Agents guide: `/Users/8bit/Downloads/clawd-terminal/docs/pay-agents.md`
#78	- Clawd Stake program: `/Users/8bit/Downloads/clawd-terminal/programs/clawd-stake/README.md`
#79	- Clawd TUI README: `/Users/8bit/Downloads/clawd-terminal/clawd-tui/clawd-tui/README.md`
#80	- Dark Ralph TUI README: `/Users/8bit/fraud/OpenClawd/dark-ralph/README.md`
#81
#82	---
#83
#84	## 🆕 What's New (May 2026)
#85
#86	### Full Clawd-ification pass — every agent now Solana-native
#87
#88	The whole [`src/`](./src/) library was rewritten to match the CLAWD Router + CLAWD holder deploy flow used by [x402.wtf/agents](https://x402.wtf/agents). Two transform scripts drove the pass:
#89
#90	- [`scripts/clawdify-agents.cjs`](./scripts/clawdify-agents.cjs) — upgrades a legacy agent to the Solana-native one-shot schema. Strips the bulky "CLAWD IDENTITY / OUTPUT CONTRACT" boilerplate from `config.systemRole` and replaces it with a compact Solana-native preamble (lamports/CU, Jito tips, deny-first signing, Clawd Router context, MPL Core mint endpoint). Sets `$schema`, `oneShot`, `featured`, `endpoints`, `homepage`, `summary`, `tokenUsage`, `createdAt`. Normalises `meta.category` to the category enum the hub renders. Wires `solana.{rpcRequirements, capabilities, metaplexSkills, programDeps, walletRequirements}` per agent profile.
#91	- [`scripts/patch-agents.cjs`](./scripts/patch-agents.cjs) — cosmetic pass for summary punctuation + restore `featured: true` on flagship Solana agents.
#92
#93	Result (May 2026 generated snapshot — regenerate any time with `node build-catalog.cjs`):
#94
#95	\| Stat \| Value \|
#96	\| ----------------------------- \| -------------------- \|
#97	\| Total agents \| 134 \|
#98	\| One-shots (on the hub rail) \| 43 \|
#99	\| Featured (top-of-page) \| 23 \|
#100	\| Metaplex-enabled \| 51 in the generated catalog rollup \|
#101	\| Trading-capable (swap-execution) \| 12 in the generated catalog rollup \|
#102	\| Launch-capable (Genesis / bonding curve / agent token) \| 1 in the generated catalog rollup \|
#103	\| Mint-capable (Core / Bubblegum / Candy Machine) \| 2 in the generated catalog rollup \|
#104	\| Categories \| 11 (see below) \|
#105	\| Templates \| 5 \|
#106
#107	- CLAWD Router integration: every agent exposes `endpoints.a2a` (`POST /api/agents/a2a`), `endpoints.mint-as-agent` (`POST /api/agents/mint`), and `endpoints.catalog`. CLAWD holders get priority routing acknowledged in-prompt. See [`scripts/clawdify-agents.cjs`](./scripts/clawdify-agents.cjs) for per-agent profiles.
#108	- Solana-native systemRole preamble: lamports/CU priority fees, Jito tip guidance, deny-first on signatures, "not financial advice" disclaimers baked in.
#109	- Per-agent `solana.programDeps`: Jupiter, Kamino, Marinade, Drift, MarginFi, Meteora, Orca, Raydium, Realms, Wormhole, MPL Core / Token Metadata / Bubblegum / Candy Machine / Agent Registry, Jito Tip Router, SPL Stake, Sanctum.
#110	- Valid `$schema`: [`https://x402.wtf/schemas/clawdAgentSchema.v1.json`](./schema/clawdAgentSchema.v1.json) applied across all schema-backed agents.
#111
#112	### New this release
#113
#114	- Catalog + deploy flow — [`agents-catalog.json`](./agents-catalog.json) aggregates all 134 agents with per-agent Install / Chat / Mint URLs where declared. Served via `GET /api/agents/catalog` and rendered at [/agents](https://x402.wtf/agents) with one-shot badges, featured rail, and category chips.
#115	- 23 featured agents across the catalog and 43 one-shots on the deploy rail.
#116	- Template registry live — the generated catalog now emits 5 templates from [`templates/`](./templates/), plus a dedicated template index at [`templates/index.json`](./templates/index.json).
#117	- Skills hub live — [`skills/index.json`](./skills/index.json) now exposes the OpenClawd skill registry with formal-verification metadata and a published skill schema.
#118	- Attestation layer live — [`../attestation/README.md`](../attestation/README.md) now vendors the Solana Attestation Service and maps it onto skills, agents, plugins, and MCP server verification flows.
#119	- Metaplex skill baked in — every agent in the catalog carries capability metadata for Agent Registry, Genesis, Core, Token Metadata, Bubblegum, and Candy Machine. The hub surfaces per-agent badges so users can filter by "can launch tokens" or "can mint NFTs".
#120	- Solana-native schema v1 — [`schema/clawdAgentSchema.v1.json`](./schema/clawdAgentSchema.v1.json) extends Sperax v1 with `solana.capabilities`, `solana.metaplexSkills`, `solana.programDeps`, `onchain`, `payment`, `agentToken`, `a2a`, `endpoints`, and `deploy` blocks.
#121	- Author/homepage rebrand — every agent now points at `https://x402.wtf/agents/{id}` with `clawd` + `solana` tags.
#122
#123	---
#124
#125	## ✨ Key Features
#126
#127	- ✅ 134 Production-Ready Agents — across DeFi, payments, trading, governance, security, tools, analytics, research, infrastructure, NFT, and programming
#128	- ✅ CLAWD Router Native — every agent declares its `endpoints.a2a` + `mint-as-agent` + catalog routes for [x402.wtf/agents](https://x402.wtf/agents) and [ClawdRouter-main](../ClawdRouter-main/)
#129	- ✅ Metaplex Skill Native — Agent Registry, Genesis, Core, Token Metadata, Bubblegum, Candy Machine capabilities baked into the schema
#130	- ✅ 18 Languages — Automated i18n translation workflow ([Learn More →](./docs/I18N_WORKFLOW.md))
#131	- ✅ RESTful JSON API + MCP — `/api/agents/catalog` + Streamable HTTP MCP endpoint ([API Docs →](./docs/API.md))
#132	- ✅ Four deploy paths — PR, self-host A2A, on-chain MPL Core mint, MCP-server-only ([Deployment →](./docs/DEPLOYMENT.md))
#133	- ✅ Universal JSON schema — works with any AI platform that supports agent indexes
#134	- ✅ No Vendor Lock-in — switch platforms without losing work
#135	- ✅ Open Source — MIT licensed, fully transparent
#136	- ✅ CDN Hosted — GitHub Pages + Vercel for fast global access
#137
#138	---
#139
#140	## 🚀 Quick Start
#141
#142	### Install the hub in any MCP client
#143
#144	```json
#145	{
#146	"mcpServers": {
#147	"openclawd-agents": {
#148	"type": "http",
#149	"url": "https://modelcontextprotocol.name/mcp/defi-agents"
#150	}
#151	}
#152	}
#153	```
#154
#155	### Browse the catalog
#156
#157	```bash
#158	# API root
#159	curl https://x402.wtf/api/agents \| jq .
#160
#161	# Full catalog (134 agents, 43 one-shots, 23 featured, 5 templates)
#162	curl https://x402.wtf/api/agents/catalog \| jq '.stats'
#163
#164	# Single agent as pure JSON
#165	curl https://x402.wtf/api/agents/catalog/solana-pumpfun-bot.json
#166
#167	# Template index
#168	curl https://x402.wtf/api/agents/templates/index.json \| jq '.stats'
#169
#170	# Skills hub index
#171	curl https://x402.wtf/api/skills/index.json \| jq '.stats'
#172
#173	# Registry
#174	curl https://x402.wtf/api/agents/registry \| jq .
#175	```
#176
#177	### For developers
#178
#179	```bash
#180	git clone https://github.com/clawdsolana/OpenClawd.git
#181	cd openclawd/agents
#182	bun install
#183	bun run format
#184	bun run build # schema validate + i18n
#185	node build-catalog.cjs # regenerate agents-catalog.json
#186	node scripts/clawdify-agents.cjs # upgrade any legacy agent to Solana-native
#187	node scripts/patch-agents.cjs # cosmetic pass (summary + featured)
#188	```
#189
#190	[Complete Development Workflow Guide →](./docs/WORKFLOW.md)
#191
#192	---
#193
#194	## 🗂️ Agent Catalog
#195
#196	The live catalog is the canonical machine-readable surface for the site:
#197
#198	- [`agents-catalog.json`](./agents-catalog.json) — full generated agent catalog
#199	- [`templates/index.json`](./templates/index.json) — reusable agent template index
#200	- [`skills/index.json`](./skills/index.json) — OpenClawd skills hub with verification metadata
#201	- [`agents-manifest.json`](./agents-manifest.json) — discovery manifest for crawlers and clients
#202	- [`../attestation/README.md`](../attestation/README.md) — SAS-backed verification layer for skills, agents, plugins, and MCP servers
#203
#204	Public endpoints:
#205
#206	- `GET /api/agents/catalog`
#207	- `GET /api/agents/templates/index.json`
#208	- `GET /api/skills/index.json`
#209	- `GET /api/agents/registry`
#210
#211	## 🏷️ Categories (11)
#212
#213	Every agent is filed into one of the valid categories the hub renders as filter chips. See `stats.byCategory` in the catalog for the live count.
#214
#215	\| Category \| Icon \| Focus \| Count \|
#216	\| -------------- \| ---- \| ----------------------------------------------- \| ----- \|
#217	\| defi \| 💰 \| Yield, lending, LP, staking, perps, swaps \| 66 \|
#218	\| payments \| 💸 \| x402, USDC rails, settlement, paid APIs \| 25 \|
#219	\| trading \| 📈 \| Routing, alpha, airdrops, memecoins \| 8 \|
#220	\| security \| 🛡️ \| Risk scoring, audits, wallet safety \| 8 \|
#221	\| education \| 📚 \| Onboarding and explainers \| 6 \|
#222	\| analytics \| 📊 \| Dashboards, trackers, portfolio analytics \| 11 \|
#223	\| research \| 🔎 \| Web and market research \| 1 \|
#224	\| governance \| 🗳️ \| Realms, proposals, delegation \| 2 \|
#225	\| infrastructure \| 🏗️ \| Attestation, runtime, platform services \| 1 \|
#226	\| dev-tools \| 🛠️ \| Developer and operator tooling \| 4 \|
#227	\| nft \| 🎨 \| NFT tooling and launch surfaces \| 2 \|
#228
#229	---
#230
#231	## ⭐ Featured Rail
#232
#233	These surface at the top of [x402.wtf/agents](https://x402.wtf/agents). They are generated directly from `agents-catalog.json`.
#234
#235	\| Agent \| Avatar \| Category \| Purpose \|
#236	\| ----- \| ------ \| -------- \| ------- \|
#237	\| [Solana PumpFun Bot](./src/solana-pumpfun-bot.json) \| 🚀 \| defi \| Pump.fun launch and trading automation surface imported from ClawdBrowser. \|
#238	\| [Solana Vulcan Clawd Autonomous Perps](./src/solana-vulcan-clawd-autonomous-perps.json) \| 🦞 \| trading \| Phoenix/Vulcan perps automation surface for autonomous trading workflows. \|
#239
#240	---
#241
#242	## 🎯 Full One-Shot Rail
#243
#244	Any agent with `oneShot: true` surfaces on the `/agents` deploy rail. The current generated catalog exposes 43 one-shots.
#245
#246	---
#247
#248	## 🧩 Templates
#249
#250	The generated snapshot emits 5 templates:
#251
#252	- `defi-analyst`
#253	- `firecrawl-researcher`
#254	- `screener`
#255	- `solana-attestation-agent`
#256	- `trading-agent`
#257
#258	---
#259
#260	## 🎨 Metaplex Skill Coverage
#261
#262	Schema-backed agents may declare Metaplex capabilities via `solana.metaplexSkills`. The hub renders these as badges; the runtime uses them to scope delegated asset-signer permissions on minted agents. The current generated catalog rollup reports 51 Metaplex-enabled agents.
#263
#264	\| Program \| Skill ID \| What it unlocks \|
#265	\| ------- \| -------- \| --------------- \|
#266	\| Agent Registry \| `agent-registry` \| On-chain agent identity, delegation, execution via MPL Core asset-signer PDAs \|
#267	\| Genesis \| `genesis` \| Token launches — launchpool (48h deposit) or bonding curve auto-graduating to Raydium CPMM \|
#268	\| Core \| `core` \| Next-gen NFTs with plugins, royalty enforcement, asset-signer execute hooks \|
#269	\| Token Metadata \| `token-metadata` \| Classic fungibles, NFTs, pNFTs, editions \|
#270	\| Bubblegum \| `bubblegum` \| Compressed NFTs via Merkle trees — 10k+ mint scale, needs DAS-enabled RPC \|
#271	\| Candy Machine \| `candy-machine` \| Core Candy Machine drops with allowlists, start/end, mint limits, payment guards \|
#272
#273	Install the official Metaplex Skill alongside the Clawd hub in any compatible agent:
#274
#275	```bash
#276	npx skills add metaplex-foundation/skill
#277	```
#278
#279	Or add the hosted MCP endpoint:
#280
#281	```json
#282	{
#283	"mcpServers": {
#284	"metaplex": {
#285	"type": "http",
#286	"url": "https://modelcontextprotocol.name/mcp/metaplex"
#287	}
#288	}
#289	}
#290	```
#291
#292	CLAWD Mayhem Mode already has the full skill stack pre-configured — install it once and you have trading + deployment + launch + mint in a single agent.
#293
#294	---
#295
#296	## 🌍 Multi-Language Support
#297
#298	All generated agent indexes are cataloged for 18-language distribution:
#299
#300	🇺🇸 English・🇨🇳 简体中文・🇹🇼 繁體中文・🇯🇵 日本語・🇰🇷 한국어・🇩🇪 Deutsch・🇫🇷 Français・🇪🇸 Español・🇷🇺 Русский・🇸🇦 العربية・🇵🇹 Português・🇮🇹 Italiano・🇳🇱 Nederlands・🇵🇱 Polski・🇻🇳 Tiếng Việt・🇹🇷 Türkçe・🇸🇪 Svenska・🇮🇩 Bahasa Indonesia
#301
#302	---
#303
#304	## 🛠️ API Reference
#305
#306	### Catalog + single agent / registry endpoints
#307
#308	```bash
#309	# API root
#310	GET https://x402.wtf/api/agents
#311
#312	# Full catalog
#313	GET https://x402.wtf/api/agents/catalog
#314
#315	# Single agent as raw JSON
#316	GET https://x402.wtf/api/agents/catalog/{identifier}.json
#317
#318	# Generated registry
#319	GET https://x402.wtf/api/agents/registry
#320
#321	# Template route reserved; current generated snapshot emits 0 templates
#322	# GET https://x402.wtf/api/agents/templates/{templateId}.json
#323
#324	# Hosted agent registry (includes externally-registered A2A agents)
#325	GET https://x402.wtf/api/agents/hosted
#326
#327	# Agent-to-agent JSON-RPC
#328	POST https://x402.wtf/api/agents/a2a
#329
#330	# Mint agent on-chain as MPL Core asset
#331	POST https://x402.wtf/api/agents/mint
#332	```
#333
#334	### Static CDN endpoints (localized, cached)
#335
#336	```bash
#337	GET https://clawd.click/index.json
#338	GET https://clawd.click/{agent-id}.json
#339	GET https://clawd.click/{agent-id}.{locale}.json
#340	GET https://clawd.click/index.{locale}.json
#341	GET https://clawd.click/agents-manifest.json
#342	```
#343
#344	### Quick Integration
#345
#346	```javascript
#347	// Load the catalog and filter to one-shots
#348	const catalog = await fetch('https://x402.wtf/api/agents/catalog').then((r) => r.json());
#349
#350	console.log(`${catalog.stats.totalAgents} agents, ${catalog.stats.totalOneShots} one-shots`);
#351	console.log(`${catalog.stats.metaplexEnabledAgents} agents with Metaplex capabilities`);
#352
#353	// Filter by Metaplex capability
#354	const launchCapable = catalog.agents.filter((a) =>
#355	a.capabilities.includes('metaplex-launch-token-genesis') \|\|
#356	a.capabilities.includes('metaplex-launch-bonding-curve'),
#357	);
#358
#359	// Deploy into CLAWD Router
#360	const router = await fetch('/api/agents/a2a', {
#361	method: 'POST',
#362	headers: { 'Content-Type': 'application/json' },
#363	body: JSON.stringify({
#364	jsonrpc: '2.0',
#365	id: 1,
#366	method: 'invoke',
#367	params: { identifier: 'solana-jupiter-router', input: 'Swap 10 SOL for USDC' },
#368	}),
#369	}).then((r) => r.json());
#370	```
#371
#372	[Full API Documentation →](./docs/API.md)
#373
#374	---
#375
#376	## 🤖 Contributing an Agent
#377
#378	Four paths to getting live on [x402.wtf/agents](https://x402.wtf/agents):
#379
#380	\| Path \| Best for \| Result \|
#381	\| --------------------------- \| ----------------------------------------- \| -------------------------------------------------- \|
#382	\| 1. PR into the repo \| Simple, static agent prompts \| Auto-hosted on CDN + hub + 18 locales \|
#383	\| 2. Self-host + A2A \| Custom logic, private tools, streaming \| Your infra, discoverable via hub \|
#384	\| 3. Mint as MPL Core \| On-chain identity, transferable ownership \| Registered on Solana, listed at `/agents/registry` \|
#385	\| 4. MCP server only \| Tool provider for Clawd Desktop / Cursor \| Endpoint listed in MCP catalog \|
#386
#387	### Path 1 — Quick Submit via PR
#388
#389	1. Fork this repo
#390	2. Create your agent in [`src/your-agent-name.json`](./src/) using the [clawdAgentSchema.v1](./schema/clawdAgentSchema.v1.json) schema
#391	3. Run the transforms — `node scripts/clawdify-agents.cjs` to upgrade any legacy fields, then `node build-catalog.cjs` to regenerate the catalog
#392	4. Submit a PR
#393
#394	Minimal agent JSON:
#395
#396	```json
#397	{
#398	"$schema": "https://x402.wtf/schemas/clawdAgentSchema.v1.json",
#399	"author": "your-github-or-solana-handle",
#400	"identifier": "your-agent-name",
#401	"schemaVersion": 1,
#402	"createdAt": "2026-04-16",
#403	"homepage": "https://x402.wtf/agents/your-agent-name",
#404	"oneShot": true,
#405	"featured": false,
#406	"config": {
#407	"systemRole": "You are a specialist inside Solana Clawd — a Solana-native AI agent stack...",
#408	"openingMessage": "...",
#409	"openingQuestions": ["...", "..."]
#410	},
#411	"meta": {
#412	"title": "Your Agent Title",
#413	"description": "Clear, concise description (max 300 chars)",
#414	"avatar": "🤖",
#415	"tags": ["solana", "clawd", "..."],
#416	"category": "defi"
#417	},
#418	"solana": {
#419	"rpcRequirements": ["das-api"],
#420	"capabilities": ["read-only", "a2a-message"],
#421	"metaplexSkills": ["agent-registry"],
#422	"programDeps": [],
#423	"walletRequirements": { "needsSigner": false }
#424	},
#425	"endpoints": {
#426	"a2a": "POST /api/agents/a2a",
#427	"mint-as-agent": "POST /api/agents/mint",
#428	"catalog": "GET /api/agents/catalog/your-agent-name.json"
#429	}
#430	}
#431	```
#432
#433	### Quality Guidelines
#434
#435	- ✅ Specific to a Solana protocol / domain
#436	- ✅ Solana-native vocabulary (lamports, CU, priority fees, Jito tips, PDAs)
#437	- ✅ Output format is consistent and scannable
#438	- ✅ Explicit risk framing (never promise yields, always disclose audit status)
#439	- ✅ Tested with 10+ representative prompts
#440	- ✅ `metaplexSkills` correctly declared
#441	- ✅ `endpoints.a2a`, `mint-as-agent`, `catalog` wired for CLAWD Router
#442
#443	[Full Contributing Guide →](./docs/CONTRIBUTING.md)
#444
#445	---
#446
#447	## 📖 Documentation
#448
#449	### For Users
#450
#451	- [Agent Teams Guide](./docs/TEAMS.md) — Multi-agent collaboration patterns
#452	- [FAQ](./docs/FAQ.md) — Common questions, answered
#453	- [Examples](./docs/EXAMPLES.md) — Real-world worked agents
#454	- [Keywords](./docs/KEYWORDS.md) — Discoverability terminology
#455
#456	### For Developers
#457
#458	- [Complete Workflow Guide](./docs/WORKFLOW.md) — End-to-end development process
#459	- [Contributing Guide](./docs/CONTRIBUTING.md) — How to submit agents
#460	- [API Reference](./docs/API.md) — Catalog + A2A + MCP surface
#461	- [Agent Creation Guide](./docs/AGENT_GUIDE.md) — Schema + metadata + publishing
#462	- [Deployment Guide](./docs/DEPLOYMENT.md) — Four paths: PR, self-host A2A, MPL Core mint, MCP-only
#463	- [18 Languages i18n Workflow](./docs/I18N_WORKFLOW.md) — Automated translation
#464	- [Prompt Engineering](./docs/PROMPTS.md) — Writing Solana-native prompts
#465	- [Model Parameters](./docs/MODELS.md) — Temperature, reasoning effort, tuning by archetype
#466	- [OpenRouter Setup](./docs/openrouter.md) — Model provider integration
#467	- [SEO Strategy](./docs/SEO_STRATEGY.md) — How agents get discovered
#468	- [Troubleshooting](./docs/TROUBLESHOOTING.md) — Common issues
#469
#470	---
#471
#472	## 🔧 Build Tooling
#473
#474	### Regenerate the catalog
#475
#476	```bash
#477	node build-catalog.cjs
#478	```
#479
#480	Reads `src/.json` + `templates/.template.json` → emits `agents-catalog.json`. Inlines Metaplex capability rollups, per-agent deploy URLs, and the shared `metaplexSkill` block the hub renders.
#481
#482	### Upgrade / re-clawdify agents
#483
#484	```bash
#485	# Upgrade any legacy-format agents to Solana-native one-shot schema
#486	node scripts/clawdify-agents.cjs
#487
#488	# Cosmetic pass (summary punctuation + preserve featured flag)
#489	node scripts/patch-agents.cjs
#490	```
#491
#492	Idempotent — already-upgraded files are detected via `$schema` + `solana` and skipped. Safe to re-run.
#493
#494	### Split / merge agent batches
#495
#496	```bash
#497	node scripts/split-agents.cjs
#498	```
#499
#500	---
#501
#502	## 🌐 Integration Examples
#503
#504	### React (catalog-driven gallery)
#505
#506	See [`client/src/components/AgentCatalog.tsx`](../client/src/components/AgentCatalog.tsx) for the live implementation.
#507
#508	```tsx
#509	const catalog = await fetch('/api/agents/catalog').then((r) => r.json());
#510
#511	return catalog.oneShots.map((agent) => (
#512	<AgentCard
#513	key={agent.identifier}
#514	agent={agent}
#515	onInstall={() => copyMcpConfig(agent)}
#516	onChat={() => router.push(agent.deploy.chat)}
#517	onMint={() => router.push(agent.deploy.mint)}
#518	/>
#519	));
#520	```
#521
#522	### Python
#523
#524	```python
#525	import requests
#526
#527	catalog = requests.get('https://x402.wtf/api/agents/catalog').json()
#528
#529	# Filter to agents that can launch tokens
#530	launchers = [a for a in catalog['agents']
#531	if 'metaplex-launch-bonding-curve' in a['capabilities']]
#532
#533	# Filter to featured Solana one-shots
#534	featured_oneshots = [a for a in catalog['featured']]
#535	```
#536
#537	### CLAWD Router invocation
#538
#539	```bash
#540	curl -X POST https://x402.wtf/api/agents/a2a \
#541	-H "Content-Type: application/json" \
#542	-d '{
#543	"jsonrpc": "2.0",
#544	"id": 1,
#545	"method": "invoke",
#546	"params": {
#547	"identifier": "solana-jupiter-router",
#548	"input": "Swap 10 SOL for USDC with tight slippage"
#549	}
#550	}'
#551	```
#552
#553	---
#554
#555	## 🔐 Security & Privacy
#556
#557	- No data collection — static JSON index, zero tracking
#558	- Agents run wherever you install them — local Clawd Desktop, your own infra, or MPL Core on Solana
#559	- Open source — full transparency, audit every line
#560	- On-chain is verifiable — minted agents live as MPL Core assets; update authority rules govern changes
#561	- Deny-first signing — every agent's system prompt instructs deny-first behaviour on irreversible actions (swap, stake, mint); signatures require explicit user confirmation
#562	- Payment-gated agents are transparent — see [CLAWD × Pump.fun Official](./src/clawd-pumpfun-official.json) for the reference pattern (wallet connect → 0.1 SOL on-chain → verify → deliver)
#563	- Pay agent workflows stay sandbox-first — see [Pay Agent](./src/pay-agent.json) and [Pay Agents docs](../docs/pay-agents.md) for `pay --sandbox curl`, Pay MCP, provider discovery, and gateway setup.
#564
#565	---
#566
#567	## 📊 Catalog Stats (Live)
#568
#569	Regenerate any time with `node build-catalog.cjs`. Current snapshot (May 2026):
#570
#571	- 124 agents across 9 categories
#572	- 1 one-shot surfaced on `/agents`
#573	- 2 featured in the top-of-page rail
#574	- 0 Metaplex-enabled in the generated catalog rollup
#575	- 0 trading-capable in the generated catalog rollup
#576	- 0 reusable templates
#577	- 18 languages via automated translation
#578	- Launch-capable (Genesis / bonding curve / agent token): `stats.launchCapableAgents`
#579	- Mint-capable (Core / Bubblegum / Candy Machine): `stats.mintCapableAgents`
#580
#581	---
#582
#583	## 🔗 Projects Building with Solana Clawd Agents
#584
#585	- ClawdOS — [Application Branch](https://github.com/clawdsolana/OpenClawd/tree/clawdos)
#586	- CLAWD Terminal — the parent repo hosting this hub + server + client
#587	- CLAWD Router — [ClawdRouter-main/](../ClawdRouter-main/) powers agent dispatch with tier/holder-aware routing
#588	- CLAWD × Pump.fun — payment-gated agent rails via `@pump-fun/agent-payments-sdk`
#589
#590	---
#591
#592	## 📜 License
#593
#594	MIT License — see [LICENSE](./LICENSE) for details.
#595
#596	Open Source • Open Format • Open Future
#597
#598	---
#599
#600	## 🌐 Live HTTP Deployment
#601
#602	The Solana Clawd Agents hub is also published over MCP [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) — no local installation required.
#603
#604	Endpoint:
#605
#606	```text
#607	https://modelcontextprotocol.name/mcp/defi-agents
#608	```
#609
#610	### Available MCP Tools (10)
#611
#612	\| Tool \| Description \|
#613	\| ------------------------ \| --------------------------------- \|
#614	\| `get_price` \| Get crypto prices \|
#615	\| `get_market_overview` \| Market overview \|
#616	\| `get_trending` \| Trending coins \|
#617	\| `search_coins` \| Search \|
#618	\| `get_coin_detail` \| Coin details \|
#619	\| `get_global_stats` \| Global stats \|
#620	\| `get_defi_protocols` \| DeFi protocols by TVL \|
#621	\| `get_protocol_detail` \| Protocol detail \|
#622	\| `get_chain_tvl` \| Chain TVL \|
#623	\| `get_yield_opportunities`\| Yield opportunities \|
#624
#625	### Example Requests
#626
#627	Get crypto prices:
#628
#629	```bash
#630	curl -X POST https://modelcontextprotocol.name/mcp/defi-agents \
#631	-H "Content-Type: application/json" \
#632	-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price","arguments":{"ids":"solana,jupiter-exchange-solana","vs_currencies":"usd"}}}'
#633	```
#634
#635	List all tools:
#636
#637	```bash
#638	curl -X POST https://modelcontextprotocol.name/mcp/defi-agents \
#639	-H "Content-Type: application/json" \
#640	-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
#641	```
#642
#643	### Also Available On
#644
#645	- [ClawdOS](https://clawdos.vercel.app) — browse and install from the [MCP marketplace](https://clawdos.vercel.app/community/mcp)
#646	- All 27 MCP servers — see the full catalog at [modelcontextprotocol.name](https://modelcontextprotocol.name)
#647
#648	> Powered by [modelcontextprotocol.name](https://modelcontextprotocol.name) — the open MCP HTTP gateway
#649
#650	---
#651
#652	## 🛣️ Roadmap — Known Follow-ups
#653
#654	Tracked here so they don't get lost between sessions.
#655
#656	- Metaplex Mint UI wiring. The Mint button on every one-shot card already routes to `/agents/mint?template=<id>`. The mint page needs to: (1) read that query param, (2) fetch the agent JSON from `/api/agents/catalog/<id>.json`, (3) prefill name / description / avatar / systemRole / `services[]` derived from `solana.capabilities`, (4) hand the composed input to `trpc.metaplex.mintAgent`, (5) write back the returned `assetAddress` into the `onchain` block.
#657	- Per-agent Metaplex capability badges on `/agents` cards. Schema + catalog data is ready; the AgentCatalog component renders a category chip row but not yet Metaplex badges.
#658	- Delegated asset-signer scoping. Once an agent is minted, `solana.capabilities` should gate which instructions the asset-signer PDA is allowed to sign via the MPL Core Execute hook.
#659	- A2A streaming. The hub's A2A endpoint is JSON-RPC over HTTP; SSE streaming for agent-to-agent dialogue is queued.
#660	- Template variable UI. Template JSON is currently not emitted; when `templates/*.template.json` returns, the mint page should render a form per variable instead of requiring users to edit JSON.
#661	- Router holder-tier priority. CLAWD Router honours holder tiers in its `ClawRouteConfig`; next step is wiring priority fee + Jito tip defaults into per-tier presets on the agent deploy flow.
#662

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public