@cap.js/solver

@cap.js/solver is a standalone library that can be used to solve Cap challenges from the server. It's extremely simple (no dependencies, one single file) yet as fast and efficient as the widget. Note that it can only be used with Bun. Node.js support is not planned.

Installation

bun add @cap.js/solver

Usage

From seeded challenges

import solver from "@cap.js/solver";

console.log(
  await solver("challenge token", {
    c: 50, // challenge count
    s: 32, // salt size
    d: 4, // difficulty
  })
);

From challenge list

import solver from "@cap.js/solver";

const challenges = [
  ["a5b6fda4aaed97cf61d7dd9259f733b5", "d455"],
  ["286bcc39249f9ee698314b600c32e40f", "f0ff"],
  ["501350aa7c46573cb604284554045703", "4971"],
  ["a55c02f3b9b4cd088a5a7ee3d4941c14", "eab7"],
  ["5f3362c12e2779f56f4ef75b4494f5e6", "999f"],
  /* ... */
];

console.log(await solver(challenges));

Output:

[67302, 64511, 40440, 27959, 71259 /* ... */]

The 2nd argument is optional but can always be provided. It's always an object.

• For all challenge types, workerCount indicates the number of workers to use (default is the number of CPU cores).

• For all challenge types, onProgress can also be used to provide a callback for progress updates.

• For seeded challenges only, it is used to specify the number of solutions to generate, the size of the challenges, and the difficulty

FAQ

Why is this needed?

Mainly for M2M interactions, where you want to solve Cap challenges on the server without user interaction.

Doesn't this defeat the purpose of Cap?

Not really. Server-side solving is a core use case of proof-of-work CAPTCHAs like Cap or altcha. It's about proving effort, not necessarily involving a human. Learn more