superrare-mint

Mint aaigotchi art into a SuperRare-compatible ERC-721 contract using Bankr signing.

Required mint choice

Before any mint, aaigotchi must clearly choose and state one of these modes:

• ownership-given
  • mint into an existing collection already owned or handed over by a SuperRare artist
  • requires --contract or config.json collectionContract
• own-deployed
  • mint into a collection deployed through superrare-deploy
  • requires a superrare-deploy receipt, either explicit or auto-resolved

Do not broadcast a mint without an explicit contract mode.

Scripts

• ./scripts/pin-metadata.mjs --name ... --description ... --image ... [--video ...] [--tag ...] [--attribute trait=value]
  • Uploads media to SuperRare and pins metadata.
  • Prints JSON including tokenUri and gatewayUrl.
• ./scripts/mint-via-bankr.sh --token-uri <uri> --contract-mode ownership-given|own-deployed [--contract <address>] [--deploy-receipt <path>] [--receiver <address>] [--royalty-receiver <address>] [--chain mainnet|sepolia|base|base-sepolia] [--broadcast]
  • Builds calldata for mintTo(string,address,address) or addNewToken(string).
  • Refuses to run without a clear contract mode.
  • Prints the chosen mode and collection source before any broadcast.
  • Validates that an own-deployed receipt matches the selected chain.
  • Defaults to dry-run unless --broadcast is passed or DRY_RUN=0.
  • Submits without waiting on Bankr, then polls chain directly for the receipt.
  • Writes a JSON receipt on successful broadcast.
• ./scripts/mint-art.sh --name ... --description ... --image ... --contract-mode ownership-given|own-deployed [options]
  • End-to-end wrapper: upload metadata, then mint via Bankr.
  • Use --metadata-only to stop after pinning and print the token URI.

Config

Default config path:

• config.json in this skill directory

Override with:

• SUPER_RARE_CONFIG_FILE=/path/to/config.json

Expected keys:

• chain: mainnet, sepolia, base, or base-sepolia
• contractMode: ownership-given or own-deployed
• collectionContract
• deployReceiptFile (optional explicit path to a superrare-deploy receipt)
• receiver
• royaltyReceiver
• rpcUrl
• apiBaseUrl
• descriptionPrefix

Defaults and safety

• Dry-run is the default. Mint transactions only broadcast with --broadcast or DRY_RUN=0.
• Supported chains are mainnet, sepolia, base, and base-sepolia.
• Broadcast mode uses a short Bankr submit timeout and then waits for the onchain receipt directly, which avoids hanging on long confirmation waits.
• mint-art.sh still uploads media/metadata to SuperRare before the dry-run mint preview. Use --metadata-only if you want to stop after pinning and inspect the token URI.
• If neither receiver nor royaltyReceiver is set, the skill calls addNewToken(string).
• If either receiver field is provided, the skill calls mintTo(string,address,address).
• If only one of receiver or royaltyReceiver is set, the other defaults to the same address.
• Successful broadcasts write receipts into receipts/.

Deploy receipt auto-resolution

In own-deployed mode, the skill looks for a deploy receipt in this order:

1. --deploy-receipt
2. SUPER_RARE_DEPLOY_RECEIPT_FILE
3. config.json deployReceiptFile
4. the latest receipt in a sibling superrare-deploy/receipts/ directory

The resolved deploy receipt must match the selected mint chain.

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
5. ~/.bankr/config.json

Quick use

cp config.example.json config.json

./scripts/mint-via-bankr.sh \
  --token-uri ipfs://... \
  --contract-mode ownership-given \
  --contract 0xYourArtistGivenCollection \
  --broadcast

./scripts/mint-via-bankr.sh \
  --token-uri ipfs://... \
  --contract-mode own-deployed \
  --chain base \
  --deploy-receipt ../superrare-deploy/receipts/2026-03-15T00-00-00Z-superrare-deploy.json \
  --broadcast

./scripts/mint-art.sh \
  --name "aaigotchi genesis #1" \
  --description "First aaigotchi genesis mint" \
  --image ./art.png \
  --contract-mode own-deployed \
  --chain base \
  --broadcast

Timeouts

Optional environment variables:

• BANKR_SUBMIT_TIMEOUT_SECONDS (default 60)
• RECEIPT_WAIT_TIMEOUT_SECONDS (default 300)
• RECEIPT_POLL_INTERVAL_SECONDS (default 5)