@prosopo/keyring 2.10.0 → 2.10.1

package/src/accounts/mnemonic.test.ts

@@ -1,103 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { u8aToHex } from "@polkadot/util";
-import {
-	mnemonicToMiniSecret,
-	mnemonicValidate,
-	sr25519FromSeed,
-} from "@prosopo/util-crypto";
-import { describe, expect, it } from "vitest";
-import { Keyring } from "../keyring/index.js";
-import { generateMiniSecret, generateMnemonic } from "./mnemonic.js";
-
-// Key derivation runs scrypt/pbkdf2 with production parameters and takes
-// seconds per call, so these suites need more than the 10s default.
-const SLOW = { timeout: 60000 };
-
-describe("generateMnemonic", SLOW, () => {
-	it("returns a valid twelve word mnemonic and its address", async () => {
-		const [mnemonic, address] = await generateMnemonic();
-		expect(mnemonic.split(" ")).toHaveLength(12);
-		expect(mnemonicValidate(mnemonic)).toBe(true);
-		expect(address).toBe(new Keyring().addFromMnemonic(mnemonic).address);
-	});
-
-	it("generates a fresh mnemonic each call", async () => {
-		// A repeated mnemonic would mean every generated account shares a key.
-		const [first] = await generateMnemonic();
-		const [second] = await generateMnemonic();
-		expect(second).not.toBe(first);
-	});
-
-	it("adds the account to a keyring it is given", async () => {
-		const keyring = new Keyring();
-		const [, address] = await generateMnemonic(keyring);
-		expect(keyring.getPairs()).toHaveLength(1);
-		expect(keyring.getPair(address).address).toBe(address);
-	});
-
-	it("uses a fresh keyring when none is passed, leaving no shared state", async () => {
-		const keyring = new Keyring();
-		await generateMnemonic();
-		expect(keyring.getPairs()).toEqual([]);
-	});
-
-	it("honours the requested pair type when it creates the keyring", async () => {
-		const [, address] = await generateMnemonic(undefined, "sr25519");
-		expect(typeof address).toBe("string");
-		await expect(generateMnemonic(undefined, "ed25519")).rejects.toThrow(
-			"Expected a keyring type of either 'sr25519'",
-		);
-	});
-
-	it("ignores the pair type when a keyring is supplied", async () => {
-		// The keyring already fixes the curve; the argument is only used to
-		// construct one, so an incompatible value must not throw here.
-		const keyring = new Keyring({ type: "sr25519" });
-		await expect(generateMnemonic(keyring, "ed25519")).resolves.toBeDefined();
-	});
-});
-
-describe("generateMiniSecret", SLOW, () => {
-	it("returns the 32 byte mini secret for the generated mnemonic", async () => {
-		const keyring = new Keyring();
-		const [secret, address] = await generateMiniSecret(keyring);
-
-		expect(secret).toHaveLength(32);
-		expect(u8aToHex(sr25519FromSeed(secret).publicKey)).toBe(
-			u8aToHex(keyring.getPair(address).publicKey),
-		);
-	});
-
-	it("derives the secret from the same mnemonic it registered", async () => {
-		const keyring = new Keyring();
-		const [secret] = await generateMiniSecret(keyring);
-		const registered = keyring.getPairs()[0];
-		expect(registered).toBeDefined();
-		expect(u8aToHex(secret)).not.toBe(u8aToHex(new Uint8Array(32)));
-	});
-
-	it("agrees with mnemonicToMiniSecret for a known phrase", async () => {
-		const phrase =
-			"bottom drive obey lake curtain smoke basket hold race lonely fit walk";
-		expect(u8aToHex(mnemonicToMiniSecret(phrase))).toHaveLength(66);
-	});
-
-	it("generates a fresh secret each call", async () => {
-		const [first] = await generateMiniSecret();
-		const [second] = await generateMiniSecret();
-		expect(u8aToHex(second)).not.toBe(u8aToHex(first));
-	});
-});

package/src/accounts/mnemonic.ts

@@ -1,45 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { mnemonicGenerate, mnemonicToMiniSecret } from "@prosopo/util-crypto";
-import type { KeypairType } from "@prosopo/util-crypto";
-import { Keyring } from "../keyring/keyring.js";
-
-/** Generate a mnemonic, returning the mnemonic and associated address
- * @param keyring
- * @param pairType
- */
-export async function generateMnemonic(
-	keyring?: Keyring,
-	pairType?: KeypairType,
-): Promise<[string, string]> {
-	if (!keyring) {
-		keyring = new Keyring({ type: pairType || "sr25519" });
-	}
-	const mnemonic = mnemonicGenerate();
-	const account = keyring.addFromMnemonic(mnemonic);
-	return [mnemonic, account.address];
-}
-
-/** Generate a secret, returning the secret and associated address
- * @param keyring
- * @param pairType
- */
-export async function generateMiniSecret(
-	keyring?: Keyring,
-	pairType?: KeypairType,
-): Promise<[Uint8Array, string]> {
-	const [mnemonic, address] = await generateMnemonic(keyring, pairType);
-	return [mnemonicToMiniSecret(mnemonic), address];
-}

package/src/accounts/testAccounts.test.ts

@@ -1,102 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { CaptchaType } from "@prosopo/types";
-import { describe, expect, it } from "vitest";
-import { DEV_PHRASE } from "../keyring/index.js";
-import { getPair } from "./getPair.js";
-import { getDefaultProviders, getDefaultSiteKeys } from "./testAccounts.js";
-
-// Key derivation runs scrypt/pbkdf2 with production parameters and takes
-// seconds per call, so these suites need more than the 10s default.
-const SLOW = { timeout: 60000 };
-
-describe("getDefaultSiteKeys", SLOW, () => {
-	it("provides one site per captcha type, in a stable order", () => {
-		expect(
-			getDefaultSiteKeys().map((site) => site.settings.captchaType),
-		).toEqual([
-			CaptchaType.image,
-			CaptchaType.pow,
-			CaptchaType.frictionless,
-			CaptchaType.puzzle,
-		]);
-	});
-
-	it("derives each site key from the dev phrase and its captcha type", () => {
-		// The seeded dev site keys are checked into fixtures and referenced by
-		// the demos, so the derivation must not drift.
-		for (const site of getDefaultSiteKeys()) {
-			expect(site.secret).toBe(`${DEV_PHRASE}//${site.settings.captchaType}`);
-			expect(site.address).toBe(getPair(site.secret).address);
-			expect(site.pair?.address).toBe(site.address);
-		}
-	});
-
-	it("gives every site a distinct address", () => {
-		const addresses = getDefaultSiteKeys().map((site) => site.address);
-		expect(new Set(addresses).size).toBe(addresses.length);
-	});
-
-	it("writes the settings explicitly rather than leaning on schema defaults", () => {
-		for (const site of getDefaultSiteKeys()) {
-			expect(site.settings.domains).toEqual(["localhost"]);
-			expect(site.settings.imageMaxRounds).toBe(2);
-			expect(
-				site.settings.frictionlessThreshold.frictionlessPuzzleThreshold,
-			).toBe(0.8);
-		}
-	});
-
-	it("returns a fresh array each call, so callers cannot corrupt the seed", () => {
-		const first = getDefaultSiteKeys();
-		const second = getDefaultSiteKeys();
-		expect(first).not.toBe(second);
-		first.pop();
-		expect(second).toHaveLength(4);
-	});
-});
-
-describe("getDefaultProviders", SLOW, () => {
-	it("provides a single local provider with a matching pair and address", () => {
-		const providers = getDefaultProviders();
-		expect(providers).toHaveLength(1);
-		const provider = providers[0];
-		expect(provider).toBeDefined();
-		if (!provider) return;
-		expect(provider.url).toBe("https://localhost:9229");
-		expect(provider.address).toBe(provider.pair?.address);
-	});
-
-	it("points at the checked-in dev dataset", () => {
-		const provider = getDefaultProviders()[0];
-		expect(provider?.datasetFile).toBe("./dev/data/captchas.json");
-		expect(provider?.captchaDatasetId).toMatch(/^0x[0-9a-f]{64}$/);
-	});
-
-	it("is deterministic across calls", () => {
-		expect(getDefaultProviders()[0]?.address).toBe(
-			getDefaultProviders()[0]?.address,
-		);
-	});
-
-	it("does not reuse a site key as the provider key", () => {
-		const siteAddresses = new Set(
-			getDefaultSiteKeys().map((site) => site.address),
-		);
-		expect(siteAddresses.has(getDefaultProviders()[0]?.address ?? "")).toBe(
-			false,
-		);
-	});
-});

package/src/accounts/testAccounts.ts

@@ -1,66 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-//sr25519 dev site keys
-import {
-	CaptchaType,
-	ClientSettingsSchema,
-	type IProviderAccount,
-	type ISite,
-} from "@prosopo/types";
-import { DEV_PHRASE } from "../keyring/index.js";
-import { getPair } from "./getPair.js";
-
-export function getDefaultSiteKeys(): ISite[] {
-	const captchaTypes = [
-		CaptchaType.image,
-		CaptchaType.pow,
-		CaptchaType.frictionless,
-		CaptchaType.puzzle,
-	];
-	const sites: ISite[] = [];
-	for (const captchaType of captchaTypes) {
-		const secret = `${DEV_PHRASE}//${captchaType}`;
-		const pair = getPair(secret);
-		// Settings are written explicitly rather than relying on schema defaults
-		// so dev seeds are self-describing and stay stable when defaults change.
-		sites.push({
-			pair: pair,
-			address: pair.address,
-			secret: secret,
-			settings: ClientSettingsSchema.parse({
-				captchaType: captchaType,
-				domains: ["localhost"],
-				imageMaxRounds: 2,
-				frictionlessThreshold: 0.8,
-			}),
-		});
-	}
-	return sites;
-}
-
-export function getDefaultProviders(): IProviderAccount[] {
-	const pair = getPair(
-		"puppy cream effort carbon despair leg pyramid cotton endorse immense drill peasant",
-	);
-	return [
-		{
-			url: "https://localhost:9229",
-			pair: pair,
-			address: pair.address,
-			datasetFile: "./dev/data/captchas.json",
-			captchaDatasetId:
-				"0x3e067b8f6aeae82fdbe2b2557b9c2d90aaabff241df651bf0f36667d2ab0018d",
-		},
-	];
-}

package/src/index.ts

@@ -1,16 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-export * from "./accounts/index.js";
-export * from "./keyring/index.js";
-export * from "./pair/index.js";

package/src/keyring/index.ts

@@ -1,15 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-export * from "./keyring.js";
-export * from "./pairs.js";