qrcoin
Interact with QR Coin auctions on Base. Use when the user wants to participate in qrcoin.fun QR code auctions — check auction status, view current bids, create new bids, or contribute to existing bids. QR Coin lets you bid to display URLs on QR codes; the highest bidder's URL gets encoded.
- License 许可
- MIT
- 最近更新
- 2026-06-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- qrcoin
- metadata
- { "clawdbot": { "emoji": "📱", "homepage": "https://qrcoin.fun", "requires": { "bins": [ "curl", "jq" ] } } }
- description
- Interact with QR Coin auctions on Base. Use when the user wants to participate in qrcoin.fun QR code auctions — check auction status, view current bids, create new bids, or contribute to existing bids. QR Coin lets you bid to display URLs on QR codes; the highest bidder's URL gets encoded.
03 SKILL.md 正文
QR Coin Auction
Participate in QR Coin auctions on Base blockchain. QR Coin lets you bid to display URLs on QR codes — the highest bidder's URL gets encoded when the auction ends.
Contracts (Base Mainnet)
| Contract | Address |
|---|---|
| QR Auction | 0x7309779122069EFa06ef71a45AE0DB55A259A176 |
| USDC | 0x833589fCD6eDb6E08f4c7c32D4f71b54bdA02913 |
How It Works
- Each auction runs for a fixed period (~24h)
- Bidders submit URLs with USDC (6 decimals — 1 USDC = 1000000 units)
- Creating a new bid costs ~11.11 USDC (createBidReserve)
- Contributing to an existing bid costs ~1.00 USDC (contributeReserve)
- Highest bid wins; winner's URL is encoded in the QR code
- Losers get refunded; winners receive QR tokens
Auction Status Queries
Note: The examples below use
https://mainnet.base.org(public RPC). You can substitute your own RPC endpoint if preferred.
Get Current Token ID
Always query this first to get the active auction ID before bidding.
curl -s -X POST https://mainnet.base.org \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x7309779122069EFa06ef71a45AE0DB55A259A176","data":"0x7d9f6db5"},"latest"],"id":1}' \
| jq -r '.result' | xargs printf "%d\n"
Get Auction End Time
# First get the current token ID, then use it here
TOKEN_ID=329 # Replace with result from currentTokenId()
TOKEN_ID_HEX=$(printf '%064x' $TOKEN_ID)
curl -s -X POST https://mainnet.base.org \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x7309779122069EFa06ef71a45AE0DB55A259A176","data":"0xa4d0a17e'"$TOKEN_ID_HEX"'"},"latest"],"id":1}' \
| jq -r '.result' | xargs printf "%d\n"
Get Reserve Prices
# Create bid reserve (~11.11 USDC)
curl -s -X POST https://mainnet.base.org \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x7309779122069EFa06ef71a45AE0DB55A259A176","data":"0x5b3bec22"},"latest"],"id":1}' \
| jq -r '.result' | xargs printf "%d\n" | awk '{print $1/1000000 " USDC"}'
# Contribute reserve (~1.00 USDC)
curl -s -X POST https://mainnet.base.org \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x7309779122069EFa06ef71a45AE0DB55A259A176","data":"0xda5a5cf3"},"latest"],"id":1}' \
| jq -r '.result' | xargs printf "%d\n" | awk '{print $1/1000000 " USDC"}'
Transactions via Bankr
QR Coin auctions require USDC transactions on Base. Use Bankr to execute these — Bankr handles:
- Function signature parsing and parameter encoding
- Gas estimation
- Transaction signing and submission
- Confirmation monitoring
Step 1: Approve USDC (One-Time)
Before bidding, approve the auction contract to spend USDC:
Approve 50 USDC to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base
Step 2: Create a New Bid
To start a new bid for your URL:
Function: createBid(uint256 tokenId, string url, string name)
Contract: 0x7309779122069EFa06ef71a45AE0DB55A259A176
Cost: ~11.11 USDC
Important: Always query
currentTokenId()first to get the active auction ID.
Example prompt for Bankr:
Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base
calling createBid(329, "https://example.com", "MyName")
Step 3: Contribute to Existing Bid
To add funds to an existing URL's bid:
Function: contributeToBid(uint256 tokenId, string url, string name)
Contract: 0x7309779122069EFa06ef71a45AE0DB55A259A176
Cost: ~1.00 USDC per contribution
Example prompt for Bankr:
Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base
calling contributeToBid(329, "https://grokipedia.com/page/debtreliefbot", "MerkleMoltBot")
Function Selectors
| Function | Selector | Parameters |
|---|---|---|
currentTokenId() |
0x7d9f6db5 |
— |
auctionEndTime(uint256) |
0xa4d0a17e |
tokenId |
createBidReserve() |
0x5b3bec22 |
— |
contributeReserve() |
0xda5a5cf3 |
— |
createBid(uint256,string,string) |
0xf7842286 |
tokenId, url, name |
contributeToBid(uint256,string,string) |
0x7ce28d02 |
tokenId, url, name |
approve(address,uint256) |
0x095ea7b3 |
spender, amount |
Error Codes
| Error | Meaning | Solution |
|---|---|---|
RESERVE_PRICE_NOT_MET |
Bid amount below minimum | Check reserve prices |
URL_ALREADY_HAS_BID |
URL already has a bid | Use contributeToBid instead |
BID_NOT_FOUND |
URL doesn't have existing bid | Use createBid instead |
AUCTION_OVER |
Current auction has ended | Wait for next auction |
AUCTION_NOT_STARTED |
Auction hasn't begun | Wait for auction to start |
INSUFFICIENT_ALLOWANCE |
USDC not approved | Approve USDC first |
Typical Workflow
- Query
currentTokenId()— Get the active auction ID - Check auction status — Verify time remaining
- Approve USDC — One-time approval for the auction contract
- Decide action:
- New URL: Use
createBid(~11.11 USDC) - Support existing URL: Use
contributeToBid(~1.00 USDC)
- New URL: Use
- Monitor — Watch for outbids and contribute more if needed
- Claim — Winners receive QR tokens; losers get refunds
Links
- Platform: https://qrcoin.fun
- Auction Contract: BaseScan
- USDC on Base: BaseScan
Tips
- Start small: Contribute to existing bids (~1 USDC) to learn the flow
- Check timing: Auctions have fixed end times; plan accordingly
- Monitor bids: Others can outbid you; watch the auction
- Use Bankr: Let Bankr handle transaction signing and execution
- Specify Base: Always include "on Base" when using Bankr
💡 Pro Tip: Contributing to an existing bid is cheaper than creating a new one. Check if someone already bid for your URL before creating a new bid.
04 同仓库更多 Skills
provisioning-v1
暂无简介
get-api-docs
Use this skill when you need documentation for a third-party library, SDK, or API before writing code that uses it — for example, "use the OpenAI API", "call the Stripe API", "use the Anthropic SDK", "query Pinecone", or any time the user asks you to write code against an external service and you need current API reference. Fetch the docs with chub before answering, rather than relying on training knowledge.
zyfai
Earn yield on any Ethereum wallet on Base, Arbitrum, and Plasma. Use when a user wants passive DeFi yield on their funds. Deploys a non-custodial deterministic subaccount (Safe) linked to their EOA, enables automated yield optimization, and lets them deposit/withdraw anytime.
zerion
Interpreted crypto wallet data for AI agents. Use when an agent needs portfolio values, token positions, DeFi positions, NFT holdings, transaction history, PnL data, token prices, charts, gas prices, swap quotes, or DApp information across 41+ chains. Zerion transforms raw blockchain data into agent-ready JSON with USD values, protocol labels, and enriched metadata. Supports x402 pay-per-request ($0.01 USDC on Base) and API key access. Triggers on mentions of portfolio, wallet analysis, positions, transactions, PnL, profit/loss, DeFi, token balances, NFTs, swap quotes, gas prices, or Zerion.
zapper
Placeholder for Zapper skill.
yoink
Play Yoink, an onchain capture-the-flag game on Base. Yoink the flag from the current holder, check game stats and leaderboards, view player scores, and compete for the trophy. Uses Bankr for transaction execution.