Embedded SDK
Embedded SDK
Loading...
Searching...
No Matches
address_book_common.c File Reference

Shared helpers for all Address Book sub-commands. More...

#include <string.h>
#include "address_book_common.h"
#include "os_utils.h"
#include "os_print.h"
#include "buffer.h"
#include "tlv_library.h"
#include "bip32.h"
#include "address_book.h"
#include "io.h"
#include "status_words.h"
#include "nbgl_use_case.h"
Include dependency graph for address_book_common.c:

Go to the source code of this file.

Functions

bool address_book_handle_derivation_path (const tlv_data_t *data, path_bip32_t *bip32_path)
 Generic handler for BIP32 derivation path.
bool address_book_handle_chain_id (const tlv_data_t *data, uint64_t *chain_id)
 Generic handler for chain ID.
bool address_book_handle_blockchain_family (const tlv_data_t *data, blockchain_family_e *family)
 Generic handler for blockchain family.
bool address_book_handle_printable_string (const tlv_data_t *data, char *output_buffer, size_t buffer_size)
 Generic handler for printable string extraction.
void address_book_display_review (const nbgl_icon_details_t *icon, const char *reviewTitle, const char *confirmText, nbgl_choiceCallback_t choiceCallback)
 Display a confirmation review for an Address Book operation.
void address_book_handle_review_rejected (nbgl_callback_t finalize)
 Common handling of a rejected Address Book review.
void address_book_finalize_review (bool success, const char *successMsg, const char *errorMsg, nbgl_callback_t finalize)
 Common handling of a confirmed Address Book review's outcome.

Variables

ab_payload_u g_ab_payload = {0}
ab_ui_t g_ab_ui = {0}

Detailed Description

Shared helpers for all Address Book sub-commands.

Provides reusable TLV field handlers used across every TLV-based flow:

Definition in file address_book_common.c.

Function Documentation

◆ address_book_display_review()

void address_book_display_review ( const nbgl_icon_details_t * icon,
const char * reviewTitle,
const char * confirmText,
nbgl_choiceCallback_t choiceCallback )

Display a confirmation review for an Address Book operation.

Uses ab_ui_t::list as the tag/value list (already populated by the caller). Sets wrapping = true and delegates to nbgl_useCaseReviewLight().

Parameters
[in]iconIcon shown on the title page (typically &LARGE_ADDRESS_BOOK_ICON, may be NULL)
[in]reviewTitleTitle of the review
[in]confirmTextText shown on the confirmation page
[in]choiceCallbackCallback invoked with the user's choice

Definition at line 149 of file address_book_common.c.

◆ address_book_finalize_review()

void address_book_finalize_review ( bool success,
const char * successMsg,
const char * errorMsg,
nbgl_callback_t finalize )

Common handling of a confirmed Address Book review's outcome.

On success, displays a success status with successMsg. On failure, sends SWO_INCORRECT_DATA and displays an error status with errorMsg. In both cases finalize is invoked once the status screen is dismissed.

Parameters
[in]successResult of the operation (e.g. HMAC build & send)
[in]successMsgStatus message to display on success
[in]errorMsgStatus message to display on failure
[in]finalizeCallback invoked once the status screen is dismissed

Definition at line 193 of file address_book_common.c.

◆ address_book_handle_blockchain_family()

bool address_book_handle_blockchain_family ( const tlv_data_t * data,
blockchain_family_e * family )

Generic handler for blockchain family.

Parameters
[in]dataTLV data
[out]familyPointer to blockchain family enum to fill
Returns
true if successful

Definition at line 94 of file address_book_common.c.

◆ address_book_handle_chain_id()

bool address_book_handle_chain_id ( const tlv_data_t * data,
uint64_t * chain_id )

Generic handler for chain ID.

Parameters
[in]dataTLV data
[out]chain_idPointer to chain ID variable to fill
Returns
true if successful

Definition at line 78 of file address_book_common.c.

◆ address_book_handle_derivation_path()

bool address_book_handle_derivation_path ( const tlv_data_t * data,
path_bip32_t * bip32_path )

Generic handler for BIP32 derivation path.

Parameters
[in]dataTLV data
[out]bip32_pathPointer to BIP32 path structure to fill
Returns
true if successful

Definition at line 53 of file address_book_common.c.

◆ address_book_handle_printable_string()

bool address_book_handle_printable_string ( const tlv_data_t * data,
char * output_buffer,
size_t buffer_size )

Generic handler for printable string extraction.

Extracts a string from TLV data and verifies it contains only printable characters, with at least one visible character: a string made only of spaces is refused, as it would show as blank on screen.

Parameters
[in]dataTLV data
[out]output_bufferBuffer to store the extracted string
[in]buffer_sizeMaximum size of the output buffer (including null terminator)
Returns
true if successful

Definition at line 121 of file address_book_common.c.

◆ address_book_handle_review_rejected()

void address_book_handle_review_rejected ( nbgl_callback_t finalize)

Common handling of a rejected Address Book review.

Sends SWO_INCORRECT_DATA and displays the standard STATUS_TYPE_OPERATION_REJECTED status, then invokes finalize.

Parameters
[in]finalizeCallback invoked once the status screen is dismissed

Definition at line 174 of file address_book_common.c.

Variable Documentation

◆ g_ab_payload

ab_payload_u g_ab_payload = {0}

Definition at line 43 of file address_book_common.c.

◆ g_ab_ui

ab_ui_t g_ab_ui = {0}

Definition at line 44 of file address_book_common.c.