osmosis frontend

Frontend d'osmose? ‍? ⚗️?

Remarque: Cette base de code subit actuellement un refacteur de l'architecture de KEPLR à une pile TRPC pour améliorer les performances, la maintenabilité et la vitesse de développement. Nous apprécions votre patience alors que nous travaillons à travers ces changements.

Aperçu

Notre frontend est construit avec les outils suivants:

• TypeScript: Type Vérification
• Réagir: ui
• Tailwind CSS: style, thème
• Next.js: échafaudage / SSR / CDN / SEO
  • Nous déployons sur Vercel pour les optimisations hors de la boîte, derrière CloudFlare
• Turbo Repo: Mono Repo Management avec exécution du script de package, avec une forte accent sur la mise en cache de construction (y compris la mise en cache à distance partagée dans Vercel)
• Lerna: Libs Libs

Déploiement

Installer Deps:

yarn

Démarrer le serveur Web

yarn start

Contribuant? ‍

Nous accueillons et encourageons les contributions! Nous vous recommandons de rechercher des problèmes étiquetés avec "bon numéro de publication".

Assurez-vous que Node = 20 et que le fil est installé.

1. Installer Deps

yarn

Configuration pour la première fois si vous êtes dans l'équipe de la Fondation Osmosis et que vous avez une configuration de compte Vercel, connectez éventuellement à Turbo Repo à l'aide de votre compte Vercel et liez le repo. Cela pourrait vous donner des constructions instantanées en partageant le cache distant de notre projet Vercel:

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

2. Exécutez une version initiale pour créer des packages Build Artefacts:

yarn build

3. Exécutez le serveur local à localhost:3000

yarn dev

Testnet

Pour développer sur le test de test public canonique, exécutez:

yarn build:testnet && yarn start:testnet

Pour se développer contre un testt local, tel que localosmose, définissez ceci dans votre fichier .env.local dans la racine du package 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)

Vous devrez peut-être vous rendre dans le dossier de configuration pour mettre à jour la liste IBC-Assets et les devises dans les informations sur la chaîne d'osmose pour afficher les devises de votre test.

Testnet

La version testnet du frontend utilise NEXT_PUBLIC_IS_TESTNET=true . Par défaut, il pointe vers le TestNet canonique, mais les packages / web / .env peuvent être modifiés pour pointer de la localosmose local.

Dev:

yarn build:testnet && yarn dev:testnet

Déployer:

yarn build:testnet && yarn start:testnet

Remarque: Notre registraire de devises vérifie les hachages IBC pour voir s'ils peuvent être trouvés via la requête Denom_Trace dans le module IBC sur chaîne. S'il n'est pas trouvé, il ne l'ajoutera pas à la liste des devises de la chaîne. Assurez-vous que les actifs IBC sur TestNet peuvent être trouvés dans l'état du module IBC de TestNet pour le test des actifs IBC à visible. Sinon, les actifs de test (c'est-à-dire fabriqués via TokenFactory) peuvent être ajoutés en tant qu'actifs natifs à la chaîne d'osmose, simplement en définissant son dénomin de base dans les informations de la chaîne d'osmose pour TestNet.

Sorties

Remarque: les versions sont suspendues jusqu'à ce que le refactor soit terminé. Veuillez éviter d'importer des forfaits de ce dépôt jusqu'à nouvel ordre.

Les balises de version sont destinées aux packages NPM publiés, qui sont tous les packages, sauf pour le package Web. Les mises à jour de l'application sont publiées progressivement via les déploiements de Master Branch.

Pour démarrer le processus de publication:

yarn build:libs && npx lerna publish

Traductions ??

Pour ajouter des traductions, vous pouvez modifier manuellement les fichiers de traduction JSON dans packages/web/translations , utiliser l'éditeur en ligne INLANG ou exécuter yarn machine-translate pour ajouter des traductions manquantes à l'aide de l'INLAND.

Remarque: Nous avons des tests dans le package Web qui garantissent que tous les fichiers de localisation contiennent les mêmes clés et qu'ils sont (les meilleurs efforts) tous trouvés dans les fichiers source TSX. Ceux-ci aident à maintenir nos localisations à jour. Pour nettoyer les localisations, consultez les scripts dans le dossier Web / localisations. Ils doivent être exécutés à l'aide node dans le dossier de localisation.

Listes d'actifs

Veuillez consulter les exigences de liste des actifs pour afficher les actifs sur l'application Web de la zone d'osmosis.

Affichage des actifs d'aperçu

Pour afficher les actifs de prévisualisation pour les tests, ajoutez le paramètre de requête suivant à l'URL d'osmose:

 ?show_preview_assets=true

Ils seront activés pour la session de l'onglet. Si vous souhaitez le désactiver, ouvrez un nouvel onglet sans le paramètre de requête ou appelez ?show_preview_assets=false .