@icp-sdk/signer 5.2.0

package/lib/esm/agent/agent.js

@@ -0,0 +1,288 @@
+import { Cbor, Certificate, Expiry, HttpAgent, IC_ROOT_KEY, JSON_KEY_EXPIRY, LookupPathStatus, requestIdOf, SubmitRequestType, } from '@icp-sdk/core/agent';
+import { uint8Equals } from '@icp-sdk/core/candid';
+import { Principal } from '@icp-sdk/core/principal';
+// Hex helpers — use native Uint8Array methods when available
+const fromHex = (hex) => {
+    if ('fromHex' in Uint8Array && typeof Uint8Array.fromHex === 'function') {
+        return Uint8Array.fromHex(hex);
+    }
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+};
+const toHex = (bytes) => {
+    if ('toHex' in bytes && typeof bytes.toHex === 'function') {
+        return bytes.toHex();
+    }
+    let hex = '';
+    for (let i = 0; i < bytes.byteLength; i++) {
+        hex += bytes[i].toString(16).padStart(2, '0');
+    }
+    return hex;
+};
+// IC root key as bytes, used as fallback when agent has no root key
+const ROOT_KEY = fromHex(IC_ROOT_KEY);
+const MAX_AGE_IN_MINUTES = 5;
+const INVALID_RESPONSE_MESSAGE = 'Received invalid response from signer';
+/**
+ * Error thrown by {@link SignerAgent} when a signer returns an invalid
+ * response or certificate validation fails.
+ */
+export class SignerAgentError extends Error {
+}
+/**
+ * An {@link Agent} implementation that routes canister calls through a
+ * {@link Signer} for user approval. Drop-in replacement for {@link HttpAgent}
+ * when canister calls need to be signed by an external signer.
+ *
+ * Calls are sent to the signer via ICRC-49, and the returned content map
+ * and certificate are validated before being returned to the caller.
+ *
+ * Use {@link SignerAgent.create} or {@link SignerAgent.createSync} to
+ * construct an instance — the constructor is private.
+ * @example
+ * ```ts
+ * const agent = await SignerAgent.create({ signer, account });
+ * const result = await agent.update(canisterId, { methodName: "transfer", arg, effectiveCanisterId: canisterId });
+ * ```
+ */
+export class SignerAgent {
+    static #isInternalConstructing = false;
+    #options;
+    #certificates = new Map();
+    #pending = Promise.resolve();
+    constructor(options) {
+        const throwError = !SignerAgent.#isInternalConstructing;
+        SignerAgent.#isInternalConstructing = false;
+        if (throwError) {
+            throw new SignerAgentError('SignerAgent is not constructable');
+        }
+        this.#options = options;
+    }
+    /** The root key used for certificate verification. */
+    get rootKey() {
+        return this.#options.agent.rootKey ?? ROOT_KEY;
+    }
+    /** The signer this agent routes calls through. */
+    get signer() {
+        return this.#options.signer;
+    }
+    /**
+     * Creates a new SignerAgent, asynchronously initializing the
+     * underlying HttpAgent if one is not provided.
+     * @param options - The signer agent options.
+     */
+    static async create(options) {
+        SignerAgent.#isInternalConstructing = true;
+        return new SignerAgent({
+            ...options,
+            agent: options.agent ?? (await HttpAgent.create()),
+        });
+    }
+    /**
+     * Creates a new SignerAgent synchronously.
+     * Use this when you already have an HttpAgent or don't need async initialization.
+     * @param options - The signer agent options.
+     */
+    static createSync(options) {
+        SignerAgent.#isInternalConstructing = true;
+        return new SignerAgent({
+            ...options,
+            agent: options.agent ?? HttpAgent.createSync(),
+        });
+    }
+    /**
+     * Sends a canister call through the signer, validates the content map
+     * and certificate, and returns the verified result.
+     *
+     * Calls are queued to ensure sequential execution — the signer's
+     * transport channel is opened first to avoid blocking popups.
+     * @param canisterId - The target canister principal.
+     * @param fields - The call options including method name and arguments.
+     */
+    async #sendAndVerify(canisterId, fields) {
+        await this.#options.signer.openChannel();
+        // Queue calls to ensure sequential execution through the signer
+        const response = await new Promise((resolve, reject) => {
+            this.#pending = this.#pending.finally(() => this.signer
+                .callCanister({
+                canisterId,
+                sender: this.#options.account,
+                method: fields.methodName,
+                arg: fields.arg,
+                nonce: fields.nonce,
+            })
+                .then(resolve, reject));
+        });
+        // Decode CBOR content map and reconstruct the Expiry
+        // (Expiry has a private constructor, so we use the JSON round-trip)
+        const decoded = Cbor.decode(response.contentMap);
+        const requestBody = {
+            ...decoded,
+            canister_id: Principal.from(decoded.canister_id),
+            ingress_expiry: Expiry.fromJSON(JSON.stringify({ [JSON_KEY_EXPIRY]: String(decoded.ingress_expiry) })),
+        };
+        // Verify the content map matches what we requested
+        const contentMapMatchesRequest = SubmitRequestType.Call === requestBody.request_type &&
+            canisterId.toText() === requestBody.canister_id.toText() &&
+            fields.methodName === requestBody.method_name &&
+            uint8Equals(fields.arg, requestBody.arg) &&
+            this.#options.account.toText() === Principal.from(requestBody.sender).toText();
+        if (!contentMapMatchesRequest) {
+            throw new SignerAgentError(INVALID_RESPONSE_MESSAGE);
+        }
+        // Validate the certificate against the IC root key
+        const requestId = requestIdOf(requestBody);
+        const certificate = await Certificate.create({
+            certificate: response.certificate,
+            rootKey: this.rootKey,
+            principal: { canisterId },
+            maxAgeInMinutes: MAX_AGE_IN_MINUTES,
+        }).catch(cause => {
+            throw new SignerAgentError(INVALID_RESPONSE_MESSAGE, { cause });
+        });
+        // Extract the reply from the certified state tree
+        const replyLookup = certificate.lookup_path(['request_status', requestId, 'reply']);
+        if (replyLookup.status !== LookupPathStatus.Found) {
+            throw new SignerAgentError(INVALID_RESPONSE_MESSAGE);
+        }
+        // Store raw certificate for readState lookups, deleted on first read
+        this.#certificates.set(toHex(requestId), response.certificate);
+        return {
+            requestId,
+            requestBody,
+            certificate,
+            rawCertificate: response.certificate,
+            reply: replyLookup.value,
+        };
+    }
+    /**
+     * Sends a canister call through the signer.
+     * Returns the request ID and a synthetic HTTP response.
+     * @param canisterId - The target canister principal or its text representation.
+     * @param fields - The call options including method name and arguments.
+     */
+    async call(canisterId, fields) {
+        canisterId = Principal.from(canisterId);
+        const { requestId, requestBody } = await this.#sendAndVerify(canisterId, fields);
+        return {
+            requestId,
+            response: {
+                ok: true,
+                status: 202,
+                statusText: 'Call has been sent over ICRC-25 JSON-RPC',
+                body: null,
+                headers: [],
+            },
+            requestDetails: requestBody,
+        };
+    }
+    /**
+     * Executes a canister update call and returns the certified result.
+     * Combines {@link call} with certificate validation and reply extraction.
+     * @param canisterId - The target canister principal or its text representation.
+     * @param fields - The call options including method name and arguments.
+     * @param _pollingOptions - Ignored. The signer already returns the
+     *   certificate with the reply in a single round-trip.
+     */
+    async update(canisterId, fields, _pollingOptions) {
+        canisterId = Principal.from(canisterId);
+        const { requestBody, certificate, rawCertificate, reply } = await this.#sendAndVerify(canisterId, fields);
+        return {
+            certificate,
+            reply,
+            rawCertificate,
+            requestDetails: requestBody,
+            callResponse: {
+                ok: true,
+                status: 202,
+                statusText: 'Call has been sent over ICRC-25 JSON-RPC',
+                body: null,
+                headers: [],
+            },
+        };
+    }
+    /**
+     * Executes a query by upgrading it to a canister call through the signer.
+     * The signer signs and submits the call, and the reply is extracted
+     * from the certified response.
+     * @param canisterId - The target canister principal or its text representation.
+     * @param options - The query fields including method name and arguments.
+     * @param _identity - Ignored. The signer manages identity internally.
+     */
+    async query(canisterId, options, _identity) {
+        canisterId = Principal.from(canisterId);
+        const { requestId, reply } = await this.#sendAndVerify(canisterId, {
+            methodName: options.methodName,
+            arg: options.arg,
+            effectiveCanisterId: canisterId,
+        });
+        return {
+            requestId,
+            status: 'replied',
+            reply: { arg: reply },
+            httpDetails: {
+                ok: true,
+                status: 202,
+                statusText: 'Certificate with reply has been received over ICRC-25 JSON-RPC',
+                headers: [],
+            },
+        };
+    }
+    /** Fetches the IC root key via the underlying HttpAgent. */
+    async fetchRootKey() {
+        return await this.#options.agent.fetchRootKey();
+    }
+    /** Returns the account principal this agent makes calls on behalf of. */
+    getPrincipal() {
+        return Promise.resolve(this.#options.account);
+    }
+    /**
+     * @internal
+     * @param _options - The read state options.
+     * @param _identity - The identity to use for the request.
+     */
+    createReadStateRequest(_options, _identity) {
+        return Promise.resolve({ body: { content: {} } });
+    }
+    /**
+     * Returns the raw certificate for a previously completed call.
+     * The certificate is deleted after being read (single-use).
+     *
+     * Only supports `request_status` paths for request IDs that were
+     * returned by a prior {@link call}, {@link update}, or {@link query}.
+     * @param _canisterId - The target canister principal (unused).
+     * @param options - The read state options containing paths to look up.
+     * @param _identity - The identity to use (unused).
+     * @param _request - The request object (unused).
+     */
+    readState(_canisterId, options, _identity, _request) {
+        if (options.paths.length !== 1 ||
+            options.paths[0].length !== 2 ||
+            new TextDecoder().decode(options.paths[0][0]) !== 'request_status') {
+            return Promise.reject(new SignerAgentError('Given paths are not supported'));
+        }
+        const requestId = options.paths[0][1];
+        const key = toHex(requestId);
+        const certificate = this.#certificates.get(key);
+        if (!certificate) {
+            return Promise.reject(new SignerAgentError('Certificate could not be found'));
+        }
+        this.#certificates.delete(key);
+        return Promise.resolve({ certificate });
+    }
+    /** Queries the IC replica status via the underlying HttpAgent. */
+    async status() {
+        return await this.#options.agent.status();
+    }
+    /**
+     * Replaces the account principal used for subsequent calls.
+     * @param account - The new account principal to use for subsequent calls.
+     */
+    replaceAccount(account) {
+        this.#options.account = account;
+    }
+}
+//# sourceMappingURL=agent.js.map

package/lib/esm/agent/agent.js.map

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

package/lib/esm/agent/index.d.ts

@@ -0,0 +1 @@
+export { SignerAgent, SignerAgentError, type SignerAgentOptions } from './agent.js';

package/lib/esm/agent/index.js

@@ -0,0 +1,2 @@
+export { SignerAgent, SignerAgentError } from './agent.js';
+//# sourceMappingURL=index.js.map

package/lib/esm/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAA2B,MAAM,YAAY,CAAC"}

package/lib/esm/extension/browserExtensionChannel.d.ts

@@ -0,0 +1,37 @@
+import { type Channel, type JsonRpcRequest, type JsonRpcResponse } from '../transport.js';
+import type { ProviderDetail } from './types.js';
+/** Options for creating a {@link BrowserExtensionChannel}. */
+export interface BrowserExtensionChannelOptions {
+    /** The provider details obtained during extension discovery. */
+    providerDetail: ProviderDetail;
+    /**
+     * The window to listen for extension events on.
+     * @default globalThis.window
+     */
+    window?: Window;
+}
+/**
+ * A {@link Channel} implementation that communicates with a browser
+ * extension signer via the ICRC-94 provider API.
+ *
+ * Messages are sent through `providerDetail.sendMessage` and responses
+ * are validated as JSON-RPC before being dispatched to listeners.
+ * The channel is automatically closed if the extension fires an
+ * `icrc94:unexpectedlyClosed` event.
+ */
+export declare class BrowserExtensionChannel implements Channel {
+    #private;
+    constructor(options: BrowserExtensionChannelOptions);
+    /** Whether this channel has been closed. */
+    get closed(): boolean;
+    addEventListener(...[event, listener]: [event: 'close', listener: () => void] | [event: 'response', listener: (response: JsonRpcResponse) => void]): () => void;
+    /**
+     * Sends a JSON-RPC request to the extension via `providerDetail.sendMessage`.
+     * The response is validated as JSON-RPC before being dispatched.
+     * Non-JSON-RPC responses are silently ignored.
+     * @param request - The JSON-RPC request to send to the extension.
+     */
+    send(request: JsonRpcRequest): Promise<void>;
+    /** Dismisses the extension and notifies all close listeners. */
+    close(): Promise<void>;
+}

package/lib/esm/extension/browserExtensionChannel.js

@@ -0,0 +1,80 @@
+import { isJsonRpcResponse, } from '../transport.js';
+import { BrowserExtensionTransportError } from './browserExtensionTransport.js';
+/**
+ * A {@link Channel} implementation that communicates with a browser
+ * extension signer via the ICRC-94 provider API.
+ *
+ * Messages are sent through `providerDetail.sendMessage` and responses
+ * are validated as JSON-RPC before being dispatched to listeners.
+ * The channel is automatically closed if the extension fires an
+ * `icrc94:unexpectedlyClosed` event.
+ */
+export class BrowserExtensionChannel {
+    #closeListeners = new Set();
+    #responseListeners = new Set();
+    #options;
+    #closed = false;
+    constructor(options) {
+        this.#options = {
+            window: globalThis.window,
+            ...options,
+        };
+        // Listen for unexpected extension closure
+        const closeListener = () => {
+            this.#options.window.removeEventListener('icrc94:unexpectedlyClosed', closeListener);
+            this.#closed = true;
+            for (const listener of this.#closeListeners) {
+                listener();
+            }
+        };
+        this.#options.window.addEventListener('icrc94:unexpectedlyClosed', closeListener);
+    }
+    /** Whether this channel has been closed. */
+    get closed() {
+        return this.#closed;
+    }
+    addEventListener(...[event, listener]) {
+        switch (event) {
+            case 'close':
+                this.#closeListeners.add(listener);
+                return () => {
+                    this.#closeListeners.delete(listener);
+                };
+            case 'response':
+                this.#responseListeners.add(listener);
+                return () => {
+                    this.#responseListeners.delete(listener);
+                };
+        }
+    }
+    /**
+     * Sends a JSON-RPC request to the extension via `providerDetail.sendMessage`.
+     * The response is validated as JSON-RPC before being dispatched.
+     * Non-JSON-RPC responses are silently ignored.
+     * @param request - The JSON-RPC request to send to the extension.
+     */
+    async send(request) {
+        if (this.#closed) {
+            throw new BrowserExtensionTransportError('Communication channel is closed');
+        }
+        const response = await this.#options.providerDetail.sendMessage(request);
+        if (!isJsonRpcResponse(response)) {
+            return;
+        }
+        for (const listener of this.#responseListeners) {
+            listener(response);
+        }
+    }
+    /** Dismisses the extension and notifies all close listeners. */
+    async close() {
+        if (this.#closed) {
+            return;
+        }
+        this.#closed = true;
+        await this.#options.providerDetail.dismiss();
+        for (const listener of this.#closeListeners) {
+            listener();
+        }
+    }
+}
+//# sourceMappingURL=browserExtensionChannel.js.map

package/lib/esm/extension/browserExtensionChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserExtensionChannel.js","sourceRoot":"","sources":["../../../src/extension/browserExtensionChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,GAGlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAchF;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAuB;IACzB,eAAe,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,kBAAkB,GAAG,IAAI,GAAG,EAAuC,CAAC;IACpE,QAAQ,CAA2C;IAC5D,OAAO,GAAG,KAAK,CAAC;IAEhB,YAAY,OAAuC;QACjD,IAAI,CAAC,QAAQ,GAAG;YACd,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,GAAG,OAAO;SACX,CAAC;QAEF,0CAA0C;QAC1C,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,2BAA2B,EAAE,aAAa,CAAC,CAAC;YACrF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC5C,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,2BAA2B,EAAE,aAAa,CAAC,CAAC;IACpF,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,gBAAgB,CACd,GAAG,CAAC,KAAK,EAAE,QAAQ,CAEmD;QAEtE,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACnC,OAAO,GAAG,EAAE;oBACV,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACxC,CAAC,CAAC;YACJ,KAAK,UAAU;gBACb,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACtC,OAAO,GAAG,EAAE;oBACV,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC3C,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,OAAuB;QAChC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,8BAA8B,CAAC,iCAAiC,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC/C,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;CACF"}

package/lib/esm/extension/browserExtensionTransport.d.ts

@@ -0,0 +1,67 @@
+import type { Transport } from '../transport.js';
+import { BrowserExtensionChannel, type BrowserExtensionChannelOptions } from './browserExtensionChannel.js';
+import type { ProviderDetail } from './types.js';
+/** Error thrown by {@link BrowserExtensionTransport} for transport-level failures. */
+export declare class BrowserExtensionTransportError extends Error {
+}
+/** Options for creating a {@link BrowserExtensionTransport}. */
+export type BrowserExtensionTransportOptions = BrowserExtensionChannelOptions;
+/** Options for {@link BrowserExtensionTransport.discover}. */
+export interface DiscoverBrowserExtensionOptions {
+    /**
+     * Time in milliseconds to wait for browser extensions to announce themselves
+     * via `icrc94:announceProvider` events.
+     * @default 100
+     */
+    discoveryDuration?: number;
+    /**
+     * The window to listen for extension events on.
+     * @default globalThis.window
+     */
+    window?: Window;
+}
+/** Options for {@link BrowserExtensionTransport.findTransport}. */
+export interface EstablishBrowserExtensionTransportOptions extends DiscoverBrowserExtensionOptions, Omit<BrowserExtensionTransportOptions, 'providerDetail'> {
+    /** The UUID of the browser extension to connect to. */
+    uuid: string;
+}
+/**
+ * ICRC-94 transport for communicating with browser extension signers.
+ *
+ * Browser extensions announce themselves via `icrc94:announceProvider`
+ * window events. Use {@link BrowserExtensionTransport.discover} to find installed extensions, or
+ * {@link BrowserExtensionTransport.findTransport} to connect to a specific one by UUID.
+ * @see https://github.com/dfinity/wg-identity-authentication/blob/main/topics/icrc_94_multi_injected_provider_discovery.md
+ * @example
+ * ```ts
+ * // Discover all installed extensions
+ * const providers = await BrowserExtensionTransport.discover();
+ *
+ * // Or connect to a specific extension by UUID
+ * const transport = await BrowserExtensionTransport.findTransport({ uuid: "..." });
+ * const signer = new Signer({ transport });
+ * ```
+ */
+export declare class BrowserExtensionTransport implements Transport {
+    #private;
+    constructor(options: BrowserExtensionTransportOptions);
+    /**
+     * Discovers all installed browser extension signers by dispatching
+     * an `icrc94:requestProvider` event and collecting `icrc94:announceProvider`
+     * responses. Waits for `discoveryDuration` ms before returning.
+     * @param root0 - The discovery options.
+     * @param root0.discoveryDuration - Time in milliseconds to wait for announcements.
+     * @param root0.window - The window to listen for extension events on.
+     * @returns The discovered extension providers, deduplicated by UUID.
+     */
+    static discover({ discoveryDuration, window, }?: DiscoverBrowserExtensionOptions): Promise<ProviderDetail[]>;
+    /**
+     * Discovers extensions and connects to the one matching the given UUID.
+     * @param options - The options including UUID and discovery settings.
+     * @throws {BrowserExtensionTransportError} If no extension with the given
+     *   UUID is found.
+     */
+    static findTransport(options: EstablishBrowserExtensionTransportOptions): Promise<BrowserExtensionTransport>;
+    /** Creates a new {@link BrowserExtensionChannel} for this extension. */
+    establishChannel(): Promise<BrowserExtensionChannel>;
+}

package/lib/esm/extension/browserExtensionTransport.js

@@ -0,0 +1,70 @@
+import { BrowserExtensionChannel, } from './browserExtensionChannel.js';
+/** Error thrown by {@link BrowserExtensionTransport} for transport-level failures. */
+export class BrowserExtensionTransportError extends Error {
+}
+/**
+ * ICRC-94 transport for communicating with browser extension signers.
+ *
+ * Browser extensions announce themselves via `icrc94:announceProvider`
+ * window events. Use {@link BrowserExtensionTransport.discover} to find installed extensions, or
+ * {@link BrowserExtensionTransport.findTransport} to connect to a specific one by UUID.
+ * @see https://github.com/dfinity/wg-identity-authentication/blob/main/topics/icrc_94_multi_injected_provider_discovery.md
+ * @example
+ * ```ts
+ * // Discover all installed extensions
+ * const providers = await BrowserExtensionTransport.discover();
+ *
+ * // Or connect to a specific extension by UUID
+ * const transport = await BrowserExtensionTransport.findTransport({ uuid: "..." });
+ * const signer = new Signer({ transport });
+ * ```
+ */
+export class BrowserExtensionTransport {
+    #options;
+    constructor(options) {
+        this.#options = {
+            window: globalThis.window,
+            ...options,
+        };
+    }
+    /**
+     * Discovers all installed browser extension signers by dispatching
+     * an `icrc94:requestProvider` event and collecting `icrc94:announceProvider`
+     * responses. Waits for `discoveryDuration` ms before returning.
+     * @param root0 - The discovery options.
+     * @param root0.discoveryDuration - Time in milliseconds to wait for announcements.
+     * @param root0.window - The window to listen for extension events on.
+     * @returns The discovered extension providers, deduplicated by UUID.
+     */
+    static async discover({ discoveryDuration = 100, window = globalThis.window, } = {}) {
+        const providerDetails = [];
+        window.addEventListener('icrc94:announceProvider', ((event) => {
+            if (providerDetails.find(providerDetail => providerDetail.uuid === event.detail.uuid)) {
+                return;
+            }
+            providerDetails.push(event.detail);
+        }));
+        window.dispatchEvent(new CustomEvent('icrc94:requestProvider'));
+        await new Promise(resolve => setTimeout(resolve, discoveryDuration));
+        return providerDetails;
+    }
+    /**
+     * Discovers extensions and connects to the one matching the given UUID.
+     * @param options - The options including UUID and discovery settings.
+     * @throws {BrowserExtensionTransportError} If no extension with the given
+     *   UUID is found.
+     */
+    static async findTransport(options) {
+        const providerDetails = await BrowserExtensionTransport.discover(options);
+        const providerDetail = providerDetails.find(({ uuid }) => uuid === options.uuid);
+        if (!providerDetail) {
+            throw new BrowserExtensionTransportError("Browser extension couldn't be found, make sure it's installed and enabled for this page.");
+        }
+        return new BrowserExtensionTransport({ ...options, providerDetail });
+    }
+    /** Creates a new {@link BrowserExtensionChannel} for this extension. */
+    establishChannel() {
+        return Promise.resolve(new BrowserExtensionChannel(this.#options));
+    }
+}
+//# sourceMappingURL=browserExtensionTransport.js.map

package/lib/esm/extension/browserExtensionTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserExtensionTransport.js","sourceRoot":"","sources":["../../../src/extension/browserExtensionTransport.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,GAExB,MAAM,8BAA8B,CAAC;AAGtC,sFAAsF;AACtF,MAAM,OAAO,8BAA+B,SAAQ,KAAK;CAAG;AA6B5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,yBAAyB;IAC3B,QAAQ,CAA6C;IAE9D,YAAY,OAAyC;QACnD,IAAI,CAAC,QAAQ,GAAG;YACd,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EACpB,iBAAiB,GAAG,GAAG,EACvB,MAAM,GAAG,UAAU,CAAC,MAAM,MACS,EAAE;QACrC,MAAM,eAAe,GAAqB,EAAE,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,EAAE,CAAC,CAAC,KAAkC,EAAE,EAAE;YACzF,IAAI,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtF,OAAO;YACT,CAAC;YACD,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC,CAAkB,CAAC,CAAC;QACrB,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAChE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACrE,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CACxB,OAAkD;QAElD,MAAM,eAAe,GAAG,MAAM,yBAAyB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC1E,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,8BAA8B,CACtC,0FAA0F,CAC3F,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,yBAAyB,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,wEAAwE;IACxE,gBAAgB;QACd,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,CAAC;CACF"}

package/lib/esm/extension/index.d.ts

@@ -0,0 +1,3 @@
+export { BrowserExtensionChannel, type BrowserExtensionChannelOptions, } from './browserExtensionChannel.js';
+export { BrowserExtensionTransport, BrowserExtensionTransportError, type BrowserExtensionTransportOptions, type DiscoverBrowserExtensionOptions, type EstablishBrowserExtensionTransportOptions, } from './browserExtensionTransport.js';
+export type { ProviderDetail } from './types.js';

package/lib/esm/extension/index.js

@@ -0,0 +1,3 @@
+export { BrowserExtensionChannel, } from './browserExtensionChannel.js';
+export { BrowserExtensionTransport, BrowserExtensionTransportError, } from './browserExtensionTransport.js';
+//# sourceMappingURL=index.js.map

package/lib/esm/extension/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extension/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAExB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAI/B,MAAM,gCAAgC,CAAC"}

package/lib/esm/extension/types.d.ts

@@ -0,0 +1,32 @@
+import type { JsonRpcRequest } from '../transport.js';
+/**
+ * Details about a browser extension signer, as announced via the
+ * ICRC-94 `icrc94:announceProvider` event.
+ * @see https://github.com/dfinity/wg-identity-authentication/blob/main/topics/icrc_94_multi_injected_provider_discovery.md
+ */
+export interface ProviderDetail {
+    /** Globally unique identifier (UUIDv4) for this extension. */
+    uuid: string;
+    /** Human-readable name of the signer. */
+    name: string;
+    /** Icon as a data URI (e.g. `data:image/svg+xml,...`). */
+    icon: `data:image/${string}`;
+    /** Reverse domain name identifier (e.g. `com.example.wallet`). */
+    rdns: string;
+    /** Sends a JSON-RPC request to the extension and returns the response. */
+    sendMessage: (message: JsonRpcRequest) => Promise<unknown>;
+    /** Dismisses the extension's UI. */
+    dismiss: () => Promise<void>;
+}
+/** Fired by extensions to announce their presence. */
+export interface AnnounceProviderEvent extends CustomEvent<ProviderDetail> {
+    type: 'icrc94:announceProvider';
+}
+/** Dispatched by relying parties to trigger extension announcements. */
+export interface RequestProviderEvent extends Event {
+    type: 'icrc94:requestProvider';
+}
+/** Fired by extensions when they close unexpectedly. */
+export interface UnexpectedlyClosedEvent extends Event {
+    type: 'icrc94:unexpectedlyClosed';
+}

package/lib/esm/extension/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/esm/extension/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extension/types.ts"],"names":[],"mappings":""}

package/lib/esm/index.d.ts

@@ -0,0 +1,2 @@
+export { type PermissionScope, type PermissionState, Signer, SignerError, type SignerOptions, type SupportedStandard, } from './signer.js';
+export type { Channel, Transport } from './transport.js';

package/lib/esm/index.js

@@ -0,0 +1,2 @@
+export { Signer, SignerError, } from './signer.js';
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EACN,WAAW,GAGZ,MAAM,aAAa,CAAC"}