@prosopo/keyring 2.9.61 → 2.9.62

package/dist/keyring/pairs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairs.test.d.ts","sourceRoot":"","sources":["../../src/keyring/pairs.test.ts"],"names":[],"mappings":""}

package/dist/keyring/pairs.test.js

@@ -0,0 +1,84 @@
+import { decodeAddress, encodeAddress } from "@prosopo/util-crypto";
+import { describe, expect, it } from "vitest";
+import { nobody } from "../pair/nobody.js";
+import { Pairs } from "./pairs.js";
+const stubPair = (publicKey) => ({
+    ...nobody(),
+    address: encodeAddress(publicKey, 42),
+    addressRaw: publicKey,
+    publicKey,
+});
+const keyOf = (byte) => new Uint8Array(32).fill(byte);
+describe("Pairs", () => {
+    it("returns the pair it was given, so callers can chain off add", () => {
+        const pairs = new Pairs();
+        const pair = stubPair(keyOf(1));
+        expect(pairs.add(pair)).toBe(pair);
+    });
+    it("starts empty", () => {
+        expect(new Pairs().all()).toEqual([]);
+    });
+    it("retrieves a pair by SS58 address, public key or raw bytes", () => {
+        const pairs = new Pairs();
+        const publicKey = keyOf(2);
+        const pair = pairs.add(stubPair(publicKey));
+        expect(pairs.get(pair.address)).toBe(pair);
+        expect(pairs.get(publicKey)).toBe(pair);
+        expect(pairs.get(encodeAddress(publicKey, 2))).toBe(pair);
+    });
+    it("keeps only the latest pair for a public key", () => {
+        const pairs = new Pairs();
+        const publicKey = keyOf(3);
+        pairs.add(stubPair(publicKey));
+        const second = stubPair(publicKey);
+        pairs.add(second);
+        expect(pairs.all()).toHaveLength(1);
+        expect(pairs.get(publicKey)).toBe(second);
+    });
+    it("keeps distinct public keys apart", () => {
+        const pairs = new Pairs();
+        const first = pairs.add(stubPair(keyOf(4)));
+        const second = pairs.add(stubPair(keyOf(5)));
+        expect(pairs.all()).toEqual([first, second]);
+        expect(pairs.get(first.address)).toBe(first);
+        expect(pairs.get(second.address)).toBe(second);
+    });
+    it("names the address it could not find, formatting bytes as hex", () => {
+        const pairs = new Pairs();
+        expect(() => pairs.get(keyOf(6))).toThrow(`Unable to retrieve keypair '0x${"06".repeat(32)}'`);
+    });
+    it("names the address verbatim when it was given as SS58", () => {
+        const address = encodeAddress(keyOf(7), 42);
+        expect(() => new Pairs().get(address)).toThrow(`Unable to retrieve keypair '${address}'`);
+    });
+    it("rejects an address that is not decodable at all", () => {
+        expect(() => new Pairs().get("not-an-address")).toThrow();
+    });
+    it("removes a pair, after which lookup throws again", () => {
+        const pairs = new Pairs();
+        const publicKey = keyOf(8);
+        pairs.add(stubPair(publicKey));
+        pairs.remove(publicKey);
+        expect(pairs.all()).toEqual([]);
+        expect(() => pairs.get(publicKey)).toThrow("Unable to retrieve keypair");
+    });
+    it("removes by any encoding of the same key", () => {
+        const pairs = new Pairs();
+        const publicKey = keyOf(9);
+        const pair = pairs.add(stubPair(publicKey));
+        pairs.remove(encodeAddress(publicKey, 2));
+        expect(pairs.all()).toEqual([]);
+        expect(pair.address).toBe(encodeAddress(publicKey, 42));
+    });
+    it("ignores removal of a key that was never added", () => {
+        const pairs = new Pairs();
+        const kept = pairs.add(stubPair(keyOf(10)));
+        expect(() => pairs.remove(keyOf(11))).not.toThrow();
+        expect(pairs.all()).toEqual([kept]);
+    });
+    it("decodes the address for the map key rather than trusting the string", () => {
+        const publicKey = keyOf(12);
+        expect(decodeAddress(encodeAddress(publicKey, 42)).toString()).toBe(decodeAddress(encodeAddress(publicKey, 2)).toString());
+    });
+});
+//# sourceMappingURL=pairs.test.js.map

package/dist/keyring/pairs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairs.test.js","sourceRoot":"","sources":["../../src/keyring/pairs.test.ts"],"names":[],"mappings":"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"}

package/dist/keyring/testing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=testing.test.d.ts.map

package/dist/keyring/testing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.test.d.ts","sourceRoot":"","sources":["../../src/keyring/testing.test.ts"],"names":[],"mappings":""}

package/dist/keyring/testing.test.js

@@ -0,0 +1,97 @@
+import { u8aToHex } from "@polkadot/util";
+import { describe, expect, it } from "vitest";
+import { PAIRSSR25519, createTestKeyring } from "./testing.js";
+import { createTestPairs } from "./testingPairs.js";
+const SLOW = { timeout: 60000 };
+describe("createTestKeyring", SLOW, () => {
+    it("adds a pair for every well-known dev account", () => {
+        expect(createTestKeyring().getPairs()).toHaveLength(PAIRSSR25519.length);
+    });
+    it("names each pair after its seed, lowercased with the path flattened", () => {
+        const names = createTestKeyring()
+            .getPairs()
+            .map((pair) => pair.meta.name);
+        expect(names).toEqual([
+            "alice",
+            "alice_stash",
+            "bob",
+            "bob_stash",
+            "charlie",
+            "dave",
+            "eve",
+            "ferdie",
+        ]);
+    });
+    it("marks every pair as a testing pair", () => {
+        for (const pair of createTestKeyring().getPairs()) {
+            expect(pair.meta.isTesting).toBe(true);
+        }
+    });
+    it("uses the hard-coded public keys, not derivation, by default", () => {
+        const keyring = createTestKeyring();
+        for (const { p } of PAIRSSR25519) {
+            expect(u8aToHex(keyring.getPair(p).publicKey)).toBe(p);
+        }
+    });
+    it("replaces lock with a no-op so the fixtures stay usable", () => {
+        const pair = createTestKeyring().getPairs()[0];
+        expect(pair).toBeDefined();
+        if (!pair)
+            return;
+        expect(() => pair.lock()).not.toThrow();
+        expect(pair.isLocked).toBe(false);
+    });
+    it("produces signable pairs", () => {
+        const pair = createTestKeyring().getPair(PAIRSSR25519[0]?.p ?? "0x");
+        const message = new TextEncoder().encode("hello");
+        expect(pair.verify(message, pair.sign(message), pair.publicKey)).toBe(true);
+    });
+    it("honours a requested ss58 format", () => {
+        const alice = PAIRSSR25519[0]?.p ?? "0x";
+        expect(createTestKeyring({ ss58Format: 42 }).getPair(alice).address).not.toBe(createTestKeyring({ ss58Format: 2 }).getPair(alice).address);
+    });
+    it("derives different keys when asked to, because the seeds are bare names", () => {
+        const derived = createTestKeyring({}, false);
+        expect(derived.getPairs()).toHaveLength(PAIRSSR25519.length);
+        for (const { p } of PAIRSSR25519) {
+            expect(() => derived.getPair(p)).toThrow("Unable to retrieve keypair");
+        }
+    });
+    it("rejects a keyring type it cannot support", () => {
+        expect(() => createTestKeyring({ type: "ed25519" })).toThrow("Expected a keyring type of either 'sr25519'");
+    });
+});
+describe("createTestPairs", SLOW, () => {
+    it("exposes every named pair plus nobody", () => {
+        const pairs = createTestPairs();
+        for (const name of [
+            "nobody",
+            "alice",
+            "alice_stash",
+            "bob",
+            "bob_stash",
+            "charlie",
+            "dave",
+            "eve",
+            "ferdie",
+        ]) {
+            expect(pairs[name], name).toBeDefined();
+        }
+    });
+    it("maps alice to the well-known Alice public key", () => {
+        expect(u8aToHex(createTestPairs().alice?.publicKey ?? new Uint8Array())).toBe(PAIRSSR25519[0]?.p);
+    });
+    it("includes nobody, which cannot verify anything", () => {
+        const nobodyPair = createTestPairs().nobody;
+        expect(nobodyPair).toBeDefined();
+        expect(nobodyPair?.isLocked).toBe(true);
+        expect(nobodyPair?.verify(new Uint8Array(1), new Uint8Array(64), nobodyPair.publicKey)).toBe(false);
+    });
+    it("returns independent maps so one test cannot poison another", () => {
+        const first = createTestPairs();
+        const second = createTestPairs();
+        expect(first).not.toBe(second);
+        expect(first.alice).not.toBe(second.alice);
+    });
+});
+//# sourceMappingURL=testing.test.js.map

package/dist/keyring/testing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.test.js","sourceRoot":"","sources":["../../src/keyring/testing.test.ts"],"names":[],"mappings":"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"}

package/dist/keyring.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=keyring.test-d.d.ts.map

package/dist/keyring.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyring.test-d.d.ts","sourceRoot":"","sources":["../src/keyring.test-d.ts"],"names":[],"mappings":""}

package/dist/keyring.test-d.js

@@ -0,0 +1,66 @@
+import { assertType, describe, expectTypeOf, it } from "vitest";
+import { Keyring, generateMiniSecret, generateMnemonic, getDefaultProviders, getDefaultSiteKeys, getPair, } from "./index.js";
+import { nobody } from "./pair/nobody.js";
+describe("Keyring types", () => {
+    it("implements the shared KeyringInstance contract", () => {
+        expectTypeOf().toExtend();
+    });
+    it("returns KeyringPair from every add and create method", () => {
+        const keyring = new Keyring();
+        expectTypeOf(keyring.addFromUri("//Alice")).toEqualTypeOf();
+        expectTypeOf(keyring.addFromMnemonic("x")).toEqualTypeOf();
+        expectTypeOf(keyring.addFromSeed(new Uint8Array())).toEqualTypeOf();
+        expectTypeOf(keyring.addFromAddress("x")).toEqualTypeOf();
+        expectTypeOf(keyring.getPair("x")).toEqualTypeOf();
+        expectTypeOf(keyring.getPairs()).toEqualTypeOf();
+        expectTypeOf(keyring.publicKeys).toEqualTypeOf();
+        expectTypeOf(keyring.toJson("x")).toEqualTypeOf();
+    });
+    it("accepts an address as either a string or raw bytes", () => {
+        const keyring = new Keyring();
+        assertType(keyring.getPair("5abc"));
+        assertType(keyring.getPair(new Uint8Array(32)));
+        assertType(keyring.getPair(1));
+    });
+    it("rejects a keyring option object with an unknown key", () => {
+        new Keyring({ curve: "sr25519" });
+    });
+    it("has a readonly type", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+describe("account helper types", () => {
+    it("returns a pair from getPair with every argument optional", () => {
+        expectTypeOf(getPair).returns.toEqualTypeOf();
+        assertType(getPair());
+        assertType(getPair("secret", "account", "sr25519", 42));
+    });
+    it("returns the mnemonic and address as a tuple", () => {
+        expectTypeOf(generateMnemonic).returns.resolves.toEqualTypeOf();
+    });
+    it("returns the mini secret as bytes paired with an address", () => {
+        expectTypeOf(generateMiniSecret).returns.resolves.toEqualTypeOf();
+    });
+    it("describes the dev fixtures with the shared account types", () => {
+        expectTypeOf(getDefaultSiteKeys()).toEqualTypeOf();
+        expectTypeOf(getDefaultProviders()).toEqualTypeOf();
+    });
+    it("returns a real KeyringPair for nobody", () => {
+        expectTypeOf(nobody()).toEqualTypeOf();
+    });
+});
+describe("test keyring map inference", () => {
+    it("defaults to the substrate map when no options are given", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("selects the ethereum map only for an ethereum keyring", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("indexes the map by arbitrary names, always yielding a pair", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+//# sourceMappingURL=keyring.test-d.js.map

package/dist/keyring.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyring.test-d.js","sourceRoot":"","sources":["../src/keyring.test-d.ts"],"names":[],"mappings":"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"}

package/dist/pair/decode.spec.js

@@ -5,7 +5,7 @@ describe("decode", () => {
     it("fails when no data provided", () => {
         expect(() => keyring.alice.decodePkcs8()).toThrow(/(No encrypted data available|Password required)/);
     });
-    it("returns correct publicKey from encoded", () => {
+    it("returns correct publicKey from encoded", { timeout: 60000 }, () => {
         const PASS = "testing";
         expect(() => keyring.alice.decodePkcs8(PASS, keyring.alice.encodePkcs8(PASS))).not.toThrow();
     });

package/dist/pair/decode.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"decode.spec.js","sourceRoot":"","sources":["../../src/pair/decode.spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAE5D,QAAQ,CAAC,QAAQ,EAAE,GAAS,EAAE;IAC7B,EAAE,CAAC,6BAA6B,EAAE,GAAS,EAAE;QAC5C,MAAM,CAAC,GAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CACtD,iDAAiD,CACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAS,EAAE;QACvD,MAAM,IAAI,GAAG,SAAS,CAAC;QAEvB,MAAM,CAAC,GAAS,EAAE,CACjB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAChE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"decode.spec.js","sourceRoot":"","sources":["../../src/pair/decode.spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAE5D,QAAQ,CAAC,QAAQ,EAAE,GAAS,EAAE;IAC7B,EAAE,CAAC,6BAA6B,EAAE,GAAS,EAAE;QAC5C,MAAM,CAAC,GAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CACtD,iDAAiD,CACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAIH,EAAE,CAAC,wCAAwC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,GAAS,EAAE;QAC3E,MAAM,IAAI,GAAG,SAAS,CAAC;QAEvB,MAAM,CAAC,GAAS,EAAE,CACjB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAChE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/pair/encode.spec.js

@@ -9,7 +9,7 @@ describe("encode", () => {
     it("returns PKCS8 when no passphrase supplied", () => {
         expect(keyring.alice.encodePkcs8()).toHaveLength(DECODED_LENGTH);
     });
-    it("returns encoded PKCS8 when passphrase supplied", () => {
+    it("returns encoded PKCS8 when passphrase supplied", { timeout: 60000 }, () => {
         expect(keyring.alice.encodePkcs8("testing")).toHaveLength(ENCODED_LENGTH);
     });
 });

package/dist/pair/encode.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"encode.spec.js","sourceRoot":"","sources":["../../src/pair/encode.spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,cAAc,GACnB,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAC7D,MAAM,cAAc,GAAG,EAAE,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAE1E,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAE5D,QAAQ,CAAC,QAAQ,EAAE,GAAS,EAAE;IAC7B,EAAE,CAAC,2CAA2C,EAAE,GAAS,EAAE;QAC1D,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAS,EAAE;QAC/D,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"encode.spec.js","sourceRoot":"","sources":["../../src/pair/encode.spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,cAAc,GACnB,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAC7D,MAAM,cAAc,GAAG,EAAE,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAE1E,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAE5D,QAAQ,CAAC,QAAQ,EAAE,GAAS,EAAE;IAC7B,EAAE,CAAC,2CAA2C,EAAE,GAAS,EAAE;QAC1D,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAIH,EAAE,CACD,gDAAgD,EAChD,EAAE,OAAO,EAAE,KAAK,EAAE,EAClB,GAAS,EAAE;QACV,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAC3E,CAAC,CACD,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/pair/nobody.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nobody.test.d.ts.map

package/dist/pair/nobody.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nobody.test.d.ts","sourceRoot":"","sources":["../../src/pair/nobody.test.ts"],"names":[],"mappings":""}

package/dist/pair/nobody.test.js

@@ -0,0 +1,77 @@
+import { encodeAddress } from "@prosopo/util-crypto";
+import { describe, expect, it } from "vitest";
+import { PAIR_DIV, PAIR_HDR, PUB_LENGTH, SALT_LENGTH, SEC_LENGTH, SEED_LENGTH, } from "./defaults.js";
+import { nobody } from "./nobody.js";
+describe("nobody", () => {
+    it("is the all-zero public key, encoded as the well-known address", () => {
+        const pair = nobody();
+        expect(pair.publicKey).toEqual(new Uint8Array(32));
+        expect(pair.address).toBe("5C4hrfjw9DjXZTzV3MwzrrAr9P1MJhSrvWGWqi1eSuyUpnhM");
+        expect(pair.address).toBe(encodeAddress(pair.publicKey, 42));
+    });
+    it("is permanently locked", () => {
+        const pair = nobody();
+        expect(pair.isLocked).toBe(true);
+        pair.unlock("anything");
+        expect(pair.isLocked).toBe(true);
+        pair.lock();
+        expect(pair.isLocked).toBe(true);
+    });
+    it("never verifies a signature, whatever it is given", () => {
+        const pair = nobody();
+        expect(pair.verify(new Uint8Array(1), new Uint8Array(64), pair.publicKey)).toBe(false);
+        expect(pair.verify(new Uint8Array(0), pair.sign(new Uint8Array(1)), pair.publicKey)).toBe(false);
+        expect(pair.vrfVerify(new Uint8Array(1), new Uint8Array(96), pair.publicKey)).toBe(false);
+    });
+    it("never reports a JWT as valid", () => {
+        const result = nobody().jwtVerify(nobody().jwtIssue());
+        expect(result.isValid).toBe(false);
+        expect(result.error).toBe("JWT verification failed");
+        expect(result.publicKey).toEqual(new Uint8Array(32));
+    });
+    it("returns correctly sized but empty signatures", () => {
+        const pair = nobody();
+        expect(pair.sign(new Uint8Array(1))).toEqual(new Uint8Array(64));
+        expect(pair.vrfSign(new Uint8Array(1))).toEqual(new Uint8Array(96));
+        expect(pair.encodePkcs8()).toEqual(new Uint8Array(0));
+    });
+    it("derives to itself, so no chain of derivation can escape it", () => {
+        const pair = nobody();
+        expect(pair.derive("//anything")).toBe(pair);
+        expect(pair.derive("//a").derive("//b")).toBe(pair);
+    });
+    it("ignores attempts to change its meta", () => {
+        const pair = nobody();
+        pair.setMeta({ name: "somebody" });
+        expect(pair.meta.name).toBe("nobody");
+        expect(pair.meta.isTesting).toBe(true);
+    });
+    it("serialises to an unencrypted v0 json blob", () => {
+        const json = nobody().toJson();
+        expect(json.address).toBe(nobody().address);
+        expect(json.encoded).toBe("");
+        expect(json.encoding.version).toBe("0");
+        expect(json.encoding.type).toBe("none");
+    });
+    it("returns the same shared instance each call", () => {
+        expect(nobody()).toBe(nobody());
+    });
+    it("accepts pkcs8 decoding without throwing", () => {
+        expect(() => nobody().decodePkcs8("pass", new Uint8Array(1))).not.toThrow();
+    });
+});
+describe("pair defaults", () => {
+    it("declares the sr25519 key and seed lengths", () => {
+        expect(PUB_LENGTH).toBe(32);
+        expect(SEED_LENGTH).toBe(32);
+        expect(SALT_LENGTH).toBe(32);
+        expect(SEC_LENGTH).toBe(64);
+    });
+    it("declares the pkcs8 header and divider used by the encoder", () => {
+        expect(Array.from(PAIR_DIV)).toEqual([161, 35, 3, 33, 0]);
+        expect(Array.from(PAIR_HDR)).toEqual([
+            48, 83, 2, 1, 1, 48, 5, 6, 3, 43, 101, 112, 4, 34, 4, 32,
+        ]);
+    });
+});
+//# sourceMappingURL=nobody.test.js.map

package/dist/pair/nobody.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nobody.test.js","sourceRoot":"","sources":["../../src/pair/nobody.test.ts"],"names":[],"mappings":"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"}

package/dist/pair/toJson.spec.js

@@ -17,7 +17,7 @@ describe("toJson", () => {
             },
         });
     });
-    it("creates an encoded output with passphrase", () => {
+    it("creates an encoded output with passphrase", { timeout: 60000 }, () => {
         const json = keyring.alice.toJson("testing");
         expect(json.encoded).toHaveLength(268);
         expect(json).toMatchObject({

package/dist/pair/toJson.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"toJson.spec.js","sourceRoot":"","sources":["../../src/pair/toJson.spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAE5D,QAAQ,CAAC,QAAQ,EAAE,GAAS,EAAE;IAC7B,EAAE,CAAC,gDAAgD,EAAE,GAAS,EAAE;QAC/D,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,CAAC;YAC5C,OAAO,EAAE,kDAAkD;YAC3D,OAAO,EACN,8JAA8J;YAC/J,QAAQ,EAAE;gBACT,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC7B,IAAI,EAAE,CAAC,MAAM,CAAC;gBACd,OAAO,EAAE,GAAG;aACZ;YACD,IAAI,EAAE;gBACL,SAAS,EAAE,IAAI;gBACf,IAAI,EAAE,OAAO;aACb;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAS,EAAE;QAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE7C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC;YAC1B,OAAO,EAAE,kDAAkD;YAC3D,QAAQ,EAAE;gBACT,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC7B,IAAI,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC;gBACrC,OAAO,EAAE,GAAG;aACZ;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"toJson.spec.js","sourceRoot":"","sources":["../../src/pair/toJson.spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAE5D,QAAQ,CAAC,QAAQ,EAAE,GAAS,EAAE;IAC7B,EAAE,CAAC,gDAAgD,EAAE,GAAS,EAAE;QAC/D,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,CAAC;YAC5C,OAAO,EAAE,kDAAkD;YAC3D,OAAO,EACN,8JAA8J;YAC/J,QAAQ,EAAE;gBACT,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC7B,IAAI,EAAE,CAAC,MAAM,CAAC;gBACd,OAAO,EAAE,GAAG;aACZ;YACD,IAAI,EAAE;gBACL,SAAS,EAAE,IAAI;gBACf,IAAI,EAAE,OAAO;aACb;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAIH,EAAE,CACD,2CAA2C,EAC3C,EAAE,OAAO,EAAE,KAAK,EAAE,EAClB,GAAS,EAAE;QACV,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE7C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC;YAC1B,OAAO,EAAE,kDAAkD;YAC3D,QAAQ,EAAE;gBACT,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC7B,IAAI,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC;gBACrC,OAAO,EAAE,GAAG;aACZ;SACD,CAAC,CAAC;IACJ,CAAC,CACD,CAAC;AACH,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prosopo/keyring",
-	"version": "2.9.61",
+	"version": "2.9.62",
 	"description": "Keypair generator for Prosopo",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/src/accounts/getPair.test.ts

@@ -0,0 +1,142 @@
+// 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 type { KeyringPair$Json } from "@prosopo/types";
+import { encodeAddress, sr25519FromSeed } from "@prosopo/util-crypto";
+import { describe, expect, it } from "vitest";
+import { DEV_PHRASE, Keyring } from "../keyring/index.js";
+import { getPair } from "./getPair.js";
+
+const SEED_32 = new Uint8Array(32).fill(7);
+const SEED_HEX = u8aToHex(SEED_32);
+const ALICE_PUBLIC =
+	"0xd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d";
+
+const pairJson = (
+	overrides: Partial<KeyringPair$Json> = {},
+): KeyringPair$Json => ({
+	address: encodeAddress(new Uint8Array(32).fill(8), 42),
+	encoded: "0x00",
+	encoding: { content: ["pkcs8", "sr25519"], type: ["none"], version: "3" },
+	meta: {},
+	...overrides,
+});
+
+// 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("getPair secret handling", SLOW, () => {
+	it("derives from a mnemonic", () => {
+		expect(getPair(DEV_PHRASE).address).toBe(
+			new Keyring({ ss58Format: 42 }).addFromMnemonic(DEV_PHRASE).address,
+		);
+	});
+
+	it("derives from a hex seed", () => {
+		expect(u8aToHex(getPair(SEED_HEX).publicKey)).toBe(
+			u8aToHex(sr25519FromSeed(SEED_32).publicKey),
+		);
+	});
+
+	it("derives from a suri with a hard derivation path", () => {
+		expect(u8aToHex(getPair(`${DEV_PHRASE}//Alice`).publicKey)).toBe(
+			ALICE_PUBLIC,
+		);
+	});
+
+	it("prefers the mnemonic branch over the suri branch", () => {
+		// A bare valid mnemonic contains no "//", but the ordering matters if
+		// one is ever added: mnemonic validation must win so the derivation
+		// path is honoured rather than the whole string being padded.
+		const suri = `${DEV_PHRASE}//1`;
+		expect(getPair(suri).address).not.toBe(getPair(DEV_PHRASE).address);
+	});
+
+	it("parses a JSON string, taking the crypto type from its encoding", () => {
+		const pair = getPair(JSON.stringify(pairJson()));
+		expect(pair.type).toBe("sr25519");
+		expect(u8aToHex(pair.publicKey)).toBe(u8aToHex(new Uint8Array(32).fill(8)));
+	});
+
+	it("accepts a JSON object directly", () => {
+		expect(getPair(pairJson()).type).toBe("sr25519");
+	});
+
+	it("reports a missing secret when the string is neither key nor JSON", () => {
+		// The unparseable case funnels into the same error as a genuinely
+		// absent secret, so an operator sees one actionable message.
+		expect(() => getPair("this is not a secret")).toThrow();
+	});
+
+	it("reports a missing secret for JSON without an encoding block", () => {
+		expect(() => getPair('{"address":"x"}')).toThrow();
+	});
+
+	it("throws when neither a secret nor an account is given", () => {
+		expect(() => getPair()).toThrow();
+	});
+
+	it("throws when the secret is an empty string and no account is given", () => {
+		expect(() => getPair("")).toThrow();
+	});
+});
+
+describe("getPair account handling", SLOW, () => {
+	it("builds a watch-only pair from an address when no secret is given", () => {
+		const address = getPair(DEV_PHRASE).address;
+		const watchOnly = getPair(undefined, address);
+		expect(watchOnly.address).toBe(address);
+		expect(watchOnly.isLocked).toBe(true);
+	});
+
+	it("accepts a raw public key as the account", () => {
+		const pair = getPair(DEV_PHRASE);
+		expect(getPair(undefined, pair.publicKey).address).toBe(pair.address);
+	});
+
+	it("ignores the account once a secret is supplied", () => {
+		const other = getPair(`${DEV_PHRASE}//other`).address;
+		expect(getPair(DEV_PHRASE, other).address).toBe(
+			getPair(DEV_PHRASE).address,
+		);
+	});
+});
+
+describe("getPair defaults", SLOW, () => {
+	it("defaults to sr25519 and ss58 format 42", () => {
+		const pair = getPair(DEV_PHRASE);
+		expect(pair.type).toBe("sr25519");
+		expect(pair.address).toBe(encodeAddress(pair.publicKey, 42));
+	});
+
+	it("honours an explicit ss58 format", () => {
+		const pair = getPair(DEV_PHRASE, undefined, "sr25519", 2);
+		expect(pair.address).toBe(encodeAddress(pair.publicKey, 2));
+	});
+
+	it("rejects a pair type the keyring does not support", () => {
+		expect(() => getPair(DEV_PHRASE, undefined, "ed25519")).toThrow(
+			"Expected a keyring type of either 'sr25519'",
+		);
+	});
+
+	it("treats ss58 format 0 as unset, because it is falsy", () => {
+		// Documents a live quirk of the `||` defaulting: Polkadot's own
+		// format 0 cannot be requested and silently becomes 42.
+		const pair = getPair(DEV_PHRASE, undefined, "sr25519", 0);
+		expect(pair.address).toBe(encodeAddress(pair.publicKey, 42));
+	});
+});