Struct ChannelName 

pub struct ChannelName(/* private fields */);

A validated channel name.

Names are hierarchical with / separators. Valid characters are alphanumeric, -, _, ., and /. Names must not be empty, start or end with /, or contain //.

Backed by Arc<str> so Clone is a refcount bump rather than a heap allocation. ChannelName is cloned on every nRPC call (the per-service route cache hands the cached name to the caller guard), on every publish (the publisher’s ChannelId is cloned into per-peer dispatch records), and on registry lookups; making Clone allocation-free removes a class of per-hot-call allocs without changing any caller code. The validated invariant is preserved by ::new: there is no public field, no From<String> or From<&str> impl, and no mutator — once constructed, the Arc<str> is immutable and aliased copies are safe to share.

Implementations

impl ChannelName

pub fn new(name: &str) -> Result<ChannelName, ChannelError>

Create a new channel name, validating the format.

pub fn as_str(&self) -> &str

Get the name as a string slice.

pub fn hash(&self) -> u64

Compute the canonical ChannelHash (64-bit) for the name.

This is the substrate-wide key used for ACL, storage, and config decisions. Targeted second-preimage attacks require ~2^64 work even though xxh3 is non-cryptographic.

pub fn wire_hash(&self) -> u16

Compute the wire u16 channel hash for the Net header fast-path.

The hint stamped on every outgoing packet — fast to compare but only 65,536 buckets, so it has routine collisions at mesh scale. Control-plane and storage authorization key on ChannelName::hash (canonical u32), not on this wire hint.

pub fn depth(&self) -> usize

Get the number of path segments.

pub fn is_prefix_of(&self, other: &ChannelName) -> bool

Check if this name is a prefix of another (for wildcard subscriptions).

Trait Implementations

impl Clone for ChannelName

fn clone(&self) -> ChannelName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChannelName

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

Formats the value using the given formatter.

impl Display for ChannelName

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

Formats the value using the given formatter.

impl Eq for ChannelName

impl Hash for ChannelName

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ChannelName

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ChannelName