ic_wire/
lib.rs

1//! Bounded Postcard contracts for controlled IC endpoints.
2//!
3//! Transport, authentication, semantic validation and replay policy belong to
4//! consumers. See the runtime guide for maintained wire rules.
5#![no_std]
6#![doc = include_str!("../README.md")]
7extern crate alloc;
8mod bounded;
9mod contract;
10mod float;
11pub mod native;
12pub mod schema;
13mod shape;
14/// Optional host-side TypeScript generation; never required by a canister.
15#[cfg(feature = "typescript")]
16pub mod typescript;
17pub use bounded::{Bytes, BytesRef, List, Text, TextRef};
18pub use contract::{
19    Method, RequestBytes, ResponseBytes, decode_request, decode_response, encode_request,
20    encode_request_into, encode_response, encode_response_into, encoded_request_len,
21    encoded_response_len,
22};
23pub use float::{FiniteF32, FiniteF64};
24pub use ic_wire_derive::Wire;
25pub use shape::{Limits, Shape, Wire};
26
27/// Implementation dependencies used by generated contracts.
28#[doc(hidden)]
29pub mod __private {
30    pub use serde;
31}
32
33/// Typed codec/admission failure, distinct from transport and application errors.
34#[derive(Clone, Copy, Debug, Eq, PartialEq)]
35pub enum Error {
36    /// Wire, collection or text allowance exceeded.
37    Limit,
38    /// The declared schema exceeds the method's resource allowances.
39    SchemaLimit,
40    /// Allocation failed within an admitted allowance.
41    Allocation,
42    /// Invalid or truncated Postcard representation.
43    Malformed,
44    /// Bytes remain after the expected value.
45    Trailing,
46    /// A valid value used a noncanonical representation.
47    Noncanonical,
48    /// Envelope marker, method identity or direction differs.
49    Identity,
50}
51impl core::fmt::Display for Error {
52    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
53        write!(f, "wire {self:?}")
54    }
55}
56impl core::error::Error for Error {}
ic_wire/lib.rs

ic_wire/
lib.rs
