Skip to content

zeroize ​

Assinaturazeroize(value: string): Result<void, MemoryError>
Assinaturazeroize(value: u8[]): Result<void, MemoryError>

zeroize(value) consome uma string ou u8[] local. Ela sobrescreve a alocação com zeros por escritas voláteis, coloca uma barreira de compilador após as escritas e libera a alocação. O binding não pode ser usado depois.

Strings dinâmicas devem ter exatamente uma referência viva. Literais de string, empréstimos e strings compartilhadas são rejeitados com MemoryError, pois apagá-los escreveria armazenamento somente leitura ou alteraria dados ainda visíveis por outro valor.

tyrus
import { MemoryError, zeroize } from "tyrus:memory";

function eraseToken(): void throws MemoryError {
    let token: string = readToken();
    zeroize(token);
}

function main(): void {
    try {
        eraseToken();
    } catch (error: MemoryError) {
        print(error.code); // ERR_MEMORY_NOT_OWNED or ERR_MEMORY_SHARED_VALUE
    }
}