34#include "status_words.h"
46#if defined(HAVE_ADDRESS_BOOK)
49#define STRUCT_VERSION 0x01
61#define REGISTER_IDENTITY_TAGS(X) \
62 X(0x01, TAG_STRUCTURE_TYPE, handle_struct_type, ENFORCE_UNIQUE_TAG) \
63 X(0x02, TAG_STRUCTURE_VERSION, handle_struct_version, ENFORCE_UNIQUE_TAG) \
64 X(0xf0, TAG_CONTACT_NAME, handle_contact_name, ENFORCE_UNIQUE_TAG) \
65 X(0xf1, TAG_SCOPE, handle_scope, ENFORCE_UNIQUE_TAG) \
66 X(0xf2, TAG_ACCOUNT_IDENTIFIER, handle_identifier, ENFORCE_UNIQUE_TAG) \
67 X(0x23, TAG_CHAIN_ID, handle_chain_id, ENFORCE_UNIQUE_TAG) \
68 X(0x51, TAG_BLOCKCHAIN_FAMILY, handle_blockchain_family, ENFORCE_UNIQUE_TAG) \
69 X(0xf6, TAG_GROUP_HANDLE, handle_group_handle, ENFORCE_UNIQUE_TAG) \
70 X(0x29, TAG_HMAC_PROOF, handle_hmac_proof, ENFORCE_UNIQUE_TAG)
89 PRINTF(
"[Register Identity] Invalid STRUCTURE_TYPE value\n");
108 PRINTF(
"[Register Identity] Invalid STRUCTURE_VERSION value\n");
128 PRINTF(
"CONTACT_NAME: failed to parse\n");
147 PRINTF(
"SCOPE: failed to parse\n");
166 PRINTF(
"IDENTIFIER: failed to extract\n");
216 PRINTF(
"[Register Identity] GROUP_HANDLE: invalid length (expected %d bytes)\n",
238 PRINTF(
"[Register Identity] HMAC_PROOF: invalid length (expected %d bytes)\n",
258 TAG_STRUCTURE_VERSION,
261 TAG_ACCOUNT_IDENTIFIER,
262 TAG_BLOCKCHAIN_FAMILY);
264 PRINTF(
"Missing mandatory fields in Register Identity descriptor!\n");
270 PRINTF(
"Missing CHAIN_ID for Ethereum family in Register Identity descriptor!\n");
277 if (has_group_handle != has_hmac_proof) {
278 PRINTF(
"GROUP_HANDLE and HMAC_PROOF must be provided together!\n");
293 PRINTF(
"****************************************************************************\n");
294 PRINTF(
"[Register Identity] - Retrieved Descriptor:\n");
295 PRINTF(
"[Register Identity] - Contact name: %s\n",
298 PRINTF(
"[Register Identity] - Contact scope: %s\n",
301 PRINTF(
"[Register Identity] - Blockchain family: %s\n",
304 PRINTF(
"[Register Identity] - Chain ID: %llu\n",
325 uint8_t hmac_proof[CX_SHA256_SIZE] = {0};
326 uint8_t hmac_rest[CX_SHA256_SIZE] = {0};
339 PRINTF(
"[Register Identity] Error: Failed to compute HMAC_REST for new address\n");
344 memmove(hmac_proof,
g_ab_payload.reg.hmac_proof, CX_SHA256_SIZE);
348 PRINTF(
"[Register Identity] Error: Failed to generate group handle\n");
352 const uint8_t *gid = group_handle;
354 gid,
g_ab_payload.reg.identity.contact_name, hmac_proof)) {
355 PRINTF(
"[Register Identity] Error: Failed to compute HMAC_PROOF\n");
365 PRINTF(
"[Register Identity] Error: Failed to compute HMAC_REST\n");
372 explicit_bzero(group_handle,
sizeof(group_handle));
373 explicit_bzero(hmac_proof,
sizeof(hmac_proof));
374 explicit_bzero(hmac_rest,
sizeof(hmac_rest));
388 PRINTF(
"[Register Identity] Error: Failed to build and send HMAC proof\n");
391 "Saved to your Contacts",
392 "Error during registration",
412 "Review contact details",
413#ifdef SCREEN_SIZE_WALLET
414 "Confirm contact details?",
416 "Confirm contact details",
432 const buffer_t payload = {.ptr = buffer_in, .size = buffer_in_length};
440 if (!identity_tlv_parser(&payload, &ctx, &ctx.
received_tags)) {
441 PRINTF(
"[Register Identity] Failed to parse TLV payload\n");
442 return SWO_INCORRECT_DATA;
445 return SWO_INCORRECT_DATA;
456 PRINTF(
"[Register Identity] Error: Group handle verification failed\n");
457 return SWO_SECURITY_CONDITION_NOT_SATISFIED;
462 PRINTF(
"[Register Identity] Error: HMAC_PROOF verification failed\n");
463 return SWO_SECURITY_CONDITION_NOT_SATISFIED;
469 PRINTF(
"[Register Identity] Error: Identity rejected by coin application\n");
470 return SWO_WRONG_PARAMETER_VALUE;
475 return SWO_NO_RESPONSE;
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.
void address_book_handle_review_rejected(nbgl_callback_t finalize)
Common handling of a rejected Address Book review.
bool address_book_handle_blockchain_family(const tlv_data_t *data, blockchain_family_e *family)
Generic handler for blockchain family.
ab_payload_u g_ab_payload
bool address_book_handle_printable_string(const tlv_data_t *data, char *output_buffer, size_t buffer_size)
Generic handler for printable string extraction.
bool address_book_handle_chain_id(const tlv_data_t *data, uint64_t *chain_id)
Generic handler for chain ID.
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.
bool address_book_send_register_identity_response(const uint8_t group_handle[GROUP_HANDLE_SIZE], const uint8_t hmac_proof[CX_SHA256_SIZE], const uint8_t hmac_rest[CX_SHA256_SIZE])
Send the Register Identity response carrying the group handle and both HMACs.
bool address_book_compute_hmac_rest(const uint8_t gid[GID_SIZE], const char *scope, const uint8_t *identifier, uint8_t identifier_len, blockchain_family_e family, uint64_t chain_id, uint8_t hmac_out[CX_SHA256_SIZE])
Compute HMAC_REST for an Identity contact.
bool address_book_compute_hmac_proof(const uint8_t gid[GID_SIZE], const char *name, uint8_t hmac_out[CX_SHA256_SIZE])
Compute HMAC_PROOF for an Identity contact.
bool address_book_verify_hmac_proof(const uint8_t gid[GID_SIZE], const char *name, const uint8_t hmac_expected[CX_SHA256_SIZE])
Verify HMAC_PROOF for an Identity contact.
bool address_book_generate_group_handle(uint8_t group_handle[GROUP_HANDLE_SIZE])
Generate a device-authenticated group handle.
bool address_book_verify_group_handle(const uint8_t group_handle[GROUP_HANDLE_SIZE], uint8_t gid_out[GID_SIZE])
Verify a group handle and extract the gid.
void finalize_ui_register_identity(void)
Handle called to finalize the UI flow for registering an Identity.
bool handle_check_register_identity(identity_t *params)
Handle called to validate the received Identity.
nbgl_contentTagValue_t * get_register_identity_tagValue(uint8_t pairIndex)
Callback to retrieve a tag-value pair for the Register Identity UI.
Register / Edit Contact Name / Edit Scope / Edit Identifier.
#define TYPE_REGISTER_IDENTITY
#define GROUP_HANDLE_SIZE
group_handle = gid(32) | MAC(K_group, gid)(32)
#define IDENTIFIER_MAX_LENGTH
blockchain address or public key, raw bytes
static bool handle_contact_name(const tlv_data_t *data, void *context_ptr)
Handler for tag CONTACT_NAME.
static bool handle_blockchain_family(const tlv_data_t *data, void *context_ptr)
Handler for tag BLOCKCHAIN_FAMILY.
static bool handle_hmac_proof(const tlv_data_t *data, void *context_ptr)
Handler for tag HMAC_PROOF (optional — proves ownership of an existing group).
static void review_choice(bool confirm)
NBGL callback invoked after the user confirms or rejects the registration.
bolos_err_t register_identity(uint8_t *buffer_in, size_t buffer_in_length)
Register a new identity.
static bool handle_struct_type(const tlv_data_t *data, void *context_ptr)
Handler for tag STRUCTURE_TYPE.
static bool handle_scope(const tlv_data_t *data, void *context_ptr)
Handler for tag SCOPE.
static bool handle_chain_id(const tlv_data_t *data, void *context_ptr)
Handler for tag CHAIN_ID.
static bool build_and_send_response(void)
Build and send response.
static bool handle_struct_version(const tlv_data_t *data, void *context_ptr)
Handler for tag STRUCTURE_VERSION.
static bool handle_identifier(const tlv_data_t *data, void *context_ptr)
Handler for tag ACCOUNT_IDENTIFIER.
static bool handle_group_handle(const tlv_data_t *data, void *context_ptr)
Handler for tag GROUP_HANDLE (optional — links to an existing group).
static void print_payload(const s_identity_ctx *context)
Print the received descriptor.
static bool verify_fields(const s_identity_ctx *context)
Check that all mandatory TLV tags were received.
#define REGISTER_IDENTITY_TAGS(X)
API of the Advanced BOLOS Graphical Library, for typical application use-cases.
size_t size
Pointer to byte buffer.
blockchain_family_e blockchain_family
uint64_t chain_id
Mandatory when blockchain_family == FAMILY_ETHEREUM.
uint8_t identifier[IDENTIFIER_MAX_LENGTH]
char contact_name[CONTACT_NAME_LENGTH]
s_register_state_t * state
TLV_reception_t received_tags
uint8_t group_handle[GROUP_HANDLE_SIZE]
uint8_t hmac_proof[CX_SHA256_SIZE]
bool tlv_enforce_u8_value(const tlv_data_t *data, uint8_t expected_value)
Enforce that a TLV data contains the expected uint8 value.
bool get_buffer_from_tlv_data(const tlv_data_t *data, buffer_t *out, uint16_t min_size, uint16_t max_size)
Extract a sized buffer from TLV data (zero-copy).
TLV_reception_internal_t TLV_reception_t
#define DEFINE_TLV_PARSER(TAG_LIST, COMMON_HANDLER, PARSE_FUNCTION_NAME)
Creates a parser function for a given TLV use case.
struct tlv_data_s tlv_data_t
#define TLV_CHECK_RECEIVED_TAGS(received,...)