Method createChallenge

server/index.js:268–294

* Generates a new challenge * @param {ChallengeConfig} [conf] - Challenge configuration * @returns {Promise<{ challenge: {c: number, s: number, d: number}, token?: string, expires: number }>} Challenge data

(conf)

   * @returns {Promise<{ challenge: {c: number, s: number, d: number}, token?: string, expires: number }>} Challenge data
   */
  async createChallenge(conf) {
    await this._lazyCleanup();

    /** @type {{c: number, s: number, d: number}} */
    const challenge = {
      c: conf?.challengeCount ?? 50,
      s: conf?.challengeSize ?? 32,
      d: conf?.challengeDifficulty ?? 4,
    };

    const token = await randomHex(25);
    const expires = Date.now() + (conf?.expiresMs ?? 600000);

    if (conf && conf.store === false) {
      return { challenge, expires };
    }

    const challengeData = { expires, challenge };

    if (this.config.storage?.challenges?.store) {
      await this.config.storage.challenges.store(token, challengeData);
    } else {
      this.config.state.challengesList[token] = challengeData;
    }

    return { challenge, token, expires };
  }

  /**
   * Redeems a challenge solution in exchange for a token