osmosis frontend

Фронтант Osmoses? ‍? ⚗?

ПРИМЕЧАНИЕ. В настоящее время эта кодовая база проходит рефактор от архитектуры KEPLR до стека TRPC для повышения производительности, обслуживания и скорости развития. Мы ценим ваше терпение, когда мы работаем над этими изменениями.

Обзор

Наш фронт построен со следующими инструментами:

• TypeScript: проверка типа
• React: UI
• Tailwind CSS: стиль, темация
• Next.js: леса/SSR/CDN/SEO
  • Мы развертываем на Vercel для оптимизации из коробки, за CloudFlare
• Turbo Repo: Mono Repo Management с выполнением сценария пакетов, с большим акцентом на кэширование сборки (включая общее удаленное кэширование в Vercel)
• ЛЕРНА: Libs Release

Развертывание

Установить DEPS:

yarn

Запустите веб -сервер

yarn start

Вклад? ‍

Мы приветствуем и поощряем вклад! Мы рекомендуем искать проблемы, помеченные «хорошим первым».

Убедитесь, что узел = 20 и пряжа установлена.

1. Установите DEPS

yarn

Настройка в первый раз, если вы находитесь в команде Foundation Osmose, и настраивайте учетную запись Vercel, при условии, подпись в Turbo Repo, используя свою учетную запись Vercel, и свяжите репо. Это может дать вам мгновенные сборки, поделившись удаленным кешем в нашем проекте Vercel:

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

2. Запустите начальную сборку, чтобы создать артефакты сборки пакетов:

yarn build

3. Запустите локальный сервер по адресу localhost:3000

yarn dev

Тестовая сеть

Чтобы разрабатывать на канонической общедоступной тестовой сети, запустите:

yarn build:testnet && yarn start:testnet

Для развития против локальной тестовой сети, такой как локальный, установите это в свой файл .env.local в 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)

Возможно, вам придется перейти в папку конфигурации, чтобы обновить список IBC-Assets и валюты в информации о цепочке осмоса, чтобы просмотреть валюты в вашей тестовой сети.

Тестовая сеть

Версия Testnet of Frontend использует NEXT_PUBLIC_IS_TESTNET=true . По умолчанию он указывает на каноническую тестовую сеть, но пакеты/web/.env могут быть изменены, чтобы указать на локальный мамос.

Разработчик:

yarn build:testnet && yarn dev:testnet

Развертывать:

yarn build:testnet && yarn start:testnet

ПРИМЕЧАНИЕ. Наш регистратор валюты проверяет HASH IBC, чтобы увидеть, можно ли их найти с помощью запроса Denom_trace в модуле IBC на цепи. Если это не найдено, это не добавит его в список валют цепочки. Убедитесь, что активы IBC на TestNet можно найти в состоянии IBC для IBC TestNet для тестирования активов IBC, которые будут видны. В противном случае, тестовые активы (то есть сделанные через TokenFactory) могут быть добавлены в качестве нативных активов в цепь осмоса, просто определив ее базовую деному в информации цепи осмоса для TestNet.

Выпуски

ПРИМЕЧАНИЕ. Выпуски приостановлены до тех пор, пока рефактор не будет завершен. Пожалуйста, избегайте импорта пакетов из этого репо до дальнейшего уведомления.

Теги релиза предназначены для опубликованных пакетов NPM, которые представляют собой каждый пакет, за исключением веб -пакета. Обновления в приложении выпускаются постепенно через развертывание из Master Branch.

Чтобы начать процесс выпуска:

yarn build:libs && npx lerna publish

Переводы ??

Чтобы добавить переводы, вы можете вручную редактировать файлы перевода JSON в packages/web/translations , использовать онлайн-редактор Inlang или запустить yarn machine-translate чтобы добавить недостающие переводы с использованием ИИ из Inlang.

Примечание. У нас есть тесты в веб -пакете, которые гарантируют все файлы локализации, содержащие одинаковые ключи и что они (наилучшие усилия) найдены в исходных файлах TSX. Они помогают поддерживать наши локализации в курсе. Чтобы очистить локализацию, ознакомьтесь с сценариями в папке Web/Localizations. Они должны работать с помощью node в папке локализации.

Списки активов

Пожалуйста, смотрите требования к листингу активов для отображения активов в веб -приложении зоны осмоса.

Показывая предварительные активы

Для просмотра предварительного просмотра активов для тестирования добавьте следующий параметр запроса к URL -адресу Osmoses:

 ?show_preview_assets=true

Они будут включены для сеанса вкладки. Если вы хотите отключить его, либо откройте новую вкладку без параметра запроса, либо добавить ?show_preview_assets=false .