Best Use & Engineering Application Guide

Engineering Category: Deterministic Sovereign Compute Kernel

Best Use in Production: Pure-Rust C64-bounded integer transformation kernel verified across 64 canonical test vectors for deterministic Snap-Circuit composition.

When to Select This Capsule: Sole canonical implementation for its 64-vector functional equivalence class. Multi-step compute kernel (7954767/200000 cyc/op); best used at frame, block, or batch aggregation boundaries.

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

Hardware _rdtsc: 7954767/200000 cycles/op
Latency: 947129/50000 ns/op
Throughput: 50000000/947129 ops/us
Compiled ELF64 .text: 1137 B (258 x86_64 insns)
C64 64KB RAM Budget: 949/65536 (949 B source)
Ternary Vote: + (score 1) | Salience: 148375/1716
Pure-Rust Capsule Source Code (949 B)
pub fn wupz_byte_diff(a: &[u8], b: &[u8]) -> u64 {
    let n = a.len().min(b.len());
    let mut count = 0u64;
    let mut i: usize = 0;
    while i + 8 <= n {
        let wa = u64::from_le_bytes([
            a[i],
            a[i + 1],
            a[i + 2],
            a[i + 3],
            a[i + 4],
            a[i + 5],
            a[i + 6],
            a[i + 7],
        ]);
        let wb = u64::from_le_bytes([
            b[i],
            b[i + 1],
            b[i + 2],
            b[i + 3],
            b[i + 4],
            b[i + 5],
            b[i + 6],
            b[i + 7],
        ]);
        let d = wa ^ wb;
        if d != 0 {
            let msb = ((d & 0x7f7f_7f7f_7f7f_7f7f) + 0x7f7f_7f7f_7f7f_7f7f) | d;
            count += u64::from((msb & 0x8080_8080_8080_8080).count_ones());
        }
        i += 8;
    }
    while i < n {
        if a[i] != b[i] {
            count += 1;
        }
        i += 1;
    }
    count
}
rustc -C opt-level=3 x86_64 Disassembly (1137 B .text / 258 insns)
wupz_byte_diff:
    push    rbp
    push    r15
    push    r14
    push    r13
    push    r12
    push    rbx
    push    rax
    cmp    rcx, rsi
    mov    r13, rsi
    cmovb    r13, rcx
    cmp    r13, 8
    jae    .LBB7_11
    xor    r9d, r9d
    mov    qword ptr [rsp], 0
.LBB7_2:
    mov    rcx, r13
    sub    rcx, r9
    jbe    .LBB7_3
    cmp    rcx, 4
    jae    .LBB7_7
    mov    rcx, r9
    mov    rax, qword ptr [rsp]
    jmp    .LBB7_6
.LBB7_11:
    xor    r8d, r8d
    mov    qword ptr [rsp], 0
    jmp    .LBB7_12
.LBB7_29:
    mov    r13, rax
    lea    r9, [r8 + 8]
    add    r8, 16
    cmp    r8, rax
    mov    r8, r9
    ja    .LBB7_2
.LBB7_12:
    cmp    r8, rsi
    jae    .LBB7_31
    lea    r9, [r8 + 1]
    cmp    r9, rsi
    jae    .LBB7_32
    lea    r10, [r8 + 2]
    cmp    r10, rsi
    jae    .LBB7_33
    lea    r11, [r8 + 3]
    cmp    r11, rsi
    jae    .LBB7_34
    lea    rbx, [r8 + 4]
    cmp    rbx, rsi
    jae    .LBB7_35
    lea    r14, [r8 + 5]
    cmp    r14, rsi
    jae    .LBB7_36
    lea    r15, [r8 + 6]
    cmp    r15, rsi
    jae    .LBB7_37
    lea    r12, [r8 + 7]
    cmp    r12, rsi
    jae    .LBB7_38
    cmp    r8, rcx
    jae    .LBB7_39
    cmp    r9, rcx
    jae    .LBB7_40
    cmp    r10, rcx
    jae    .LBB7_41
    cmp    r11, rcx
    jae    .LBB7_42
    cmp    rbx, rcx
    jae    .LBB7_43
    cmp    r14, rcx
    jae    .LBB7_44
    cmp    r15, rcx
    jae    .LBB7_45
    cmp    r12, rcx
    jae    .LBB7_46
    mov    rax, r13
    movzx    r10d, byte ptr [rdi + r8]
    movzx    r9d, byte ptr [rdi + r8 + 1]
    movzx    ebp, byte ptr [rdi + r8 + 2]
    movzx    r12d, byte ptr [rdi + r8 + 3]
    movzx    r15d, byte ptr [rdi + r8 + 4]
    movzx    r14d, byte ptr [rdi + r8 + 5]
    movzx    ebx, byte ptr [rdi + r8 + 6]
    movzx    r11d, byte ptr [rdi + r8 + 7]
    shl    r11, 56
    shl    rbx, 48
    shl    r14, 40
    shl    r15, 32
    shl    r12d, 24
    shl    ebp, 16
    shl    r9d, 8
    or    r9, r10
    or    r9, rbp
    or    r9, r12
    or    r9, r15
    or    r9, r14
    or    r9, rbx
    or    r9, r11
    movzx    r11d, byte ptr [rdx + r8]
    movzx    r10d, byte ptr [rdx + r8 + 1]
    movzx    r13d, byte ptr [rdx + r8 + 2]
    movzx    ebp, byte ptr [rdx + r8 + 3]
    movzx    r12d, byte ptr [rdx + r8 + 4]
    movzx    r15d, byte ptr [rdx + r8 + 5]
    movzx    r14d, byte ptr [rdx + r8 + 6]
    movzx    ebx, byte ptr [rdx + r8 + 7]
    shl    rbx, 56
    shl    r14, 48
    shl    r15, 40
    shl    r12, 32
    shl    ebp, 24
    shl    r13d, 16
    shl    r10d, 8
    or    r10, r11
    or    r10, r13
    or    r10, rbp
    or    r10, r12
    or    r10, r15
    or    r10, r14
    or    r10, rbx
    cmp    r9, r10
    je    .LBB7_29
    xor    r10, r9
    mov    r9, r10
    movabs    r11, 9187201950435737471
    and    r9, r11
    add    r9, r11
    or    r9, r10
    movabs    r10, -9187201950435737472
    and    r9, r10
    mov    r10, r9
    shr    r10
    sub    r9, r10
    mov    r10, r9
    movabs    r11, 3689348814741910272
    and    r10, r11
    shr    r9, 2
    movabs    r11, 3689348814741910320
    and    r9, r11
    add    r9, r10
    mov    r10, r9
    shr    r10, 4
    add    r10, r9
    movabs    r9, 1085102592571150095
    and    r10, r9
    movabs    r9, 72340172838076673
    imul    r10, r9
    shr    r10, 56
    add    qword ptr [rsp], r10
    jmp    .LBB7_29
.LBB7_3:
    mov    rax, qword ptr [rsp]
    jmp    .LBB7_10
.LBB7_7:
    mov    esi, r13d
    and    esi, 3
    sub    rcx, rsi
    add    rcx, r9
    movq    xmm1, qword ptr [rsp]
    pxor    xmm0, xmm0
    pcmpeqd    xmm2, xmm2
    movdqa    xmm3, xmmword ptr [rip + .LCPI7_0]
.LBB7_8:
    movzx    eax, word ptr [rdi + r9]
    movd    xmm4, eax
    movzx    eax, word ptr [rdi + r9 + 2]
    movd    xmm5, eax
    movzx    eax, word ptr [rdx + r9]
    movd    xmm6, eax
    pcmpeqb    xmm6, xmm4
    movzx    eax, word ptr [rdx + r9 + 2]
    movd    xmm4, eax
    pcmpeqb    xmm4, xmm5
    pxor    xmm6, xmm2
    punpcklbw    xmm6, xmm6
    pshuflw    xmm5, xmm6, 212
    pshufd    xmm5, xmm5, 212
    pand    xmm5, xmm3
    paddq    xmm1, xmm5
    pxor    xmm4, xmm2
    punpcklbw    xmm4, xmm4
    pshuflw    xmm4, xmm4, 212
    pshufd    xmm4, xmm4, 212
    pand    xmm4, xmm3
    paddq    xmm0, xmm4
    add    r9, 4
    cmp    rcx, r9
    jne    .LBB7_8
    paddq    xmm0, xmm1
    pshufd    xmm1, xmm0, 238
    paddq    xmm1, xmm0
    movq    rax, xmm1
    test    rsi, rsi
    je    .LBB7_10
.LBB7_6:
    movzx    esi, byte ptr [rdi + rcx]
    xor    r8d, r8d
    cmp    sil, byte ptr [rdx + rcx]
    setne    r8b
    add    rax, r8
    inc    rcx
    cmp    r13, rcx
    jne    .LBB7_6
.LBB7_10:
    add    rsp, 8
    pop    rbx
    pop    r12
    pop    r13
    pop    r14
    pop    r15
    pop    rbp
    ret
.LBB7_46:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.19]
    mov    rdi, r12
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_45:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.18]
    mov    rdi, r15
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_44:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.17]
    mov    rdi, r14
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_43:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.16]
    mov    rdi, rbx
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_42:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.15]
    mov    rdi, r11
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_41:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.14]
    mov    rdi, r10
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_40:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.13]
    mov    rdi, r9
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_39:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.12]
    mov    rdi, r8
    mov    rsi, rcx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_38:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.11]
    mov    rdi, r12
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_37:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.10]
    mov    rdi, r15
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_36:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.9]
    mov    rdi, r14
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_35:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.8]
    mov    rdi, rbx
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_34:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.7]
    mov    rdi, r11
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_33:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.6]
    mov    rdi, r10
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_32:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.5]
    mov    rdi, r9
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]
.LBB7_31:
    lea    rdx, [rip + .Lanon.a270e05f789020653a98a620bea8a67e.4]
    mov    rdi, r8
    call    qword ptr [rip + _RNvNtCscNqnBmBaIcL_4core9panicking18panic_bounds_check@GOTPCREL]

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

Global RankCapsule & DomainHardware _rdtscLatencyThroughputELF .textTernary VoteAuthor Aye
#1707wupz_byte_diff (THIS CAPSULE)
domain: aurora-x86_64 | id: 20dc7b8ff6dfe15e8f2e02be09376ae3
7954767/200000 cyc/op947129/50000 ns/op50000000/947129 ops/us1137 B .text (258 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz