aergo.h

#include <stdint.h>
#include <stdbool.h>


#ifdef _WIN32
#define EXPORTED __declspec(dllexport)
#else
#define EXPORTED __attribute__((visibility("default")))
#endif

// Library version in string format

EXPORTED char * aergo_lib_version();


// Connection

typedef struct aergo aergo;

EXPORTED aergo * aergo_connect(const char *host, int port);

EXPORTED void aergo_free(aergo *instance);

EXPORTED int aergo_process_requests(aergo *instance, int timeout);


// Accounts

typedef struct aergo_account aergo_account;

struct aergo_account {
  bool use_ledger;
  int  index;
  unsigned char privkey[32];
  unsigned char pubkey[33];
  char address[64];
  uint64_t nonce;
  double balance;
  uint8_t state_root[32];
  bool is_updated;
};

EXPORTED bool aergo_check_privkey(aergo *instance, aergo_account *account);

/* the error string buffer must be at least 256 bytes in size */
EXPORTED bool aergo_get_account_state(aergo *instance, aergo_account *account, char *error);


// Transaction Receipt

typedef struct transaction_receipt transaction_receipt;

struct transaction_receipt {
  char contractAddress[56];  // in expanded/string form
  char status[16];
  char ret[2048];
  uint64_t blockNo;
  char blockHash[32];
  int32_t txIndex;
  char txHash[32];
  uint64_t gasUsed;
  double feeUsed;
  bool feeDelegation;
};

typedef void (*transaction_receipt_cb)(void *arg, transaction_receipt *receipt);

EXPORTED bool aergo_get_receipt(aergo *instance,
  const char *txn_hash,
  struct transaction_receipt *receipt);

EXPORTED bool aergo_get_receipt_async(aergo *instance,
  const char *txn_hash,
  transaction_receipt_cb cb,
  void *arg);


// Transfer - synchronous

EXPORTED bool aergo_transfer(aergo *instance,
  transaction_receipt *receipt,
  aergo_account *from_account,
  const char *to_account,
  double value);

EXPORTED bool aergo_transfer_int(aergo *instance,
  transaction_receipt *receipt,
  aergo_account *from_account,
  const char *to_account,
  uint64_t integer,
  uint64_t decimal);

EXPORTED bool aergo_transfer_str(aergo *instance,
  transaction_receipt *receipt,
  aergo_account *from_account,
  const char *to_account,
  const char *value);

EXPORTED bool aergo_transfer_bignum(aergo *instance,
  transaction_receipt *receipt,
  aergo_account *from_account,
  const char *to_account,
  const unsigned char *amount,
  int len);

// Transfer - asynchronous

EXPORTED bool aergo_transfer_async(aergo *instance,
  transaction_receipt_cb cb,
  void *arg,
  aergo_account *from_account,
  const char *to_account,
  double value);

EXPORTED bool aergo_transfer_int_async(aergo *instance,
  transaction_receipt_cb cb,
  void *arg,
  aergo_account *from_account,
  const char *to_account,
  uint64_t integer,
  uint64_t decimal);

EXPORTED bool aergo_transfer_str_async(aergo *instance,
  transaction_receipt_cb cb,
  void *arg,
  aergo_account *from_account,
  const char *to_account,
  const char *value);

EXPORTED bool aergo_transfer_bignum_async(aergo *instance,
  transaction_receipt_cb cb,
  void *arg,
  aergo_account *from_account,
  const char *to_account,
  const unsigned char *amount,
  int len);



// Call smart contract function - synchronous

EXPORTED bool aergo_call_smart_contract_json(aergo *instance,
  transaction_receipt *receipt,
  aergo_account *account,
  const char *contract_address,
  const char *function,
  const char *args);

EXPORTED bool aergo_call_smart_contract(aergo *instance,
  transaction_receipt *receipt,
  aergo_account *account,
  const char *contract_address,
  const char *function,
  const char *types,
  ...);

// Call smart contract function - asynchronous

EXPORTED bool aergo_call_smart_contract_json_async(aergo *instance,
  transaction_receipt_cb cb,
  void *arg,
  aergo_account *account,
  const char *contract_address,
  const char *function,
  const char *args);

EXPORTED bool aergo_call_smart_contract_async(aergo *instance,
  transaction_receipt_cb cb,
  void *arg,
  aergo_account *account,
  const char *contract_address,
  const char *function,
  const char *types,
  ...);



// MultiCall - synchronous

EXPORTED bool aergo_multicall(aergo *instance,
  transaction_receipt *receipt,
  aergo_account *account,
  const char *payload);

// MultiCall - asynchronous

EXPORTED bool aergo_multicall_async(aergo *instance,
  transaction_receipt_cb cb,
  void *arg,
  aergo_account *account,
  const char *payload);



// Query smart contract - synchronous

EXPORTED bool aergo_query_smart_contract_json(aergo *instance,
  char *result,
  int resultlen,
  const char *contract_address,
  const char *function,
  const char *args);

EXPORTED bool aergo_query_smart_contract(aergo *instance,
  char *result,
  int resultlen,
  const char *contract_address,
  const char *function,
  const char *types,
  ...);

// Query smart contract - asynchronous

typedef void (*query_smart_contract_cb)(void *arg, bool success, char *result);

EXPORTED bool aergo_query_smart_contract_json_async(aergo *instance,
  query_smart_contract_cb cb,
  void *arg,
  const char *contract_address,
  const char *function,
  const char *args);

EXPORTED bool aergo_query_smart_contract_async(aergo *instance,
  query_smart_contract_cb cb,
  void *arg,
  const char *contract_address,
  const char *function,
  const char *types,
  ...);


// Query smart contract state variable - synchronous

EXPORTED bool aergo_query_smart_contract_state_variable(aergo *instance,
  char *result,
  int resultlen,
  const char *contract_address,
  const char *state_var);

// Query smart contract state variable - asynchronous

typedef void (*query_state_var_cb)(void *arg, bool success, char *result);

EXPORTED bool aergo_query_smart_contract_state_variable_async(aergo *instance,
  query_state_var_cb cb,
  void *arg,
  const char *contract_address,
  const char *state_var);


// Smart contract events

typedef struct contract_event contract_event;

struct contract_event {
  char contractAddress[64];
  char eventName[64];
  char jsonArgs[2048];
  int32_t eventIdx;
  char txHash[32];
  char blockHash[32];
  uint64_t blockNo;
  int32_t txIndex;
};

typedef void (*contract_event_cb)(void *arg, contract_event *event);

EXPORTED bool aergo_contract_events_subscribe(aergo *instance,
  const char *contract_address,
  const char *event_name,
  contract_event_cb cb,
  void *arg);


// Blocks

EXPORTED bool aergo_get_block(aergo *instance, uint64_t block_number);


typedef void (*block_stream_cb)(uint64_t block_number, uint64_t timestamp);

EXPORTED bool aergo_block_stream_subscribe(aergo *instance, block_stream_cb cb);


// Status

EXPORTED bool aergo_get_blockchain_status(aergo *instance);