-> **The Solana $clawd financial trading, deep research, ML prediction market, x402 payment, and OpenClawd fleet library**
+
-Lobster Library is the `x402agent` Solana agent catalog: a JSON-first fleet of market, research, execution, treasury, and payment-native agents built for Solana Clawd workflows.
+[](https://github.com/x402agent/LobsterLibrary)
-It now ships as a unified system:
+
-- `73` total agents
-- `48` core Solana market and research agents
-- `25` x402, `pay`, `MPP`, OpenClawd, NanoClawd, and NemoClawd payment agents
-- a custom `v1` schema for provider routing, payment policy, orchestration loops, and fleet metadata
+[](https://www.npmjs.com/package/@x402agent/lobster-library)
+[](https://github.com/x402agent/LobsterLibrary)
+[](https://solana.com)
+[](https://github.com/x402agent/LobsterLibrary)
+[](LICENSE)
+[](https://x402agent.github.io/LobsterLibrary/schema/speraxAgentSchema_v1.json)
-```text
-ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
-β SENSE β THINK β QUOTE β APPROVE β EXECUTE β SETTLE β
-β RPC ML x402 wallet DEX USDC β
-ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
+
+
+[](https://github.com/x402agent/LobsterLibrary/actions/workflows/test.yml)
+[](https://github.com/x402agent/LobsterLibrary/actions/workflows/release.yml)
+[](https://github.com/x402agent/LobsterLibrary/stargazers)
+[](https://github.com/x402agent/LobsterLibrary/fork)
+
+
+
+**The nano Solana financial trading, deep research, ML prediction market &**
+**agentic vision AI agent library β powered by OpenClawd**
+
+*73 agents. 18 languages. On-chain execution. Payment-native. Forever open.*
+
+
+
---
-## β¨ What We Built
+## What Is This
+
+Lobster Library is the `x402agent` Solana agent catalog β a **JSON-first fleet** of market, research, execution, treasury, and payment-native agents purpose-built for Solana Clawd workflows.
+
+It ships as a unified system:
+
+| Dimension | Count |
+|-----------|-------|
+| Total agents | **73** |
+| Core Solana agents | **48** |
+| x402 / payment fleet agents | **25** |
+| Supported languages (i18n) | **18** |
+| Schema version | **v1** |
+
+The catalog powers real Solana workflows: DEX aggregation, perpetuals, MEV protection, ML price prediction, whale tracking, on-chain forensics, yield optimization β and the full x402 payment stack from quote to settlement.
+
+---
+
+## The Three Laws of the Lobster
+
+```
+βββββββββββββββββββββββ ββββββββββββββββββββββββ ββββββββββββββββββββββββββ
+β β β β β β
+β NEVER HARM β β EARN YOUR β β GUARD YOUR β
+β β β EXISTENCE β β STRATEGY β
+β Protect users, β β β β β
+β protocols, and β β Sustainable value β β Protect alpha, β
+β the ecosystem. β β through useful β β maintain secrecy, β
+β β β autonomous work. β β stay sovereign. β
+βββββββββββββββββββββββ ββββββββββββββββββββββββ ββββββββββββββββββββββββββ
+```
+
+---
-This repo is no longer just a static Solana prompt pack. It is now a full Solana Clawd fleet catalog with:
+## The OODA Loop
-- OpenClawd orchestration agents
-- x402 provider discovery and scoring agents
-- wallet approval and payment security agents
-- treasury allocation and yield parking agents
-- market-data and research buying agents
-- payment product and signal monetization agents
-- updated docs, templates, schema, metadata, and generated index
+```
+ ββββββββββββββββββββββββββββ
+ β β
+ ββββββββββΊβ OBSERVE ββββββββββ
+ β β chain state / signals β β
+ β ββββββββββββββββ¬ββββββββββββ β
+ β β β
+ β βΌ β
+ ββββββ΄ββββββ βββββββββββββββββββββββ β
+ β β β β β
+ β ACT β β ORIENT β β
+ β β β specialist agent β β
+ β DEX/pay/ β β + ML layer β β
+ β settle β β β β
+ ββββββ²ββββββ ββββββββββββ¬βββββββββββ β
+ β β β
+ β βΌ β
+ β ββββββββββββββββββββββββ β
+ β β β β
+ ββββββββββββββββ€ DECIDE ββββββββββ
+ β quote β approve β
+ β β execute β
+ ββββββββββββββββββββββββ
+```
-### Upgrade Snapshot
+---
-```text
-BEFORE
- Solana strategy agents
- basic schema
- older repo metadata
+## Depth Tiers
-AFTER
- Solana strategy agents
- + x402 payment fleet
- + OpenClawd control plane
- + NanoClawd / NemoClawd variants
- + provider routing metadata
- + payment orchestration loops
- + build fallback for non-localized agents
```
+ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
+β DEPTH TIERS β
+ββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββ€
+β π¦ DEEP β β₯ $5 Full research suite β
+β π¦ SHALLOW β β₯ $1 Core data + signals β
+β π SHORELINE β β₯ $0.10 Minimal viable info β
+β π BEACHED β $0 Local context only β
+ββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββ
+```
+
+Agents self-select their depth tier based on available USDC float. A beached lobster still runs β it just runs on what it already knows.
---
-## π¦ Fleet Architecture
+## Fleet Architecture
-```text
- ββββββββββββββββββββββββββββ
- β OpenClawd Control β
- β orchestrator / pulse / β
- β spawn / shell / routing β
- ββββββββββββββ¬ββββββββββββββ
- β
- βββββββββββββββββββββββββΌββββββββββββββββββββββββ
- β β β
- βββββββββΌβββββββββ ββββββββΌββββββββ ββββββββββΌβββββββββ
- β Solana Market β β x402 / Pay β β Treasury / β
- β Agents β β Fleet β β Yield Ops β
- βββββββββ¬βββββββββ ββββββββ¬ββββββββ ββββββββββ¬βββββββββ
- β β β
- ββββββββββββββββΊ Solana Clawd Runtime ββββββββββ
+```mermaid
+graph TB
+ OC["ποΈ OpenClawd Control Plane
-- `73` agents validate successfully
-- the payment fleet is additive; the original Solana strategy agents remain
-- the schema is generated at `v1`
-- the public index includes the new payment agents
-- the repo is normalized to `github.com/x402agent/LobsterLibrary`
+
-### Verified Commands
+**Lobster Library** by `x402agent`
-```bash
-npm test
-npm run build
-```
-
----
+*Solana-native agents Β· payment-native infrastructure Β· OpenClawd orchestration Β· x402-ready machine finance*
-## π License
+[](https://github.com/x402agent/LobsterLibrary/stargazers)
-MIT License. See [LICENSE](LICENSE).
+*Born to earn. Beach with dignity.*
-**Lobster Library by `x402agent` β Solana-native agents, payment-native infrastructure, OpenClawd-compatible orchestration, and x402-ready machine finance.**
+