Enum GhostkeyResponse 

#[non_exhaustive]
pub enum GhostkeyResponse {
    ImportResult {
        fingerprint: String,
        notary_info: String,
    },
    GhostKeyList {
        keys: Vec<GhostKeyInfo>,
    },
    GhostKeyDetail {
        fingerprint: String,
        certificate_pem: String,
        label: Option<String>,
        notary_info: String,
    },
    Certificate {
        fingerprint: String,
        certificate_pem: String,
    },
    SignResult {
        scoped_payload: Vec<u8>,
        signature: Vec<u8>,
        certificate_pem: String,
    },
    DefaultKeyResult {
        fingerprint: Option<String>,
    },
    DefaultKeySet {
        fingerprint: String,
    },
    VerifyResult {
        valid: bool,
        signer_fingerprint: Option<String>,
        notary_info: Option<String>,
        requestor: Option<SignatureRequestor>,
        message: Option<Vec<u8>>,
    },
    Deleted {
        fingerprint: String,
    },
    LabelSet {
        fingerprint: String,
        label: String,
    },
    PermissionGranted {
        fingerprint: String,
        requestor: SignatureRequestor,
    },
    PermissionRevoked {
        fingerprint: String,
        requestor: SignatureRequestor,
    },
    PermissionList {
        fingerprint: String,
        requestors: Vec<SignatureRequestor>,
    },
    ExportResult {
        fingerprint: String,
        certificate_pem: String,
        signing_key_pem: String,
        label: Option<String>,
    },
    ExportAllResult {
        keys: Vec<ExportedGhostKey>,
    },
    PermissionDenied {
        fingerprint: String,
        requestor: SignatureRequestor,
    },
    AccessDenied {
        requestor: SignatureRequestor,
    },
    NoIdentityAvailable,
    IdentityPresence {
        usable: usize,
        unusable: usize,
    },
    BackedUpMarked {
        fingerprint: String,
    },
    KeyNotFound {
        fingerprint: String,
    },
    Error {
        message: String,
    },
}

Responses from the ghostkey delegate.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ImportResult

Fields

fingerprint: String

notary_info: String

GhostKeyList

Fields

keys: Vec<GhostKeyInfo>

GhostKeyDetail

Fields

fingerprint: String

certificate_pem: String

label: Option<String>

notary_info: String

Certificate

Fields

fingerprint: String

certificate_pem: String

SignResult

Fields

scoped_payload: Vec<u8>

CBOR-serialized ScopedPayload

signature: Vec<u8>

Ed25519 signature over the scoped_payload bytes

certificate_pem: String

The certificate PEM, so the verifier has the full chain

DefaultKeyResult

Fields

fingerprint: Option<String>

DefaultKeySet

Fields

fingerprint: String

VerifyResult

Fields

valid: bool

signer_fingerprint: Option<String>

notary_info: Option<String>

requestor: Option<SignatureRequestor>

message: Option<Vec<u8>>

Deleted

Fields

fingerprint: String

LabelSet

Fields

fingerprint: String

label: String

PermissionGranted

Fields

fingerprint: String

requestor: SignatureRequestor

PermissionRevoked

Fields

fingerprint: String

requestor: SignatureRequestor

PermissionList

Fields

fingerprint: String

requestors: Vec<SignatureRequestor>

ExportResult

Fields

fingerprint: String

certificate_pem: String

signing_key_pem: String

label: Option<String>

ExportAllResult

Fields

keys: Vec<ExportedGhostKey>

PermissionDenied

Fields

fingerprint: String

requestor: SignatureRequestor

AccessDenied

Permission denied for a request that didn’t name a specific fingerprint – today this means the user denied a RequestAnyAccess prompt. Distinct from PermissionDenied so callers don’t have to invent a placeholder fingerprint to pattern-match.

Fields

requestor: SignatureRequestor

NoIdentityAvailable

The user has no ghostkeys. Apps should direct the user to freenet.org/ghostkey to purchase one.

It is NOT returned merely because the caller lacks permission — SignWithDefault prompts the user instead when the vault holds keys the caller has no grant on. So an app can treat this as “offer to buy one” without first checking whether it was really a permissions problem.

Precisely, it means no identity is available to sign with: either the vault is empty, or every identity in it has lost its signing key. Use HasIdentity to tell those apart — its unusable count is non-zero in the second case, which is worth a different message, since buying another key is not what that user needs.

IdentityPresence

Reply to HasIdentity. Counts only — no fingerprints, labels or tiers.

Fields

usable: usize

Identities that can actually sign: certificate AND signing key both present.

unusable: usize

Identities whose certificate loads but whose signing key is gone. These still appear in ListGhostKeys, which never checks for the signing key, so without this count a half-lost identity looks perfectly healthy right up until it fails to sign.

BackedUpMarked

Confirms MarkBackedUp.

Fields

fingerprint: String

KeyNotFound

The requested ghostkey fingerprint was not found.

Fields

fingerprint: String

Error

Generic error for unexpected failures.

Fields

message: String

Trait Implementations

impl Clone for GhostkeyResponse

fn clone(&self) -> GhostkeyResponse

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GhostkeyResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GhostkeyResponse

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GhostkeyResponse

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.