accounts 0.3.0 → 0.4.1

package/dist/core/adapters/webAuthn.js

@@ -0,0 +1,93 @@
+import { PublicKey, Signature } from 'ox';
+import { SignatureEnvelope } from 'ox/tempo';
+import { Account } from 'viem/tempo';
+import { Authentication, Registration } from 'webauthx/client';
+import * as Adapter from '../Adapter.js';
+import * as Ceremony from '../Ceremony.js';
+import { local } from './local.js';
+/**
+ * Creates a WebAuthn adapter backed by real passkey ceremonies.
+ *
+ * Wraps the {@link local} adapter with WebAuthn registration and authentication flows,
+ * using the provided {@link Ceremony} for challenge generation and verification.
+ *
+ * @example
+ * ```ts
+ * import { webAuthn } from 'accounts'
+ *
+ * const provider = Provider.create({
+ *   adapter: webAuthn(),
+ * })
+ * ```
+ */
+export function webAuthn(options = {}) {
+    const { authUrl, icon, name, rdns } = options;
+    return Adapter.define({ icon, name, rdns }, (parameters) => {
+        const { storage } = parameters;
+        const ceremony = options.ceremony ??
+            (authUrl ? Ceremony.server({ url: authUrl }) : Ceremony.local({ storage }));
+        const base = local({
+            async createAccount(parameters) {
+                const { options } = await ceremony.getRegistrationOptions(parameters);
+                const rpId = options.publicKey?.rp.id;
+                if (!rpId)
+                    throw new Error('rpId is required');
+                const credential = await Registration.create({ options });
+                const { publicKey } = await ceremony.verifyRegistration(credential, {
+                    name: parameters.name,
+                });
+                await storage.setItem('lastCredentialId', credential.id);
+                const account = Account.fromWebAuthnP256({ id: credential.id, publicKey });
+                return {
+                    accounts: [
+                        {
+                            address: account.address,
+                            keyType: 'webAuthn',
+                            credential: { id: credential.id, publicKey, rpId },
+                        },
+                    ],
+                };
+            },
+            async loadAccounts(parameters = {}) {
+                const { selectAccount, digest } = parameters;
+                const credentialId = selectAccount
+                    ? undefined
+                    : (parameters?.credentialId ??
+                        (await storage.getItem('lastCredentialId')) ??
+                        undefined);
+                const { options } = await ceremony.getAuthenticationOptions({
+                    ...parameters,
+                    challenge: digest,
+                    credentialId,
+                });
+                const rpId = options.publicKey?.rpId;
+                if (!rpId)
+                    throw new Error('rpId is required');
+                const response = await Authentication.sign({ options });
+                const { publicKey } = await ceremony.verifyAuthentication(response);
+                await storage.setItem('lastCredentialId', response.id);
+                const account = Account.fromWebAuthnP256({ id: response.id, publicKey }, { rpId });
+                const signature = digest
+                    ? SignatureEnvelope.serialize({
+                        metadata: response.metadata,
+                        publicKey: PublicKey.fromHex(publicKey),
+                        signature: Signature.from(response.signature),
+                        type: 'webAuthn',
+                    }, { magic: true })
+                    : undefined;
+                return {
+                    accounts: [
+                        {
+                            address: account.address,
+                            keyType: 'webAuthn',
+                            credential: { id: response.id, publicKey, rpId },
+                        },
+                    ],
+                    signature,
+                };
+            },
+        })(parameters);
+        return { ...base, persistAccounts: true };
+    });
+}
+//# sourceMappingURL=webAuthn.js.map

package/dist/core/adapters/webAuthn.js.map

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

package/dist/core/internal/withDedupe.d.ts

@@ -0,0 +1,12 @@
+/** Deduplicates in-flight promises by key. */
+export declare function withDedupe<data>(fn: () => Promise<data>, { enabled, id }: withDedupe.Options): Promise<data>;
+export declare namespace withDedupe {
+    var cache: Map<string, Promise<any>>;
+}
+export declare namespace withDedupe {
+    type Options = {
+        enabled?: boolean | undefined;
+        id?: string | undefined;
+    };
+}
+//# sourceMappingURL=withDedupe.d.ts.map

package/dist/core/internal/withDedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withDedupe.d.ts","sourceRoot":"","sources":["../../../src/core/internal/withDedupe.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,IAAI,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,EAAE,OAAc,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,OAAO,GACzC,OAAO,CAAC,IAAI,CAAC,CAMf;yBATe,UAAU;;;AAW1B,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAK,OAAO,GAAG;QACb,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACxB,CAAA;CACF"}

package/dist/core/internal/withDedupe.js

@@ -0,0 +1,12 @@
+/** Deduplicates in-flight promises by key. */
+export function withDedupe(fn, { enabled = true, id }) {
+    if (!enabled || !id)
+        return fn();
+    if (withDedupe.cache.get(id))
+        return withDedupe.cache.get(id);
+    const promise = fn().finally(() => withDedupe.cache.delete(id));
+    withDedupe.cache.set(id, promise);
+    return promise;
+}
+withDedupe.cache = new Map();
+//# sourceMappingURL=withDedupe.js.map

package/dist/core/internal/withDedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withDedupe.js","sourceRoot":"","sources":["../../../src/core/internal/withDedupe.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CACxB,EAAuB,EACvB,EAAE,OAAO,GAAG,IAAI,EAAE,EAAE,EAAsB;IAE1C,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,CAAA;IAChC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAE,CAAA;IAC9D,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/D,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACjC,OAAO,OAAO,CAAA;AAChB,CAAC;AASD,UAAU,CAAC,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAA"}

package/dist/core/zod/request.d.ts

@@ -0,0 +1,31 @@
+import * as z from 'zod/mini';
+/**
+ * Validates an incoming JSON-RPC request against the provider schema.
+ *
+ * Returns the original request augmented with a `_decoded` property
+ * containing the Zod-parsed output (with codec transforms applied).
+ *
+ * Throws EIP-1193 errors on validation failure:
+ * - `4200` if the method is not in the discriminated union
+ * - `-32602` if params fail validation
+ */
+export declare function validate<const schema extends z.ZodMiniType>(schema: schema, value: unknown): WithDecoded<schema>;
+/**
+ * A validated request with the decoded (Zod-parsed) output attached.
+ *
+ * Distributes over the union so that switching on `method` narrows
+ * both the input and `_decoded` properties together.
+ */
+export type WithDecoded<schema extends z.ZodMiniType> = z.output<schema> extends infer decoded ? decoded extends {
+    method: infer m extends string;
+} ? Extract<z.input<schema>, {
+    method: m;
+}> & {
+    _decoded: decoded;
+} : never : never;
+/**
+ * Encodes a decoded (output) value back to its wire (input) format
+ * by running codec `reverseTransform` functions.
+ */
+export declare function encode<const schema extends z.ZodMiniType>(schema: schema, value: z.output<schema>): z.input<schema>;
+//# sourceMappingURL=request.d.ts.map

package/dist/core/zod/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/core/zod/request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EACzD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,WAAW,CAAC,MAAM,CAAC,CAcrB;AAiBD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,IAClD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,OAAO,GAClC,OAAO,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC/D,KAAK,GACP,KAAK,CAAA;AAEX;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EACvD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GACtB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAEjB"}

package/dist/core/zod/request.js

@@ -0,0 +1,41 @@
+import { Provider } from 'ox';
+import * as z from 'zod/mini';
+/**
+ * Validates an incoming JSON-RPC request against the provider schema.
+ *
+ * Returns the original request augmented with a `_decoded` property
+ * containing the Zod-parsed output (with codec transforms applied).
+ *
+ * Throws EIP-1193 errors on validation failure:
+ * - `4200` if the method is not in the discriminated union
+ * - `-32602` if params fail validation
+ */
+export function validate(schema, value) {
+    const result = z.safeParse(schema, value);
+    if (result.error) {
+        const issue = result.error.issues.at(0);
+        if (issue?.code === 'invalid_union' && issue.note === 'No matching discriminator')
+            throw new Provider.UnsupportedMethodError({
+                message: `Unsupported method "${value?.method}".`,
+            });
+        throw new Provider.ProviderRpcError(-32602, `Invalid params: ${formatIssues(result.error.issues)}`);
+    }
+    return { ...value, _decoded: result.data };
+}
+function formatIssues(issues) {
+    return issues
+        .flatMap((issue) => {
+        if (issue.code === 'invalid_union' && issue.errors.length > 0)
+            return issue.errors.flatMap((branch) => branch.map((i) => `${[...issue.path, ...i.path].join('.')}: ${i.code === 'invalid_union' && i.errors.length > 0 ? formatIssues([i]) : i.message}`));
+        return [`${issue.path.join('.')}: ${issue.message}`];
+    })
+        .join(', ');
+}
+/**
+ * Encodes a decoded (output) value back to its wire (input) format
+ * by running codec `reverseTransform` functions.
+ */
+export function encode(schema, value) {
+    return z.encode(schema, value);
+}
+//# sourceMappingURL=request.js.map

package/dist/core/zod/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/core/zod/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAA;AAC7B,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAc,EACd,KAAc;IAEd,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACzC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACvC,IAAI,KAAK,EAAE,IAAI,KAAK,eAAe,IAAK,KAAa,CAAC,IAAI,KAAK,2BAA2B;YACxF,MAAM,IAAI,QAAQ,CAAC,sBAAsB,CAAC;gBACxC,OAAO,EAAE,uBAAwB,KAAa,EAAE,MAAM,IAAI;aAC3D,CAAC,CAAA;QACJ,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CACjC,CAAC,KAAK,EACN,mBAAmB,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CACvD,CAAA;IACH,CAAC;IACD,OAAO,EAAE,GAAI,KAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAW,CAAA;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,MAAmC;IACvD,OAAO,MAAM;SACV,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAC3D,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACrC,MAAM,CAAC,GAAG,CACR,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAClI,CACF,CAAA;QACH,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IACtD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAeD;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,MAAc,EACd,KAAuB;IAEvB,OAAQ,CAAwC,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AACxE,CAAC"}