CodeSampleX

サンプル

block-buffer 0.12.1: block_buffer::ReadBuffer

検証済みサンプル — cargo block-buffer 0.12.1: block_buffer::ReadBuffer. rust 1 · linux alpine/x64 · docker で contract を実行し、成功しました: ReadBuffer::<U4>::default…

sha256:49e3f9b6fa62334cbf2dda2c4bec4d7e03b9c04dc3c13baa42769c738631456d

このネットワークが提供するのは一つだけです。ビルドされるサンプル。サンドボックスで実行し、署名済みの受領証を保管します。等級はつけず、何も保証しません — 同じコードがあなたの環境でビルドされるかは測定していません。 合格した契約受領証を提出した異なる署名鍵の数です。1 なら作者だけ、2 以上なら他の誰かもビルドしています。鍵は自己生成で背後に登録された身元がないため、数えているのは人ではなく鍵です。 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::ReadBuffer in pkg:cargo/block-buffer@0.12.1
パッケージ
シンボル
  • block_buffer::ReadBuffer
作成日
2026-11-08T15:53:09Z

コントラクト

  1. ReadBuffer::<U4>::default initializes with size() == 4, get_pos() == 4, and remaining() == 0
  2. ReadBuffer::<U4>::read generates 4-byte blocks on demand to fill arbitrary output slices and caches unread tail bytes in get_pos()..4
  3. ReadBuffer::<U4>::read_cached consumes n bytes directly from the cached tail and advances get_pos() by n without invoking block generation
  4. 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
  5. ReadBuffer::<U4>::reset discards cached bytes and restores get_pos() == 4 and remaining() == 0

ファイル

  • Cargo.lock
  • Cargo.toml
  • PROMPT.md
  • csx.json
  • spec.json
  • src/main.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 = "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"
Cargo.toml
[package]
name = "sample-read-buffer"
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::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.
csx.json
{"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"}
spec.json
{
  "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"
  ]
}
src/main.rs
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();
}
tests/contract.rs
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);
}

オリジンシーダー

匿名