xahau.js/test/api/generateAddress/index.ts

import assert from 'assert-diff'
import responses from '../../fixtures/responses'
import {TestSuite} from '../../utils'
import {GenerateAddressOptions} from '../../../src/offline/generate-address'
const {generateAddress: RESPONSE_FIXTURES} = responses

/**
 * Every test suite exports their tests in the default object.
 * - Check out the "TestSuite" type for documentation on the interface.
 * - Check out "test/api/index.ts" for more information about the test runner.
 */
export default <TestSuite>{
  'generateAddress': async api => {
    // GIVEN entropy of all zeros
    function random() {
      return new Array(16).fill(0)
    }

    assert.deepEqual(
      // WHEN generating an address
      api.generateAddress({entropy: random()}),

      // THEN we get the expected return value
      RESPONSE_FIXTURES
    )
  },

  'generateAddress invalid entropy': async api => {
    assert.throws(() => {
      // GIVEN entropy of 1 byte
      function random() {
        return new Array(1).fill(0)
      }

      // WHEN generating an address
      api.generateAddress({entropy: random()})

      // THEN an UnexpectedError is thrown
      // because 16 bytes of entropy are required
    }, api.errors.UnexpectedError)
  },

  'generateAddress with no options object': async api => {
    // GIVEN no options

    // WHEN generating an address
    const account = api.generateAddress()

    // THEN we get an object with an address starting with 'r' and a secret starting with 's'
    assert(account.address.startsWith('r'), 'Address must start with `r`')
    assert(account.secret.startsWith('s'), 'Secret must start with `s`')
  },

  'generateAddress with empty options object': async api => {
    // GIVEN an empty options object
    const options = {}

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get an object with an address starting with 'r' and a secret starting with 's'
    assert(account.address.startsWith('r'), 'Address must start with `r`')
    assert(account.secret.startsWith('s'), 'Secret must start with `s`')
  },

  'generateAddress with algorithm `ecdsa-secp256k1`': async api => {
    // GIVEN we want to use 'ecdsa-secp256k1'
    const options: GenerateAddressOptions = {algorithm: 'ecdsa-secp256k1'}

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get an object with an address starting with 'r' and a secret starting with 's' (not 'sEd')
    assert(account.address.startsWith('r'), 'Address must start with `r`')
    assert.deepEqual(
      account.secret.slice(0, 1),
      's',
      `Secret ${account.secret} must start with 's'`
    )
    assert.notStrictEqual(
      account.secret.slice(0, 3),
      'sEd',
      `secp256k1 secret ${account.secret} must not start with 'sEd'`
    )
  },

  'generateAddress with algorithm `ed25519`': async api => {
    // GIVEN we want to use 'ed25519'
    const options: GenerateAddressOptions = {algorithm: 'ed25519'}

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get an object with an address starting with 'r' and a secret starting with 'sEd'
    assert(account.address.startsWith('r'), 'Address must start with `r`')
    assert.deepEqual(
      account.secret.slice(0, 3),
      'sEd',
      `Ed25519 secret ${account.secret} must start with 'sEd'`
    )
  },

  'generateAddress with algorithm `ecdsa-secp256k1` and given entropy': async api => {
    // GIVEN we want to use 'ecdsa-secp256k1' with entropy of zero
    const options: GenerateAddressOptions = {
      algorithm: 'ecdsa-secp256k1',
      entropy: new Array(16).fill(0)
    }

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get the expected return value
    assert.deepEqual(account, responses.generateAddress)
  },

  'generateAddress with algorithm `ed25519` and given entropy': async api => {
    // GIVEN we want to use 'ed25519' with entropy of zero
    const options: GenerateAddressOptions = {
      algorithm: 'ed25519',
      entropy: new Array(16).fill(0)
    }

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get the expected return value
    assert.deepEqual(account, {
      // generateAddress return value always includes xAddress to encourage X-address adoption
      xAddress: 'X7xq1YJ4xmLSGGLhuakFQB9CebWYthQkgsvFC4LGFH871HB',

      classicAddress: 'r9zRhGr7b6xPekLvT6wP4qNdWMryaumZS7',
      address: 'r9zRhGr7b6xPekLvT6wP4qNdWMryaumZS7',
      secret: 'sEdSJHS4oiAdz7w2X2ni1gFiqtbJHqE'
    })
  },

  'generateAddress with algorithm `ecdsa-secp256k1` and given entropy; include classic address': async api => {
    // GIVEN we want to use 'ecdsa-secp256k1' with entropy of zero
    const options: GenerateAddressOptions = {
      algorithm: 'ecdsa-secp256k1',
      entropy: new Array(16).fill(0),
      includeClassicAddress: true
    }

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get the expected return value
    assert.deepEqual(account, responses.generateAddress)
  },

  'generateAddress with algorithm `ed25519` and given entropy; include classic address': async api => {
    // GIVEN we want to use 'ed25519' with entropy of zero
    const options: GenerateAddressOptions = {
      algorithm: 'ed25519',
      entropy: new Array(16).fill(0),
      includeClassicAddress: true
    }

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get the expected return value
    assert.deepEqual(account, {
      // generateAddress return value always includes xAddress to encourage X-address adoption
      xAddress: 'X7xq1YJ4xmLSGGLhuakFQB9CebWYthQkgsvFC4LGFH871HB',

      secret: 'sEdSJHS4oiAdz7w2X2ni1gFiqtbJHqE',
      classicAddress: 'r9zRhGr7b6xPekLvT6wP4qNdWMryaumZS7',
      address: 'r9zRhGr7b6xPekLvT6wP4qNdWMryaumZS7'
    })
  },

  'generateAddress with algorithm `ecdsa-secp256k1` and given entropy; include classic address; for test network use': async api => {
    // GIVEN we want to use 'ecdsa-secp256k1' with entropy of zero
    const options: GenerateAddressOptions = {
      algorithm: 'ecdsa-secp256k1',
      entropy: new Array(16).fill(0),
      includeClassicAddress: true,
      test: true
    }

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get the expected return value
    const response = Object.assign({}, responses.generateAddress, {
      // generateAddress return value always includes xAddress to encourage X-address adoption
      xAddress: 'TVG3TcCD58BD6MZqsNuTihdrhZwR8SzvYS8U87zvHsAcNw4'
    })
    assert.deepEqual(account, response)
  },

  'generateAddress with algorithm `ed25519` and given entropy; include classic address; for test network use': async api => {
    // GIVEN we want to use 'ed25519' with entropy of zero
    const options: GenerateAddressOptions = {
      algorithm: 'ed25519',
      entropy: new Array(16).fill(0),
      includeClassicAddress: true,
      test: true
    }

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get the expected return value
    assert.deepEqual(account, {
      // generateAddress return value always includes xAddress to encourage X-address adoption
      xAddress: 'T7t4HeTMF5tT68agwuVbJwu23ssMPeh8dDtGysZoQiij1oo',

      secret: 'sEdSJHS4oiAdz7w2X2ni1gFiqtbJHqE',
      classicAddress: 'r9zRhGr7b6xPekLvT6wP4qNdWMryaumZS7',
      address: 'r9zRhGr7b6xPekLvT6wP4qNdWMryaumZS7'
    })
  },

  'generateAddress for test network use': async api => {
    // GIVEN we want an address for test network use
    const options: GenerateAddressOptions = {test: true}

    // WHEN generating an address
    const account = api.generateAddress(options)

    // THEN we get an object with xAddress starting with 'T' and a secret starting with 's'

    // generateAddress return value always includes xAddress to encourage X-address adoption
    assert.deepEqual(
      account.xAddress.slice(0, 1),
      'T',
      'Test addresses start with T'
    )

    assert.deepEqual(
      account.secret.slice(0, 1),
      's',
      `Secret ${account.secret} must start with 's'`
    )
  }
}