@hammerock/cca-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2717 @@
+import * as viem from 'viem';
+import { Address, Hex } from 'viem';
+export { Address, Chain, Hex } from 'viem';
+import { B as BeaconClient, D as DiscoveredAuction, A as AuctionInfo, a as AuctionStatus, b as AuctionState, c as AuctionSummary } from './erc20-C3yff839.js';
+export { d as BeaconClientConfig, C as Checkpoint, T as TokenMetadata, e as assertChainMatches, f as assertSupportedChain, g as createBeaconClient, h as erc20MetadataAbi, i as formatTokenAmount, j as getTokenMetadata, k as getTokenMetadataBatch } from './erc20-C3yff839.js';
+import * as viem_chains from 'viem/chains';
+
+declare const auctionAbi: readonly [{
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_totalSupply";
+        readonly type: "uint128";
+        readonly internalType: "uint128";
+    }, {
+        readonly name: "_parameters";
+        readonly type: "tuple";
+        readonly internalType: "struct AuctionParameters";
+        readonly components: readonly [{
+            readonly name: "currency";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "tokensRecipient";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "fundsRecipient";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "startBlock";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "endBlock";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "claimBlock";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "tickSpacing";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "validationHook";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "floorPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "requiredCurrencyRaised";
+            readonly type: "uint128";
+            readonly internalType: "uint128";
+        }, {
+            readonly name: "auctionStepsData";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }];
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_BID_PRICE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_BLOCK_NUMBER";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_TICK_PTR";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "bids";
+    readonly inputs: readonly [{
+        readonly name: "bidId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct Bid";
+        readonly components: readonly [{
+            readonly name: "startBlock";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "startCumulativeMps";
+            readonly type: "uint24";
+            readonly internalType: "uint24";
+        }, {
+            readonly name: "exitedBlock";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "maxPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "owner";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "amountQ96";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "tokensFilled";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "checkpoint";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct Checkpoint";
+        readonly components: readonly [{
+            readonly name: "clearingPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "currencyRaisedAtClearingPriceQ96_X7";
+            readonly type: "uint256";
+            readonly internalType: "ValueX7";
+        }, {
+            readonly name: "cumulativeMpsPerPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "cumulativeMps";
+            readonly type: "uint24";
+            readonly internalType: "uint24";
+        }, {
+            readonly name: "prev";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "next";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }];
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "checkpoints";
+    readonly inputs: readonly [{
+        readonly name: "blockNumber";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct Checkpoint";
+        readonly components: readonly [{
+            readonly name: "clearingPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "currencyRaisedAtClearingPriceQ96_X7";
+            readonly type: "uint256";
+            readonly internalType: "ValueX7";
+        }, {
+            readonly name: "cumulativeMpsPerPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "cumulativeMps";
+            readonly type: "uint24";
+            readonly internalType: "uint24";
+        }, {
+            readonly name: "prev";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "next";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "claimBlock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "claimTokens";
+    readonly inputs: readonly [{
+        readonly name: "_bidId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claimTokensBatch";
+    readonly inputs: readonly [{
+        readonly name: "_owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_bidIds";
+        readonly type: "uint256[]";
+        readonly internalType: "uint256[]";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "clearingPrice";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "currency";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "currencyRaised";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "currencyRaisedQ96_X7";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "ValueX7";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "endBlock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "exitBid";
+    readonly inputs: readonly [{
+        readonly name: "_bidId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "exitPartiallyFilledBid";
+    readonly inputs: readonly [{
+        readonly name: "_bidId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "_lastFullyFilledCheckpointBlock";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }, {
+        readonly name: "_outbidBlock";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "floorPrice";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "forceIterateOverTicks";
+    readonly inputs: readonly [{
+        readonly name: "_untilTickPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "fundsRecipient";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isGraduated";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lastCheckpointedBlock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "latestCheckpoint";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct Checkpoint";
+        readonly components: readonly [{
+            readonly name: "clearingPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "currencyRaisedAtClearingPriceQ96_X7";
+            readonly type: "uint256";
+            readonly internalType: "ValueX7";
+        }, {
+            readonly name: "cumulativeMpsPerPrice";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "cumulativeMps";
+            readonly type: "uint24";
+            readonly internalType: "uint24";
+        }, {
+            readonly name: "prev";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "next";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lbpInitializationParams";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly internalType: "struct LBPInitializationParams";
+        readonly components: readonly [{
+            readonly name: "initialPriceX96";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "tokensSold";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "currencyRaised";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "nextActiveTickPrice";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "nextBidId";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "onTokensReceived";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "pointer";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "startBlock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "step";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct AuctionStep";
+        readonly components: readonly [{
+            readonly name: "mps";
+            readonly type: "uint24";
+            readonly internalType: "uint24";
+        }, {
+            readonly name: "startBlock";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "endBlock";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "submitBid";
+    readonly inputs: readonly [{
+        readonly name: "_maxPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "_amount";
+        readonly type: "uint128";
+        readonly internalType: "uint128";
+    }, {
+        readonly name: "_owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_hookData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "submitBid";
+    readonly inputs: readonly [{
+        readonly name: "_maxPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "_amount";
+        readonly type: "uint128";
+        readonly internalType: "uint128";
+    }, {
+        readonly name: "_owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_prevTickPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "_hookData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "sumCurrencyDemandAboveClearingQ96";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "supportsInterface";
+    readonly inputs: readonly [{
+        readonly name: "interfaceId";
+        readonly type: "bytes4";
+        readonly internalType: "bytes4";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "sweepCurrency";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "sweepCurrencyBlock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "sweepUnsoldTokens";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "sweepUnsoldTokensBlock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "tickSpacing";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "ticks";
+    readonly inputs: readonly [{
+        readonly name: "price";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct Tick";
+        readonly components: readonly [{
+            readonly name: "next";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "currencyDemandQ96";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "token";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "tokensRecipient";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalCleared";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalClearedQ96_X7";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "ValueX7";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint128";
+        readonly internalType: "uint128";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "validationHook";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IValidationHook";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "AuctionStepRecorded";
+    readonly inputs: readonly [{
+        readonly name: "startBlock";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "endBlock";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "mps";
+        readonly type: "uint24";
+        readonly indexed: false;
+        readonly internalType: "uint24";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "BidExited";
+    readonly inputs: readonly [{
+        readonly name: "bidId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokensFilled";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "currencyRefunded";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "BidSubmitted";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "price";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint128";
+        readonly indexed: false;
+        readonly internalType: "uint128";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "CheckpointUpdated";
+    readonly inputs: readonly [{
+        readonly name: "blockNumber";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "clearingPrice";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "cumulativeMps";
+        readonly type: "uint24";
+        readonly indexed: false;
+        readonly internalType: "uint24";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "ClearingPriceUpdated";
+    readonly inputs: readonly [{
+        readonly name: "blockNumber";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "clearingPrice";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "CurrencySwept";
+    readonly inputs: readonly [{
+        readonly name: "fundsRecipient";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "currencyAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "NextActiveTickUpdated";
+    readonly inputs: readonly [{
+        readonly name: "price";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "TickInitialized";
+    readonly inputs: readonly [{
+        readonly name: "price";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "TokensClaimed";
+    readonly inputs: readonly [{
+        readonly name: "bidId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokensFilled";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "TokensReceived";
+    readonly inputs: readonly [{
+        readonly name: "totalSupply";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "TokensSwept";
+    readonly inputs: readonly [{
+        readonly name: "tokensRecipient";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokensAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "AuctionIsNotFinalized";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AuctionIsNotOver";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AuctionIsOver";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AuctionNotStarted";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AuctionSoldOut";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "BatchClaimDifferentOwner";
+    readonly inputs: readonly [{
+        readonly name: "expectedOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "receivedOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "BidAlreadyExited";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "BidAmountTooSmall";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "BidIdDoesNotExist";
+    readonly inputs: readonly [{
+        readonly name: "bidId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "BidMustBeAboveClearingPrice";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "BidNotExited";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "BidOwnerCannotBeZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CannotExitBid";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CannotPartiallyExitBidBeforeEndBlock";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CannotPartiallyExitBidBeforeGraduation";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CannotSweepCurrency";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CannotSweepTokens";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CannotUpdateUninitializedTick";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CheckpointBlockNotIncreasing";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ClaimBlockIsBeforeEndBlock";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "CurrencyIsNotNative";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ERC20TransferFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "FloorPriceAndTickSpacingGreaterThanMaxBidPrice";
+    readonly inputs: readonly [{
+        readonly name: "nextTick";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "maxBidPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "FloorPriceAndTickSpacingTooLarge";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "FloorPriceIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "FloorPriceTooLow";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "FundsRecipientIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAuctionDataLength";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidBidPriceTooHigh";
+    readonly inputs: readonly [{
+        readonly name: "maxPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "maxBidPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidBidUnableToClear";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidEndBlock";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidEndBlockGivenStepData";
+    readonly inputs: readonly [{
+        readonly name: "actualEndBlock";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }, {
+        readonly name: "expectedEndBlock";
+        readonly type: "uint64";
+        readonly internalType: "uint64";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidLastFullyFilledCheckpointHint";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidOutbidBlockCheckpointHint";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidStepDataMps";
+    readonly inputs: readonly [{
+        readonly name: "actualMps";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "expectedMps";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidTickPrice";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidTokenAmountReceived";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "MpsRemainingIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NativeTransferFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotClaimable";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotGraduated";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "Reentrancy";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "StepBlockDeltaCannotBeZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "StepLib__InvalidOffsetNotAtStepBoundary";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "StepLib__InvalidOffsetTooLarge";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TickHintMustBeGreaterThanNextActiveTickPrice";
+    readonly inputs: readonly [{
+        readonly name: "tickPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "nextActiveTickPrice";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "TickNotInitialized";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TickPreviousPriceInvalid";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TickPriceNotAtBoundary";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TickPriceNotIncreasing";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TickSpacingTooSmall";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TokenAndCurrencyCannotBeTheSame";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TokenIsAddressZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TokenTransferFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TokensNotReceived";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TokensRecipientIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TotalSupplyIsTooLarge";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TotalSupplyIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ValidationHookCallFailed";
+    readonly inputs: readonly [{
+        readonly name: "reason";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+}];
+
+declare const factoryAbi: readonly [{
+    readonly type: "function";
+    readonly name: "getAuctionAddress";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "configData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "salt";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "initializeDistribution";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "configData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "salt";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "distributionContract";
+        readonly type: "address";
+        readonly internalType: "contract IDistributionContract";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "AuctionCreated";
+    readonly inputs: readonly [{
+        readonly name: "auction";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "configData";
+        readonly type: "bytes";
+        readonly indexed: false;
+        readonly internalType: "bytes";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "InvalidTokenAmount";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}];
+
+declare const auctionStateLensAbi: readonly [{
+    readonly type: "function";
+    readonly name: "revertWithState";
+    readonly inputs: readonly [{
+        readonly name: "auction";
+        readonly type: "address";
+        readonly internalType: "contract IContinuousClearingAuction";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "state";
+    readonly inputs: readonly [{
+        readonly name: "auction";
+        readonly type: "address";
+        readonly internalType: "contract IContinuousClearingAuction";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct AuctionState";
+        readonly components: readonly [{
+            readonly name: "checkpoint";
+            readonly type: "tuple";
+            readonly internalType: "struct Checkpoint";
+            readonly components: readonly [{
+                readonly name: "clearingPrice";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "currencyRaisedAtClearingPriceQ96_X7";
+                readonly type: "uint256";
+                readonly internalType: "ValueX7";
+            }, {
+                readonly name: "cumulativeMpsPerPrice";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "cumulativeMps";
+                readonly type: "uint24";
+                readonly internalType: "uint24";
+            }, {
+                readonly name: "prev";
+                readonly type: "uint64";
+                readonly internalType: "uint64";
+            }, {
+                readonly name: "next";
+                readonly type: "uint64";
+                readonly internalType: "uint64";
+            }];
+        }, {
+            readonly name: "currencyRaised";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "totalCleared";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "isGraduated";
+            readonly type: "bool";
+            readonly internalType: "bool";
+        }];
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "error";
+    readonly name: "CheckpointFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidRevertReasonLength";
+    readonly inputs: readonly [];
+}];
+/** Deployed runtime bytecode, for eth_call state-override reads.
+ *  Lets Beacon run the lens without deploying it. */
+declare const auctionStateLensDeployedBytecode: "0x608060405234801561000f575f80fd5b5060043610610034575f3560e01c806321a13d371461003857806331e658a51461004d575b5f80fd5b61004b61004636600461048a565b610076565b005b61006061005b36600461048a565b6102c7565b60405161006d91906104bd565b60405180910390f35b8073ffffffffffffffffffffffffffffffffffffffff1663c2c4c5c16040518163ffffffff1660e01b815260040160c0604051808303815f875af19250505080156100fc575060408051601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01682019092526100f991810190610620565b60015b610132576040517fd027b09000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f60405180608001604052808381526020018473ffffffffffffffffffffffffffffffffffffffff1663998ba4fc6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561018d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906101b1919061063a565b81526020018473ffffffffffffffffffffffffffffffffffffffff16633e9d91746040518163ffffffff1660e01b8152600401602060405180830381865afa1580156101ff573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610223919061063a565b81526020018473ffffffffffffffffffffffffffffffffffffffff16639e5f26026040518163ffffffff1660e01b8152600401602060405180830381865afa158015610271573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906102959190610660565b151581525090505f816040516020016102ae91906104bd565b6040516020818303038152906040529050805160208201fd5b60408051610140810182525f6080820181815260a0830182905260c0830182905260e083018290526101008301829052610120830182905282526020820181905291810182905260608101919091526040517f21a13d3700000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8316600482015230906321a13d37906024015f604051808303815f87803b15801561037a575f80fd5b505af192505050801561038b575060015b6103ce573d8080156103b8576040519150601f19603f3d011682016040523d82523d5f602084013e6103bd565b606091505b506103c7816103d3565b9392505050565b919050565b60408051610140810182525f6080820181815260a0830182905260c0830182905260e083018290526101008301829052610120830182905282526020820181905291810182905260608101919091528151610120146104705760208251111561043e57815160208301fd5b6040517fa75357f900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b818060200190518101906104849190610679565b92915050565b5f6020828403121561049a575f80fd5b813573ffffffffffffffffffffffffffffffffffffffff811681146103c7575f80fd5b5f61012082019050825180518352602081015160208401526040810151604084015262ffffff606082015116606084015267ffffffffffffffff608082015116608084015267ffffffffffffffff60a08201511660a084015250602083015160c0830152604083015160e0830152606083015161053f61010084018215159052565b5092915050565b60405160c0810167ffffffffffffffff8111828210171561058e577f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b60405290565b805167ffffffffffffffff811681146103ce575f80fd5b5f60c082840312156105bb575f80fd5b6105c3610546565b825181526020808401519082015260408084015190820152606083015190915062ffffff811681146105f3575f80fd5b606082015261060460808301610594565b608082015261061560a08301610594565b60a082015292915050565b5f60c08284031215610630575f80fd5b6103c783836105ab565b5f6020828403121561064a575f80fd5b5051919050565b805180151581146103ce575f80fd5b5f60208284031215610670575f80fd5b6103c782610651565b5f61012082840312801561068b575f80fd5b506040516080810167ffffffffffffffff811182821017156106d4577f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b6040526106e184846105ab565b815260c0830151602082015260e083015160408201526107046101008401610651565b6060820152939250505056fea164736f6c634300081a000a";
+
+/** Upstream tag these ABIs were compiled from. */
+declare const UPSTREAM_TAG = "v1.1.0";
+/** Exact upstream commit these ABIs were compiled from. */
+declare const UPSTREAM_COMMIT = "a0aabaa45d8677a4944fc04d5dea2c4b499b3d3a";
+
+/** Mirrors `struct AuctionParameters`. */
+interface AuctionParameters {
+    /** Currency to raise in. `address(0)` for native ETH. */
+    currency: Address;
+    /** Receives leftover unsold tokens. */
+    tokensRecipient: Address;
+    /** Receives the raised funds. */
+    fundsRecipient: Address;
+    startBlock: bigint;
+    endBlock: bigint;
+    /** Block from which bidders can claim. Must be >= endBlock. */
+    claimBlock: bigint;
+    tickSpacing: bigint;
+    /** Optional pre-bid hook. `address(0)` for none. */
+    validationHook: Address;
+    /** Q96-encoded starting price. */
+    floorPriceQ96: bigint;
+    /** Currency that must be raised for the auction to graduate. */
+    requiredCurrencyRaised: bigint;
+    /** Packed supply schedule. Build with {@link buildAuctionSteps}. */
+    auctionStepsData: Hex;
+}
+/** One entry of the supply schedule. */
+interface AuctionStep {
+    /** Milli-bips of supply released per block during this step. uint24. */
+    mps: number;
+    /** How many blocks this step lasts. uint40, must be > 0. */
+    blockDelta: number;
+}
+/** `ConstantsLib.MIN_FLOOR_PRICE` - `type(uint32).max + 1`. */
+declare const MIN_FLOOR_PRICE = 4294967296n;
+/** `ConstantsLib.MIN_TICK_SPACING`. */
+declare const MIN_TICK_SPACING = 2n;
+declare class AuctionParametersError extends Error {
+}
+/**
+ * Pack steps into `auctionStepsData`.
+ *
+ * Each step is one 8-byte word: `uint24 mps | uint40 blockDelta`.
+ */
+declare function packAuctionSteps(steps: readonly AuctionStep[]): Hex;
+/** Unpack `auctionStepsData` back into steps. */
+declare function unpackAuctionSteps(data: Hex): AuctionStep[];
+/**
+ * Build a schedule that releases the whole supply evenly over `durationBlocks`.
+ *
+ * The contract requires `sum(mps * blockDelta) == MPS` exactly. `MPS` (1e7)
+ * rarely divides evenly by a duration, so this emits a flat step for all but
+ * the last block and puts the remainder on the final block, rather than
+ * silently rounding and reverting with `InvalidStepDataMps`.
+ */
+declare function buildAuctionSteps(durationBlocks: number): AuctionStep[];
+/** Total supply released by a schedule, which must equal `MPS`. */
+declare function totalMps(steps: readonly AuctionStep[]): bigint;
+/** Total blocks a schedule spans. */
+declare function totalBlocks(steps: readonly AuctionStep[]): bigint;
+/**
+ * Validate parameters against every constructor rule, before spending gas.
+ * Throws on the first violation, naming the revert it would have caused.
+ */
+declare function validateAuctionParameters(params: AuctionParameters): void;
+/**
+ * ABI-encode parameters into the factory's `configData`.
+ * Validates first - the factory decodes this blindly and the auction's
+ * constructor is where a bad value surfaces, after the gas is spent.
+ */
+declare function encodeAuctionParameters(params: AuctionParameters): Hex;
+/**
+ * Decode a factory `AuctionCreated` event's `configData`.
+ * Lets the directory show how any auction was configured.
+ */
+declare function decodeAuctionParameters(configData: Hex): AuctionParameters;
+
+/**
+ * `ContinuousClearingAuctionFactory` v1.1.0.
+ *
+ * Deployed through the deterministic CREATE2 deployer (`0x4e59b448...`), so the
+ * address is identical on every chain Uniswap has launched CCA on.
+ *
+ * VERIFIED on Sepolia: the deployed runtime bytecode is byte-for-byte identical
+ * to a local `forge build` of upstream tag v1.1.0. Re-check with
+ * `./contracts/sync-abis.sh` and a bytecode diff before trusting a new chain.
+ */
+declare const FACTORY_ADDRESS: Address;
+/**
+ * Block each chain's factory was created at - where auction discovery starts
+ * scanning. Scanning from 0 instead wastes thousands of RPC calls.
+ */
+declare const FACTORY_DEPLOY_BLOCK: Record<number, bigint>;
+/**
+ * Testnets Beacon is allowed to talk to.
+ *
+ * Only Sepolia is verified end-to-end today; the other two are listed because
+ * the factory is a cross-chain singleton, but their deploy blocks are unknown
+ * (discovery will need an explicit `fromBlock`).
+ */
+declare const SUPPORTED_CHAINS: {
+    readonly 11155111: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "Etherscan";
+                readonly url: "https://sepolia.etherscan.io";
+                readonly apiUrl: "https://api-sepolia.etherscan.io/api";
+            };
+        };
+        blockTime?: number | undefined | undefined;
+        contracts: {
+            readonly multicall3: {
+                readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+                readonly blockCreated: 751532;
+            };
+            readonly ensUniversalResolver: {
+                readonly address: "0xeeeeeeee14d718c2b47d9923deab1335e144eeee";
+                readonly blockCreated: 8928790;
+            };
+        };
+        ensTlds?: readonly string[] | undefined;
+        id: 11155111;
+        name: "Sepolia";
+        nativeCurrency: {
+            readonly name: "Sepolia Ether";
+            readonly symbol: "ETH";
+            readonly decimals: 18;
+        };
+        experimental_preconfirmationTime?: number | undefined | undefined;
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://11155111.rpc.thirdweb.com"];
+            };
+        };
+        sourceId?: number | undefined | undefined;
+        supportsTransactionReplacementDetection?: boolean | undefined | undefined;
+        testnet: true;
+        custom?: Record<string, unknown> | undefined;
+        extendSchema?: Record<string, unknown> | undefined;
+        fees?: viem.ChainFees<undefined> | undefined;
+        formatters?: undefined;
+        prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+            client: viem.Client;
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+            client: viem.Client;
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+            runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+        }] | undefined;
+        serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+        verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+    };
+    readonly 84532: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "Basescan";
+                readonly url: "https://sepolia.basescan.org";
+                readonly apiUrl: "https://api-sepolia.basescan.org/api";
+            };
+        };
+        blockTime: 2000;
+        contracts: {
+            readonly disputeGameFactory: {
+                readonly 11155111: {
+                    readonly address: "0xd6E6dBf4F7EA0ac412fD8b65ED297e64BB7a06E1";
+                };
+            };
+            readonly l2OutputOracle: {
+                readonly 11155111: {
+                    readonly address: "0x84457ca9D0163FbC4bbfe4Dfbb20ba46e48DF254";
+                };
+            };
+            readonly portal: {
+                readonly 11155111: {
+                    readonly address: "0x49f53e41452c74589e85ca1677426ba426459e85";
+                    readonly blockCreated: 4446677;
+                };
+            };
+            readonly l1StandardBridge: {
+                readonly 11155111: {
+                    readonly address: "0xfd0Bf71F60660E2f608ed56e1659C450eB113120";
+                    readonly blockCreated: 4446677;
+                };
+            };
+            readonly multicall3: {
+                readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+                readonly blockCreated: 1059647;
+            };
+            readonly gasPriceOracle: {
+                readonly address: "0x420000000000000000000000000000000000000F";
+            };
+            readonly l1Block: {
+                readonly address: "0x4200000000000000000000000000000000000015";
+            };
+            readonly l2CrossDomainMessenger: {
+                readonly address: "0x4200000000000000000000000000000000000007";
+            };
+            readonly l2Erc721Bridge: {
+                readonly address: "0x4200000000000000000000000000000000000014";
+            };
+            readonly l2StandardBridge: {
+                readonly address: "0x4200000000000000000000000000000000000010";
+            };
+            readonly l2ToL1MessagePasser: {
+                readonly address: "0x4200000000000000000000000000000000000016";
+            };
+        };
+        ensTlds?: readonly string[] | undefined;
+        id: 84532;
+        name: "Base Sepolia";
+        nativeCurrency: {
+            readonly name: "Sepolia Ether";
+            readonly symbol: "ETH";
+            readonly decimals: 18;
+        };
+        experimental_preconfirmationTime?: number | undefined | undefined;
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://sepolia.base.org"];
+            };
+        };
+        sourceId: 11155111;
+        supportsTransactionReplacementDetection?: boolean | undefined | undefined;
+        testnet: true;
+        custom?: Record<string, unknown> | undefined;
+        extendSchema?: Record<string, unknown> | undefined;
+        fees?: viem.ChainFees<undefined> | undefined;
+        formatters: {
+            readonly block: {
+                exclude: [] | undefined;
+                format: (args: viem_chains.OpStackRpcBlock, action?: string | undefined) => {
+                    baseFeePerGas: bigint | null;
+                    blobGasUsed: bigint;
+                    difficulty: bigint;
+                    excessBlobGas: bigint;
+                    extraData: viem.Hex;
+                    gasLimit: bigint;
+                    gasUsed: bigint;
+                    hash: `0x${string}` | null;
+                    logsBloom: `0x${string}` | null;
+                    miner: `0x${string}`;
+                    mixHash: viem.Hash;
+                    nonce: `0x${string}` | null;
+                    number: bigint | null;
+                    parentBeaconBlockRoot?: `0x${string}` | undefined;
+                    parentHash: viem.Hash;
+                    receiptsRoot: viem.Hex;
+                    sealFields: viem.Hex[];
+                    sha3Uncles: viem.Hash;
+                    size: bigint;
+                    stateRoot: viem.Hash;
+                    timestamp: bigint;
+                    totalDifficulty: bigint | null;
+                    transactions: `0x${string}`[] | viem_chains.OpStackTransaction<boolean>[];
+                    transactionsRoot: viem.Hash;
+                    uncles: viem.Hash[];
+                    withdrawals?: viem.Withdrawal[] | undefined | undefined;
+                    withdrawalsRoot?: `0x${string}` | undefined;
+                } & {};
+                type: "block";
+            };
+            readonly transaction: {
+                exclude: [] | undefined;
+                format: (args: viem_chains.OpStackRpcTransaction, action?: string | undefined) => ({
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: boolean;
+                    mint?: bigint | undefined | undefined;
+                    sourceHash: viem.Hex;
+                    type: "deposit";
+                } | {
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    v: bigint;
+                    to: `0x${string}` | null;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    nonce: number;
+                    value: bigint;
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    accessList?: undefined | undefined;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId?: number | undefined;
+                    yParity?: undefined | undefined;
+                    type: "legacy";
+                    gasPrice: bigint;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas?: undefined | undefined;
+                    maxPriorityFeePerGas?: undefined | undefined;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId: number;
+                    type: "eip2930";
+                    gasPrice: bigint;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas?: undefined | undefined;
+                    maxPriorityFeePerGas?: undefined | undefined;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId: number;
+                    type: "eip1559";
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes: readonly viem.Hex[];
+                    chainId: number;
+                    type: "eip4844";
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas: bigint;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList: viem.SignedAuthorizationList;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId: number;
+                    type: "eip7702";
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                }) & {};
+                type: "transaction";
+            };
+            readonly transactionReceipt: {
+                exclude: [] | undefined;
+                format: (args: viem_chains.OpStackRpcTransactionReceipt, action?: string | undefined) => {
+                    blobGasPrice?: bigint | undefined;
+                    blobGasUsed?: bigint | undefined;
+                    blockHash: viem.Hash;
+                    blockNumber: bigint;
+                    blockTimestamp?: bigint | undefined;
+                    contractAddress: `0x${string}` | null | undefined;
+                    cumulativeGasUsed: bigint;
+                    effectiveGasPrice: bigint;
+                    from: `0x${string}`;
+                    gasUsed: bigint;
+                    logs: viem.Log<bigint, number, false>[];
+                    logsBloom: viem.Hex;
+                    root?: `0x${string}` | undefined;
+                    status: "success" | "reverted";
+                    to: `0x${string}` | null;
+                    transactionHash: viem.Hash;
+                    transactionIndex: number;
+                    type: viem.TransactionType;
+                    depositNonce?: bigint | undefined | undefined;
+                    depositReceiptVersion?: number | undefined | undefined;
+                    l1GasPrice: bigint | null;
+                    l1GasUsed: bigint | null;
+                    l1Fee: bigint | null;
+                    l1FeeScalar: number | null;
+                } & {};
+                type: "transactionReceipt";
+            };
+        };
+        prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+            client: viem.Client;
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+            client: viem.Client;
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+            runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+        }] | undefined;
+        serializers: {
+            readonly transaction: typeof viem_chains.serializeTransactionOpStack;
+        };
+        verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+        readonly network: "base-sepolia";
+    };
+    readonly 1301: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "Uniscan";
+                readonly url: "https://sepolia.uniscan.xyz";
+                readonly apiUrl: "https://api-sepolia.uniscan.xyz/api";
+            };
+        };
+        blockTime: 1000;
+        contracts: {
+            readonly multicall3: {
+                readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+                readonly blockCreated: 0;
+            };
+            readonly portal: {
+                readonly 11155111: {
+                    readonly address: "0x0d83dab629f0e0F9d36c0Cbc89B69a489f0751bD";
+                };
+            };
+            readonly l1StandardBridge: {
+                readonly 11155111: {
+                    readonly address: "0xea58fcA6849d79EAd1f26608855c2D6407d54Ce2";
+                };
+            };
+            readonly disputeGameFactory: {
+                readonly 11155111: {
+                    readonly address: "0xeff73e5aa3B9AEC32c659Aa3E00444d20a84394b";
+                };
+            };
+            readonly gasPriceOracle: {
+                readonly address: "0x420000000000000000000000000000000000000F";
+            };
+            readonly l1Block: {
+                readonly address: "0x4200000000000000000000000000000000000015";
+            };
+            readonly l2CrossDomainMessenger: {
+                readonly address: "0x4200000000000000000000000000000000000007";
+            };
+            readonly l2Erc721Bridge: {
+                readonly address: "0x4200000000000000000000000000000000000014";
+            };
+            readonly l2StandardBridge: {
+                readonly address: "0x4200000000000000000000000000000000000010";
+            };
+            readonly l2ToL1MessagePasser: {
+                readonly address: "0x4200000000000000000000000000000000000016";
+            };
+        };
+        ensTlds?: readonly string[] | undefined;
+        id: 1301;
+        name: "Unichain Sepolia";
+        nativeCurrency: {
+            readonly name: "Ether";
+            readonly symbol: "ETH";
+            readonly decimals: 18;
+        };
+        experimental_preconfirmationTime?: number | undefined | undefined;
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://sepolia.unichain.org"];
+            };
+        };
+        sourceId: 11155111;
+        supportsTransactionReplacementDetection?: boolean | undefined | undefined;
+        testnet: true;
+        custom?: Record<string, unknown> | undefined;
+        extendSchema?: Record<string, unknown> | undefined;
+        fees?: viem.ChainFees<undefined> | undefined;
+        formatters: {
+            readonly block: {
+                exclude: [] | undefined;
+                format: (args: viem_chains.OpStackRpcBlock, action?: string | undefined) => {
+                    baseFeePerGas: bigint | null;
+                    blobGasUsed: bigint;
+                    difficulty: bigint;
+                    excessBlobGas: bigint;
+                    extraData: viem.Hex;
+                    gasLimit: bigint;
+                    gasUsed: bigint;
+                    hash: `0x${string}` | null;
+                    logsBloom: `0x${string}` | null;
+                    miner: `0x${string}`;
+                    mixHash: viem.Hash;
+                    nonce: `0x${string}` | null;
+                    number: bigint | null;
+                    parentBeaconBlockRoot?: `0x${string}` | undefined;
+                    parentHash: viem.Hash;
+                    receiptsRoot: viem.Hex;
+                    sealFields: viem.Hex[];
+                    sha3Uncles: viem.Hash;
+                    size: bigint;
+                    stateRoot: viem.Hash;
+                    timestamp: bigint;
+                    totalDifficulty: bigint | null;
+                    transactions: `0x${string}`[] | viem_chains.OpStackTransaction<boolean>[];
+                    transactionsRoot: viem.Hash;
+                    uncles: viem.Hash[];
+                    withdrawals?: viem.Withdrawal[] | undefined | undefined;
+                    withdrawalsRoot?: `0x${string}` | undefined;
+                } & {};
+                type: "block";
+            };
+            readonly transaction: {
+                exclude: [] | undefined;
+                format: (args: viem_chains.OpStackRpcTransaction, action?: string | undefined) => ({
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: boolean;
+                    mint?: bigint | undefined | undefined;
+                    sourceHash: viem.Hex;
+                    type: "deposit";
+                } | {
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    v: bigint;
+                    to: `0x${string}` | null;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    nonce: number;
+                    value: bigint;
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    accessList?: undefined | undefined;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId?: number | undefined;
+                    yParity?: undefined | undefined;
+                    type: "legacy";
+                    gasPrice: bigint;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas?: undefined | undefined;
+                    maxPriorityFeePerGas?: undefined | undefined;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId: number;
+                    type: "eip2930";
+                    gasPrice: bigint;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas?: undefined | undefined;
+                    maxPriorityFeePerGas?: undefined | undefined;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId: number;
+                    type: "eip1559";
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList?: undefined | undefined;
+                    blobVersionedHashes: readonly viem.Hex[];
+                    chainId: number;
+                    type: "eip4844";
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas: bigint;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                } | {
+                    blockHash: `0x${string}` | null;
+                    blockNumber: bigint | null;
+                    blockTimestamp?: bigint | undefined;
+                    from: `0x${string}`;
+                    gas: bigint;
+                    hash: viem.Hash;
+                    input: viem.Hex;
+                    nonce: number;
+                    r: viem.Hex;
+                    s: viem.Hex;
+                    to: `0x${string}` | null;
+                    transactionIndex: number | null;
+                    typeHex: viem.Hex | null;
+                    v: bigint;
+                    value: bigint;
+                    yParity: number;
+                    accessList: viem.AccessList;
+                    authorizationList: viem.SignedAuthorizationList;
+                    blobVersionedHashes?: undefined | undefined;
+                    chainId: number;
+                    type: "eip7702";
+                    gasPrice?: undefined | undefined;
+                    maxFeePerBlobGas?: undefined | undefined;
+                    maxFeePerGas: bigint;
+                    maxPriorityFeePerGas: bigint;
+                    isSystemTx?: undefined | undefined;
+                    mint?: undefined | undefined;
+                    sourceHash?: undefined | undefined;
+                }) & {};
+                type: "transaction";
+            };
+            readonly transactionReceipt: {
+                exclude: [] | undefined;
+                format: (args: viem_chains.OpStackRpcTransactionReceipt, action?: string | undefined) => {
+                    blobGasPrice?: bigint | undefined;
+                    blobGasUsed?: bigint | undefined;
+                    blockHash: viem.Hash;
+                    blockNumber: bigint;
+                    blockTimestamp?: bigint | undefined;
+                    contractAddress: `0x${string}` | null | undefined;
+                    cumulativeGasUsed: bigint;
+                    effectiveGasPrice: bigint;
+                    from: `0x${string}`;
+                    gasUsed: bigint;
+                    logs: viem.Log<bigint, number, false>[];
+                    logsBloom: viem.Hex;
+                    root?: `0x${string}` | undefined;
+                    status: "success" | "reverted";
+                    to: `0x${string}` | null;
+                    transactionHash: viem.Hash;
+                    transactionIndex: number;
+                    type: viem.TransactionType;
+                    depositNonce?: bigint | undefined | undefined;
+                    depositReceiptVersion?: number | undefined | undefined;
+                    l1GasPrice: bigint | null;
+                    l1GasUsed: bigint | null;
+                    l1Fee: bigint | null;
+                    l1FeeScalar: number | null;
+                } & {};
+                type: "transactionReceipt";
+            };
+        };
+        prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+            client: viem.Client;
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+            client: viem.Client;
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+            runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+        }] | undefined;
+        serializers: {
+            readonly transaction: typeof viem_chains.serializeTransactionOpStack;
+        };
+        verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+    };
+};
+type SupportedChainId = keyof typeof SUPPORTED_CHAINS;
+/**
+ * Approximate seconds per block, used to turn a block countdown into a human
+ * "time remaining". Estimates - block times drift.
+ */
+declare const BLOCK_TIME_SECONDS: Record<number, number>;
+/**
+ * Maximum block span for a single `eth_getLogs` call.
+ *
+ * Public Sepolia RPCs reject anything wider with
+ * `-32701: exceed maximum block range: 50000`, and some clients surface that as
+ * an empty result rather than an error - which looks exactly like "no auctions
+ * exist". Discovery always chunks.
+ */
+declare const DEFAULT_LOG_CHUNK_SIZE = 50000n;
+/** `address(0)` - the currency sentinel meaning native ETH. */
+declare const NATIVE_CURRENCY: Address;
+/**
+ * Canonical Permit2, deployed at the same address on every chain.
+ *
+ * ERC-20 bids do NOT approve the auction. `ContinuousClearingAuction.submitBid`
+ * pulls the bid currency with `SafeTransferLib.permit2TransferFrom`, which
+ * calls Permit2's `transferFrom(from,to,uint160,token)`. A bidder therefore
+ * needs an ERC-20 approval to THIS address, plus a Permit2 allowance naming the
+ * auction as spender. Matches solady's `SafeTransferLib.PERMIT2`.
+ */
+declare const PERMIT2_ADDRESS: Address;
+
+/** The factory event that announces every new auction. */
+declare const auctionCreatedEvent: {
+    readonly type: "event";
+    readonly name: "AuctionCreated";
+    readonly inputs: readonly [{
+        readonly name: "auction";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "configData";
+        readonly type: "bytes";
+        readonly indexed: false;
+        readonly internalType: "bytes";
+    }];
+    readonly anonymous: false;
+};
+interface ScanOptions {
+    /** First block to scan. Defaults to the factory's deploy block. */
+    fromBlock?: bigint;
+    /** Last block to scan. Defaults to the current head. */
+    toBlock?: bigint;
+    /** Blocks per `eth_getLogs` request. Defaults to 50,000. */
+    chunkSize?: bigint;
+    /**
+     * Re-query a chunk that came back empty, this many times, before believing it.
+     *
+     * Some public RPCs (observed on ethereum-sepolia-rpc.publicnode.com) are load
+     * balanced across backends with incomplete log indexes and answer an
+     * identical `eth_getLogs` with either the real logs or an empty array, with no
+     * error. That silently under-reports auctions. Re-querying an empty chunk
+     * reduces the chance of believing a false empty, but CANNOT eliminate it -
+     * the real fix is a reliable RPC endpoint. Defaults to 2.
+     */
+    emptyChunkRetries?: number;
+    /**
+     * Called when an empty chunk turned out to be a lie on retry. A caller seeing
+     * these should switch RPC providers rather than trust the scan.
+     */
+    onAnomaly?: (anomaly: {
+        fromBlock: bigint;
+        toBlock: bigint;
+        recoveredLogs: number;
+    }) => void;
+    /** Called after each chunk, for progress reporting on long scans. */
+    onProgress?: (progress: {
+        fromBlock: bigint;
+        toBlock: bigint;
+        scannedTo: bigint;
+        headBlock: bigint;
+        found: number;
+    }) => void;
+}
+/**
+ * Scan a block range for `AuctionCreated` events, chunked.
+ *
+ * Returns auctions in chain order (oldest first). On a chunk failure the chunk
+ * size is halved and retried, so a stricter-than-expected RPC degrades into a
+ * slower scan rather than a wrong answer.
+ */
+declare function scanAuctions(client: BeaconClient, options?: ScanOptions): Promise<DiscoveredAuction[]>;
+/**
+ * Watch for auctions created from now on.
+ *
+ * Polls rather than subscribing, so it works over plain HTTP RPC with no
+ * WebSocket endpoint. Returns an unwatch function.
+ */
+declare function watchAuctions(client: BeaconClient, onAuction: (auction: DiscoveredAuction) => void, options?: {
+    pollingIntervalMs?: number;
+    onError?: (error: Error) => void;
+}): () => void;
+/**
+ * Auctions created for a specific token.
+ * Uses an indexed-topic filter so the RPC does the work, not the client.
+ */
+declare function scanAuctionsForToken(client: BeaconClient, token: Address, options?: ScanOptions): Promise<DiscoveredAuction[]>;
+
+/**
+ * Private-key format normalisation.
+ *
+ * This module does exactly one thing: turn a key string into the `0x`-prefixed
+ * form viem requires, or throw. It never logs, never stores, and never returns
+ * anything derived from the key other than the key itself.
+ *
+ * It exists because wallets and key exporters disagree about the `0x` prefix -
+ * Foundry's `cast wallet new` prints one, several UIs do not - and bouncing a
+ * user back to edit their `.env` over two characters is a poor trade for the
+ * risk of them pasting the key somewhere less safe while they fix it.
+ */
+/** A 32-byte private key in the form viem expects. */
+type PrivateKeyHex = `0x${string}`;
+declare class PrivateKeyFormatError extends Error {
+}
+/**
+ * Normalise a private key to `0x` + 64 hex characters.
+ *
+ * Accepts the key with or without the prefix. Every error message here is
+ * deliberately written to describe the SHAPE of the problem and never to echo
+ * any part of the value.
+ *
+ * @throws PrivateKeyFormatError when the value is not a 32-byte hex key.
+ */
+declare function normalizePrivateKey(raw: string | undefined, envVarName: string): PrivateKeyHex;
+/** True when a key is present and well-formed, without throwing. */
+declare function isValidPrivateKey(raw: string | undefined): boolean;
+
+/**
+ * Q96 fixed-point helpers.
+ *
+ * CCA encodes prices as Q96: a value multiplied by 2^96. This module is the
+ * ONLY place in Beacon that converts between Q96 and human-readable numbers.
+ * The web app, widget, bot and agent all import from here rather than
+ * reimplementing `/ 2 ** 96` with floating point.
+ *
+ * Everything here is exact BigInt arithmetic except {@link q96ToNumber}, which
+ * is explicitly lossy and documented as such.
+ */
+/** 2^96 - the Q96 fixed-point scaling factor. */
+declare const Q96: bigint;
+/**
+ * MPS ("milli-bips", one thousandth of a basis point) = 1e7.
+ *
+ * The auction tracks how much of its supply SCHEDULE has been released as a
+ * `cumulativeMps` out of `MPS`. Note this tracks the schedule, not sales: an
+ * auction that ends with no bids still reaches `MPS`.
+ * Mirrors `ConstantsLib.MPS` upstream.
+ */
+declare const MPS = 10000000n;
+/** X7 values are scaled by MPS to avoid intermediate division. Mirrors `ValueX7`. */
+declare const X7 = 10000000n;
+/**
+ * Convert a Q96 value to an exact decimal string.
+ *
+ * Exact for the requested precision - the fractional part is computed with
+ * BigInt division and truncated (never rounded up), so the result never
+ * overstates a price.
+ *
+ * @param valueQ96 The Q96-encoded value.
+ * @param precision Fractional digits to emit. Defaults to 18.
+ * @param trimTrailingZeros Drop trailing fractional zeros. Defaults to true.
+ */
+declare function q96ToDecimalString(valueQ96: bigint, precision?: number, trimTrailingZeros?: boolean): string;
+/**
+ * Convert a Q96 value to a JavaScript number.
+ *
+ * LOSSY. `number` is a float64, so values beyond ~2^53 or with more than ~15
+ * significant digits lose precision. Use for charts, sorting and display only -
+ * never for anything that gets sent back on-chain. Use
+ * {@link q96ToDecimalString} when exactness matters.
+ */
+declare function q96ToNumber(valueQ96: bigint): number;
+/**
+ * Convert a decimal value to Q96, exactly.
+ *
+ * Accepts a string (preferred - no float rounding) or a number. Fractional
+ * digits beyond what Q96 can represent are truncated.
+ *
+ * @throws TypeError on a malformed or non-finite input.
+ */
+declare function decimalToQ96(decimal: string | number): bigint;
+/**
+ * Format a Q96 value for human display.
+ *
+ * Unlike {@link q96ToDecimalString}, which truncates for exactness, this ROUNDS
+ * half-up at the chosen precision. That matters: 0.0001 is not exactly
+ * representable in Q96, so a truncating formatter renders it as
+ * "0.0000999999999999" - technically accurate and useless in a UI.
+ *
+ * For values below 1 the digit budget starts at the first non-zero digit, so
+ * very small prices stay readable instead of showing a wall of zeros.
+ *
+ * @param significantDigits Digits to keep after the first significant one
+ *   (or fractional digits, for values >= 1). Defaults to 6.
+ */
+declare function formatQ96(valueQ96: bigint, significantDigits?: number): string;
+/**
+ * Fraction of the supply schedule released so far, from a checkpoint's
+ * `cumulativeMps`. Returns a value in [0, 1]. Not the fraction sold.
+ */
+declare function mpsToFraction(cumulativeMps: bigint | number): number;
+/** Percentage of the supply schedule released so far, e.g. `"12.34"`. */
+declare function formatMpsPercent(cumulativeMps: bigint | number, fractionDigits?: number): string;
+/** Unwrap a ValueX7 (a value pre-multiplied by MPS) back to its base units. */
+declare function fromValueX7(valueX7: bigint): bigint;
+/**
+ * Format a Q96 value compactly, switching to scientific notation when a value
+ * is too small to read as a decimal.
+ *
+ * Real CCA clearing prices on Sepolia are around 5.4e-20. Rendered plainly that
+ * is "0.000000000000000000054212" - 25 characters of mostly zeros, which
+ * destroys a table layout and is genuinely hard to compare at a glance. Below
+ * 1e-6 this switches to "5.4212e-20".
+ *
+ * Rounding is inherited from {@link formatQ96}, so the compact and plain
+ * renderings of the same value never disagree.
+ */
+declare function formatQ96Compact(valueQ96: bigint, significantDigits?: number): string;
+
+/**
+ * Address the lens bytecode is injected at when no deployed lens is configured.
+ * Arbitrary and unused on-chain: it only has to be an address nothing else
+ * occupies for the duration of the call. Must be EIP-55 checksummed - viem
+ * rejects a mixed-case address whose checksum does not validate.
+ */
+declare const LENS_OVERRIDE_ADDRESS: Address;
+/**
+ * Read an auction's live state through `AuctionStateLens.state()`.
+ *
+ * This is the freshest possible view: the lens checkpoints the auction inside
+ * the simulated call, so the clearing price reflects the current block rather
+ * than the last block someone happened to bid in.
+ */
+declare function getAuctionState(client: BeaconClient, auction: Address): Promise<AuctionState>;
+/**
+ * Read an auction's static configuration in a single multicall.
+ * These values never change, so callers can cache them freely.
+ */
+declare function getAuctionInfo(client: BeaconClient, auction: Address): Promise<AuctionInfo>;
+/** The auction's current clearing price, Q96-encoded. A cheap `view` read. */
+declare function getClearingPrice(client: BeaconClient, auction: Address): Promise<bigint>;
+/** Whether the auction has raised enough to seed the pool. */
+declare function isGraduated(client: BeaconClient, auction: Address): Promise<boolean>;
+/** Derive an auction's lifecycle position from the current block. */
+declare function deriveStatus(info: AuctionInfo, blockNumber: bigint): AuctionStatus;
+/**
+ * Everything a UI needs about one auction, with the derived values (status,
+ * progress, time remaining) computed once here instead of in each app.
+ */
+declare function getAuctionSummary(client: BeaconClient, auction: Address, options?: {
+    info?: AuctionInfo;
+    blockNumber?: bigint;
+}): Promise<AuctionSummary>;
+/** A summary that failed to load, so one bad auction cannot blank a directory page. */
+interface FailedAuctionSummary {
+    auction: Address;
+    error: Error;
+}
+declare function isFailedSummary(result: AuctionSummary | FailedAuctionSummary): result is FailedAuctionSummary;
+/**
+ * Summarise many auctions with bounded concurrency, so a directory page listing
+ * dozens of auctions does not open dozens of simultaneous RPC calls.
+ */
+declare function getAuctionSummaries(client: BeaconClient, auctions: readonly Address[], options?: {
+    concurrency?: number;
+}): Promise<(AuctionSummary | FailedAuctionSummary)[]>;
+/**
+ * The cheap, batchable slice of live state used by directory list views.
+ *
+ * Every field here is a `view` function on the auction, so a whole page of
+ * auctions resolves in one multicall - no lens, no per-auction round trips.
+ * Use {@link getAuctionState} when you need the freshest checkpointed state.
+ */
+interface AuctionListState {
+    auction: Address;
+    clearingPriceQ96: bigint;
+    isGraduated: boolean;
+    currencyRaised: bigint;
+    totalCleared: bigint;
+}
+/** Read {@link AuctionListState} for many auctions in a single multicall. */
+declare function getAuctionListStates(client: BeaconClient, auctions: readonly Address[]): Promise<Map<Address, AuctionListState>>;
+
+/** ERC-20 approval + balance surface. */
+declare const erc20ApprovalAbi: readonly [{
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "name";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];
+/** Permit2 AllowanceTransfer, the second half of the ERC-20 approval flow. */
+declare const permit2Abi: readonly [{
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint48";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}];
+interface TransactionRequest {
+    to: Address;
+    data: Hex;
+    value: bigint;
+}
+/**
+ * Round a price DOWN to the nearest tick boundary.
+ *
+ * `submitBid` reverts with `TickPriceNotAtBoundary()` unless `maxPrice` is an
+ * exact multiple of the auction's `tickSpacing` - the same rule the constructor
+ * applies to the floor price, but it also applies to every bid. A price typed
+ * by a human almost never lands on a boundary, so it has to be snapped.
+ *
+ * Rounding DOWN is the only safe direction: it can only lower the ceiling a
+ * bidder is committing to, never raise it above what they asked for.
+ */
+declare function alignPriceToTickBoundary(priceQ96: bigint, tickSpacing: bigint): bigint;
+/** True when a price sits exactly on a tick boundary. */
+declare function isPriceOnTickBoundary(priceQ96: bigint, tickSpacing: bigint): boolean;
+interface SubmitBidParams {
+    auction: Address;
+    /** Highest price the bidder will pay, Q96-encoded. Use `decimalToQ96`. */
+    maxPriceQ96: bigint;
+    /** Bid size, in the currency's smallest unit. uint128 on-chain. */
+    amount: bigint;
+    /** Who owns the resulting bid. */
+    owner: Address;
+    /** Extra data for a validation hook, if the auction has one. */
+    hookData?: Hex;
+    /** True when the auction's currency is native ETH, so `value` must be sent. */
+    isNativeCurrency: boolean;
+    /**
+     * Search hint: the initialised tick at or below `maxPriceQ96`. Omit to use
+     * the floor price, which is always correct but costs more gas.
+     * See {@link getPrevTickHint}.
+     */
+    prevTickPriceQ96?: bigint;
+    /**
+     * The auction's tick spacing. When given, the price is checked against it so
+     * a misaligned bid fails here with a clear message instead of on-chain with
+     * an opaque `TickPriceNotAtBoundary()`.
+     */
+    tickSpacing?: bigint;
+}
+/**
+ * Encode a `submitBid` call.
+ *
+ * @throws RangeError if the amount does not fit the contract's `uint128`.
+ */
+declare function encodeSubmitBid(params: SubmitBidParams): TransactionRequest;
+/**
+ * Look up a `prevTickPrice` hint.
+ *
+ * The auction inserts a bid by walking initialised ticks upward from this
+ * price. `nextActiveTickPrice()` is the next initialised tick above the current
+ * clearing price, so it is a strictly better starting point than the floor
+ * whenever the bid sits above it. Anything at or above `maxPrice` would make
+ * the contract search past the target, so those fall back to the floor.
+ *
+ * A wrong hint cannot make a bid execute at a different price - it only affects
+ * how far the contract searches - but a hint above the target reverts, so this
+ * is deliberately conservative.
+ */
+declare function getPrevTickHint(client: BeaconClient, auction: Address, maxPriceQ96: bigint): Promise<bigint>;
+/** Approve Permit2 to move the bid currency. Step 1 of 2 for ERC-20 bids. */
+declare function encodeApproveErc20ToPermit2(currency: Address, amount?: bigint): TransactionRequest;
+/**
+ * Grant the auction a Permit2 allowance. Step 2 of 2 for ERC-20 bids.
+ *
+ * @param expiration Unix seconds. Defaults to 30 days out; Permit2 stores this
+ *   as a uint48, and an expired allowance fails at transfer time.
+ */
+declare function encodeApprovePermit2(currency: Address, auction: Address, amount?: bigint, expiration?: bigint): TransactionRequest;
+interface BidReadiness {
+    /** Whether the bidder holds enough of the currency. */
+    hasBalance: boolean;
+    balance: bigint;
+    /** ERC-20 allowance granted to Permit2. Unlimited for native currency. */
+    erc20AllowanceToPermit2: bigint;
+    /** Permit2 allowance granted to the auction. Unlimited for native currency. */
+    permit2AllowanceToAuction: bigint;
+    /** When the Permit2 allowance lapses, as unix seconds. */
+    permit2Expiration: bigint;
+    /** True when step 1 (ERC-20 -> Permit2) is still needed. */
+    needsErc20Approval: boolean;
+    /** True when step 2 (Permit2 -> auction) is still needed. */
+    needsPermit2Approval: boolean;
+    /** Convenience: either approval step is outstanding. */
+    needsApproval: boolean;
+}
+/**
+ * Check whether a bidder can actually submit a given bid right now.
+ *
+ * Native-currency auctions need no approvals at all, so those are reported as
+ * unlimited rather than pretending an allowance was read.
+ */
+declare function checkBidReadiness(client: BeaconClient, params: {
+    auction: Address;
+    currency: Address;
+    bidder: Address;
+    amount: bigint;
+}): Promise<BidReadiness>;
+/**
+ * Every transaction needed to place this bid, in order.
+ * One entry for a native bid; up to three for an ERC-20 bid.
+ */
+declare function buildBidTransactions(params: {
+    auction: Address;
+    currency: Address;
+    maxPriceQ96: bigint;
+    amount: bigint;
+    owner: Address;
+    readiness: BidReadiness;
+    prevTickPriceQ96?: bigint;
+    hookData?: Hex;
+    /** When given, the price is snapped down to a boundary before encoding. */
+    tickSpacing?: bigint;
+}): Array<{
+    label: string;
+    request: TransactionRequest;
+}>;
+/**
+ * Why a bid cannot be submitted, or `null` when it can.
+ * Callers use this to disable a bid button with an honest reason.
+ */
+declare function describeBidBlocker(input: {
+    status: "pending" | "live" | "ended";
+    amount: bigint;
+    maxPriceQ96: bigint;
+    floorPriceQ96: bigint;
+    tickSpacing?: bigint;
+    readiness?: BidReadiness;
+}): string | null;
+
+export { AuctionInfo, type AuctionListState, type AuctionParameters, AuctionParametersError, AuctionState, AuctionStatus, type AuctionStep, AuctionSummary, BLOCK_TIME_SECONDS, BeaconClient, type BidReadiness, DEFAULT_LOG_CHUNK_SIZE, DiscoveredAuction, FACTORY_ADDRESS, FACTORY_DEPLOY_BLOCK, type FailedAuctionSummary, LENS_OVERRIDE_ADDRESS, MIN_FLOOR_PRICE, MIN_TICK_SPACING, MPS, NATIVE_CURRENCY, PERMIT2_ADDRESS, PrivateKeyFormatError, type PrivateKeyHex, Q96, SUPPORTED_CHAINS, type ScanOptions, type SubmitBidParams, type SupportedChainId, type TransactionRequest, UPSTREAM_COMMIT, UPSTREAM_TAG, X7, alignPriceToTickBoundary, auctionAbi, auctionCreatedEvent, auctionStateLensAbi, auctionStateLensDeployedBytecode, buildAuctionSteps, buildBidTransactions, checkBidReadiness, decimalToQ96, decodeAuctionParameters, deriveStatus, describeBidBlocker, encodeApproveErc20ToPermit2, encodeApprovePermit2, encodeAuctionParameters, encodeSubmitBid, erc20ApprovalAbi, factoryAbi, formatMpsPercent, formatQ96, formatQ96Compact, fromValueX7, getAuctionInfo, getAuctionListStates, getAuctionState, getAuctionSummaries, getAuctionSummary, getClearingPrice, getPrevTickHint, isFailedSummary, isGraduated, isPriceOnTickBoundary, isValidPrivateKey, mpsToFraction, normalizePrivateKey, packAuctionSteps, permit2Abi, q96ToDecimalString, q96ToNumber, scanAuctions, scanAuctionsForToken, totalBlocks, totalMps, unpackAuctionSteps, validateAuctionParameters, watchAuctions };