跳转到内容

std.Random.Ascon

标准库Zig 0.17.0官方原文
源码std/Random/Ascon.zig

第 1 行

基于 Reverie 构造的密码学安全伪随机数生成器。Reverie 是具有前向安全性的置换式伪随机数生成器,此处采用 Ascon(128,12,8) 置换实例化。

与 ChaCha 相比,此生成器的状态小得多,可能更适合资源受限环境。

参考文献:

字段

state: Ascon

std.Random.Ascon.addEntropy

函数

第 30 行

注入熵以刷新内部状态。

pub fn addEntropy(self: *Self, bytes: []const u8) void

参数

self: *Self
bytes: []const u8

std.Random.Ascon.Ascon

类型

第 15 行

std.Random.Ascon.fill

函数

第 47 行

使用随机字节填充缓冲区。

pub fn fill(self: *Self, buf: []u8) void

参数

self: *Self
buf: []u8

std.Random.Ascon.init

函数

第 23 行

种子必须均匀、保密,且长度为 secret_seed_length 字节。

pub fn init(secret_seed: [secret_seed_length]u8) Self

参数

secret_seed: [secret_seed_length]u8

std.Random.Ascon.mem

别名

第 12 行

别名目标 std.mem

std.Random.Ascon.random

函数

第 42 行

返回由当前随机数生成器提供支持的 std.Random 结构体。

pub fn random(self: *Self) std.Random

参数

self: *Self

std.Random.Ascon.rate

常量

第 19 行

std.Random.Ascon.secret_seed_length

常量

第 20 行

std.Random.Ascon.Self

别名

第 13 行

别名目标 std.Random.Ascon

std.Random.Ascon.std

别名

第 11 行

别名目标 std

源码

std/Random/Ascon.zig

//! 基于 Reverie 构造的密码学安全伪随机数生成器。Reverie 是具有前向安全性的置换式伪随机数生成器,此处采用 Ascon(128,12,8) 置换实例化。
//!
//! 与 ChaCha 相比,此生成器的状态小得多,可能更适合资源受限环境。
//!
//! 参考文献:
//! - 一种提高效率的稳健海绵式伪随机数生成器 https://eprint.iacr.org/2016/886.pdf
//! - Ascon https://ascon.iaik.tugraz.at/files/asconv12-nist.pdf
//!
//!

const std = @import("std");
const mem = std.mem;
const Self = @This();

const Ascon = std.crypto.core.Ascon(.little);

state: Ascon,

const rate = 16;
pub const secret_seed_length = 32;

/// 种子必须均匀、保密,且长度为 `secret_seed_length` 字节。
pub fn init(secret_seed: [secret_seed_length]u8) Self {
    var self = Self{ .state = Ascon.initXof() };
    self.addEntropy(&secret_seed);
    return self;
}

/// 注入熵以刷新内部状态。
pub fn addEntropy(self: *Self, bytes: []const u8) void {
    comptime std.debug.assert(secret_seed_length % rate == 0);
    var i: usize = 0;
    while (i + rate < bytes.len) : (i += rate) {
        self.state.addBytes(bytes[i..][0..rate]);
        self.state.permuteR(8);
    }
    if (i != bytes.len) self.state.addBytes(bytes[i..]);
    self.state.permute();
}

/// 返回由当前随机数生成器提供支持的 `std.Random` 结构体。
pub fn random(self: *Self) std.Random {
    return std.Random.init(self, fill);
}

/// 使用随机字节填充缓冲区。
pub fn fill(self: *Self, buf: []u8) void {
    var i: usize = 0;
    while (true) {
        const left = buf.len - i;
        const n = @min(left, rate);
        self.state.extractBytes(buf[i..][0..n]);
        if (left == 0) break;
        self.state.permuteR(8);
        i += n;
    }
    self.state.permuteRatchet(6, rate);
}