Struct TopicId 

#[repr(C)]
pub struct TopicId {
    pub shard: u64,
    pub realm: u64,
    pub num: u64,
    pub checksum: Option<Checksum>,
}

The unique identifier for a topic on Hiero.

Fields

shard: u64

A non-negative number identifying the shard containing this topic.

realm: u64

A non-negative number identifying the realm within the shard containing this topic.

num: u64

A non-negative number identifying the entity within the realm containing this topic.

checksum: Option<Checksum>

A checksum if the topic ID was read from a user inputted string which inclueded a checksum

Implementations

impl TopicId

pub const fn new(shard: u64, realm: u64, num: u64) -> Self

Create a TopicId with the given shard.realm.num.

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Create a new TopicId from protobuf-encoded bytes.

Errors

• Error::FromProtobuf if decoding the bytes fails to produce a valid protobuf.
• Error::FromProtobuf if decoding the protobuf fails.

pub fn from_solidity_address(address: &str) -> Result<Self>

Create a TopicId from a solidity address.

Errors

• Error::BasicParse if address cannot be parsed as a solidity address.

pub fn to_bytes(&self) -> Vec<u8>

Convert self to a protobuf-encoded Vec<u8>.

pub fn to_solidity_address(&self) -> Result<String>

Convert self into a solidity address

Errors

• Error::BasicParse if self.shard is larger than u32::MAX.

pub fn to_string_with_checksum(&self, client: &Client) -> String

Convert self to a string with a valid checksum.

pub fn validate_checksum(&self, client: &Client) -> Result<()>

Validates self.checksum (if it exists) for client.

Errors

• Error::BadEntityId if there is a checksum, and the checksum is not valid for the client’s ledger_id.

Trait Implementations

impl Clone for TopicId

fn clone(&self) -> TopicId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TopicId

impl Debug for TopicId

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

Formats the value using the given formatter.

impl Display for TopicId

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

Formats the value using the given formatter.

impl Eq for TopicId

impl From<EntityId> for TopicId

fn from(value: EntityId) -> Self

Converts to this type from the input type.

impl From<u64> for TopicId

fn from(num: u64) -> Self

Converts to this type from the input type.

impl FromStr for TopicId

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for TopicId

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

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 TopicId

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TopicId

impl ValidateChecksums for TopicId

fn validate_checksums(&self, ledger_id: &RefLedgerId) -> Result<(), Error>

Validates all entity-id checksums for self with the given ledger-id.