Struct ContractEntrypointID 

pub struct ContractEntrypointID { /* private fields */ }

8-byte identifier for a contract method (entrypoint).

Entrypoint IDs uniquely identify which method to invoke on a contract. A contract may use any 8 bytes; the protocol attaches no meaning to them. By default, the SDK derives them from the interface name, the major version of the interface, and the method name:

SHA256(name || "::" || major || "::" || method)[0..8]

major is the semver compatibility prefix of the interface version: the leading components up to and including the first nonzero one ("1" for "1.4.2", "0.2" for "0.2.7", "0.0.3" for "0.0.3"). Versions that share it therefore share entrypoint IDs, and the "::" separators keep distinct (name, major, method) triples from concatenating to the same preimage.

Example

For an "ERC20" interface at version "1.0.0", transfer is SHA256("ERC20::1::transfer")[0..8].

Interface IDs use the same prefix under a domain tag, SHA256("thruput-interface::" || name || "::" || major)[0..8], so they never coincide with an entrypoint ID.

Implementations

impl ContractEntrypointID

pub const fn from_u64(n: u64) -> ContractEntrypointID

Builds an entrypoint ID from its numeric form, storing n as the ID’s 8 big-endian bytes.

pub fn into_u64(self) -> u64

Returns the numeric form of this ID, reading its 8 bytes as a big-endian u64. Inverse of Self::from_u64.

impl ContractEntrypointID

pub fn into_inner(self) -> [u8; 8]

pub const fn new(_inner: [u8; 8]) -> ContractEntrypointID

Trait Implementations

impl AsRef<[u8]> for ContractEntrypointID

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ContractEntrypointID

fn clone(&self) -> ContractEntrypointID

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CollectAuthHandles for ContractEntrypointID

fn collect_auth_handles( &self, _out: &mut AuthHandleBuf, ) -> Result<(), FaultString>

impl ConstMaxSize for ContractEntrypointID

const MAX_SIZE: Option<usize>

Worst-case CXS encoded size in bytes, or None if unbounded.

impl ConstMaxSize for ContractEntrypointID

const MAX_SIZE: Option<usize>

Worst-case TXS encoded size in bytes, or None if unbounded.

impl ContractTypeRefSpec for ContractEntrypointID

const INFO: ContractTypeInfo<'static>

The type reference. Transitive type definitions are not carried here; they are retained via the linker-anchor mechanism (__THRUPUT_SPEC_ANCHOR_ROOT) and resolved by spec-tool.

const SIGNED_PREIMAGE: Option<&'static ContractTypeView<'static>> = _

How this type appears as a signed-token preimage (ContractTypeView::SignedToken’s payload): the type itself by default, or None for a type-erased payload (the SDK’s Opaque overrides this).

impl Copy for ContractEntrypointID

impl Debug for ContractEntrypointID

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

Formats the value using the given formatter.

impl Default for ContractEntrypointID

fn default() -> ContractEntrypointID

Returns the “default value” for a type.

impl Deref for ContractEntrypointID

type Target = [u8; 8]

The resulting type after dereferencing.

fn deref(&self) -> &<ContractEntrypointID as Deref>::Target

Dereferences the value.

impl DerefMut for ContractEntrypointID

fn deref_mut(&mut self) -> &mut <ContractEntrypointID as Deref>::Target

Mutably dereferences the value.

impl EncodesAs<ContractEntrypointID> for ContractEntrypointID

impl Eq for ContractEntrypointID

impl<'a> From<&'a [u8; 8]> for &'a ContractEntrypointID

fn from(arr: &[u8; 8]) -> &'a ContractEntrypointID

Converts to this type from the input type.

impl From<[u8; 8]> for ContractEntrypointID

fn from(_inner: [u8; 8]) -> ContractEntrypointID

Converts to this type from the input type.

impl Hash for ContractEntrypointID

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 JsonSchema for ContractEntrypointID

Available on crate feature schema only.

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn json_schema(_gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

impl Mintable for ContractEntrypointID

fn mint_into_parent( preimage: ContractEntrypointID, _children: &mut ChildNodeBuf, ) -> Self

impl MintableType for ContractEntrypointID

type Preimage = ContractEntrypointID

impl Ord for ContractEntrypointID

fn cmp(&self, other: &ContractEntrypointID) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for ContractEntrypointID

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ContractEntrypointID

fn partial_cmp(&self, other: &ContractEntrypointID) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_r> ReadXDR<'_r> for ContractEntrypointID

fn read_xdr<R>(r: &mut R) -> Result<ContractEntrypointID, ReadError>

where R: Reader<'_r>,

Reads an XDR value from the reader.

fn read_xdr_in_place<R, '__xdrs_s>( r: &mut R, __xdrs_slot: Slot<'__xdrs_s, ContractEntrypointID>, ) -> Result<Init<'__xdrs_s, ContractEntrypointID>, ReadError>

where R: Reader<'_r>,

Reads an XDR value directly into slot, without first building it on the stack.

impl<'r, 'a> ReadXDR<'r> for &'a ContractEntrypointID

where 'r: 'a,

Available on crate feature xdrs only.

fn read_xdr<R>(r: &mut R) -> Result<&'a ContractEntrypointID, ReadError>

where R: Reader<'r>,

Reads an XDR value from the reader.

fn read_xdr_in_place<'s, R>( r: &mut R, slot: Slot<'s, Self>, ) -> Result<Init<'s, Self>, ReadError>

where R: Reader<'r>,

Reads an XDR value directly into slot, without first building it on the stack.

impl ReceiveAuthHandles for ContractEntrypointID

fn receive_auth_handles( &mut self, _handles: &mut impl Iterator<Item = u32>, ) -> Result<(), AuthTokenError>

impl StructuralPartialEq for ContractEntrypointID

impl WriteXDR for ContractEntrypointID

fn write_xdr<F, W>(&self, w: &mut W) -> Result<(), WriteError>

where W: Writer<F>,

Writes this value as XDR data to the writer.

unsafe fn write_xdr_unchecked<F, W>(&self, w: &mut W)

where W: WriterUnchecked<F>,

Writes this value as XDR data to the writer, without runtime checks.