gotchi-channeling

# gotchi-channeling

Channel Alchemica for configured gotchi/parcel pairs.

## Scripts

- `./scripts/check-cooldown.sh <gotchi-id>`
  - Outputs `ready:0` or `waiting:<seconds>`.
  - Fails if RPC query fails.
- `./scripts/channel.sh <gotchi-id> <parcel-id>`
  - Validates cooldown, submits tx via Bankr, prints tx hash.
- `./scripts/channel-all.sh`
  - Iterates `config.json` pairs and channels only ready gotchis.

## Config

`config.json` keys:
- `realmDiamond`
- `rpcUrl`
- `chainId`
- `channeling[]` entries: `{ "parcelId": "...", "gotchiId": "...", "description": "..." }`

Optional env:
- `GOTCHI_CHANNELING_CONFIG_FILE` override config path.
- `BASE_MAINNET_RPC` overrides `rpcUrl`.

## Bankr API key resolution

1. `BANKR_API_KEY`
2. `systemctl --user show-environment`
3. `~/.openclaw/skills/bankr/config.json`
4. `~/.openclaw/workspace/skills/bankr/config.json`

## Quick use

```bash
./scripts/check-cooldown.sh 9638
./scripts/channel.sh 9638 867
./scripts/channel-all.sh
```

## Safety notes

- Cooldown enforced at 24h (`86400` seconds).
- Scripts fail closed on RPC/config/tool errors.
- Batch mode exits non-zero when any entry fails.

# Gotchi Channeling

Automate Aavegotchi Alchemica channeling on Base via Bankr wallet submission.

## Scripts

- `./scripts/check-cooldown.sh <gotchi-id>`
  - Returns `ready:0` or `waiting:<seconds>`
- `./scripts/channel.sh <gotchi-id> <parcel-id>`
  - Channels one gotchi if cooldown is ready
- `./scripts/channel-all.sh`
  - Reads `config.json` and channels all ready entries

## Requirements

- `cast` (Foundry)
- `jq`
- `curl`
- Bankr API key

Bankr API key resolution order:
1. `BANKR_API_KEY`
2. user systemd environment (`systemctl --user show-environment`)
3. `~/.openclaw/skills/bankr/config.json`
4. `~/.openclaw/workspace/skills/bankr/config.json`

## Config

Default config path: `./config.json`
Override path: `GOTCHI_CHANNELING_CONFIG_FILE=/path/to/config.json`

Example:

```json
{
  "realmDiamond": "0x4B0040c3646D3c44B8a28Ad7055cfCF536c05372",
  "rpcUrl": "https://mainnet.base.org",
  "chainId": 8453,
  "channeling": [
    {
      "parcelId": "867",
      "gotchiId": "9638",
      "description": "Primary pair"
    }
  ]
}
```

## Notes

- Cooldown is 24h (`86400` seconds).
- `channel.sh` fails closed if cooldown/RPC checks fail.
- `channel-all.sh --help` is non-destructive.