nucypher-ts

Communicate with NuCypher network from browser.

Disclaimer

This is a work in progress

• SDK does not support policy revocation.
• We expect breaking changes.

Supported networks

nucypher-ts is available on the following networks:

• Polygon
• Mumbai (Polygon testnet)

Usage

Run with:

yarn install
yarn test
yarn build

Development

Install git hooks

npx husky install

Generate contract typings

yarn typechain

Prepare a new release

yarn run prepare-release

Publishing

Publish a new release on NPM.

Pay attention to output of these commands and fix your release if needed.

To build and publish a release, run

yarn prepare-release
# Or, to publish an alpha release
yarn prepare-release:alpha

Follow instructions from the command output to finalize the process.

Examples

See ./test directory for usage examples.

See ./examples directory for examples of browser integration.

See ./examples/api-example.ts for an abridged API example.

See nucypher-ts-demo for usage example with React app.

Using Threshold Decryption

There are several schemes available for the user. They follow a naming convention of <NETWORK>-<M>-of-<N>, where M is the threshold required, and N is the total size of the cohort. NETWORK is either mainnet or ibex.

An encrypter can be created by:

import { makeTDecEncrypter } from '@nucypher/nucypher-ts'

const encrypter = await makeTDecEncrypter("ibex-2-of-3");

The equivalent decrypter can be created by:

import { makeTDecDecrypter } from '@nucypher/nucypher-ts'

// you can specify your own porter url here
const decrypter = await makeTDecDecrypter("ibex-2-of-3", "https://porter-ibex.nucypher.community")

Please note, the schemes for the encrypter and decrypter must match.

Encryption and decryption is then as simple as:

const plaintext = toBytes('plaintext-message');
const encryptedMessageKit = encrypter.encryptMessage(plaintext);

const decryptedPlaintext = await decrypter.retrieveAndDecrypt([encryptedMessageKit]);