@thenamespace/ens-components 1.3.0 → 1.4.0

package/dist/types/components/ens-name-registration/RegistrationSummary.d.ts

@@ -10,6 +10,8 @@ export interface RegistrationSummaryProps {
     };
     transactionFees?: {
         isChecking: boolean;
+        failed?: boolean;
+        isHeuristic?: boolean;
         estimatedGas: number;
         price: {
             wei: bigint;

package/dist/types/components/ens-name-registration/registration/types.d.ts

@@ -15,6 +15,7 @@ export interface RegistrationState {
         tx?: string;
         completed: boolean;
         time: number;
+        feeWei?: bigint;
     };
     timerStartedAt: number;
     registration: {

package/dist/types/components/molecules/pricing-display/PricingDisplay.d.ts

@@ -1,19 +1,19 @@
 import React from "react";
 import "./PricingDisplay.css";
+interface FeeRow {
+    amount: number | string;
+    isChecking: boolean;
+    /** Optional precise wei value. When provided, USD is computed from wei
+     *  rather than from the (possibly rounded) display string. See
+     *  `usdFromWei` for the precision bound. */
+    weiAmount?: bigint;
+}
 export interface PricingDisplayProps {
-    primaryFee: {
+    primaryFee: FeeRow & {
         label: string;
-        amount: number | string;
-        isChecking: boolean;
-    };
-    networkFees?: {
-        amount: number | string;
-        isChecking: boolean;
-    };
-    total: {
-        amount: number | string;
-        isChecking: boolean;
     };
+    networkFees?: FeeRow;
+    total: FeeRow;
     expiryPicker?: {
         durationSeconds: number;
         onDurationChange: (seconds: number) => void;

package/dist/types/hooks/useRegisterENS.d.ts

@@ -4,6 +4,15 @@ interface RentPriceResponse {
     wei: bigint;
     eth: number;
 }
+export interface RegistrationFeeEstimate {
+    wei: bigint;
+    eth: number;
+    gasEstimate: bigint;
+    gasPrice: bigint;
+    /** True when the precise eth_estimateGas+stateOverride path failed and we
+     *  fell back to a heuristic. UI can mark the value as approximate. */
+    isHeuristic: boolean;
+}
 export interface RegistrationRequest {
     label: string;
     owner: Address;
@@ -17,6 +26,7 @@ export declare const useRegisterENS: ({ isTestnet }: {
 }) => {
     isEnsAvailable: (label: string) => Promise<boolean>;
     getRegistrationPrice: (label: string, durationInSeconds?: number) => Promise<RentPriceResponse>;
+    estimateRegistrationFees: (request: RegistrationRequest) => Promise<RegistrationFeeEstimate>;
     sendCommitmentTx: (request: RegistrationRequest) => Promise<Hash>;
     sendRegisterTx: (request: RegistrationRequest) => Promise<{
         txHash: Hash;

package/dist/types/utils/index.d.ts

@@ -7,3 +7,4 @@ export * from "./ens";
 export * from "./blockExplorer";
 export * from "./async";
 export * from "./date";
+export * from "./pricing";

package/dist/types/utils/pricing.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Pure helpers for formatting ETH/USD pricing in the registration UI.
+ *
+ * Display rules:
+ *  - ETH is rendered at a fixed 4 decimals.
+ *  - Non-zero values smaller than 0.0001 ETH render as the literal "<0.0001"
+ *    so cheap-gas rows stay informative without claiming a misleading exact
+ *    figure. The USD subtitle is derived from wei (when available) so it
+ *    stays numerically honest even when the ETH cell is rounded.
+ *  - "Free" and "N/A" are sentinel strings — they bypass formatting and
+ *    suppress the USD subtitle.
+ */
+export declare const ETH_SENTINELS: readonly ["Free", "N/A"];
+export type EthSentinel = (typeof ETH_SENTINELS)[number];
+export declare const isSentinel: (amount: number | string) => amount is EthSentinel;
+/**
+ * Format an ETH amount for display at a fixed 4 decimals.
+ *
+ * Any positive value below the 4-decimal threshold renders as the literal
+ * "<0.0001" — honest about the rounding direction, and (crucially) avoids
+ * the misleading 1:1 read against the wei-derived USD subtitle when the
+ * true amount is much smaller than 0.0001 ETH.
+ */
+export declare const formatEth: (eth: number) => string;
+/**
+ * Convert wei → USD. Note the `Number(bigint)` cast loses exactness above
+ * 2^53 wei (~0.009 ETH); the resulting error is < 1e-7 relative, which is
+ * invisible after `.toFixed(2)` for any realistic ENS registration total.
+ */
+export declare const usdFromWei: (wei: bigint, rate: number) => number;
+/**
+ * Compute the `≈ $X.XX` subtitle for a fee row.
+ *
+ * Prefers `weiAmount` (precise) over the displayed string (which may have
+ * been rounded by `formatEth`). Returns `null` when the row is loading,
+ * unpriced, a sentinel ("Free"/"N/A"), or otherwise unparseable.
+ */
+export declare const computeUsd: (amount: number | string, weiAmount: bigint | undefined, ethUsdRate: number | null | undefined, isChecking: boolean) => string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thenamespace/ens-components",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "",
   "main": "dist/index.cjs",
   "module": "dist/index.js",