osmosis frontend

Osmosis Frontend? ‍? ⚗️?

CATATAN: Basis kode ini saat ini sedang menjalani refactor dari arsitektur Keplr ke tumpukan TRPC untuk meningkatkan kinerja, pemeliharaan, dan kecepatan pengembangan. Kami menghargai kesabaran Anda saat kami mengerjakan perubahan ini.

Ringkasan

Frontend kami dibangun dengan alat berikut:

• TypeScript: Ketik Pemeriksaan
• Bereaksi: UI
• Tailwind CSS: Styling, Theming
• Next.js: Perancah/SSR/CDN/SEO
  • Kami menggunakan Vercel untuk optimasi di luar kotak, di belakang Cloudflare
• Turbo Repo: Manajemen Repo Mono dengan Eksekusi Skrip Paket, dengan penekanan berat pada caching build (termasuk caching jarak jauh bersama di Vercel)
• LERNA: Rilis LIBS

Penyebaran

Instal Deps:

yarn

Mulai server web

yarn start

Berkontribusi? ‍

Kami menyambut dan mendorong kontribusi! Kami merekomendasikan mencari masalah yang diberi label dengan "edisi pertama".

Pastikan node = 20 dan benang diinstal.

1. Instal Deps

yarn

Pengaturan pertama kali jika Anda berada di tim Osmosis Foundation dan mengatur akun Vercel, secara opsional masuk ke Turbo Repo menggunakan akun Vercel Anda, dan menautkan repo. Ini bisa memberi Anda build instan dengan berbagi cache jarak jauh pada proyek Vercel kami:

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

2. Jalankan Build Awal untuk Membuat Paket Bangun Artefak:

yarn build

3. Jalankan server lokal di localhost:3000

yarn dev

Testnet

Untuk mengembangkan testnet publik kanonik, jalankan:

yarn build:testnet && yarn start:testnet

Untuk mengembangkan terhadap testnet lokal, seperti localosmosis, atur ini di file .env.local Anda di root paket 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)

Anda mungkin perlu pergi ke folder konfigurasi untuk memperbarui daftar dan mata uang IBC-Assets dalam info rantai osmosis untuk melihat mata uang pada testNet Anda.

Testnet

Versi testNet dari frontend menggunakan NEXT_PUBLIC_IS_TESTNET=true . Secara default, itu menunjuk ke testnet kanonik, tetapi paket/web/.env dapat diubah untuk menunjuk ke localosmosis.

DEV:

yarn build:testnet && yarn dev:testnet

Menyebarkan:

yarn build:testnet && yarn start:testnet

Catatan: Pendaftar mata uang kami memeriksa hash IBC untuk melihat apakah mereka dapat ditemukan melalui kueri Denom_Trace di modul IBC pada rantai. Jika tidak ditemukan, itu tidak akan menambahkannya ke daftar mata uang rantai. Pastikan aset IBC di TestNet dapat ditemukan di status modul IBC TestNet untuk pengujian aset IBC agar terlihat. Kalau tidak, aset uji (yaitu dibuat melalui tokenFactory) dapat ditambahkan sebagai aset asli ke rantai osmosis, hanya dengan mendefinisikan denom dasarnya dalam info rantai osmosis untuk testnet.

Pelepasan

Catatan: Rilis ditangguhkan sampai refactor selesai. Harap hindari mengimpor paket dari repo ini sampai pemberitahuan lebih lanjut.

Tag rilis untuk paket NPM yang diterbitkan, yang merupakan setiap paket kecuali untuk paket web. Pembaruan ke aplikasi dirilis secara bertahap melalui penyebaran dari Master Branch.

Untuk memulai proses rilis:

yarn build:libs && npx lerna publish

Terjemahan ??

Untuk menambahkan terjemahan, Anda dapat mengedit file terjemahan JSON secara manual dalam packages/web/translations , menggunakan editor online inlang, atau menjalankan yarn machine-translate untuk menambahkan terjemahan yang hilang menggunakan AI dari inlang.

Catatan: Kami memiliki tes dalam paket web yang memastikan semua file lokalisasi berisi kunci yang sama dan bahwa mereka (upaya terbaik) semuanya ditemukan dalam file sumber TSX. Ini membantu menjaga lokalisasi kami tetap up to date. Untuk membersihkan lokalisasi, lihat skrip di folder Web/Lokalisasi. Mereka harus dijalankan menggunakan node dalam folder lokalisasi.

Daftar Aset

Silakan lihat persyaratan daftar aset untuk menampilkan aset di aplikasi web Osmosis Zone.

Menampilkan aset pratinjau

Untuk melihat aset pratinjau untuk pengujian, tambahkan parameter kueri berikut ke URL osmosis:

 ?show_preview_assets=true

Mereka akan diaktifkan untuk sesi tab. Jika Anda ingin menonaktifkannya, buka tab baru tanpa parameter kueri atau tambahkan ?show_preview_assets=false .