Vertices Docs
  • Welcome 👨‍💻
  • ⚙️ Vertices SDK
    • Quickstart
      • Unix
        • New account
        • Pay transaction
        • Application call
      • Microcontrollers
        • PlatformIO
        • ESP-IDF
        • Zephyr (soon)
    • API Reference
      • Providers
      • Accounts
      • Events
      • Transactions
      • Applications
    • Porting guide
      • Starting from scratch
      • New vertex
      • HTTP Client
      • Handling events
Powered by GitBook
On this page
  • Create
  • Parameters
  • Return codes
  • Update
  • Parameters
  • Return codes
  • Delete
  • Parameters
  • Return codes

Was this helpful?

  1. ⚙️ Vertices SDK
  2. API Reference

Accounts

Creating accounts that will interact with the blockchain.

Using the SDK starts with creating at least one account.

Whenever a new transaction is to be done, you will need to register the new account using the public key (B32 format or binary format).

Create

ret_code_t
vertices_account_new_from_b32(
                char *public_b32,
                account_info_t **account);

Parameters

  • public_b32: string containing account address

  • account: pointer to account_info_t *

Below is the structure account_info_t

typedef struct
{
    char public_b32[PUBLIC_B32_STR_MAX_LENGTH]; //!< b32 public address, with `\0` termination character
    unsigned char public_key[ADDRESS_LENGTH];   //!< 32-bytes public key
    int32_t amount;                             //!< amount of tokens on account
} account_info_t;

Return codes

  • VTC_SUCCESS : success

  • VTC_ERROR_NO_MEM : no more room for registering a new account

Update

Request the last info on the blockchain regarding the account: amount, opted-in apps, etc...

ret_code_t
vertices_account_update(account_info_t *account);

Parameters

  • account pointer to the account, given by vertices_account_new_from_b32.

Return codes

  • VTC_SUCCESS on success

Delete

Delete the instance of the account, freeing up the spot to store another account.

ret_code_t
vertices_account_free(account_info_t *account);

Parameters

  • account given by vertices_account_add.

Return codes

  • VTC_SUCCESS on success

PreviousProvidersNextEvents

Last updated 3 years ago

Was this helpful?