solanaos

Files (200)

• .dockerignore
• .env.example
• .gitattributes
• CODEOWNERS · .github/
• bug_report.md · .github/ISSUE_TEMPLATE/
• feature_request.md · .github/ISSUE_TEMPLATE/
• PULL_REQUEST_TEMPLATE.md · .github/
• dependabot.yml · .github/
• ci.yml · .github/workflows/
• launch-readiness.yml · .github/workflows/
• neon-branch.yml · .github/workflows/
• npm-release.yml · .github/workflows/
• protect-sensitive-paths.yml · .github/workflows/
• pump-scan-deploy.yml · .github/workflows/
• release.yml · .github/workflows/
• trufflehog.yml · .github/workflows/
• .gitignore
• .markdownlint.json
• CHANGELOG.md
• CODE_OF_CONDUCT.md
• CONTRIBUTING.md
• DAEMON.md
• Dockerfile
• Dockerfile.fly
• FORK.md
• LICENSE
• META.md
• Makefile
• PAPER.md
• README.md
• SECURITY.md
• SKILL.md
• SOUL.md
• STRATEGY.md
• TOKEN.md
• TRADE.md
• Contents.json · WatchApp/Assets.xcassets/AppIcon.appiconset/
• Contents.json · WatchApp/Assets.xcassets/
• ComplicationViews.swift · WatchApp/
• ContentView.swift · WatchApp/
• Info.plist · WatchApp/
• OpenClawWatchApp.swift · WatchApp/
• project.pbxproj · WatchApp/SolanaOSWatch.xcodeproj/
• WalletState.swift · WatchApp/
• agent.example.json · acp_registry/
• agent.json · acp_registry/
• generate.mjs · acp_registry/
• .gitignore · bots/pumpfun-mayhem-ai-trading-bot-main/
• README.md · bots/pumpfun-mayhem-ai-trading-bot-main/
• env.example · bots/pumpfun-mayhem-ai-trading-bot-main/
• package-lock.json · bots/pumpfun-mayhem-ai-trading-bot-main/
• package.json · bots/pumpfun-mayhem-ai-trading-bot-main/
• index.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/config/
• index.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/
• errorHandler.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/middleware/
• events.routes.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/routes/
• health.routes.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/routes/
• trading.routes.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/routes/
• ai-trading.service.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/services/
• market-scanner.ts · bots/pumpfun-mayhem-ai-trading-bot-main/src/services/
• …and 140 more

SKILL.md (first lines)

# SolanaOS — Complete Agent Skill

> Give this file to any AI agent (Claude, Codex, GPT-4, DeepSolana, Hermes, etc.)
> to fully install, configure, and operate SolanaOS in one shot.

```text
   _____       __                        ____  _____
  / ___/____  / /___ _____  ____ _     / __ \/ ___/
  \__ \/ __ \/ / __ `/ __ \/ __ `/    / / / /\__ \
 ___/ / /_/ / / /_/ / / / / /_/ /    / /_/ /___/ /
/____/\____/_/\__,_/_/ /_/\__,_/     \____//____/
                S O L A N A O S
```

## What You Are Installing

**SolanaOS** — an autonomous Solana trading and operator runtime by 8BIT Labs.

One ~10MB Go binary (`solanaos`) that combines:

- **OODA trading loop** — RSI + EMA + ATR across Solana spot, Hyperliquid perps, Aster perps
- **Honcho v3 memory** — persistent cross-session reasoning (KNOWN/LEARNED/INFERRED)
- **On-chain intelligence** — wallets, token research, whale detection, USD pricing
- **Telegram bot** — 60+ commands + natural language trading
- **Gateway API** — memory, trading, sessions, chat on port 18790
- **Tailscale mesh** — cross-device access without port forwarding
- **Hardware** — Arduino Modulino I2C on Orin Nano, RPi, RISC-V
- **80+ skills** — auto-injected into LLM context
- **SolanaOS Hub** — [seeker.solanaos.net](https://seeker.solanaos.net)

### Links

| | |
| --- | --- |
| Repo | [github.com/x402agent/SolanaOS](https://github.com/x402agent/SolanaOS) |
| Hub | [seeker.solanaos.net](https://seeker.solanaos.net) |
| Souls | [souls.solanaos.net](https://souls.solanaos.net) |
| Docs | [go.solanaos.net](https://go.solanaos.net) |
| npm | [solanaos-cli](https://www.npmjs.com/package/solanaos-cli) |
| Launch | [solanaos.net](https://solanaos.net) |

---

## Install

```bash
git clone https://github.com/x402agent/SolanaOS solanaos
cd solanaos
```

### Minimum `.env`

```bash
SOLANA_TRACKER_API_KEY=your-key
SOLANA_TRACKER_RPC_URL=https://rpc-mainnet.solanatracker.io/?api_key=your-key
SOLANA_TRACKER_WSS_URL=wss://rpc-mainnet.solanatracker.io/?api_key=your-key
TELEGRAM_BOT_TOKEN=your-telegram-bot-token
TELEGRAM_ID=123456789
LLM_PROVIDER=openrouter
OPENROUTER_API_KEY=sk-or-v1-your-key
OPENROUTER_MODEL=minimax/minimax-m2.7

# Recommended
HONCHO_ENABLED=true
HONCHO_API_KEY=hch-v3-your-key
HONCHO_SESSION_STRATEGY=per-chat
HONCHO_DIALECTIC_ENABLED=true
HELIUS_API_KEY=your-helius-key

# Optional perps
# HYPERLIQUID_PRIVATE_KEY=0x...
# ASTER_API_KEY=your-key
```

### Build & Run

```bash
make build
./build/solanaos onboard
./build/solanaos daemon
```

Or npm: `npx solanaos-cli install`

### Verify

```bash
solanaos status && solanaos solana wallet && solanaos pet
```

---

## On-Chain Intelligence

| Source | Tier | Freshness |
|--------|------|-----------|
| SolanaTracker RPC | **KNOWN** | < 60s |
| SolanaTracker Datastream | **KNOWN** | Real-time WSS |
| Helius DAS | **KNOWN** | < 60s |
| Jupiter + SolanaTracker Swap | **KNOWN** | < 30s |
| Hyperliquid / Aster | **KNOWN** | < 10s |
| Honcho conclusions | **LEARNED** | Persistent |

### Commands

```
/wallet                     SOL balance + token portfolio + USD
/trending                   Trending via SolanaTracker Datastream
/research <mint>            Deep research with risk scoring (0.0-1.0)
/buy <token> <sol>          Buy via Jupiter + SolanaTracker swap
/sell <token> <amount|%>    Sell (supports "50%", "all")
```

### Natural Language Spot Trading

```
buy 0.5 SOL worth of BONK       → executes buy
ape into WIF with 1 sol         → executes buy
sell all my BONK                 → executes sell

From x402agent/SolanaOS, MIT.

More from x402agent/SolanaOS