osmosis frontend

Frontend de Osmose? ‍? ⚗️?

NOTA: Esta base de código está atualmente passando por um refator da arquitetura da KEPLR para uma pilha TRPC para melhorar o desempenho, a manutenção e a velocidade de desenvolvimento. Agradecemos sua paciência enquanto trabalhamos com essas mudanças.

Visão geral

Nosso front -end é construído com as seguintes ferramentas:

• TypeScript: Verificação do tipo
• REACTER: UI
• Tailwind CSS: estilo, tema
• Next.JS: Scaffolding/SSR/CDN/SEO
  • Implantamos no Vercel para otimizações prontas, por trás do CloudFlare
• Turbo Repo: Mono Repo Management com execução de scripts de pacotes, com ênfase forte no cache de compilação (incluindo cache remoto compartilhado em vercel)
• LERNA: Liberação de Libs

Implantação

Instalar deps:

yarn

Inicie o servidor da web

yarn start

Contribuindo? ‍

Congratulamo -nos com e incentivamos as contribuições! Recomendamos procurar problemas rotulados com "bom primeiro de emissão".

Verifique se o nó = 20 e o fio estão instalados.

1. Instale deps

yarn

Configuração pela primeira vez Se você estiver na equipe da Osmosis Foundation e tiver uma conta de vercel configurada, opcionalmente, assine no Turbo Repo usando sua conta vercel e vincule o repositório. Isso pode lhe dar construções instantâneas compartilhando o cache remoto em nosso projeto de vercel:

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

2. Execute uma compilação inicial para criar pacotes construir artefatos:

yarn build

3. Execute o servidor local em localhost:3000

yarn dev

TestNet

Para desenvolver no Testnet público canônico, execute:

yarn build:testnet && yarn start:testnet

Para desenvolver -se contra um TestNet local, como Localosmosis, defina isso no seu arquivo .env.local no pacote da web root:

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

Pode ser necessário acessar a pasta de configuração para atualizar a lista de ativos do IBC e moedas nas informações da cadeia de osmose para visualizar moedas no seu TestNet.

TestNet

A versão TestNet do frontend usa NEXT_PUBLIC_IS_TESTNET=true . Por padrão, aponta para o TestNet canônico, mas os pacotes/Web/.env podem ser alterados para apontar para Localosmose.

Dev:

yarn build:testnet && yarn dev:testnet

Implantar:

yarn build:testnet && yarn start:testnet

NOTA: Nosso registrador de moeda verifica o IBC Hashes para ver se eles podem ser encontrados através da consulta Denom_Trace no módulo IBC na cadeia. Se não for encontrado, não o adicionará à lista de moedas da cadeia. Verifique se os ativos do IBC no TestNet podem ser encontrados no estado do módulo IBC do TestNet para que os ativos do IBC sejam visíveis. Caso contrário, os ativos de teste (ou seja, feitos via tokenfactory) podem ser adicionados como ativos nativos à cadeia de osmose, simplesmente definindo seu denom de base nas informações da cadeia de osmose para o TestNet.

Lançamentos

Nota: Os lançamentos são suspensos até que o refattor esteja concluído. Evite importar pacotes deste repositório até novo aviso.

As tags de liberação são para os pacotes NPM publicados, que são todos os pacotes, exceto o pacote da web. As atualizações para o aplicativo são lançadas de maneira incremental por meio de implantações do Master Branch.

Para iniciar o processo de liberação:

yarn build:libs && npx lerna publish

Traduções ??

Para adicionar traduções, você pode editar manualmente os arquivos de tradução JSON em packages/web/translations , usar o editor on-line do Inlang ou executar yarn machine-translate para adicionar traduções ausentes usando a IA do Inlang.

NOTA: Temos testes no pacote da web que garantem que todos os arquivos de localização contenham as mesmas teclas e que elas (melhor esforço) são encontradas nos arquivos de origem TSX. Isso ajuda a manter nossas localizações atualizadas. Para limpar as localizações, consulte os scripts na pasta Web/Localizações. Eles devem ser executados usando node dentro da pasta de localização.

Listagens de ativos

Consulte os requisitos de listagem de ativos para exibir ativos no aplicativo da Web de Osmose Zone.

Mostrando ativos de visualização

Para visualizar os ativos de visualização para teste, anexe o seguinte parâmetro de consulta ao URL da osmose:

 ?show_preview_assets=true

Eles serão ativados para a sessão da guia. Se você quiser desativá -lo, abra uma nova guia sem o parâmetro de consulta ou anexar ?show_preview_assets=false .