/urbit-key-generation

Key derivation and HD wallet generation functions for Urbit

Primary LanguageJavaScriptMIT LicenseMIT

urbit-key-generation

Build Status License: MIT npm

Key derivation and HD wallet generation functions for Urbit.

Install

Grab it from npm like so:

npm install urbit-key-generation

To include in your node project, use:

const kg = require('urbit-key-generation')

To use in the browser, you can use e.g. rollup and the rollup-plugin-node-resolve plugin, and specify the following in your rollup.config.js or similar:

plugins: [
  ..,
  resolve({
    browser: true,
  }),
  ..
]

Usage

You will probably be interested in the generateWallet function, which generates a HD wallet for Urbit keys. It expects an object argument containing the following properties:

  • ticket, a 64, 128, or 384-bit @q master ticket (you can use e.g. the appropriate patq functions from urbit-ob to create these from decimal or hex strings).
  • ship, an Urbit ship number between 0 and 2^32 - 1.
  • passphrase, an optional passphrase used to salt seeds derived from BIP39 mnemonics.
  • revision, an optional number used to salt network seeds derived from a management seed. Defaults to 0.
  • boot, an optional flag that indicates whether or not to generate Urbit network keys for the provided ship. Defaults to false.

generateWallet returns a Promise, so you can deal with it as follows, for example:

let config = {
  ticket: '~marbud-tidsev-litsut-hidfep',
  ship: 65012,
  boot: true
}

let wallet = await generateWallet(config)

Security

Tlon runs a bug bounty program. If you believe you've discovered a vulnerability anywhere in this implementation, you can disclose it privately to security@tlon.io.

Dev

Before making a PR, you should create an updated browser bundle (generated via npm run-script build).

You can run the test suite with a simple npm test.