aavegotchi-gbm-skill
View, create, cancel, bid, and claim Aavegotchi GBM auctions on Base mainnet (8453). Subgraph-first discovery (Goldsky), with onchain verification + execution via Foundry cast.
Install / Use
npx skills add LeoYeAI/openclaw-master-skills --skill aavegotchi-gbm-skillInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of aavegotchi-gbm-skill
aavegotchi-gbm-skill scores 90/100 on our quality scale, 1352nd of 4,698 Development & Engineering skills we index (top 29%).
Its SKILL.md is 16 KB long, well organised into 14 sections with 21 code examples: a thorough specification that gives an agent plenty to work with.
With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
aavegotchi-gbm-skill compared with similar skills
All 4 of these similar skills score higher than aavegotchi-gbm-skill; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| aavegotchi-gbm-skill (this skill)by LeoYeAI | 90 | 2.1k | 4mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install aavegotchi-gbm-skill?
- Run
npx skills add LeoYeAI/openclaw-master-skills --skill aavegotchi-gbm-skill. The install tabs above show the steps for each supported agent. - Which AI agents does aavegotchi-gbm-skill work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is aavegotchi-gbm-skill safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is aavegotchi-gbm-skill still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: aavegotchi-gbm-skill description: > View, create, cancel, bid, and claim Aavegotchi GBM auctions on Base mainnet (8453). Subgraph-first discovery (Goldsky), with onchain verification + execution via Foundry cast. Safety-first: DRY_RUN defaults to 1 (simulate with cast call; only broadcast with cast send when DRY_RUN=0 and explicitly instructed). homepage: https://github.com/aavegotchi/aavegotchi-gbm-skill metadata: openclaw: requires: bins: - cast - curl - python3 env: - FROM_ADDRESS - PRIVATE_KEY - BASE_MAINNET_RPC - DRY_RUN - RECIPIENT_ADDRESS - GBM_SUBGRAPH_URL - GOLDSKY_API_KEY - GBM_DIAMOND - GHST - USDC - SLIPPAGE_PCT - GHST_USD_PRICE - ETH_USD_PRICE primaryEnv: PRIVATE_KEY
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 be8453.
- 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
highestBidmatches thehighestBidyou pass intocommitBid/swapAndCommitBid. - ensure token params match (token contract, token id, quantity).
- ensure the onchain
- 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):
python3 - <<'PY'
import re
auction_id = "<AUCTION_ID>" # digits only
token_contract = "<TOKEN_CONTRACT_ADDRESS>" # 0x + 40 hex chars
token_id = "<TOKEN_ID>" # digits only
amount = "<TOKEN_AMOUNT>" # digits only
if not re.fullmatch(r"[0-9]+", auction_id):
raise SystemExit("AUCTION_ID must be base-10 digits only")
if not re.fullmatch(r"0x[a-fA-F0-9]{40}", token_contract):
raise SystemExit("TOKEN_CONTRACT_ADDRESS must be a 0x + 40-hex address")
if not re.fullmatch(r"[0-9]+", token_id):
raise SystemExit("TOKEN_ID must be base-10 digits only")
if not re.fullmatch(r"[0-9]+", amount):
raise SystemExit("TOKEN_AMOUNT must be base-10 digits only")
print("ok")
PY
Required Setup
Required env vars:
PRIVATE_KEY: EOA private key used forcast send(never print/log).FROM_ADDRESS: EOA address that owns NFTs and will submit txs.BASE_MAINNET_RPC: RPC URL. If unset, usehttps://mainnet.base.org.GBM_SUBGRAPH_URL: Goldsky subgraph endpoint for auctions.
Optional env vars:
DRY_RUN:1(default) to only simulate viacast call. Set to0to broadcast viacast send.RECIPIENT_ADDRESS: for swap flows; receives any excess GHST refunded by the contract. Defaults toFROM_ADDRESS.GOLDSKY_API_KEY: optional; if set, includeAuthorization: Bearer ...header in subgraph calls.SLIPPAGE_PCT: defaults to1(%); used inswapAmountestimate math.GHST_USD_PRICE,ETH_USD_PRICE: optional overrides; if unset, fetch from CoinGecko in the swap math snippets.
Recommended defaults (override via env if needed):
export BASE_MAINNET_RPC="${BASE_MAINNET_RPC:-https://mainnet.base.org}"
export GBM_DIAMOND="${GBM_DIAMOND:-0x80320A0000C7A6a34086E2ACAD6915Ff57FfDA31}"
export GHST="${GHST:-0xcD2F22236DD9Dfe2356D7C543161D4d260FD9BcB}"
export USDC="${USDC:-0x833589fCD6eDb6E08f4c7C32D4f71b54BDA02913}"
export GBM_SUBGRAPH_URL="${GBM_SUBGRAPH_URL:-https://api.goldsky.com/api/public/project_cmh3flagm0001r4p25foufjtt/subgraphs/aavegotchi-gbm-baazaar-base/prod/gn}"
export DRY_RUN="${DRY_RUN:-1}"
export SLIPPAGE_PCT="${SLIPPAGE_PCT:-1}"
Notes:
- Commands below use
~/.foundry/bin/castso they work in cron/non-interactive shells.
View / List Auctions (Subgraph First)
See references/subgraph.md for canonical queries.
Auction by id (quick):
curl -s "$GBM_SUBGRAPH_URL" -H 'content-type: application/json' ${GOLDSKY_API_KEY:+-H "Authorization: Bearer $GOLDSKY_API_KEY"} --data '{
"query":"query($id:ID!){ auction(id:$id){ id type contractAddress tokenId quantity seller highestBid highestBidder totalBids startsAt endsAt claimAt claimed cancelled presetId category buyNowPrice startBidPrice } }",
"variables":{"id":"<AUCTION_ID>"}
}'
Active auctions (ends soonest first):
NOW=$(date +%s)
curl -s "$GBM_SUBGRAPH_URL" -H 'content-type: application/json' ${GOLDSKY_API_KEY:+-H "Authorization: Bearer $GOLDSKY_API_KEY"} --data "{
\"query\":\"query(\$now:BigInt!){ auctions(first:20, orderBy: endsAt, orderDirection: asc, where:{claimed:false, cancelled:false, startsAt_lte:\$now, endsAt_gt:\$now}){ id type contractAddress tokenId quantity highestBid highestBidder totalBids startsAt endsAt claimAt presetId category seller } }\",
\"variables\":{\"now\":\"$NOW\"}
}"
Onchain Verification (Required Before Bids / Sends)
The onchain source of truth is the GBM diamond.
Confirm core auction fields (full struct decode):
~/.foundry/bin/cast call "$GBM_DIAMOND" \
'getAuctionInfo(uint256)((address,uint96,address,uint88,uint88,bool,bool,address,(uint80,uint80,uint56,uint8,bytes4,uint256,uint96,uint96),(uint64,uint64,uint64,uint64,uint256),uint96,uint96))' \
"<AUCTION_ID>" \
--rpc-url "$BASE_MAINNET_RPC"
Useful individual getters:
~/.foundry/bin/cast call "$GBM_DIAMOND" 'getAuctionHighestBid(uint256)(uint256)' "<AUCTION_ID>" --rpc-url "$BASE_MAINNET_RPC"
~/.foundry/bin/cast call "$GBM_DIAMOND" 'getAuctionHighestBidder(uint256)(address)' "<AUCTION_ID>" --rpc-url "$BASE_MAINNET_RPC"
~/.foundry/bin/cast call "$GBM_DIAMOND" 'getAuctionStartTime(uint256)(uint256)' "<AUCTION_ID>" --rpc-url "$BASE_MAINNET_RPC"
~/.foundry/bin/cast call "$GBM_DIAMOND" 'getAuctionEndTime(uint256)(uint256)' "<AUCTION_ID>" --rpc-url "$BASE_MAINNET_RPC"
~/.foundry/bin/cast call "$GBM_DIAMOND" 'getContractAddress(uint256)(address)' "<AUCTION_ID>" --rpc-url "$BASE_MAINNET_RPC"
~/.foundry/bin/cast call "$GBM_DIAMOND" 'getTokenId(uint256)(uint256)' "<AUCTION_ID>" --rpc-url "$BASE_MAINNET_RPC"
~/.foundry/bin/cast call "$GBM_DIAMOND" 'getTokenKind(uint256)(bytes4)' "<AUCTION_ID>" --rpc-url "$BASE_MAINNET_RPC"
Create Auction
Onchain method:
createAuction((uint80,uint80,uint56,uint8,bytes4,uint256,uint96,uint96),address,uint256)(uint256)
High-level steps:
- Ensure the token contract is whitelisted on the GBM diamond (otherwise revert
ContractNotAllowed). - Ensure the token is approved to the GBM diamond:
- ERC721/1155:
setApprovalForAll(GBM_DIAMOND,true)
- ERC721/1155:
- Choose
InitiatorInfo:startTimemust be in the future.endTime - startTimemust be between 3600 and 604800 seconds (1h to 7d).tokenKindis0x73ad2146(ERC721) or0x973bb640(ERC1155).buyItNowPriceoptional;startingBidoptional (if nonzero, you must approve GHST for the 4% prepaid fee).
- Simulate with
cast callusing--from "$FROM_ADDRESS". - Broadcast with
cast sendonly when explicitly instructed (DRY_RUN=0). - Post-tx: query subgraph for newest seller auctions and match
(contractAddress, tokenId).
Simulate create (ERC721 example):
~/.foundry/bin/cast call "$GBM_DIAMOND" \
'createAuction((uint80,uint80,uint56,uint8,bytes4,uint256,uint96,uint96),address,uint256)(uint256)' \
"(<START_TIME>,<END_TIME>,1,<CATEGORY>,0x73ad2146,<TOKEN_ID>,<BUY_NOW_GHST_WEI>,<STARTING_BID_GHST_WEI>)" \
"<ERC721_CONTRACT_ADDRESS>" "<PRESET_ID>" \
--from "$FROM_ADDRESS" \
--rpc-url "$BASE_MAINNET_RPC"
Broadcast create (only when explicitly instructed):
~/.foundry/bin/cast send "$GBM_DIAMOND" \
'createAuction((uint80,uint80,uint56,uint8,bytes4,uint256,uint96,uint96),address,uint256)(uint256)' \
"(<START_TIME>,<END_TIME>,1,<CATEGORY>,0x73ad2146,<TOKEN_ID>,<BUY_NOW_GHST_WEI>,<STARTING_BID_GHST_WEI>)" \
"<ERC721_CONTRACT_ADDRESS>" "<PRESET_ID>" \
--private-key "$PRIVATE_KEY" \
--rpc-url "$BASE_MAINNET_RPC"
Post-create (find your newest auctions and confirm):
curl -s "$GBM_SUBGRAPH_URL" -H 'content-type: application/json' ${GOLDSKY_API_KEY:+-H "Authorization: Bearer $GOLDSKY_API_KEY"} --data '{
"query":"query($seller:Bytes!){ auctions(first:10, orderBy: createdAt, orderDirection: desc, where:{seller:$seller}){ id type contractAddress tokenId quantity createdAt startsAt endsAt claimed cancelled } }",
"variables":{"seller":"<FROM_ADDRESS_LOWERCASE>"}
}'
Cancel Auction
Onchain method:
cancelAuction(uint256)
Steps:
- Subgraph: check
claimed,cancelled,endsAt,highestBid. - Onchain: call
getAuctionInfo(auctionId)to verify ownership and state. - Simulate with
cast call(--from "$FROM_ADDRESS"). - Broadcast only when explicitly instructed.
Simulate:
~/.foundry/bin/cast call "$GBM_DIAMOND" 'cancelAuction(uint256)' "<AUCTION_ID>" \
--from "$FROM_ADDRESS" \
--rpc-url "$BASE_MAINNET_RPC"
Broadcast (only when explicitly instructed):
~/.foundry/bin/cast send "$GBM_DIAMOND" 'cancelAuction(uint256)' "<AUCTION_ID>" \
--private-key "$PRIVATE_KEY" \
--rpc-url "$BASE_MAINNET_RPC"
Bid With GHST (commitBid)
Onchain method:
commitBid(uint256,uint256,uint256,address,uint256,uint256,bytes)(lastbytesis ignored; pass0x)
Steps:
- Subgraph: fetch auction fields (id, contractAddress, tokenId, quantity, highestBid, startsAt, endsAt, claimed/cancelled).
- Onchain: refetch
highestBidand token params; you must pass the exact current onchainhighestBidor it revertsUnmatchedHighestBid. - Compute a safe minimum next bid using
references/bid-math.md(uses onchainbidDecimals+stepMin). - Ensure GHST allowance to the GBM diamond covers
bidAmount. - Simulate via
cast call(optional but recommended). - Broadcast only when explicitly instructed.
Simulate:
~/.foundry/bin/cast call "$GBM_DIAMOND" \
'commitBid(uint256,uint256,uint256,address,uint256,uint256,bytes)' \
"<AUCTION_ID>" "<BID_AMOUNT_GHST_WEI>" "<HIGHEST_BID_GHST_WEI>" "<TOKEN_CONTRACT_ADDRESS>" "<TOKEN_ID>" "<TOKEN_AMOUNT>" 0x \
--from "$FROM_ADDRESS" \
--rpc-url "$BASE_MAINNET_RPC"
Broadcast (only when explicitly instructed):
~/.foundry/bin/cast send "$GBM_DIAMOND" \
'commitBid(uint256,uint256,uint256,address,uint256,uint256,bytes)' \
"<AUCTION_ID>" "<BID_AMOUNT_GHST_WEI>" "<HIGHEST_BID_GHST_WEI>" "<TOKEN_CONTRACT_ADDRESS>" "<TOKEN_ID>" "<TOKEN_AMOUNT>" 0x \
--private-key "$PRIVATE_KEY" \
--rpc-url "$BASE_MAINNET_RPC"
Bid With USDC Swap (swapAndCommitBid)
Onchain method:
swapAndCommitBid((address,uint256,uint256,uint256,address,uint256,uint256,uint256,address,uint256,uint256,bytes))
Struct fields (in order):
tokenIn(USDC)swapAmount(USDC 6dp)minGhstOut(GHST wei; must be >= bidAmount)swapDeadline(unix; must be <= now + 86400)recipient(refund receiver for excess GHST)auctionIDbidAmount(GHST wei)highestBid(must match onchain)tokenContracttokenIDamount(tokenAmount/quantity)_signature(ignored; pass0x)
Compute swapAmount estimate in references/swap-math.md.
Simulate:
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
