🚀 Space Lord

Open-source Hedera DeFi toolkit built for an OpenClaw AI agent to drive — via CLI tool use, not MCP. Fully built. Ready to go.

Hedera Hello Future Apex Hackathon 2026 — AI & Agents Track | OpenClaw Bounty

📄 Whitepaper (PDF) · 📑 Pitch Deck (PDF) · 🎬 Demo Video

For Judges

1. Watch → Demo Video (5 min)
2. Read → Pitch Deck or Whitepaper
3. Explore → This README (architecture, features, security model)
4. Try it → git clone → ./launch.sh init → ./launch.sh balance (2 min setup)

Built solo by Chris — github.com/Chris0x88

---

💡 What is Space Lord?

The Hedera Agent Kit gives developers incredible building blocks — swaps, transfers, token operations. What it doesn't give you is an agent system to drive them. That's what we built.

Space Lord is the connective tissue between an OpenClaw AI agent and the Hedera hashgraph. It collapses the exchange, the wallet, and the portfolio tracker into one local CLI tool that an AI agent drives through CLI tool use — not MCP. Your agent doesn't write swap code. It calls fixed tools every time. One valid execution path per operation.

	Hedera Agent Kit	Space Lord
What	Developer toolkit / library	Full-stack agent-driven application
Agent integration	You build it	Pre-configured OpenClaw specialist agent
SaucerSwap	API-dependent	Direct smart contract calls (no API)
Governance	None	Read-only config: per-swap limits, daily caps, slippage ceilings
Key security	Framework-dependent	XOR-obfuscated, agent-sandboxed, whitelisted transfers
Runs on	Your infrastructure	Your machine — local edge compute

No browser wallet. No exchange login. No click fatigue. No multi-app juggling. One local tool. 30+ commands. Direct to smart contracts.

We consume the middleware — starting with HashPack and SaucerSwap. Built and tested exclusively on Hedera mainnet with real tokens. See the full differentiation breakdown.

---

⚡ Quick Start

Option A: From your OpenClaw Agent

We're heading to a multi-agent universe. The Space Lord skill is a support tool that provides agentic control of the application (installed in Option B). Your primary OpenClaw agent can clone this repo, install the app, and spin up a dedicated trading agent with the Space Lord skill package.

1. Ask your agent to git clone this repo and install the application locally
2. Have it spin up a dedicated trading agent using the Space Lord skill
3. Set up Telegram — create your own bot to chat directly with your new agent (OpenClaw also supports Discord and other platforms)

Option B: Manual Install (Mac/Linux)

⚠️ Best to run locally — don't pass crypto keys through AI LLM chat APIs (unsafe — keys could end up in model training data). New key protection features coming soon. For now, treat as live network "experimental."

git clone https://github.com/Chris0x88/pacman.git
cd pacman
./launch.sh init        # Guided wizard: key setup, token associations
./launch.sh help        # See all 30+ available commands
./launch.sh balance     # Check your portfolio
./launch.sh swap 10 USDC for HBAR          # Execute a real swap

./launch.sh is a zero-dependency bash launcher — installs uv, validates .env, dispatches to the CLI engine. Keys entered locally through the wizard — they never travel through any API.

---

🏗️ Architecture

graph TD
    %% Styling %%
    classDef interface fill:#1e1e2e,stroke:#cba6f7,stroke-width:2px,color:#fff,rx:8,ry:8
    classDef ai fill:#ff2052,stroke:#fff,stroke-width:2px,color:#fff,rx:8,ry:8
    classDef engine fill:#313244,stroke:#a6e3a1,stroke-width:2px,color:#fff,rx:8,ry:8
    classDef ext fill:#11111b,stroke:#f9e2af,stroke-width:2px,color:#fff,rx:8,ry:8
    classDef hedera fill:#000000,stroke:#00a8e8,stroke-width:3px,color:#fff,rx:8,ry:8

    User((You)):::interface -->|Natural Language| Agent[OpenClaw AI Agent]:::ai
    User -->|Terminal| CLI[CLI Direct]:::interface

    Agent -->|subprocess| Engine[Space Lord Engine]:::engine
    CLI --> Engine

    Engine -->|controller| Router[SaucerSwap V2 Router]:::ext
    Engine -->|HTS| Tokens[Token Transfers]:::ext
    Engine -->|HCS| Signals[On-Chain Signals]:::ext
    Engine -->|SDK| Accounts[Account Management]:::ext

    Router -->|JSON-RPC| Hedera[Hedera Mainnet]:::hedera
    Tokens --> Hedera
    Signals --> Hedera
    Accounts --> Hedera

Loading

Components

Component	Role
🔧 CLI Engine	30+ deterministic commands. Controller → router → executor pipeline.
🔀 SaucerSwap V2 Router	Custom, open-source multi-hop path finding. Direct smart contract calls via JSON-RPC.
🛡️ Governance Engine	Per-swap max, daily max, slippage cap, gas reserve. User-configurable, agent-immutable.
🤖 OpenClaw Agent	Reads SKILL.md, interprets natural language, executes CLI via subprocesses. Light key protection — full sandbox planned.
📊 Power Law Rebalancer	Autonomous daemon for local portfolio rebalancing. Proof of concept while awaiting Hedera Schedule Service.
📡 HCS Publisher	(1) Crowd-sourced bug/telemetry logging for self-healing. (2) Trading signal broadcast for potential monetization.
🧠 Training Pipeline	Records CLI commands + responses as instruction pairs for future LLM fine-tuning.

Interfaces

Interface	Speed	Best for
🤖 OpenClaw Agent (Telegram)	~2-5s	Drives the CLI for you — no commands to remember, no multi-step waits
💻 Terminal CLI	Instant	Scripting, automation, direct control
📊 Dashboard	Real-time	Visual monitoring (to be replaced by OpenClaw's "canvas" feature)

---

🔗 Hedera Integration

Direct to Hedera — no middleware:

Service	Usage
SaucerSwap V2	Direct router/quoter calls via JSON-RPC. Multi-hop path finding.
HTS	Token associations, transfers, approvals via HTS Precompile.
HCS	Signal broadcast, bug telemetry, HCS-10 agent-to-agent messaging.
Mirror Node	Real-time balances, transaction history, key lookups.
Accounts	Multi-account management, creation via Hiero SDK, ECDSA signing.
Staking	HBAR staking/unstaking to consensus nodes.

---

🎯 Features at a Glance

• 🔄 Token Swaps — Natural language ("swap 10 USDC for HBAR") → SaucerSwap V2 smart contracts
• 💰 Portfolio Management — Real-time balances, USD values, transaction history, NFT viewer
• 📤 Self-Custody Transfers — Whitelisted destinations only. EVM addresses blocked.
• 🤖 Autonomous Rebalancing — Power Law daemon auto-rebalances BTC allocation on thresholds
• 📡 On-Chain Signals — Daily HCS heartbeat. Structured JSON. Anyone can subscribe.
• 🛡️ Governance & Safety — One config file. Per-swap limits, slippage caps, gas reserves. Agent can't modify.
• 🧠 Training Data — Every command generates fine-tuning data for future AI models

---

🔒 Security Model

The golden rule: the AI agent never sees your keys.

• 🔐 Keys stored locally in .env, encrypted in memory, decrypted only at signing, then immediately cleared
• 🧠 Agent predicts intent. Deterministic CLI handles the cryptography.
• 📋 Wallet whitelists enforce all transfers — no exceptions
• 🛡️ Governance is read-only to the agent
• ⚡ We never simulate — every transaction is real

---

📚 Hackathon Resources

Resource	Link
🎥 Demo Video	YouTube
📑 Pitch Deck	docs/PITCH_DECK.pdf
📄 Technical Whitepaper	docs/WHITEPAPER_v2.pdf
🔌 ClawHub Skill	clawhub.ai/Chris0x88/pacman-hedera
📡 HCS Signal Topic	0.0.10371598

---

License

MIT

---

Built with real money. Real transactions. Real learnings. 🚀