my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	---
#2	name: solanaos
#3	description: >
#4	Complete SolanaOS agent skill — install, configure, and operate the autonomous
#5	Solana trading runtime with Honcho v3 epistemological memory, multi-venue perp
#6	trading (Hyperliquid + Aster), on-chain intelligence with USD pricing, Telegram
#7	bot, gateway API, Tailscale mesh, hardware integration, and cross-session recall.
#8	Use when asked to install SolanaOS, query Solana blockchain data, manage wallets,
#9	run OODA trading loops, configure strategies, control BitAxe mining fleets, pair
#10	Seeker devices, or operate any SolanaOS runtime surface.
#11	license: MIT
#12	metadata:
#13	solanaos:
#14	version: 2.0.0
#15	author: 8BIT Labs
#16	category: solana-crypto
#17	venues: [solana-spot, hyperliquid, aster]
#18	requires_bins: [go, git, curl]
#19	requires_env: [SOLANA_TRACKER_API_KEY, TELEGRAM_BOT_TOKEN]
#20	---
#21
#22	# SolanaOS — Complete Agent Skill
#23
#24	> Give this file to any AI agent (Claude, Codex, GPT-4, etc.)
#25	> to fully install, configure, and operate SolanaOS in one shot.
#26
#27	## What You Are Installing
#28
#29	SolanaOS — an autonomous Solana trading and operator runtime by 8BIT Labs.
#30
#31	One ~10MB Go binary (`solanaos`) that combines:
#32
#33	- OODA trading loop — RSI + EMA + ATR across Solana spot, Hyperliquid perps, Aster perps
#34	- Honcho v3 memory — persistent cross-session reasoning (KNOWN/LEARNED/INFERRED)
#35	- On-chain intelligence — wallets, token research, whale detection, USD pricing
#36	- Telegram bot — 60+ commands + natural language trading
#37	- Gateway API — memory, trading, sessions, chat on port 18790
#38	- Tailscale mesh — cross-device access without port forwarding
#39	- 80+ skills — auto-injected into LLM context
#40	- SolanaOS Hub — [seeker.solanaos.net](https://seeker.solanaos.net)
#41
#42	### Links
#43
#44	\| \| \|
#45	\| --- \| --- \|
#46	\| Repo \| [github.com/x402agent/SolanaOS](https://github.com/x402agent/SolanaOS) \|
#47	\| Hub \| [seeker.solanaos.net](https://seeker.solanaos.net) \|
#48	\| Souls \| [souls.solanaos.net](https://souls.solanaos.net) \|
#49	\| Docs \| [go.solanaos.net](https://go.solanaos.net) \|
#50	\| npm \| [solanaos-cli](https://www.npmjs.com/package/solanaos-cli) \|
#51	\| Launch \| [solanaos.net](https://solanaos.net) \|
#52
#53	---
#54
#55	## Install
#56
#57	```bash
#58	git clone https://github.com/x402agent/SolanaOS solanaos
#59	cd solanaos
#60	```
#61
#62	### Minimum `.env`
#63
#64	```bash
#65	SOLANA_TRACKER_API_KEY=your-key
#66	SOLANA_TRACKER_RPC_URL=https://rpc-mainnet.solanatracker.io/?api_key=your-key
#67	TELEGRAM_BOT_TOKEN=<redacted>
#68	TELEGRAM_ID=123456789
#69	LLM_PROVIDER=openrouter
#70	OPENROUTER_API_KEY=sk-or-v1-your-key
#71	OPENROUTER_MODEL=minimax/minimax-m2.7
#72
#73	# Recommended — get free key at helius.dev
#74	HONCHO_ENABLED=true
#75	HONCHO_API_KEY=hch-v3-your-key
#76	HELIUS_API_KEY=your-helius-key
#77	HELIUS_RPC_URL=<redacted>
#78	HELIUS_WSS_URL=wss://mainnet.helius-rpc.com/?api-key=your-helius-key
#79
#80	# Optional perps
#81	# HYPERLIQUID_PRIVATE_KEY=0x...
#82	# ASTER_API_KEY=your-key
#83	```
#84
#85	### Build & Run
#86
#87	```bash
#88	go build -o solanaos .
#89	./solanaos onboard
#90	./solanaos daemon
#91	```
#92
#93	### Verify
#94
#95	```bash
#96	solanaos status && solanaos solana wallet && solanaos pet
#97	```
#98
#99	---
#100
#101	## On-Chain Intelligence
#102
#103	\| Source \| Tier \| Freshness \|
#104	\|--------\|------\|-----------\|
#105	\| SolanaTracker RPC \| KNOWN \| < 60s \|
#106	\| Helius RPC \| KNOWN \| < 60s \|
#107	\| Helius Enhanced WebSockets \| KNOWN \| Real-time \|
#108	\| Helius DAS \| KNOWN \| < 60s \|
#109	\| Jupiter + SolanaTracker Swap \| KNOWN \| < 30s \|
#110	\| Hyperliquid / Aster \| KNOWN \| < 10s \|
#111	\| Honcho conclusions \| LEARNED \| Persistent \|
#112
#113	### Key Commands
#114
#115	```
#116	/wallet SOL balance + token portfolio + USD
#117	/trending Trending via SolanaTracker Datastream
#118	/research <mint> Deep research with risk scoring (0.0-1.0)
#119	/buy <token> <sol> Buy via Jupiter + SolanaTracker swap
#120	/sell <token> <amount\|%> Sell (supports "50%", "all")
#121	```
#122
#123	---
#124
#125	## Helius onchain-listener.ts (solana-claude integration)
#126
#127	When using solana-claude in a Node.js runtime:
#128
#129	```typescript
#130	import { HeliusListener, HeliusPoller } from "solana-claude/src/helius";
#131
#132	// Real-time account monitoring
#133	const listener = new HeliusListener({ apiKey: process.env.HELIUS_API_KEY! });
#134	await listener.connect();
#135
#136	// Watch a wallet for SOL balance changes
#137	await listener.subscribeAccount(
#138	"WALLET_ADDRESS",
#139	(data) => console.log("Balance changed:", data.account.lamports / 1e9, "SOL"),
#140	);
#141
#142	// Watch Token Program for all token transfers
#143	await listener.subscribeTransaction({
#144	accountInclude: ["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],
#145	vote: false,
#146	failed: false,
#147	}, (tx) => console.log("Token tx:", tx.signature));
#148
#149	// Slot heartbeat (fires every ~400ms)
#150	await listener.subscribeSlot((slot) => console.log("Slot:", slot.slot));
#151
#152	// Program logs (e.g. Raydium AMM v4)
#153	await listener.subscribeLogs(
#154	{ filter: { mentions: ["675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"] } },
#155	(log) => console.log("Raydium log:", log.logs),
#156	);
#157	```
#158
#159	---
#160
#161	## Memory (Honcho v3)
#162
#163	```
#164	/memory Status + peer card
#165	/recall <query> AI-powered recall via dialectic
#166	/remember <fact> Save durable conclusion
#167	/dream Trigger memory consolidation
#168	/profile Synthesized operator profile
#169	```
#170
#171	---
#172
#173	## Troubleshooting
#174
#175	\| Problem \| Fix \|
#176	\|---------\|-----\|
#177	\| Port 18790 in use \| `lsof -i :18790` → kill \|
#178	\| Telegram 409 \| `pkill -f "solanaos"` → restart \|
#179	\| Wallet not found \| `solanaos onboard` \|
#180	\| Helius WS disconnects \| Listener auto-reconnects with exponential backoff \|
#181	\| Build fails \| `go mod tidy && go build -o solanaos .` \|
#182
#183	---
#184
#185	SolanaOS v2.0.0 · 8BIT Labs · MIT
#186	github.com/x402agent/SolanaOS · seeker.solanaos.net
#187

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public