qrcoin_skill

Overview

This skill lets an agent interact with QR Coin auctions on Base so users can check auction status, view reserve prices, create new bids, or contribute to existing bids. It focuses on the core auction flow: query current token, inspect timing and reserves, approve USDC, and submit createBid or contributeToBid transactions via Bankr. Use it when you want to participate in qrcoin.fun QR code auctions or automate bidding actions.

How this skill works

The skill queries the QR Auction contract on Base to read currentTokenId, auction end time, and reserve prices using JSON-RPC eth_call. For transactions it prepares prompts for Bankr to approve USDC, call createBid(tokenId, url, name) to start a new bid, or call contributeToBid(tokenId, url, name) to add funds to an existing URL. It converts USDC units (6 decimals) and relies on Bankr for encoding, signing, and submission.

When to use it

• You want to find the active auction tokenId before bidding
• Check auction end time and reserve prices before submitting a bid
• Approve USDC allowance to the auction contract on Base
• Create a new URL bid (~11.11 USDC) for a fresh entry
• Contribute to an existing URL bid (~1 USDC) to support someone or increase standing

Best practices

• Always call currentTokenId() first to target the active auction
• Verify auctionEndTime(tokenId) to avoid bidding after the auction ends
• Check createBidReserve() and contributeReserve() (USDC has 6 decimals) before sending funds
• Approve sufficient USDC allowance once; reuse for multiple bids
• Prefer contributeToBid for cost-efficient support of existing URLs

Example use cases

• Query currentTokenId and auctionEndTime to build an auction dashboard
• Approve USDC then createBid(329, "https://example.com", "MyName") via Bankr to start a new entry
• ContributeToBid(329, "https://example.com", "Supporter") to add ~1 USDC support
• Automate monitoring and re-contributing when outbid during the 24h auction window
• Fetch reserve prices to display minimums to end users before they bid