Struct hedera::ContractId

pub struct ContractId {
    pub shard: u64,
    pub realm: u64,
    pub num: u64,
    pub checksum: Option<Checksum>,
    pub evm_address: Option<[u8; 20]>,
}

A unique identifier for a smart contract on Hedera.

Fields

shard: u64

A non-negative number identifying the shard containing this contract instance.

realm: u64

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

num: u64

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

Note: Exactly one of evm_address and num must exist.

checksum: Option<Checksum>

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

evm_address: Option<[u8; 20]>

EVM address identifying the entity within the realm containing this contract instance.

Note: Exactly one of evm_address and num must exist.

Implementations

impl ContractId

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

Create a ContractId from the given shard/realm/num

pub fn from_evm_address_bytes( shard: u64, realm: u64, evm_address: [u8; 20] ) -> Self

Create a ContractId from a shard.realm.evm_address set.

pub fn from_evm_address(shard: u64, realm: u64, address: &str) -> Result<Self>

Create a ContractId from a shard.realm.evm_address set.

Errors

Error::BasicParse if address is invalid hex, or the wrong length.

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

Create a ContractId from a solidity address.

Errors

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

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

Create a new ContractId 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 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) -> Result<String, Error>

Convert self to a string with a valid checksum.

Errors

• Error::CannotCreateChecksum if self has an evm_address.

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

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 ContractId

fn clone(&self) -> ContractId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ContractId

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

Formats the value using the given formatter.

impl Display for ContractId

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

Formats the value using the given formatter.

impl From<[u8; 20]> for ContractId

fn from(address: [u8; 20]) -> Self

Converts to this type from the input type.

impl From<ContractId> for Key

fn from(id: ContractId) -> Self

Converts to this type from the input type.

impl From<EntityId> for ContractId

fn from(value: EntityId) -> Self

Converts to this type from the input type.

impl From<u64> for ContractId

fn from(num: u64) -> Self

Converts to this type from the input type.

impl FromStr for ContractId

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 ContractId

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 ContractId

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Copy for ContractId

impl Eq for ContractId

impl StructuralPartialEq for ContractId