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

1
ret_code_t
2
vertices_account_new_from_b32(
3
char *public_b32,
4
account_info_t **account);
Copied!

Parameters

    public_b32: string containing account address
    account: pointer to account_info_t *
Below is the structure account_info_t
1
typedef struct
2
{
3
char public_b32[PUBLIC_B32_STR_MAX_LENGTH]; //!< b32 public address, with `\0` termination character
4
unsigned char public_key[ADDRESS_LENGTH]; //!< 32-bytes public key
5
int32_t amount; //!< amount of tokens on account
6
} account_info_t;
Copied!

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...
1
ret_code_t
2
vertices_account_update(account_info_t *account);
Copied!

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.
1
ret_code_t
2
vertices_account_free(account_info_t *account);
Copied!

Parameters

    account given by vertices_account_add.

Return codes

    VTC_SUCCESS on success
Last modified 4mo ago