@trustless-work/blocks 0.0.5 → 0.0.7

package/templates/escrows/escrows-by-signer/table/EscrowsTable.tsx

@@ -25,8 +25,8 @@ import {
 import { FileX, Loader2, Wallet, RefreshCw, AlertTriangle } from "lucide-react";
 import Filters from "./Filters";
 import { useEscrowsBySigner } from "../useEscrowsBySigner.shared";
-import { useEscrowDialogs } from "../../escrow-context/EscrowDialogsProvider";
-import { useEscrowContext } from "../../escrow-context/EscrowProvider";
+import { useEscrowDialogs } from "@/components/tw-blocks/providers/EscrowDialogsProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import EscrowDetailDialog from "../../escrows-by-role/details/EscrowDetailDialog";
 import { formatTimestamp } from "../../../helpers/format.helper";
 
@@ -73,6 +73,10 @@ export function EscrowsBySignerTable() {
   const dialogStates = useEscrowDialogs();
   const { setSelectedEscrow } = useEscrowContext();
 
+  const handleRefresh = React.useCallback(() => {
+    void refetch();
+  }, [refetch]);
+
   const columns = React.useMemo<ColumnDef<Escrow>[]>(
     () => [
       {
@@ -184,7 +188,7 @@ export function EscrowsBySignerTable() {
         ),
       },
     ],
-    []
+    [dialogStates.second.setIsOpen, setSelectedEscrow]
   );
 
   const table = useReactTable({
@@ -199,7 +203,18 @@ export function EscrowsBySignerTable() {
     enableSortingRemoval: true,
   });
 
-  const activeRole: Role[] = ["approver"];
+  /**
+   * Based on the provided roles -> https://docs.trustlesswork.com/trustless-work/technology-overview/roles-in-trustless-work
+   *
+   * You must pass one or more roles according to requirements
+   *
+   * For example:
+   * - If the user is a freelancer, you must pass the "serviceProvider" and "receiver" role
+   *
+   * Depending of the role, you'll have different actions buttons
+   */
+  const activeRole: Role[] = React.useMemo(() => ["approver"] as Role[], []);
+
   const escrows = data ?? [];
 
   return (
@@ -220,18 +235,18 @@ export function EscrowsBySignerTable() {
           setEngagementId={setEngagementId}
           setIsActive={setIsActive}
           setValidateOnChain={setValidateOnChain}
-          setType={(v) => setType(v as typeof type)}
-          setStatus={(v) => setStatus(v as typeof status)}
+          setType={setType}
+          setStatus={setStatus}
           setMinAmount={setMinAmount}
           setMaxAmount={setMaxAmount}
           setDateRange={setDateRange}
           onClearFilters={onClearFilters}
-          onRefresh={() => refetch()}
+          onRefresh={handleRefresh}
           isRefreshing={isFetching}
           orderBy={orderBy}
           orderDirection={orderDirection}
-          setOrderBy={(v) => setOrderBy(v)}
-          setOrderDirection={(v) => setOrderDirection(v)}
+          setOrderBy={setOrderBy}
+          setOrderDirection={setOrderDirection}
         />
 
         <Card className="w-full py-2 sm:py-4">
@@ -330,7 +345,7 @@ export function EscrowsBySignerTable() {
                         <Button
                           variant="outline"
                           size="sm"
-                          onClick={() => refetch()}
+                          onClick={handleRefresh}
                         >
                           <RefreshCw className="h-4 w-4 mr-2" />
                           Retry
@@ -409,14 +424,16 @@ export function EscrowsBySignerTable() {
       </div>
 
       {/* Dialog */}
-      <EscrowDetailDialog
-        activeRole={activeRole}
-        isDialogOpen={dialogStates.second.isOpen}
-        setIsDialogOpen={dialogStates.second.setIsOpen}
-        setSelectedEscrow={setSelectedEscrow}
-      />
+      {dialogStates.second.isOpen ? (
+        <EscrowDetailDialog
+          activeRole={activeRole}
+          isDialogOpen={dialogStates.second.isOpen}
+          setIsDialogOpen={dialogStates.second.setIsOpen}
+          setSelectedEscrow={setSelectedEscrow}
+        />
+      ) : null}
     </>
   );
 }
 
-export default EscrowsBySignerTable;
+export default React.memo(EscrowsBySignerTable);

package/templates/escrows/escrows-by-signer/useEscrowsBySigner.shared.ts

@@ -101,8 +101,8 @@ export function useEscrowsBySigner() {
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
 
-  const debouncedSearchParams = useDebouncedValue(
-    {
+  const stableSearchParams = React.useMemo(
+    () => ({
       page,
       orderBy,
       orderDirection,
@@ -118,10 +118,28 @@ export function useEscrowsBySigner() {
         ? startOfDay(dateRange.from).toISOString()
         : undefined,
       endDate: dateRange.to ? endOfDay(dateRange.to).toISOString() : undefined,
-    },
-    200
+    }),
+    [
+      page,
+      orderBy,
+      orderDirection,
+      debouncedTitle,
+      debouncedEngagementId,
+      isActive,
+      validateOnChain,
+      type,
+      status,
+      debouncedMinAmount,
+      debouncedMaxAmount,
+      dateRange.from,
+      dateRange.to,
+    ]
   );
 
+  const debouncedSearchParams = useDebouncedValue(stableSearchParams, 200);
+
+  const lastQueryStringRef = React.useRef("");
+
   React.useEffect(() => {
     if (!pathname) return;
     const qp = new URLSearchParams();
@@ -137,8 +155,10 @@ export function useEscrowsBySigner() {
       qp.set("engagementId", debouncedSearchParams.engagementId);
     qp.set("isActive", String(debouncedSearchParams.isActive));
     qp.set("validateOnChain", String(debouncedSearchParams.validateOnChain));
-    if (type && type !== "all") qp.set("type", type);
-    if (status && status !== "all") qp.set("status", status);
+    if (debouncedSearchParams.type && debouncedSearchParams.type !== "all")
+      qp.set("type", debouncedSearchParams.type);
+    if (debouncedSearchParams.status && debouncedSearchParams.status !== "all")
+      qp.set("status", debouncedSearchParams.status);
     if (debouncedSearchParams.minAmount)
       qp.set("minAmount", String(debouncedSearchParams.minAmount));
     if (debouncedSearchParams.maxAmount)
@@ -147,25 +167,12 @@ export function useEscrowsBySigner() {
       qp.set("startDate", String(debouncedSearchParams.startDate));
     if (debouncedSearchParams.endDate)
       qp.set("endDate", String(debouncedSearchParams.endDate));
-
-    router.replace(`${pathname}?${qp.toString()}`);
-  }, [
-    pathname,
-    router,
-    debouncedSearchParams.page,
-    debouncedSearchParams.orderBy,
-    debouncedSearchParams.orderDirection,
-    debouncedSearchParams.title,
-    debouncedSearchParams.engagementId,
-    debouncedSearchParams.isActive,
-    debouncedSearchParams.validateOnChain,
-    type,
-    status,
-    debouncedSearchParams.minAmount,
-    debouncedSearchParams.maxAmount,
-    debouncedSearchParams.startDate,
-    debouncedSearchParams.endDate,
-  ]);
+    const newQs = qp.toString();
+    if (lastQueryStringRef.current !== newQs) {
+      lastQueryStringRef.current = newQs;
+      router.replace(`${pathname}?${newQs}`);
+    }
+  }, [pathname, router, debouncedSearchParams]);
 
   const formattedRangeLabel = React.useMemo(() => {
     if (!dateRange?.from && !dateRange?.to) return "Date range";
@@ -221,6 +228,12 @@ export function useEscrowsBySigner() {
     dateRange,
   ]);
 
+  /**
+   * Call the query to get the escrows from the Trustless Work Indexer
+   *
+   * @param params - The parameters for the query
+   * @returns The query result
+   */
   const query = useEscrowsBySignerQuery(params);
   const nextPageQuery = useEscrowsBySignerQuery({ ...params, page: page + 1 });
 

package/templates/escrows/single-release/approve-milestone/button/ApproveMilestone.tsx

@@ -8,7 +8,7 @@ import {
   ErrorResponse,
   handleError,
 } from "@/components/tw-blocks/handle-errors/handle";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { Loader2 } from "lucide-react";
 
 type ApproveMilestoneButtonProps = {
@@ -27,6 +27,12 @@ export default function ApproveMilestoneButton({
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the payload for the approve milestone mutation
+       *
+       * @param milestoneIndex - The index of the milestone to approve
+       * @returns The payload for the approve milestone mutation
+       */
       const payload: ApproveMilestonePayload = {
         contractId: selectedEscrow?.contractId || "",
         milestoneIndex: String(milestoneIndex),
@@ -34,6 +40,13 @@ export default function ApproveMilestoneButton({
         newFlag: true,
       };
 
+      /**
+       * Call the approve milestone mutation
+       *
+       * @param payload - The payload for the approve milestone mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await approveMilestone.mutateAsync({
         payload,
         type: "single-release",

package/templates/escrows/single-release/approve-milestone/dialog/ApproveMilestone.tsx

@@ -17,7 +17,7 @@ import {
 } from "__UI_BASE__/dialog";
 import { Loader2 } from "lucide-react";
 import { useApproveMilestone } from "./useApproveMilestone";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import {
   Select,
   SelectContent,

package/templates/escrows/single-release/approve-milestone/form/ApproveMilestone.tsx

@@ -10,7 +10,7 @@ import {
 import { Button } from "__UI_BASE__/button";
 import { useApproveMilestone } from "./useApproveMilestone";
 import { Loader2 } from "lucide-react";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import {
   Select,
   SelectContent,

package/templates/escrows/single-release/approve-milestone/shared/useApproveMilestone.ts

@@ -4,7 +4,7 @@ import { zodResolver } from "@hookform/resolvers/zod";
 import { approveMilestoneSchema, type ApproveMilestoneValues } from "./schema";
 import { toast } from "sonner";
 import { ApproveMilestonePayload } from "@trustless-work/escrow";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { useEscrowsMutations } from "@/components/tw-blocks/tanstack/useEscrowsMutations";
 import {
   ErrorResponse,
@@ -31,6 +31,12 @@ export function useApproveMilestone() {
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the final payload for the approve milestone mutation
+       *
+       * @param payload - The payload from the form
+       * @returns The final payload for the approve milestone mutation
+       */
       const finalPayload: ApproveMilestonePayload = {
         contractId: selectedEscrow?.contractId || "",
         milestoneIndex: payload.milestoneIndex,
@@ -38,6 +44,13 @@ export function useApproveMilestone() {
         newFlag: true,
       };
 
+      /**
+       * Call the approve milestone mutation
+       *
+       * @param payload - The final payload for the approve milestone mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await approveMilestone.mutateAsync({
         payload: finalPayload,
         type: "single-release",

package/templates/escrows/single-release/change-milestone-status/button/ChangeMilestoneStatus.tsx

@@ -8,7 +8,7 @@ import {
   ErrorResponse,
   handleError,
 } from "@/components/tw-blocks/handle-errors/handle";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { Loader2 } from "lucide-react";
 
 type ChangeMilestoneStatusButtonProps = {
@@ -36,6 +36,14 @@ export default function ChangeMilestoneStatusButton({
 
       setIsSubmitting(true);
 
+      /**
+       * Create the payload for the change milestone status mutation
+       *
+       * @param status - The status to change
+       * @param evidence - The evidence to change
+       * @param milestoneIndex - The index of the milestone to change
+       * @returns The payload for the change milestone status mutation
+       */
       const payload: ChangeMilestoneStatusPayload = {
         contractId: selectedEscrow?.contractId || "",
         milestoneIndex: String(milestoneIndex),
@@ -44,6 +52,13 @@ export default function ChangeMilestoneStatusButton({
         serviceProvider: walletAddress || "",
       };
 
+      /**
+       * Call the change milestone status mutation
+       *
+       * @param payload - The payload for the change milestone status mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await changeMilestoneStatus.mutateAsync({
         payload,
         type: "single-release",

package/templates/escrows/single-release/change-milestone-status/dialog/ChangeMilestoneStatus.tsx

@@ -19,7 +19,7 @@ import {
 } from "__UI_BASE__/dialog";
 import { Loader2 } from "lucide-react";
 import { useChangeMilestoneStatus } from "./useChangeMilestoneStatus";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import {
   Select,
   SelectContent,

package/templates/escrows/single-release/change-milestone-status/form/ChangeMilestoneStatus.tsx

@@ -12,7 +12,7 @@ import { Textarea } from "__UI_BASE__/textarea";
 import { Button } from "__UI_BASE__/button";
 import { useChangeMilestoneStatus } from "./useChangeMilestoneStatus";
 import { Loader2 } from "lucide-react";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import {
   Select,
   SelectContent,

package/templates/escrows/single-release/change-milestone-status/shared/useChangeMilestoneStatus.ts

@@ -7,7 +7,7 @@ import {
 } from "./schema";
 import { toast } from "sonner";
 import { ChangeMilestoneStatusPayload } from "@trustless-work/escrow";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { useEscrowsMutations } from "@/components/tw-blocks/tanstack/useEscrowsMutations";
 import {
   ErrorResponse,
@@ -36,6 +36,12 @@ export function useChangeMilestoneStatus() {
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the final payload for the change milestone status mutation
+       *
+       * @param payload - The payload from the form
+       * @returns The final payload for the change milestone status mutation
+       */
       const finalPayload: ChangeMilestoneStatusPayload = {
         contractId: selectedEscrow?.contractId || "",
         milestoneIndex: payload.milestoneIndex,
@@ -44,6 +50,13 @@ export function useChangeMilestoneStatus() {
         serviceProvider: walletAddress || "",
       };
 
+      /**
+       * Call the change milestone status mutation
+       *
+       * @param payload - The final payload for the change milestone status mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await changeMilestoneStatus.mutateAsync({
         payload: finalPayload,
         type: "single-release",

package/templates/escrows/single-release/dispute-escrow/button/DisputeEscrow.tsx

@@ -8,7 +8,7 @@ import {
   ErrorResponse,
   handleError,
 } from "@/components/tw-blocks/handle-errors/handle";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { Loader2 } from "lucide-react";
 
 export default function DisputeEscrowButton() {
@@ -21,11 +21,23 @@ export default function DisputeEscrowButton() {
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the payload for the dispute escrow mutation
+       *
+       * @returns The payload for the dispute escrow mutation
+       */
       const payload: SingleReleaseStartDisputePayload = {
         contractId: selectedEscrow?.contractId || "",
         signer: walletAddress || "",
       };
 
+      /**
+       * Call the dispute escrow mutation
+       *
+       * @param payload - The payload for the dispute escrow mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await startDispute.mutateAsync({
         payload,
         type: "single-release",

package/templates/escrows/single-release/fund-escrow/button/FundEscrow.tsx

@@ -8,7 +8,7 @@ import {
   ErrorResponse,
   handleError,
 } from "@/components/tw-blocks/handle-errors/handle";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { Loader2 } from "lucide-react";
 
 type FundEscrowButtonProps = {
@@ -35,12 +35,24 @@ export default function FundEscrowButton({ amount }: FundEscrowButtonProps) {
 
       setIsSubmitting(true);
 
+      /**
+       * Create the payload for the fund escrow mutation
+       *
+       * @returns The payload for the fund escrow mutation
+       */
       const payload: FundEscrowPayload = {
         amount: Number(amount),
         contractId: selectedEscrow?.contractId || "",
         signer: walletAddress || "",
       };
 
+      /**
+       * Call the fund escrow mutation
+       *
+       * @param payload - The payload for the fund escrow mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await fundEscrow.mutateAsync({
         payload,
         type: "single-release",

package/templates/escrows/single-release/fund-escrow/shared/useFundEscrow.ts

@@ -4,7 +4,7 @@ import { zodResolver } from "@hookform/resolvers/zod";
 import { fundEscrowSchema, type FundEscrowValues } from "./schema";
 import { toast } from "sonner";
 import { FundEscrowPayload } from "@trustless-work/escrow";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { useEscrowsMutations } from "@/components/tw-blocks/tanstack/useEscrowsMutations";
 import {
   ErrorResponse,
@@ -31,6 +31,12 @@ export function useFundEscrow() {
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the final payload for the fund escrow mutation
+       *
+       * @param payload - The payload from the form
+       * @returns The final payload for the fund escrow mutation
+       */
       const finalPayload: FundEscrowPayload = {
         amount:
           typeof payload.amount === "string"
@@ -40,6 +46,13 @@ export function useFundEscrow() {
         signer: walletAddress || "",
       };
 
+      /**
+       * Call the fund escrow mutation
+       *
+       * @param payload - The final payload for the fund escrow mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await fundEscrow.mutateAsync({
         payload: finalPayload,
         type: "single-release",

package/templates/escrows/single-release/initialize-escrow/shared/useInitializeEscrow.ts

@@ -14,12 +14,14 @@ import {
   ErrorResponse,
   handleError,
 } from "@/components/tw-blocks/handle-errors/handle";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 
 export function useInitializeEscrow() {
   const [isSubmitting, setIsSubmitting] = React.useState(false);
 
   const { getSingleReleaseFormSchema } = useInitializeEscrowSchema();
   const formSchema = getSingleReleaseFormSchema();
+  const { setSelectedEscrow } = useEscrowContext();
 
   const { walletAddress } = useWalletContext();
   const { deployEscrow } = useEscrowsMutations();
@@ -71,6 +73,12 @@ export function useInitializeEscrow() {
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the final payload for the initialize escrow mutation
+       *
+       * @param payload - The payload from the form
+       * @returns The final payload for the initialize escrow mutation
+       */
       const finalPayload: InitializeSingleReleaseEscrowPayload = {
         ...payload,
         amount:
@@ -86,6 +94,13 @@ export function useInitializeEscrow() {
         milestones: payload.milestones,
       };
 
+      /**
+       * Call the initialize escrow mutation
+       *
+       * @param payload - The final payload for the initialize escrow mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       const response: InitializeSingleReleaseEscrowResponse =
         (await deployEscrow.mutateAsync({
           payload: finalPayload,
@@ -93,8 +108,9 @@ export function useInitializeEscrow() {
           address: walletAddress || "",
         })) as InitializeSingleReleaseEscrowResponse;
 
-      console.log("response", response);
       toast.success("Escrow initialized successfully");
+
+      setSelectedEscrow(response);
     } catch (error) {
       toast.error(handleError(error as ErrorResponse).message);
     } finally {

package/templates/escrows/single-release/release-escrow/button/ReleaseEscrow.tsx

@@ -8,9 +8,9 @@ import {
   ErrorResponse,
   handleError,
 } from "@/components/tw-blocks/handle-errors/handle";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
-import { useEscrowDialogs } from "../../../escrow-context/EscrowDialogsProvider";
-import { useEscrowAmountContext } from "../../../escrow-context/EscrowAmountProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
+import { useEscrowDialogs } from "@/components/tw-blocks/providers/EscrowDialogsProvider";
+import { useEscrowAmountContext } from "@/components/tw-blocks/providers/EscrowAmountProvider";
 import { Loader2 } from "lucide-react";
 
 export default function ReleaseEscrowButton() {
@@ -25,11 +25,23 @@ export default function ReleaseEscrowButton() {
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the payload for the release escrow mutation
+       *
+       * @returns The payload for the release escrow mutation
+       */
       const payload: SingleReleaseReleaseFundsPayload = {
         contractId: selectedEscrow?.contractId || "",
         releaseSigner: walletAddress || "",
       };
 
+      /**
+       * Call the release escrow mutation
+       *
+       * @param payload - The payload for the release escrow mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await releaseFunds.mutateAsync({
         payload,
         type: "single-release",

package/templates/escrows/single-release/resolve-dispute/button/ResolveDispute.tsx

@@ -8,7 +8,7 @@ import {
   ErrorResponse,
   handleError,
 } from "@/components/tw-blocks/handle-errors/handle";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { Loader2 } from "lucide-react";
 
 type ResolveDisputeButtonProps = {
@@ -44,6 +44,11 @@ export default function ResolveDisputeButton({
 
       setIsSubmitting(true);
 
+      /**
+       * Create the payload for the resolve dispute mutation
+       *
+       * @returns The payload for the resolve dispute mutation
+       */
       const payload: SingleReleaseResolveDisputePayload = {
         contractId: selectedEscrow?.contractId || "",
         disputeResolver: walletAddress || "",
@@ -51,6 +56,13 @@ export default function ResolveDisputeButton({
         receiverFunds: Number(receiverFunds),
       };
 
+      /**
+       * Call the resolve dispute mutation
+       *
+       * @param payload - The payload for the resolve dispute mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await resolveDispute.mutateAsync({
         payload,
         type: "single-release",

package/templates/escrows/single-release/resolve-dispute/dialog/ResolveDispute.tsx

@@ -18,7 +18,7 @@ import {
 } from "__UI_BASE__/dialog";
 import { Loader2 } from "lucide-react";
 import { useResolveDispute } from "./useResolveDispute";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 
 export default function ResolveDisputeDialog() {
   const { form, handleSubmit, isSubmitting } = useResolveDispute();

package/templates/escrows/single-release/resolve-dispute/shared/useResolveDispute.ts

@@ -4,7 +4,7 @@ import { zodResolver } from "@hookform/resolvers/zod";
 import { resolveDisputeSchema, type ResolveDisputeValues } from "./schema";
 import { toast } from "sonner";
 import { SingleReleaseResolveDisputePayload } from "@trustless-work/escrow";
-import { useEscrowContext } from "../../../escrow-context/EscrowProvider";
+import { useEscrowContext } from "@/components/tw-blocks/providers/EscrowProvider";
 import { useEscrowsMutations } from "@/components/tw-blocks/tanstack/useEscrowsMutations";
 import {
   ErrorResponse,
@@ -32,6 +32,12 @@ export function useResolveDispute() {
     try {
       setIsSubmitting(true);
 
+      /**
+       * Create the final payload for the resolve dispute mutation
+       *
+       * @param payload - The payload from the form
+       * @returns The final payload for the resolve dispute mutation
+       */
       const finalPayload: SingleReleaseResolveDisputePayload = {
         contractId: selectedEscrow?.contractId || "",
         disputeResolver: walletAddress || "",
@@ -39,6 +45,13 @@ export function useResolveDispute() {
         receiverFunds: Number(payload.receiverFunds),
       };
 
+      /**
+       * Call the resolve dispute mutation
+       *
+       * @param payload - The final payload for the resolve dispute mutation
+       * @param type - The type of the escrow
+       * @param address - The address of the escrow
+       */
       await resolveDispute.mutateAsync({
         payload: finalPayload,
         type: "single-release",