Struct Destination 

pub struct Destination {
    pub hash: DestHash,
    pub dest_type: DestinationType,
    pub direction: Direction,
    pub app_name: String,
    pub aspects: Vec<String>,
    pub identity_hash: Option<IdentityHash>,
    pub public_key: Option<[u8; 64]>,
    pub group_key: Option<Vec<u8>>,
    pub proof_strategy: ProofStrategy,
}

A network destination (endpoint) for sending or receiving packets.

This is a pure data struct with no behavior — all operations (register, announce, send) are methods on RnsNode.

Fields

hash: DestHash

Computed destination hash.

dest_type: DestinationType

Type: Single, Group, or Plain.

direction: Direction

Direction: In (receiving) or Out (sending).

app_name: String

Application name (e.g. “echo_app”).

aspects: Vec<String>

Aspects (e.g. [“echo”, “request”]).

identity_hash: Option<IdentityHash>

Identity hash of the owner (for SINGLE destinations).

public_key: Option<[u8; 64]>

Full public key (64 bytes) of the remote peer (for OUT SINGLE destinations).

group_key: Option<Vec<u8>>

Symmetric key for GROUP destinations (32 or 64 bytes).

proof_strategy: ProofStrategy

How to handle proofs for incoming packets.

Implementations

impl Destination

pub fn single_in( app_name: &str, aspects: &[&str], identity_hash: IdentityHash, ) -> Self

Create an inbound SINGLE destination (for receiving encrypted packets).

identity_hash is the local identity that owns this destination.

pub fn single_out( app_name: &str, aspects: &[&str], recalled: &AnnouncedIdentity, ) -> Self

Create an outbound SINGLE destination (for sending encrypted packets).

recalled contains the remote peer’s identity data (from announce/recall).

pub fn plain(app_name: &str, aspects: &[&str]) -> Self

Create a PLAIN destination (unencrypted, no identity).

pub fn group(app_name: &str, aspects: &[&str]) -> Self

Create a GROUP destination (symmetric encryption with pre-shared key).

No identity needed — the hash is based only on app_name + aspects, same as PLAIN. All members sharing the same key can encrypt/decrypt.

pub fn create_keys(&mut self)

Generate a new random 64-byte symmetric key (AES-256) for this GROUP destination.

pub fn load_private_key(&mut self, key: Vec<u8>) -> Result<(), GroupKeyError>

Load an existing symmetric key for this GROUP destination.

Key must be 32 bytes (AES-128) or 64 bytes (AES-256).

pub fn get_private_key(&self) -> Option<&[u8]>

Retrieve the symmetric key bytes, if set.

pub fn encrypt(&self, plaintext: &[u8]) -> Result<Vec<u8>, GroupKeyError>

Encrypt plaintext using this destination’s GROUP key.

pub fn decrypt(&self, ciphertext: &[u8]) -> Result<Vec<u8>, GroupKeyError>

Decrypt ciphertext using this destination’s GROUP key.

pub fn set_proof_strategy(self, strategy: ProofStrategy) -> Self

Set the proof strategy for this destination.

Trait Implementations

impl Clone for Destination

fn clone(&self) -> Destination

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Destination

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

Formats the value using the given formatter.