provision.h

Go to the documentation of this file.

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

 
#ifndef PROVISION_H
#define PROVISION_H
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#include "net.h"  /* net_wifi_ap_t — the browser is offered the device's own scan */
#include "ui.h"   /* ui_event_cb_t — submissions are reported as UI events */
 
#ifdef __cplusplus
extern "C" {
#endif

#define PROV_WINDOW_MIN  15U

typedef enum {
    PROV_MODE_OFF,      
    PROV_MODE_WIZARD,   
    PROV_MODE_ADMIN,    
} prov_mode_t;

typedef enum {
    PROV_STEP_IDLE,   
    PROV_STEP_AUTH,   
    PROV_STEP_ADDR,   
    PROV_STEP_WIFI,   
    PROV_STEP_DONE,   
    PROV_STEP_ADMIN,  
} prov_step_t;

typedef enum {
    PROV_ASK_NONE,
    PROV_ASK_PAYOUT_ETH,     
    PROV_ASK_PAYOUT_TRON,    
    PROV_ASK_CONTRACT_ETH,   
    PROV_ASK_CONTRACT_TRON,  
} prov_ask_t;

bool prov_start(prov_mode_t mode, ui_event_cb_t cb);

void prov_stop(void);

prov_mode_t prov_mode(void);

void prov_set_step(prov_step_t step);

prov_step_t prov_step(void);

unsigned prov_window_left_min(void);

const char *prov_ap_ssid(void);

const char *prov_ap_pass(void);

const char *prov_qr_payload(void);

bool prov_auth_pending(void);

void prov_auth_resolve(bool grant);

bool prov_authed(void);

bool prov_pair_code(char *out, size_t out_size);

void prov_set_wifi_only(void);

bool prov_wifi_only(void);

void prov_set_note(const char *note);

void prov_set_scan(const net_wifi_ap_t *aps, uint16_t n);

bool prov_pending(prov_ask_t *kind, char *label, size_t label_n,
                  char *value, size_t value_n);

bool prov_pending_commit(bool accept);

bool prov_propose(prov_ask_t kind, const char *addr);
 
#ifdef __cplusplus
}
#endif
 
#endif /* PROVISION_H */