Back to Details

qrcoin

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

QR Coin Auction

QR Coin 拍卖

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.
参与Base区块链上的QR Coin拍卖。QR Coin允许你出价在二维码上展示URL——拍卖结束时，最高出价者的URL会被编码到二维码中。

Contracts (Base Mainnet)

合约（Base主网）

ContractAddress
QR Auction
0x7309779122069EFa06ef71a45AE0DB55A259A176
USDC
0x833589fCD6eDb6E08f4c7c32D4f71b54bdA02913
合约地址
QR Auction
0x7309779122069EFa06ef71a45AE0DB55A259A176
USDC
0x833589fCD6eDb6E08f4c7c32D4f71b54bdA02913

How It Works

运行规则

  1. Each auction runs for a fixed period (~24h)
  2. Bidders submit URLs with USDC (6 decimals — 1 USDC = 1000000 units)
  3. Creating a new bid costs ~11.11 USDC (createBidReserve)
  4. Contributing to an existing bid costs ~1.00 USDC (contributeReserve)
  5. Highest bid wins; winner's URL is encoded in the QR code
  6. Losers get refunded; winners receive QR tokens
  1. 每场拍卖固定时长约24小时
  2. 出价者使用USDC提交URL（6位小数——1 USDC = 1000000 单位）
  3. 创建新出价需要约11.11 USDC（createBidReserve）
  4. 为现有出价增资需要约1.00 USDC（contributeReserve）
  5. 最高出价获胜；获胜者的URL会被编码到二维码中
  6. 出价失败者会获得退款；获胜者将获得QR代币

Auction Status Queries

拍卖状态查询

Note: The examples below use 
https://mainnet.base.org
(public RPC). You can substitute your own RPC endpoint if preferred.
注意：以下示例使用
https://mainnet.base.org
（公共RPC）。你也可以根据需要替换为自己的RPC端点。

Get Current Token ID

获取当前Token ID

Always query this first to get the active auction ID before bidding.
bash
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"
出价前请务必先查询该接口获取当前活跃的拍卖ID。
bash
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

获取拍卖结束时间

bash
undefined
bash
undefined

First get the current token ID, then use it here

首先获取当前token ID，然后在这里使用

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"
undefined
TOKEN_ID=329 # 替换为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"
undefined

Get Reserve Prices

获取底价

bash
undefined
bash
undefined

Create bid reserve (~11.11 USDC)

创建出价底价（约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"}'
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)

增资底价（约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"}'
undefined
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"}'
undefined

Transactions via Bankr

通过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
QR Coin拍卖需要在Base上进行USDC交易。使用Bankr来执行这些交易，Bankr会处理：
  • 函数签名解析和参数编码
  • Gas预估
  • 交易签名和提交
  • 确认状态监控

Step 1: Approve USDC (One-Time)

步骤1：授权USDC（仅需一次）

Before bidding, approve the auction contract to spend USDC:
Approve 50 USDC to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base
出价前，请先授权拍卖合约可以花费你的USDC：
Approve 50 USDC to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base

Step 2: Create a New Bid

步骤2：创建新出价

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")
为你的URL发起新出价：
函数：
createBid(uint256 tokenId, string url, string name)
合约：
0x7309779122069EFa06ef71a45AE0DB55A259A176
成本：约11.11 USDC
重要提示：请务必先调用
currentTokenId()
获取当前活跃的拍卖ID。
给Bankr的示例提示：
Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base
calling createBid(329, "https://example.com", "MyName")

Step 3: Contribute to Existing Bid

步骤3：为现有出价增资

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")
为已有的URL出价追加资金：
函数：
contributeToBid(uint256 tokenId, string url, string name)
合约：
0x7309779122069EFa06ef71a45AE0DB55A259A176
成本：每次增资约1.00 USDC
给Bankr的示例提示：
Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base
calling contributeToBid(329, "https://grokipedia.com/page/debtreliefbot", "MerkleMoltBot")

Function Selectors

函数选择器

FunctionSelectorParameters
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
函数选择器参数
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

错误码

ErrorMeaningSolution
RESERVE_PRICE_NOT_MET
Bid amount below minimumCheck reserve prices
URL_ALREADY_HAS_BID
URL already has a bidUse 
contributeToBid
instead
BID_NOT_FOUND
URL doesn't have existing bidUse 
createBid
instead
AUCTION_OVER
Current auction has endedWait for next auction
AUCTION_NOT_STARTED
Auction hasn't begunWait for auction to start
INSUFFICIENT_ALLOWANCE
USDC not approvedApprove USDC first
错误含义解决方案
RESERVE_PRICE_NOT_MET
出价金额低于最低要求检查底价
URL_ALREADY_HAS_BID
该URL已有出价改用
contributeToBid
接口
BID_NOT_FOUND
该URL没有现有出价改用
createBid
接口
AUCTION_OVER
当前拍卖已结束等待下一场拍卖
AUCTION_NOT_STARTED
拍卖尚未开始等待拍卖启动
INSUFFICIENT_ALLOWANCE
USDC未完成授权先授权USDC额度

Typical Workflow

典型工作流程

  1. Query 
    currentTokenId()
     — Get the active auction ID
  2. Check auction status — Verify time remaining
  3. Approve USDC — One-time approval for the auction contract
  4. Decide action:
    • New URL: Use 
      createBid
      (~11.11 USDC)
    • Support existing URL: Use 
      contributeToBid
      (~1.00 USDC)
  5. Monitor — Watch for outbids and contribute more if needed
  6. Claim — Winners receive QR tokens; losers get refunds
  1. 调用
    currentTokenId()
     —— 获取活跃拍卖ID
  2. 检查拍卖状态 —— 确认剩余时间
  3. 授权USDC —— 为拍卖合约进行一次USDC额度授权
  4. 选择操作：
    • 新URL：使用
      createBid
      接口（约11.11 USDC）
    • 支持现有URL：使用
      contributeToBid
      接口（约1.00 USDC）
  5. 监控状态：留意是否被他人出价超过，如有需要可追加资金
  6. 领取结果：获胜者获得QR代币；失败者获得退款

Links

相关链接

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.
  • 从小额开始：先为现有出价增资（约1 USDC）来熟悉流程
  • 注意时间：拍卖有固定结束时间，请提前规划
  • 监控出价：他人可能超过你的出价，请留意拍卖动态
  • 使用Bankr：让Bankr处理交易签名和执行流程
  • 指定Base网络：使用Bankr时请务必带上"on Base"标识
💡 进阶提示：为现有出价增资比创建新出价更便宜。创建新出价前请先检查是否已经有人为你的URL出过价。