settings.h

Go to the documentation of this file.

/*
 * SPDX-License-Identifier: LGPL-3.0-or-later
 * Copyright (c) 2026 Cryptnox SA
 */

 
#ifndef SETTINGS_H
#define SETTINGS_H
 
#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif

typedef enum {
    POS_CHAIN_ETH_USDC    = 0,  
    POS_CHAIN_TRON_TRX    = 1,  
    POS_CHAIN_TRON_USDT   = 2,  
    POS_CHAIN_ETH_USDT    = 3,  
    POS_CHAIN_POLY_USDC   = 4,  
    POS_CHAIN_POLY_USDT   = 5,  
    POS_CHAIN_TRON_USDC   = 6,  
    POS_CHAIN_ETH_NATIVE  = 7,  
    POS_CHAIN_POLY_NATIVE = 8,  
    POS_CHAIN__COUNT            
} pos_chain_t;
 
/* Family/network predicates for each selection live in assets.h. */

#define POS_AMOUNT_UNITS_MAX_NATIVE  18446744ULL

pos_chain_t settings_get_chain(void);

void settings_set_chain(pos_chain_t chain);

bool settings_get_mainnet(void);

void settings_set_mainnet(bool mainnet);

const char *settings_net_str(const char *testnet, const char *mainnet);

#define TZ_OFFSET_MIN  (-720)
#define TZ_OFFSET_MAX  (840)

int16_t settings_get_tz_offset_min(void);

bool settings_set_tz_offset_min(int16_t minutes);

uint8_t settings_get_tz_dst(void);

bool settings_set_tz_dst(uint8_t rule);

uint8_t settings_get_brightness(void);

void settings_set_brightness(uint8_t pct);

void settings_get_touch_cal(uint16_t *x_min, uint16_t *x_max,
                            uint16_t *y_min, uint16_t *y_max);

void settings_set_touch_cal(uint16_t x_min, uint16_t x_max,
                            uint16_t y_min, uint16_t y_max);

bool settings_has_wifi(void);

bool settings_get_wifi(char *ssid, size_t ssid_n, char *pass, size_t pass_n);

void settings_set_wifi(const char *ssid, const char *pass);

bool settings_has_admin_code(void);

bool settings_set_admin_code(const char *code);

bool settings_check_admin_code(const char *code);

uint8_t settings_admin_fail_count(void);

uint32_t settings_get_max_fee_gwei(void);

uint32_t settings_get_priority_fee_gwei(void);

bool settings_set_fees_gwei(uint32_t max_gwei, uint32_t prio_gwei);

#define SETTINGS_PAYOUT_MAX  64U

bool settings_get_payout(bool tron, char *out, size_t n);

bool settings_has_payout(bool tron);

bool settings_set_payout(bool tron, const char *addr);

bool settings_get_contract(pos_chain_t chain, char *out, size_t n);

bool settings_set_contract(pos_chain_t chain, const char *addr);

void settings_factory_reset(void);

bool settings_inflight_save(const void *rec, size_t n);

bool settings_inflight_load(void *rec, size_t n);

void settings_inflight_clear(void);
 
/*
 * BUILD_ID is set by the build to `git rev-list --count --first-parent HEAD`
 * (project CMakeLists.txt), so every commit gets a new one. A plain counter
 * survives every route onto a unit (browser update, `idf.py flash`, factory
 * image). See @ref settings_wipe_if_new_build.
 */

bool settings_wipe_if_new_build(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* SETTINGS_H */