Struct InfoAwareIdentity 

pub struct InfoAwareIdentity<I: Identity> { /* private fields */ }

An identity wrapper that attaches canister-certified sender information to every request.

The inner identity’s public key must be a canister signature key (OID 1.3.6.1.4.1.56387.1.2). sig must be a canister signature over \x0Eic-sender-info || info using that same key.

Implementations

impl<I: Identity> InfoAwareIdentity<I>

pub fn new( inner: I, info: Vec<u8>, sig: Vec<u8>, ) -> Result<Self, DelegationError>

Wraps inner and attaches info/sig as certified sender information.

Verifies the canister signature against the IC mainnet root key. inner must have a canister signature public key.

pub fn new_with_root_key( inner: I, info: Vec<u8>, sig: Vec<u8>, root_key: &[u8], ) -> Result<Self, DelegationError>

Like new, but verifies against a custom root key (e.g. local replica or testnet).

pub fn new_unchecked( inner: I, info: Vec<u8>, sig: Vec<u8>, ) -> Result<Self, DelegationError>

Like new, but skips cryptographic verification of the canister signature.

The replica will still reject an invalid signature. The signer principal is still parsed from the inner identity’s public key.

Trait Implementations

impl<I: Identity> Identity for InfoAwareIdentity<I>

fn sender(&self) -> Result<Principal, String>

Returns a sender, ie. the Principal ID that is used to sign a request.

fn public_key(&self) -> Option<Vec<u8>>

Produce the public key commonly returned in Signature.

fn sign(&self, content: &EnvelopeContent) -> Result<Signature, String>

Sign a request ID derived from a content map.

fn sign_delegation(&self, content: &Delegation) -> Result<Signature, String>

Sign a delegation to let another key be used to authenticate sender.

fn sign_arbitrary(&self, content: &[u8]) -> Result<Signature, String>

Sign arbitrary bytes.

fn delegation_chain(&self) -> Vec<SignedDelegation>

A list of signed delegations connecting sender to public_key, and in that order.

fn sender_info(&self) -> Option<SenderInfo>

Returns canister-certified sender information to include in the request envelope, or None.