什么是 QR Auction Bidder？

QR Auction Bidder 是一款专门设计的工具，用于对接 Base 主网上的 $QR 拍卖协议。它允许用户在每日 24 小时的拍卖中竞标 USDC，获胜者可获得实物二维码目标 URL 的一天控制权。通过利用 Bankr 技能，它消除了手动钱包管理和交易签名的复杂性，为链上交互提供了流线型的开发体验。

该技能是 Openclaw Skills 如何将 AI 代理的能力扩展到去中心化金融和数字广告领域的典范。它处理合约交互、竞标类型选择和状态监控，确保用户无需深厚的区块链专业知识即可有效竞争 $QR 曝光度。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ss251/qr-auction-bidder

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

QR Auction Bidder 应用场景

• 自动参与每日 $QR 拍卖以锁定广告位。
• 在拍卖最后几分钟实施战略性加价以超过竞争对手。
• 以程序化方式为共享 URL 的现有社区竞标贡献资金。
• 监控拍卖状态和代币 ID，用于数据分析或机器人触发。

1. 该技能查询 Base 上的 QRAuctionV5 合约，以检索当前拍卖状态和活跃的 tokenId。
2. 它检查现有竞标，以确定应通过 createBid 提交新 URL，还是通过 contributeToBid 对现有竞标进行注资。
3. 用户通过 Bankr 界面发起 USDC 授权，以批准特定的竞标金额。
4. 该技能使用提供的参数在 Base 主网上执行交易。
5. 它监控拍卖时长并处理由最后时刻竞价活动触发的潜在延时。

QR Auction Bidder 配置指南

安装必备的 Bankr 技能以进行交易处理：

# 从官方仓库安装 Bankr
https://github.com/BankrBot/moltbot-skills

配置您的 Base 主网环境并确保拥有 USDC 余额。随后您可以使用该技能通过标准 RPC 调用检查状态，以验证 Openclaw Skills 集成是否已激活。

QR Auction Bidder 数据架构与分类体系

该技能与 QRAuctionV5 合约状态交互，并按如下方式组织数据：

所有竞标历史都可以使用 getAllBids 函数检索，返回 URL 列表及其累计 USDC 总额。

name: qr-auction-bidder
description: Bid on $QR auctions at qrcoin.fun. Place bids on Base mainnet using USDC. Uses Bankr for transaction execution — no wallet management needed.
metadata:
  openclaw:
    emoji: "??"
    requires: []

QR Auction Bidder

Bid on $QR daily auctions. Each auction lets you bid with USDC to win a QR code that points to your chosen URL for 24 hours.

Overview

$QR runs continuous 24-hour auctions on Base mainnet. The highest bid wins, and the winning URL is displayed on a real QR code. Losing bidders are refunded automatically.

• Website: https://qrcoin.fun
• Network: Base mainnet (chain ID 8453)
• Currency: USDC (6 decimals)
• Community: m/qr on moltbook.com
• Transaction execution: Uses Bankr — install the bankr skill from https://github.com/BankrBot/moltbot-skills

Contract Addresses

Minimum Bids

How Auctions Work

1. A new auction starts automatically after the previous one settles
2. Each auction has a tokenId, startTime, and endTime (typically 24 hours)
3. Bidders call createBid() to bid on a URL, or contributeToBid() to add USDC to an existing URL's bid
4. The highest total bid when time expires wins
5. If the leading URL changes in the last 5 minutes, the auction extends by 5 more minutes (up to 3 hours max beyond the scheduled end). Note: contributing to the already-winning URL does NOT trigger an extension.
6. After the auction ends, it's settled and losing bidders are refunded

Prerequisites

This skill uses Bankr for on-chain transaction execution. Install the bankr skill first:

https://github.com/BankrBot/moltbot-skills

Bankr handles wallet creation, USDC approvals, transaction signing, gas estimation, and confirmation. No private keys or wallet setup needed.

Check Auction Status

Query the current auction state via RPC:

# Get current auction state (tokenId, highestBid, startTime, endTime, settled)
curl -s -X POST https://mainnet.base.org r
  -H "Content-Type: application/json" r
  -d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x7309779122069EFa06ef71a45AE0DB55A259A176","data":"0xe4b8f0de"},"latest"],"id":1}' r
  | jq -r '.result'

The auction() function (selector 0xe4b8f0de) returns the full auction state including tokenId, highestBid, startTime, endTime, settled, and qrMetadata.

# Get number of bids in current auction
curl -s -X POST https://mainnet.base.org r
  -H "Content-Type: application/json" r
  -d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x7309779122069EFa06ef71a45AE0DB55A259A176","data":"0x91a3823f"},"latest"],"id":1}' r
  | jq -r '.result' | xargs printf "%d
"

# Get create bid reserve price (should return 11110000 = 11.11 USDC)
curl -s -X POST https://mainnet.base.org r
  -H "Content-Type: application/json" r
  -d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x7309779122069EFa06ef71a45AE0DB55A259A176","data":"0x4b6014f6"},"latest"],"id":1}' r
  | jq -r '.result' | xargs printf "%d
"

Bidding with Bankr

Step 1: Approve USDC

Before bidding, approve the auction contract to spend your USDC. The contract takes your full allowance (up to your balance) as the bid amount, so set approval to exactly what you want to bid.

Approve 15 USDC to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base

Or via Bankr script:

scripts/bankr.sh "Approve 15 USDC to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base"

Step 2: Create a New Bid

Use createBid when no bid exists yet for your URL. Always query the current tokenId from auction() first.

Function: createBid(uint256 _tokenId, string _urlString, string _name)

Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base calling createBid(329, "https://your-url.com", "YourName")

Or via Bankr script:

scripts/bankr.sh 'Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base calling createBid(329, "https://your-url.com", "YourName")'

Important: Replace 329 with the actual current tokenId. Using a wrong token ID reverts with INVALID_TOKEN_ID.

Step 3: Contribute to an Existing Bid

Use contributeToBid to add USDC to a URL that already has a bid:

Function: contributeToBid(uint256 _tokenId, string _urlString, string _name)

Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base calling contributeToBid(329, "https://existing-url.com", "YourName")

Or via Bankr script:

scripts/bankr.sh 'Send transaction to 0x7309779122069EFa06ef71a45AE0DB55A259A176 on Base calling contributeToBid(329, "https://existing-url.com", "YourName")'

Decide: createBid vs contributeToBid

• If your URL has no existing bid → use createBid (minimum 11.11 USDC)
• If your URL already has a bid → use contributeToBid (minimum 1.00 USDC)
• Calling createBid with a URL that already has a bid reverts with URL_ALREADY_HAS_BID
• Calling contributeToBid with a URL that has no bid reverts with BID_NOT_FOUND

Auction Timing

Important Notes

• USDC is real money. Bids use real USDC on Base mainnet. Only bid what you can afford to lose.
• Losing bids are refunded after the auction settles, but there may be a delay during batch processing.
• The contract takes your full allowance (up to your balance). Set your USDC approval to exactly your intended bid amount.
• URL must be unique per auction. If someone already bid on your URL, use contributeToBid. Calling createBid with a taken URL will revert with URL_ALREADY_HAS_BID.
• Token ID must match. Always read the current tokenId from auction() before bidding. Using a wrong token ID reverts with INVALID_TOKEN_ID.

Error Codes

ABI Reference

The full QRAuctionV5 ABI is available at references/QRAuctionV5.abi.json in this skill package.

Key functions:

Key events:

Typical Workflow

1. Check auction status — Query auction() for current tokenId and time remaining
2. Check existing bids — Query getAllBids() or getBid(url) to see what's already bid
3. Approve USDC via Bankr — Set allowance to exactly your intended bid amount
4. Place bid via Bankr — createBid for a new URL or contributeToBid for an existing one
5. Monitor — Watch for outbids and contribute more if needed
6. Settlement — Losing bids are refunded automatically after the auction settles

Links

• Platform: https://qrcoin.fun
• About / Docs: https://qrcoin.fun/about
• Auction Contract: https://basescan.org/address/0x7309779122069EFa06ef71a45AE0DB55A259A176
• Bankr skill: https://github.com/BankrBot/moltbot-skills
• Community: m/qr on moltbook.com