privatekey.md

Private Key

Represents a Dash private key and is needed to be able to spend funds and sign transactions. See the official Bitcoin Wiki for more information about private keys. A PrivateKey in Dashcore is an immutable object that has methods to import and export into a variety of formats including Wallet Import Format.

Instantiate a Private Key

Here is how to create a new private key. It will generate a new random number using window.crypto or the Node.js crypto library.

var privateKey = new PrivateKey();

// Creates a private key from a hex encoded number
var privateKey2 = new PrivateKey(
  'b221d9dbb083a7f33428d7c2a3c3198ae925614d70210e28716ccaa7cd4ddb79'
);

To export and import a private key, you can do the following:

// encode into wallet export format
var exported = privateKey.toWIF(); //XHFu419963FyHRikGLeRxxgNNJRdujRnxz9u8YRFfG5FNeGpfueL

// instantiate from the exported (and saved) private key
var imported = PrivateKey.fromWIF(exported);

Note: The WIF (Wallet Import Format) includes information about the network and if the associated public key is compressed or uncompressed (thus the same Dash address will be generated by using this format).

To generate an Address or PublicKey from a PrivateKey:

var publicKey = privateKey.toPublicKey();
var address = publicKey.toAddress(Networks.livenet);

Validating a Private Key

The code to do these validations looks like this:

// validate an address
if (PrivateKey.isValid(input)){
  ...
}

// get the specific validation error that can occurred
var error = PrivateKey.getValidationError(input, Networks.livenet);
if (error) {
  // handle the error
}