Enum Ipld 

pub enum Ipld {
    Null,
    Bool(bool),
    Integer(i128),
    Float(f64),
    String(String),
    Bytes(Vec<u8>),
    List(Vec<Ipld>),
    Map(BTreeMap<String, Ipld>),
    Link(SerializableCid),
}

IPLD data model

Represents the core IPLD data types that can be stored and transferred across the IPFRS network.

Variants

Null

Null value

Bool(bool)

Boolean value

Integer(i128)

Integer value (supports full i128 range)

Float(f64)

Float value (IEEE 754 double precision)

String(String)

String value (UTF-8)

Bytes(Vec<u8>)

Bytes value (raw binary data)

List(Vec<Ipld>)

List of IPLD values

Map(BTreeMap<String, Ipld>)

Map of string keys to IPLD values (keys are sorted)

Link(SerializableCid)

Link to another IPLD node via CID

Implementations

impl Ipld

pub fn link(cid: Cid) -> Self

Create a link to a CID

pub fn is_link(&self) -> bool

Check if this is a link

pub fn as_link(&self) -> Option<&Cid>

Extract CID if this is a link

pub fn to_dag_cbor(&self) -> Result<Vec<u8>>

Encode this IPLD value to DAG-CBOR format

DAG-CBOR is a deterministic subset of CBOR with:

• Map keys sorted by byte ordering
• No indefinite-length items
• CID links encoded with tag 42

pub fn from_dag_cbor(data: &[u8]) -> Result<Self>

Decode IPLD value from DAG-CBOR format

pub fn to_dag_json(&self) -> Result<String>

Encode this IPLD value to DAG-JSON format

DAG-JSON is a JSON encoding for IPLD with special handling for:

• Bytes (encoded as {"/": {"bytes": "<base64>"}})
• Links (encoded as {"/": "<cid-string>"})

pub fn from_dag_json(json: &str) -> Result<Self>

Decode IPLD value from DAG-JSON format

pub fn to_json(&self) -> Result<String>

Encode this IPLD value to JSON format (simple, for debugging)

pub fn from_json(json: &str) -> Result<Self>

Decode IPLD value from JSON format

pub fn links(&self) -> Vec<Cid>

Get all CID links contained in this IPLD structure (recursively)

pub const fn is_null(&self) -> bool

Check if this is a null value

pub const fn is_bool(&self) -> bool

Check if this is a boolean value

pub const fn is_integer(&self) -> bool

Check if this is an integer value

pub const fn is_float(&self) -> bool

Check if this is a float value

pub const fn is_string(&self) -> bool

Check if this is a string value

pub const fn is_bytes(&self) -> bool

Check if this is a bytes value

pub const fn is_list(&self) -> bool

Check if this is a list value

pub const fn is_map(&self) -> bool

Check if this is a map value

pub const fn as_bool(&self) -> Option<bool>

Extract boolean value if this is a Bool

pub const fn as_integer(&self) -> Option<i128>

Extract integer value if this is an Integer

pub const fn as_float(&self) -> Option<f64>

Extract float value if this is a Float

pub fn as_string(&self) -> Option<&str>

Extract string reference if this is a String

pub fn as_bytes(&self) -> Option<&[u8]>

Extract bytes reference if this is Bytes

pub fn as_list(&self) -> Option<&[Ipld]>

Extract list reference if this is a List

pub fn as_map(&self) -> Option<&BTreeMap<String, Ipld>>

Extract map reference if this is a Map

pub fn get(&self, key: &str) -> Option<&Ipld>

Get a value from a map by key (if this is a Map)

pub fn index(&self, idx: usize) -> Option<&Ipld>

Get a value from a list by index (if this is a List)

pub fn len(&self) -> usize

Get the size/length of this IPLD value

• For List: number of elements
• For Map: number of key-value pairs
• For String: length in bytes
• For Bytes: length in bytes
• For other types: 0

pub fn is_empty(&self) -> bool

Check if this IPLD value is empty

• For List/Map/String/Bytes: checks if length is 0
• For Null: true
• For other types: false

pub const fn type_name(&self) -> &'static str

Get a human-readable type name for this IPLD value

Trait Implementations

impl Clone for Ipld

fn clone(&self) -> Ipld

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ipld

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Ipld

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&str> for Ipld

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<Cid<64>> for Ipld

fn from(cid: Cid) -> Self

Converts to this type from the input type.

impl From<String> for Ipld

fn from(s: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for Ipld

fn from(bytes: Vec<u8>) -> Self

Converts to this type from the input type.

impl From<bool> for Ipld

fn from(b: bool) -> Self

Converts to this type from the input type.

impl From<f64> for Ipld

fn from(f: f64) -> Self

Converts to this type from the input type.

impl From<i128> for Ipld

fn from(i: i128) -> Self

Converts to this type from the input type.

impl From<i64> for Ipld

fn from(i: i64) -> Self

Converts to this type from the input type.

impl From<u64> for Ipld

fn from(u: u64) -> Self

Converts to this type from the input type.

impl PartialEq for Ipld

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

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Ipld