# CryptoNight¶

CryptoNight is a memory hard hash function

## Background¶

CryptoNight was originally designed around 2013 as part of the CryptoNote suite.

One design goal was to make it very friendly for the off-the-shelf CPU-s, by employing:

- native AES encryption
- fast 64 bit multipliers
- scratchpad fitting exactly the size of the per-core L3 cache on Intel CPUs (about 2MB)

More ambitious design goal was to make it inefficiently computable on ASIC-s. This goal has since failed, as it inevitably happens with "ASIC hard" algorithms. Efficient CryptoNight ASIC was developed in 2017 by Bitmain.

Monero inherited CryptoNight as its proof of work in 2014. Since then Monero slightly evolved the algorithm to intentionally break compatibility with released ASIC-s. Currently Monero implements CryptoNight v2, a third iteration of original CryptoNight (v0, v1, v2).

## The goal is to find small-enough hash¶

In hashing based PoW algorithms the goal is to find small-enough hash.

Hash is simply an integer (normally, a very large integer). Most hashing functions result in 256-bit hashes (integers between 0 and 2^256). This includes Bitcoin's double-SHA-256 and Monero's CryptoNight.

Miner randomly tweaks input data until the hash fits under specified threshold. The threshold (also a large integer) is established collectively by the network as part of the consensus mechanism. The PoW is only considered valid (solved) if hash fits under the threshold.

Because hash functions are one-way, it is not possible to analytically calculate input data that would result in a small-enough hash. The solution must be brute-forced by tweaking the input data and recalculating the hash over and over again.

Miners have a few areas of flexibility regarding input data - most importantly they can iterate with the nonce value. They also have a power over which transactions are included in the block and how they are put together in a merkle tree.

## Cryptographic primitives¶

CryptoNight is based on:

- AES encryption
- 5 hashing functions, all of which were finalists in NIST SHA-3 competition:
- Keccak (the primary one)
- BLAKE
- Groestl
- JH
- Skein

## Input data¶

In Monero the input to hashing function is concatenation of:

- serialized block header (around 46 bytes; subject to varint representation)
- merkle tree root (32 bytes)
- number of transactions included in the block (around 1-2 bytes; subject to varint representation)

See get_block_hashing_blob() function to dig further.

## Algorithm¶

Warning

The article attempts to give reader a high-level understanding of the CryptoNight algorithm. For implementation details refer to CryptoNote Standard and Monero source code. See references at the bottom.

### Overview¶

CryptoNight attempts to make memory access a bottleneck for performance ("memory hardness"). It has three steps:

- Initialize large area of memory with pseudo-random data. This memory is known as the scratchpad.
- Perform numerous read/write operations at pseudo-random (but deterministic) addresses on the scratchpad.
- Hash the entire scratchpad to produce the resulting value.

### Step 1: scratchpad initialization¶

Firstly, the input data is hashed with Keccak-1600. This results in 200 bytes of pseudorandom data (1600 bits == 200 bytes).

These 200 bytes become a seed to generate a larger, 2MB-wide buffer of pseudorandom data, by applying AES-256 encryption.

The first 0..31 bytes of Keccak-1600 hash are used as AES key.

The encryption is performed on 128 bytes-long payloads until 2MB is ready. The first payload are Keccak-1600 bytes 66..191. The next payload is encryption result of the previous payload.

Each 128-byte payload is actually encrypted 10 times.

The details are a bit more nuanced, see "Scratchpad Initialization" in CryptoNote Standard.

### Step 2: memory-hard loop¶

The second step is basically 524288 iterations of a simple stateful algorithm.

Each algorithm iteration reads from and writes back to the scratchpad, at pseudorandom-but-deterministic locations.

Critically, next iteration depends on the state prepared by previous iterations. It is not possible to directly calculate state of future iterations.

The specific operations include AES, XOR, 8byte_mul, 8byte_add - operations that are CPU-friendly (highly optimized on modern CPU-s).

The goal here is to make memory latency the bottleneck in attempt to close the gap between potential ASIC-s and general purpose CPU-s.

### Step 3: hashing¶

The final step (simplifying) is to:

- combine original Keccak-1600 output with the whole scratchpad
- pick the hashing algorithm based on 2 low-order bits of the result
- 0=BLAKE-256
- 1=Groestl-256
- 2=JH-256
- 3=Skein-256

- hash the result with selected function

The resulting 256-bit hash is the final output of CryptoNight algorithm.

## Monero specific modifications¶

### CryptoNight v0¶

This is how Monero community refers to original implementation of CryptoNight.

### CryptoNight v1¶

See the source code diff.

### CryptoNight v2¶

See the rationale and the source code diff.

### CryptoNight v3 aka CryptoNightR¶

See the rationale and the source code diff.

## Critique¶

- CryptoNight hash is relatively expensive to verify. This poses a risk of DoS-ing nodes with incorrect proofs to process. See strong asymmetry requirement.
- The hash function was designed from scratch with limited peer review. While CryptoNight is composed of proven and peer-reviewed primitives, combining secure primitives doesn't necessarily result in a secure cryptosystem.
- CryptoNight ultimately failed to prevent ASIC-s.
- Complexity of CryptoNight kills competition in ASIC manufacturing.

CryptoNight proof of work remains one of the most controversial aspect of Monero.

## Reference¶

- CryptoNight hash function description in the CryptoNote Standard
- CryptoNight v2 source code
- The entry point is
`cn_slow_hash()`

function. Manually removing support and optimizations for multiple architectures should help you understand the actual code.

- The entry point is
- "Egalitarian Proof of Work" chapter in CryptoNote whitepaper
- First days of Monero mining by dr David Andersen
- Some test vectors in Monero source code