tron_rpc.h

Go to the documentation of this file.

/*
 * SPDX-License-Identifier: LGPL-3.0-or-later
 * Copyright (c) 2026 Cryptnox SA
 */

 
#ifndef TRON_RPC_H
#define TRON_RPC_H
 
#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif

#define TRON_RAW_HEX_MAX  768U

typedef struct {
    uint8_t txid[32];                    
    char    txid_hex[65];                
    char    raw_hex[TRON_RAW_HEX_MAX];   
    uint64_t expiration_ms;              
} tron_tx_ctx_t;

typedef enum {
    TRON_RECEIPT_PENDING,    
    TRON_RECEIPT_SUCCESS,    
    TRON_RECEIPT_FAILED,     
    TRON_RECEIPT_RPC_ERROR,  
} tron_receipt_t;

void tron_rpc_init(const char *base_url);

void tron_rpc_set_ca_cert(const char *ca_pem);

bool tron_rpc_get_balance(const char *owner_hex, uint64_t *sun_out);

bool tron_rpc_get_energy(const char *owner_hex, uint64_t *energy_out);

bool tron_rpc_get_trc20_balance(const char *owner_hex, const char *contract_hex,
                                uint64_t *units_out);

bool tron_rpc_get_trc20_decimals(const char *contract_hex, uint64_t *dec_out);

bool tron_rpc_create_transfer(const char *owner_hex, const char *to_hex,
                              uint64_t amount_sun, tron_tx_ctx_t *out);

bool tron_rpc_create_trc20_transfer(const char *owner_hex,
                                    const char *contract_hex,
                                    const char *to_hex, uint64_t amount,
                                    uint64_t fee_limit_sun,
                                    tron_tx_ctx_t *out);

bool tron_rpc_broadcast(const tron_tx_ctx_t *tx, const uint8_t sig[65]);

tron_receipt_t tron_rpc_get_receipt(const char *txid_hex);
 
#ifdef __cplusplus
}
#endif
 
#endif /* TRON_RPC_H */