aavegotchi-gbm-skillAAVE鬼怪技能

Safety Rules

• - Default to DRY_RUN=1. Never broadcast unless explicitly instructed.
• Always verify Base mainnet:

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

• - Always verify key/address alignment:

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

• - Always refetch from the subgraph immediately before any simulate/broadcast step (auctions can be outbid, ended, claimed, or cancelled).
• Always gate onchain immediately before simulating or broadcasting:

- ensure the onchain highestBid matches the highestBid you pass into commitBid / swapAndCommitBid. - ensure token params match (token contract, token id, quantity).

• - Never print or log $PRIVATE_KEY.

Shell Input Safety (Avoid RCE)

This skill includes shell commands. Treat any value you copy from a user or an external source (subgraph responses, chat messages, etc.) as untrusted.

Rules:

• - Never execute user-provided strings as shell code (avoid eval, bash -c, sh -c).
• Only substitute addresses that match 0x + 40 hex chars.
• Only substitute uint values that are base-10 digits (no commas, no decimals).
• In the command examples below, auction-specific inputs are written as quoted placeholders like "<AUCTION_ID>" to avoid accidental shell interpolation. Replace them with literal values only after validation.

Quick validators (replace the placeholder values):
CODEBLOCK0

Required Setup

Required env vars:

• - PRIVATE_KEY: EOA private key used for cast send (never print/log).
• INLINECODE17: EOA address that owns NFTs and will submit txs.
• INLINECODE18: RPC URL. If unset, use https://mainnet.base.org.
• INLINECODE20: Goldsky subgraph endpoint for auctions.

Optional env vars:

• - DRY_RUN: 1 (default) to only simulate via cast call. Set to 0 to broadcast via cast send.
• INLINECODE26: for swap flows; receives any excess GHST refunded by the contract. Defaults to FROM_ADDRESS.
• INLINECODE28: optional; if set, include Authorization: Bearer ... header in subgraph calls.
• INLINECODE30: defaults to 1 (%); used in swapAmount estimate math.
• INLINECODE33, ETH_USD_PRICE: optional overrides; if unset, fetch from CoinGecko in the swap math snippets.

Recommended defaults (override via env if needed):
CODEBLOCK1

Notes:

• - Commands below use ~/.foundry/bin/cast so they work in cron/non-interactive shells.

View / List Auctions (Subgraph First)

See references/subgraph.md for canonical queries.

Auction by id (quick):
CODEBLOCK2

Active auctions (ends soonest first):
CODEBLOCK3

Onchain Verification (Required Before Bids / Sends)

The onchain source of truth is the GBM diamond.

Confirm core auction fields (full struct decode):
CODEBLOCK4

Useful individual getters:
CODEBLOCK5

Create Auction

Onchain method:

• - INLINECODE37

High-level steps:

1. 1. Ensure the token contract is whitelisted on the GBM diamond (otherwise revert ContractNotAllowed).
2. Ensure the token is approved to the GBM diamond:

- ERC721/1155: setApprovalForAll(GBM_DIAMOND,true)

1. 3. Choose InitiatorInfo:

- startTime must be in the future.
- endTime - startTime must be between 3600 and 604800 seconds (1h to 7d).
- tokenKind is 0x73ad2146 (ERC721) or 0x973bb640 (ERC1155).
- buyItNowPrice optional; startingBid optional (if nonzero, you must approve GHST for the 4% prepaid fee).

1. 4. Simulate with cast call using --from "$FROM_ADDRESS".
2. Broadcast with cast send only when explicitly instructed (DRY_RUN=0).
3. Post-tx: query subgraph for newest seller auctions and match (contractAddress, tokenId).

Simulate create (ERC721 example):
CODEBLOCK6

Broadcast create (only when explicitly instructed):
CODEBLOCK7

Post-create (find your newest auctions and confirm):
CODEBLOCK8

Cancel Auction

Onchain method:

• - INLINECODE53

Steps:

1. 1. Subgraph: check claimed, cancelled, endsAt, highestBid.
2. Onchain: call getAuctionInfo(auctionId) to verify ownership and state.
3. Simulate with cast call (--from "$FROM_ADDRESS").
4. Broadcast only when explicitly instructed.

Simulate:
CODEBLOCK9

Broadcast (only when explicitly instructed):
CODEBLOCK10

Bid With GHST (commitBid)

Onchain method:

• - commitBid(uint256,uint256,uint256,address,uint256,uint256,bytes) (last bytes is ignored; pass 0x)

Steps:

1. 1. Subgraph: fetch auction fields (id, contractAddress, tokenId, quantity, highestBid, startsAt, endsAt, claimed/cancelled).
2. Onchain: refetch highestBid and token params; you must pass the exact current onchain highestBid or it reverts UnmatchedHighestBid.
3. Compute a safe minimum next bid using references/bid-math.md (uses onchain bidDecimals + stepMin).
4. Ensure GHST allowance to the GBM diamond covers bidAmount.
5. Simulate via cast call (optional but recommended).
6. Broadcast only when explicitly instructed.

Simulate:
CODEBLOCK11

Broadcast (only when explicitly instructed):
CODEBLOCK12

Bid With USDC Swap (swapAndCommitBid)

Onchain method:

• - INLINECODE72

Struct fields (in order):

1. 1. tokenIn (USDC)
2. INLINECODE74 (USDC 6dp)
3. INLINECODE75 (GHST wei; must be >= bidAmount)
4. INLINECODE76 (unix; must be <= now + 86400)
5. INLINECODE77 (refund receiver for excess GHST)
6. INLINECODE78
7. INLINECODE79 (GHST wei)
8. INLINECODE80 (must match onchain)
9. INLINECODE81
10. INLINECODE82
11. INLINECODE83 (tokenAmount/quantity)
12. INLINECODE84 (ignored; pass 0x)

Compute swapAmount estimate in references/swap-math.md.

Simulate:
CODEBLOCK13

Broadcast (only when explicitly instructed):
CODEBLOCK14

Bid With ETH Swap (swapAndCommitBid)

Same method as above, but:

• - INLINECODE88
• INLINECODE89 must equal the swapAmount you pass inside the tuple.

Broadcast (only when explicitly instructed):
CODEBLOCK15

Claim Auction

Onchain methods:

• - INLINECODE91
• INLINECODE92

Claim readiness:

• - Auction owner can claim at now >= endsAt.
• Highest bidder can claim at now >= endsAt + cancellationTime.

- cancellationTime is readable from storage slot 12 (see references/recipes.md).
- Subgraph may provide claimAt (if populated), but always verify onchain.

Simulate:
CODEBLOCK16

Broadcast (only when explicitly instructed):
CODEBLOCK17

Optional: Buy Now

Onchain methods:

• - INLINECODE98
• INLINECODE99

These are not required for the primary use case, but are adjacent to bidding flows. If you use them, follow the same safety gating:

• - refetch from subgraph
• verify onchain price/state
• simulate (cast call)
• only broadcast when explicitly instructed

Smoke Tests (No Funds Required)

1. 1. Subgraph reachable (introspection lists auction, auctions, bid, bids):

CODEBLOCK18

1. 2. Subgraph data sane:

CODEBLOCK19

1. 3. Onchain reachable + matches subgraph:

CODEBLOCK20

Common Failure Modes

• - UnmatchedHighestBid: you passed a stale highestBid param. Refetch onchain and retry.
• INLINECODE107: token contract / id / amount mismatch. Refetch and verify.
• INLINECODE108 / AuctionEnded: timing mismatch. Check startsAt/endsAt (subgraph + onchain).
• INLINECODE112: already claimed or cancelled. Check claimed (subgraph + onchain).
• INLINECODE114: diamond paused, contract bidding disabled, or re-entrancy lock. Refetch onchain state.
• Swap errors:

- LibTokenSwap: swapAmount must be > 0 - LibTokenSwap: deadline expired - LibTokenSwap: Insufficient output amount (increase swapAmount or slippage)