1-out-of-n

1-out-of-n oblivious transfer protocol in JavaScript

Usage no npm install needed!

<script type="module">
  import OutOfN from 'https://cdn.skypack.dev/1-out-of-n';
</script>

README

1-out-of-n

1-out-of-n oblivious transfer protocol in JavaScript

Protocol

To create 1-out-of-N, we use log2(N) 1-out-of-2 oblivious transfers of random bits to create log2(N) random strings. Each secret is masked with one of these strings (by XOR) and the receiving party picks one after which the sender reveals all the masked secrets.

We build 1-out-of-N OT by composing random 1-out-of-N and multiple 1-out-of-2 oracles. This is the same protocol as described in Oblivious Transfer and Polynomial Evaluation pp. 247-248.

Project layout

├─ index.js           Module entry point (include this or use npm)
├─ lib/               Library source
│  ├─ ot.js             Oblivious transfer protocols
│  ├─ util.js           Bitwise helpers
│  └─ crypto.js         Crypto primitives
└─ demo/              Example demos
   ├─ io-example.js     Input-output communication for the demos
   ├─ io-template.js    IO methods template
   ├─ strings/          Strings demo
   │  ├─ example.js       OT choosing from strings
   │  └─ ascii.js         ASCII helpers to convert inputs to Uint8Array
   └─ numbers/          Numbers demo
      └─ example.js       OT choosing from numbers

Installation

You may also install this module from npm.

npm install 1-out-of-n

Calling the API

The process generally works as follows:

// Each party includes the 1-out-of-n module with IO:
const OT = require('1-out-of-n')(IO);

// 1-out-of-3
const N = 3;

// The sender calls send and provides its secrets:
OT.send([77, 66, 88], N);

// The receiver calls receive with its selection out of N:
OT.receive(2, N).then(console.log.bind(null, 'Secret #2 is:'));

// Result:
66

Note that the latest version expects to get an array of Uint8Array as inputs, so if you are working with numbers larger than 8 bits, it is strongly recommended to use the Uint8Array byte array type to represent your number choices. Please read strings/example.js for a more detailed example or run it with node demo/*/example.js.

Test suite

The example demos in demo/numbers/example.js and demo/strings/example.js test both a basic, and slightly more advanced usage of the library. You may run them individually, or use the pre-configured test script by running npm test. All versions and releases have tests passing.

Code linting

Please run npm run-script lint-fix before submitting a pull request.