Descripción

Este repositorio contiene el código, recursos y documentación para mi tesis para de ciencias de la computación.

La implementación se realizará en una subnet de la red de Avalanche, una plataforma de computación descentralizada que permite la ejecución de smart contracts.

La subnet nos permite utilizar el token nativo MXN (Peso Mexicano Digital) para realizar transacciones.

Tecnologias utilizadas

Blockchain

• Red de blockchain:
  • Avalanche
  • Avalanche subnets
• Lenguaje de programación para smart contracts:
  • Solidity
• Framework para smart contracts:
  • Foundry
• Libreria para smart contracts:
  • OpenZeppelin

Dapp

• Framework para desarrollo de la dapp:
  • React
• Librerias para desarrollo de la dapp:
  • RaimbowKit
  • WAGMI
  • Viem
• Libreria para manejo de wallets:
  • RaimbowKit

Estructura del repositorio

.
├── 📁 assets_README 
|    └── 📁 img 
├── 🗂️ dapp
├── 📁 DocumentacionParaSC
├── 📁 Graficos de apoyo
├── 📁 Smart-Contracts
|    ├── 📁 src
|    |   ├── 📄 AvisoDeCruce.sol
|    |   ├── 📄 CasaAduanal.sol
|    |   └── 📄 SecretariaAduanas.sol
├── 📁 configuracion_subnet
|    └── 📄 subnetMX.json
├── 🗄️ DocumentoTesis_LaTeX.xip
├── 📄 LICENSE
└── 📄 README.md

Instalación

Requisitos previos:

Asegúrate de tener Avalanche CLI, Foundry, Node.js y npm instalados en tu sistema. Puedes instalados desde los siguientes enlaces:

Avalanche docs: Install Avalanche-CLI

Foundry book: installation

Node.js

Manera 1: Local con subnet de Avalanche local (recomendado)

En construcción...

Manera 2: Local sin subnet de Avalanche

Clonar el repositorio:

Abre una terminal y ejecuta el siguiente comando para clonar este repositorio en tu máquina local:

git clone https://github.com/jistro/tesis

Navegar al directorio del proyecto:

Usando tres consolas, ingresa al directorio del proyecto utilizando el siguiente comando:

cd tesis

Preparacion para smart contracts

La primera consola estara a cargo de la blockchain local usando foundry mediante el siguiente comando:

anvil

Copiamos la frase semilla que nos da al momento de usar anvil y la agregamos en una extencion de wallet como metamask

IMPORTANTE: la frase semilla es solo para motivos de prueba y desarrollo y NUNCA se debe usar en produccion

en la segunda consola, nos movemos a la seccion de smart contracts de la siguiente manera:

cd Smart-contracts

alli para levantar los contratos de manera local sin usar una subnet entramos el siguente comando:

make deployTest

Preparacion de aplicacion (Dapp)

El la ultima consola nos movemos a la carpeta de la web app mediante:

cd dapp

Ejecuta el siguiente comando para instalar las dependencias del frontend:

npm install

Ejecutamos de manera local la web app con el siguente comando:

make local

¡Listo! Ahora tienes el sistema instalado y en funcionamiento en tu entorno local utilizando npm y Foundry.