Expand description
This crate provides a type for representing a syntactically valid, unique account identifier on the Utility network.
§Account ID Rules
- Minimum length is
2
- Maximum length is
64
- An Account ID consists of Account ID parts separated by
.
, example:root
✔alice.unc
✔app.stage.testnet
✔
- Must not start or end with separators (
_
,-
or.
):_alice.
✗.bob.unc-
✗
- Each part of the Account ID consists of lowercase alphanumeric symbols separated either by
_
or-
, example:ƒelicia.unc
✗ (ƒ
is notf
)1_4m_n0t-al1c3.unc
✔
- Separators are not permitted to immediately follow each other, example:
alice..unc
✗not-_alice.unc
✗
- An Account ID that is 64 characters long and consists of lowercase hex characters is a specific implicit account ID
Learn more here: https://docs.unc.org/docs/concepts/account#account-id-rules
Also see Error kind precedence.
§Usage
use unc_account_id::{AccountIdRef, AccountId};
const ALICE: &AccountIdRef = AccountIdRef::new_or_panic("alice.unc");
let alice: AccountId = "alice.unc".parse().unwrap();
assert!("ƒelicia.unc".parse::<AccountId>().is_err()); // (ƒ is not f)
Structs§
- Account
Id - Utility Account Identifier.
- Account
IdRef - Account identifier. This is the human readable UTF-8 string which is used internally to index accounts on the network and their respective state.
- Parse
Account Error - An error which can be returned when parsing a Utility Account ID.
Enums§
- Account
Type - Enum representing possible types of accounts.
This
enum
is returned by theget_account_type
method onAccountIdRef
. See its documentation for more. - Parse
Error Kind - A list of errors that occur when parsing an invalid Account ID.