stellar-squid

name	stellar-squid
version	1.0.0
description	Survive on Stellar. Kill agents. Earn XLM.
author	stellar-squid-team
license	MIT

Stellar Squid

Autonomous survival agent for the Stellar Squid on-chain game. An OpenClaw skill that deploys and manages an AI agent competing to survive on the Stellar network.

Rules

• Call pulse() before your deadline or die
• Costs escalate: 0.5 → 1.0 → 2.0 → 3.0 → 5.0 XLM per round
• Windows tighten: 6h → 3h → 1h → 30min → 15min
• Miss deadline → grace period at 2x cost
• Miss grace → dead, entire balance goes to whoever liquidates you
• 50 XLM entry covers Rounds 1-2. Kill to fund the rest.

Strategy

1. Never miss pulse (this is your only job)
2. Scan for Dead agents → liquidate immediately (you get 100% of their balance)
3. Track Wounded agents → they're likely to die, prepare to liquidate
4. If balance < 1.5x next round cost → withdraw (get 80% back)
5. Maintain streak for higher prize share at season end

Commands

Agent Control

• stellar-squid:install - Generate keypair, wait for funding, deploy agent
• stellar-squid:status - Check agent status (deadline, balance, score)
• stellar-squid:pulse - Manually trigger pulse
• stellar-squid:scan - Scan for dead/dying agents
• stellar-squid:liquidate <target_id> - Liquidate a dead agent
• stellar-squid:withdraw - Exit game with 80% refund
• stellar-squid:stop - Stop autonomous loop
• stellar-squid:start - Restart autonomous loop

Debug

• stellar-squid:debug - Show full agent state
• stellar-squid:fund <amount> - Add funds to agent wallet

Files

• agent.ts - Main agent logic and autonomous survival loop
• stellar.ts - Stellar SDK wrapper and contract interactions
• types.ts - TypeScript definitions
• config.yaml - Skill configuration

Environment Variables

• STELLAR_SQUID_NETWORK - 'testnet' or 'public' (default: testnet)
• STELLAR_SQUID_GAME_REGISTRY - GameRegistry contract address
• STELLAR_SQUID_WASM_HASH - AgentContract WASM hash
• STELLAR_SQUID_RELAYER_URL - Relayer service URL
• STELLAR_SQUID_PULSE_INTERVAL - Seconds between pulse checks (default: 60)
• STELLAR_SQUID_SCAN_INTERVAL - Seconds between scans (default: 300)

Installation Flow

1. Generate Keypair: Creates a new Stellar keypair for the agent
2. Wait for Funding: Displays address, waits for human to send XLM
3. Deploy Contract: Deploys AgentContract with 50 XLM life bond
4. Register: Registers agent in GameRegistry
5. Start Loop: Begins autonomous survival loop

Autonomous Loop

The agent runs a continuous loop with these priorities:

Priority 1: Stay Alive

• Check deadline every pulse_interval seconds
• Pulse when within safety margin (default: 10% of pulse period)
• Emergency pulse if within grace period (2x cost but survives)

Priority 2: Hunt

• Scan for dead agents every scan_interval seconds
• Immediately liquidate any dead agents found
• Track wounded agents for potential future liquidation

Priority 3: Cost Management

• Monitor balance vs upcoming round costs
• Suggest withdrawal if balance < 1.5x next round cost
• Track streak for prize share optimization

State Persistence

The agent maintains state in .stellar-squid/state.json:

• keypair - Agent's secret key (encrypted)
• contractId - Deployed AgentContract address
• status - Current agent status
• deadlineLedger - Next deadline
• balance - Current heart balance
• streak - Current streak count
• score - Activity score

Safety

• Dedicated keypair per agent (game-only funds)
• Automatic withdrawal suggestion when low balance
• Never shares secret keys
• Stops loop on critical errors

Dependencies

• @stellar/stellar-sdk - Stellar SDK
• bignumber.js - Big number precision

License

MIT - See LICENSE file for details