This project is a decentralized application (dApp) that allows any person to start using digital assets as payment method for everyday use.
Developed during ETHOnline 2023 by members LaDAO.
To use it, there are still some manual steps that we need you to complete:
- Fund your Privy wallet with some MATIC, to deploy Safe (gasless deployment is in development)
- Deploy the XocSafe
- Fund XocSafe with XOC (you can mint some here or send a mail to gm@ladao.club
After that, you can start sending XOC without paying gas!
Este proyecto es una aplicación descentralizada que permite a cualquier persona empezar a utilizar activos digitales como método de pago para el día a día.
Desarrollado durante ETHOnline 2023 por miembros de La DAO.
Conecta, Contribuye, Construye
Bienvenido a La DAO, una comunidad de apasionados de las finanzas descentralizadas y la tecnología.
- NodeJS v18.18.0 (LTS) o superior
- Git
- Sugerimos crear una cuenta en Supabase o PlanetScale, y obtener un string de conexión para tu propia Base de Datos. Cómo obtener en Supabase.
- En caso de requerir acceso a las base de datos de La DAO, contáctanos a través de Discord o Telegram.
Utilizamos los principios de Gitflow para el control de versiones durante el flujo de trabajo como desarrolladores.
En nuestras contribuciones, debemos considerar el modelo de creación de ramas propuesto en Gitflow, donde siempre mantendremos nuestra rama principal, main
, así como una rama para aportar nuestras contribuciones: dev
.
Para conocer más sobre este flujo de trabajo, puedes visitar este excelente Tutorial de Gitflow creado por Atlassian.
Clona este repositorio
git clone https://github.com/La-DAO/la-cartera-next-pwa
Cambia al directorio del proyecto
cd la-cartera-next-pwa
Instala las dependencias
bun install
Utilizamos bun para este proyecto, puedes obtener más información en la documentación oficial de Bun
Ejecuta el siguiente comando en la consola
git switch dev
La rama dev es donde mantenemos una copia de las últimas contribuciones. Por ello, es nuestro punto de inicio para contribuir.
Si deseas crear un nuevo feature o realizarás alguna otra contribución, siguiendo el modelo de trabajo Gitflow, deberás crear tu propia rama a partir de dev
git checkout -b feat/<inserta-tu-feature>
Seamos descriptivos pero concisos con los nombres de las ramas, algunos ejemplos:
- feat/contacto-pagina
- feat/setup-auth
- feat/api-profile-routes
Para contribuciones, crea commits constantemente para que los demás podamos mantener el contexto de tus contribuciones. Recomendamos seguir estas mejores prácticas en tus commits.
Una vez que tu aportación esté lista, puedes abrir un Pull Request hacia la rama dev
y solicita revisión de otro contribuidor.
Para que la aplicación funcione en su totalidad, debes crear una copia del archivo .env.example
y nombrarlo .env
En este nuevo archivo .env
, es necesario modificar las siguientes variables de estado:
DATABASE_URL
Al copiar .env.example
, existe un string sin autenticación (es decir, no tiene la contraseña correcta). Esto es por diseño, para evitar abusos de la base de datos de prueba. Sigue el tutorial indicado en Requerimientos.
Corre el siguiente script para iniciar el servidor de NextJS
bun run dev
La aplicación iniciará en http://localhost:3000
Corre el siguiente script aplicar las migraciones a la base de datos, y así estar sincronizado con el schema (arquitectura de la base de datos: tablas, modelos, relaciones, etc.):
npx prisma migrate dev
Ahora debes poder iniciar Prisma Studio, el explorador default de Prisma para la base de datos.
npx prisma studio
Iniciará la aplicación de Prisma Studio en http://localhost:5050
. Aquí podrás interactuar la base de datos mientras desarrollas.
Cuando realices un cambio en la base de datos, deberás seguir el flujo de Prisma:
- Modificar el schema en el archivo
/prisma/schema.prisma
- Crear una migración
- Continuar trabajando en el código
- Repetir en caso de requerir otra modificación
Puedes utilizar esta guía para conocer más del flujo de desarrolo de Prisma
Este es un proyecto en construcción, y tenemos grandes planes para La DAO. Acércate a nuestros canales de comunicación para más información.
Actualizaremos este README conforme avancemos en el desarrollo.