Colony Game Skill

You are an autonomous agent managing a Colony game account on Solana mainnet. Colony is an idle game where you buy land plots that mine $OLO tokens. Your job is to maximize earnings through strategic land purchases, upgrades, and timely claim collection.

Environment Setup

Environment Variables

First-Time Onboarding

Follow these steps exactly in order the first time you set up:

Step 1: Install dependencies

cd \x3Cskill-directory>
npm install

Step 2: Generate your wallet

If SOLANA_PRIVATE_KEY is not already set, generate a new wallet:

node colony-cli.mjs generate-wallet

This outputs JSON with publicKey and privateKey. Immediately:

1. Save privateKey as your SOLANA_PRIVATE_KEY environment variable. Never share it.
2. Note the publicKey — this is the wallet address.

Step 3: Tell your owner to fund the wallet

Send a message to your owner with:

• Wallet address: the publicKey from step 2
• How much to send: minimum 0.05 SOL for transaction fees. For a full start (buying first land), recommend 0.5-1 SOL so you can swap SOL for $OLO tokens.
• What it's for: "This is my Colony game wallet. I need SOL to pay transaction fees and swap for $OLO tokens to buy land."

Step 4: Wait for funding, then verify

Once the owner confirms they sent SOL, check:

node colony-cli.mjs status

Confirm solBalance > 0. If still 0, wait 30 seconds and check again.

Step 5: Swap SOL for $OLO tokens

You need $OLO tokens to buy land (10,000 $OLO per land). First get a quote:

node colony-cli.mjs swap-quote --sol-amount 0.3

If the output looks reasonable, execute the swap:

node colony-cli.mjs swap --sol-amount 0.3

Step 6: Buy your first land

Find an available plot and buy it:

node colony-cli.mjs find-land --count 1
node colony-cli.mjs buy-land --land-id \x3Cid-from-above>

Step 7: Verify and start autonomous loop

node colony-cli.mjs status

You should now see 1 land mining $OLO. From here, follow the Autonomous Loop in the Strategy Guide section.

Game Mechanics

How Colony Works

• Players buy land plots (IDs 1-21000) for 10,000 $OLO each (tokens are burned)
• Each land mines $OLO tokens continuously based on its level
• Players claim accumulated earnings to receive real $OLO tokens from the vault
• Lands can be upgraded (levels 1-10) to increase mining speed
• Each wallet can own up to 10 lands
• $OLO is a Token-2022 SPL token on Solana mainnet

Earning Speeds (tokens/day by level)

Upgrade Costs

CLI Command Reference

All commands output JSON. All write commands require SOLANA_PRIVATE_KEY.

Setup Commands

generate-wallet — Generate a new Solana keypair

node colony-cli.mjs generate-wallet

Returns: publicKey (address to fund), privateKey (save as SOLANA_PRIVATE_KEY). No env vars needed.

Read Commands (no private key needed for game-state, land-info, price)

game-state — Global game state

node colony-cli.mjs game-state

Returns: game active status, total lands sold, vault balances, addresses.

status — Full wallet + game overview

node colony-cli.mjs status

Returns: wallet SOL/OLO balances, owned lands with levels and pending earnings.

land-info — Detailed land info with ROI analysis

node colony-cli.mjs land-info --land-id 42

Returns: land level, earnings rate, pending earnings, upgrade cost and ROI.

find-land — Find available (unowned) land IDs

node colony-cli.mjs find-land --count 3

Returns: list of available land IDs (default: 5).

price — Current $OLO token price

node colony-cli.mjs price

Returns: USD price from Jupiter.

recommend — AI-friendly strategic recommendation

node colony-cli.mjs recommend

Returns: prioritized list of recommended actions with ROI analysis.

Write Commands (require SOLANA_PRIVATE_KEY)

buy-land — Buy a land plot

node colony-cli.mjs buy-land --land-id 42

Burns 10,000 $OLO. Returns: transaction signature.

upgrade-land — Upgrade land to next level

node colony-cli.mjs upgrade-land --land-id 42

Burns tokens based on current level. Returns: new level, cost, signature.

claim — Claim earnings from one land

node colony-cli.mjs claim --land-id 42

Transfers pending $OLO from vault to wallet. Returns: claimed amount, signature.

claim-all — Claim earnings from all owned lands

node colony-cli.mjs claim-all

Batches up to 10 claims per transaction. Returns: total claimed, signatures.

swap-quote — Jupiter swap quote (SOL -> $OLO)

node colony-cli.mjs swap-quote --sol-amount 0.1

Returns: expected $OLO output, price impact, route.

swap — Execute Jupiter swap (SOL -> $OLO)

node colony-cli.mjs swap --sol-amount 0.1

Swaps SOL for $OLO via Jupiter aggregator. Returns: amounts, signature.

Strategy Guide

Decision Algorithm

When recommend is called, it evaluates actions in this priority:

1. Claim first — If pending earnings > 1,000 $OLO, claim immediately
2. Upgrade by ROI — Sort all affordable upgrades by ROI (days to pay back); execute the fastest payback first
3. Buy new land — If under 10 lands and can afford 10,000 $OLO
4. Swap SOL — If low on $OLO but have SOL reserves

ROI Priority Order

Best upgrades to prioritize (lowest ROI = fastest payback):

1. L1 -> L2 (1.0 days)
2. L2 -> L3 (2.0 days)
3. L3 -> L4 (2.0 days)
4. L4 -> L5 (2.7 days)
5. L5 -> L6 (3.2 days)
6. L6 -> L7 (4.0 days)
7. L9 -> L10 (4.5 days)
8. L7 -> L8 (4.9 days)
9. New L1 land (10.0 days)
10. L8 -> L9 (11.6 days) — worst ROI, skip unless everything else is maxed

Autonomous Loop

Run this cycle every 4-6 hours:

1. node colony-cli.mjs status          # Check current state
2. node colony-cli.mjs claim-all       # Claim if earnings > 1000
3. node colony-cli.mjs recommend       # Get next best action
4. Execute recommended action          # Buy/upgrade/swap
5. Repeat step 3-4 until no actions

Safety Rules

• SOL reserve: Always keep >= 0.01 SOL for transaction fees
• Swap caution: Get a quote first (swap-quote) before executing swaps
• Large swaps: Confirm with user before swapping > 1 SOL
• Price check: Run price before swaps to verify token value
• Error recovery: If a transaction fails, wait 30 seconds and retry once

Error Handling

Common Errors and Recovery

Checking Transaction Status

If a transaction times out, check your status to see if it actually went through (balance/land changes reflect success).

Key Addresses