Liberación arbitral con Celo ContractKit

Curso de Introducción a Celo con Solidity

Contenido del curso

Introducción

Entendiendo la EVM

Herramientas de Solidity

Retiros y control de permisos

Interactuando con la Blockchain de Celo

Interactuando con Smart Contracts

Sigue practicando

21
Qué hacer al terminar el curso de Celo
00:37 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:004:30

Liberación arbitral con Celo ContractKit

Curso de Introducción a Celo con Solidity

Clase 19 de 21

Clase 19 / 21

Recursos

Integrar Celo ContractKit en un proyecto permite ejecutar transacciones contra un contrato inteligente desde una interfaz web, firmando con la wallet correcta según el rol del usuario. Aquí verás cómo funciona la liberación arbitral de un pago paso a paso, con el código real y la interacción con Celo Wallet.

¿Qué hace el método liberacionArbitralContractKitHandler?

Es la función que conecta el frontend con el contrato inteligente para que el árbitro libere el pago retenido. Está enlazada a un botón en la interfaz que, al hacer clic, dispara toda la secuencia de conexión, instanciación y firma de la transacción.

El flujo dentro de la función ocurre en cuatro momentos clave:

Se crea una conexión con el Celo Provider, que es básicamente Celo Wallet actuando como puente entre la app y la blockchain.
Se configura una nueva instancia de ContractKit y se le indica que la cuenta a usar es la asociada a la wallet conectada.
Se obtiene una referencia al contrato pasando su address, lo que permite invocar sus métodos.
Se ejecuta la transacción llamando al método del contrato y especificando desde qué wallet se firma.

¿Qué es Celo ContractKit? Es una librería de Celo que facilita la interacción entre aplicaciones web y contratos inteligentes desplegados en la red Celo, manejando conexión, instancias y envío de transacciones.

¿Cómo se ejecuta la transacción contra el contrato inteligente?

Una vez que tienes la instancia del contrato, accedes al atributo methods y llamas al método que definiste en el contrato inteligente. En el ejemplo, el método invocado es pagarPorArbitro, pero podría ser hacerPago, liberarPago o cualquier otro definido en Solidity.

A ese método le pasas las variables necesarias y, al final, encadenas un .send() con un objeto que indica desde qué dirección se firma. Lo habitual en una interfaz web es usar la default account de la wallet, porque es la única que puede firmar la transacción cuando se abra el cuadro de confirmación.

javascript contractInstance.methods .pagarPorArbitro(args) .send({ from: defaultAccount });

¿Por qué se usa la default account al firmar? Porque solo la billetera activa en la wallet puede autorizar la transacción. Si intentas firmar desde otra cuenta, la red rechaza la operación.

¿Por qué falla la transacción si firmas con la wallet equivocada?

Aquí está el detalle que confunde a muchos al integrar contratos con roles. En la prueba, la Celo Wallet tenía seleccionada la billetera del vendedor en vez de la del árbitro. Al pulsar el botón de liberación, la transacción devuelve un error porque la dirección que firma no está autorizada por el contrato para ejecutar ese método.

El contrato inteligente valida internamente que solo el árbitro pueda liberar el pago. Si firma cualquier otra wallet, la transacción es inválida y aparece un mensaje de gas insuficiente o de rechazo directo.

La solución es simple pero clave:

Rechazar la transacción fallida desde Celo Wallet.
Cambiar la cuenta activa por la del árbitro.
Confirmar con el botón connected que esa es la wallet activa.
Volver a pulsar el botón de liberación del pago.

Con la billetera correcta, la transacción se valida, desaparece el error y el árbitro puede firmar para que el contrato ejecute la liberación tal como fue diseñado.

Conceptos y habilidades que aparecen en la clase

Algunos elementos vale la pena tenerlos claros para replicar este flujo en tu propio proyecto:

Celo Provider [00:42]: capa que conecta la dapp con Celo Wallet para enviar peticiones a la red.
Instancia de ContractKit [00:50]: objeto principal que centraliza la conexión con la blockchain de Celo.
Referencia al contrato por address [01:05]: necesitas el address del contrato desplegado para invocar sus métodos.
methods + nombre del método [01:20]: patrón estándar para llamar funciones del contrato desde JavaScript.
Parámetro send con from [01:38]: define qué wallet firma la transacción y paga el gas.
Validación de roles en Solidity [02:15]: el contrato verifica que solo direcciones autorizadas ejecuten ciertos métodos, como el árbitro liberando el pago.
Cambio de cuenta activa en Celo Wallet [02:40]: paso operativo imprescindible cuando un mismo usuario maneja varios roles.

Dominar este patrón te prepara para el siguiente paso del proyecto: hacer la misma liberación arbitral usando WalletConnect desde una billetera móvil. ¿Ya tienes lista tu wallet de árbitro para probarlo? Cuéntame en los comentarios cómo te fue con tu primera transacción firmada.

Resumen

¿Qué hace el método liberacionArbitralContractKitHandler?

El flujo dentro de la función ocurre en cuatro momentos clave:

Se crea una conexión con el Celo Provider, que es básicamente Celo Wallet actuando como puente entre la app y la blockchain.
Se configura una nueva instancia de ContractKit y se le indica que la cuenta a usar es la asociada a la wallet conectada.
Se obtiene una referencia al contrato pasando su address, lo que permite invocar sus métodos.
Se ejecuta la transacción llamando al método del contrato y especificando desde qué wallet se firma.

¿Qué es Celo ContractKit? Es una librería de Celo que facilita la interacción entre aplicaciones web y contratos inteligentes desplegados en la red Celo, manejando conexión, instancias y envío de transacciones.

¿Cómo se ejecuta la transacción contra el contrato inteligente?

javascript contractInstance.methods .pagarPorArbitro(args) .send({ from: defaultAccount });

¿Por qué se usa la default account al firmar? Porque solo la billetera activa en la wallet puede autorizar la transacción. Si intentas firmar desde otra cuenta, la red rechaza la operación.

¿Por qué falla la transacción si firmas con la wallet equivocada?

La solución es simple pero clave:

Rechazar la transacción fallida desde Celo Wallet.
Cambiar la cuenta activa por la del árbitro.
Confirmar con el botón connected que esa es la wallet activa.
Volver a pulsar el botón de liberación del pago.

Con la billetera correcta, la transacción se valida, desaparece el error y el árbitro puede firmar para que el contrato ejecute la liberación tal como fue diseñado.

Conceptos y habilidades que aparecen en la clase

Algunos elementos vale la pena tenerlos claros para replicar este flujo en tu propio proyecto:

Celo Provider [00:42]: capa que conecta la dapp con Celo Wallet para enviar peticiones a la red.
Instancia de ContractKit [00:50]: objeto principal que centraliza la conexión con la blockchain de Celo.
Referencia al contrato por address [01:05]: necesitas el address del contrato desplegado para invocar sus métodos.
methods + nombre del método [01:20]: patrón estándar para llamar funciones del contrato desde JavaScript.
Parámetro send con from [01:38]: define qué wallet firma la transacción y paga el gas.
Validación de roles en Solidity [02:15]: el contrato verifica que solo direcciones autorizadas ejecuten ciertos métodos, como el árbitro liberando el pago.
Cambio de cuenta activa en Celo Wallet [02:40]: paso operativo imprescindible cuando un mismo usuario maneja varios roles.

Introducción

Primer contrato en Solidity sobre Celo

Qué hace diferente a Celo de otras blockchains

Entendiendo la EVM

Herramientas esenciales para desarrollar en Celo

Qué es la EVM y cómo funciona Solidity

Qué son las transacciones en Celo

Herramientas de Solidity

Estructura de un smart contract en Solidity

Loops y condicionales en Solidity

address en Solidity y msg.sender

El atributo payable en Solidity

Retiros y control de permisos

Modificadores en Solidity para código limpio

Herencia en Solidity con OpenZeppelin

Scaffolding de un contrato de escrow en Celo

Modificadores y ownable en contratos escrow

Interactuando con la Blockchain de Celo

Deploy de smart contracts en Alfajores con Remix

Desplegar contratos con Hardhat en Alfajores

Interactuando con Smart Contracts

Conectando React con Celo usando ContractKit

Conectar Valora a contratos inteligentes con Wallet Connect

Despliegue de Contratos Inteligentes en Testnet Alfajores con Remix

Liberación arbitral con Celo ContractKit

Firma de transacciones con WalletConnect y Valora

Sigue practicando

Qué hacer al terminar el curso de Celo

Liberación arbitral con Celo ContractKit

Progreso del curso

Introducción

Entendiendo la EVM

Herramientas de Solidity

Retiros y control de permisos

Interactuando con la Blockchain de Celo

Interactuando con Smart Contracts

Sigue practicando

Recursos

Recursos