forked from anoma/namada-docs
-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* feat: zh-CN * feat: UA --------- Co-authored-by: EvgenyKhlivetsky <[email protected]>
- Loading branch information
1 parent
1df7fab
commit b8b3010
Showing
203 changed files
with
4,941 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,5 @@ | ||
.next | ||
node_modules | ||
out | ||
.DS_Store | ||
.DS_Store | ||
.vercel |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
import { withLocales } from 'nextra/locales' | ||
|
||
export const middleware = withLocales((request) => { | ||
}) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
{ | ||
"index": "Namada", | ||
"introduction": "Початок роботи", | ||
"users": "Посібник користувача", | ||
"operators": "Посібник для операторів", | ||
"integrating-with-namada" : "Інтеграція з Namada", | ||
"networks": "Мережі" | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
{ | ||
"sdk" : "Using the SDK", | ||
"indexer": "Indexer" | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,4 @@ | ||
{ | ||
"sdk" : "Using the SDK" | ||
"sdk" : "Using the SDK", | ||
"indexer": "Indexer" | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
{ | ||
"sdk" : "Використання SDK", | ||
"indexer": "Індексатор" | ||
} |
File renamed without changes.
102 changes: 102 additions & 0 deletions
102
packages/docs/pages/integrating-with-namada/indexer.uk-UA.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). | ||
|
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
7 changes: 7 additions & 0 deletions
7
packages/docs/pages/integrating-with-namada/sdk/_meta.en-US.json
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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" | ||
} |
7 changes: 7 additions & 0 deletions
7
packages/docs/pages/integrating-with-namada/sdk/_meta.uk-UA.json
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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" : "Інтеграція інтерфейсу" | ||
} |
File renamed without changes.
Oops, something went wrong.