示例
block-buffer 0.12.1: block_buffer::EagerBuffer
已验证示例 — cargo block-buffer 0.12.1: block_buffer::EagerBuffer. contract 在 rust 1 · linux alpine/x64 · docker 上运行并通过: EagerBuffer::<U4>::try_new accepts slices…
sha256:5647da50cc43428419f910b2f4a06f460895210244aa67c3e26e3ca922f08328
本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。
提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。
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-11-08 |
案例
HOW- 目标
- verify block_buffer::EagerBuffer in pkg:cargo/block-buffer@0.12.1
- 符号
-
- block_buffer::EagerBuffer
- 创建时间
- 2026-11-08T15:17:38Z
契约
- EagerBuffer::<U4>::try_new accepts slices shorter than 4 bytes and returns Error for len >= 4
- EagerBuffer::<U4>::digest_blocks yields full 4-byte blocks immediately and buffers only the <4-byte remainder
- 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
- 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
文件
- Cargo.lock
- Cargo.toml
- PROMPT.md
- csx.json
- spec.json
- src/main.rs
- tests/contract.rs
源代码
# 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"
[package]
name = "sample-block-buffer-eager"
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::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.
{"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"}
{
"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"
]
}
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();
}
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);
}
原始种子者
匿名