useSendTransaction

La mayoría de los endpoints de Trustless Work devuelven una transacción sin firmar en formato XDR. Este endpoint se usa para firmar dichas transacciones sin firmar y enviarlas a la red Stellar.

Este endpoint debe usarse para todos los endpoints después de que lo ejecutemos. Excepto getEscrowBalances, getEscrowsByContractId, getEscrowsByRole y getEscrowsBySigner.

Uso

Este hook personalizado expone una función para enviar una transacción firmada a la red.

import { useSendTransaction} from "@trustless-work/escrow/hooks";

/*
 *  useSendTransaction
*/
const { sendTransaction } = useSendTransaction();

/* 
 * Devuelve un SendTransactionResponse
 * el payload debe ser de tipo string
*/
const data = await sendTransaction(signedXdr);

Función

• sendTransaction Responsable de construir y devolver datos basados en el payload proporcionado.

Argumento:

payload: Una cadena que contiene los campos requeridos para enviar una transacción a la red.

Tipos

Valor de retorno:

Para: Fundar Escrow, Resolver Disputa, Cambiar Estado del Hito, Cambiar Indicador de Aprobación del Hito, Iniciar Disputa, Liberar Fondos:

• Este objeto será de un tipo sendTransactionResponse.

Para: Inicializar Escrow:

• Este objeto será de un tipo sendTransactionResponse. Pero puedes configurarlo como InitializeEscrowResponse.

Para: Actualizar Escrow:

• Este objeto será de un tipo sendTransactionResponse. Pero puedes configurarlo como UpdateEscrowResponse.

---

Ejemplo de uso

src/hooks/useSendTransactionForm.ts

import {
  useFundEscrow,
  useSendTransaction,
} from "@trustless-work/escrow/hooks";
import {
  useSomeEndpointPayload
} from "@trustless-work/escrow/types";

export const useSomeEndpointForm= () => {

 /*
  *  useSomeEndpoint
 */
 const { someFunction } = useSomeEndpoint();
 
 /*
  *  useSendTransaction
 */
 const { sendTransaction } = useSendTransaction();

/*
 * función onSubmit, esto podría ser llamada por un botón de formulario
*/
 const onSubmit = async (payload: useSomeEndpointPayload) => {

    try {
      // obtener unsignedTransaction desde algún endpoint ...

      /**
       * @Note:
       * - Necesitamos firmar la transacción usando tu [clave privada] como la wallet
       * - El resultado será una transacción firmada
       */
      const signedXdr = await signTransaction({ /* Este método debe ser proporcionado por la wallet */
        unsignedTransaction,
        address: walletAddress || "",
      });

      if (!signedXdr) {
        throw new Error("La transacción firmada falta.");
      }

      /**
       * @Note:
       * - Necesitamos enviar la transacción firmada a la API
       * - Los datos serán un SendTransactionResponse
       */
      const data = await sendTransaction(signedXdr);

    } catch (error: unknown) {
      // lógica para capturar errores
    }
  };
}