Skip to content

Commit

Permalink
Feat: i18n CN & UA (#3)
Browse files Browse the repository at this point in the history
* feat: zh-CN

* feat: UA

---------

Co-authored-by: EvgenyKhlivetsky <[email protected]>
  • Loading branch information
RuslanGlaznyov and EvgenyKhlivetsky authored Nov 15, 2023
1 parent 1df7fab commit b8b3010
Show file tree
Hide file tree
Showing 203 changed files with 4,941 additions and 7 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
.next
node_modules
out
.DS_Store
.DS_Store
.vercel
1 change: 1 addition & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
"dev:specs": "npm run dev --workspace=packages/specs",
"dev:community": "npm run dev --workspace=packages/community",
"build:docs": "npm run build --workspace=packages/docs",
"build:page": "npm run cloud-page --workspace=packages/docs",
"build:specs": "npm run build --workspace=packages/specs",
"build:community": "npm run build --workspace=packages/community",
"build": "npm run build --workspaces"
Expand Down
4 changes: 4 additions & 0 deletions packages/docs/middleware.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
import { withLocales } from 'nextra/locales'

export const middleware = withLocales((request) => {
})
4 changes: 4 additions & 0 deletions packages/docs/next.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@ const withNextra = require("nextra")({

module.exports = {
...withNextra(),
i18n: {
locales: ['en-US', 'uk-UA', 'zh-CN'],
defaultLocale: 'en-US'
},
images: {
unoptimized: true,
},
Expand Down
5 changes: 3 additions & 2 deletions packages/docs/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,9 @@
"license": "GPL-3.0",
"scripts": {
"dev": "next dev",
"build": "next build && next export",
"start": "next start"
"build": "next build",
"start": "next start",
"cloud-page": "npx @cloudflare/next-on-pages@1"
},
"dependencies": {
"next": "^13.4.8",
Expand Down
File renamed without changes.
8 changes: 8 additions & 0 deletions packages/docs/pages/_meta.uk-UA.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"index": "Namada",
"introduction": "Початок роботи",
"users": "Посібник користувача",
"operators": "Посібник для операторів",
"integrating-with-namada" : "Інтеграція з Namada",
"networks": "Мережі"
}
8 changes: 8 additions & 0 deletions packages/docs/pages/_meta.zh-CN.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"index": "Namada",
"introduction": "Getting Started",
"users": "User Guide",
"operators": "Operator Guide",
"integrating-with-namada" : "Integration Guide",
"networks": "Networks"
}
File renamed without changes.
37 changes: 37 additions & 0 deletions packages/docs/pages/index.uk-UA.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
import { DocsAscii } from '../components/DocsAscii'

<DocsAscii/>

## Про Namada

[Namada](https://namada.net/)- це блокчейн, орієнтований на конфіденційність активів,
який використовує технологію доказу нульового знання. Криптографічні особливості Namada забезпечують
користувачам агностичність щодо активів, міжланцюгову конфіденційність, і розробляється Фондом Anoma.

### Ключові нововведення:

- Zcash-подібні перекази на будь-які активи (взаємозамінні та не взаємозамінні)
- Винагорода за використання приватності як суспільного блага
- Інтероперабельність з Ethereum через спеціальний міст з мінімізацією довіри

## Огляд функціонала

- [Proof-of-Stake](./operators/validators/proof-of-stake.mdx) з [управлінням](./users/governance.mdx) щоб захищати та розвивати Namada
- BFT швидкої фінальності з 4-секундними блоками
- Двосторонній міст Ethereum з мінімізацією довіри
- IBC-з'єднання з блокчейнами, які вже комунікують по IBC (всі блокчейни Cosmos)
- [Multi-Asset Shielded Pool](./users/shielded-accounts/shielded-transfers.mdx) (MASP)
- Перетворення схеми ([захищений набір винагород](./users/shielded-accounts/shielded-rewards.mdx))
- Застосунок для [Ledger](./users/wallet/hardware-wallet.mdx)

Для поверхневого рівня ознайомлення ми рекомендуємо:

- Стаття: [Introducing Namada: Interchain Asset-agnostic Privacy](https://blog.namada.net/introducing-namada-interchain-asset-agnostic-privacy/)
- Стаття: [What is Namada?](https://blog.namada.net/what-is-namada/)
- [Бесіди та подкасти](https://namada.net/talks)

Щоб дізнатися більше про протокол, ми рекомендуємо ці поглиблені ресурси:

- Виступ на самміті ZK8 [Namada: asset-agnostic interchain privacy](https://youtu.be/5K6YxmZPFkE)
- [Специфікації Namada](https://specs.namada.net)
- [Сховище коду](https://github.com/anoma/namada)
31 changes: 31 additions & 0 deletions packages/docs/pages/index.zh-CN.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
import { DocsAscii } from '../components/DocsAscii'

<DocsAscii/>
# 关于 Namada (About Namada)

Namada 是一个以隐私保护为核心,利用零知识证明技术的区块链平台。Namada 的加密特性为用户提供了与资产无关、跨链的隐私保护,由 Anoma 基金会负责开发建设。

### 主要创新 (Key innovations):
对任何资产(可替换和不可替换的)实现类似 Zcash 的转账
将隐私作为公共利益的有奖使用
通过定制的桥接技术,实现与以太坊的互操作性,同时最小化信任

### 功能概述 (Overview of features):
- 采用具有[治理](./users/governance.mdx)功能的[权益证明机制](./operators/validators/proof-of-stake.zh-CN.mdx),以保护和推动 Namada 的发展
- 采用快速确定性的拜占庭容错机制,实现 4 秒的区块时间
- 通过最小化信任的双向以太坊桥接
- 通过 IBC 连接到已经支持 IBC 的链(所有 Cosmos 链)
- [多资产屏蔽池(MASP](./users/shielded-accounts.zh-CN.mdx),用于实现资产无关的隐私保护
- 转换电路 [(屏蔽奖励)](./users/shielded-rewards.zh-CN.mdx),用于以屏蔽方式奖励隐私集贡献
- 账本应用

### 高层次介绍推荐 (For high-level introductions, we recommend):

- 文章:[介绍 Namada:跨链资产无关隐私](https://namada.net/blog/introducing-namada-interchain-asset-agnostic-privacy)
- 文章:[什么是 Namada?](https://namada.net/blog/what-is-namada)
- 交谈和播客

### 深入了解协议推荐资源 (To learn more about the protocol, we recommend the following in-depth resources):
- ZK8 Namada 讲座:[资产无关的跨链隐私](https://www.youtube.com/watch?v=5K6YxmZPFkE)
- [Namada 的规格说明](https://specs.namada.net/)
- [代码库](https://github.com/anoma/namada)
10 changes: 10 additions & 0 deletions packages/docs/pages/integrating-with-namada.uk-UA.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Інтеграція

Цей посібник присвячений інтеграції з Namada. Він призначений для розробників, які хочуть інтегрувати з Namada у свої додатки, а також для інженерів, які хочуть розширити Namada.

## Ліцензія
Namada працює під [ліцензією GPLv3](https://www.gnu.org/licenses/gpl-3.0.html) і є вільною для використання та модифікації. Будь ласка, зверніться до [ЛІЦЕНЗІЯ](https://github.com/anoma/namada/blob/main/LICENSE) для отримання додаткової інформації.

## Зміст
- [SDK](./integrating-with-namada/sdk.mdx)
- [Індексатор](./integrating-with-namada/indexer.mdx)
4 changes: 4 additions & 0 deletions packages/docs/pages/integrating-with-namada/_meta.en-US.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"sdk" : "Using the SDK",
"indexer": "Indexer"
}
3 changes: 2 additions & 1 deletion packages/docs/pages/integrating-with-namada/_meta.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
{
"sdk" : "Using the SDK"
"sdk" : "Using the SDK",
"indexer": "Indexer"
}
4 changes: 4 additions & 0 deletions packages/docs/pages/integrating-with-namada/_meta.uk-UA.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"sdk" : "Використання SDK",
"indexer": "Індексатор"
}
102 changes: 102 additions & 0 deletions packages/docs/pages/integrating-with-namada/indexer.uk-UA.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
import Expandable from '../../components/Expandable';
import { Callout } from 'nextra-theme-docs'

# Namada Indexer

У співпраці з [Zondax](https://zondax.ch/) було створено індексатор для блокчейну Namada.

Індексатор Namada (він же `namadexer`) постійно запитує блокчейн Namada і разом з [SDK](./sdk.mdx) може відображати блоки, транзакції та іншу цінну інформацію в реляційну базу даних (postgres).

Це особливо корисно для виконання аналітики над блокчейном, в тому числі для зберігання історичних даних, які можна легко запитувати.

## Налаштування

Вихідний код індексатора namada можна знайти [тут](https://github.com/zondax/namadexer), і він простий у налаштуванні.

Найкраще `namadexer` працює разом з [Docker](https://www.docker.com/products/docker-desktop)

```bash
git clone https://github.com/Zondax/namadexer.git
cd namadexer
make compose
```

## Запуск сервера і бази даних
Після запуску DockerFile можна легко налаштувати базу даних postgres, а також сервер, який буде запитувати базу даних.

Переконайтеся, що `postgres` [встановлено](https://www.postgresql.org/download/) на локальній машині.

**Запуск postgres у докері**
```bash
make postgres
# or run (and change arguments, e.g port):
# docker run --name postgres -e POSTGRES_PASSWORD=wow -e POSTGRES_DB=blockchain -p 5432:5432 -d postgres
```
Коли сервер Postgres запущений і працює, прийшов час налаштувати сервер, який буде виконувати запити до бази даних Postgres.

Щоб налаштувати сервер, виконайте наступну команду
```
make run_server
```

У разі успіху сервер повинен працювати як служба на локальному хості за портом `30303`.

## Запуск індексатора

Спочатку переконайтеся, що файл `Settings.toml` у каталозі `config/Settings.toml` налаштовано правильно.

<Expandable>
```toml
log_level = "info"
network = "public-testnet-14"

[database]
host = "0.0.0.0:5435"
user = "postgres"
password = "wow"
dbname = "blockchain"
# Optional field to configure a timeout if database connection
# fails.
connection_timeout = 20


[server]
serve_at = "0.0.0.0"
port = 30303

[indexer]
tendermint_addr = "0.0.0.0"
port = 26657

[jaeger]
enable = false
host = "localhost"
port = 6831

[prometheus]
host = "0.0.0.0"
port = 9000
```

</Expandable>

<Callout type="info" emoji="👀">
**Інтерпретація toml**

Важливо змінити наступні параметри:

1. `indexer.tendermint_addr` - Це має бути адреса та відповідний порт синхронізованого повного вузла Namada

2. `database.host` - Це має бути tcp-адреса (з портом), на якій запущено базу даних postgres.
</Callout>

Після завершення налаштування можна запускати індексатор

```bash
make run_indexer
```

## Запит до бази даних

Попередньо визначені кінцеві точки для запитів до бази даних описано в документації [тут](https://github.com/Zondax/namadexer/blob/main/docs/04-server.md).

63 changes: 63 additions & 0 deletions packages/docs/pages/integrating-with-namada/sdk.uk-UA.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
import Expandable from '../../components/Expandable';

# Namada SDK

Комплект для розробки програмного забезпечення (SDK) Namada можна знайти в репозиторії `namada` за посиланням [`namada/shared`](https://github.com/anoma/namada/tree/main/shared). SDK написаний на Rust і може бути використаний для взаємодії з блокчейном Namada шляхом створення транзакцій, їх підписання та відправки в мережу.

## Швидкий старт

Гарною відправною точкою для ознайомлення з використанням SDK є репозиторій [namada interface](https://github.com/anoma/namada-interface/tree/main/packages/shared/lib/src/sdk). Цей репозиторій містить простий веб-додаток, який використовує SDK для взаємодії з блокчейном Namada. Однак, важливо відзначити додаткову складність, що виникає через інтеграцію додатку з javascript за допомогою [wasm-bindgen](https://rustwasm.github.io/docs/wasm-bindgen/), що не є обов'язковим.

## Встановлення

Namada SDK можна встановити, створивши новий проект Rust і додавши до файлу `Cargo.toml` наступне:


<Expandable>

```toml
[package]
name = "namada-sdk-starter"
version = "0.1.0"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]
async-std = "1.11.0"
async-trait = "0.1.51"
borsh = "0.9.0"
file-lock = "2.0.2"
futures = "0.3.28"
getrandom = { version = "0.2" }
masp_primitives = { git = "https://github.com/anoma/masp.git", rev = "50acc5028fbcd52a05970fe7991c7850ab04358e" }
masp_proofs = { git = "https://github.com/anoma/masp.git", rev = "50acc5028fbcd52a05970fe7991c7850ab04358e", features = ["download-params"]}
# Make sure the rev is to the latest version of namada in the below repo
namada_sdk = { git = "https://github.com/anoma/namada.git", rev = "v0.24.0", default-features = false, features = ["abciplus", "namada-sdk", "std"] }
rand = {version = "0.8", default-features = false}
rand_core = {version = "0.6", default-features = false}
tendermint-config = {git="https://github.com/heliaxdev/tendermint-rs.git", rev="b7d1e5afc6f2ccb3fd1545c2174bab1cc48d7fa7"}
tendermint-rpc = {git="https://github.com/heliaxdev/tendermint-rs.git", rev="b7d1e5afc6f2ccb3fd1545c2174bab1cc48d7fa7", features = ["http-client"]}
thiserror = "1.0.38"
tokio = {version = "1.8.2", default-features = false}
toml = "0.5.8"
zeroize = "1.5.5"

[patch.crates-io]
borsh = {git = "https://github.com/heliaxdev/borsh-rs.git", rev = "cd5223e5103c4f139e0c54cf8259b7ec5ec4073a"}
borsh-derive = {git = "https://github.com/heliaxdev/borsh-rs.git", rev = "cd5223e5103c4f139e0c54cf8259b7ec5ec4073a"}
borsh-derive-internal = {git = "https://github.com/heliaxdev/borsh-rs.git", rev = "cd5223e5103c4f139e0c54cf8259b7ec5ec4073a"}
borsh-schema-derive-internal = {git = "https://github.com/heliaxdev/borsh-rs.git", rev = "cd5223e5103c4f139e0c54cf8259b7ec5ec4073a"}

```

</Expandable>


Після встановлення sdk ви можете використовувати його для взаємодії з блокчейном Namada.

## Зміст

- [Налаштування клієнта](./sdk/setting-up-a-client.mdx)
- [Налаштування гаманця](./sdk/setting-up-a-wallet.mdx)
- [Створення переказів](./sdk/constructing-transfers.mdx)
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"setting-up-a-client" : "Setting up a client",
"setting-up-a-wallet" : "Setting up a wallet",
"generating-accounts": "Generating accounts",
"constructing-transfers" : "Constructing transfers",
"interface-integration" : "Integrating with the interface"
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"setting-up-a-client" : "Налаштування клієнта",
"setting-up-a-wallet" : "Налаштування гаманця",
"generating-accounts": "Генерація рахунків",
"constructing-transfers" : "Конструювання переказів",
"interface-integration" : "Інтеграція інтерфейсу"
}
Loading

0 comments on commit b8b3010

Please sign in to comment.