2 unstable releases

0.2.0 Feb 21, 2023
0.1.0 Sep 15, 2022

#2 in #meow

Download history 40/week @ 2024-07-22 55/week @ 2024-07-29 65/week @ 2024-08-05 6/week @ 2024-08-12 49/week @ 2024-08-19 63/week @ 2024-08-26 39/week @ 2024-09-02 38/week @ 2024-09-09 63/week @ 2024-09-16 85/week @ 2024-09-23 68/week @ 2024-09-30 65/week @ 2024-10-07 62/week @ 2024-10-14 60/week @ 2024-10-21 126/week @ 2024-10-28 35/week @ 2024-11-04

287 downloads per month
Used in cait-sith

MIT license

305KB
157 lines

Magikitten

A system for making public-coin protocols non-interactive, using Meow.

This library is also heavily inspired by Merlin, and provides a similar construction, albeit with some differences.

Usage

The essence of using the library is that you initialize a Transcript object, and then alternate between feeding in data and extracting out randomness:

use rand_core::RngCore;
use magikitten::Transcript;

let mut transcript = Transcript::new(b"my cool protocol");
transcript.message(b"message0", b"hello world!");
let c0 = transcript.challenge(b"challenge0").next_u64();
transcript.message(b"message1", b"hello world again!");
let c1 = transcript.challenge(b"challenge1").next_u64();

The challenge function ratchets the state of the transcript, and then gives you an object implementing RngCore, allowing you to extract arbitrary randomness. This randomness depends (unpredictably) on the state of the transcript so far, but is otherwise deterministic. The label you use to create the challenge RNG also affects the transcript, but then the state of the RNG is independent, and the way you use the RNG doesn't affect the transcript. Implementing RngCore lets you use the challenge RNG to generate arbitrarily complex objects. For example, you can do rejection sampling, or other tricky techniques.

Sequential Composition

In most situations, you should write schemes to accept a Transcript as an argument, rather than creating it themselves.

This allows schemes to be composed sequentially, by having one scheme use the running transcript that another scheme interacted with.

Differences with Merlin

This library is heavily inspired by Merlin, which essentially serves the same use case. There are a few differences though.

Magikitten uses a reduced round permutation

Rather than using Keccak with 24 rounds, we use KitTen, which is Keccak with only 10 rounds. This makes the protocol faster, but obviously more vulnerable to potential advances in the cryptanalysis of Keccak.

See Meow for some more rationale on using KitTen.

Challenges are a stream of bytes

Merlin requires you to specify the length of a challenge, and it just generates a challenge of that length. Magikitten, on the other hand, gives you an arbitrary RNG object. I think this makes the library easier to use, since many functions can easily be written to accept an object implementing the RngCore trait. Some sampling algorithms, like rejection sampling, don't work well if you need to know the length of the bits you need to sample in advance.

Also, the RNG object is seeded from the transcript, but then becomes independent. With an independent state, the way you query bits of the RNG doesn't affect the rest of the transcript. This is more intuitive, since seemingly equivalent behavior can't change the results. For example, if you do rejection sampling using a buffer of bytes, increasing this buffer size won't affect the results you get with Magikitten, because the RNG can be treated as simply an infinite stream of bytes.

With Merlin, the length of each RNG query is recorded, and so different query patterns for the RNG change the result.

No support for private RNG

At the moment, Magikitten doesn't support private randomness. This is a feature that might be added in the future though.

Dependencies

~0.7–1.1MB
~19K SLoC