Struct Pin

pub struct Pin {
    pub kind: String,
    pub version: String,
    pub metadata: Metadata,
    pub spec: PinSpec,
    pub status: Option<PinStatus>,
}

Represents a Pin resource for storing data in the network

A Pin defines what data should be stored, for how long, and with what redundancy level. The data can be referenced either by CID or fallback URLs.

Examples

Creating a Pin with CID:

use crate::models::{Pin, PinSpec, Metadata};

let pin = Pin {
    kind: "Pin".to_string(),
    version: "v0".to_string(),
    metadata: Metadata {
        name: "my-data".to_string(),
        ..Default::default()
    },
    spec: PinSpec {
        cid: Some("QmExample123".to_string()),
        bytes: "1GB".parse().unwrap(),
        time: "24h".parse().unwrap(),
        redundancy: 3,
        fallback_urls: None,
    },
    status: None,
};

Creating a Pin with fallback URLs:

use crate::models::{Pin, PinSpec, Metadata};

let pin = Pin {
    kind: "Pin".to_string(),
    version: "v0".to_string(),
    metadata: Metadata {
        name: "my-backup".to_string(),
        ..Default::default()
    },
    spec: PinSpec {
        cid: None,
        bytes: "500MB".parse().unwrap(),
        time: "7d".parse().unwrap(),
        redundancy: 2,
        fallback_urls: Some(vec![
            "https://example.com/backup1".to_string(),
            "https://backup.example.com/data".to_string()
        ]),
    },
    status: None,
};

Fields

kind: String

version: String

metadata: Metadata

spec: PinSpec

status: Option<PinStatus>

Trait Implementations

impl Debug for Pin

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Pin

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Pin> for Pin

fn from(proto: Pin) -> Self

Converts to this type from the input type.

impl Serialize for Pin

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.