Struct Issuer

pub struct Issuer { /* private fields */ }

An issuer contains information required for the creation of a contract and interaction with an existing contract.

Invariance

The structure provides the following invariance guarantees:

• all the API codex matches the codex under which the contract was issued;
• all the API ids are unique;
• all custom APIs have unique names.

Implementations

impl Issuer

pub fn load<E>( path: impl AsRef<Path>, sig_validator: impl FnOnce(StrictHash, &Identity, &SigBlob) -> Result<(), E>, ) -> Result<Self, DeserializeError>

Available on crate feature binfile only.

pub fn save(&self, path: impl AsRef<Path>) -> Result<()>

Available on crate feature binfile only.

impl Issuer

pub fn new(codex: Codex, semantics: Semantics) -> Result<Self, SemanticError>

Construct issuer from a codex and its semantics.

pub fn with<E>( codex: Codex, semantics: Semantics, sig: SigBlob, sig_validator: impl FnOnce(StrictHash, &Identity, &SigBlob) -> Result<(), E>, ) -> Result<Self, SemanticError>

Construct issuer from a codex and signed semantics.

pub fn dismember(self) -> (Codex, Semantics)

pub fn issuer_id(&self) -> IssuerId

Compute an issuer id, which includes information about the codex id, API version and checksum.

pub fn codex_id(&self) -> CodexId

Compute a codex id.

pub fn codex(&self) -> &Codex

Get a reference to the underlying codex.

pub fn codex_name(&self) -> &TinyString

Get the name of the underlying codex.

pub fn semantics(&self) -> &Semantics

Get a reference to the contract semantic.

pub fn default_api(&self) -> &Api

Get a reference to the default API.

pub fn custom_apis(&self) -> impl Iterator<Item = (&TypeName, &Api)>

Get an iterator over the custom APIs.

pub fn types(&self) -> &TypeSystem

Get a reference to the type system.

pub fn apis(&self) -> impl Iterator<Item = &Api>

Iterates over all APIs, including the default and the named ones.

pub fn codex_libs(&self) -> impl Iterator<Item = &Lib>

Iterates over all codex libraries.

pub fn is_signed(&self) -> bool

Detect whether the issuer is signed.

pub fn call_id(&self, method: impl Into<MethodName>) -> CallId

Get a CallId for a method from the default API.

Panics

If the method name is not known.

impl Issuer

pub fn start_issue( self, method: impl Into<MethodName>, consensus: Consensus, testnet: bool, ) -> IssueBuilder

pub fn start_issue_mainnet( self, method: impl Into<MethodName>, consensus: Consensus, ) -> IssueBuilder

pub fn start_issue_testnet( self, method: impl Into<MethodName>, consensus: Consensus, ) -> IssueBuilder

pub fn issue(self, params: IssueParams) -> Articles

Trait Implementations

impl Clone for Issuer

fn clone(&self) -> Issuer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Issuer

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

Formats the value using the given formatter.

impl LibRepo for Issuer

fn get_lib(&self, lib_id: LibId) -> Option<&Lib>

Get a specific library with the provided id.

impl PartialEq for Issuer

fn eq(&self, other: &Issuer) -> 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 StrictDumb for Issuer

fn strict_dumb() -> Self

impl StrictEncode for Issuer

fn strict_encode<W: TypedWrite>(&self, writer: W) -> Result<W>

fn strict_write(&self, writer: impl WriteRaw) -> Result<(), Error>

impl StrictStruct for Issuer

const ALL_FIELDS: &'static [&'static str]

fn strict_check_fields()

fn strict_type_info() -> TypeInfo<Self>

impl StrictType for Issuer

const STRICT_LIB_NAME: &'static str = LIB_NAME_SONIC

fn strict_name() -> Option<TypeName>

impl Eq for Issuer

impl StrictProduct for Issuer

impl StructuralPartialEq for Issuer