Segredos
Um Secret<T> é um valor que não pode vazar — uma senha, uma chave, um token, ou um registro deles — e o tipo transforma isso numa regra que o compilador cumpre:
echo,panice a interpolação recusam um, e também qualquer coisa que guarde um: um campo, um elemento, umResult. Escrever um como JSON também.reveal(secret)é o único caminho de volta para oT.Té um dado simples: texto, números, vetores, mapas, resultados e tipos declarados feitos deles. UmSecretde uma função, de um endereço, de um recurso da biblioteca ou de outroSecreté um erro de compilação, e também umSecretsozinho, que não diz o que guarda. Os segredos da biblioteca são texto, então sãoSecret<Str>.- O que ele guarda fica em bytes numa memória que o sistema operacional é instruído a nunca levar para o swap, e é zerado assim que nada mais o segura.
==compara o que dois guardam em tempo constante, então quanto tempo leva não diz nada sobre onde eles diferem. Um mapa é guardado em ordem de chave, então dois com os mesmos pares são iguais. Não existe ordem.
Memória travada é finita, então hide(value) responde com um Result<Secret<T>, SecretError>, que é SecretError.LimitExceeded quando o limite se esgota e SecretError.Unsupported onde a plataforma não consegue travar memória nenhuma, cada um com uma message. bypass(value) faz um Secret<T> que não falha, guardado em memória comum que pode ir para o swap — para um valor que nunca foi segredo de verdade na chegada, como um literal, que o executável já guarda de qualquer jeito. Duas chamadas da biblioteca têm um gêmeo do mesmo tipo: hive.term.readSecretBypass() e hive.crypto.decryptBypass(ciphertext, password) são o readSecret e o decrypt em memória comum, então nenhuma das duas para no limite.
Um programa que declara o seu próprio Secret ainda tem o nativo como hive.Secret<T>, e o erro dele como hive.SecretError.
type Login {
user: Str
password: Secret<Str>
}
proc main(): void {
typed := hide("hunter2")
if typed is Result.Error(why) {
echo why
} else if typed is Result.Ok(password) {
echo reveal(password) // hunter2
echo password == bypass("hunter2") // true
echo Login("ada", password).user // ada
// echo password — um erro de compilação
// echo Login("ada", password) — e este também
}
}type Card {
number: Str
pin: Int
}
proc main(): void {
card := bypass(Card("4111 1111 1111 1111", 1234))
echo reveal(card).pin // 1234
codes := bypass([93, 17, 42])
echo len(reveal(codes)) // 3
echo codes == bypass([93, 17, 42]) // true
// Secret<Str> s = codes — um erro de compilação: guarda Int[3]
}