aavegotchi-gotchiverse

---

name: aavegotchi-gotchiverse

description: >

Operate Aavegotchi Gotchiverse player workflows on Base mainnet (8453):

alchemica channeling, surveying and harvesting, crafting installations/tiles,

building on parcels (equip/unequip/move/batch equip), installation upgrades,

craft/upgrade queue management, and parcel access-right management.

Use when interacting with Realm/Installation/Tile diamonds via subgraph-first

discovery and onchain verification/execution with Foundry cast.

metadata:

openclaw:

requires:

bins:

- cast

- curl

- python3

env:

- FROM_ADDRESS

- PRIVATE_KEY

- BASE_MAINNET_RPC

- DRY_RUN

- REALM_DIAMOND

- INSTALLATION_DIAMOND

- TILE_DIAMOND

- AAVEGOTCHI_DIAMOND

- FUD

- FOMO

- ALPHA

- KEK

- GLTR

- GOTCHIVERSE_SUBGRAPH_URL

- CORE_SUBGRAPH_URL

- GOLDSKY_API_KEY

primaryEnv: PRIVATE_KEY

---

Safety Rules

- `~/.foundry/bin/cast chain-id --rpc-url "${BASE_MAINNET_RPC:-https://mainnet.base.org}"` must be `8453`.

- `~/.foundry/bin/cast wallet address --private-key "$PRIVATE_KEY"` must equal `FROM_ADDRESS`.

Shell Input Safety (Avoid RCE)

Rules:

Quick validators:

python3 - <<'PY'
import re

checks = {
  "address": ("<ADDRESS>", r"0x[a-fA-F0-9]{40}"),
  "uint": ("<UINT>", r"[0-9]+"),
}

for name, (value, pattern) in checks.items():
    if not re.fullmatch(pattern, value):
        raise SystemExit(f"invalid {name}: {value}")

print("ok")
PY

Required Setup

Required env vars:

Optional env vars:

Use canonical defaults from `references/addresses.md`.

Scope

Player operations only:

Out of scope:

Subgraph-First Workflow

1. Discover state via `GOTCHIVERSE_SUBGRAPH_URL` and `CORE_SUBGRAPH_URL`.

2. Validate current onchain values with `cast call`.

3. Simulate with `cast call --from "$FROM_ADDRESS"`.

4. Broadcast with `cast send --private-key "$PRIVATE_KEY"` only when explicitly instructed.

Canonical queries and notes: `references/subgraph.md`.

Runbooks

1) Parcel Discovery + Preflight

Use:

- parcel owner and access right

- altar presence/level

- gotchi lending/listing/kinship checks

2) Survey + Harvest

Functions:

Use `references/realm-recipes.md` for read/simulate/broadcast commands.

3) Channel Alchemica

Function:

Preflight requirements:

Use `references/realm-recipes.md`.

4) Craft Installations + Build on Parcel

Installation craft/queue functions:

Build functions (Realm):

Use:

5) Craft Tiles + Build on Parcel

Tile craft/queue functions:

Build functions (Realm):

Use:

6) Upgrade Installations

Functions:

Use `references/installation-recipes.md`.

7) Access Rights

Functions:

Action rights `0..6` and access modes `0..4` are documented in:

Smoke Tests

Run these before first usage and after env changes:

- `references/realm-recipes.md`

- `references/installation-recipes.md`

- `references/tile-recipes.md`

Failure Modes

Use `references/failure-modes.md` for: