Method getKeyByAddress

src/modules/KeyringBase.js:143–176

* Query keys by email address * @param {Array |String} emailAddr * @param {Boolean} [options.pub = true] - query for public keys * @param {Bolean} [options.priv = true] - query for private keys * @param {Boolean} [options.sort = false] - sort results by key creation date and d

(emailAddr, {pub = true, priv = true, sort = false, validForEncrypt = true, keyId, verifyUser = true} = {})

   * @return {Object} - map in the form {address: [key1, key2, ..]}
   */
  async getKeyByAddress(emailAddr, {pub = true, priv = true, sort = false, validForEncrypt = true, keyId, verifyUser = true} = {}) {
    const result = Object.create(null);
    const emailArray = toArray(emailAddr);
    for (const email of emailArray) {
      result[email] = [];
      let keys = [];
      if (pub) {
        keys = keys.concat(this.keystore.publicKeys.getForAddress(email));
      }
      if (priv) {
        keys = keys.concat(this.keystore.privateKeys.getForAddress(email));
      }
      if (validForEncrypt) {
        keys = await filterAsync(keys, key => isValidEncryptionKey(key, this.id));
      }
      if (verifyUser) {
        keys = await filterAsync(keys, key => verifyForAddress(key, email));
      }
      if (keyId) {
        keys = keys.filter(key => key.getKeys(keyId).length);
      }
      if (!keys.length) {
        result[email] = false;
        continue;
      }
      if (sort) {
        // sort by key creation date and default key status
        const defaultKeyFpr = await this.getDefaultKeyFpr();
        sortKeysByCreationDate(keys, defaultKeyFpr);
      }
      result[email] = keys;
    }
    return result;
  }

  /**
   * Get armored keys by fingerprints