solveChallenge

solveChallenge() runs the same proof-of-work algorithm used by the browser widget, but synchronously in Node.js. It is designed for automated testing of your challenge and verify endpoints — not for production use in request handlers.

Import

import { solveChallenge } from 'ribaunt';

Signature

// Single token
function solveChallenge(
  token: ChallengeToken,
  options?: SolveChallengeOptions
): ChallengeSolution | undefined

// Array of tokens
function solveChallenge(
  token: ChallengeToken[],
  options?: SolveChallengeOptions
): ChallengeSolution[] | undefined

Parameters

ChallengeToken | ChallengeToken[]

required

A single JWT challenge token or an array of tokens from createChallenge().

SolveChallengeOptions

Optional guardrails to prevent long-running synchronous solves.

Show SolveChallengeOptions

number

Hard cap on nonce attempts per token. Returns undefined if reached.

number

default:"30000"

Max synchronous solve time in milliseconds per token. Returns undefined if exceeded.

Return value

Returns a ChallengeSolution ({ nonce: string; hash: string }) for a single token input, or ChallengeSolution[] for an array input. Returns undefined if any guardrail is hit or a token is invalid. When solving an array, undefined is returned as soon as any single token fails — no partial results are returned.

Example

import { createChallenge, solveChallenge, verifySolution } from 'ribaunt';

const tokens = createChallenge({ difficulty: 3, amount: 2, ttlSeconds: 60 });
const solutions = solveChallenge(tokens);

if (solutions) {
  const result = await verifySolution(tokens, solutions);
  console.log('Valid:', result.valid);
}

With guardrails:

const solution = solveChallenge(token, {
  maxDurationMs: 2000,
  maxIterations: 500_000,
});

if (!solution) {
  console.log('Solver gave up — difficulty too high or timeout reached');
}

solveChallenge() is synchronous and CPU-intensive. Never call it in a production HTTP request handler — it will block your Node.js event loop.

Use difficulty 3–4 in tests. Difficulty 5 will noticeably slow down your test suite.

Server API

Types

Import

Signature

Parameters

Return value

Example

​Import

​Signature

​Parameters

​Return value

​Example

Import

Signature

Parameters

Return value

Example