c_stellar_sdk is a header-only lightweight pure C library to interface with the Stellar Horizon API server, suitable for doing high-performance analytics on Stellar data.
The project lives on Github.
Documentation is here.
Capabilities
With c_stellar_sdk you can:
- Query the state of the network: accounts, ledgers, transactions, operations, effects, payments, orderbooks, offers
- Get data from the Stellar descentralized exchange: prices, orders, trades (coming soon!)
- Submit transactions to the network (coming soon!)
Examples
For all example, see the docs.
View account balances (all assets)
#include "stellar_sdk.h"
int main(){
struct xlm_Horizon horizon;
xlm_horizon_init(&horizon, XLM_HORIZON_LIVE); // Or `XLM_HORIZON_TESTNET`
struct xlm_Response response;
xlm_response_init(&response);
struct xlm_Request_params request_params = {
.account_id = "GB7JKG66CJN3ACX5DX43FOZTTSOI7GZUP547I3BSXIJVUX3NRYUXHE6W",
};
xlm_account(&horizon, &response, &request_params); // Send request!
xlm_JSON* json_root = json_parse(response.raw); // Parse a raw JSON string!
xlm_JSON* json_balances = json_get(json_root, "balances");
json_show(json_balances);
m_sep();
for(uint i=0; i<json_get_array_len(json_balances); ++i){
xlm_JSON* json_balance_item = json_get_array_item(json_balances, i);
xlm_JSON* json_balance = json_get(json_balance_item, "balance");
xlm_JSON* json_asset_type = json_get(json_balance_item, "asset_type");
printf("%s %s\n", json_asset_type->valuestring, json_balance->valuestring);
}
json_free(json_root); // Deleting the root takes care of everything
xlm_response_free(&response);
xlm_horizon_free(&horizon);
m_exit_success();
}
Show all ledgers in the (returned) records
#include "stellar_sdk.h"
int main(){
struct xlm_Horizon horizon;
xlm_horizon_init(&horizon, XLM_HORIZON_LIVE); // Or `XLM_HORIZON_TESTNET`
struct xlm_Response response;
xlm_response_init(&response);
struct xlm_Request_params request_params = {
.cursor = 60496199207092224,
.order = "desc",
.limit = 4,
};
xlm_ledgers(&horizon, &response, &request_params); // Send request!
xlm_JSON* json_root = json_parse(response.raw); // Parse a raw JSON string!
xlm_JSON* json_embedded = json_get(json_root, "_embedded");
xlm_JSON* json_records = json_get(json_embedded, "records");
json_show(json_records);
uint n_records = json_get_array_len(json_records);
m_sep();
for(uint i=0; i<n_records; ++i){ // Grab all ledgers from the records!
xlm_JSON* json_record = json_get_array_item(json_records, i);
struct xlm_Ledger ledger;
xlm_ledger_from_json(&ledger, json_record);
puts(""); xlm_ledger_show(&ledger); // Show the ledger object from its internal format
}
json_free(json_root); // Deleting the root takes care of everything
xlm_response_free(&response);
xlm_horizon_free(&horizon);
m_exit_success();
}
Roadmap
- Perform operations (eg.
change_trust, manage_offer)
- Build, sign & submit transactions
- Decode XDR blobs
- Write a high-level API for event streams (currently accessible by low-level routines)
- Write a high-level API for async requests (currently accessible by low-level routines)
- Write tests
Documentation screenshots
