eth_rpc.h

Go to the documentation of this file.

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

 
#ifndef ETH_RPC_H
#define ETH_RPC_H
 
/******************************************************************
 * 1. Included files
 ******************************************************************/
 
#include <stdint.h>
#include <stddef.h>
#include <stdbool.h>
 
#include "eth_json.h"   /* eth_receipt_expect_t */
 
#ifdef __cplusplus
extern "C" {
#endif
 
/******************************************************************
 * 2. Types
 ******************************************************************/

typedef enum {
    ETH_RPC_RECEIPT_PENDING,   
    ETH_RPC_RECEIPT_SUCCESS,   
    ETH_RPC_RECEIPT_REVERTED,  
    ETH_RPC_RECEIPT_RPC_ERROR, 
    ETH_RPC_RECEIPT_MISMATCH,  
} eth_rpc_receipt_result_t;
 
/******************************************************************
 * 3. Public API
 ******************************************************************/

void eth_rpc_init(const char *rpc_url, const char *from_addr);

bool eth_rpc_set_from(const char *addr);

void eth_rpc_set_auth(const char *project_id, const char *api_secret);

void eth_rpc_set_ca_cert(const char *ca_pem);

bool eth_rpc_get_nonce(uint64_t *nonce_out);

bool eth_rpc_get_balance(uint64_t *wei_out);

bool eth_rpc_get_token_balance(const char *token_addr, uint64_t *units_out);

bool eth_rpc_get_token_decimals(const char *token_addr, uint64_t *dec_out);

bool eth_rpc_send_raw_tx(const uint8_t *tx, size_t tx_len,
                          char *tx_hash_out, size_t tx_hash_max,
                          char *err_out, size_t err_max);

eth_rpc_receipt_result_t eth_rpc_get_tx_receipt(const eth_receipt_expect_t *want);

bool eth_rpc_err_already_known(const char *node_err);
 
#ifdef __cplusplus
}
#endif
 
#endif // ETH_RPC_H