Crate near_account_id

source ·
Expand description

This crate provides a type for representing a syntactically valid, unique account identifier on the NEAR 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.near ✔
    • app.stage.testnet ✔
  • Must not start or end with separators (_, - or .):
    • _alice. ✗
    • .bob.near- ✗
  • Each part of the Account ID consists of lowercase alphanumeric symbols separated either by _ or -, example:
    • ƒelicia.near ✗ (ƒ is not f)
    • 1_4m_n0t-al1c3.near ✔
  • Separators are not permitted to immediately follow each other, example:
    • alice..near ✗
    • not-_alice.near ✗
  • 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.near.org/docs/concepts/account#account-id-rules

Also see Error kind precedence.

Usage

use near_account_id::{AccountIdRef, AccountId};

const ALICE: &AccountIdRef = AccountIdRef::new_or_panic("alice.near");

let alice: AccountId = "alice.near".parse().unwrap();

assert!("ƒelicia.near".parse::<AccountId>().is_err()); // (ƒ is not f)

Structs

  • AccountId
    NEAR Account Identifier.
  • AccountIdRef
    Account identifier. This is the human readable UTF-8 string which is used internally to index accounts on the network and their respective state.
  • ParseAccountError
    An error which can be returned when parsing a NEAR Account ID.

Enums