@tezos-x/octez.connect-dapp 4.8.3 → 4.8.5

package/README.md

@@ -1,16 +1,64 @@
 # `@tezos-x/octez.connect-dapp`
 
-This package is part of the `@tezos-x/octez.connect-sdk` project. [Read more](https://github.com/trilitech/octez.connect)
+octez.connect dApp client for connecting Tezos dApps to wallets.
 
-## Introduction
+This is a primary package in the Trilitech-maintained octez.connect SDK line and may be installed directly.
 
-Use this package on your dApp to instanciate a `DAppClient` object and communicate to wallets.
-
-## Usage
+## Install
 
+```sh
+npm install @tezos-x/octez.connect-dapp
 ```
-import { DAppClient } from '@tezos-x/octez.connect-dapp'
+## Package provenance
+
+This package is published from the Trilitech-maintained octez.connect repository:
+[trilitech/octez.connect](https://github.com/trilitech/octez.connect)
+
+- Original Beacon lineage: [airgap-it/beacon-sdk](https://github.com/airgap-it/beacon-sdk)
+- External maintenance line Trilitech may selectively import from: [ecadlabs/beacon-sdk-taquito-patches](https://github.com/ecadlabs/beacon-sdk-taquito-patches)
+
+## Notes
+
+- Trilitech publishes these packages under the `@tezos-x/octez.connect-*` scope
+- Release notes, package policy, and the current package list live in the repository README
+
+## Restoring persisted dApp sessions
 
-const dAppClient = new DAppClient({ name: "octez.connect Docs" });
+Applications should restore Beacon connection state from the SDK, for example by
+calling `client.getActiveAccount()`, instead of relying only on app-local markers
+such as `wallet-provider=beacon`.
+
+Treat a missing `beacon:active-account` storage entry as disconnected. Do not use
+checks like `localStorage.getItem('beacon:active-account') !== 'undefined'` as a
+valid restore guard, because `null` and corrupt stored state are not valid active
+accounts.
+
+When Beacon deactivates invalid stored active-account state, it emits
+`BeaconEvent.INVALID_ACCOUNT_DEACTIVATED` with this payload:
+
+```ts
+{
+  reason:
+    | 'missing_active_account'
+    | 'invalid_active_account_storage'
+    | 'storage_validation_failed'
+}
 ```
 
+For backward compatibility, event handler types still allow this event data to
+be `undefined`. Beacon's invalid active-account deactivation path emits the
+object above; consumers that inspect the reason should handle an absent payload
+defensively if they also support direct event emission or older Beacon versions.
+
+Reason meanings:
+
+- `missing_active_account`: `beacon:active-account` pointed at an account
+  identifier that was not present in Beacon's persisted account list.
+- `invalid_active_account_storage`: Beacon could not read or parse the persisted
+  active-account/account storage needed to restore the account.
+- `storage_validation_failed`: Beacon restored an active account, but a later
+  storage validation pass still found invalid persisted session state.
+
+The default UI intentionally keeps a generic "session expired" message for end
+users, while the event payload and debug logs expose the specific restore failure
+reason for applications and diagnostics.

package/dist/cjs/beacon-message-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"beacon-message-events.js","sourceRoot":"","sources":["../../src/beacon-message-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"beacon-message-events.js","sourceRoot":"","sources":["../../src/beacon-message-events.ts"],"names":[],"mappings":"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","sourcesContent":["import { BeaconEvent } from './events'\nimport { BeaconMessageType } from '@tezos-x/octez.connect-types'\n\nexport const messageEvents: {\n  [key in BeaconMessageType]: { sent: BeaconEvent; success: BeaconEvent; error: BeaconEvent }\n} = {\n  [BeaconMessageType.BlockchainRequest]: {\n    sent: BeaconEvent.OPERATION_REQUEST_SENT,\n    success: BeaconEvent.BLOCKCHAIN_REQUEST_SUCCESS,\n    error: BeaconEvent.OPERATION_REQUEST_ERROR\n  },\n  [BeaconMessageType.BlockchainResponse]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.PermissionRequest]: {\n    sent: BeaconEvent.PERMISSION_REQUEST_SENT,\n    success: BeaconEvent.PERMISSION_REQUEST_SUCCESS,\n    error: BeaconEvent.PERMISSION_REQUEST_ERROR\n  },\n  [BeaconMessageType.PermissionResponse]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.ProofOfEventChallengeRequest]: {\n    sent: BeaconEvent.PROOF_OF_EVENT_CHALLENGE_REQUEST_SENT,\n    success: BeaconEvent.PROOF_OF_EVENT_CHALLENGE_REQUEST_SUCCESS,\n    error: BeaconEvent.PROOF_OF_EVENT_CHALLENGE_REQUEST_ERROR\n  },\n  [BeaconMessageType.ProofOfEventChallengeResponse]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.SimulatedProofOfEventChallengeRequest]: {\n    sent: BeaconEvent.SIMULATED_PROOF_OF_EVENT_CHALLENGE_REQUEST_SENT,\n    success: BeaconEvent.SIMULATED_PROOF_OF_EVENT_CHALLENGE_REQUEST_SUCCESS,\n    error: BeaconEvent.SIMULATED_PROOF_OF_EVENT_CHALLENGE_REQUEST_ERROR\n  },\n  [BeaconMessageType.SimulatedProofOfEventChallengeResponse]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.OperationRequest]: {\n    sent: BeaconEvent.OPERATION_REQUEST_SENT,\n    success: BeaconEvent.OPERATION_REQUEST_SUCCESS,\n    error: BeaconEvent.OPERATION_REQUEST_ERROR\n  },\n  [BeaconMessageType.OperationResponse]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.SignPayloadRequest]: {\n    sent: BeaconEvent.SIGN_REQUEST_SENT,\n    success: BeaconEvent.SIGN_REQUEST_SUCCESS,\n    error: BeaconEvent.SIGN_REQUEST_ERROR\n  },\n  [BeaconMessageType.SignPayloadResponse]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  // TODO: ENCRYPTION\n  // [BeaconMessageType.EncryptPayloadRequest]: {\n  //   sent: BeaconEvent.ENCRYPT_REQUEST_SENT,\n  //   success: BeaconEvent.ENCRYPT_REQUEST_SUCCESS,\n  //   error: BeaconEvent.ENCRYPT_REQUEST_ERROR\n  // },\n  // [BeaconMessageType.EncryptPayloadResponse]: {\n  //   sent: BeaconEvent.UNKNOWN,\n  //   success: BeaconEvent.UNKNOWN,\n  //   error: BeaconEvent.UNKNOWN\n  // },\n  [BeaconMessageType.BroadcastRequest]: {\n    sent: BeaconEvent.BROADCAST_REQUEST_SENT,\n    success: BeaconEvent.BROADCAST_REQUEST_SUCCESS,\n    error: BeaconEvent.BROADCAST_REQUEST_ERROR\n  },\n  [BeaconMessageType.BroadcastResponse]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.ChangeAccountRequest]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.Acknowledge]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.Disconnect]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  },\n  [BeaconMessageType.Error]: {\n    sent: BeaconEvent.UNKNOWN,\n    success: BeaconEvent.UNKNOWN,\n    error: BeaconEvent.UNKNOWN\n  }\n}\n"]}

package/dist/cjs/dapp-client/DAppClient.d.ts

@@ -1,12 +1,25 @@
-import { BeaconEvent, BeaconEventHandlerFunction, BeaconEventType } from '../events';
 import { AccountInfo, TransportType, BeaconMessageType, RequestPermissionInput, RequestSignPayloadInput, RequestOperationInput, RequestBroadcastInput, PermissionResponseOutput, SignPayloadResponseOutput, OperationResponseOutput, BroadcastResponseOutput, Network, AppMetadata, ExtendedPeerInfo, ColorMode, Blockchain, BlockchainRequestV3, BlockchainResponseV3, PermissionRequestV3, PermissionResponseV3, ProofOfEventChallengeResponse, RequestProofOfEventChallengeInput, PeerInfoType, SimulatedProofOfEventChallengeResponse, RequestSimulatedProofOfEventChallengeInput } from '@tezos-x/octez.connect-types';
 import { Client, Transport } from '@tezos-x/octez.connect-core';
+import { BeaconEvent, BeaconEventHandlerFunction, BeaconEventType, BeaconEventHandler } from '../events';
 import { BlockExplorer } from '../utils/block-explorer';
 import { DAppClientOptions } from './DAppClientOptions';
-import { BeaconEventHandler } from '@tezos-x/octez.connect-dapp';
 import { DappPostMessageTransport } from '../transports/DappPostMessageTransport';
 import { DappP2PTransport } from '../transports/DappP2PTransport';
 import { DappWalletConnectTransport } from '../transports/DappWalletConnectTransport';
+export interface DAppClientDisconnectOptions {
+    /**
+     * Send Beacon disconnect messages to stored wallet peers before tearing down the transport.
+     *
+     * Defaults to true because DAppClient.disconnect is the user-facing wallet logout path.
+     */
+    notifyPeers?: boolean;
+}
+export interface DAppClientRemoveAllPeersOptions {
+    /**
+     * Continue removing local peer/account state even if notifying one peer fails.
+     */
+    ignoreDisconnectErrors?: boolean;
+}
 /**
  * @publicapi
  *
@@ -40,12 +53,20 @@ export declare class DAppClient extends Client {
     protected walletConnectTransport: DappWalletConnectTransport | undefined;
     protected wcProjectId?: string;
     protected wcRelayUrl?: string;
+    /**
+     * When true, the WalletConnect transport is not built or listened to. See
+     * DAppClientOptions.disableWalletConnect.
+     */
+    protected disableWalletConnect: boolean;
     private isGetActiveAccountHandled;
     private readonly openRequestsOtherTabs;
     /**
      * A map of requests that are currently "open", meaning we have sent them to a wallet and are still awaiting a response.
      */
     private readonly openRequests;
+    private readonly acknowledgedRequests;
+    private readonly openRequestTimeouts;
+    private readonly requestTimeoutMs;
     /**
      * The currently active account. For all requests that are associated to a specific request (operation request, signing request),
      * the active account is used to determine the network and destination wallet
@@ -56,8 +77,22 @@ export declare class DAppClient extends Client {
      */
     private _activePeer;
     private _initPromise;
-    private isInitPending;
+    /**
+     * Rejector for the in-flight {@link _initPromise}. Populated while init is
+     * awaiting a peer pairing; cleared automatically when {@link _initPromise}
+     * settles. Abort paths (modal close, WC session-proposal rejection,
+     * transport-level connection failure) call this to unwedge any
+     * `await this.init()` caller, surfacing the error to handleRequestError
+     * instead of hanging.
+     */
+    private _initReject;
+    private _initSubstratePairing;
+    private _requestPermissionsPromise;
+    private _requestPermissionsKey;
+    private _sdkSecretSeedPromise;
+    private destroyed;
     private readonly activeAccountLoaded;
+    private readonly storageValidated;
     private readonly appMetadataManager;
     private readonly disclaimerText?;
     private readonly errorMessages;
@@ -65,15 +100,22 @@ export declare class DAppClient extends Client {
     private readonly storageValidator;
     private readonly beaconIDB;
     private debounceSetActiveAccount;
+    private hasEmittedInvalidAccountDeactivated;
+    private _disconnectPromise?;
+    private _disconnectNotifyPeers;
     private multiTabChannel;
     constructor(config: DAppClientOptions);
     private checkIfBCLeaderExists;
     private onElectedLeaderhandler;
     private onBCMessageHandler;
     private prepareRequest;
+    private buildDelegatedRequestError;
     private createStateSnapshot;
     private initUserID;
     initInternalTransports(): Promise<void>;
+    private getOrCreateSDKSecretSeed;
+    private loadOrCreateSDKSecretSeed;
+    private isValidSDKSecretSeed;
     private initEvents;
     private onRelayerError;
     private wcToastHandler;
@@ -86,11 +128,30 @@ export declare class DAppClient extends Client {
      * If you wish to disconnect your dApp, use `disconnect` instead.
      */
     destroy(): Promise<void>;
+    private destroyInternalTransports;
+    private abortPendingInit;
+    private createAbortedError;
+    /**
+     * @internal
+     */
+    isDestroyed(): boolean;
+    private assertNotDestroyed;
     init(transport?: Transport<any>, substratePairing?: boolean): Promise<TransportType>;
+    /**
+     * Attach a settle observer to {@link _initPromise} that drops
+     * {@link _initReject} once the promise settles (resolved or rejected).
+     * Errors on the observer chain are swallowed; only the original
+     * {@link _initPromise} surfaces them to its awaiters.
+     */
+    private clearInitRejectOnSettle;
     /**
      * Returns the active account
      */
     getActiveAccount(): Promise<AccountInfo | undefined>;
+    private retainStorageValidationPromise;
+    private deactivateInvalidAccountState;
+    private repairMissingActiveAccount;
+    private hasStoredActiveAccountPointer;
     private isInvalidState;
     private resetInvalidState;
     /**
@@ -99,6 +160,8 @@ export declare class DAppClient extends Client {
      * @param account The account that will be set as the active account
      */
     setActiveAccount(account?: AccountInfo): Promise<void>;
+    private isActiveAccountAlreadyCleared;
+    private recoverActiveAccountFromAccountsChange;
     /**
      * Clear the active account
      */
@@ -116,7 +179,6 @@ export declare class DAppClient extends Client {
     private tryToAppSwitch;
     private addQueryParam;
     private buildPayload;
-    private updateMetricsStorage;
     private sendMetrics;
     private checkMakeRequest;
     /**
@@ -138,7 +200,7 @@ export declare class DAppClient extends Client {
     /**
      * Remove all peers and all accounts that have been connected through those peers
      */
-    removeAllPeers(sendDisconnectToPeers?: boolean): Promise<void>;
+    removeAllPeers(sendDisconnectToPeers?: boolean, options?: DAppClientRemoveAllPeersOptions): Promise<void>;
     /**
      * Allows the user to subscribe to specific events that are fired in the SDK
      *
@@ -167,6 +229,9 @@ export declare class DAppClient extends Client {
      * @param input The message details we need to prepare the PermissionRequest message.
      */
     requestPermissions(input?: RequestPermissionInput): Promise<PermissionResponseOutput>;
+    private requestPermissionsInternal;
+    private getPermissionRequestScopes;
+    private getPermissionRequestKey;
     /**
      * Send a proof of event request to the wallet. The wallet will either accept or decline the challenge.
      * If it is accepted, the challenge will be stored, meaning that even if the user refresh the page, the DAppClient will keep checking if the challenge has been fulfilled.
@@ -231,6 +296,29 @@ export declare class DAppClient extends Client {
      */
     private removeAccountsForPeers;
     private removeAccountsForPeerIds;
+    /**
+     * Run the standard request-error side effects (abort/error metric,
+     * timer stop, {@link handleRequestError}) on a single awaited control
+     * flow so callers can re-throw the original {@link ErrorResponse} without
+     * leaking an UnhandledPromiseRejection.
+     *
+     * Why this exists: every request method historically used a fire-and-
+     * forget `res.catch(handler)` whose handler did `throw await
+     * this.handleRequestError(...)`. The catch returned a detached promise
+     * nobody awaited; `handleRequestError`'s thrown wrapped error became an
+     * unhandled rejection. The bug rarely surfaced before the dapp-init
+     * promise was made rejectable, because pre-pairing rejection paths used
+     * to hang instead of routing through these handlers. Once init started
+     * rejecting reliably, the unhandled rejection started firing on every
+     * WC session-proposal rejection. We swallow the wrapped throw here so
+     * callers can re-throw the original `ErrorResponse`, matching the
+     * post-pairing rejection contract at the openRequest path.
+     *
+     * @param request The request we sent
+     * @param requestError The error we received
+     * @param logId The {@link logger.time} label opened for this request
+     */
+    private runRequestErrorSideEffects;
     /**
      * This message handles errors that we receive from the wallet.
      *
@@ -269,7 +357,22 @@ export declare class DAppClient extends Client {
      */
     private makeRequestV3;
     private makeRequestBC;
-    disconnect(): Promise<void>;
+    /**
+     * Disconnects all resolved transports (postMessage, P2P, WalletConnect), removes their peers,
+     * and clears active account state. After calling, the DAppClient remains usable for a new
+     * requestPermissions().
+     */
+    disconnect(options?: DAppClientDisconnectOptions): Promise<void>;
+    private disconnectInternal;
+    private getInitializedTransports;
+    private getResolvedTransports;
+    private clearInternalTransportReferences;
+    private removeAllPeersFromTransports;
+    private getUniquePeerNotifications;
+    private getPeerNotificationKey;
+    private disconnectResolvedTransports;
+    private hasClientCleanup;
+    private isTransportConnected;
     /**
      * Adds a requests to the "openRequests" set so we know what messages have already been answered/handled.
      *
@@ -277,6 +380,11 @@ export declare class DAppClient extends Client {
      * @param promise A promise that resolves once the response for that specific message is received
      */
     private addOpenRequest;
+    private addOpenRequestTimeout;
+    private clearOpenRequest;
+    private clearOpenRequestTimeout;
+    private clearAllOpenRequestTimeouts;
+    private abortOpenRequests;
     private sendNotificationWithAccessToken;
     private onNewAccount;
 }