CodeSampleX

Exemple

block-buffer 0.12.1: block_buffer::EagerBuffer

Échantillon vérifié pour cargo block-buffer 0.12.1: block_buffer::EagerBuffer. Le contrat s'est exécuté sur rust 1 · linux alpine/x64 · docker et a réussi.

sha256:5647da50cc43428419f910b2f4a06f460895210244aa67c3e26e3ca922f08328

Ce réseau offre une seule chose : un échantillon qui compile. Il l'a exécuté dans un bac à sable et conservé le reçu signé. Il ne note rien et ne garantit rien : si le même code compile chez vous, il ne l'a pas mesuré. Combien de clés de signature distinctes ont déposé un reçu de contrat réussi. Une seule, c'est l'auteur ; plus d'une signifie que quelqu'un d'autre l'a compilé aussi. Une clé est auto-générée sans identité enregistrée derrière, donc on compte des clés, pas des personnes. MIT-0

Preuves d'exécution

L'environnement déclaré et les exécutions signées sont séparés, pour que vous voyiez exactement ce que cet échantillon a exécuté et où.

Base de preuve
Contrat signé réussi
Reçus de vérification
1
Clés de signature qui l’ont compilé
1
Environnement déclaré linux x64 cargo

Environnements des exécutions de vérification

Environnement Contrat Étapes Exécution
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-11-08

Cas

HOW
Objectif
verify block_buffer::EagerBuffer in pkg:cargo/block-buffer@0.12.1
Paquets
Symboles
  • block_buffer::EagerBuffer
Créé
2026-11-08T15:17:38Z

Contrat

  1. EagerBuffer::<U4>::try_new accepts slices shorter than 4 bytes and returns Error for len >= 4
  2. EagerBuffer::<U4>::digest_blocks yields full 4-byte blocks immediately and buffers only the <4-byte remainder
  3. EagerBuffer::<U4>::serialize and deserialize round-trip a 4-byte SerializedBuffer<U4, Eager> ([pos, data.., 0..]) and reject pos >= 4 or non-zero trailing bytes
  4. EagerBuffer::<U4>::pad_with_zeros and digest_pad zero-pad buffered bytes (emitting 1 or 2 blocks for delimiter + suffix) and reset get_pos() to 0

Fichiers

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

Télécharger l’artefact source (tar.gz)

Code source

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

[[package]]
name = "block-buffer"
version = "0.12.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d2f6c7dbe95a6ed67ad9f18e57daf93a2f034c524b99fd2b76d18fdfeb6660aa"
dependencies = [
 "hybrid-array",
]

[[package]]
name = "hybrid-array"
version = "0.4.15"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "27f864f10dfb56725ce5ce5472bc52252c8f93a4ab86327122cebf62c5f59a17"
dependencies = [
 "typenum",
]

[[package]]
name = "sample-block-buffer-eager"
version = "0.1.0"
dependencies = [
 "block-buffer",
]

[[package]]
name = "typenum"
version = "1.20.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
Cargo.toml
[package]
name = "sample-block-buffer-eager"
version = "0.1.0"
edition = "2021"

[dependencies]
block-buffer = "=0.12.1"
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 block_buffer::EagerBuffer in pkg:cargo/block-buffer@0.12.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:cargo/block-buffer@0.12.1
Demonstrate these symbols/APIs:
  - block_buffer::EagerBuffer

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:2b6de12ea6dbbc59aec19d5241d606941e30901cbdff7930db4097c8825cceaf","contract":["EagerBuffer::\u003cU4\u003e::try_new accepts slices shorter than 4 bytes and returns Error for len \u003e= 4","EagerBuffer::\u003cU4\u003e::digest_blocks yields full 4-byte blocks immediately and buffers only the \u003c4-byte remainder","EagerBuffer::\u003cU4\u003e::serialize and deserialize round-trip a 4-byte SerializedBuffer\u003cU4, Eager\u003e ([pos, data.., 0..]) and reject pos \u003e= 4 or non-zero trailing bytes","EagerBuffer::\u003cU4\u003e::pad_with_zeros and digest_pad zero-pad buffered bytes (emitting 1 or 2 blocks for delimiter + suffix) and reset get_pos() to 0"],"goal":"verify block_buffer::EagerBuffer in pkg:cargo/block-buffer@0.12.1","kind":"HOW","packages":["pkg:cargo/block-buffer@0.12.1"],"schemaVersion":1,"symbols":["block_buffer::EagerBuffer"]},"contractCommand":["cargo","run","--offline"],"environment":{"arch":"x64","ecosystem":"cargo","os":"linux","packageManager":"cargo","schemaVersion":1},"license":"MIT-0","packages":["pkg:cargo/block-buffer@0.12.1"],"schemaVersion":1,"subject":"pkg:cargo/block-buffer@0.12.1","symbols":["block_buffer::EagerBuffer"],"verifierAdapter":"cargo@1"}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify block_buffer::EagerBuffer in pkg:cargo/block-buffer@0.12.1",
  "kind": "HOW",
  "packages": [
    "pkg:cargo/block-buffer@0.12.1"
  ],
  "symbols": [
    "block_buffer::EagerBuffer"
  ]
}
src/main.rs
use block_buffer::array::{Array, typenum::U4};
use block_buffer::{EagerBuffer, Error};

fn verify_eager_buffer() {
    // 1. Construction and invariant: EagerBuffer::<U4> holds strictly fewer than 4 bytes (pos in 0..4)
    let from_slice = EagerBuffer::<U4>::try_new(b"abc").expect("slice len < 4 succeeds");
    assert_eq!(from_slice.size(), 4);
    assert_eq!(from_slice.get_pos(), 3);
    assert_eq!(from_slice.remaining(), 1);
    assert_eq!(from_slice.get_data(), b"abc");

    assert_eq!(EagerBuffer::<U4>::try_new(b"abcd").unwrap_err(), Error);
    assert_eq!(EagerBuffer::<U4>::try_new(b"abcde").unwrap_err(), Error);

    // 2. Immediate block emission via digest_blocks
    let mut buf = EagerBuffer::<U4>::default();
    assert_eq!(buf.get_pos(), 0);
    assert_eq!(buf.remaining(), 4);

    let mut emitted: Vec<[u8; 4]> = Vec::new();
    buf.digest_blocks(b"abcdefghij", |blocks| {
        for block in blocks {
            emitted.push((*block).into());
        }
    });
    assert_eq!(emitted, vec![*b"abcd", *b"efgh"]);
    assert_eq!(buf.get_pos(), 2);
    assert_eq!(buf.remaining(), 2);
    assert_eq!(buf.get_data(), b"ij");

    // 3. Serialization and deserialization round-trip (4-byte SerializedBuffer<U4, Eager>)
    let serialized = buf.serialize();
    assert_eq!(serialized.as_slice(), &[2, b'i', b'j', 0]);

    let restored = EagerBuffer::<U4>::deserialize(&serialized).expect("valid serialized buffer");
    assert_eq!(restored.get_pos(), 2);
    assert_eq!(restored.get_data(), b"ij");

    // Deserialization rejects out-of-range pos (>= 4) or non-zero trailing bytes
    let mut bad_tail = serialized;
    bad_tail[3] = 0xff;
    assert_eq!(EagerBuffer::<U4>::deserialize(&bad_tail).unwrap_err(), Error);

    let mut bad_pos = serialized;
    bad_pos[0] = 4;
    assert_eq!(EagerBuffer::<U4>::deserialize(&bad_pos).unwrap_err(), Error);

    // Completing the exact 4-byte boundary flushes immediately in Eager mode
    buf.digest_blocks(b"kl", |blocks| {
        for block in blocks {
            emitted.push((*block).into());
        }
    });
    assert_eq!(emitted, vec![*b"abcd", *b"efgh", *b"ijkl"]);
    assert_eq!(buf.get_pos(), 0);
    assert_eq!(buf.get_data(), b"");

    // 4. Zero-padding and reset
    buf.digest_blocks(b"xy", |_| unreachable!());
    let padded: Array<u8, U4> = buf.pad_with_zeros();
    assert_eq!(padded.as_slice(), &[b'x', b'y', 0, 0]);
    assert_eq!(buf.get_pos(), 0);

    // 5. Delimiter + suffix padding via digest_pad (single-block and two-block cases)
    buf.digest_blocks(b"a", |_| unreachable!());
    let mut single_pad: Vec<[u8; 4]> = Vec::new();
    buf.digest_pad(0x80, &[0x11, 0x22], |block| single_pad.push((*block).into()));
    assert_eq!(single_pad, vec![[b'a', 0x80, 0x11, 0x22]]);
    assert_eq!(buf.get_pos(), 0);

    buf.digest_blocks(b"abc", |_| unreachable!());
    let mut double_pad: Vec<[u8; 4]> = Vec::new();
    buf.digest_pad(0x80, &[0x33, 0x44], |block| double_pad.push((*block).into()));
    assert_eq!(
        double_pad,
        vec![[b'a', b'b', b'c', 0x80], [0x00, 0x00, 0x33, 0x44]]
    );
    assert_eq!(buf.get_pos(), 0);

    // Explicit reset clears buffered bytes
    buf.digest_blocks(b"qw", |_| unreachable!());
    assert_eq!(buf.get_pos(), 2);
    buf.reset();
    assert_eq!(buf.get_pos(), 0);
}

fn main() {
    verify_eager_buffer();
}
tests/contract.rs
use block_buffer::array::typenum::U4;
use block_buffer::{EagerBuffer, Error};

#[test]
fn contract_eager_buffer() {
    assert!(EagerBuffer::<U4>::try_new(b"abc").is_ok());
    assert_eq!(EagerBuffer::<U4>::try_new(b"abcd").unwrap_err(), Error);

    let mut buf = EagerBuffer::<U4>::default();
    let mut blocks_out: Vec<[u8; 4]> = Vec::new();
    buf.digest_blocks(b"abcdefghij", |blocks| {
        for b in blocks {
            blocks_out.push((*b).into());
        }
    });
    assert_eq!(blocks_out, vec![*b"abcd", *b"efgh"]);
    assert_eq!(buf.get_pos(), 2);
    assert_eq!(buf.get_data(), b"ij");

    let ser = buf.serialize();
    assert_eq!(ser.as_slice(), &[2, b'i', b'j', 0]);
    let de = EagerBuffer::<U4>::deserialize(&ser).unwrap();
    assert_eq!(de.get_data(), b"ij");

    let padded = buf.pad_with_zeros();
    assert_eq!(padded.as_slice(), &[b'i', b'j', 0, 0]);
    assert_eq!(buf.get_pos(), 0);
}

Seeder d'origine

anonyme