osmosis frontend

Osmose Frontend? ‍? ⚗️?

Hinweis: Diese Codebasis wird derzeit einem Refaktor von der KePLR -Architektur zu einem TRPC -Stack unterzogen, um Leistung, Wartbarkeit und Entwicklungsgeschwindigkeit zu verbessern. Wir schätzen Ihre Geduld, wenn wir diese Veränderungen durcharbeiten.

Überblick

Unser Frontend ist mit den folgenden Werkzeugen erstellt:

• TypeScript: Geben Sie die Überprüfung an
• React: UI
• Rückenwind -CSS: Styling, Themen
• Weiter.js: Gerüst/SSR/CDN/SEO
  • Wir stellen auf Vercel für Optimierungen hinter CloudFlare ein
• Turbo Repo: Mono Repo -Management mit Paketskriptausführung mit starkem Schwerpunkt auf dem Aufbau von Caching (einschließlich gemeinsam genutztes Remote -Caching in Vercel)
• Lerna: Libs Release

Einsatz

DEPs installieren:

yarn

Webserver starten

yarn start

Beitragen? ‍

Wir begrüßen und fördern Beiträge! Wir empfehlen, nach Problemen zu suchen, die mit "Good-First-Isue" gekennzeichnet sind.

Stellen Sie sicher, dass Node = 20 und Garn installiert sind.

1. DEPs installieren

yarn

Erstmales Einrichten Wenn Sie im Osmosis Foundation -Team sind und ein Vercel -Konto eingerichtet haben, melden Sie sich optional in Turbo Repo mit Ihrem Vercel -Konto an und verknüpfen Sie das Repo. Auf diese Weise können Sie sofort Builds geben, indem Sie den Remote -Cache in unserem Vercel -Projekt teilen:

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

2. Führen Sie einen ersten Build aus, um Pakete zu erstellen. Build -Artefakte:

yarn build

3. Führen Sie den lokalen Server bei localhost:3000

yarn dev

Testnet

Um sich auf dem kanonischen öffentlichen Test zu entwickeln, rennen Sie:

yarn build:testnet && yarn start:testnet

Um sich gegen ein lokales TestNet wie Localosmose zu entwickeln, legen Sie diese in Ihrer .Env.local -Datei in Webpaket -Root fest:

 # 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)

Möglicherweise müssen Sie zum Konfigurationsordner gehen, um die Liste der IBC-Assets und die Währungen in den Osmose-Ketteninformationen zu aktualisieren, um Währungen in Ihrem TestNet anzuzeigen.

Testnet

Die TestNet -Version des Frontend verwendet NEXT_PUBLIC_IS_TESTNET=true . Standardmäßig weist es auf das kanonische TestNet hin, aber Pakete/Web/.Env können so geändert werden, dass sie auf die Localosmose hinweisen.

Dev:

yarn build:testnet && yarn dev:testnet

Einsetzen:

yarn build:testnet && yarn start:testnet

Hinweis: Unser Währungsregistrar prüft IBC -Hashes, um festzustellen, ob sie über die Denom_Trace -Abfrage im IBC -Modul in der Kette gefunden werden können. Wenn es nicht gefunden wird, wird es es nicht in die Liste der Währungen der Kette hinzufügen. Stellen Sie sicher, dass die IBC -Assets in TestNet im IBC -Modulzustand des TestNET gefunden werden können, damit die Testen IBC -Assets sichtbar sind. Andernfalls können Testvermögen (dh über Tokenfactory) als native Assets in die Osmosekette hinzugefügt werden, indem sie ihre Basis -Denom in der Osmosis -Kette -Info für TestNET definiert.

Veröffentlichungen

Hinweis: Die Veröffentlichungen werden ausgesetzt, bis der Refaktor abgeschlossen ist. Bitte vermeiden Sie das Importieren von Paketen aus diesem Repo bis zu weiteren Ankündigung.

Release -Tags sind für die veröffentlichten NPM -Pakete abgesehen, die jedes Paket mit Ausnahme des Webpakets sind. Aktualisierungen der App werden schrittweise über Bereitstellungen von Master Branch veröffentlicht.

Um den Veröffentlichungsprozess zu starten:

yarn build:libs && npx lerna publish

Übersetzungen?

Um Übersetzungen hinzuzufügen, können Sie die JSON-Übersetzungsdateien in packages/web/translations manuell bearbeiten, den Inlang Online-Editor verwenden oder yarn machine-translate ausführen, um fehlende Übersetzungen mit AI von Inlang hinzuzufügen.

Hinweis: Wir haben Tests im Webpaket, die sicherstellen, dass alle Lokalisierungsdateien dieselben Schlüssel enthalten und die in den TSX -Quelldateien (besten Anstrengungen) enthalten sind. Diese helfen dabei, unsere Lokalisierungen auf dem neuesten Stand zu halten. Um Lokalisationen aufzuräumen, lesen Sie die Skripte im Web-/Lokalisierungsordner. Sie müssen mit node im Lokalisierungsordner ausgeführt werden.

Vermögenswerte

Bitte beachten Sie die Anforderungen an die Vermögensauflistung, um Vermögenswerte in der Web -App der Osmosis Zone anzuzeigen.

Vorschau auf Vermögenswerte anzeigen

Um die Vorschau -Vermögenswerte für das Testen anzuzeigen, fügen Sie den folgenden Abfrageparameter an die Osmose -URL an:

 ?show_preview_assets=true

Sie werden für die Sitzung der Registerkarte aktiviert. Wenn Sie es deaktivieren möchten, öffnen Sie entweder eine neue Registerkarte ohne Abfrageparameter oder appendieren ?show_preview_assets=false .