@m3000/market 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/components/blocks/auction/Auction.d.ts

@@ -0,0 +1,49 @@
+import { AuctionData, AuctionFormatters, AuctionUserBid, RankableBid } from "../../../types/index.js";
+import { useAuctionContext } from "./AuctionContext.js";
+import { ReactNode } from "react";
+
+//#region src/components/blocks/auction/Auction.d.ts
+interface AuctionProps {
+  auction: AuctionData;
+  bids: RankableBid[];
+  userBids: AuctionUserBid[];
+  onPlaceBid: (price: bigint, quantity: bigint) => Promise<boolean>;
+  onTopUpBid: (bidId: bigint, newPrice: bigint, additionalValue: bigint) => Promise<boolean>;
+  onClaimEdition?: (bidId: string) => Promise<boolean>;
+  formatters?: AuctionFormatters;
+  children: ReactNode;
+  className?: string;
+}
+/**
+* Root component for an auction interface.
+* Provides context and orchestrates the layout of child components.
+*
+* @example
+* ```tsx
+* <Auction
+*   auction={auctionData}
+*   bids={bids}
+*   userBids={myBids}
+*   onPlaceBid={async (price, qty) => { /* wagmi call *\/ }}
+*   onTopUpBid={async (bidId, newPrice, value) => { /* wagmi call *\/ }}
+* >
+*   <AuctionInfo />
+*   <AuctionBidInput />
+*   <AuctionRankings />
+*   <AuctionYourBids />
+* </Auction>
+* ```
+*/
+declare function Auction({
+  auction,
+  bids,
+  userBids,
+  onPlaceBid,
+  onTopUpBid,
+  onClaimEdition,
+  formatters,
+  children,
+  className
+}: AuctionProps): React.ReactElement;
+//#endregion
+export { Auction, AuctionProps };

package/dist/components/blocks/auction/Auction.js

@@ -0,0 +1,44 @@
+"use client";
+
+import { AuctionProvider, useAuctionContext } from "./AuctionContext.js";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/blocks/auction/Auction.tsx
+/**
+* Root component for an auction interface.
+* Provides context and orchestrates the layout of child components.
+*
+* @example
+* ```tsx
+* <Auction
+*   auction={auctionData}
+*   bids={bids}
+*   userBids={myBids}
+*   onPlaceBid={async (price, qty) => { /* wagmi call *\/ }}
+*   onTopUpBid={async (bidId, newPrice, value) => { /* wagmi call *\/ }}
+* >
+*   <AuctionInfo />
+*   <AuctionBidInput />
+*   <AuctionRankings />
+*   <AuctionYourBids />
+* </Auction>
+* ```
+*/
+function Auction({ auction, bids, userBids, onPlaceBid, onTopUpBid, onClaimEdition, formatters, children, className }) {
+	return /* @__PURE__ */ jsx(AuctionProvider, {
+		auction,
+		bids,
+		userBids,
+		onPlaceBid,
+		onTopUpBid,
+		onClaimEdition,
+		formatters,
+		children: /* @__PURE__ */ jsx("div", {
+			className,
+			children
+		})
+	});
+}
+
+//#endregion
+export { Auction };

package/dist/components/blocks/auction/AuctionBidForm.d.ts

@@ -0,0 +1,11 @@
+//#region src/components/blocks/auction/AuctionBidForm.d.ts
+declare function AuctionBidFormRoot({
+  className
+}: {
+  className?: string;
+}): React.ReactElement;
+declare const AuctionBidForm: {
+  Root: typeof AuctionBidFormRoot;
+};
+//#endregion
+export { AuctionBidForm };

package/dist/components/blocks/auction/AuctionBidForm.js

@@ -0,0 +1,88 @@
+"use client";
+
+import { useAuctionContext } from "./AuctionContext.js";
+import { cn } from "../../../lib/cn.js";
+import { Button } from "../../primitives/Button.js";
+import { CursorGrowIcon, SteppedInput } from "../../primitives/SteppedInput.js";
+import { Text } from "../../primitives/Text.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/blocks/auction/AuctionBidForm.tsx
+function AuctionBidFormRoot({ className }) {
+	const { isAuctionEnded, minBidValue, tickConfig, tickSize, lockedBid, placeBidOperation, topUpOperation, handlePlaceBid, handleTopUp, bidValue, setBidValue, formatPrice, currencySymbol, inputDecimals, cancelBidding } = useAuctionContext();
+	const effectiveMinBid = lockedBid !== null && lockedBid.priceValue > minBidValue ? lockedBid.priceValue : minBidValue;
+	const getTickSize = (currentValue) => {
+		if (!tickConfig) return tickSize;
+		return currentValue > tickConfig.threshold ? tickConfig.largeTickSize : tickConfig.smallTickSize;
+	};
+	const activeOperation = lockedBid !== null ? topUpOperation : placeBidOperation;
+	const status = activeOperation.status;
+	const errorMessage = activeOperation.error;
+	const handleSubmit = async () => {
+		if (lockedBid !== null ? await handleTopUp(bidValue.toString()) : await handlePlaceBid(bidValue.toString())) setBidValue(effectiveMinBid);
+	};
+	const isLoading = status === "pending" || status === "confirming" || status === "indexing";
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("flex flex-col gap-4", className),
+		children: [status === "error" ? /* @__PURE__ */ jsx("div", {
+			className: "rounded-xs bg-destructive-muted p-2 text-destructive",
+			children: /* @__PURE__ */ jsx(Text, {
+				size: "1",
+				children: errorMessage
+			})
+		}) : null, /* @__PURE__ */ jsxs("fieldset", {
+			disabled: isAuctionEnded,
+			className: "flex w-full flex-col gap-4",
+			children: [
+				lockedBid !== null ? /* @__PURE__ */ jsx(Text, {
+					size: "1",
+					children: "Update your bid. You will pay the difference between the new bid amount and the existing bid."
+				}) : /* @__PURE__ */ jsx(Text, {
+					size: "1",
+					children: "Place a new bid to participate in the auction."
+				}),
+				/* @__PURE__ */ jsx(SteppedInput.Root, {
+					value: bidValue,
+					onChange: setBidValue,
+					min: effectiveMinBid,
+					getTickSize,
+					decimals: inputDecimals,
+					disabled: isAuctionEnded,
+					snapToTick: "nearest",
+					children: /* @__PURE__ */ jsxs(SteppedInput.Group, { children: [
+						/* @__PURE__ */ jsx(SteppedInput.Decrement, {}),
+						/* @__PURE__ */ jsxs(SteppedInput.ScrubArea, { children: [/* @__PURE__ */ jsx(SteppedInput.ScrubAreaCursor, { children: /* @__PURE__ */ jsx(CursorGrowIcon, {}) }), /* @__PURE__ */ jsx(SteppedInput.Value, { children: ({ value }) => `${formatPrice(value)} ${currencySymbol}` })] }),
+						/* @__PURE__ */ jsx(SteppedInput.Increment, {})
+					] })
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "flex w-full gap-2",
+					children: [/* @__PURE__ */ jsx(Button, {
+						type: "button",
+						color: "tertiary",
+						className: "grow whitespace-nowrap",
+						onClick: cancelBidding,
+						children: "Cancel"
+					}), /* @__PURE__ */ jsx(Button, {
+						className: "grow",
+						type: "button",
+						loading: isLoading,
+						disabled: isAuctionEnded || !!lockedBid && bidValue - lockedBid.priceValue === 0n,
+						onClick: handleSubmit,
+						children: lockedBid !== null ? /* @__PURE__ */ jsxs("span", { children: [
+							"Update bid (+",
+							formatPrice(bidValue - lockedBid.priceValue),
+							" ",
+							currencySymbol,
+							")"
+						] }) : /* @__PURE__ */ jsx("span", { children: "Place bid" })
+					})]
+				})
+			]
+		})]
+	});
+}
+const AuctionBidForm = { Root: AuctionBidFormRoot };
+
+//#endregion
+export { AuctionBidForm };

package/dist/components/blocks/auction/AuctionBidInput.d.ts

@@ -0,0 +1,9 @@
+//#region src/components/blocks/auction/AuctionBidInput.d.ts
+interface AuctionBidInputProps {
+  className?: string;
+}
+declare function AuctionBidInput({
+  className
+}: AuctionBidInputProps): React.ReactElement;
+//#endregion
+export { AuctionBidInput, AuctionBidInputProps };

package/dist/components/blocks/auction/AuctionBidInput.js

@@ -0,0 +1,99 @@
+"use client";
+
+import { useAuctionContext } from "./AuctionContext.js";
+import { transitions } from "../../../lib/motion.js";
+import { Button } from "../../primitives/Button.js";
+import { CursorGrowIcon, SteppedInput } from "../../primitives/SteppedInput.js";
+import { Text } from "../../primitives/Text.js";
+import { useCallback, useEffect } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { AnimatePresence, motion } from "motion/react";
+
+//#region src/components/blocks/auction/AuctionBidInput.tsx
+function AuctionBidInput({ className }) {
+	const { isAuctionEnded, minBidValue, tickConfig, tickSize, lockedBid, setLockedBid, placeBidOperation, topUpOperation, handlePlaceBid, handleTopUp, getProjectedRank, bidValue, setBidValue, formatPrice, currencySymbol, inputDecimals } = useAuctionContext();
+	const effectiveMinBid = lockedBid !== null && lockedBid.priceValue > minBidValue ? lockedBid.priceValue : minBidValue;
+	useEffect(() => {
+		setBidValue((prev) => prev < effectiveMinBid ? effectiveMinBid : prev);
+	}, [effectiveMinBid, setBidValue]);
+	const getTickSize = useCallback((currentValue) => {
+		if (!tickConfig) return tickSize;
+		return currentValue > tickConfig.threshold ? tickConfig.largeTickSize : tickConfig.smallTickSize;
+	}, [tickConfig, tickSize]);
+	const activeOperation = lockedBid !== null ? topUpOperation : placeBidOperation;
+	const status = activeOperation.status;
+	const errorMessage = activeOperation.error;
+	const { rank: projectedRank, isWinning: isProjectedWinning } = getProjectedRank(bidValue);
+	const bidDisplay = `${formatPrice(bidValue)} ${currencySymbol}`;
+	const primaryCtaLabel = lockedBid !== null ? projectedRank != null && !isAuctionEnded ? `Top up to rank #${projectedRank}${!isProjectedWinning ? " (outside winning range)" : ""}` : "Top up" : projectedRank != null && !isAuctionEnded ? `Bid ${bidDisplay} and get rank #${projectedRank}${!isProjectedWinning ? " (outside winning range)" : ""}` : `Bid ${bidDisplay}`;
+	const handleSubmit = useCallback(async () => {
+		if (lockedBid !== null ? await handleTopUp(bidValue.toString()) : await handlePlaceBid(bidValue.toString())) setBidValue(effectiveMinBid);
+	}, [
+		bidValue,
+		effectiveMinBid,
+		lockedBid,
+		handlePlaceBid,
+		handleTopUp,
+		setBidValue
+	]);
+	const isLoading = status === "pending" || status === "confirming" || status === "indexing";
+	return /* @__PURE__ */ jsxs("div", {
+		className,
+		children: [status === "error" ? /* @__PURE__ */ jsx("div", {
+			className: "bg-error/10 text-error mb-2 rounded-xs p-2",
+			children: /* @__PURE__ */ jsx(Text, {
+				size: "1",
+				children: errorMessage
+			})
+		}) : null, /* @__PURE__ */ jsxs("fieldset", {
+			disabled: isAuctionEnded,
+			className: "flex w-full flex-col gap-2",
+			children: [/* @__PURE__ */ jsx(SteppedInput.Root, {
+				value: bidValue,
+				onChange: setBidValue,
+				min: effectiveMinBid,
+				getTickSize,
+				decimals: inputDecimals,
+				disabled: isAuctionEnded,
+				snapToTick: "nearest",
+				children: /* @__PURE__ */ jsxs(SteppedInput.Group, { children: [
+					/* @__PURE__ */ jsx(SteppedInput.Decrement, {}),
+					/* @__PURE__ */ jsxs(SteppedInput.ScrubArea, { children: [/* @__PURE__ */ jsx(SteppedInput.ScrubAreaCursor, { children: /* @__PURE__ */ jsx(CursorGrowIcon, {}) }), /* @__PURE__ */ jsx(SteppedInput.Value, { children: ({ value }) => `${formatPrice(value)} ${currencySymbol}` })] }),
+					/* @__PURE__ */ jsx(SteppedInput.Increment, {})
+				] })
+			}), /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-row gap-2",
+				children: [/* @__PURE__ */ jsx(AnimatePresence, {
+					mode: "popLayout",
+					children: lockedBid !== null && /* @__PURE__ */ jsx(motion.div, {
+						initial: { opacity: 0 },
+						animate: { opacity: 1 },
+						exit: { opacity: 0 },
+						transition: transitions.fade,
+						className: "flex-1",
+						children: /* @__PURE__ */ jsx(Button, {
+							type: "button",
+							color: "tertiary",
+							className: "w-full whitespace-nowrap",
+							onClick: () => setLockedBid(null),
+							children: "Cancel top up"
+						})
+					}, "cancel-button")
+				}), /* @__PURE__ */ jsx("div", {
+					className: "min-w-0 flex-1",
+					children: /* @__PURE__ */ jsx(Button, {
+						type: "button",
+						loading: isLoading,
+						disabled: isAuctionEnded,
+						onClick: handleSubmit,
+						className: "w-full whitespace-nowrap",
+						children: primaryCtaLabel
+					})
+				})]
+			})]
+		})]
+	});
+}
+
+//#endregion
+export { AuctionBidInput };

package/dist/components/blocks/auction/AuctionContext.d.ts

@@ -0,0 +1,71 @@
+import { AuctionData, AuctionFormatters, AuctionTickConfig, AuctionUserBid, OperationState, RankableBid } from "../../../types/index.js";
+
+//#region src/components/blocks/auction/AuctionContext.d.ts
+interface AuctionContextValue {
+  auction: AuctionData;
+  isAuctionEnded: boolean;
+  bids: RankableBid[];
+  userBids: AuctionUserBid[];
+  maxTotalItems: number;
+  bidValue: bigint;
+  setBidValue: (value: bigint | ((prev: bigint) => bigint)) => void;
+  minBidValue: bigint;
+  reservePriceValue: bigint;
+  tickReferencePrice: bigint;
+  tickConfig: AuctionTickConfig | undefined;
+  tickSize: bigint;
+  placeBidOperation: OperationState;
+  topUpOperation: OperationState;
+  lockedBid: {
+    bidId: bigint;
+    priceValue: bigint;
+  } | null;
+  mergedForRank: RankableBid[];
+  getRankForBid: (bidId: string) => number | null;
+  getProjectedRank: (priceValue: bigint) => {
+    rank: number | null;
+    isWinning: boolean;
+  };
+  getSuggestedBids: () => bigint[];
+  showBidPreview: boolean;
+  setShowBidPreview: (show: boolean) => void;
+  isBiddingActive: boolean;
+  setIsBiddingActive: (active: boolean) => void;
+  startBidding: () => void;
+  cancelBidding: () => void;
+  setLockedBid: (bid: {
+    bidId: bigint;
+    priceValue: bigint;
+  } | null) => void;
+  handlePlaceBid: (price: string) => Promise<boolean>;
+  handleTopUp: (newPrice: string) => Promise<boolean>;
+  handleClaimEdition?: (bidId: string) => Promise<boolean>;
+  resetOperations: () => void;
+  formatPrice: (priceValue: bigint) => string;
+  formatTime: (date: Date) => string;
+  currencySymbol: string;
+  inputDecimals: number;
+}
+declare function useAuctionContext(): AuctionContextValue;
+interface AuctionProviderProps {
+  auction: AuctionData;
+  bids: RankableBid[];
+  userBids: AuctionUserBid[];
+  onPlaceBid: (price: bigint, quantity: bigint) => Promise<boolean>;
+  onTopUpBid: (bidId: bigint, newPrice: bigint, additionalValue: bigint) => Promise<boolean>;
+  onClaimEdition?: (bidId: string) => Promise<boolean>;
+  formatters?: AuctionFormatters;
+  children: React.ReactNode;
+}
+declare function AuctionProvider({
+  auction,
+  bids,
+  userBids,
+  onPlaceBid,
+  onTopUpBid,
+  onClaimEdition,
+  formatters,
+  children
+}: AuctionProviderProps): React.ReactElement;
+//#endregion
+export { AuctionProvider, AuctionProviderProps, useAuctionContext };

package/dist/components/blocks/auction/AuctionContext.js

@@ -0,0 +1,228 @@
+"use client";
+
+import { getProjectedRankForPrice, getSuggestedBidPrices } from "../../../utils/rank-utils.js";
+import { createContext, useCallback, useContext, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/blocks/auction/AuctionContext.tsx
+const AuctionContext = createContext(null);
+function useAuctionContext() {
+	const ctx = useContext(AuctionContext);
+	if (!ctx) throw new Error("useAuctionContext must be used within an Auction provider");
+	return ctx;
+}
+function AuctionProvider({ auction, bids, userBids, onPlaceBid, onTopUpBid, onClaimEdition, formatters, children }) {
+	const defaultFormatPrice = (priceValue) => {
+		return (Number(priceValue) / 0xde0b6b3a7640000).toLocaleString("en-US", {
+			minimumFractionDigits: 3,
+			maximumFractionDigits: 3
+		});
+	};
+	const defaultFormatTime = (date) => {
+		const now = Date.now();
+		const diff = date.getTime() - now;
+		const isPast = diff < 0;
+		const absMs = Math.abs(diff);
+		const seconds = Math.floor(absMs / 1e3);
+		const minutes = Math.floor(seconds / 60);
+		const hours = Math.floor(minutes / 60);
+		const days = Math.floor(hours / 24);
+		if (days > 0) return `${days}d ${hours % 24}h ${isPast ? "ago" : ""}`;
+		if (hours > 0) return `${hours}h ${minutes % 60}m ${isPast ? "ago" : ""}`;
+		if (minutes > 0) return `${minutes}m ${seconds % 60}s ${isPast ? "ago" : ""}`;
+		return `${seconds}s ${isPast ? "ago" : ""}`;
+	};
+	const formatPrice = formatters?.formatPrice ?? defaultFormatPrice;
+	const formatTime = formatters?.formatTime ?? defaultFormatTime;
+	const currencySymbol = formatters?.currencySymbol ?? "USD";
+	const inputDecimals = formatters?.inputDecimals ?? 18;
+	const isAuctionEnded = auction.endsAt ? Date.now() > auction.endsAt.getTime() : false;
+	const reservePriceValue = auction.reservePrice;
+	const tickConfig = auction.tickConfig;
+	const activeBids = bids.filter((b) => {
+		const bid = userBids.find((ub) => ub.id === b.id);
+		return !bid || bid.status === "active";
+	});
+	const totalActiveQty = BigInt(activeBids.length);
+	const mergedForRank = useMemo(() => {
+		const cutoffIds = new Set(bids.map((b) => b.id));
+		const myBidsNotInCutoff = userBids.filter((bid) => bid.status === "active" && !cutoffIds.has(bid.id)).map((bid) => ({
+			id: bid.id,
+			price: bid.price.toString(),
+			created_at: bid.createdAt.toISOString()
+		}));
+		return [...bids, ...myBidsNotInCutoff].sort((a, b) => {
+			const pa = BigInt(a.price);
+			const pb = BigInt(b.price);
+			if (pa !== pb) return pb > pa ? 1 : -1;
+			return new Date(a.created_at).getTime() - new Date(b.created_at).getTime();
+		});
+	}, [bids, userBids]);
+	const minBidValue = useMemo(() => {
+		if (totalActiveQty >= BigInt(auction.maxTotalItems)) {
+			const winningBids = mergedForRank.slice(0, auction.maxTotalItems);
+			if (winningBids.length > 0) {
+				const lastWinning = winningBids[winningBids.length - 1];
+				const tickSize = tickConfig ? BigInt(lastWinning.price) > tickConfig.threshold ? tickConfig.largeTickSize : tickConfig.smallTickSize : BigInt(lastWinning.price);
+				return BigInt(lastWinning.price) + tickSize;
+			}
+		}
+		return reservePriceValue;
+	}, [
+		reservePriceValue,
+		totalActiveQty,
+		auction.maxTotalItems,
+		mergedForRank,
+		tickConfig
+	]);
+	const tickReferencePrice = minBidValue;
+	const tickSize = useMemo(() => {
+		if (!tickConfig) return minBidValue;
+		return BigInt(minBidValue) > tickConfig.threshold ? tickConfig.largeTickSize : tickConfig.smallTickSize;
+	}, [tickConfig, minBidValue]);
+	const getRankForBid = useCallback((bidId) => {
+		const idx = mergedForRank.findIndex((b) => b.id === bidId);
+		return idx >= 0 ? idx + 1 : null;
+	}, [mergedForRank]);
+	const getProjectedRank = useCallback((priceValue) => {
+		return getProjectedRankForPrice(priceValue, mergedForRank, auction.maxTotalItems);
+	}, [mergedForRank, auction.maxTotalItems]);
+	const getSuggestedBids = useCallback(() => {
+		return getSuggestedBidPrices({
+			mergedForRank,
+			maxTotalItems: auction.maxTotalItems,
+			minBidValue,
+			reservePriceValue,
+			tickConfig,
+			tickSize
+		});
+	}, [
+		mergedForRank,
+		auction.maxTotalItems,
+		minBidValue,
+		reservePriceValue,
+		tickConfig,
+		tickSize
+	]);
+	const [placeBidOperation, setPlaceBidOperation] = useState({ status: "idle" });
+	const [topUpOperation, setTopUpOperation] = useState({ status: "idle" });
+	const [lockedBid, setLockedBid] = useState(null);
+	const [showBidPreview, setShowBidPreview] = useState(false);
+	const [isBiddingActive, setIsBiddingActive] = useState(false);
+	const startBidding = useCallback(() => {
+		setIsBiddingActive(true);
+		setShowBidPreview(true);
+	}, []);
+	const cancelBidding = useCallback(() => {
+		setIsBiddingActive(false);
+		setShowBidPreview(false);
+		setLockedBid(null);
+	}, []);
+	const setLockedBidAndActivate = useCallback((bid) => {
+		setLockedBid(bid);
+		if (bid !== null) {
+			setIsBiddingActive(true);
+			setShowBidPreview(true);
+		}
+	}, []);
+	const [bidValue, setBidValue] = useState(minBidValue);
+	const resetOperations = useCallback(() => {
+		setPlaceBidOperation({ status: "idle" });
+		setTopUpOperation({ status: "idle" });
+	}, []);
+	const handlePlaceBid = useCallback(async (price) => {
+		const priceValue = BigInt(price);
+		setPlaceBidOperation({ status: "pending" });
+		try {
+			if (await onPlaceBid(priceValue, 1n)) {
+				setPlaceBidOperation({ status: "success" });
+				setShowBidPreview(false);
+				return true;
+			} else {
+				setPlaceBidOperation({
+					status: "error",
+					error: "Transaction failed"
+				});
+				return false;
+			}
+		} catch (err) {
+			setPlaceBidOperation({
+				status: "error",
+				error: err instanceof Error ? err.message : "Unknown error"
+			});
+			return false;
+		}
+	}, [onPlaceBid]);
+	const handleTopUp = useCallback(async (newPrice) => {
+		if (!lockedBid) return false;
+		const newPriceValue = BigInt(newPrice);
+		const additionalValue = newPriceValue - lockedBid.priceValue;
+		setTopUpOperation({ status: "pending" });
+		try {
+			if (await onTopUpBid(lockedBid.bidId, newPriceValue, additionalValue)) {
+				setTopUpOperation({ status: "success" });
+				setLockedBid(null);
+				return true;
+			} else {
+				setTopUpOperation({
+					status: "error",
+					error: "Transaction failed"
+				});
+				return false;
+			}
+		} catch (err) {
+			setTopUpOperation({
+				status: "error",
+				error: err instanceof Error ? err.message : "Unknown error"
+			});
+			return false;
+		}
+	}, [lockedBid, onTopUpBid]);
+	const handleClaimEdition = useCallback(async (bidId) => {
+		if (!onClaimEdition) return false;
+		return onClaimEdition(bidId);
+	}, [onClaimEdition]);
+	const value = {
+		auction,
+		isAuctionEnded,
+		bids,
+		userBids,
+		maxTotalItems: auction.maxTotalItems,
+		bidValue,
+		setBidValue,
+		minBidValue,
+		reservePriceValue,
+		tickReferencePrice,
+		tickConfig,
+		tickSize,
+		placeBidOperation,
+		topUpOperation,
+		lockedBid,
+		mergedForRank,
+		getRankForBid,
+		getProjectedRank,
+		getSuggestedBids,
+		showBidPreview,
+		setShowBidPreview,
+		isBiddingActive,
+		setIsBiddingActive,
+		startBidding,
+		cancelBidding,
+		setLockedBid: setLockedBidAndActivate,
+		handlePlaceBid,
+		handleTopUp,
+		handleClaimEdition,
+		resetOperations,
+		formatPrice,
+		formatTime,
+		currencySymbol,
+		inputDecimals
+	};
+	return /* @__PURE__ */ jsx(AuctionContext.Provider, {
+		value,
+		children
+	});
+}
+
+//#endregion
+export { AuctionProvider, useAuctionContext };

package/dist/components/blocks/auction/AuctionInfo.d.ts

@@ -0,0 +1,9 @@
+//#region src/components/blocks/auction/AuctionInfo.d.ts
+interface AuctionInfoProps {
+  className?: string;
+}
+declare function AuctionInfo({
+  className
+}: AuctionInfoProps): React.ReactElement;
+//#endregion
+export { AuctionInfo, AuctionInfoProps };

package/dist/components/blocks/auction/AuctionInfo.js

@@ -0,0 +1,37 @@
+"use client";
+
+import { useAuctionContext } from "./AuctionContext.js";
+import { Text } from "../../primitives/Text.js";
+import { AuctionStatusTag } from "./AuctionStatusTag.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/blocks/auction/AuctionInfo.tsx
+function AuctionInfo({ className }) {
+	const { auction, isAuctionEnded, maxTotalItems } = useAuctionContext();
+	const editionsLabel = maxTotalItems === 1 ? "1 item" : `${maxTotalItems} items`;
+	return /* @__PURE__ */ jsxs("div", {
+		className,
+		children: [/* @__PURE__ */ jsx("div", {
+			className: "flex flex-wrap items-center gap-2",
+			children: /* @__PURE__ */ jsx(AuctionStatusTag, {
+				opensAt: auction.opensAt,
+				endsAt: auction.endsAt,
+				background: "transparent"
+			})
+		}), !isAuctionEnded ? /* @__PURE__ */ jsxs(Text, {
+			size: "2",
+			color: "tertiary",
+			className: "mt-2",
+			children: [
+				"Bid on one of ",
+				editionsLabel,
+				". Top ",
+				maxTotalItems,
+				" bidders win and pay the lowest winning bid."
+			]
+		}) : null]
+	});
+}
+
+//#endregion
+export { AuctionInfo };