C++

The C++ SDK is the C++ client for the antd daemon.

Install

include(FetchContent)
FetchContent_Declare(
    antd-cpp
    GIT_REPOSITORY https://github.com/WithAutonomi/ant-sdk.git
    SOURCE_SUBDIR  antd-cpp
)
FetchContent_MakeAvailable(antd-cpp)

target_link_libraries(your_target PRIVATE antd)

Connect to the daemon

#include "antd/antd.hpp"

int main() {
    antd::Client client("http://localhost:8082");
    auto health = client.health();
    return health.ok ? 0 : 1;
}

Store and retrieve data

#include "antd/antd.hpp"
#include <iostream>

int main() {
    antd::Client client;
    std::string msg = "Hello, Autonomi!";
    std::vector<uint8_t> data(msg.begin(), msg.end());

    auto result = client.data_put_public(data);
    std::cout << result.address << std::endl;

    auto retrieved = client.data_get_public(result.address);
    std::string text(retrieved.begin(), retrieved.end());
    std::cout << text << std::endl;
}

Type mappings

Autonomi type	C++ type
HealthStatus	struct with ok and network
PutResult	struct with cost and address
Raw data	std::vector<uint8_t>

Error handling

try {
    auto data = client.data_get_public("bad-address");
} catch (const antd::NotFoundError& e) {
    std::cerr << e.what() << std::endl;
} catch (const antd::PaymentError& e) {
    std::cerr << e.what() << std::endl;
} catch (const antd::AntdError& e) {
    std::cerr << e.what() << std::endl;
}

Full API reference

For all available daemon endpoints, see the REST API.