Module spin_sdk.wit.imports.wasi_random_insecure_0_3_0

The insecure interface for insecure pseudo-random numbers.

It is intended to be portable at least between Unix-family platforms and Windows.

Functions

def get_insecure_random_bytes(max_len: int) ‑> bytes

Expand source code

def get_insecure_random_bytes(max_len: int) -> bytes:
    """
    Return up to `max-len` insecure pseudo-random bytes.
    
    This function is not cryptographically secure. Do not use it for
    anything related to security.
    
    There are no requirements on the values of the returned bytes, however
    implementations are encouraged to return evenly distributed values with
    a long period.
    
    Implementations MAY return fewer bytes than requested (a short read).
    Callers that require exactly `max-len` bytes MUST call this function in
    a loop until the desired number of bytes has been accumulated.
    Implementations MUST return at least 1 byte when `max-len` is greater
    than zero. When `max-len` is zero, implementations MUST return an empty
    list without trapping.
    """
    raise NotImplementedError

Return up to max-len insecure pseudo-random bytes.

This function is not cryptographically secure. Do not use it for anything related to security.

There are no requirements on the values of the returned bytes, however implementations are encouraged to return evenly distributed values with a long period.

Implementations MAY return fewer bytes than requested (a short read). Callers that require exactly max-len bytes MUST call this function in a loop until the desired number of bytes has been accumulated. Implementations MUST return at least 1 byte when max-len is greater than zero. When max-len is zero, implementations MUST return an empty list without trapping.

def get_insecure_random_u64() ‑> int

Expand source code

def get_insecure_random_u64() -> int:
    """
    Return an insecure pseudo-random `u64` value.
    
    This function returns the same type of pseudo-random data as
    `get-insecure-random-bytes`, represented as a `u64`.
    """
    raise NotImplementedError

Return an insecure pseudo-random u64 value.

This function returns the same type of pseudo-random data as get-insecure-random-bytes, represented as a u64.