Aggregate runtime state for a single UDIF entity process. More...

#include <entity.h>

Data Fields
udif_certificate	selfcert
udif_certificate	parentcert
udif_certificate	rootcert
udif_certstore	certstore
udif_capstore	capstore
udif_treatystore	treatystore
udif_signature_keypair	selfkeypair
uint8_t	capabilitykey [UDIF_CRYPTO_KEY_SIZE]
bool	hascapabilitykey
qstp_root_certificate	qstprootcert
qstp_server_signature_key	qstpserverkey
udif_mcel_manager *	mcelmgr
udif_tunnel_table	tunnels
udif_anchor_sequence_state	anchorseq [UDIF_ENTITY_MAX_ANCHOR_STATES]
udif_entity_registry_entry	registries [UDIF_ENTITY_MAX_REGISTRIES]
uint64_t	nextanchorsecs
udif_roles	role
bool	haslistener
bool	initialized

Detailed Description

Aggregate runtime state for a single UDIF entity process.

Owned by the entity's main loop. Handlers receive a non-owning pointer and may read or mutate any field subject to the usual thread-safety rules of the host application.

QSTP certificates (qstprootcert and qstpserverkey) are only populated for entities that accept incoming QSTP connections (Root, BC, GC). A UA that only initiates outbound tunnels needs only the root certificate against which to validate the server.

Field Documentation

◆ anchorseq

udif_anchor_sequence_state anchorseq[UDIF_ENTITY_MAX_ANCHOR_STATES]

Expected child anchor sequences

◆ capabilitykey

uint8_t capabilitykey[UDIF_CRYPTO_KEY_SIZE]

Local capability KMAC verification key

◆ capstore

udif_capstore capstore

Runtime capability-token store

◆ certstore

udif_certstore certstore

Runtime certificate status store

◆ hascapabilitykey

bool hascapabilitykey

True when capabilitykey is configured

◆ haslistener

bool haslistener

True if this entity accepts inbound QSTP connections

◆ initialized

bool initialized

Initialization flag

◆ mcelmgr

udif_mcel_manager* mcelmgr

MCEL manager (holds membership, registry, transaction ledgers and storage); NULL for UA

◆ nextanchorsecs

uint64_t nextanchorsecs

UTC seconds at which next anchor is due; 0 for UA

◆ parentcert

udif_certificate parentcert

Parent UDIF certificate; zeroed for Root

◆ qstprootcert

qstp_root_certificate qstprootcert

QSTP trust anchor for the transport layer

◆ qstpserverkey

qstp_server_signature_key qstpserverkey

QSTP server signing key (populated for listeners)

◆ registries

udif_entity_registry_entry registries[UDIF_ENTITY_MAX_REGISTRIES]

Runtime per-UA registries

◆ role

udif_roles role

Fixed at init; governs handler admissibility

◆ rootcert

udif_certificate rootcert

Domain UDIF trust anchor

◆ selfcert

udif_certificate selfcert

This entity's signed UDIF certificate

◆ selfkeypair

udif_signature_keypair selfkeypair

This entity's UDIF long-term signing keypair

◆ treatystore

udif_treatystore treatystore

Runtime cross-domain treaty store

◆ tunnels

udif_tunnel_table tunnels

Active tunnels

The documentation for this struct was generated from the following file:

C:/Users/stepp/Documents/Visual Studio 2022/Projects/C/UDIF/UDIF/entity.h

Data Fields