Struct ChainId 

pub struct ChainId {
    pub namespace: String,
    pub reference: String,
}

A CAIP-2 compliant blockchain identifier.

Chain IDs uniquely identify blockchain networks across different ecosystems. The format is namespace:reference where:

• namespace identifies the blockchain family (e.g., eip155, solana)
• reference identifies the specific chain within that family

Serialization

Serializes to/from a colon-separated string: "eip155:8453"

Example

use x402_types::chain::ChainId;

let chain = ChainId::new("eip155", "8453");
let json = serde_json::to_string(&chain).unwrap();
assert_eq!(json, "\"eip155:8453\"");

Fields

namespace: String

The blockchain namespace (e.g., eip155 for EVM chains, solana for Solana).

reference: String

The chain-specific reference (e.g., 8453 for Base, 137 for Polygon).

Implementations

impl ChainId

pub fn new<N: Into<String>, R: Into<String>>(namespace: N, reference: R) -> Self

Creates a new chain ID from namespace and reference components.

Example

use x402_types::chain::ChainId;

let base = ChainId::new("eip155", "8453");
assert_eq!(base.namespace, "eip155");
assert_eq!(base.reference, "8453");

pub fn namespace(&self) -> &str

Returns the namespace component of the chain ID.

pub fn reference(&self) -> &str

Returns the reference component of the chain ID.

pub fn from_network_name(network_name: &str) -> Option<Self>

Creates a chain ID from a well-known network name.

This method looks up the network name in the registry of known networks (see crate::networks) and returns the corresponding chain ID.

Example

use x402_types::chain::ChainId;

let base = ChainId::from_network_name("base").unwrap();
assert_eq!(base.to_string(), "eip155:8453");

assert!(ChainId::from_network_name("unknown").is_none());

pub fn as_network_name(&self) -> Option<&'static str>

Returns the well-known network name for this chain ID, if any.

This is the reverse of ChainId::from_network_name.

Example

use x402_types::chain::ChainId;

let base = ChainId::new("eip155", "8453");
assert_eq!(base.as_network_name(), Some("base"));

let unknown = ChainId::new("eip155", "999999");
assert!(unknown.as_network_name().is_none());

Trait Implementations

impl Clone for ChainId

fn clone(&self) -> ChainId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChainId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChainId

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ChainId

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

Formats the value using the given formatter.

impl From<ChainId> for ChainIdPattern

fn from(chain_id: ChainId) -> Self

Converts to this type from the input type.

impl From<ChainId> for String

fn from(value: ChainId) -> Self

Converts to this type from the input type.

impl From<ChainId> for Vec<ChainId>

fn from(value: ChainId) -> Self

Converts to this type from the input type.

impl FromStr for ChainId

type Err = ChainIdFormatError

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 ChainId

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 ChainId

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

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ChainId

impl StructuralPartialEq for ChainId