Клиент контрактов

ContractClient предоставляет высокоуровневые вспомогательные функции для взаимодействия со смарт-контрактами, оракулами и системой управления в Savitri Network.

Настройка

use savitri_sdk::{ContractClient, Wallet, RpcClient};

let wallet = Wallet::from_private_key_hex("your_private_key")?;
let rpc = RpcClient::from_url("http://localhost:8545")?;

let contract = ContractClient::new(rpc, wallet);

// Or from URL directly
let contract = ContractClient::from_url_and_wallet(
    "http://localhost:8545",
    wallet,
)?;

Вызовы контрактов

Универсальный вызов контракта

let tx_hash = contract.call_contract(
    &"contract_address_64hex".to_string(),  // contract address
    b"function_name",                        // function selector
    b"encoded_arguments",                    // ABI-encoded args
    Some(0),                                 // value to send (0 for read-like)
).await?;

println!("TX hash: {}", tx_hash);

Метод call_contract:

1. Формирует данные вызова (function_selector || args)
2. Создаёт транзакцию через TransactionBuilder
3. Подписывает её кошельком
4. Отправляет через savitri_sendRawTransaction
5. Возвращает хэш транзакции

Клиент оракула

Доступ к системе оракулов для внешних потоков данных:

let oracle = contract.oracle();

// Request data from an oracle
let tx_hash = oracle.request_data(
    &"oracle_address".to_string(),
    "temperature",          // data type
    b"sensor_id_001",       // parameters
).await?;

// Submit a response (as oracle provider)
let tx_hash = oracle.submit_response(
    &"oracle_address".to_string(),
    request_id,             // u64
    b"25.5",                // response data
).await?;

// Verify data
let is_valid = oracle.verify_data(
    &"oracle_address".to_string(),
    b"data_to_verify",
).await?;

Клиент управления

Взаимодействие с системой управления на блокчейне:

let gov = contract.governance();

// Create a proposal
let tx_hash = gov.create_proposal(
    &"governance_address".to_string(),
    "Upgrade consensus parameters",    // title
    "Increase block size to 2MB",      // description
    604800,                            // voting period (seconds)
).await?;

// Vote on a proposal
let tx_hash = gov.vote(
    &"governance_address".to_string(),
    proposal_id,    // u64
    true,           // true = support, false = oppose
).await?;

// Execute an approved proposal
let tx_hash = gov.execute(
    &"governance_address".to_string(),
    proposal_id,
).await?;

// Check proposal status
let status = gov.get_proposal_status(
    &"governance_address".to_string(),
    proposal_id,
).await?;

println!("Proposal #{}: {}", status.id, status.status);
println!("Votes: {} for, {} against", status.votes_for, status.votes_against);
println!("Executed: {}", status.executed);

Поля ProposalStatus

Поле	Тип	Описание
id	u64	Идентификатор предложения
title	String	Заголовок предложения
votes_for	u64	Количество голосов за
votes_against	u64	Количество голосов против
status	String	"active", "passed", "rejected", "executed"
executed	bool	Было ли предложение выполнено