Быстрый старт
Запустите локальный узел Savitri и отправьте первую транзакцию менее чем за 5 минут.
1. Генерация ключей
# Generate a node keypair
cargo run -p savitri-sdk --bin key_generator
Эта команда выводит пару ключей ed25519:
- Приватный ключ: 64 шестнадцатеричных символа (32 байта) -- держите в тайне
- Публичный ключ: 64 шестнадцатеричных символа (32 байта) -- это ваш адрес
2. Запуск лайтноды
cargo run -p savitri-lightnode --bin lightnode -- \
--listen-port 4001 \
--tx-interval-secs 2 \
--block-interval-secs 10 \
--max-block-txs 32
Лайтнода начинает прослушивать порт 4001 (P2P) и 8545 (RPC).
3. Проверка состояния узла
curl -X POST http://localhost:8545/rpc \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "savitri_health",
"params": [],
"id": 1
}'
Ответ:
{
"jsonrpc": "2.0",
"result": {
"status": "ok",
"service": "savitri-rpc",
"mode": "lightnode"
},
"id": 1
}
4. Получение высоты блока
curl -X POST http://localhost:8545/rpc \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "savitri_blockNumber",
"params": [],
"id": 2
}'
5. Проверка баланса аккаунта
curl -X POST http://localhost:8545/rpc \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "savitri_getAccount",
"params": ["YOUR_ADDRESS_HEX_64_CHARS"],
"id": 3
}'
6. Получение токенов тестовой сети (Faucet)
В тестовой сети получите бесплатные токены SAVT:
curl -X POST http://localhost:8545/rpc \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "savitri_faucetClaim",
"params": ["YOUR_ADDRESS_HEX_64_CHARS"],
"id": 4
}'
Ответ:
{
"jsonrpc": "2.0",
"result": {
"result": {
"tx_hash": "0x...",
"amount": "5000000000000000000"
}
},
"id": 4
}
Faucet выдаёт 5 SAVT за запрос с перезарядкой 24 часа.
7. Использование SDK (Rust)
Добавьте в Cargo.toml:
[dependencies]
savitri-sdk = { path = "../savitri-sdk" }
tokio = { version = "1", features = ["full"] }
use savitri_sdk::{RpcClient, Wallet, TransactionBuilder};
#[tokio::main]
async fn main() -> anyhow::Result<()> {
let client = RpcClient::from_url("http://localhost:8545")?;
// Health check
let health = client.health().await?;
println!("Node mode: {}", health.mode);
// Block height
let height = client.get_block_number().await?;
println!("Block height: {}", height);
// Create wallet and check balance
let wallet = Wallet::new();
let account = client.get_account(wallet.address()).await?;
println!("Address: {}", wallet.address());
println!("Balance: {}", account.balance);
Ok(())
}
Следующие шаги
- Справочник по SDK -- Полная документация SDK
- Справочник RPC API -- Все методы JSON-RPC
- Отправка транзакций -- Создание, подпись и отправка транзакций