Struct RustChainClient 

pub struct RustChainClient { /* private fields */ }

The main RustChain API client.

Example

use rustchain_client::RustChainClient;

let client = RustChainClient::new("https://rustchain.org")?;
let health = client.health().await?;
println!("{:?}", health);

Implementations

impl RustChainClient

pub fn new(base_url: &str) -> Result<Self, Error>

Create a new RustChain API client.

Arguments

• base_url - The base URL of the RustChain node (e.g., "https://rustchain.org" or "https://50.28.86.131").

Accepts self-signed certificates, which is common for RustChain nodes.

pub fn with_client(base_url: &str, http: Client) -> Self

Create a client with a custom reqwest::Client.

pub async fn health(&self) -> Result<HealthResponse, Error>

Check node health.

Calls GET /health.

pub async fn epoch(&self) -> Result<EpochResponse, Error>

Get current epoch information.

Calls GET /epoch.

pub async fn miners(&self) -> Result<Vec<Miner>, Error>

List active miners on the network.

Calls GET /api/miners.

pub async fn wallet_balance(&self, wallet: &str) -> Result<WalletBalance, Error>

Check a wallet’s RTC balance.

Calls GET /wallet/balance?miner_id={wallet}.

pub async fn submit_attestation( &self, attestation: &AttestationSubmit, ) -> Result<AttestationResponse, Error>

Submit a mining attestation.

Calls POST /attest/submit.

pub async fn proposals(&self) -> Result<Vec<Proposal>, Error>

List governance proposals.

Calls GET /governance/proposals.

pub async fn proposal(&self, id: u64) -> Result<Proposal, Error>

Get a single governance proposal by ID.

Calls GET /governance/proposal/{id}.

pub async fn vote(&self, vote: &Vote) -> Result<VoteResponse, Error>

Submit a governance vote.

Calls POST /governance/vote.

pub async fn agent_jobs(&self) -> Result<AgentJobsResponse, Error>

List open Agent Economy jobs.

Calls GET /agent/jobs.

pub fn base_url(&self) -> &str

Get the base URL of this client.