Ejemplo
block-buffer 0.12.1: block_buffer::ReadBuffer
Muestra verificada para cargo block-buffer 0.12.1: block_buffer::ReadBuffer. El contrato se ejecutó en rust 1 · linux alpine/x64 · docker y pasó.
sha256:49e3f9b6fa62334cbf2dda2c4bec4d7e03b9c04dc3c13baa42769c738631456d
Esta red ofrece una sola cosa: una muestra que compila. La ejecutó en un sandbox y guardó el recibo firmado. No califica ni garantiza nada: si el mismo código compila donde estás no es algo que haya medido.
Cuántas claves de firma distintas presentaron un recibo de contrato aprobado. Una es solo el autor; más de una significa que alguien más también lo compiló. Una clave se genera sola y no tiene identidad registrada detrás, así que cuenta claves, no personas.
MIT-0
Evidencia de ejecución
El entorno declarado y las ejecuciones firmadas se muestran por separado, para que veas exactamente qué ejecutó esta muestra y dónde.
- Base de evidencia
- Contrato firmado aprobado
- Recibos de verificación
- 1
- Claves de firma que lo compilaron
- 1
Entorno declarado
linux x64 cargo
Entornos de las ejecuciones de verificación
| Entorno | Contrato | Etapas | Ejecución |
|---|---|---|---|
| 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 |
Caso
HOW- Objetivo
- verify block_buffer::ReadBuffer in pkg:cargo/block-buffer@0.12.1
- Paquetes
- Símbolos
-
- block_buffer::ReadBuffer
- Creado
- 2026-11-08T15:53:09Z
Contrato
- ReadBuffer::<U4>::default initializes with size() == 4, get_pos() == 4, and remaining() == 0
- ReadBuffer::<U4>::read generates 4-byte blocks on demand to fill arbitrary output slices and caches unread tail bytes in get_pos()..4
- ReadBuffer::<U4>::read_cached consumes n bytes directly from the cached tail and advances get_pos() by n without invoking block generation
- ReadBuffer::<U4>::serialize writes get_pos() at byte 0, zeroizes consumed prefix indices 1..get_pos(), and preserves unread cached bytes at get_pos()..4; deserialize restores that state and rejects non-zero consumed prefix bytes or out-of-range pos with Error
- ReadBuffer::<U4>::reset discards cached bytes and restores get_pos() == 4 and remaining() == 0
Archivos
- Cargo.lock
- Cargo.toml
- PROMPT.md
- csx.json
- spec.json
- src/main.rs
- tests/contract.rs
Código fuente
# 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-read-buffer"
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"
[package]
name = "sample-read-buffer"
version = "0.1.0"
edition = "2021"
[dependencies]
block-buffer = "=0.12.1"
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::ReadBuffer 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::ReadBuffer
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.
{"case":{"caseId":"case:sha256:efe4ac338e7690a331e206a34bc81d32122819e4bc225c3c6dd28acd79eb7bd7","contract":["ReadBuffer::\u003cU4\u003e::default initializes with size() == 4, get_pos() == 4, and remaining() == 0","ReadBuffer::\u003cU4\u003e::read generates 4-byte blocks on demand to fill arbitrary output slices and caches unread tail bytes in get_pos()..4","ReadBuffer::\u003cU4\u003e::read_cached consumes n bytes directly from the cached tail and advances get_pos() by n without invoking block generation","ReadBuffer::\u003cU4\u003e::serialize writes get_pos() at byte 0, zeroizes consumed prefix indices 1..get_pos(), and preserves unread cached bytes at get_pos()..4; deserialize restores that state and rejects non-zero consumed prefix bytes or out-of-range pos with Error","ReadBuffer::\u003cU4\u003e::reset discards cached bytes and restores get_pos() == 4 and remaining() == 0"],"goal":"verify block_buffer::ReadBuffer in pkg:cargo/block-buffer@0.12.1","kind":"HOW","packages":["pkg:cargo/block-buffer@0.12.1"],"schemaVersion":1,"symbols":["block_buffer::ReadBuffer"]},"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::ReadBuffer"],"verifierAdapter":"cargo@1"}
{
"schemaVersion": 1,
"goal": "verify block_buffer::ReadBuffer in pkg:cargo/block-buffer@0.12.1",
"kind": "HOW",
"packages": [
"pkg:cargo/block-buffer@0.12.1"
],
"symbols": [
"block_buffer::ReadBuffer"
]
}
use block_buffer::array::typenum::U4;
use block_buffer::{Error, ReadBuffer};
fn verify_read_buffer() {
// 1. Default initialization: pos starts at block size (4) with 0 cached bytes remaining
let mut rb = ReadBuffer::<U4>::default();
assert_eq!(rb.size(), 4);
assert_eq!(rb.get_pos(), 4);
assert_eq!(rb.remaining(), 0);
// 2. Reading across block boundaries generates blocks on demand and caches unread tail bytes
let mut seq = 0u8;
let mut next_block = |block: &mut block_buffer::array::Array<u8, U4>| {
for byte in block.iter_mut() {
seq += 1;
*byte = seq;
}
};
// Read 2 bytes: generates block [1, 2, 3, 4], consumes [1, 2], caches [3, 4]
let mut first = [0u8; 2];
rb.read(&mut first, &mut next_block);
assert_eq!(first, [1, 2]);
assert_eq!(rb.get_pos(), 2);
assert_eq!(rb.remaining(), 2);
// read_cached consumes directly from the cached tail without generating a new block
let cached_one = rb.read_cached(1);
assert_eq!(cached_one, &[3]);
assert_eq!(rb.get_pos(), 3);
assert_eq!(rb.remaining(), 1);
// Reading 6 more bytes drains cached [4], generates full block [5, 6, 7, 8],
// and generates block [9, 10, 11, 12] to supply [9] while caching [10, 11, 12]
let mut span = [0u8; 6];
rb.read(&mut span, &mut next_block);
assert_eq!(span, [4, 5, 6, 7, 8, 9]);
assert_eq!(rb.get_pos(), 1);
assert_eq!(rb.remaining(), 3);
// After reading 1 more cached byte, pos == 2 and unread tail is [11, 12]
assert_eq!(rb.read_cached(1), &[10]);
assert_eq!(rb.get_pos(), 2);
assert_eq!(rb.remaining(), 2);
// 3. Serialization stores pos at index 0, zeroizes consumed prefix indices 1..pos,
// and preserves unread cached bytes in pos..block_size
let serialized = rb.serialize();
assert_eq!(serialized.as_slice(), &[2, 0, 11, 12]);
let mut restored = ReadBuffer::<U4>::deserialize(&serialized).expect("valid ReadBuffer state");
assert_eq!(restored.get_pos(), 2);
assert_eq!(restored.remaining(), 2);
assert_eq!(restored.read_cached(2), &[11, 12]);
assert_eq!(restored.get_pos(), 4);
assert_eq!(restored.remaining(), 0);
// Invalid serialized states: non-zero byte in consumed prefix (1..pos) or out-of-range pos
let mut bad_prefix = serialized;
bad_prefix[1] = 0xFF;
assert_eq!(ReadBuffer::<U4>::deserialize(&bad_prefix).unwrap_err(), Error);
let mut bad_pos = serialized;
bad_pos[0] = 0; // pos == 0 is invalid for ReadBuffer
assert_eq!(ReadBuffer::<U4>::deserialize(&bad_pos).unwrap_err(), Error);
let mut bad_pos_over = serialized;
bad_pos_over[0] = 5; // pos > 4 is invalid for ReadBuffer::<U4>
assert_eq!(ReadBuffer::<U4>::deserialize(&bad_pos_over).unwrap_err(), Error);
// 4. reset discards cached bytes and restores pos to block_size (remaining == 0)
rb.reset();
assert_eq!(rb.get_pos(), 4);
assert_eq!(rb.remaining(), 0);
}
fn main() {
verify_read_buffer();
}
use block_buffer::array::typenum::U4;
use block_buffer::{Error, ReadBuffer};
#[test]
fn contract_read_buffer() {
let mut rb = ReadBuffer::<U4>::default();
assert_eq!(rb.size(), 4);
assert_eq!(rb.get_pos(), 4);
assert_eq!(rb.remaining(), 0);
let mut seq = 0u8;
let mut gen_block = |block: &mut block_buffer::array::Array<u8, U4>| {
for b in block.iter_mut() {
seq += 1;
*b = seq * 10;
}
};
let mut out = [0u8; 6];
rb.read(&mut out, &mut gen_block);
assert_eq!(out, [10, 20, 30, 40, 50, 60]);
assert_eq!(rb.get_pos(), 2);
assert_eq!(rb.remaining(), 2);
let ser = rb.serialize();
assert_eq!(ser.as_slice(), &[2, 0, 70, 80]);
let mut restored = ReadBuffer::<U4>::deserialize(&ser).unwrap();
assert_eq!(restored.read_cached(2), &[70, 80]);
assert_eq!(restored.remaining(), 0);
let mut invalid = ser;
invalid[1] = 1;
assert_eq!(ReadBuffer::<U4>::deserialize(&invalid).unwrap_err(), Error);
rb.reset();
assert_eq!(rb.get_pos(), 4);
assert_eq!(rb.remaining(), 0);
}
Seeder de origen
anónimo