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（USDC为6位小数——1 USDC = 1000000单位）
  3. 创建新出价需要约11.11 USDC（createBidReserve）
  4. 为现有出价追加资金需要约1.00 USDC（contributeReserve）
  5. 出价最高者获胜；获胜者的URL会被编码到二维码中
  6. 未获胜者会收到退款；获胜者将获得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.
注意：以下示例使用
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 — 为拍卖合约完成一次性授权
  4. 选择操作:
    • 新URL：使用
      createBid
      （约11.11 USDC）
    • 支持已有URL：使用
      contributeToBid
      （约1.00 USDC）
  5. 监控拍卖 — 留意是否被反超，必要时追加资金
  6. 领取结果 — 获胜者获得QR tokens；未获胜者收到退款

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出价。