Supported types

This document introduces the encrypted integer types provided by the FHE library in FHEVM and explains their usage, including casting, state variable declarations, and type-specific considerations.

Introduction

The FHE library offers a robust type system with encrypted integer types, enabling secure computations on confidential data in smart contracts. These encrypted types are validated both at compile time and runtime to ensure correctness and security.

Key features of encrypted types

  • Encrypted integers function similarly to Solidity’s native integer types, but they operate on Fully Homomorphic Encryption (FHE) ciphertexts.

  • Arithmetic operations on e(u)int types are unchecked, meaning they wrap around on overflow. This design choice ensures confidentiality by avoiding the leakage of information through error detection.

  • Future versions of the FHE library will support encrypted integers with overflow checking, but with the trade-off of exposing limited information about the operands.

Encrypted integers with overflow checking will soon be available in the FHE library. These will allow reversible arithmetic operations but may reveal some information about the input values.

Encrypted integers in FHEVM are represented as FHE ciphertexts, abstracted using ciphertext handles. These types, prefixed with e (for example, euint64) act as secure wrappers over the ciphertext handles.

List of encrypted types

The FHE library currently supports the following encrypted types:

Type
Bit Length
Supported Operators
Aliases (with supported operators)

Ebool

2

and, or, xor, eq, ne, not, select, rand

Euint8

8

add, sub, mul, div, rem, and, or, xor, shl, shr, rotl, rotr, eq, ne, ge, gt, le, lt, min, max, neg, not, select, rand, randBounded

Euint16

16

add, sub, mul, div, rem, and, or, xor, shl, shr, rotl, rotr, eq, ne, ge, gt, le, lt, min, max, neg, not, select, rand, randBounded

Euint32

32

add, sub, mul, div, rem, and, or, xor, shl, shr, rotl, rotr, eq, ne, ge, gt, le, lt, min, max, neg, not, select, rand, randBounded

Euint64

64

add, sub, mul, div, rem, and, or, xor, shl, shr, rotl, rotr, eq, ne, ge, gt, le, lt, min, max, neg, not, select, rand, randBounded

Euint128

128

add, sub, mul, div, rem, and, or, xor, shl, shr, rotl, rotr, eq, ne, ge, gt, le, lt, min, max, neg, not, select, rand, randBounded

Euint160

160

Eaddress (eq, ne, select)

Euint256

256

and, or, xor, shl, shr, rotl, rotr, eq, ne, neg, not, select, rand, randBounded

Division (div) and remainder (rem) operations are only supported when the right-hand side (rhs) operand is a plaintext (non-encrypted) value. Attempting to use an encrypted value as rhs will result in a panic. This restriction ensures correct and secure computation within the current framework.

Higher-precision integer types are available in the TFHE-rs library and can be added to fhevm as needed.

Last updated