osmosis frontend

Osmosis frontend? ‍ ⚗️?

Nota: Esta base de código está actualmente en un refactor de la arquitectura de KePlr a una pila TRPC para mejorar el rendimiento, la mantenibilidad y la velocidad de desarrollo. Apreciamos su paciencia mientras trabajamos en estos cambios.

Descripción general

Nuestro frontend está construido con las siguientes herramientas:

• TypeScript: Tipo de comprobación
• React: UI
• Tailwind CSS: estilo, temas
• Next.js: andamio/SSR/CDN/SEO
  • Nos desplegamos en Vercel para optimizaciones fuera de la caja, detrás de Cloudflare
• Turbo Repo: Mono Repo Management con la ejecución del script del paquete, con un fuerte énfasis en el almacenamiento en caché de la construcción (incluido el almacenamiento en caché remoto compartido en Vercel)
• Lerna: liberación de libs

Despliegue

Instalar DEPS:

yarn

Iniciar servidor web

yarn start

Contribuyendo? ‍

¡Agradecemos y fomentamos las contribuciones! Recomendamos buscar problemas etiquetados con "buen primero".

Asegúrese de que el nodo = 20 y el hilo esté instalado.

1. Instalar DEPS

yarn

Configuración por primera vez Si se encuentra en el equipo de la Fundación Osmosis y tiene una cuenta Vercel configurada, opcionalmente inicie sesión en Turbo Repo usando su cuenta Vercely y vincule el repositorio. Esto podría darle compilaciones instantáneas compartiendo el caché remoto en nuestro proyecto Vercel:

npx turbo login
...login via browser...
npx turbo link
...press y (yes) and choose " OsmoLabs " as the Vercel build scope...

2. Ejecute una compilación inicial para crear artefactos de compilación de paquetes:

yarn build

3. Ejecute el servidor local en localhost:3000

yarn dev

Prueba de prueba

Para desarrollarse en la red pública canónica, ejecute:

yarn build:testnet && yarn start:testnet

Para desarrollarse en una red de prueba local, como localosmosis, establezca esto en su archivo .env.local en la raíz del paquete web:

 # Osmosis Chain Configuration Overwrite
NEXT_PUBLIC_IS_TESTNET=true
NEXT_PUBLIC_OSMOSIS_RPC_OVERWRITE=http://localhost:26657/
NEXT_PUBLIC_OSMOSIS_REST_OVERWRITE=http://localhost:1317/
NEXT_PUBLIC_OSMOSIS_CHAIN_ID_OVERWRITE=localosmosis
# NEXT_PUBLIC_OSMOSIS_EXPLORER_URL_OVERWRITE=https://testnet.mintscan.io/osmosis-testnet/txs/{txHash}
# NEXT_PUBLIC_OSMOSIS_CHAIN_NAME_OVERWRITE=Osmosis (Testnet v13.X latest)

Es posible que deba ir a la carpeta de configuración para actualizar la lista de activos de IBC y las monedas en la información de la cadena de ósmosis para ver las monedas en su TestNet.

Prueba de prueba

La versión de TestNet del frontend usa NEXT_PUBLIC_IS_TESTNET=true . De manera predeterminada, apunta a la red de prueba canónica, pero los paquetes/web/.env se pueden cambiar para apuntar a localosmosis.

Dev:

yarn build:testnet && yarn dev:testnet

Desplegar:

yarn build:testnet && yarn start:testnet

Nota: Nuestro registrador de divisas verifica los hash de IBC para ver si se pueden encontrar a través de la consulta Denom_Trace en el módulo IBC en la cadena. Si no se encuentra, no lo agregará a la lista de monedas de la cadena. Asegúrese de que los activos de IBC en Testnet se puedan encontrar en el estado del módulo IBC de Testnet para que los activos de Test IBC sean visibles. De lo contrario, los activos de prueba (es decir, a través de TokenFactory) se pueden agregar como activos nativos a la cadena de ósmosis, simplemente definiendo su denom.

Lanzamientos

Nota: Las liberaciones se suspenden hasta que el refactor se complete. Evite importar paquetes de este repositorio hasta nuevo aviso.

Las etiquetas de lanzamiento son para los paquetes NPM publicados, que son todos los paquetes, excepto el paquete web. Las actualizaciones de la aplicación se publican de forma incremental a través de implementaciones de Master Branch.

Para comenzar el proceso de lanzamiento:

yarn build:libs && npx lerna publish

Traducciones ??

Para agregar traducciones, puede editar manualmente los archivos de traducción JSON en packages/web/translations , usar el editor en línea INLANG o ejecutar yarn machine-translate para agregar traducciones faltantes usando AI desde Inlang.

Nota: Tenemos pruebas en el paquete web que aseguran que todos los archivos de localización contengan las mismas claves y que se encuentren (el mejor esfuerzo), todos encontrados dentro de los archivos de origen TSX. Estos ayudan a mantener actualizadas nuestras localizaciones. Para limpiar las localizaciones, consulte los scripts en la carpeta Web/Localizaciones. Deben ejecutarse usando node dentro de la carpeta de localización.

Listados de activos

Consulte los requisitos de listado de activos para mostrar activos en la aplicación web de la zona de ósmosis.

Mostrando activos de vista previa

Para ver los activos de vista previa para las pruebas, agregue el siguiente parámetro de consulta a la URL de ósmosis:

 ?show_preview_assets=true

Estarán habilitados para la sesión de la pestaña. Si desea deshabilitarlo, abra una nueva pestaña sin el parámetro de consulta o agregar ?show_preview_assets=false .