Embedded SDK
Embedded SDK
Loading...
Searching...
No Matches
tlv_use_case_transaction_check.h File Reference
#include "tlv_library.h"
#include "buffer.h"
Include dependency graph for tlv_use_case_transaction_check.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes

struct  tlv_transaction_check_out_s

Macros

#define TRANSACTION_CHECK_HASH_SIZE   CX_SHA3_256_SIZE
#define TRANSACTION_CHECK_MSG_SIZE   25
#define TRANSACTION_CHECK_URL_SIZE   30
#define TRANSACTION_CHECK_MIN_ADDRESS_SIZE   20
#define TRANSACTION_CHECK_MAX_ADDRESS_SIZE   44
#define TRANSACTION_CHECK_PARTNER_SIZE   20

Typedefs

typedef enum transaction_check_risk_e transaction_check_risk_t
typedef enum transaction_check_type_e transaction_check_type_t
typedef enum transaction_check_category_e transaction_check_category_t
typedef struct tlv_transaction_check_out_s tlv_transaction_check_out_t
typedef enum tlv_transaction_check_status_e tlv_transaction_check_status_t

Enumerations

enum  transaction_check_risk_e { TRANSACTION_CHECK_RISK_BENIGN = 0x00 , TRANSACTION_CHECK_RISK_WARNING = 0x01 , TRANSACTION_CHECK_RISK_MALICIOUS = 0x02 , TRANSACTION_CHECK_RISK_COUNT }
enum  transaction_check_type_e { TRANSACTION_CHECK_TYPE_TRANSACTION = 0x00 , TRANSACTION_CHECK_TYPE_TYPED_DATA = 0x01 , TRANSACTION_CHECK_TYPE_COUNT }
enum  transaction_check_category_e {
  TRANSACTION_CHECK_CATEGORY_NA = 0x00 , TRANSACTION_CHECK_CATEGORY_OTHERS = 0x01 , TRANSACTION_CHECK_CATEGORY_ADDRESS = 0x02 , TRANSACTION_CHECK_CATEGORY_DAPP = 0x03 ,
  TRANSACTION_CHECK_CATEGORY_LOSING_OPERATION = 0x04 , TRANSACTION_CHECK_CATEGORY_COUNT
}
enum  tlv_transaction_check_status_e {
  TLV_TRANSACTION_CHECK_SUCCESS = 0 , TLV_TRANSACTION_CHECK_PARSING_ERROR = 1 , TLV_TRANSACTION_CHECK_MISSING_STRUCTURE_TAG = 2 , TLV_TRANSACTION_CHECK_WRONG_TYPE = 3 ,
  TLV_TRANSACTION_CHECK_MISSING_TAG = 4 , TLV_TRANSACTION_CHECK_UNKNOWN_VERSION = 5 , TLV_TRANSACTION_CHECK_SIGNATURE_ERROR = 0x80
}

Functions

tlv_transaction_check_status_t tlv_use_case_transaction_check (const buffer_t *payload, tlv_transaction_check_out_t *out)
 Parse a Transaction Check TLV payload.

Macro Definition Documentation

◆ TRANSACTION_CHECK_HASH_SIZE

#define TRANSACTION_CHECK_HASH_SIZE   CX_SHA3_256_SIZE

Definition at line 35 of file tlv_use_case_transaction_check.h.

◆ TRANSACTION_CHECK_MAX_ADDRESS_SIZE

#define TRANSACTION_CHECK_MAX_ADDRESS_SIZE   44

Definition at line 40 of file tlv_use_case_transaction_check.h.

◆ TRANSACTION_CHECK_MIN_ADDRESS_SIZE

#define TRANSACTION_CHECK_MIN_ADDRESS_SIZE   20

Definition at line 39 of file tlv_use_case_transaction_check.h.

◆ TRANSACTION_CHECK_MSG_SIZE

#define TRANSACTION_CHECK_MSG_SIZE   25

Definition at line 36 of file tlv_use_case_transaction_check.h.

◆ TRANSACTION_CHECK_PARTNER_SIZE

#define TRANSACTION_CHECK_PARTNER_SIZE   20

Definition at line 42 of file tlv_use_case_transaction_check.h.

◆ TRANSACTION_CHECK_URL_SIZE

#define TRANSACTION_CHECK_URL_SIZE   30

Definition at line 37 of file tlv_use_case_transaction_check.h.

Typedef Documentation

◆ tlv_transaction_check_out_t

◆ tlv_transaction_check_status_t

◆ transaction_check_category_t

◆ transaction_check_risk_t

◆ transaction_check_type_t

Enumeration Type Documentation

◆ tlv_transaction_check_status_e

Enumerator
TLV_TRANSACTION_CHECK_SUCCESS 
TLV_TRANSACTION_CHECK_PARSING_ERROR 
TLV_TRANSACTION_CHECK_MISSING_STRUCTURE_TAG 
TLV_TRANSACTION_CHECK_WRONG_TYPE 
TLV_TRANSACTION_CHECK_MISSING_TAG 
TLV_TRANSACTION_CHECK_UNKNOWN_VERSION 
TLV_TRANSACTION_CHECK_SIGNATURE_ERROR 

Definition at line 97 of file tlv_use_case_transaction_check.h.

◆ transaction_check_category_e

Enumerator
TRANSACTION_CHECK_CATEGORY_NA 
TRANSACTION_CHECK_CATEGORY_OTHERS 
TRANSACTION_CHECK_CATEGORY_ADDRESS 
TRANSACTION_CHECK_CATEGORY_DAPP 
TRANSACTION_CHECK_CATEGORY_LOSING_OPERATION 
TRANSACTION_CHECK_CATEGORY_COUNT 

Definition at line 57 of file tlv_use_case_transaction_check.h.

◆ transaction_check_risk_e

Enumerator
TRANSACTION_CHECK_RISK_BENIGN 
TRANSACTION_CHECK_RISK_WARNING 
TRANSACTION_CHECK_RISK_MALICIOUS 
TRANSACTION_CHECK_RISK_COUNT 

Definition at line 44 of file tlv_use_case_transaction_check.h.

◆ transaction_check_type_e

Enumerator
TRANSACTION_CHECK_TYPE_TRANSACTION 
TRANSACTION_CHECK_TYPE_TYPED_DATA 
TRANSACTION_CHECK_TYPE_COUNT 

Definition at line 51 of file tlv_use_case_transaction_check.h.

Function Documentation

◆ tlv_use_case_transaction_check()

tlv_transaction_check_status_t tlv_use_case_transaction_check ( const buffer_t * payload,
tlv_transaction_check_out_t * out )

Parse a Transaction Check TLV payload.

Parses the provided TLV payload, verifies the PKI signature, and extracts the simulation result into the output structure.

Warning
A successful return only means the descriptor is authentic and well-formed. This parser is chain-agnostic: it does not enforce the presence of chain_id nor domain_hash, as their meaning depends on the blockchain (e.g. EVM vs Solana). Before displaying the risk verdict, the caller MUST check that the descriptor is bound to the operation being reviewed:
  • type matches the kind of operation being reviewed,
  • tx_hash and address match the transaction / message hash and the signer address,
  • when relevant for the blockchain, chain_id is received (chain_id_received) and matches the transaction chain ID,
  • for EIP-712 typed data, domain_hash is received (domain_hash_received) and matches the domain separator hash of the message. Otherwise a valid verdict could be replayed on another chain, domain or operation.
Parameters
[in]payloadPointer to the buffer containing the TLV payload data.
[out]outPointer to the structure where the parsed Transaction Check result will be stored.
Returns
Status code indicating the result of the operation. See tlv_transaction_check_status_t for possible values.

Definition at line 317 of file tlv_use_case_transaction_check.c.