@hammerock/cca-sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,998 @@
+'use strict';
+
+var viem = require('viem');
+var chains = require('viem/chains');
+
+// src/abis/auction.ts
+var auctionAbi = [{ "type": "constructor", "inputs": [{ "name": "_token", "type": "address", "internalType": "address" }, { "name": "_totalSupply", "type": "uint128", "internalType": "uint128" }, { "name": "_parameters", "type": "tuple", "internalType": "struct AuctionParameters", "components": [{ "name": "currency", "type": "address", "internalType": "address" }, { "name": "tokensRecipient", "type": "address", "internalType": "address" }, { "name": "fundsRecipient", "type": "address", "internalType": "address" }, { "name": "startBlock", "type": "uint64", "internalType": "uint64" }, { "name": "endBlock", "type": "uint64", "internalType": "uint64" }, { "name": "claimBlock", "type": "uint64", "internalType": "uint64" }, { "name": "tickSpacing", "type": "uint256", "internalType": "uint256" }, { "name": "validationHook", "type": "address", "internalType": "address" }, { "name": "floorPrice", "type": "uint256", "internalType": "uint256" }, { "name": "requiredCurrencyRaised", "type": "uint128", "internalType": "uint128" }, { "name": "auctionStepsData", "type": "bytes", "internalType": "bytes" }] }], "stateMutability": "nonpayable" }, { "type": "function", "name": "MAX_BID_PRICE", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "MAX_BLOCK_NUMBER", "inputs": [], "outputs": [{ "name": "", "type": "uint64", "internalType": "uint64" }], "stateMutability": "view" }, { "type": "function", "name": "MAX_TICK_PTR", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "bids", "inputs": [{ "name": "bidId", "type": "uint256", "internalType": "uint256" }], "outputs": [{ "name": "", "type": "tuple", "internalType": "struct Bid", "components": [{ "name": "startBlock", "type": "uint64", "internalType": "uint64" }, { "name": "startCumulativeMps", "type": "uint24", "internalType": "uint24" }, { "name": "exitedBlock", "type": "uint64", "internalType": "uint64" }, { "name": "maxPrice", "type": "uint256", "internalType": "uint256" }, { "name": "owner", "type": "address", "internalType": "address" }, { "name": "amountQ96", "type": "uint256", "internalType": "uint256" }, { "name": "tokensFilled", "type": "uint256", "internalType": "uint256" }] }], "stateMutability": "view" }, { "type": "function", "name": "checkpoint", "inputs": [], "outputs": [{ "name": "", "type": "tuple", "internalType": "struct Checkpoint", "components": [{ "name": "clearingPrice", "type": "uint256", "internalType": "uint256" }, { "name": "currencyRaisedAtClearingPriceQ96_X7", "type": "uint256", "internalType": "ValueX7" }, { "name": "cumulativeMpsPerPrice", "type": "uint256", "internalType": "uint256" }, { "name": "cumulativeMps", "type": "uint24", "internalType": "uint24" }, { "name": "prev", "type": "uint64", "internalType": "uint64" }, { "name": "next", "type": "uint64", "internalType": "uint64" }] }], "stateMutability": "nonpayable" }, { "type": "function", "name": "checkpoints", "inputs": [{ "name": "blockNumber", "type": "uint64", "internalType": "uint64" }], "outputs": [{ "name": "", "type": "tuple", "internalType": "struct Checkpoint", "components": [{ "name": "clearingPrice", "type": "uint256", "internalType": "uint256" }, { "name": "currencyRaisedAtClearingPriceQ96_X7", "type": "uint256", "internalType": "ValueX7" }, { "name": "cumulativeMpsPerPrice", "type": "uint256", "internalType": "uint256" }, { "name": "cumulativeMps", "type": "uint24", "internalType": "uint24" }, { "name": "prev", "type": "uint64", "internalType": "uint64" }, { "name": "next", "type": "uint64", "internalType": "uint64" }] }], "stateMutability": "view" }, { "type": "function", "name": "claimBlock", "inputs": [], "outputs": [{ "name": "", "type": "uint64", "internalType": "uint64" }], "stateMutability": "view" }, { "type": "function", "name": "claimTokens", "inputs": [{ "name": "_bidId", "type": "uint256", "internalType": "uint256" }], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "claimTokensBatch", "inputs": [{ "name": "_owner", "type": "address", "internalType": "address" }, { "name": "_bidIds", "type": "uint256[]", "internalType": "uint256[]" }], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "clearingPrice", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "currency", "inputs": [], "outputs": [{ "name": "", "type": "address", "internalType": "address" }], "stateMutability": "view" }, { "type": "function", "name": "currencyRaised", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "currencyRaisedQ96_X7", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "ValueX7" }], "stateMutability": "view" }, { "type": "function", "name": "endBlock", "inputs": [], "outputs": [{ "name": "", "type": "uint64", "internalType": "uint64" }], "stateMutability": "view" }, { "type": "function", "name": "exitBid", "inputs": [{ "name": "_bidId", "type": "uint256", "internalType": "uint256" }], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "exitPartiallyFilledBid", "inputs": [{ "name": "_bidId", "type": "uint256", "internalType": "uint256" }, { "name": "_lastFullyFilledCheckpointBlock", "type": "uint64", "internalType": "uint64" }, { "name": "_outbidBlock", "type": "uint64", "internalType": "uint64" }], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "floorPrice", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "forceIterateOverTicks", "inputs": [{ "name": "_untilTickPrice", "type": "uint256", "internalType": "uint256" }], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "nonpayable" }, { "type": "function", "name": "fundsRecipient", "inputs": [], "outputs": [{ "name": "", "type": "address", "internalType": "address" }], "stateMutability": "view" }, { "type": "function", "name": "isGraduated", "inputs": [], "outputs": [{ "name": "", "type": "bool", "internalType": "bool" }], "stateMutability": "view" }, { "type": "function", "name": "lastCheckpointedBlock", "inputs": [], "outputs": [{ "name": "", "type": "uint64", "internalType": "uint64" }], "stateMutability": "view" }, { "type": "function", "name": "latestCheckpoint", "inputs": [], "outputs": [{ "name": "", "type": "tuple", "internalType": "struct Checkpoint", "components": [{ "name": "clearingPrice", "type": "uint256", "internalType": "uint256" }, { "name": "currencyRaisedAtClearingPriceQ96_X7", "type": "uint256", "internalType": "ValueX7" }, { "name": "cumulativeMpsPerPrice", "type": "uint256", "internalType": "uint256" }, { "name": "cumulativeMps", "type": "uint24", "internalType": "uint24" }, { "name": "prev", "type": "uint64", "internalType": "uint64" }, { "name": "next", "type": "uint64", "internalType": "uint64" }] }], "stateMutability": "view" }, { "type": "function", "name": "lbpInitializationParams", "inputs": [], "outputs": [{ "name": "params", "type": "tuple", "internalType": "struct LBPInitializationParams", "components": [{ "name": "initialPriceX96", "type": "uint256", "internalType": "uint256" }, { "name": "tokensSold", "type": "uint256", "internalType": "uint256" }, { "name": "currencyRaised", "type": "uint256", "internalType": "uint256" }] }], "stateMutability": "view" }, { "type": "function", "name": "nextActiveTickPrice", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "nextBidId", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "onTokensReceived", "inputs": [], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "pointer", "inputs": [], "outputs": [{ "name": "", "type": "address", "internalType": "address" }], "stateMutability": "view" }, { "type": "function", "name": "startBlock", "inputs": [], "outputs": [{ "name": "", "type": "uint64", "internalType": "uint64" }], "stateMutability": "view" }, { "type": "function", "name": "step", "inputs": [], "outputs": [{ "name": "", "type": "tuple", "internalType": "struct AuctionStep", "components": [{ "name": "mps", "type": "uint24", "internalType": "uint24" }, { "name": "startBlock", "type": "uint64", "internalType": "uint64" }, { "name": "endBlock", "type": "uint64", "internalType": "uint64" }] }], "stateMutability": "view" }, { "type": "function", "name": "submitBid", "inputs": [{ "name": "_maxPrice", "type": "uint256", "internalType": "uint256" }, { "name": "_amount", "type": "uint128", "internalType": "uint128" }, { "name": "_owner", "type": "address", "internalType": "address" }, { "name": "_hookData", "type": "bytes", "internalType": "bytes" }], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "payable" }, { "type": "function", "name": "submitBid", "inputs": [{ "name": "_maxPrice", "type": "uint256", "internalType": "uint256" }, { "name": "_amount", "type": "uint128", "internalType": "uint128" }, { "name": "_owner", "type": "address", "internalType": "address" }, { "name": "_prevTickPrice", "type": "uint256", "internalType": "uint256" }, { "name": "_hookData", "type": "bytes", "internalType": "bytes" }], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "payable" }, { "type": "function", "name": "sumCurrencyDemandAboveClearingQ96", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "supportsInterface", "inputs": [{ "name": "interfaceId", "type": "bytes4", "internalType": "bytes4" }], "outputs": [{ "name": "", "type": "bool", "internalType": "bool" }], "stateMutability": "pure" }, { "type": "function", "name": "sweepCurrency", "inputs": [], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "sweepCurrencyBlock", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "sweepUnsoldTokens", "inputs": [], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "sweepUnsoldTokensBlock", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "tickSpacing", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "ticks", "inputs": [{ "name": "price", "type": "uint256", "internalType": "uint256" }], "outputs": [{ "name": "", "type": "tuple", "internalType": "struct Tick", "components": [{ "name": "next", "type": "uint256", "internalType": "uint256" }, { "name": "currencyDemandQ96", "type": "uint256", "internalType": "uint256" }] }], "stateMutability": "view" }, { "type": "function", "name": "token", "inputs": [], "outputs": [{ "name": "", "type": "address", "internalType": "address" }], "stateMutability": "view" }, { "type": "function", "name": "tokensRecipient", "inputs": [], "outputs": [{ "name": "", "type": "address", "internalType": "address" }], "stateMutability": "view" }, { "type": "function", "name": "totalCleared", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "uint256" }], "stateMutability": "view" }, { "type": "function", "name": "totalClearedQ96_X7", "inputs": [], "outputs": [{ "name": "", "type": "uint256", "internalType": "ValueX7" }], "stateMutability": "view" }, { "type": "function", "name": "totalSupply", "inputs": [], "outputs": [{ "name": "", "type": "uint128", "internalType": "uint128" }], "stateMutability": "view" }, { "type": "function", "name": "validationHook", "inputs": [], "outputs": [{ "name": "", "type": "address", "internalType": "contract IValidationHook" }], "stateMutability": "view" }, { "type": "event", "name": "AuctionStepRecorded", "inputs": [{ "name": "startBlock", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "endBlock", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "mps", "type": "uint24", "indexed": false, "internalType": "uint24" }], "anonymous": false }, { "type": "event", "name": "BidExited", "inputs": [{ "name": "bidId", "type": "uint256", "indexed": true, "internalType": "uint256" }, { "name": "owner", "type": "address", "indexed": true, "internalType": "address" }, { "name": "tokensFilled", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "currencyRefunded", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "event", "name": "BidSubmitted", "inputs": [{ "name": "id", "type": "uint256", "indexed": true, "internalType": "uint256" }, { "name": "owner", "type": "address", "indexed": true, "internalType": "address" }, { "name": "price", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "amount", "type": "uint128", "indexed": false, "internalType": "uint128" }], "anonymous": false }, { "type": "event", "name": "CheckpointUpdated", "inputs": [{ "name": "blockNumber", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "clearingPrice", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "cumulativeMps", "type": "uint24", "indexed": false, "internalType": "uint24" }], "anonymous": false }, { "type": "event", "name": "ClearingPriceUpdated", "inputs": [{ "name": "blockNumber", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "clearingPrice", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "event", "name": "CurrencySwept", "inputs": [{ "name": "fundsRecipient", "type": "address", "indexed": true, "internalType": "address" }, { "name": "currencyAmount", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "event", "name": "NextActiveTickUpdated", "inputs": [{ "name": "price", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "event", "name": "TickInitialized", "inputs": [{ "name": "price", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "event", "name": "TokensClaimed", "inputs": [{ "name": "bidId", "type": "uint256", "indexed": true, "internalType": "uint256" }, { "name": "owner", "type": "address", "indexed": true, "internalType": "address" }, { "name": "tokensFilled", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "event", "name": "TokensReceived", "inputs": [{ "name": "totalSupply", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "event", "name": "TokensSwept", "inputs": [{ "name": "tokensRecipient", "type": "address", "indexed": true, "internalType": "address" }, { "name": "tokensAmount", "type": "uint256", "indexed": false, "internalType": "uint256" }], "anonymous": false }, { "type": "error", "name": "AuctionIsNotFinalized", "inputs": [] }, { "type": "error", "name": "AuctionIsNotOver", "inputs": [] }, { "type": "error", "name": "AuctionIsOver", "inputs": [] }, { "type": "error", "name": "AuctionNotStarted", "inputs": [] }, { "type": "error", "name": "AuctionSoldOut", "inputs": [] }, { "type": "error", "name": "BatchClaimDifferentOwner", "inputs": [{ "name": "expectedOwner", "type": "address", "internalType": "address" }, { "name": "receivedOwner", "type": "address", "internalType": "address" }] }, { "type": "error", "name": "BidAlreadyExited", "inputs": [] }, { "type": "error", "name": "BidAmountTooSmall", "inputs": [] }, { "type": "error", "name": "BidIdDoesNotExist", "inputs": [{ "name": "bidId", "type": "uint256", "internalType": "uint256" }] }, { "type": "error", "name": "BidMustBeAboveClearingPrice", "inputs": [] }, { "type": "error", "name": "BidNotExited", "inputs": [] }, { "type": "error", "name": "BidOwnerCannotBeZeroAddress", "inputs": [] }, { "type": "error", "name": "CannotExitBid", "inputs": [] }, { "type": "error", "name": "CannotPartiallyExitBidBeforeEndBlock", "inputs": [] }, { "type": "error", "name": "CannotPartiallyExitBidBeforeGraduation", "inputs": [] }, { "type": "error", "name": "CannotSweepCurrency", "inputs": [] }, { "type": "error", "name": "CannotSweepTokens", "inputs": [] }, { "type": "error", "name": "CannotUpdateUninitializedTick", "inputs": [] }, { "type": "error", "name": "CheckpointBlockNotIncreasing", "inputs": [] }, { "type": "error", "name": "ClaimBlockIsBeforeEndBlock", "inputs": [] }, { "type": "error", "name": "CurrencyIsNotNative", "inputs": [] }, { "type": "error", "name": "ERC20TransferFailed", "inputs": [] }, { "type": "error", "name": "FloorPriceAndTickSpacingGreaterThanMaxBidPrice", "inputs": [{ "name": "nextTick", "type": "uint256", "internalType": "uint256" }, { "name": "maxBidPrice", "type": "uint256", "internalType": "uint256" }] }, { "type": "error", "name": "FloorPriceAndTickSpacingTooLarge", "inputs": [] }, { "type": "error", "name": "FloorPriceIsZero", "inputs": [] }, { "type": "error", "name": "FloorPriceTooLow", "inputs": [] }, { "type": "error", "name": "FundsRecipientIsZero", "inputs": [] }, { "type": "error", "name": "InvalidAmount", "inputs": [] }, { "type": "error", "name": "InvalidAuctionDataLength", "inputs": [] }, { "type": "error", "name": "InvalidBidPriceTooHigh", "inputs": [{ "name": "maxPrice", "type": "uint256", "internalType": "uint256" }, { "name": "maxBidPrice", "type": "uint256", "internalType": "uint256" }] }, { "type": "error", "name": "InvalidBidUnableToClear", "inputs": [] }, { "type": "error", "name": "InvalidEndBlock", "inputs": [] }, { "type": "error", "name": "InvalidEndBlockGivenStepData", "inputs": [{ "name": "actualEndBlock", "type": "uint64", "internalType": "uint64" }, { "name": "expectedEndBlock", "type": "uint64", "internalType": "uint64" }] }, { "type": "error", "name": "InvalidLastFullyFilledCheckpointHint", "inputs": [] }, { "type": "error", "name": "InvalidOutbidBlockCheckpointHint", "inputs": [] }, { "type": "error", "name": "InvalidStepDataMps", "inputs": [{ "name": "actualMps", "type": "uint256", "internalType": "uint256" }, { "name": "expectedMps", "type": "uint256", "internalType": "uint256" }] }, { "type": "error", "name": "InvalidTickPrice", "inputs": [] }, { "type": "error", "name": "InvalidTokenAmountReceived", "inputs": [] }, { "type": "error", "name": "MpsRemainingIsZero", "inputs": [] }, { "type": "error", "name": "NativeTransferFailed", "inputs": [] }, { "type": "error", "name": "NotClaimable", "inputs": [] }, { "type": "error", "name": "NotGraduated", "inputs": [] }, { "type": "error", "name": "Reentrancy", "inputs": [] }, { "type": "error", "name": "StepBlockDeltaCannotBeZero", "inputs": [] }, { "type": "error", "name": "StepLib__InvalidOffsetNotAtStepBoundary", "inputs": [] }, { "type": "error", "name": "StepLib__InvalidOffsetTooLarge", "inputs": [] }, { "type": "error", "name": "TickHintMustBeGreaterThanNextActiveTickPrice", "inputs": [{ "name": "tickPrice", "type": "uint256", "internalType": "uint256" }, { "name": "nextActiveTickPrice", "type": "uint256", "internalType": "uint256" }] }, { "type": "error", "name": "TickNotInitialized", "inputs": [] }, { "type": "error", "name": "TickPreviousPriceInvalid", "inputs": [] }, { "type": "error", "name": "TickPriceNotAtBoundary", "inputs": [] }, { "type": "error", "name": "TickPriceNotIncreasing", "inputs": [] }, { "type": "error", "name": "TickSpacingTooSmall", "inputs": [] }, { "type": "error", "name": "TokenAndCurrencyCannotBeTheSame", "inputs": [] }, { "type": "error", "name": "TokenIsAddressZero", "inputs": [] }, { "type": "error", "name": "TokenTransferFailed", "inputs": [] }, { "type": "error", "name": "TokensNotReceived", "inputs": [] }, { "type": "error", "name": "TokensRecipientIsZero", "inputs": [] }, { "type": "error", "name": "TotalSupplyIsTooLarge", "inputs": [] }, { "type": "error", "name": "TotalSupplyIsZero", "inputs": [] }, { "type": "error", "name": "ValidationHookCallFailed", "inputs": [{ "name": "reason", "type": "bytes", "internalType": "bytes" }] }];
+
+// src/abis/factory.ts
+var factoryAbi = [{ "type": "function", "name": "getAuctionAddress", "inputs": [{ "name": "token", "type": "address", "internalType": "address" }, { "name": "amount", "type": "uint256", "internalType": "uint256" }, { "name": "configData", "type": "bytes", "internalType": "bytes" }, { "name": "salt", "type": "bytes32", "internalType": "bytes32" }, { "name": "sender", "type": "address", "internalType": "address" }], "outputs": [{ "name": "", "type": "address", "internalType": "address" }], "stateMutability": "view" }, { "type": "function", "name": "initializeDistribution", "inputs": [{ "name": "token", "type": "address", "internalType": "address" }, { "name": "amount", "type": "uint256", "internalType": "uint256" }, { "name": "configData", "type": "bytes", "internalType": "bytes" }, { "name": "salt", "type": "bytes32", "internalType": "bytes32" }], "outputs": [{ "name": "distributionContract", "type": "address", "internalType": "contract IDistributionContract" }], "stateMutability": "nonpayable" }, { "type": "event", "name": "AuctionCreated", "inputs": [{ "name": "auction", "type": "address", "indexed": true, "internalType": "address" }, { "name": "token", "type": "address", "indexed": true, "internalType": "address" }, { "name": "amount", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "configData", "type": "bytes", "indexed": false, "internalType": "bytes" }], "anonymous": false }, { "type": "error", "name": "InvalidTokenAmount", "inputs": [{ "name": "amount", "type": "uint256", "internalType": "uint256" }] }];
+
+// src/abis/auctionStateLens.ts
+var auctionStateLensAbi = [{ "type": "function", "name": "revertWithState", "inputs": [{ "name": "auction", "type": "address", "internalType": "contract IContinuousClearingAuction" }], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "state", "inputs": [{ "name": "auction", "type": "address", "internalType": "contract IContinuousClearingAuction" }], "outputs": [{ "name": "", "type": "tuple", "internalType": "struct AuctionState", "components": [{ "name": "checkpoint", "type": "tuple", "internalType": "struct Checkpoint", "components": [{ "name": "clearingPrice", "type": "uint256", "internalType": "uint256" }, { "name": "currencyRaisedAtClearingPriceQ96_X7", "type": "uint256", "internalType": "ValueX7" }, { "name": "cumulativeMpsPerPrice", "type": "uint256", "internalType": "uint256" }, { "name": "cumulativeMps", "type": "uint24", "internalType": "uint24" }, { "name": "prev", "type": "uint64", "internalType": "uint64" }, { "name": "next", "type": "uint64", "internalType": "uint64" }] }, { "name": "currencyRaised", "type": "uint256", "internalType": "uint256" }, { "name": "totalCleared", "type": "uint256", "internalType": "uint256" }, { "name": "isGraduated", "type": "bool", "internalType": "bool" }] }], "stateMutability": "nonpayable" }, { "type": "error", "name": "CheckpointFailed", "inputs": [] }, { "type": "error", "name": "InvalidRevertReasonLength", "inputs": [] }];
+var auctionStateLensDeployedBytecode = "0x608060405234801561000f575f80fd5b5060043610610034575f3560e01c806321a13d371461003857806331e658a51461004d575b5f80fd5b61004b61004636600461048a565b610076565b005b61006061005b36600461048a565b6102c7565b60405161006d91906104bd565b60405180910390f35b8073ffffffffffffffffffffffffffffffffffffffff1663c2c4c5c16040518163ffffffff1660e01b815260040160c0604051808303815f875af19250505080156100fc575060408051601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01682019092526100f991810190610620565b60015b610132576040517fd027b09000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f60405180608001604052808381526020018473ffffffffffffffffffffffffffffffffffffffff1663998ba4fc6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561018d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906101b1919061063a565b81526020018473ffffffffffffffffffffffffffffffffffffffff16633e9d91746040518163ffffffff1660e01b8152600401602060405180830381865afa1580156101ff573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610223919061063a565b81526020018473ffffffffffffffffffffffffffffffffffffffff16639e5f26026040518163ffffffff1660e01b8152600401602060405180830381865afa158015610271573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906102959190610660565b151581525090505f816040516020016102ae91906104bd565b6040516020818303038152906040529050805160208201fd5b60408051610140810182525f6080820181815260a0830182905260c0830182905260e083018290526101008301829052610120830182905282526020820181905291810182905260608101919091526040517f21a13d3700000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8316600482015230906321a13d37906024015f604051808303815f87803b15801561037a575f80fd5b505af192505050801561038b575060015b6103ce573d8080156103b8576040519150601f19603f3d011682016040523d82523d5f602084013e6103bd565b606091505b506103c7816103d3565b9392505050565b919050565b60408051610140810182525f6080820181815260a0830182905260c0830182905260e083018290526101008301829052610120830182905282526020820181905291810182905260608101919091528151610120146104705760208251111561043e57815160208301fd5b6040517fa75357f900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b818060200190518101906104849190610679565b92915050565b5f6020828403121561049a575f80fd5b813573ffffffffffffffffffffffffffffffffffffffff811681146103c7575f80fd5b5f61012082019050825180518352602081015160208401526040810151604084015262ffffff606082015116606084015267ffffffffffffffff608082015116608084015267ffffffffffffffff60a08201511660a084015250602083015160c0830152604083015160e0830152606083015161053f61010084018215159052565b5092915050565b60405160c0810167ffffffffffffffff8111828210171561058e577f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b60405290565b805167ffffffffffffffff811681146103ce575f80fd5b5f60c082840312156105bb575f80fd5b6105c3610546565b825181526020808401519082015260408084015190820152606083015190915062ffffff811681146105f3575f80fd5b606082015261060460808301610594565b608082015261061560a08301610594565b60a082015292915050565b5f60c08284031215610630575f80fd5b6103c783836105ab565b5f6020828403121561064a575f80fd5b5051919050565b805180151581146103ce575f80fd5b5f60208284031215610670575f80fd5b6103c782610651565b5f61012082840312801561068b575f80fd5b506040516080810167ffffffffffffffff811182821017156106d4577f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b6040526106e184846105ab565b815260c0830151602082015260e083015160408201526107046101008401610651565b6060820152939250505056fea164736f6c634300081a000a";
+
+// src/abis/index.ts
+var UPSTREAM_TAG = "v1.1.0";
+var UPSTREAM_COMMIT = "a0aabaa45d8677a4944fc04d5dea2c4b499b3d3a";
+
+// src/q96.ts
+var Q96 = 2n ** 96n;
+var MPS = 10000000n;
+var X7 = MPS;
+var DECIMAL_PATTERN = /^-?\d+(\.\d+)?$/;
+function q96ToDecimalString(valueQ96, precision = 18, trimTrailingZeros = true) {
+  if (precision < 0 || !Number.isInteger(precision)) {
+    throw new TypeError(
+      `q96ToDecimalString: precision must be a non-negative integer, got ${precision}`
+    );
+  }
+  const negative = valueQ96 < 0n;
+  const magnitude = negative ? -valueQ96 : valueQ96;
+  const whole = magnitude / Q96;
+  const remainder = magnitude % Q96;
+  if (precision === 0) {
+    return `${negative && whole !== 0n ? "-" : ""}${whole}`;
+  }
+  const scale = 10n ** BigInt(precision);
+  const fractional = remainder * scale / Q96;
+  let fractionalDigits = fractional.toString().padStart(precision, "0");
+  if (trimTrailingZeros) {
+    fractionalDigits = fractionalDigits.replace(/0+$/, "");
+  }
+  const sign = negative && (whole !== 0n || fractional !== 0n) ? "-" : "";
+  return fractionalDigits.length > 0 ? `${sign}${whole}.${fractionalDigits}` : `${sign}${whole}`;
+}
+function q96ToNumber(valueQ96) {
+  return Number(q96ToDecimalString(valueQ96, 20, false));
+}
+function decimalToQ96(decimal) {
+  const asString = typeof decimal === "number" ? numberToDecimalString(decimal) : decimal.trim();
+  if (!DECIMAL_PATTERN.test(asString)) {
+    throw new TypeError(`decimalToQ96: expected a decimal string, got "${decimal}"`);
+  }
+  const negative = asString.startsWith("-");
+  const unsigned = negative ? asString.slice(1) : asString;
+  const [wholePart = "0", fractionalPart = ""] = unsigned.split(".");
+  const scale = 10n ** BigInt(fractionalPart.length);
+  const scaledValue = BigInt(wholePart) * scale + (fractionalPart === "" ? 0n : BigInt(fractionalPart));
+  const result = scaledValue * Q96 / scale;
+  return negative ? -result : result;
+}
+function numberToDecimalString(value) {
+  if (!Number.isFinite(value)) {
+    throw new TypeError(`decimalToQ96: expected a finite number, got ${value}`);
+  }
+  return value.toLocaleString("en-US", { useGrouping: false, maximumFractionDigits: 20 });
+}
+function formatQ96(valueQ96, significantDigits = 6) {
+  if (valueQ96 === 0n) return "0";
+  const negative = valueQ96 < 0n;
+  const magnitude = negative ? -valueQ96 : valueQ96;
+  const sign = negative ? "-" : "";
+  let precision;
+  if (magnitude / Q96 > 0n) {
+    precision = significantDigits;
+  } else {
+    const fractional = q96ToDecimalString(magnitude, 40, false).split(".")[1] ?? "";
+    const firstSignificant = fractional.search(/[1-9]/);
+    if (firstSignificant === -1) return "0";
+    precision = firstSignificant + significantDigits;
+  }
+  const scale = 10n ** BigInt(precision);
+  const rounded = (magnitude * scale * 2n + Q96) / (Q96 * 2n);
+  const wholePart = rounded / scale;
+  const fractionalPart = (rounded % scale).toString().padStart(precision, "0").replace(/0+$/, "");
+  return fractionalPart.length > 0 ? `${sign}${wholePart}.${fractionalPart}` : `${sign}${wholePart}`;
+}
+function mpsToFraction(cumulativeMps) {
+  return Number(BigInt(cumulativeMps)) / Number(MPS);
+}
+function formatMpsPercent(cumulativeMps, fractionDigits = 2) {
+  return (mpsToFraction(cumulativeMps) * 100).toFixed(fractionDigits);
+}
+function fromValueX7(valueX7) {
+  return valueX7 / X7;
+}
+function formatQ96Compact(valueQ96, significantDigits = 6) {
+  if (valueQ96 === 0n) return "0";
+  const negative = valueQ96 < 0n;
+  const magnitude = negative ? -valueQ96 : valueQ96;
+  const sign = negative ? "-" : "";
+  const plain = formatQ96(magnitude, significantDigits);
+  const [integerPart = "0", fractionalPart = ""] = plain.split(".");
+  if (integerPart !== "0") return `${sign}${plain}`;
+  const firstSignificant = fractionalPart.search(/[1-9]/);
+  if (firstSignificant === -1) return "0";
+  if (firstSignificant < 6) return `${sign}${plain}`;
+  const digits = fractionalPart.slice(firstSignificant).replace(/0+$/, "");
+  const exponent = -(firstSignificant + 1);
+  const mantissa = digits.length > 1 ? `${digits[0]}.${digits.slice(1)}` : digits;
+  return `${sign}${mantissa}e${exponent}`;
+}
+
+// src/auctionParameters.ts
+var MIN_FLOOR_PRICE = 4294967296n;
+var MIN_TICK_SPACING = 2n;
+var UINT24_MAX = 16777215;
+var UINT40_MAX = 1099511627775;
+var AuctionParametersError = class extends Error {
+};
+function packAuctionSteps(steps) {
+  if (steps.length === 0) {
+    throw new AuctionParametersError("auctionStepsData cannot be empty (InvalidAuctionDataLength).");
+  }
+  let packed = "";
+  for (const step of steps) {
+    if (!Number.isInteger(step.mps) || step.mps < 0 || step.mps > UINT24_MAX) {
+      throw new AuctionParametersError(`step mps ${step.mps} does not fit uint24.`);
+    }
+    if (!Number.isInteger(step.blockDelta) || step.blockDelta <= 0) {
+      throw new AuctionParametersError(`step blockDelta must be > 0, got ${step.blockDelta}.`);
+    }
+    if (step.blockDelta > UINT40_MAX) {
+      throw new AuctionParametersError(`step blockDelta ${step.blockDelta} does not fit uint40.`);
+    }
+    packed += step.mps.toString(16).padStart(6, "0");
+    packed += step.blockDelta.toString(16).padStart(10, "0");
+  }
+  return `0x${packed}`;
+}
+function unpackAuctionSteps(data) {
+  const body = data.slice(2);
+  if (body.length === 0 || body.length % 16 !== 0) {
+    throw new AuctionParametersError(
+      `auctionStepsData must be a whole number of 8-byte steps, got ${body.length / 2} bytes.`
+    );
+  }
+  const steps = [];
+  for (let i = 0; i < body.length; i += 16) {
+    steps.push({
+      mps: Number.parseInt(body.slice(i, i + 6), 16),
+      blockDelta: Number.parseInt(body.slice(i + 6, i + 16), 16)
+    });
+  }
+  return steps;
+}
+function buildAuctionSteps(durationBlocks) {
+  if (!Number.isInteger(durationBlocks) || durationBlocks < 2) {
+    throw new AuctionParametersError(`durationBlocks must be an integer >= 2, got ${durationBlocks}.`);
+  }
+  const total = Number(MPS);
+  const perBlock = Math.floor(total / durationBlocks);
+  if (perBlock <= 0) {
+    throw new AuctionParametersError(
+      `durationBlocks ${durationBlocks} is longer than MPS (${total}) allows - each block would release 0.`
+    );
+  }
+  const remainder = total - perBlock * durationBlocks;
+  const finalBlockMps = perBlock + remainder;
+  if (finalBlockMps > UINT24_MAX) {
+    throw new AuctionParametersError(`final step mps ${finalBlockMps} does not fit uint24.`);
+  }
+  return durationBlocks === 1 ? [{ mps: total, blockDelta: 1 }] : [
+    { mps: perBlock, blockDelta: durationBlocks - 1 },
+    { mps: finalBlockMps, blockDelta: 1 }
+  ];
+}
+function totalMps(steps) {
+  return steps.reduce((sum, step) => sum + BigInt(step.mps) * BigInt(step.blockDelta), 0n);
+}
+function totalBlocks(steps) {
+  return steps.reduce((sum, step) => sum + BigInt(step.blockDelta), 0n);
+}
+function validateAuctionParameters(params) {
+  if (params.startBlock >= params.endBlock) {
+    throw new AuctionParametersError(
+      `startBlock (${params.startBlock}) must be < endBlock (${params.endBlock}) - InvalidEndBlock.`
+    );
+  }
+  if (params.claimBlock < params.endBlock) {
+    throw new AuctionParametersError(
+      `claimBlock (${params.claimBlock}) must be >= endBlock (${params.endBlock}) - ClaimBlockIsBeforeEndBlock.`
+    );
+  }
+  if (params.tickSpacing < MIN_TICK_SPACING) {
+    throw new AuctionParametersError(
+      `tickSpacing (${params.tickSpacing}) must be >= ${MIN_TICK_SPACING} - TickSpacingTooSmall.`
+    );
+  }
+  if (params.floorPriceQ96 === 0n) {
+    throw new AuctionParametersError("floorPrice cannot be zero - FloorPriceIsZero.");
+  }
+  if (params.floorPriceQ96 < MIN_FLOOR_PRICE) {
+    throw new AuctionParametersError(
+      `floorPrice (${params.floorPriceQ96}) must be >= ${MIN_FLOOR_PRICE} - FloorPriceTooLow.`
+    );
+  }
+  if (params.floorPriceQ96 % params.tickSpacing !== 0n) {
+    throw new AuctionParametersError(
+      `floorPrice (${params.floorPriceQ96}) must be a multiple of tickSpacing (${params.tickSpacing}) - TickPriceNotAtBoundary.`
+    );
+  }
+  const steps = unpackAuctionSteps(params.auctionStepsData);
+  const mpsSum = totalMps(steps);
+  if (mpsSum !== MPS) {
+    throw new AuctionParametersError(
+      `supply schedule releases ${mpsSum} mps, must be exactly ${MPS} - InvalidStepDataMps.`
+    );
+  }
+  const blockSum = totalBlocks(steps);
+  if (params.startBlock + blockSum !== params.endBlock) {
+    throw new AuctionParametersError(
+      `supply schedule spans ${blockSum} blocks, so it ends at ${params.startBlock + blockSum}, but endBlock is ${params.endBlock} - InvalidEndBlockGivenStepData.`
+    );
+  }
+}
+var PARAMETERS_TUPLE = viem.parseAbiParameters(
+  "(address currency, address tokensRecipient, address fundsRecipient, uint64 startBlock, uint64 endBlock, uint64 claimBlock, uint256 tickSpacing, address validationHook, uint256 floorPrice, uint128 requiredCurrencyRaised, bytes auctionStepsData)"
+);
+function encodeAuctionParameters(params) {
+  validateAuctionParameters(params);
+  return viem.encodeAbiParameters(PARAMETERS_TUPLE, [
+    {
+      currency: params.currency,
+      tokensRecipient: params.tokensRecipient,
+      fundsRecipient: params.fundsRecipient,
+      startBlock: params.startBlock,
+      endBlock: params.endBlock,
+      claimBlock: params.claimBlock,
+      tickSpacing: params.tickSpacing,
+      validationHook: params.validationHook,
+      floorPrice: params.floorPriceQ96,
+      requiredCurrencyRaised: params.requiredCurrencyRaised,
+      auctionStepsData: params.auctionStepsData
+    }
+  ]);
+}
+function decodeAuctionParameters(configData) {
+  const [decoded] = viem.decodeAbiParameters(PARAMETERS_TUPLE, configData);
+  const value = decoded;
+  return {
+    currency: value.currency,
+    tokensRecipient: value.tokensRecipient,
+    fundsRecipient: value.fundsRecipient,
+    startBlock: BigInt(value.startBlock),
+    endBlock: BigInt(value.endBlock),
+    claimBlock: BigInt(value.claimBlock),
+    tickSpacing: value.tickSpacing,
+    validationHook: value.validationHook,
+    floorPriceQ96: value.floorPrice,
+    requiredCurrencyRaised: value.requiredCurrencyRaised,
+    auctionStepsData: value.auctionStepsData
+  };
+}
+var FACTORY_ADDRESS = "0xCCccCcCAE7503Cac057829BF2811De42E16e0bD5";
+var FACTORY_DEPLOY_BLOCK = {
+  [chains.sepolia.id]: 10130119n
+};
+var SUPPORTED_CHAINS = {
+  [chains.sepolia.id]: chains.sepolia,
+  [chains.baseSepolia.id]: chains.baseSepolia,
+  [chains.unichainSepolia.id]: chains.unichainSepolia
+};
+var BLOCK_TIME_SECONDS = {
+  [chains.sepolia.id]: 12,
+  [chains.baseSepolia.id]: 2,
+  [chains.unichainSepolia.id]: 1
+};
+var DEFAULT_LOG_CHUNK_SIZE = 50000n;
+var NATIVE_CURRENCY = "0x0000000000000000000000000000000000000000";
+var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+
+// src/client.ts
+function assertSupportedChain(chainId) {
+  const chain = SUPPORTED_CHAINS[chainId];
+  if (!chain) {
+    const supported = Object.values(SUPPORTED_CHAINS).map((c) => `${c.name} (${c.id})`).join(", ");
+    throw new Error(
+      `Beacon is testnet-only and refuses to run against chain id ${chainId}. Supported: ${supported}.`
+    );
+  }
+  return chain;
+}
+function createBeaconClient(config) {
+  const chain = assertSupportedChain(config.chainId);
+  const publicClient = viem.createPublicClient({
+    chain,
+    transport: viem.http(config.rpcUrl),
+    // Batch eagerly: reads fan out across many auctions in the directory.
+    batch: { multicall: true }
+  });
+  const logsClient = config.logsRpcUrl && config.logsRpcUrl !== config.rpcUrl ? viem.createPublicClient({ chain, transport: viem.http(config.logsRpcUrl) }) : publicClient;
+  const factoryDeployBlock = config.factoryDeployBlock ?? FACTORY_DEPLOY_BLOCK[config.chainId];
+  if (factoryDeployBlock === void 0) {
+    throw new Error(
+      `No known factory deploy block for chain id ${config.chainId}. Pass \`factoryDeployBlock\` explicitly so discovery knows where to start scanning.`
+    );
+  }
+  return {
+    publicClient,
+    logsClient,
+    chain,
+    chainId: config.chainId,
+    factoryAddress: config.factoryAddress ?? FACTORY_ADDRESS,
+    lensAddress: config.lensAddress,
+    factoryDeployBlock,
+    blockTimeSeconds: BLOCK_TIME_SECONDS[config.chainId] ?? 12
+  };
+}
+async function assertChainMatches(client) {
+  const actual = await client.publicClient.getChainId();
+  if (actual !== client.chainId) {
+    throw new Error(
+      `RPC chain id mismatch: configured for ${client.chainId} (${client.chain.name}) but the endpoint reports ${actual}. Check BEACON_RPC_URL.`
+    );
+  }
+}
+var auctionCreatedEvent = viem.getAbiItem({ abi: factoryAbi, name: "AuctionCreated" });
+function toDiscoveredAuction(log) {
+  const { auction, token, amount, configData } = log.args;
+  if (!auction || !token) {
+    throw new Error(`Malformed AuctionCreated log in block ${log.blockNumber}: missing auction/token`);
+  }
+  return {
+    auction,
+    token,
+    amount: amount ?? 0n,
+    configData: configData ?? "0x",
+    blockNumber: log.blockNumber,
+    transactionHash: log.transactionHash,
+    logIndex: log.logIndex
+  };
+}
+async function scanAuctions(client, options = {}) {
+  const headBlock = options.toBlock ?? await client.publicClient.getBlockNumber();
+  const startBlock = options.fromBlock ?? client.factoryDeployBlock;
+  const maxChunk = options.chunkSize ?? DEFAULT_LOG_CHUNK_SIZE;
+  if (startBlock > headBlock) return [];
+  const emptyChunkRetries = options.emptyChunkRetries ?? 2;
+  const found = [];
+  let cursor = startBlock;
+  let chunkSize = maxChunk;
+  while (cursor <= headBlock) {
+    const chunkEnd = min(cursor + chunkSize - 1n, headBlock);
+    const fetchChunk = async (from, to) => await client.logsClient.getLogs({
+      address: client.factoryAddress,
+      event: auctionCreatedEvent,
+      fromBlock: from,
+      toBlock: to
+    });
+    let logs;
+    try {
+      logs = await fetchChunk(cursor, chunkEnd);
+      for (let attempt = 0; logs.length === 0 && attempt < emptyChunkRetries; attempt++) {
+        const retry = await fetchChunk(cursor, chunkEnd);
+        if (retry.length > 0) {
+          options.onAnomaly?.({
+            fromBlock: cursor,
+            toBlock: chunkEnd,
+            recoveredLogs: retry.length
+          });
+          logs = retry;
+        }
+      }
+    } catch (error) {
+      if (chunkSize > 1n) {
+        chunkSize = chunkSize / 2n;
+        continue;
+      }
+      throw new Error(
+        `eth_getLogs failed for a single block (${cursor}) on ${client.chain.name}: ${error.message}`
+      );
+    }
+    for (const log of logs) found.push(toDiscoveredAuction(log));
+    options.onProgress?.({
+      fromBlock: cursor,
+      toBlock: chunkEnd,
+      scannedTo: chunkEnd,
+      headBlock,
+      found: found.length
+    });
+    cursor = chunkEnd + 1n;
+    if (chunkSize < maxChunk) chunkSize = min(chunkSize * 2n, maxChunk);
+  }
+  found.sort(
+    (a, b) => a.blockNumber === b.blockNumber ? a.logIndex - b.logIndex : a.blockNumber < b.blockNumber ? -1 : 1
+  );
+  return found;
+}
+function watchAuctions(client, onAuction, options = {}) {
+  return client.logsClient.watchEvent({
+    address: client.factoryAddress,
+    event: auctionCreatedEvent,
+    poll: true,
+    pollingInterval: options.pollingIntervalMs ?? 12e3,
+    onError: options.onError,
+    onLogs: (logs) => {
+      for (const log of logs) {
+        try {
+          onAuction(toDiscoveredAuction(log));
+        } catch (error) {
+          options.onError?.(error);
+        }
+      }
+    }
+  });
+}
+async function scanAuctionsForToken(client, token, options = {}) {
+  const all = await scanAuctions(client, options);
+  return all.filter((entry) => entry.token.toLowerCase() === token.toLowerCase());
+}
+function min(a, b) {
+  return a < b ? a : b;
+}
+var erc20MetadataAbi = [
+  { type: "function", name: "symbol", inputs: [], outputs: [{ type: "string" }], stateMutability: "view" },
+  { type: "function", name: "name", inputs: [], outputs: [{ type: "string" }], stateMutability: "view" },
+  { type: "function", name: "decimals", inputs: [], outputs: [{ type: "uint8" }], stateMutability: "view" }
+];
+async function getTokenMetadata(client, address) {
+  if (address === NATIVE_CURRENCY) {
+    const native = client.chain.nativeCurrency;
+    return {
+      address,
+      symbol: native.symbol,
+      name: native.name,
+      decimals: native.decimals,
+      isNative: true
+    };
+  }
+  const contract = { address, abi: erc20MetadataAbi };
+  const [symbol, name, decimals] = await client.publicClient.multicall({
+    allowFailure: true,
+    contracts: [
+      { ...contract, functionName: "symbol" },
+      { ...contract, functionName: "name" },
+      { ...contract, functionName: "decimals" }
+    ]
+  });
+  return {
+    address,
+    symbol: symbol.status === "success" ? symbol.result : shortAddress(address),
+    name: name.status === "success" ? name.result : shortAddress(address),
+    // 18 is the overwhelmingly common default; better than refusing to render.
+    decimals: decimals.status === "success" ? Number(decimals.result) : 18,
+    isNative: false
+  };
+}
+async function getTokenMetadataBatch(client, addresses) {
+  const unique = [...new Set(addresses)];
+  const entries = await Promise.all(
+    unique.map(async (address) => [address, await getTokenMetadata(client, address)])
+  );
+  return new Map(entries);
+}
+function formatTokenAmount(amount, token, maxFractionDigits = 4) {
+  if (amount === 0n) return `0 ${token.symbol}`;
+  const negative = amount < 0n;
+  const whole = viem.formatUnits(negative ? -amount : amount, token.decimals);
+  const [integerPart = "0", fractionalPart = ""] = whole.split(".");
+  const grouped = BigInt(integerPart).toLocaleString("en-US");
+  let trimmed = fractionalPart.slice(0, maxFractionDigits).replace(/0+$/, "");
+  if (integerPart === "0" && trimmed.length === 0) {
+    const firstSignificant = fractionalPart.search(/[1-9]/);
+    if (firstSignificant !== -1) {
+      trimmed = fractionalPart.slice(0, firstSignificant + 4).replace(/0+$/, "");
+    }
+  }
+  const sign = negative ? "-" : "";
+  return trimmed.length > 0 ? `${sign}${grouped}.${trimmed} ${token.symbol}` : `${sign}${grouped} ${token.symbol}`;
+}
+function shortAddress(address) {
+  return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+
+// src/privateKey.ts
+var PrivateKeyFormatError = class extends Error {
+};
+function normalizePrivateKey(raw, envVarName) {
+  const trimmed = (raw ?? "").trim();
+  if (trimmed.length === 0) {
+    throw new PrivateKeyFormatError(`${envVarName} is not set.`);
+  }
+  const body = trimmed.startsWith("0x") || trimmed.startsWith("0X") ? trimmed.slice(2) : trimmed;
+  if (!/^[0-9a-fA-F]{64}$/.test(body)) {
+    throw new PrivateKeyFormatError(
+      `${envVarName} is malformed: expected 64 hex characters (optionally 0x-prefixed), got ${body.length} characters. The value itself is not shown.`
+    );
+  }
+  if (/^0{64}$/.test(body)) {
+    throw new PrivateKeyFormatError(
+      `${envVarName} is all zeros - that is the .env.example placeholder, not a real key.`
+    );
+  }
+  return `0x${body.toLowerCase()}`;
+}
+function isValidPrivateKey(raw) {
+  try {
+    normalizePrivateKey(raw, "key");
+    return true;
+  } catch {
+    return false;
+  }
+}
+var LENS_OVERRIDE_ADDRESS = "0x00000000000000000000000000000000BEAC0E75";
+function toCheckpoint(raw) {
+  return {
+    clearingPriceQ96: raw.clearingPrice,
+    currencyRaisedAtClearingPriceQ96X7: raw.currencyRaisedAtClearingPriceQ96_X7,
+    cumulativeMpsPerPrice: raw.cumulativeMpsPerPrice,
+    cumulativeMps: Number(raw.cumulativeMps),
+    prevBlock: BigInt(raw.prev),
+    nextBlock: BigInt(raw.next)
+  };
+}
+async function getAuctionState(client, auction) {
+  const data = viem.encodeFunctionData({
+    abi: auctionStateLensAbi,
+    functionName: "state",
+    args: [auction]
+  });
+  const useOverride = client.lensAddress === void 0;
+  const target = client.lensAddress ?? LENS_OVERRIDE_ADDRESS;
+  const { data: returnData } = await client.publicClient.call({
+    to: target,
+    data,
+    ...useOverride ? {
+      stateOverride: [
+        { address: LENS_OVERRIDE_ADDRESS, code: auctionStateLensDeployedBytecode }
+      ]
+    } : {}
+  });
+  if (!returnData) {
+    throw new Error(
+      `AuctionStateLens.state(${auction}) returned no data. Is ${auction} really a ContinuousClearingAuction on ${client.chain.name}?`
+    );
+  }
+  const raw = viem.decodeFunctionResult({
+    abi: auctionStateLensAbi,
+    functionName: "state",
+    data: returnData
+  });
+  return {
+    checkpoint: toCheckpoint(raw.checkpoint),
+    currencyRaised: raw.currencyRaised,
+    totalCleared: raw.totalCleared,
+    isGraduated: raw.isGraduated
+  };
+}
+async function getAuctionInfo(client, auction) {
+  const contract = { address: auction, abi: auctionAbi };
+  const [token, currency, totalSupply, startBlock, endBlock, floorPrice, tickSpacing] = await client.publicClient.multicall({
+    allowFailure: false,
+    contracts: [
+      { ...contract, functionName: "token" },
+      { ...contract, functionName: "currency" },
+      { ...contract, functionName: "totalSupply" },
+      { ...contract, functionName: "startBlock" },
+      { ...contract, functionName: "endBlock" },
+      { ...contract, functionName: "floorPrice" },
+      { ...contract, functionName: "tickSpacing" }
+    ]
+  });
+  return {
+    auction,
+    token,
+    currency,
+    totalSupply,
+    startBlock: BigInt(startBlock),
+    endBlock: BigInt(endBlock),
+    floorPriceQ96: floorPrice,
+    tickSpacing
+  };
+}
+async function getClearingPrice(client, auction) {
+  return client.publicClient.readContract({
+    address: auction,
+    abi: auctionAbi,
+    functionName: "clearingPrice"
+  });
+}
+async function isGraduated(client, auction) {
+  return client.publicClient.readContract({
+    address: auction,
+    abi: auctionAbi,
+    functionName: "isGraduated"
+  });
+}
+function deriveStatus(info, blockNumber) {
+  if (blockNumber < info.startBlock) return "pending";
+  if (blockNumber <= info.endBlock) return "live";
+  return "ended";
+}
+async function getAuctionSummary(client, auction, options = {}) {
+  const [info, state, blockNumber] = await Promise.all([
+    options.info ?? getAuctionInfo(client, auction),
+    getAuctionState(client, auction),
+    options.blockNumber ?? client.publicClient.getBlockNumber()
+  ]);
+  const status = deriveStatus(info, blockNumber);
+  const blocksRemaining = status === "pending" ? info.startBlock - blockNumber : status === "live" ? info.endBlock - blockNumber : 0n;
+  return {
+    info,
+    state,
+    blockNumber,
+    status,
+    clearingPrice: formatQ96(state.checkpoint.clearingPriceQ96),
+    supplyScheduleProgress: mpsToFraction(state.checkpoint.cumulativeMps),
+    hasClearedSupply: state.totalCleared > 0n,
+    blocksRemaining,
+    secondsRemaining: Number(blocksRemaining) * client.blockTimeSeconds
+  };
+}
+function isFailedSummary(result) {
+  return "error" in result;
+}
+async function getAuctionSummaries(client, auctions, options = {}) {
+  const concurrency = options.concurrency ?? 5;
+  const blockNumber = await client.publicClient.getBlockNumber();
+  const results = [];
+  for (let i = 0; i < auctions.length; i += concurrency) {
+    const batch = auctions.slice(i, i + concurrency);
+    const settled = await Promise.all(
+      batch.map(async (auction) => {
+        try {
+          return await getAuctionSummary(client, auction, { blockNumber });
+        } catch (error) {
+          return { auction, error };
+        }
+      })
+    );
+    results.push(...settled);
+  }
+  return results;
+}
+async function getAuctionListStates(client, auctions) {
+  const result = /* @__PURE__ */ new Map();
+  if (auctions.length === 0) return result;
+  const contracts = auctions.flatMap((auction) => {
+    const base = { address: auction, abi: auctionAbi };
+    return [
+      { ...base, functionName: "clearingPrice" },
+      { ...base, functionName: "isGraduated" },
+      { ...base, functionName: "currencyRaised" },
+      { ...base, functionName: "totalCleared" }
+    ];
+  });
+  const responses = await client.publicClient.multicall({ allowFailure: true, contracts });
+  auctions.forEach((auction, index) => {
+    const [price, graduated, raised, cleared] = responses.slice(index * 4, index * 4 + 4);
+    if (price?.status !== "success") return;
+    result.set(auction, {
+      auction,
+      clearingPriceQ96: price.result,
+      isGraduated: graduated?.status === "success" ? graduated.result : false,
+      currencyRaised: raised?.status === "success" ? raised.result : 0n,
+      totalCleared: cleared?.status === "success" ? cleared.result : 0n
+    });
+  });
+  return result;
+}
+var erc20ApprovalAbi = [
+  ...erc20MetadataAbi,
+  {
+    type: "function",
+    name: "allowance",
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" }
+    ],
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "approve",
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: [{ type: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view"
+  }
+];
+var permit2Abi = [
+  {
+    type: "function",
+    name: "allowance",
+    inputs: [
+      { name: "user", type: "address" },
+      { name: "token", type: "address" },
+      { name: "spender", type: "address" }
+    ],
+    outputs: [
+      { name: "amount", type: "uint160" },
+      { name: "expiration", type: "uint48" },
+      { name: "nonce", type: "uint48" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "approve",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint160" },
+      { name: "expiration", type: "uint48" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  }
+];
+var UINT128_MAX = 2n ** 128n - 1n;
+var UINT160_MAX = 2n ** 160n - 1n;
+var UINT48_MAX = 2n ** 48n - 1n;
+function alignPriceToTickBoundary(priceQ96, tickSpacing) {
+  if (tickSpacing <= 0n) {
+    throw new RangeError(`alignPriceToTickBoundary: tickSpacing must be positive, got ${tickSpacing}`);
+  }
+  return priceQ96 / tickSpacing * tickSpacing;
+}
+function isPriceOnTickBoundary(priceQ96, tickSpacing) {
+  return tickSpacing > 0n && priceQ96 % tickSpacing === 0n;
+}
+function encodeSubmitBid(params) {
+  if (params.amount <= 0n) {
+    throw new RangeError(`submitBid: amount must be positive, got ${params.amount}`);
+  }
+  if (params.amount > UINT128_MAX) {
+    throw new RangeError(`submitBid: amount ${params.amount} exceeds uint128.`);
+  }
+  if (params.maxPriceQ96 <= 0n) {
+    throw new RangeError(`submitBid: maxPriceQ96 must be positive, got ${params.maxPriceQ96}`);
+  }
+  if (params.tickSpacing !== void 0 && !isPriceOnTickBoundary(params.maxPriceQ96, params.tickSpacing)) {
+    throw new RangeError(
+      `submitBid: maxPriceQ96 ${params.maxPriceQ96} is not a multiple of tickSpacing ${params.tickSpacing} and would revert with TickPriceNotAtBoundary(). Use alignPriceToTickBoundary() first.`
+    );
+  }
+  const data = params.prevTickPriceQ96 === void 0 ? viem.encodeFunctionData({
+    abi: auctionAbi,
+    functionName: "submitBid",
+    // Four args selects the no-hint overload, which passes FLOOR_PRICE.
+    args: [params.maxPriceQ96, params.amount, params.owner, params.hookData ?? "0x"]
+  }) : viem.encodeFunctionData({
+    abi: auctionAbi,
+    functionName: "submitBid",
+    args: [
+      params.maxPriceQ96,
+      params.amount,
+      params.owner,
+      params.prevTickPriceQ96,
+      params.hookData ?? "0x"
+    ]
+  });
+  return {
+    to: params.auction,
+    data,
+    // ERC-20 bids are pulled via Permit2; any value sent would revert with
+    // CurrencyIsNotNative().
+    value: params.isNativeCurrency ? params.amount : 0n
+  };
+}
+async function getPrevTickHint(client, auction, maxPriceQ96) {
+  const [floorPrice, nextActive] = await client.publicClient.multicall({
+    allowFailure: false,
+    contracts: [
+      { address: auction, abi: auctionAbi, functionName: "floorPrice" },
+      { address: auction, abi: auctionAbi, functionName: "nextActiveTickPrice" }
+    ]
+  });
+  if (nextActive > floorPrice && nextActive < maxPriceQ96) return nextActive;
+  return floorPrice;
+}
+function encodeApproveErc20ToPermit2(currency, amount = viem.maxUint256) {
+  return {
+    to: currency,
+    data: viem.encodeFunctionData({
+      abi: erc20ApprovalAbi,
+      functionName: "approve",
+      args: [PERMIT2_ADDRESS, amount]
+    }),
+    value: 0n
+  };
+}
+function encodeApprovePermit2(currency, auction, amount = UINT160_MAX, expiration) {
+  if (amount > UINT160_MAX) {
+    throw new RangeError(`Permit2 approve: amount ${amount} exceeds uint160.`);
+  }
+  const expiry = expiration ?? BigInt(Math.floor(Date.now() / 1e3) + 30 * 24 * 60 * 60);
+  if (expiry > UINT48_MAX) {
+    throw new RangeError(`Permit2 approve: expiration ${expiry} exceeds uint48.`);
+  }
+  return {
+    to: PERMIT2_ADDRESS,
+    data: viem.encodeFunctionData({
+      abi: permit2Abi,
+      functionName: "approve",
+      args: [currency, auction, amount, Number(expiry)]
+    }),
+    value: 0n
+  };
+}
+async function checkBidReadiness(client, params) {
+  if (params.currency === NATIVE_CURRENCY) {
+    const balance2 = await client.publicClient.getBalance({ address: params.bidder });
+    return {
+      hasBalance: balance2 >= params.amount,
+      balance: balance2,
+      erc20AllowanceToPermit2: viem.maxUint256,
+      permit2AllowanceToAuction: viem.maxUint256,
+      permit2Expiration: viem.maxUint256,
+      needsErc20Approval: false,
+      needsPermit2Approval: false,
+      needsApproval: false
+    };
+  }
+  const [balance, erc20Allowance, permit2Allowance] = await client.publicClient.multicall({
+    allowFailure: false,
+    contracts: [
+      {
+        address: params.currency,
+        abi: erc20ApprovalAbi,
+        functionName: "balanceOf",
+        args: [params.bidder]
+      },
+      {
+        address: params.currency,
+        abi: erc20ApprovalAbi,
+        functionName: "allowance",
+        args: [params.bidder, PERMIT2_ADDRESS]
+      },
+      {
+        address: PERMIT2_ADDRESS,
+        abi: permit2Abi,
+        functionName: "allowance",
+        args: [params.bidder, params.currency, params.auction]
+      }
+    ]
+  });
+  const [permit2Amount, permit2Expiration] = permit2Allowance;
+  const nowSeconds = BigInt(Math.floor(Date.now() / 1e3));
+  const permit2Expired = BigInt(permit2Expiration) <= nowSeconds;
+  const needsErc20Approval = erc20Allowance < params.amount;
+  const needsPermit2Approval = permit2Amount < params.amount || permit2Expired;
+  return {
+    hasBalance: balance >= params.amount,
+    balance,
+    erc20AllowanceToPermit2: erc20Allowance,
+    permit2AllowanceToAuction: permit2Amount,
+    permit2Expiration: BigInt(permit2Expiration),
+    needsErc20Approval,
+    needsPermit2Approval,
+    needsApproval: needsErc20Approval || needsPermit2Approval
+  };
+}
+function buildBidTransactions(params) {
+  const isNative = params.currency === NATIVE_CURRENCY;
+  const steps = [];
+  if (!isNative) {
+    if (params.readiness.needsErc20Approval) {
+      steps.push({
+        label: "Approve Permit2 to move the bid currency",
+        request: encodeApproveErc20ToPermit2(params.currency)
+      });
+    }
+    if (params.readiness.needsPermit2Approval) {
+      steps.push({
+        label: "Grant the auction a Permit2 allowance",
+        request: encodeApprovePermit2(params.currency, params.auction)
+      });
+    }
+  }
+  const alignedPriceQ96 = params.tickSpacing === void 0 ? params.maxPriceQ96 : alignPriceToTickBoundary(params.maxPriceQ96, params.tickSpacing);
+  steps.push({
+    label: "Submit bid",
+    request: encodeSubmitBid({
+      auction: params.auction,
+      maxPriceQ96: alignedPriceQ96,
+      amount: params.amount,
+      owner: params.owner,
+      isNativeCurrency: isNative,
+      prevTickPriceQ96: params.prevTickPriceQ96,
+      hookData: params.hookData,
+      tickSpacing: params.tickSpacing
+    })
+  });
+  return steps;
+}
+function describeBidBlocker(input) {
+  if (input.status === "ended") return "This auction has ended - bidding is closed.";
+  if (input.status === "pending") return "This auction has not opened yet.";
+  if (input.amount <= 0n) return "Enter a bid amount.";
+  if (input.maxPriceQ96 <= 0n) return "Enter a maximum price.";
+  if (input.maxPriceQ96 < input.floorPriceQ96) {
+    return "Your maximum price is below the auction's floor price.";
+  }
+  if (input.tickSpacing !== void 0) {
+    const aligned = alignPriceToTickBoundary(input.maxPriceQ96, input.tickSpacing);
+    if (aligned < input.floorPriceQ96) {
+      return "Your maximum price rounds down below the auction's floor price.";
+    }
+  }
+  if (input.readiness && !input.readiness.hasBalance) return "Insufficient balance.";
+  return null;
+}
+
+exports.AuctionParametersError = AuctionParametersError;
+exports.BLOCK_TIME_SECONDS = BLOCK_TIME_SECONDS;
+exports.DEFAULT_LOG_CHUNK_SIZE = DEFAULT_LOG_CHUNK_SIZE;
+exports.FACTORY_ADDRESS = FACTORY_ADDRESS;
+exports.FACTORY_DEPLOY_BLOCK = FACTORY_DEPLOY_BLOCK;
+exports.LENS_OVERRIDE_ADDRESS = LENS_OVERRIDE_ADDRESS;
+exports.MIN_FLOOR_PRICE = MIN_FLOOR_PRICE;
+exports.MIN_TICK_SPACING = MIN_TICK_SPACING;
+exports.MPS = MPS;
+exports.NATIVE_CURRENCY = NATIVE_CURRENCY;
+exports.PERMIT2_ADDRESS = PERMIT2_ADDRESS;
+exports.PrivateKeyFormatError = PrivateKeyFormatError;
+exports.Q96 = Q96;
+exports.SUPPORTED_CHAINS = SUPPORTED_CHAINS;
+exports.UPSTREAM_COMMIT = UPSTREAM_COMMIT;
+exports.UPSTREAM_TAG = UPSTREAM_TAG;
+exports.X7 = X7;
+exports.alignPriceToTickBoundary = alignPriceToTickBoundary;
+exports.assertChainMatches = assertChainMatches;
+exports.assertSupportedChain = assertSupportedChain;
+exports.auctionAbi = auctionAbi;
+exports.auctionCreatedEvent = auctionCreatedEvent;
+exports.auctionStateLensAbi = auctionStateLensAbi;
+exports.auctionStateLensDeployedBytecode = auctionStateLensDeployedBytecode;
+exports.buildAuctionSteps = buildAuctionSteps;
+exports.buildBidTransactions = buildBidTransactions;
+exports.checkBidReadiness = checkBidReadiness;
+exports.createBeaconClient = createBeaconClient;
+exports.decimalToQ96 = decimalToQ96;
+exports.decodeAuctionParameters = decodeAuctionParameters;
+exports.deriveStatus = deriveStatus;
+exports.describeBidBlocker = describeBidBlocker;
+exports.encodeApproveErc20ToPermit2 = encodeApproveErc20ToPermit2;
+exports.encodeApprovePermit2 = encodeApprovePermit2;
+exports.encodeAuctionParameters = encodeAuctionParameters;
+exports.encodeSubmitBid = encodeSubmitBid;
+exports.erc20ApprovalAbi = erc20ApprovalAbi;
+exports.erc20MetadataAbi = erc20MetadataAbi;
+exports.factoryAbi = factoryAbi;
+exports.formatMpsPercent = formatMpsPercent;
+exports.formatQ96 = formatQ96;
+exports.formatQ96Compact = formatQ96Compact;
+exports.formatTokenAmount = formatTokenAmount;
+exports.fromValueX7 = fromValueX7;
+exports.getAuctionInfo = getAuctionInfo;
+exports.getAuctionListStates = getAuctionListStates;
+exports.getAuctionState = getAuctionState;
+exports.getAuctionSummaries = getAuctionSummaries;
+exports.getAuctionSummary = getAuctionSummary;
+exports.getClearingPrice = getClearingPrice;
+exports.getPrevTickHint = getPrevTickHint;
+exports.getTokenMetadata = getTokenMetadata;
+exports.getTokenMetadataBatch = getTokenMetadataBatch;
+exports.isFailedSummary = isFailedSummary;
+exports.isGraduated = isGraduated;
+exports.isPriceOnTickBoundary = isPriceOnTickBoundary;
+exports.isValidPrivateKey = isValidPrivateKey;
+exports.mpsToFraction = mpsToFraction;
+exports.normalizePrivateKey = normalizePrivateKey;
+exports.packAuctionSteps = packAuctionSteps;
+exports.permit2Abi = permit2Abi;
+exports.q96ToDecimalString = q96ToDecimalString;
+exports.q96ToNumber = q96ToNumber;
+exports.scanAuctions = scanAuctions;
+exports.scanAuctionsForToken = scanAuctionsForToken;
+exports.totalBlocks = totalBlocks;
+exports.totalMps = totalMps;
+exports.unpackAuctionSteps = unpackAuctionSteps;
+exports.validateAuctionParameters = validateAuctionParameters;
+exports.watchAuctions = watchAuctions;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map