Enum GhostkeyRequest 

#[non_exhaustive]
pub enum GhostkeyRequest {
    ImportGhostKey {
        certificate_pem: String,
        signing_key_pem: String,
        master_verifying_key_pem: Option<String>,
    },
    ListGhostKeys,
    GetGhostKey {
        fingerprint: String,
    },
    GetCertificate {
        fingerprint: String,
    },
    DeleteGhostKey {
        fingerprint: String,
    },
    SetLabel {
        fingerprint: String,
        label: String,
    },
    SignMessage {
        fingerprint: String,
        message: Vec<u8>,
    },
    SignWithDefault {
        message: Vec<u8>,
    },
    SetDefaultKey {
        fingerprint: String,
    },
    GetDefaultKey,
    VerifySignedMessage {
        signed_message: Vec<u8>,
    },
    ExportGhostKey {
        fingerprint: String,
    },
    ExportAllGhostKeys,
    GrantPermission {
        fingerprint: String,
        requestor: SignatureRequestor,
    },
    RevokePermission {
        fingerprint: String,
        requestor: SignatureRequestor,
    },
    ListPermissions {
        fingerprint: String,
    },
    TestPermissionPrompt {
        fingerprint: String,
    },
    RequestAnyAccess,
}

Requests from UI or other delegates to 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.

ImportGhostKey

Import a ghostkey from PEM-armored certificate and signing key. If master_verifying_key_pem is None, uses the hardcoded Freenet master key.

Fields

certificate_pem: String

signing_key_pem: String

master_verifying_key_pem: Option<String>

ListGhostKeys

List all stored ghostkeys.

GetGhostKey

Get details for a specific ghostkey.

Fields

fingerprint: String

GetCertificate

Get just the public certificate (for sharing with counterparties).

Fields

fingerprint: String

DeleteGhostKey

Delete a stored ghostkey.

Fields

fingerprint: String

SetLabel

Set a user-friendly label.

Fields

fingerprint: String

label: String

SignMessage

Sign a message with a specific ghostkey. The delegate scopes the signature to the requestor.

Fields

fingerprint: String

message: Vec<u8>

SignWithDefault

Sign a message with the user’s default ghostkey (highest-tier key, or user-overridden via SetDefaultKey). Apps should prefer this over SignMessage – it avoids needing to know about specific fingerprints.

Fields

message: Vec<u8>

SetDefaultKey

Set which ghostkey is the default for signing.

Fields

fingerprint: String

GetDefaultKey

Get the current default ghostkey fingerprint.

VerifySignedMessage

Verify a signed message produced by this delegate.

Fields

signed_message: Vec<u8>

ExportGhostKey

Export a ghostkey’s certificate and signing key for backup. Security-sensitive: returns the private signing key.

Fields

fingerprint: String

ExportAllGhostKeys

Export all ghostkeys for backup.

GrantPermission

Grant an application or delegate permission to use a ghostkey.

Fields

fingerprint: String

requestor: SignatureRequestor

RevokePermission

Revoke a previously granted permission.

Fields

fingerprint: String

requestor: SignatureRequestor

ListPermissions

List permissions for a ghostkey.

Fields

fingerprint: String

TestPermissionPrompt

Debug: force a permission prompt regardless of existing permissions.

Fields

fingerprint: String

RequestAnyAccess

A third-party app asks for any one of the user’s ghostkeys. The delegate emits a user prompt that lets the user pick a key (or deny). On approval the delegate grants {ReadPublic, Sign} to the requesting app for the chosen fingerprint and replies with a single-element GhostKeyList containing that key.

The request takes no fields on purpose: the only identifier the user sees in the prompt is the runtime-attested requestor (a truncated contract id). Letting the app supply free text would open a phishing surface (a hostile app could write text designed to look like Freenet UI chrome). Apps that want to communicate purpose to the user should do so in their own UI before this flow runs.

Trait Implementations

impl Clone for GhostkeyRequest

fn clone(&self) -> GhostkeyRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GhostkeyRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GhostkeyRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GhostkeyRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.