@hyperlane-xyz/widgets 1.5.7-beta5 → 1.5.7-beta8

package/dist/esm/messages/types.d.ts

@@ -0,0 +1,79 @@
+export declare enum MessageStatus {
+    Unknown = "unknown",
+    Pending = "pending",
+    Delivered = "delivered",
+    Failing = "failing"
+}
+export interface MessageTxStub {
+    timestamp: number;
+    hash: string;
+    from: Address;
+}
+export interface MessageTx extends MessageTxStub {
+    to: Address;
+    blockHash: string;
+    blockNumber: number;
+    mailbox: Address;
+    nonce: number;
+    gasLimit: number;
+    gasPrice: number;
+    effectiveGasPrice: any;
+    gasUsed: number;
+    cumulativeGasUsed: number;
+    maxFeePerGas: number;
+    maxPriorityPerGas: number;
+}
+export interface MessageStub {
+    status: MessageStatus;
+    id: string;
+    msgId: string;
+    nonce: number;
+    sender: Address;
+    recipient: Address;
+    originChainId: number;
+    originDomainId: number;
+    destinationChainId: number;
+    destinationDomainId: number;
+    origin: MessageTxStub;
+    destination?: MessageTxStub;
+    isPiMsg?: boolean;
+}
+export interface Message extends MessageStub {
+    body: string;
+    decodedBody?: string;
+    origin: MessageTx;
+    destination?: MessageTx;
+    totalGasAmount?: string;
+    totalPayment?: string;
+    numPayments?: number;
+}
+export type ApiMessage = Omit<Message, 'msgId' | 'decodedBody'>;
+export interface PartialMessage {
+    status: MessageStatus;
+    nonce: number;
+    originChainId: number;
+    originDomainId: number;
+    destinationChainId: number;
+    destinationDomainId: number;
+    origin: {
+        blockNumber: number;
+        timestamp: number;
+    };
+    destination?: {
+        blockNumber: number;
+        timestamp: number;
+    };
+}
+export declare enum MessageStage {
+    Preparing = 0,
+    Sent = 1,
+    Finalized = 2,
+    Validated = 3,
+    Relayed = 4
+}
+export type StageTimings = {
+    [MessageStage.Finalized]: number | null;
+    [MessageStage.Validated]: number | null;
+    [MessageStage.Relayed]: number | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/messages/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/messages/types.ts"],"names":[],"mappings":"AAEA,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,MAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,IAAI,CAC3B,OAAO,EACL,OAAO,GACP,aAAa,CAChB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,WAAW,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,oBAAY,YAAY;IACtB,SAAS,IAAI;IACb,IAAI,IAAI;IACR,SAAS,IAAI;IACb,SAAS,IAAI;IACb,OAAO,IAAI;CACZ;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC"}

package/dist/esm/messages/types.js

@@ -0,0 +1,18 @@
+// TODO DE-DUPE WITH EXPLORER
+// Mostly copied from explorer src/types.ts
+export var MessageStatus;
+(function (MessageStatus) {
+    MessageStatus["Unknown"] = "unknown";
+    MessageStatus["Pending"] = "pending";
+    MessageStatus["Delivered"] = "delivered";
+    MessageStatus["Failing"] = "failing";
+})(MessageStatus || (MessageStatus = {}));
+export var MessageStage;
+(function (MessageStage) {
+    MessageStage[MessageStage["Preparing"] = 0] = "Preparing";
+    MessageStage[MessageStage["Sent"] = 1] = "Sent";
+    MessageStage[MessageStage["Finalized"] = 2] = "Finalized";
+    MessageStage[MessageStage["Validated"] = 3] = "Validated";
+    MessageStage[MessageStage["Relayed"] = 4] = "Relayed";
+})(MessageStage || (MessageStage = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/messages/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/messages/types.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,2CAA2C;AAC3C,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,oCAAmB,CAAA;AACrB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAkED,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,yDAAa,CAAA;IACb,+CAAQ,CAAA;IACR,yDAAa,CAAA;IACb,yDAAa,CAAA;IACb,qDAAW,CAAA;AACb,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB"}

package/dist/esm/messages/useMessage.d.ts

@@ -0,0 +1,14 @@
+import { ApiMessage } from './types';
+interface Params {
+    messageId?: string;
+    originTxHash?: string;
+    explorerApiUrl?: string;
+    retryInterval?: number;
+}
+export declare function useMessage({ messageId, originTxHash, explorerApiUrl, retryInterval, }: Params): {
+    data: ApiMessage | null;
+    isLoading: boolean;
+    error: string | null;
+};
+export {};
+//# sourceMappingURL=useMessage.d.ts.map

package/dist/esm/messages/useMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessage.d.ts","sourceRoot":"","sources":["../../../src/messages/useMessage.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AAEpD,UAAU,MAAM;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,YAAY,EACZ,cAA2C,EAC3C,aAAoB,GACrB,EAAE,MAAM;;;;EA6BR"}

package/dist/esm/messages/useMessage.js

@@ -0,0 +1,69 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useCallback, useState } from 'react';
+import { HYPERLANE_EXPLORER_API_URL } from '../consts';
+import { executeExplorerQuery } from '../utils/explorers';
+import { useInterval } from '../utils/useInterval';
+import { MessageStatus } from './types';
+// Queries Explorer API to get data for message
+// Requires either messageId or originTxHash
+export function useMessage({ messageId, originTxHash, explorerApiUrl = HYPERLANE_EXPLORER_API_URL, retryInterval = 2000, }) {
+    // Tempting to use react-query here as we did in Explorer but
+    // avoiding for now to keep dependencies for this lib minimal
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [data, setData] = useState(null);
+    const fetcher = useCallback(() => {
+        // Skip if message is already fetched and delivered
+        if ((data === null || data === void 0 ? void 0 : data.status) === MessageStatus.Delivered)
+            return;
+        setIsLoading(true);
+        fetchMessage(explorerApiUrl, messageId, originTxHash)
+            .then((result) => {
+            setData(result);
+            setError(null);
+        })
+            .catch((e) => setError(e.toString()))
+            .finally(() => setIsLoading(false));
+    }, [messageId, originTxHash, data]);
+    useInterval(fetcher, retryInterval);
+    return {
+        data,
+        isLoading,
+        error,
+    };
+}
+function fetchMessage(explorerApiUrl, messageId, originTxHash) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!explorerApiUrl)
+            throw new Error('Explorer API URL required');
+        if (!messageId && !originTxHash)
+            throw new Error('Either messageId or originTxHash required');
+        let url = `${explorerApiUrl}?module=message&action=get-messages`;
+        if (messageId)
+            url += `&id=${messageId}`;
+        else if (originTxHash)
+            url += `&origin-tx-hash=${originTxHash}`;
+        const result = yield executeExplorerQuery(url, 5000);
+        if (result.length > 1) {
+            console.warn('More than one message received, should not occur');
+            return result[0];
+        }
+        else if (result.length === 1) {
+            console.debug('Message data found, id:', result[0].id);
+            return result[0];
+        }
+        else {
+            console.debug('Message data not found');
+            return null;
+        }
+    });
+}
+//# sourceMappingURL=useMessage.js.map

package/dist/esm/messages/useMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessage.js","sourceRoot":"","sources":["../../../src/messages/useMessage.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAc,aAAa,EAAE,MAAM,SAAS,CAAC;AASpD,+CAA+C;AAC/C,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,EACzB,SAAS,EACT,YAAY,EACZ,cAAc,GAAG,0BAA0B,EAC3C,aAAa,GAAG,IAAI,GACb;IACP,6DAA6D;IAC7D,6DAA6D;IAE7D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,mDAAmD;QACnD,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,MAAK,aAAa,CAAC,SAAS;YAAE,OAAO;QAErD,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,YAAY,CAAC,cAAc,EAAE,SAAS,EAAE,YAAY,CAAC;aAClD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;aACpC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;IAEpC,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAEpC,OAAO;QACL,IAAI;QACJ,SAAS;QACT,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAe,YAAY,CACzB,cAAsB,EACtB,SAAkB,EAClB,YAAqB;;QAErB,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAClE,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAE9F,IAAI,GAAG,GAAG,GAAG,cAAc,qCAAqC,CAAC;QACjE,IAAI,SAAS;YAAE,GAAG,IAAI,OAAO,SAAS,EAAE,CAAC;aACpC,IAAI,YAAY;YAAE,GAAG,IAAI,mBAAmB,YAAY,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAe,GAAG,EAAE,IAAI,CAAC,CAAC;QAEnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;YACrB,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;YACjE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;SAClB;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;SAClB;aAAM;YACL,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC;SACb;IACH,CAAC;CAAA"}

package/dist/esm/messages/useMessageStage.d.ts

@@ -0,0 +1,14 @@
+import { PartialMessage, MessageStage as Stage, StageTimings } from './types';
+interface Params {
+    message: PartialMessage | null | undefined;
+    explorerApiUrl?: string;
+    retryInterval?: number;
+}
+export declare function useMessageStage({ message, explorerApiUrl, retryInterval, }: Params): {
+    stage: Stage;
+    timings: StageTimings;
+    isLoading: boolean;
+    error: string | null;
+};
+export {};
+//# sourceMappingURL=useMessageStage.d.ts.map

package/dist/esm/messages/useMessageStage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageStage.d.ts","sourceRoot":"","sources":["../../../src/messages/useMessageStage.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,cAAc,EAAE,YAAY,IAAI,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI7F,UAAU,MAAM;IACd,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAQD,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,cAA2C,EAC3C,aAAoB,GACrB,EAAE,MAAM;;;;;EAkCR"}

package/dist/esm/messages/useMessageStage.js

@@ -0,0 +1,168 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useCallback, useState } from 'react';
+import { chainIdToMetadata } from '@hyperlane-xyz/sdk';
+import { HYPERLANE_EXPLORER_API_URL } from '../consts';
+import { queryExplorerForBlock } from '../utils/explorers';
+import { fetchWithTimeout } from '../utils/timeout';
+import { useInterval } from '../utils/useInterval';
+import { MessageStatus, MessageStage as Stage } from './types';
+const VALIDATION_TIME_EST = 5;
+const defaultTiming = {
+    [Stage.Finalized]: null,
+    [Stage.Validated]: null,
+    [Stage.Relayed]: null,
+};
+export function useMessageStage({ message, explorerApiUrl = HYPERLANE_EXPLORER_API_URL, retryInterval = 2000, }) {
+    // Tempting to use react-query here as we did in Explorer but
+    // avoiding for now to keep dependencies for this lib minimal
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [data, setData] = useState(null);
+    const fetcher = useCallback(() => {
+        // Skip invalid or placeholder messages
+        if (!isValidMessage(message))
+            return;
+        // Don't re-run for failing messages
+        if (message.status === MessageStatus.Failing && data)
+            return;
+        // Don't re-run for pending, validated messages
+        if (message.status === MessageStatus.Pending && (data === null || data === void 0 ? void 0 : data.stage) === Stage.Validated)
+            return;
+        setIsLoading(true);
+        fetchMessageState(message, explorerApiUrl)
+            .then((result) => {
+            setData(result);
+            setError(null);
+        })
+            .catch((e) => setError(e.toString()))
+            .finally(() => setIsLoading(false));
+    }, [message, data]);
+    useInterval(fetcher, retryInterval);
+    return {
+        stage: (data === null || data === void 0 ? void 0 : data.stage) ? data.stage : isValidMessage(message) ? Stage.Sent : Stage.Preparing,
+        timings: (data === null || data === void 0 ? void 0 : data.timings) ? data.timings : defaultTiming,
+        isLoading,
+        error,
+    };
+}
+function fetchMessageState(message, explorerApiUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { status, nonce, originChainId, destinationChainId, origin, destination } = message;
+        const { blockNumber: originBlockNumber, timestamp: originTimestamp } = origin;
+        const destTimestamp = destination === null || destination === void 0 ? void 0 : destination.timestamp;
+        const relayEstimate = Math.floor(getBlockTimeEst(destinationChainId) * 1.5);
+        const finalityBlocks = getFinalityBlocks(originChainId);
+        const finalityEstimate = finalityBlocks * getBlockTimeEst(originChainId);
+        if (status === MessageStatus.Delivered && destTimestamp) {
+            // For delivered messages, just to rough estimates for stages
+            // This saves us from making extra explorer calls. May want to revisit in future
+            const totalDuration = Math.round((destTimestamp - originTimestamp) / 1000);
+            const finalityDuration = Math.max(Math.min(finalityEstimate, totalDuration - VALIDATION_TIME_EST), 1);
+            const remaining = totalDuration - finalityDuration;
+            const validateDuration = Math.max(Math.min(Math.round(remaining * 0.25), VALIDATION_TIME_EST), 1);
+            const relayDuration = Math.max(remaining - validateDuration, 1);
+            return {
+                stage: Stage.Relayed,
+                timings: {
+                    [Stage.Finalized]: finalityDuration,
+                    [Stage.Validated]: validateDuration,
+                    [Stage.Relayed]: relayDuration,
+                },
+            };
+        }
+        const latestNonce = yield tryFetchLatestNonce(originChainId, explorerApiUrl);
+        if (latestNonce && latestNonce >= nonce) {
+            return {
+                stage: Stage.Validated,
+                timings: {
+                    [Stage.Finalized]: finalityEstimate,
+                    [Stage.Validated]: VALIDATION_TIME_EST,
+                    [Stage.Relayed]: relayEstimate,
+                },
+            };
+        }
+        const latestBlock = yield tryFetchChainLatestBlock(originChainId);
+        const finalizedBlock = originBlockNumber + finalityBlocks;
+        if (latestBlock && parseInt(latestBlock.number.toString()) > finalizedBlock) {
+            return {
+                stage: Stage.Finalized,
+                timings: {
+                    [Stage.Finalized]: finalityEstimate,
+                    [Stage.Validated]: VALIDATION_TIME_EST,
+                    [Stage.Relayed]: relayEstimate,
+                },
+            };
+        }
+        return {
+            stage: Stage.Sent,
+            timings: {
+                [Stage.Finalized]: finalityEstimate,
+                [Stage.Validated]: VALIDATION_TIME_EST,
+                [Stage.Relayed]: relayEstimate,
+            },
+        };
+    });
+}
+function getFinalityBlocks(chainId) {
+    var _a, _b;
+    const finalityBlocks = ((_b = (_a = chainIdToMetadata[chainId]) === null || _a === void 0 ? void 0 : _a.blocks) === null || _b === void 0 ? void 0 : _b.confirmations) || 0;
+    return Math.max(finalityBlocks, 1);
+}
+function getBlockTimeEst(chainId) {
+    var _a, _b;
+    return ((_b = (_a = chainIdToMetadata[chainId]) === null || _a === void 0 ? void 0 : _a.blocks) === null || _b === void 0 ? void 0 : _b.estimateBlockTime) || 3;
+}
+function tryFetchChainLatestBlock(chainId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!chainId)
+            return null;
+        console.debug(`Attempting to fetch latest block for:`, chainId);
+        try {
+            const block = yield queryExplorerForBlock(chainId, 'latest');
+            return block;
+        }
+        catch (error) {
+            console.error('Error fetching latest block', error);
+            return null;
+        }
+    });
+}
+function tryFetchLatestNonce(chainId, explorerApiUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!chainId)
+            return null;
+        console.debug(`Attempting to fetch nonce for:`, chainId);
+        try {
+            const response = yield fetchWithTimeout(`${explorerApiUrl}/latest-nonce`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ chainId }),
+            }, 3000);
+            const result = yield response.json();
+            console.debug(`Found nonce:`, result.nonce);
+            return result.nonce;
+        }
+        catch (error) {
+            console.error('Error fetching nonce', error);
+            return null;
+        }
+    });
+}
+function isValidMessage(message) {
+    return !!(message &&
+        message.originChainId &&
+        message.destinationChainId &&
+        message.originDomainId &&
+        message.destinationDomainId);
+}
+//# sourceMappingURL=useMessageStage.js.map

package/dist/esm/messages/useMessageStage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageStage.js","sourceRoot":"","sources":["../../../src/messages/useMessageStage.ts"],"names":[],"mappings":"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"}

package/dist/esm/messages/useMessageTimeline.d.ts

@@ -0,0 +1,15 @@
+interface Params {
+    messageId?: string;
+    originTxHash?: string;
+    explorerApiUrl?: string;
+    retryInterval?: number;
+}
+export declare function useMessageTimeline(params: Params): {
+    message: import("./types").ApiMessage | null;
+    stage: import("./types").MessageStage;
+    timings: import("./types").StageTimings;
+    error: string | null;
+    isLoading: boolean;
+};
+export {};
+//# sourceMappingURL=useMessageTimeline.d.ts.map

package/dist/esm/messages/useMessageTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageTimeline.d.ts","sourceRoot":"","sources":["../../../src/messages/useMessageTimeline.ts"],"names":[],"mappings":"AAGA,UAAU,MAAM;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM;;;;;;EAehD"}

package/dist/esm/messages/useMessageTimeline.js

@@ -0,0 +1,14 @@
+import { useMessage } from './useMessage';
+import { useMessageStage } from './useMessageStage';
+export function useMessageTimeline(params) {
+    const { data: message, error: msgError, isLoading: isMsgLoading } = useMessage(params);
+    const { stage, timings, error: stageError, isLoading: isStageLoading, } = useMessageStage({ message, retryInterval: params.retryInterval });
+    return {
+        message,
+        stage,
+        timings,
+        error: msgError || stageError,
+        isLoading: isMsgLoading || isStageLoading,
+    };
+}
+//# sourceMappingURL=useMessageTimeline.js.map

package/dist/esm/messages/useMessageTimeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageTimeline.js","sourceRoot":"","sources":["../../../src/messages/useMessageTimeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASpD,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACvF,MAAM,EACJ,KAAK,EACL,OAAO,EACP,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,cAAc,GAC1B,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACtE,OAAO;QACL,OAAO;QACP,KAAK;QACL,OAAO;QACP,KAAK,EAAE,QAAQ,IAAI,UAAU;QAC7B,SAAS,EAAE,YAAY,IAAI,cAAc;KAC1C,CAAC;AACJ,CAAC"}

package/dist/esm/utils/explorers.d.ts

@@ -0,0 +1,19 @@
+export interface ExplorerQueryResponse<R> {
+    status: string;
+    message: string;
+    result: R;
+}
+export declare function getExplorerUrl(chainId: number): string | null;
+export declare function getExplorerApiUrl(chainId: number): string | null;
+export declare function getTxExplorerUrl(chainId: number, hash?: string): string | null;
+export declare function queryExplorer<P>(chainId: number, path: string, apiKey?: string, timeout?: number): Promise<NonNullable<P>>;
+export declare function executeExplorerQuery<P>(url: string, timeout?: number): Promise<NonNullable<P>>;
+interface PartialBlock {
+    hash: string;
+    number: number;
+    timestamp: number;
+    nonce: string;
+}
+export declare function queryExplorerForBlock(chainId: number, blockNumber?: number | string): Promise<PartialBlock>;
+export {};
+//# sourceMappingURL=explorers.d.ts.map

package/dist/esm/utils/explorers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorers.d.ts","sourceRoot":"","sources":["../../../src/utils/explorers.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,CAAC;CACX;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,iBAI7C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,iBAIhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,iBAI9D;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,2BAcjB;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,2BAa1E;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,yBAWzF"}

package/dist/esm/utils/explorers.js

@@ -0,0 +1,72 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { chainIdToMetadata } from '@hyperlane-xyz/sdk';
+import { fetchWithTimeout } from './timeout';
+export function getExplorerUrl(chainId) {
+    var _a;
+    const chain = chainIdToMetadata[chainId];
+    if (!((_a = chain === null || chain === void 0 ? void 0 : chain.blockExplorers) === null || _a === void 0 ? void 0 : _a.length))
+        return null;
+    return chain.blockExplorers[0].url;
+}
+export function getExplorerApiUrl(chainId) {
+    var _a;
+    const chain = chainIdToMetadata[chainId];
+    if (!((_a = chain === null || chain === void 0 ? void 0 : chain.blockExplorers) === null || _a === void 0 ? void 0 : _a.length))
+        return null;
+    return chain.blockExplorers[0].apiUrl || chain.blockExplorers[0].url;
+}
+export function getTxExplorerUrl(chainId, hash) {
+    const baseUrl = getExplorerUrl(chainId);
+    if (!hash || !baseUrl)
+        return null;
+    return `${baseUrl}/tx/${hash}`;
+}
+export function queryExplorer(chainId, path, apiKey, timeout) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const baseUrl = getExplorerApiUrl(chainId);
+        if (!baseUrl)
+            throw new Error(`No URL found for explorer for chain ${chainId}`);
+        let url = `${baseUrl}/${path}`;
+        console.debug('Querying explorer url:', url);
+        if (apiKey) {
+            url += `&apikey=${apiKey}`;
+        }
+        const result = yield executeExplorerQuery(url, timeout);
+        return result;
+    });
+}
+export function executeExplorerQuery(url, timeout) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield fetchWithTimeout(url, undefined, timeout);
+        if (!response.ok) {
+            throw new Error(`Fetch response not okay: ${response.status}`);
+        }
+        const json = (yield response.json());
+        if (!json.result) {
+            const responseText = yield response.text();
+            throw new Error(`Invalid result format: ${responseText}`);
+        }
+        return json.result;
+    });
+}
+export function queryExplorerForBlock(chainId, blockNumber) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const path = `?module=proxy&action=eth_getBlockByNumber&tag=${blockNumber || 'latest'}&boolean=false`;
+        const block = yield queryExplorer(chainId, path);
+        if (!(block === null || block === void 0 ? void 0 : block.number) || parseInt(block.number.toString()) < 0) {
+            const msg = 'Invalid block result';
+            console.error(msg, JSON.stringify(block), path);
+            throw new Error(msg);
+        }
+        return block;
+    });
+}
+//# sourceMappingURL=explorers.js.map

package/dist/esm/utils/explorers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorers.js","sourceRoot":"","sources":["../../../src/utils/explorers.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/timeout.d.ts

@@ -0,0 +1,2 @@
+export declare function fetchWithTimeout(resource: RequestInfo, options?: RequestInit, timeout?: number): Promise<Response>;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/esm/utils/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../../src/utils/timeout.ts"],"names":[],"mappings":"AAAA,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,SAAQ,qBAUhB"}

package/dist/esm/utils/timeout.js

@@ -0,0 +1,19 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export function fetchWithTimeout(resource, options, timeout = 10000) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const controller = new AbortController();
+        const id = setTimeout(() => controller.abort(), timeout);
+        const response = yield fetch(resource, Object.assign(Object.assign({}, options), { signal: controller.signal }));
+        clearTimeout(id);
+        return response;
+    });
+}
+//# sourceMappingURL=timeout.js.map

package/dist/esm/utils/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../../src/utils/timeout.ts"],"names":[],"mappings":";;;;;;;;;AAAA,MAAM,UAAgB,gBAAgB,CACpC,QAAqB,EACrB,OAAqB,EACrB,OAAO,GAAG,KAAK;;QAEf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,kCAChC,OAAO,KACV,MAAM,EAAE,UAAU,CAAC,MAAM,IACzB,CAAC;QACH,YAAY,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC;CAAA"}

package/dist/esm/utils/useInterval.d.ts

@@ -0,0 +1,2 @@
+export declare function useInterval(callback: () => void, delay: number | null): void;
+//# sourceMappingURL=useInterval.d.ts.map

package/dist/esm/utils/useInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.d.ts","sourceRoot":"","sources":["../../../src/utils/useInterval.ts"],"names":[],"mappings":"AAMA,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,QAoBrE"}

package/dist/esm/utils/useInterval.js

@@ -0,0 +1,22 @@
+import { useEffect, useRef } from 'react';
+import { useLayoutEffect } from 'react';
+const useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;
+// https://usehooks-typescript.com/react-hook/use-interval
+export function useInterval(callback, delay) {
+    const savedCallback = useRef(callback);
+    // Remember the latest callback if it changes.
+    useIsomorphicLayoutEffect(() => {
+        savedCallback.current = callback;
+    }, [callback]);
+    // Set up the interval.
+    useEffect(() => {
+        // Don't schedule if no delay is specified.
+        // Note: 0 is a valid value for delay.
+        if (!delay && delay !== 0) {
+            return;
+        }
+        const id = setInterval(() => savedCallback.current(), delay);
+        return () => clearInterval(id);
+    }, [delay]);
+}
+//# sourceMappingURL=useInterval.js.map

package/dist/esm/utils/useInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.js","sourceRoot":"","sources":["../../../src/utils/useInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAExC,MAAM,yBAAyB,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;AAE9F,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,QAAoB,EAAE,KAAoB;IACpE,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEvC,8CAA8C;IAC9C,yBAAyB,CAAC,GAAG,EAAE;QAC7B,aAAa,CAAC,OAAO,GAAG,QAAQ,CAAC;IACnC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,uBAAuB;IACvB,SAAS,CAAC,GAAG,EAAE;QACb,2CAA2C;QAC3C,sCAAsC;QACtC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,EAAE;YACzB,OAAO;SACR;QAED,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAE7D,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACd,CAAC"}

package/dist/styles.css

@@ -0,0 +1 @@
+/*! tailwindcss v3.2.4 | MIT License | https://tailwindcss.com*/*,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:Helvetica,Arial,sans-serif;font-feature-settings:normal}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:Courier New,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:initial}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;font-weight:inherit;line-height:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:initial}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]{display:none}*,::backdrop,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#2362c080;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }.htw-absolute{position:absolute}.htw-relative{position:relative}.htw--left-3{left:-.75rem}.htw-top-0{top:0}.htw--right-3{right:-.75rem}.htw--top-12{top:-3rem}.htw-mt-2\.5{margin-top:.625rem}.htw-mt-2{margin-top:.5rem}.htw-mt-1{margin-top:.25rem}.htw-flex{display:flex}.htw-h-9{height:2.25rem}.htw-h-6{height:1.5rem}.htw-h-3{height:.75rem}.htw-h-4{height:1rem}.htw-w-full{width:100%}.htw-w-9{width:2.25rem}.htw-w-1{width:.25rem}.htw-w-3{width:.75rem}.htw-w-0\.5{width:.125rem}.htw-w-0{width:0}.htw-flex-1{flex:1 1 0%}.htw--rotate-90{--tw-rotate:-90deg}.htw--rotate-90,.htw-rotate-90{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.htw-rotate-90{--tw-rotate:90deg}.htw-rotate-180{--tw-rotate:180deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes htw-pulse{50%{opacity:.5}}.htw-animate-pulse-slow{animation:htw-pulse 3s cubic-bezier(.4,0,.6,1) infinite}.htw-flex-col{flex-direction:column}.htw-items-center{align-items:center}.htw-justify-center{justify-content:center}.htw-rounded-full{border-radius:9999px}.htw-rounded-l{border-top-left-radius:.3rem;border-bottom-left-radius:.3rem}.htw-rounded-r{border-top-right-radius:.3rem;border-bottom-right-radius:.3rem}.htw-bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246/var(--tw-bg-opacity))}.htw-bg-blue-100{--tw-bg-opacity:1;background-color:rgb(205 220 244/var(--tw-bg-opacity))}.htw-bg-pink-200{--tw-bg-opacity:1;background-color:rgb(235 171 224/var(--tw-bg-opacity))}.htw-bg-green-100{--tw-bg-opacity:1;background-color:rgb(190 213 201/var(--tw-bg-opacity))}.htw-bg-orange-200{--tw-bg-opacity:1;background-color:rgb(254 215 170/var(--tw-bg-opacity))}.htw-bg-violet-200{--tw-bg-opacity:1;background-color:rgb(221 214 254/var(--tw-bg-opacity))}.htw-bg-blue-500{--tw-bg-opacity:1;background-color:rgb(35 98 192/var(--tw-bg-opacity))}.htw-bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.htw-pt-14{padding-top:3.5rem}.htw-pb-1{padding-bottom:.25rem}.htw-text-center{text-align:center}.htw-text-xs{font-size:.75rem;line-height:1rem}.htw-text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity))}.htw-text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128/var(--tw-text-opacity))}.htw-opacity-50{opacity:.5}.htw-transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}@media (min-width:480px){.xs\:htw-w-2{width:.5rem}.xs\:htw-text-sm{font-size:.875rem;line-height:1.25rem}}@media (min-width:640px){.sm\:htw-w-3{width:.75rem}.sm\:htw-px-4{padding-left:1rem;padding-right:1rem}.sm\:htw-text-base{font-size:1rem;line-height:1.5rem}}