Enum ArtifactMsg 

pub enum ArtifactMsg {
    MetaRequest {
        key: ArtifactKey,
    },
    Announce {
        id: ArtifactId,
        have: Bitfield,
    },
    Request {
        id: ArtifactId,
        pieces: Vec<u32>,
    },
    Meta {
        descriptor: ArtifactDescriptor,
    },
    Piece {
        id: ArtifactId,
        index: u32,
        offset: u64,
        data: Vec<u8>,
    },
    NoPiece {
        id: ArtifactId,
        index: u32,
    },
    Reject {
        key: ArtifactKey,
        reason: String,
    },
}

One artifact-protocol message.

Variants

MetaRequest

0x0B: ask a peer for an artifact’s descriptor and its have.

Fields

key: ArtifactKey

What is wanted.

Announce

0x0B: the pieces the sender holds, verified.

Fields

id: ArtifactId

Artifact.

have: Bitfield

Held pieces.

Request

0x0B: ask for pieces by index.

Fields

id: ArtifactId

Artifact.

pieces: Vec<u32>

Piece indexes.

Meta

0x0C: the descriptor.

Fields

descriptor: ArtifactDescriptor

Piece list.

Piece

0x0C: one block of piece data.

Fields

id: ArtifactId

Artifact.

index: u32

Piece index.

offset: u64

Byte offset of this block within the piece.

data: Vec<u8>

Block bytes.

NoPiece

0x0C: the sender cannot supply this piece.

Fields

id: ArtifactId

Artifact.

index: u32

Piece index.

Reject

0x0C: the request is refused (unknown, or not servable).

Fields

key: ArtifactKey

What was asked for.

reason: String

Short reason.

Implementations

impl ArtifactMsg

pub fn frame_type(&self) -> FrameType

Frame type this message travels in.

pub fn to_frame(&self) -> Result<MeshFrame, WireError>

Encode to a MeshFrame, refusing payloads over the cap.

pub fn to_wire(&self) -> Result<Vec<u8>, WireError>

Encode to stream bytes: [4-byte len][type][payload].

pub fn from_wire(raw: &[u8]) -> Result<Self, WireError>

Decode stream bytes produced by Self::to_wire. The declared length is checked against the cap before anything is parsed.

pub fn from_frame(frame: &MeshFrame) -> Result<Self, WireError>

Decode a MeshFrame of type 0x0B or 0x0C.

Trait Implementations

impl Clone for ArtifactMsg

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactMsg

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

Formats the value using the given formatter.

impl Eq for ArtifactMsg

impl PartialEq for ArtifactMsg

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ArtifactMsg