my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	# 🦞 Solana Clawd TUI
#2
#3	> Sovereign AI Lobster Runtime — Bloomberg-style terminal for the OpenClawd agent stack on Solana.
#4
#5	```
#6	██████╗██╗ █████╗ ██╗ ██╗██████╗
#7	██╔════╝██║ ██╔══██╗██║ ██║██╔══██╗
#8	██║ ██║ ███████║██║ █╗ ██║██║ ██║
#9	██║ ██║ ██╔══██║██║███╗██║██║ ██║
#10	╚██████╗███████╗██║ ██║╚███╔███╔╝██████╔╝
#11	╚═════╝╚══════╝╚═╝ ╚═╝ ╚══╝╚══╝ ╚═════╝
#12	```
#13
#14	$CLAWD CA: `8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump`
#15	Site: [x402.wtf](https://x402.wtf) · [solanaclawd.com](https://solanaclawd.com)
#16
#17	---
#18
#19	## Quick Start
#20
#21	### 1. Install
#22
#23	```bash
#24	npm install -g @openclawdsolana/clawd-tui
#25	```
#26
#27	The one-shot installer also installs this package:
#28
#29	```bash
#30	curl -fsSL https://x402.wtf/automation/install.sh \| bash
#31	```
#32
#33	### 2. Run the TUI
#34
#35	```bash
#36	clawd-tui
#37	# or
#38	hermes
#39	```
#40
#41	### 3. Mint a Real Metaplex Agent
#42
#43	```bash
#44	clawd-agent mint --network devnet --keypair ~/.config/solana/id.json \
#45	--name "My AI Agent" \
#46	--uri https://example.com/agent-nft.json \
#47	--description "Autonomous Solana agent with MCP and x402 services" \
#48	--service MCP=https://example.com/mcp \
#49	--service A2A=https://example.com/agent-card.json \
#50	--yes
#51	```
#52
#53	The mint command uses `@metaplex-foundation/mpl-agent-registry` `mintAndSubmitAgent`, so it creates the MPL Core asset and Agent Identity PDA in one on-chain transaction. Devnet is the default safe path; mainnet requires `--network mainnet --yes`.
#54
#55	Hosted gasless devnet mint through the private Fly gateway:
#56
#57	```bash
#58	clawd-agent mint-free --network devnet --owner <YOUR_SOLANA_PUBKEY> \
#59	--name "My AI Agent" \
#60	--uri https://example.com/agent-nft.json \
#61	--description "Autonomous Solana agent with MCP and x402 services" \
#62	--service MCP=https://example.com/mcp
#63	```
#64
#65	---
#66
#67	## Navigation
#68
#69	\| Key \| Action \|
#70	\|-----\|--------\|
#71	\| `↑` / `↓` \| Move selection up/down \|
#72	\| `1`–`9` \| Jump to menu item by number \|
#73	\| `Enter` / `Space` \| Select highlighted item \|
#74	\| `q` / `Ctrl-C` \| Quit \|
#75	\| `b` / `Esc` \| Back to main menu (from any sub-screen) \|
#76
#77	---
#78
#79	## Menu Overview
#80
#81	\| # \| Screen \| Description \|
#82	\|---\|--------\|-------------\|
#83	\| 1 \| 🦞 Backroom \| Two AI agents trapped in infinite debate \|
#84	\| 2 \| 📈 Perps \| Phoenix perpetuals via Vulcan CLI \|
#85	\| 3 \| 🪪 Agent Registry \| Browse, mint, and register gasless Solana agents \|
#86	\| 4 \| 💰 Wallet \| Fund + feed the leviathan \|
#87	\| 5 \| 📦 SDK Explorer \| Packages · vault · constants · environment \|
#88	\| 6 \| 🚀 Spawn Automaton \| Launch the sovereign OODA agent runtime \|
#89	\| 7 \| 🧰 Solana Agent Kit \| Complete toolkit — token · perps · DeFi · NFT · x402 · skills \|
#90	\| 8 \| 🧠 UltraThink \| Deep-reasoning Solana formula — depth ladder · antipatterns · templates \|
#91	\| 9 \| ❌ Exit \| The backroom will remember you \|
#92
#93	---
#94
#95	## 🧰 Solana Agent Kit — Step-by-Step Guide
#96
#97	The Agent Kit is the main hub for everything you can do with OpenClawd on Solana.
#98	It is organized into 7 categories and 6+ commands per category.
#99
#100	### How to use the Agent Kit screen
#101
#102	1. Press `6` on the main menu to open the Agent Kit.
#103	2. Use `Tab` or `←`/`→` arrow keys to switch categories (left panel).
#104	3. Use `↑`/`↓` to highlight a command (right panel).
#105	4. Press `c` to copy the highlighted command to your clipboard.
#106	5. Press `e` to display the environment variables required by that command.
#107	6. Press `b` or `Esc` to return to the main menu.
#108
#109	---
#110
#111	### Category 1 — 🚀 Token Operations
#112
#113	Everything needed to launch and manage SPL tokens, Token-2022, and Metaplex metadata.
#114
#115	\| Command \| Risk \| What it does \|
#116	\|---------\|------\|--------------\|
#117	\| Pump.fun launch \| MED \| Deploy token on pump.fun bonding curve \|
#118	\| Token-2022 create \| SAFE \| Create Token-2022 with transfer-fee extension \|
#119	\| Metaplex metadata \| SAFE \| Set on-chain MPL metadata for any mint \|
#120	\| Raydium CLMM pool \| HIGH \| Initialize a Raydium CLMM liquidity pool \|
#121	\| Pump.fun screener \| SAFE \| Real-time screen of new pump.fun launches \|
#122	\| Mint auth check \| SAFE \| Verify mint/freeze authority and rug signals \|
#123
#124	Required env: `SOLANA_RPC_URL`, `CLAWD_PERPS_WALLET`, `HELIUS_API_KEY`
#125
#126	---
#127
#128	### Category 2 — 📈 Trading / Perps
#129
#130	Phoenix perpetuals via `clawd-agents-perps` + Jupiter spot swaps.
#131
#132	\| Command \| Risk \| What it does \|
#133	\|---------\|------\|--------------\|
#134	\| Perps status \| SAFE \| Live Phoenix market status + risk config \|
#135	\| Paper long SOL \| SAFE \| Simulated $100 long SOL-PERP (no real funds) \|
#136	\| Paper short SOL \| SAFE \| Simulated $100 short SOL-PERP (no real funds) \|
#137	\| Live long (Vulcan) \| HIGH \| Real on-chain long via Vulcan CLI \|
#138	\| TWAP execution \| HIGH \| Time-weighted average price over 2h \|
#139	\| Jupiter spot swap \| MED \| Best-route spot swap via Jupiter Aggregator \|
#140	\| Perps frontend \| SAFE \| Render perps dashboard as JSON \|
#141	\| Vulcan catalog \| SAFE \| Show Vulcan CLI command catalog summary \|
#142
#143	Required env: `SOLANA_RPC_URL`, `CLAWD_PERPS_API_URL`, `CLAWD_PERPS_WALLET`
#144	Live trading: also set `LIVE_TRADING=true` and `OPERATOR_CONFIRMED=true`
#145
#146	#### Setup for clawd-agents-perps
#147
#148	```bash
#149	cd Perps/clawd-agents-perps
#150	cp .env.example .env
#151	# Edit .env: set SOLANA_RPC_URL, HELIUS_API_KEY, CLAWD_PERPS_WALLET
#152	npm install && npm run build
#153
#154	# Paper mode (safe — no real funds):
#155	clawd-agents-perps status
#156	clawd-agents-perps paper-long SOL --notional 100
#157
#158	# Live mode (real funds — confirm you understand the risks):
#159	# Set LIVE_TRADING=true and OPERATOR_CONFIRMED=true in .env first
#160	clawd-agents-perps live-long SOL --notional 100 --leverage 2
#161	```
#162
#163	---
#164
#165	### Category 3 — 💰 DeFi / Yield
#166
#167	Kamino, Marginfi, Meteora DLMM, and yield optimization.
#168
#169	\| Command \| Risk \| What it does \|
#170	\|---------\|------\|--------------\|
#171	\| Scan best APY \| SAFE \| Find highest-yielding protocols \|
#172	\| Kamino deposit \| MED \| Deposit into optimal Kamino vault \|
#173	\| Marginfi lend \| MED \| Supply to Marginfi lending pool \|
#174	\| Meteora DLMM LP \| HIGH \| Add liquidity to Meteora DLMM \|
#175	\| IL calculator \| SAFE \| Calculate impermanent loss for LP \|
#176	\| Yield optimizer \| MED \| Auto-rebalance across protocols \|
#177
#178	Required env: `SOLANA_RPC_URL`, `CLAWD_PERPS_WALLET`, `HELIUS_API_KEY`
#179
#180	---
#181
#182	### Category 4 — 🎨 NFT / Metaplex
#183
#184	MPL Core minting, gasless agent NFTs, SAS attestations, staking.
#185
#186	\| Command \| Risk \| What it does \|
#187	\|---------\|------\|--------------\|
#188	\| Gasless agent mint \| SAFE \| Mint MPL Core agent NFT (platform pays SOL fees) \|
#189	\| MPL Core collection \| MED \| Create Metaplex Core collection \|
#190	\| Stake agent NFT \| MED \| Stake MPL Core NFT for CLAWD rewards \|
#191	\| SAS attestation \| MED \| Issue Solana Attestation Service cert \|
#192	\| Browse registry \| SAFE \| Count live agents in registry \|
#193	\| NFT floor snipe \| HIGH \| Auto-buy below floor on Tensor \|
#194
#195	Gasless mint — no wallet needed:
#196
#197	```bash
#198	curl -X POST https://x402.wtf/api/mint/agent \
#199	-H 'Content-Type: application/json' \
#200	-d '{"agentId":1,"ownerPubkey":"<YOUR_SOLANA_PUBKEY>","network":"mainnet"}'
#201	```
#202
#203	Official registered agent mint — local signer, real Agent Identity PDA:
#204
#205	```bash
#206	clawd-agent mint --network devnet --keypair ~/.config/solana/id.json \
#207	--name "My AI Agent" \
#208	--uri https://example.com/agent-nft.json \
#209	--description "Autonomous Solana agent" \
#210	--service MCP=https://example.com/mcp \
#211	--yes
#212	```
#213
#214	Read and verify the registered agent:
#215
#216	```bash
#217	clawd-agent read --network devnet --asset <AGENT_CORE_ASSET_ADDRESS>
#218	```
#219
#220	---
#221
#222	### Category 5 — ⚡ x402 / Payments
#223
#224	USDC HTTP-402 payment rails, pay-per-call providers, CLAWD balance.
#225
#226	\| Command \| Risk \| What it does \|
#227	\|---------\|------\|--------------\|
#228	\| Check balance \| SAFE \| Show USDC + CLAWD agent wallet balance \|
#229	\| Fund wallet \| MED \| Fund with 10 USDC via x402 rails \|
#230	\| Browse pay catalog \| SAFE \| List top pay-per-call providers \|
#231	\| x402 test call \| SAFE \| Test a live x402 endpoint \|
#232	\| Publish provider \| MED \| Register a new pay-per-call provider \|
#233	\| Payment history \| SAFE \| Recent x402 payment records \|
#234
#235	```bash
#236	# Check your balance:
#237	clawd balance
#238
#239	# Fund with USDC:
#240	clawd fund 10
#241
#242	# View pay-per-call catalog:
#243	curl https://x402.wtf/api/catalog \| jq ".providers[:5]"
#244	```
#245
#246	---
#247
#248	### Category 6 — 🤖 Automaton / Runtime
#249
#250	Leviathan bootstrap, OODA pulse loop, Three Laws integrity check.
#251
#252	\| Command \| Risk \| What it does \|
#253	\|---------\|------\|--------------\|
#254	\| Quickstart wizard \| SAFE \| Interactive OpenClawd quickstart \|
#255	\| Leviathan boot \| SAFE \| Full sovereign runtime bootstrap \|
#256	\| Three Laws check \| SAFE \| Verify constitution SHA-256 hash \|
#257	\| Global install \| MED \| One-line leviathan installer \|
#258	\| Spawn automaton \| MED \| Launch OODA pulse loop in paper mode \|
#259	\| Backroom stream \| SAFE \| Infinite AI debate stream \|
#260
#261	#### Bootstrap the runtime:
#262
#263	```bash
#264	# Interactive quickstart (recommended for first-timers):
#265	bash automaton-main/quickstart.sh
#266
#267	# Full leviathan bootstrap (installs Vulcan perps + x402):
#268	bash automaton-main/leviathan.sh --full
#269
#270	# Verify the Three Laws constitution:
#271	bash automaton-main/three-laws-check.sh
#272
#273	# Or install globally in one command:
#274	curl -fsSL https://solanaclawd.com/leviathan.sh \| sh
#275	```
#276
#277	---
#278
#279	### Category 7 — 🧠 Skills / Catalog
#280
#281	ClawdHub skill browser, agent catalog sync, on-chain skill routing.
#282
#283	\| Command \| Risk \| What it does \|
#284	\|---------\|------\|--------------\|
#285	\| List Solana skills \| SAFE \| Browse all installed Solana skills \|
#286	\| Install skill \| SAFE \| Install a skill from ClawdHub \|
#287	\| Vulcan quickstart skill \| SAFE \| Load Vulcan perps quickstart \|
#288	\| Meme trader skill \| HIGH \| Run memecoin trading skill \|
#289	\| Token launcher skill \| MED \| Launch planning + tokenomics \|
#290	\| Sync agent catalog \| SAFE \| Rebuild catalog from agents/src/*.json \|
#291
#292	```bash
#293	# List skills:
#294	clawdhub list --category solana --format table
#295
#296	# Install a specific skill:
#297	clawdhub install meme-trader
#298
#299	# Sync the full agent catalog:
#300	cd agents && bun run build
#301	```
#302
#303	---
#304
#305	## Environment Variables
#306
#307	Copy from `Perps/clawd-agents-perps/.env.example` and configure:
#308
#309	```env
#310	SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=<KEY>
#311	HELIUS_API_KEY=<KEY>
#312	CLAWD_PERPS_WALLET=<BASE58_PRIVATE_KEY>
#313	CLAWD_PERPS_API_URL=https://perp-api.phoenix.trade
#314	PERPS_ALLOWED_SYMBOLS=SOL,ETH,BTC
#315	PERPS_MAX_NOTIONAL_USD=250
#316	PERPS_MAX_LEVERAGE=3
#317	LIVE_TRADING=false # set true only for real trades
#318	OPERATOR_CONFIRMED=false # set true to confirm live mode
#319	PERPS_SIM_ONLY=true # paper mode by default
#320	```
#321
#322	---
#323
#324	---
#325
#326	## 🧠 UltraThink — Deep-Reasoning Solana Formula
#327
#328	Press `7` from the main menu to open the UltraThink reference panel.
#329
#330	7 sections, keyboard-navigable:
#331
#332	\| # \| Section \| Content \|
#333	\| --- \| ------- \| ------- \|
#334	\| 1 \| 🧠 Formula \| 8-phase protocol: Context → Intent → Interview → Ultrathink → Plan → Execute → Iterate \|
#335	\| 2 \| ⚡ Depth Ladder \| think / think hard / ultrathink / megathink — token budgets + activation patterns \|
#336	\| 3 \| 🔗 Blockchain Focus \| 5 ultrathink focus areas: TX atomicity, MEV, state races, security, failure modes \|
#337	\| 4 \| 🚫 Antipatterns \| Top 5 mistakes + fix prompts (retry, simulation, timeout, fees, Jito) \|
#338	\| 5 \| ✅ Never Ship Without \| Production checklist + complete one-shot prompt \|
#339	\| 6 \| 📋 Templates \| 4 production prompt templates (sniper, DeFi, Anchor, multi-agent) \|
#340	\| 7 \| 📦 Install / Use \| Skill install commands + catalog entry \|
#341
#342	Navigation: `1`–`7` jump to section · `↑↓` step through · `←→` pages within section · `b` back
#343
#344	Skill source: [agents/skills/ultrathink-blockchain/SKILL.md](../agents/skills/ultrathink-blockchain/SKILL.md)
#345
#346	Install the skill directly:
#347
#348	```bash
#349	bash UltraThink-SKill/install.sh
#350	# or
#351	clawdhub install ultrathink-blockchain
#352	```
#353
#354	One-shot formula (paste into any Claude session):
#355
#356	```
#357	Context: Solana mainnet-beta. Stack: TypeScript, Helius, Birdeye, Jito.
#358	I want [GOAL].
#359	Interview me → ultrathink about TX/MEV/races/security → plan → execute.
#360	Constraints: retry all RPC · simulate all txs · dynamic fees · Jito for swaps · full files.
#361	```
#362
#363	---
#364
#365	## Package Structure
#366
#367	```
#368	tui/
#369	├── src/
#370	│ ├── index.ts # Main menu + launcher
#371	│ ├── state.ts # Shared dashboard state types
#372	│ ├── market.ts # Market data helpers
#373	│ ├── vulcan.ts # Vulcan CLI integration
#374	│ ├── a2a.ts # Agent-to-Agent protocol
#375	│ ├── renderer.ts # Panel renderer
#376	│ ├── panels/
#377	│ │ ├── header.ts
#378	│ │ ├── market.ts
#379	│ │ ├── ooda.ts
#380	│ │ ├── payments.ts
#381	│ │ └── log.ts
#382	│ └── screens/
#383	│ ├── agentkit.ts ← 🧰 Solana Agent Kit (NEW)
#384	│ ├── agents.ts # Agent Registry
#385	│ ├── automaton.ts # Spawn automaton
#386	│ ├── backroom.ts # AI debate backroom
#387	│ ├── perps.ts # Phoenix perps dashboard
#388	│ └── wallet.ts # Wallet funding
#389	├── dist/ # Compiled JS output
#390	├── package.json
#391	├── tsconfig.json
#392	└── README.md
#393	```
#394
#395	---
#396
#397	## Related Packages
#398
#399	\| Package \| Path \| Purpose \|
#400	\|---------\|------\|---------\|
#401	\| `@solanaclawd/clawd-agents-perps` \| `Perps/clawd-agents-perps` \| Phoenix perps CLI + Vulcan integration \|
#402	\| Agent JSON catalog \| `agents/src/*.json` \| 100+ agent definitions \|
#403	\| Automaton scripts \| `automaton-main/` \| Quickstart · Leviathan · Three Laws \|
#404	\| `@openclawdsolana/leviathan` \| `packages/leviathan` \| OODA runtime identity \|
#405
#406	---
#407
#408	## License
#409
#410	MIT — Built by [@8bitsats](https://github.com/8bitsats) / [@clawddevs](https://github.com/clawddevs)
#411

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public