Gotchi Finder Skill

Find and display any Aavegotchi by ID with complete traits and image.

Features

• - ✅ Instant ID lookup - Fetch any gotchi by ID number
• ✅ Fetch any gotchi by ID from Base mainnet
• ✅ Display full traits (BRS, Kinship, Level, XP, Haunt, Name, Owner)
• ✅ TOTAL BRS - Shows base + wearables modifiers (true power level)
• ✅ Generate PNG images (standard 512x512 or hi-res 1024x1024)
• ✅ Export as SVG (scalable vector graphics)
• ✅ Flexible format options (PNG, hi-res, SVG, or all)
• ✅ Support for all gotchi states (Portal, Gotchi, etc.)
• ✅ Automatic image conversion and delivery

Usage

Default Behavior (ALWAYS)

When you run gotchi-finder, it ALWAYS outputs:

1. 1. 🖼️ Gotchi PNG image (512×512) - sent as photo/media
2. 📊 Stats as caption - displayed below the image

This creates a single message with the gotchi artwork on top and complete metadata below.

Example:
CODEBLOCK0

Output: One Telegram message with:

• - Image at top (PNG)
• Caption below with all stats, traits, and info

Additional Format Options (Optional)

After seeing the default output, users can request additional formats:

CODEBLOCK1

Format Options

• - preview - Show traits + standard PNG (default)
• INLINECODE1 - Standard PNG (512x512)
• INLINECODE2 - Hi-res PNG (1024x1024)
• INLINECODE3 - SVG only (no PNG conversion)
• INLINECODE4 - All formats at once

Examples

Preview first (conversational flow):
CODEBLOCK2

Direct download (skip preview):
CODEBLOCK3

Output Files:

• - gotchi-{ID}.json - Complete metadata (always)
• INLINECODE6 - Vector image (always)
• INLINECODE7 - Standard PNG (preview/png/all)
• INLINECODE8 - Hi-res PNG (hires/all)

Display Format (OFFICIAL)

Live Gotchis (Status 3)

ALWAYS send as single message with media + caption:

Format:
CODEBLOCK4

Caption Template:
CODEBLOCK5

Rarity Tiers:

• - BRS ≥ 580: GODLIKE
• BRS ≥ 525: MYTHICAL
• BRS ≥ 475: UNCOMMON
• BRS < 475: COMMON

Portals (Status 0-1)

Technical Details

Blockchain:

• - Chain: Base mainnet (8453)
• RPC: https://mainnet.base.org
• Diamond: 0xA99c4B08201F2913Db8D28e71d020c4298F29dBF

Dependencies:

• - Node.js with ethers v6
• Sharp library for image conversion

Status Codes:

• - 0: Unopened Portal
• 1: Opened Portal
• 2: Gotchi (rare on Base)
• 3: Gotchi (standard on Base)

Files

• - scripts/show-gotchi.sh - Display gotchi (RECOMMENDED) - Shows PNG + stats in single message
• INLINECODE10 - Fetch and convert (advanced usage)
• INLINECODE11 - Fetch from blockchain
• INLINECODE12 - Convert SVG to PNG
• INLINECODE13 - Node dependencies

For OpenClaw Agents

Use show-gotchi.sh - it outputs the exact format needed for the message tool:

CODEBLOCK6

Output:
CODEBLOCK7

Then use:
CODEBLOCK8

Installation

CODEBLOCK9

Examples

Find your gotchi:
CODEBLOCK10

Find any gotchi:
CODEBLOCK11

Find multiple gotchis:

for id in 9638 21785 10052; do
  bash scripts/find-gotchi.sh $id
done

🔒 Security

This skill is 100% SAFE - Read-only! ✅

Security Features

• - ✅ Read-only - No wallet interaction at all
• ✅ No transactions - Cannot modify blockchain state
• ✅ No credentials needed - Public data only
• ✅ No private keys - Zero wallet access
• ✅ Safe for anyone - Cannot cause harm

What This Skill Does

• - ✅ Fetches gotchi data from public subgraph
• ✅ Generates images from public SVG data
• ✅ Displays gotchi traits (read-only)

What This Skill CANNOT Do

• - ❌ Access wallets
• ❌ Sign transactions
• ❌ Modify gotchis
• ❌ Transfer anything
• ❌ Spend money

Data Sources

• - Public subgraph: api.goldsky.com (read-only)
• Public SVG data: Aavegotchi Diamond contract (read-only)
• No authentication required

Privacy

• - ✅ Fetches only PUBLIC gotchi data
• ✅ No wallet addresses exposed
• ✅ No sensitive information

Compliance

• - ✅ ClawHub security standards
• ✅ Read-only best practices
• ✅ Zero-risk skill classification

BRS Calculation (OFFICIAL)

gotchi-finder ALWAYS uses TOTAL BRS = Base BRS + Wearables Modifiers

This shows the gotchi's true power level with all equipped gear!

JSON Output Fields

• - brs - TOTAL BRS (base + wearables) - main field ⭐
• INLINECODE17 - Base BRS only (no wearables)
• INLINECODE18 - Same as baseBrs (from contract)
• INLINECODE19 - Same as brs (from contract)

Example Output

CODEBLOCK13

Console Display:
CODEBLOCK14

Why Total BRS?

• - ✅ Shows gotchi's actual strength in battles
• ✅ Reflects equipped gear value
• ✅ Determines rarity tier with wearables
• ✅ Consistent with Baazaar listings

A MYTHICAL gotchi can become GODLIKE with the right gear! 🔥