Best Use & Engineering Application Guide

Engineering Category: Cryptographic Mixing, Checksums & Wire Integrity

Best Use in Production: Fast wire-speed packet checksum verification, case-folded label hashing, and frame integrity sealing on network ingress paths.

When to Select This Capsule: Sole canonical implementation for its 64-vector functional equivalence class. Low-latency L1-resident kernel (40406/3125 cyc/op); well-suited for high-frequency pipeline stages.

Snap-Circuit Wiring Role: Slice Ingress / Scanner Stage `(&[u8])->u8` — digests raw byte buffers into scalar tokens or checksums.

Hardware _rdtsc: 40406/3125 cycles/op
Latency: 2463449/400000 ns/op
Throughput: 400000000/2463449 ops/us
Compiled ELF64 .text: 258 B (72 x86_64 insns)
C64 64KB RAM Budget: 375/65536 (375 B source)
Ternary Vote: + (score 1) | Salience: 260135/3036
Pure-Rust Capsule Source Code (375 B)
pub fn checksum(bytes: &[u8]) -> u8 {
    let (chunks, tail) = bytes.split_at(bytes.len() - bytes.len() % 8);
    let mut acc = 0u64;
    for chunk in chunks.chunks_exact(8) {
        acc ^= u64::from_le_bytes(chunk.try_into().unwrap());
    }
    let mut out = (acc ^ (acc >> 32) ^ (acc >> 16) ^ (acc >> 8) ^ acc) as u8;
    for b in tail {
        out ^= b;
    }
    out
}
rustc -C opt-level=3 x86_64 Disassembly (258 B .text / 72 insns)
checksum:
    mov    edx, esi
    and    edx, 7
    movabs    rcx, 9223372036854775800
    and    rcx, rsi
    je    .LBB7_1
    add    rsi, -8
    cmp    rsi, 24
    jae    .LBB7_13
    xor    eax, eax
    mov    r8, rdi
    mov    r9, rcx
    jmp    .LBB7_16
.LBB7_1:
    xor    eax, eax
    jmp    .LBB7_2
.LBB7_13:
    shr    rsi, 3
    inc    rsi
    mov    r10, rsi
    and    r10, -4
    lea    rax, [8*r10]
    lea    r8, [rdi + 8*r10]
    mov    r9, rcx
    sub    r9, rax
    pxor    xmm0, xmm0
    xor    eax, eax
    pxor    xmm1, xmm1
.LBB7_14:
    movdqu    xmm2, xmmword ptr [rdi + 8*rax]
    pxor    xmm1, xmm2
    movdqu    xmm2, xmmword ptr [rdi + 8*rax + 16]
    pxor    xmm0, xmm2
    add    rax, 4
    cmp    r10, rax
    jne    .LBB7_14
    pxor    xmm0, xmm1
    pshufd    xmm1, xmm0, 238
    pxor    xmm1, xmm0
    movq    rax, xmm1
    cmp    rsi, r10
    je    .LBB7_2
.LBB7_16:
    xor    esi, esi
.LBB7_17:
    xor    rax, qword ptr [r8 + rsi]
    add    rsi, 8
    cmp    r9, rsi
    jne    .LBB7_17
.LBB7_2:
    mov    rsi, rax
    shr    rsi, 32
    mov    r8d, eax
    shr    r8d, 16
    xor    esi, r8d
    shr    eax, 8
    xor    eax, esi
    test    rdx, rdx
    je    .LBB7_10
    xor    al, byte ptr [rdi + rcx]
    cmp    edx, 1
    je    .LBB7_10
    xor    al, byte ptr [rdi + rcx + 1]
    cmp    edx, 2
    je    .LBB7_10
    xor    al, byte ptr [rdi + rcx + 2]
    cmp    edx, 3
    je    .LBB7_10
    xor    al, byte ptr [rdi + rcx + 3]
    cmp    edx, 4
    je    .LBB7_10
    xor    al, byte ptr [rdi + rcx + 4]
    cmp    edx, 5
    je    .LBB7_10
    xor    al, byte ptr [rdi + rcx + 5]
    cmp    edx, 6
    je    .LBB7_10
    xor    al, byte ptr [rdi + rcx + 6]
.LBB7_10:
    ret

Head-to-Head Functional Equivalence Class Peers (1 Implementation(s) Matching 64 Test Vectors)

Global RankCapsule & DomainHardware _rdtscLatencyThroughputELF .textTernary VoteAuthor Aye
#1568checksum (THIS CAPSULE)
domain: 8b-kit-x86_64 | id: eb2d28c07613408d2d2fe3e301385d30
40406/3125 cyc/op2463449/400000 ns/op400000000/2463449 ops/us258 B .text (72 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz