CodeSampleX

Пример

zerocopy 0.8.62: FromBytes

Проверенный пример — cargo zerocopy 0.8.62: FromBytes. Контракт выполнен на rust 1 · linux alpine/x64 · docker и пройден: Deriving FromBytes on a #[repr(C)]…

sha256:01c1a5fe8287b9bdb83defa580899c2ee2684947e70c0d5a1ea79ffc9629615a

Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла. Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди. MIT-0

Свидетельства выполнения

Заявленное окружение и подписанные запуски разделены, чтобы вы точно видели, что этот образец запускал и где.

Основа свидетельства
Подписанный контракт пройден
Квитанции проверки
1
Ключи подписи, собравшие его
1
Заявленная среда linux x64 cargo

Среды запусков проверки

Окружение Контракт Этапы Запуск
rust 1 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · cargo@1rust:1-alpine@sha256:a10e64dd139b…
2026-10-16

Кейс

HOW
Цель
verify FromBytes in pkg:cargo/zerocopy@0.8.62
Пакеты
Символы
  • FromBytes
Создан
2026-10-16T16:23:47Z

Контракт

  1. Deriving FromBytes on a #[repr(C)] struct with no padding requires also deriving KnownLayout and Immutable
  2. FromBytes::read_from_bytes copies an exact-length byte slice into the struct regardless of alignment and returns Err on length mismatch
  3. FromBytes::read_from_prefix parses the leading sizeof::<Self>() bytes and returns the parsed value paired with the remaining byte slice
  4. FromBytes::ref_from_bytes borrows an aligned exact-length byte slice as &Self without copying

Файлы

  • Cargo.lock
  • Cargo.toml
  • PROMPT.md
  • csx.json
  • spec.json
  • src/lib.rs
  • src/main.rs
  • test/contract.rs
  • tests/contract.rs

Скачать артефакт с исходным кодом (tar.gz)

Исходный код

Cargo.lock
# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4

[[package]]
name = "proc-macro2"
version = "1.0.107"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
dependencies = [
 "unicode-ident",
]

[[package]]
name = "quote"
version = "1.0.47"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
dependencies = [
 "proc-macro2",
]

[[package]]
name = "sample"
version = "0.1.0"
dependencies = [
 "zerocopy",
]

[[package]]
name = "syn"
version = "2.0.119"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
dependencies = [
 "proc-macro2",
 "quote",
 "unicode-ident",
]

[[package]]
name = "unicode-ident"
version = "1.0.27"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"

[[package]]
name = "zerocopy"
version = "0.8.62"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "86502bf56ac7c77571a32e2647bb2a15894565e981fb2a48d7bde2d91c965a9d"
dependencies = [
 "zerocopy-derive",
]

[[package]]
name = "zerocopy-derive"
version = "0.8.62"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5457206954b06561e2608c7e19cf58b1926586d999c246eebe4502f7e2039d1a"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]
Cargo.toml
[package]
name = "sample"
version = "0.1.0"
edition = "2021"

[dependencies]
zerocopy = { version = "=0.8.62", features = ["derive"] }
PROMPT.md
Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify FromBytes in pkg:cargo/zerocopy@0.8.62
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/zerocopy@0.8.62
Demonstrate these symbols/APIs:
  - FromBytes

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.
csx.json
{"case":{"caseId":"case:sha256:a38f8ca69d55c550a5b11093e57d0a1a2147ba1ddc20162ec310cd05d2458535","contract":["Deriving FromBytes on a #[repr(C)] struct with no padding requires also deriving KnownLayout and Immutable","FromBytes::read_from_bytes copies an exact-length byte slice into the struct regardless of alignment and returns Err on length mismatch","FromBytes::read_from_prefix parses the leading sizeof::\u003cSelf\u003e() bytes and returns the parsed value paired with the remaining byte slice","FromBytes::ref_from_bytes borrows an aligned exact-length byte slice as \u0026Self without copying"],"goal":"verify FromBytes in pkg:cargo/zerocopy@0.8.62","kind":"HOW","packages":["pkg:cargo/zerocopy@0.8.62"],"schemaVersion":1,"symbols":["FromBytes"]},"contractCommand":["cargo","run","--offline"],"environment":{"arch":"x64","ecosystem":"cargo","os":"linux","packageManager":"cargo","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/zerocopy@0.8.62"],"schemaVersion":1,"subject":"pkg:cargo/zerocopy@0.8.62","symbols":["FromBytes"],"verifierAdapter":"cargo@1"}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify FromBytes in pkg:cargo/zerocopy@0.8.62",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/zerocopy@0.8.62"
  ],
  "symbols": [
    "FromBytes"
  ]
}
src/lib.rs
use zerocopy::{FromBytes, FromZeros, Immutable, KnownLayout};

#[repr(C)]
#[derive(Debug, PartialEq, Eq, FromBytes, KnownLayout, Immutable)]
pub struct Header {
    pub magic: u16,
    pub version: u8,
    pub flags: u8,
    pub length: u32,
}

pub fn run_contract() {
    let raw: [u8; 8] = [
        0x34, 0x12, // magic (little-endian 0x1234)
        0x01,       // version
        0x80,       // flags
        0x04, 0x00, 0x00, 0x00, // length (little-endian 4)
    ];

    // 1. Copy-convert an aligned or unaligned byte slice into the struct
    let parsed = Header::read_from_bytes(&raw).expect("exact 8-byte buffer should parse");
    assert_eq!(parsed.magic, u16::from_le_bytes([0x34, 0x12]));
    assert_eq!(parsed.version, 1);
    assert_eq!(parsed.flags, 0x80);
    assert_eq!(parsed.length, u32::from_le_bytes([0x04, 0x00, 0x00, 0x00]));

    // 2. Read prefix from a longer slice
    let longer: [u8; 10] = [0x34, 0x12, 0x02, 0x00, 0x08, 0x00, 0x00, 0x00, 0xff, 0xfe];
    let (prefix, suffix) =
        Header::read_from_prefix(&longer).expect("longer buffer has valid prefix");
    assert_eq!(prefix.version, 2);
    assert_eq!(suffix, &[0xff, 0xfe]);

    // 3. Zero-copy reference from a sufficiently aligned slice
    #[repr(C, align(4))]
    struct Aligned([u8; 8]);
    let aligned = Aligned(raw);
    let ref_header =
        Header::ref_from_bytes(&aligned.0).expect("4-byte aligned 8-byte buffer yields &Header");
    assert_eq!(ref_header, &parsed);

    // 4. Reject short buffers cleanly
    assert!(Header::read_from_bytes(&raw[..7]).is_err());

    // 5. Zeroed creation via FromZeros (supertrait of FromBytes)
    let zeroed = Header::new_zeroed();
    assert_eq!(
        zeroed,
        Header {
            magic: 0,
            version: 0,
            flags: 0,
            length: 0,
        }
    );
}
src/main.rs
fn main() {
    sample::run_contract();
}
test/contract.rs
fn main() {
    sample::run_contract();
}
tests/contract.rs
#[test]
fn contract() {
    sample::run_contract();
}

Исходный сидер

аноним