Hello World — Ваша первая транзакция в Savitri

Это руководство проведёт вас от нуля до отправки первой транзакции в тестовой сети Savitri. Выберите путь, соответствующий вашему профилю.

Путь	Для кого	Время	Предварительные требования
A. Браузерный кошелёк	Пользователи крипты	2 мин	Chrome/Brave
B. Мобильное приложение	Мобильные пользователи	3 мин	iOS или Android
C. Установщик для рабочего стола	Нетехнические пользователи	5 мин	Windows или macOS
D. Docker (разработчик)	Разработчики	5 мин	Установлен Docker
E. Сборка из исходного кода	Разработчики на Rust	15 мин	Rust 1.82+

---

A. Браузерный кошелёк

Время: 2 минуты

1. Установите расширение Savitri Wallet из интернет-магазина Chrome

2. Откройте расширение и нажмите Create Wallet

3. Запишите вашу мнемоническую фразу из 12 слов и сохраните её в надёжном месте

4. Ваш кошелёк автоматически подключится к тестовой сети Savitri

5. Получите тестовые токены из крана:

   • Откройте кошелёк
   • Нажмите Request Testnet Tokens
   • Подождите 10 секунд для подтверждения

6. Отправьте вашу первую транзакцию:

   • Нажмите Send
   • Введите любой адрес тестовой сети (или используйте пример адреса, показанного в кошельке)
   • Введите сумму (например, 10 SAVI)
   • Нажмите Confirm

7. Проверьте транзакцию на вкладке History кошелька

Готово. Вы создали кошелёк, получили токены и отправили транзакцию в Savitri.

---

B. Мобильное приложение

Время: 3 минуты

1. Скачайте приложение Savitri:

   • iOS (App Store)
   • Android (Play Store)

2. Откройте приложение и нажмите Create New Wallet

3. Надёжно сохраните вашу мнемоническую фразу

4. Приложение подключается к тестовой сети и запускает облегчённый узел в фоне

5. Нажмите Receive, чтобы увидеть адрес вашего кошелька

6. Нажмите Faucet, чтобы получить бесплатные тестовые SAVI

7. Нажмите Send → введите адрес получателя → введите сумму → подтвердите

8. Наблюдайте за появлением транзакции в Activity

Бонус: перейдите на вкладку Node, чтобы увидеть статус лайтноды, подключённые узлы и оценку PoU.

---

C. Установщик для рабочего стола

Время: 5 минут

1. Скачайте установщик:

   • Windows (.exe)
   • macOS (.dmg)

2. Запустите установщик и следуйте мастеру настройки (15 шагов с подсказками)

3. Выберите тип узла:

   • Lightnode (рекомендуется для первого раза) — минимальные ресурсы
   • Masternode — полный валидатор (требует 8 ГБ+ ОЗУ)

4. Установщик скачивает двоичный файл узла, генерирует ключи и настраивает всё

5. Нажмите Start Node — ваш узел подключится к тестовой сети

6. Откройте вкладку Wallet → Create Wallet → сохраните мнемоническую фразу

7. Нажмите Faucet → получите тестовые токены

8. Нажмите Send → введите получателя → введите сумму → подтвердите

9. Проверьте вкладку Dashboard для просмотра метрик в реальном времени: высота блока, узлы, оценка PoU

---

D. Docker (разработчик)

Время: 5 минут

Предварительные требования

• Установлен Docker (получить Docker)

Шаг 1: Запустите лайтноду

docker run -d --name savitri-node \
  -p 4001:4001 -p 8545:8545 -p 9090:9090 \
  savitri/lightnode:testnet

Шаг 2: Проверьте, что узел работает

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"chain_getBlockHeight","params":[],"id":1}'

Ожидаемый ответ:

{"jsonrpc":"2.0","result":{"height":12345},"id":1}

Шаг 3: Создайте кошелёк

# Generate a new keypair
curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"wallet_create","params":[],"id":2}'

Сохраните возвращённый адрес и приватный ключ.

Шаг 4: Получите тестовые токены

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"faucet_request","params":["YOUR_ADDRESS"],"id":3}'

Шаг 5: Проверьте баланс

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"account_getBalance","params":["YOUR_ADDRESS"],"id":4}'

Шаг 6: Отправьте транзакцию

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"tx_send",
    "params":{
      "from":"YOUR_ADDRESS",
      "to":"RECIPIENT_ADDRESS",
      "amount":"1000000000000000000",
      "private_key":"YOUR_PRIVATE_KEY"
    },
    "id":5
  }'

Сумма указывается в wei (18 десятичных знаков). 1000000000000000000 = 1 SAVI.

Шаг 7: Запустите полную локальную тестовую сеть (необязательно)

git clone --recurse-submodules https://github.com/Savitri-Network/savitri-network.git
cd savitri-network/savitri-testnet
docker-compose up -d

Это запустит: 2 мастерноды, 1 лайтноду, 1 гардиан, Prometheus и Grafana.

• Панель Grafana: http://localhost:3000
• Метрики Prometheus: http://localhost:9090
• RPC (мастернода 1): http://localhost:8545
• RPC (мастернода 2): http://localhost:8546
• RPC (лайтнода): http://localhost:8547

---

E. Сборка из исходного кода

Время: 15 минут

Предварительные требования

# macOS
brew install rustup cmake ninja llvm openssl zstd lz4 ccache protobuf
rustup install stable

# Ubuntu / Debian
sudo apt install build-essential pkg-config clang llvm-dev libclang-dev \
  cmake ninja-build libssl-dev zlib1g-dev liblz4-dev libzstd-dev
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Windows — install Visual Studio Build Tools with C++ workload + Windows SDK

Шаг 1: Клонируйте и соберите

git clone --recurse-submodules https://github.com/Savitri-Network/savitri-network.git
cd savitri-network

# Build a lightnode
cargo build --release -p savitri-lightnode

Шаг 2: Запустите узел

./target/release/lightnode \
  --listen-port 4001 \
  --tx-interval-secs 2 \
  --block-interval-secs 10 \
  --max-block-txs 32 \
  --bootstrap <PEER_ID>@/ip4/<TESTNET_IP>/tcp/4002

Получите текущий адрес начальной загрузки тестовой сети из конфигурации тестовой сети.

Шаг 3: Создайте ключи

cargo build --release -p savitri-sdk
./target/release/key_generator

Это выведет ваш публичный ключ (адрес) и приватный ключ.

Шаг 4: Отправьте транзакцию через RPC

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"tx_send",
    "params":{
      "from":"YOUR_ADDRESS",
      "to":"RECIPIENT_ADDRESS",
      "amount":"1000000000000000000",
      "private_key":"YOUR_PRIVATE_KEY"
    },
    "id":1
  }'

Шаг 5: Разверните токен (необязательно)

Смотрите полное руководство: Развёртывание токена SAVITRI-20

---

Что дальше?

Цель	Ресурс
Понять архитектуру	Обзор архитектуры
Развернуть токен	Руководство по развёртыванию токена
Запустить валидатор (мастернода)	Типы узлов
Разрабатывать с SDK	Обзор SDK
Изучить RPC API	Справочник методов RPC
Присоединиться к сообществу	Discord
Прочитать о токеномике	Распределение токенов
Полная документация	docs.savitrinetwork.com