Struct ProducerInfo 

pub struct ProducerInfo {
    pub name: String,
    pub version: String,
    pub candid_version: String,
    pub candid_parser_version: String,
}

Untrusted, caller-supplied provenance about the tool that produced a Contract.

Producer metadata is deliberately outside the semantic Contract identities. The candid-core:contract:v1 and candid-core:interface:v1 hashes (see docs/canonicalization-v1.md) are computed over the type graph, declarations, actor, and format/profile markers only — never over producer. Two Contracts that differ only in their producer therefore share the same contract_id and interface_id, even though they are byte-different on the wire (producer is part of the canonical serialized JSON — and identical in every feature configuration). No unkeyed content ID authenticates itself, so neither identity authenticates these claims; a signature over one commits to the semantic Contract and callers must treat producer metadata as unverified.

A caller that must commit to the producer bytes it actually received commits to a detached artifact_id_with_limits instead, and what that binds depends on the ArtifactKind named: ContractJsonV1 covers the Contract document’s octets, producer included and nothing more, while the envelope and compilation kinds cover those octets plus extensions or the provenance sidecar respectively. The semantic identities exclude producer metadata under every kind.

This boundary is load-bearing for compatibility: binding producer into the identity payload would change every existing contract_id. The bytes are still bounded — see crate::Limits::max_producer_bytes — so untrusted producer strings cannot grow without limit; they simply never influence an identity.

Fields

name: String

version: String

candid_version: String

candid_parser_version: String

Implementations

impl ProducerInfo

pub fn current() -> Self

The producer metadata describing this build of candid-core itself: the crate name and version plus the exact pinned candid and candid_parser dependency versions. This is the producer a ContractDraft builds with when none is supplied explicitly.

The four fields are present and identical in every feature configuration. candid and candid_parser are optional dependencies enabled by the compiler feature, but the versions reported here are read out of this package’s own manifest text at compile time, not from a linked crate, so a default-features = false build of a given candid-core version reports exactly the same producer bytes as a full one. That is deliberate: producer metadata is untrusted provenance about this package, and making it vary by feature would fork the serialized shape of otherwise identical Contracts.

Trait Implementations

impl Clone for ProducerInfo

fn clone(&self) -> ProducerInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProducerInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProducerInfo

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ProducerInfo

impl PartialEq for ProducerInfo

fn eq(&self, other: &ProducerInfo) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ProducerInfo

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ProducerInfo