Skip to main content

Module nfc_evidence

Module nfc_evidence 

Source
Expand description

Bounded variable-length radio identifiers and signed custody receipts.

NFC UIDs and other protocol identifiers are observation bytes only. This module makes no stable-device, owner, person, presence, or legal-admissibility claim. Protocol and identifier-kind values are explicit host declarations; unknown time and unknown protocol remain explicit. Bytes are caller-buffered.

Structs§

NfcCustodyReceipt
Signature validity is distinct from host trust, permission validity, and chain completeness. Receipt construction hashes the exact encoded record.
NfcEvidenceRecord
One raw observation with the same source/capture/time/permission context used for MAC/BSSID records, but an independent variable-length identifier. A missing generation remains explicitly unknown: a stream ID and sequence without it do not establish continuity or distinguish stream restarts.
VariableRadioIdentifier
Exact variable-length identifier bytes. The unused fixed-array suffix is always zero; len is authoritative and prevents trimming meaningful zeros.

Enums§

NfcEvidenceError
NfcReceiptStatus
ProtocolIdentifier
VariableRadioIdentifierKind

Constants§

NFC_EVIDENCE_RECORD_SIZE
NFC_EVIDENCE_VERSION
NFC_IDENTIFIER_MAX_LEN
NFC_RECEIPT_ENCODED_LEN

Traits§

NfcReceiptAuthority
Host-owned trust boundary; implementations must check current signer, permission/revocation, and anti-rollback/checkpoint completeness state. The chain callback receives the signed timestamp verbatim and must decide whether ReceiptTimestamp::Unknown is acceptable for the requested use.

Functions§

encode_nfc_evidence_record
Encode a single record into a canonical fixed-size caller buffer.