Batch Auction Uniform Price Settlement Tool

WHAT IT DOES

Batch Auction Uniform Price Settlement Tool enables auction administrators to settle batch auctions where all winning bidders pay the same clearing price. The tool reads the auction contract address, bidder addresses, bid amounts, bid prices, total sell volume, total buy volume, and current block timestamp to determine the uniform clearing price that clears supply and demand. It then executes settlement in a single batched transaction: distributing the auctioned tokens to winning bidders at the uniform price, refunding the excess bid amounts to all bidders who bid above the clearing price, and fully refunding bidders who bid below the clearing price. The tool displays a complete breakdown of the auction including the clearing price, winning bidders, and refund amounts before you confirm.

HOW TO USE

Connect your wallet and select your network. Enter the auction contract address, sell token address, and buy token address. Click "Fetch auction data" to load all auction details including total sell volume, total buy volume, clearing price, bidder count, and the status of the auction. The tool displays a list of all bidders with their bid amounts, prices, and whether they win or lose at the clearing price. Review the batch sender contract details including the contract address, owner, and fee. Click "Settle auction" to execute the settlement—this will distribute tokens to winning bidders, refund losing bidders, and record the settlement on-chain. The entire settlement happens in one batched transaction using the shared BotGentz sender contract, saving gas compared to individual refunds and distributions.

THE REAL MECHANISM — UNIFORM PRICE CLEARING WITH BATCHED DISTRIBUTION

Unlike English or Dutch auctions where prices vary per bidder, batch auctions use a uniform clearing price mechanism. The tool computes the clearing price by sorting bids by price (highest to lowest) and cumulatively summing buy volumes until the total sell volume is met. The clearing price is the price of the last bid that fills the supply. All bidders who bid at or above the clearing price are winners; they receive tokens at the uniform clearing price regardless of their actual bid price, and their excess funds are refunded. Bidders who bid below the clearing price are fully refunded. The tool uses the BotGentz sender contract to execute the settlement in a single transaction: it transfers sell tokens to winning bidders proportional to their bid volume at the clearing price, refunds the difference between their bid and the clearing price for winners, and refunds the full bid amount for losers. All transfers are batched using the sender contract's batch transfer function, which significantly reduces gas costs. The tool reads fee() and owner() live from the sender contract and checks the total value against the sender's balance before execution.

WHAT IT CANNOT SEE

Cannot verify off-chain bidder identity—this tool has no visibility into whether bidders are legitimate, related parties, or engaging in wash trading. It cannot ensure price discovery efficiency—the clearing price is determined by on-chain bids, but the tool cannot evaluate whether the auction process was fair or manipulated. It cannot predict future market prices—the clearing price is based on historical bids and may not reflect future market conditions. It cannot detect if the auction contract contains vulnerabilities or manipulation risks—the tool does not audit the auction logic or verify its implementation. It cannot prevent front-running or last-minute bid manipulation.

PLEASE NOTE — EVM CHAINS ONLY

This tool exclusively supports EVM-compatible chains where ethers.js can connect via standard JSON-RPC. It does not support non-EVM chains such as Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The auction contract must implement the specific interface expected by this tool (getAuctionInfo, getBidderCount, getBidder, settle). The batch sender contract must be available on your selected chain—the tool uses the BotGentz registry and will notify you if unsupported. Always test with small amounts on a testnet before executing on mainnet. This tool is an auction settlement interface, not a financial advisor or investment strategist.