核心功能
Gotchi Finder 是一款针对 Base 主网 Aavegotchi NFT 的专用查询工具，通过链上 Diamond 合约（0xA99c4B...9dBF）实时获取任意 ID 的 Gotchi 完整数据，包括 SVG 原生图像、BRS/Kinship/Level/XP 等核心属性，以及六种特质（Energy、Aggression、Spookiness 等）。工具支持智能格式转换，可将链上 SVG 自动渲染为 512×512 标准 PNG 或 1024×1024 高清版本，同时保留原始矢量文件。
显著优点
- 原生链上渲染：直接从区块链获取 SVG 数据，非第三方 API，确保图像真实性与所有权可验证
- 多格式灵活输出：支持 preview/png/hires/svg/all 五种模式，适应收藏展示、打印输出、二次编辑等不同场景
- 完整元数据捕获：除图像外同步提取 BRS（稀有度评分）、Kinship（亲密度）、修改后属性、锁仓状态等全量链上信息
- 状态自适应：自动识别 Portal（未开启/已开启）与 Gotchi（状态 2/3）两种形态，分别优化展示逻辑
- 零配置开箱即用：内置 Base mainnet RPC 端点，仅需
BASE_MAINNET_RPC环境变量即可运行
潜在局限
- 网络依赖性强：必须配置有效的 Base 主网 RPC，公共节点存在速率限制或稳定性风险
- 本地渲染开销：SVG→PNG 转换依赖 Node.js + Sharp 库，大规模批量查询时内存与 CPU 占用显著
- 无历史数据：仅支持当前链上状态查询，无法追溯历史持有者或交易记录
- Gotchi ID 需已知：不支持按钱包地址批量列举，用户必须主动提供具体 NFT ID
- Base 链专属：不兼容 Ethereum 主网或 Polygon 上的历史 Aavegotchi 资产
适用人群
- Aavegotchi 收藏者验证资产真伪与稀有度
- NFT 交易员快速生成高清展示图用于二级市场上架
- 社区运营者批量获取 Gotchi 形象用于内容创作
- 开发者调试 Aavegotchi Diamond 合约交互
常规风险提示
1. RPC 节点安全：建议使用自有 Alchemy/Infura 节点或可信第三方服务，避免在公共 RPC 泄露查询隐私
2. 本地文件残留：运行后生成 gotchi-{ID}.json/svg/png 等临时文件，敏感环境需及时清理
3. 依赖版本锁定：ethers v6 与 Sharp 存在 ABI 兼容性风险，务必通过 npm install 锁定版本
4. 图像版权：生成的 PNG/SVG 仅用于个人展示，商用需遵循 Aavegotchi 官方 IP 授权条款