Struct TitanClient

pub struct TitanClient { /* private fields */ }

A client for your HTTP server.

Implementations

impl Client

pub fn new(base_url: &str) -> Self

Create a new client with the given base URL (e.g. “http://localhost:3030”).

pub async fn get_status(&self) -> Result<Status, Box<dyn Error>>

GET /status

pub async fn get_tip(&self) -> Result<BlockTip, Box<dyn Error>>

GET /tip

pub async fn get_block(&self, query: &str) -> Result<Block, Box<dyn Error>>

GET /block/{query}

pub async fn get_address( &self, address: &str, ) -> Result<AddressData, Box<dyn Error>>

GET /address/{address}

pub async fn get_transaction( &self, txid: &str, ) -> Result<Transaction, Box<dyn Error>>

GET /tx/{txid} Returns a structured bitcoin Transaction (JSON).

pub async fn get_transaction_with_runes( &self, txid: &str, ) -> Result<Transaction, Box<dyn Error>>

Same as get_transaction but always requests runes (with_runes=true).

pub async fn get_transaction_raw( &self, txid: &str, ) -> Result<Vec<u8>, Box<dyn Error>>

GET /tx/{txid}/raw Returns the raw transaction bytes (content-type: application/octet-stream).

pub async fn get_transaction_hex( &self, txid: &str, ) -> Result<String, Box<dyn Error>>

GET /tx/{txid}/hex Returns a text/plain body containing hex-encoded raw transaction.

pub async fn broadcast_transaction( &self, tx_hex: String, ) -> Result<Txid, Box<dyn Error>>

POST /tx/broadcast Broadcast a raw transaction (in hex form) to the network.

pub async fn get_output( &self, outpoint: &str, ) -> Result<TxOutEntry, Box<dyn Error>>

GET /output/{outpoint}

pub async fn get_inscription( &self, inscription_id: &str, ) -> Result<(HeaderMap, Vec<u8>), Box<dyn Error>>

GET /inscription/{inscription_id} Returns (Headers, Bytes). The server sets content-type and possibly compression, and the body is the raw inscription content.

pub async fn get_runes( &self, pagination: Option<Pagination>, ) -> Result<PaginationResponse<RuneResponse>, Box<dyn Error>>

GET /runes?skip=&limit=

pub async fn get_rune(&self, rune: &str) -> Result<RuneResponse, Box<dyn Error>>

GET /rune/{rune}

pub async fn get_rune_transactions( &self, rune: &str, pagination: Option<Pagination>, ) -> Result<PaginationResponse<Txid>, Box<dyn Error>>

GET /rune/{rune}/transactions?skip=&limit=

pub async fn get_mempool_txids(&self) -> Result<Vec<Txid>, Box<dyn Error>>

GET /mempool/txids

pub async fn get_subscription( &self, id: &str, ) -> Result<Subscription, Box<dyn Error>>

GET /subscription/{id}

pub async fn list_subscriptions( &self, ) -> Result<Vec<Subscription>, Box<dyn Error>>

GET /subscriptions

pub async fn add_subscription( &self, subscription: &Subscription, ) -> Result<Subscription, Box<dyn Error>>

POST /subscription

pub async fn delete_subscription(&self, id: &str) -> Result<(), Box<dyn Error>>

DELETE /subscription/{id}