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 (426891/25000 cyc/op); well-suited for high-frequency pipeline stages.

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

Hardware _rdtsc: 426891/25000 cycles/op
Latency: 3252897/400000 ns/op
Throughput: 400000000/3252897 ops/us
Compiled ELF64 .text: 415 B (105 x86_64 insns)
C64 64KB RAM Budget: 375/65536 (375 B source)
Ternary Vote: + (score 1) | Salience: 53069/624
Pure-Rust Capsule Source Code (375 B)
pub fn internet_checksum(data: &[u8]) -> u16 {
    let mut sum: u32 = 0;
    let mut i = 0;
    while i + 1 < data.len() {
        sum += u16::from_be_bytes([data[i], data[i + 1]]) as u32;
        i += 2;
    }
    if i < data.len() {
        sum += (data[i] as u32) << 8;
    }
    while sum >> 16 != 0 {
        sum = (sum & 0xFFFF) + (sum >> 16);
    }
    !(sum as u16)
}
rustc -C opt-level=3 x86_64 Disassembly (415 B .text / 105 insns)
internet_checksum:
    cmp    rsi, 2
    jb    .LBB7_1
    lea    rdx, [rsi - 2]
    cmp    rdx, 14
    jae    .LBB7_9
    xor    eax, eax
    xor    ecx, ecx
    jmp    .LBB7_12
.LBB7_1:
    xor    ecx, ecx
    xor    eax, eax
    jmp    .LBB7_2
.LBB7_9:
    shr    rdx
    inc    rdx
    mov    r8, rdx
    and    r8, -8
    lea    rcx, [r8 + r8]
    pxor    xmm1, xmm1
    xor    eax, eax
    pxor    xmm2, xmm2
    pxor    xmm0, xmm0
.LBB7_10:
    movzx    r9d, byte ptr [rdi + 2*rax]
    movzx    r10d, byte ptr [rdi + 2*rax + 2]
    movzx    r11d, byte ptr [rdi + 2*rax + 4]
    shl    r10d, 8
    or    r10d, r9d
    shl    r11d, 16
    or    r11d, r10d
    movzx    r9d, byte ptr [rdi + 2*rax + 6]
    shl    r9d, 24
    or    r9d, r11d
    movd    xmm4, r9d
    movzx    r9d, byte ptr [rdi + 2*rax + 8]
    movzx    r10d, byte ptr [rdi + 2*rax + 10]
    movzx    r11d, byte ptr [rdi + 2*rax + 12]
    shl    r10d, 8
    or    r10d, r9d
    shl    r11d, 16
    or    r11d, r10d
    movzx    r9d, byte ptr [rdi + 2*rax + 14]
    shl    r9d, 24
    or    r9d, r11d
    movd    xmm3, r9d
    movzx    r9d, byte ptr [rdi + 2*rax + 1]
    movzx    r10d, byte ptr [rdi + 2*rax + 3]
    movzx    r11d, byte ptr [rdi + 2*rax + 5]
    shl    r10d, 8
    or    r10d, r9d
    shl    r11d, 16
    or    r11d, r10d
    movzx    r9d, byte ptr [rdi + 2*rax + 7]
    shl    r9d, 24
    or    r9d, r11d
    movd    xmm5, r9d
    punpcklbw    xmm5, xmm4
    movzx    r9d, byte ptr [rdi + 2*rax + 9]
    movzx    r10d, byte ptr [rdi + 2*rax + 11]
    movzx    r11d, byte ptr [rdi + 2*rax + 13]
    shl    r10d, 8
    or    r10d, r9d
    shl    r11d, 16
    or    r11d, r10d
    movzx    r9d, byte ptr [rdi + 2*rax + 15]
    shl    r9d, 24
    or    r9d, r11d
    movd    xmm4, r9d
    punpcklbw    xmm4, xmm3
    punpcklwd    xmm5, xmm1
    paddd    xmm2, xmm5
    punpcklwd    xmm4, xmm1
    paddd    xmm0, xmm4
    add    rax, 8
    cmp    r8, rax
    jne    .LBB7_10
    paddd    xmm0, xmm2
    pshufd    xmm1, xmm0, 238
    paddd    xmm1, xmm0
    pshufd    xmm0, xmm1, 85
    paddd    xmm0, xmm1
    movd    eax, xmm0
    cmp    rdx, r8
    je    .LBB7_2
.LBB7_12:
    mov    rdx, rcx
.LBB7_13:
    movzx    ecx, word ptr [rdi + rdx]
    rol    cx, 8
    movzx    ecx, cx
    add    eax, ecx
    lea    rcx, [rdx + 2]
    add    rdx, 3
    cmp    rdx, rsi
    mov    rdx, rcx
    jb    .LBB7_13
.LBB7_2:
    cmp    rcx, rsi
    jae    .LBB7_5
    movzx    ecx, byte ptr [rdi + rcx]
    shl    ecx, 8
    add    ecx, eax
    mov    eax, ecx
    jmp    .LBB7_5
.LBB7_4:
    movzx    eax, ax
    add    eax, ecx
.LBB7_5:
    mov    ecx, eax
    shr    ecx, 16
    jne    .LBB7_4
    not    eax
    ret

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

Global RankCapsule & DomainHardware _rdtscLatencyThroughputELF .textTernary VoteAuthor Aye
#1669internet_checksum (THIS CAPSULE)
domain: aye-x86_64 | id: 11db7045e45e6f67670b2a00981cbc48
426891/25000 cyc/op3252897/400000 ns/op400000000/3252897 ops/us415 B .text (105 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz