EncryptedValue

A value sealed by crypto.encrypt.

Use it to store something you must read back later, such as a provider's token. crypto.encrypt(value, key: key, context: context) gives the bytes, with a key from your settings. For a value you only need to compare, use Hash or PasswordHash.

Shape

One value, held as bytes, with no parts. As text it reads AQGhssPUGBkaGxwdHh8gISIjJCUmJygpKissLS4vaGVsbG+QkZKTlJWWl5iZmpucnZ6f.

Example

type NotSealed = Failure {    kind: FailureKind.invalid_value    message: "That isn't a sealed value."}var example: EncryptedValue = attempt text.parse(    "AQGhssPUAAECAwQFBgcICQoLDA0ODxAREhMUFRYXgIGCg4SFhoeIiYqLjI2Ojw==",    as: EncryptedValue) {    malformed: NotSealed}assert example == example

EncryptedValue(bytes) checks them, and bytes that aren't one break the format rule.

text.parse(raw, as: EncryptedValue) reads one from text that comes from outside. Text that isn't one at all fails malformed.

Good to know

• It may be stored and sent. Only crypto.decrypt, with the key, reads what it holds.
• == tells you whether two are the same. < and list.sort_by don't take it.

In JSON

A string, in a request, a response or json.write:

"AQGhssPUAAECAwQFBgcICQoLDA0ODxAREhMUFRYXgIGCg4SFhoeIiYqLjI2Ojw==""AQGhssPUGBkaGxwdHh8gISIjJCUmJygpKissLS4vaGVsbG+QkZKTlJWWl5iZmpucnZ6f"

Details