@console-wallet/dapp-sdk 0.0.23 → 1.0.0

package/dist/cjs/triggersNative/onConnectionStatusChanged.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onConnectionStatusChanged.js","sourceRoot":"","sources":["../../../src/triggersNative/onConnectionStatusChanged.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,oCAA4D;AAC5D,0CAAqC;AAErC,IAAI,YAAY,GAAgC,SAAS,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACI,MAAM,yBAAyB,GAAG,CAAC,QAA2C,EAAE,EAAE;IACvF,MAAM,oBAAoB,GAAG,KAAK,IAAI,EAAE;QACtC,IAAI;YACF,MAAM,WAAW,GAAG,MAAM,IAAA,iBAAM,GAAE,CAAC;YACnC,YAAY,GAAG,WAAW,CAAC;YAC3B,IAAI,QAAQ;gBAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;SACrC;QAAC,MAAM;YACN,YAAY,GAAG,cAAc,CAAC;SAC/B;IACH,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAE,EAAE;QAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,yBAAa,CAAC;QACrF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,GAAG,uBAAe,CAAC,gBAAgB,UAAU,CAAC;QAErF,IAAI,YAAY,IAAI,SAAS,EAAE;YAC7B,oBAAoB,EAAE,CAAC;SACxB;IACH,CAAC,CAAC;IAEF,IAAI,YAAY,KAAK,SAAS,EAAE;QAC9B,oBAAoB,EAAE,CAAC;KACxB;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC,CAAC;AAzBW,QAAA,yBAAyB,6BAyBpC"}

package/dist/cjs/triggersNative/onTxChanged.d.ts

@@ -0,0 +1,17 @@
+import { TxChangedEvent } from '../types';
+/**
+ * Subscribes to transaction status changes emitted by the wallet.
+ *
+ * Listens for `${PUBLIC_REQUESTS.GET_TRANSFER_DETAILS}_TRIGGER` messages containing
+ * `TxChangedEvent` payloads and invokes `onChange` with the event data.
+ *
+ * Emits: `${PUBLIC_REQUESTS.GET_TRANSFER_DETAILS}_TRIGGER`
+ * Payload: `TxChangedEvent` with event_id, status and metadata.
+ *
+ * @param onChange Callback invoked with `TxChangedEvent`.
+ * @example
+ * onTxStatusChanged((txEvent) => {
+ *   console.log('Transaction changed:', txEvent);
+ * });
+ */
+export declare const onTxStatusChanged: (onChange?: ((value: TxChangedEvent) => void) | undefined) => void;

package/dist/cjs/triggersNative/onTxChanged.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onTxStatusChanged = void 0;
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+/**
+ * Subscribes to transaction status changes emitted by the wallet.
+ *
+ * Listens for `${PUBLIC_REQUESTS.GET_TRANSFER_DETAILS}_TRIGGER` messages containing
+ * `TxChangedEvent` payloads and invokes `onChange` with the event data.
+ *
+ * Emits: `${PUBLIC_REQUESTS.GET_TRANSFER_DETAILS}_TRIGGER`
+ * Payload: `TxChangedEvent` with event_id, status and metadata.
+ *
+ * @param onChange Callback invoked with `TxChangedEvent`.
+ * @example
+ * onTxStatusChanged((txEvent) => {
+ *   console.log('Transaction changed:', txEvent);
+ * });
+ */
+const onTxStatusChanged = (onChange) => {
+    const handleTrigger = (event) => {
+        const isFromWallet = event.source === window && event.data?.target === constants_1.WALLET_TARGET;
+        const isTrigger = event.data?.type === `${types_1.PUBLIC_REQUESTS.GET_TRANSFER_DETAILS}_TRIGGER`;
+        const data = event.data?.data;
+        if (isFromWallet && isTrigger && data && onChange) {
+            onChange(data);
+        }
+    };
+    window.addEventListener('message', handleTrigger);
+};
+exports.onTxStatusChanged = onTxStatusChanged;
+//# sourceMappingURL=onTxChanged.js.map

package/dist/cjs/triggersNative/onTxChanged.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onTxChanged.js","sourceRoot":"","sources":["../../../src/triggersNative/onTxChanged.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,oCAA2D;AAE3D;;;;;;;;;;;;;;GAcG;AACI,MAAM,iBAAiB,GAAG,CAAC,QAA0C,EAAE,EAAE;IAC9E,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAE,EAAE;QAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,yBAAa,CAAC;QACrF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,GAAG,uBAAe,CAAC,oBAAoB,UAAU,CAAC;QACzF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAkC,CAAC;QAE5D,IAAI,YAAY,IAAI,SAAS,IAAI,IAAI,IAAI,QAAQ,EAAE;YACjD,QAAQ,CAAC,IAAI,CAAC,CAAC;SAChB;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC,CAAC;AAZW,QAAA,iBAAiB,qBAY5B"}

package/dist/cjs/types/account.type.d.ts

@@ -1,25 +1,75 @@
 import { CANTON_NETWORK_VARIANTS } from './token.types';
 /**
- * Template-literal type representing a party identifier with namespace.
+ *
+ * Set as primary wallet for dApp usage.
+ *
+ */
+export type Primary = boolean;
+/**
+ * Template-literal type representing a party identifier ([a-zA-Z0-9:_-]*::[a-z0-9]) with namespace matching the pattern .
  * Example: "partHint::generatedPart".
  */
-export type Party = `${string}::${string}`;
+export type PartyId = `${string}::${string}`;
 /**
- * Wallet account information tied to a specific Canton network.
  *
- * Fields:
- * - `public_key`: Public key string associated with the account.
- * - `party`: Party identifier.
- * - `name`: Human-readable account name.
- * - `network`: Canton network variant this account belongs to.
+ * The status of the wallet.
+ *
+ */
+export type WalletStatus = 'initialized' | 'allocated';
+/**
+ *
+ * The party hint and name of the wallet.
+ *
+ */
+export type Hint = string;
+/**
+ *
+ * The public key of the party.
+ *
+ */
+export type PublicKey = string;
+/**
+ *
+ * The namespace of the party.
+ *
+ */
+export type Namespace = string;
+/**
+ *
+ * The signing provider ID the wallet corresponds to.
+ *
+ */
+export type SigningProviderId = string;
+/**
+ *
+ * Unique identifier of the signed transaction given by the Signing Provider. This may not be the same as the internal txId given by the Wallet Gateway.
+ *
+ */
+export type ExternalTxId = string;
+/**
+ *
+ * The topology transactions
+ *
+ */
+export type TopologyTransactions = string;
+/**
+ *
+ * Structure representing a wallet
+ *
  */
-export type Account = {
-    public_key: string;
-    party: string;
-    name: string;
-    network: CANTON_NETWORK_VARIANTS;
+export type Wallet = {
+    primary: Primary;
+    status: WalletStatus;
+    partyId: PartyId;
+    hint: Hint;
+    publicKey: PublicKey;
+    namespace: Namespace;
+    networkId: CANTON_NETWORK_VARIANTS;
+    signingProviderId: SigningProviderId;
+    externalTxId?: ExternalTxId;
+    topologyTransactions?: TopologyTransactions;
 };
 /** Array of accounts or undefined when no accounts are available. */
-export type GetAccountsResponse = Account[] | undefined;
+export type GetAccountsResponse = Wallet[] | undefined;
 /** Single account or undefined when no active account is set. */
-export type GetAccountResponse = Account | undefined;
+export type GetAccountResponse = Wallet | undefined;

package/dist/cjs/types/communication.types.d.ts

@@ -15,6 +15,7 @@ export declare enum INTERNAL_REQUESTS {
  * Each request has a corresponding `${REQUEST}_RESPONSE` message.
  */
 export declare enum PUBLIC_REQUESTS {
+    GET_IS_CONNECTED_NETWORK = "GET_IS_CONNECTED_NETWORK",
     CONNECT = "CONNECT",
     DISCONNECT = "DISCONNECT",
     GET_IS_CONNECTED = "GET_IS_CONNECTED",
@@ -30,6 +31,8 @@ export declare enum PUBLIC_REQUESTS {
 }
 /** Template-literal form for deriving a `${REQUEST}_RESPONSE` message type. */
 export type POSSIBLE_RESPONSE_TYPE = `${PUBLIC_REQUESTS}_RESPONSE`;
+/** Template-literal form for deriving a `${REQUEST}_TRIGGER` message type. */
+export type POSSIBLE_TRIGGER_TYPE = `${PUBLIC_REQUESTS}_TRIGGER`;
 /**
  * Common fields included in every request message posted to the wallet.
  *
@@ -43,3 +46,7 @@ export type CommonDataFieldsRequest = {
     target: string;
     id: string;
 };
+export type CommonDataFieldsTrigger = CommonDataFieldsRequest & {
+    /** Optional origin the trigger is intended for; used by the wallet. */
+    forOrigin?: string;
+};

package/dist/cjs/types/communication.types.js

@@ -20,6 +20,7 @@ var INTERNAL_REQUESTS;
  */
 var PUBLIC_REQUESTS;
 (function (PUBLIC_REQUESTS) {
+    PUBLIC_REQUESTS["GET_IS_CONNECTED_NETWORK"] = "GET_IS_CONNECTED_NETWORK";
     PUBLIC_REQUESTS["CONNECT"] = "CONNECT";
     PUBLIC_REQUESTS["DISCONNECT"] = "DISCONNECT";
     PUBLIC_REQUESTS["GET_IS_CONNECTED"] = "GET_IS_CONNECTED";

package/dist/cjs/types/communication.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"communication.types.js","sourceRoot":"","sources":["../../../src/types/communication.types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,4DAAuC,CAAA;IACvC,0DAAqC,CAAA;IACrC,8DAAyC,CAAA;IACzC,oDAA+B,CAAA;IAC/B,oDAA+B,CAAA;IAC/B,wDAAmC,CAAA;AACrC,CAAC,EAPW,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QAO5B;AAED;;;GAGG;AACH,IAAY,eAkBX;AAlBD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,4CAAyB,CAAA;IACzB,wDAAqC,CAAA;IACrC,4DAAyC,CAAA;IAEzC,gDAA6B,CAAA;IAC7B,0CAAuB,CAAA;IAEvB,gDAA6B,CAAA;IAC7B,4DAAyC,CAAA;IAEzC,8CAA2B,CAAA;IAE3B,kEAA+C,CAAA;IAC/C,gEAA6C,CAAA;IAE7C,4DAAyC,CAAA;AAC3C,CAAC,EAlBW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAkB1B"}
+{"version":3,"file":"communication.types.js","sourceRoot":"","sources":["../../../src/types/communication.types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,4DAAuC,CAAA;IACvC,0DAAqC,CAAA;IACrC,8DAAyC,CAAA;IACzC,oDAA+B,CAAA;IAC/B,oDAA+B,CAAA;IAC/B,wDAAmC,CAAA;AACrC,CAAC,EAPW,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QAO5B;AAED;;;GAGG;AACH,IAAY,eAmBX;AAnBD,WAAY,eAAe;IACzB,wEAAqD,CAAA;IACrD,sCAAmB,CAAA;IACnB,4CAAyB,CAAA;IACzB,wDAAqC,CAAA;IACrC,4DAAyC,CAAA;IAEzC,gDAA6B,CAAA;IAC7B,0CAAuB,CAAA;IAEvB,gDAA6B,CAAA;IAC7B,4DAAyC,CAAA;IAEzC,8CAA2B,CAAA;IAE3B,kEAA+C,CAAA;IAC/C,gEAA6C,CAAA;IAE7C,4DAAyC,CAAA;AAC3C,CAAC,EAnBW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAmB1B"}

package/dist/cjs/types/connect.type.d.ts

@@ -6,10 +6,14 @@ export type ConnectRequest = {
     icon?: string;
     name?: string;
 };
-/** Boolean response indicating whether the user approved the connection. */
-export type ConnectResponse = boolean;
-/** Boolean response */
-export type DisconnectResponse = boolean;
+/** Connection status reported by the wallet for the dApp origin. */
+export type ConnectStatus = 'connected' | 'disconnected';
+/** Boolean alias indicating whether the network available */
+export type NetworkStatus = boolean;
+/** Response for connect/status queries; mirrors `ConnectStatus`. */
+export type ConnectResponse = ConnectStatus;
+/** Response for disconnect */
+export type DisconnectResponse = ConnectStatus;
 /**
  * Internal-only fields included by the wallet during connection flow.
  * Not provided by the dApp.

package/dist/cjs/types/index.d.ts

@@ -5,3 +5,4 @@ export * from './signed.type';
 export * from './token.types';
 export * from './helpers.types';
 export * from './history.types';
+export * from './txTriggers.type';

package/dist/cjs/types/index.js

@@ -8,4 +8,5 @@ tslib_1.__exportStar(require("./signed.type"), exports);
 tslib_1.__exportStar(require("./token.types"), exports);
 tslib_1.__exportStar(require("./helpers.types"), exports);
 tslib_1.__exportStar(require("./history.types"), exports);
+tslib_1.__exportStar(require("./txTriggers.type"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,yDAA+B;AAC/B,yDAA+B;AAC/B,wDAA8B;AAC9B,wDAA8B;AAC9B,0DAAgC;AAChC,0DAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,yDAA+B;AAC/B,yDAA+B;AAC/B,wDAA8B;AAC9B,wDAA8B;AAC9B,0DAAgC;AAChC,0DAAgC;AAChC,4DAAkC"}

package/dist/cjs/types/signed.type.d.ts

@@ -5,10 +5,7 @@ export declare const MAX_WAITING = 10000;
 /** Minimum wait time in ms when waiting for finalization. */
 export declare const MIN_WAITING = 2000;
 /** Result payload from signing an arbitrary message. */
-export type SignedMessageResponse = {
-    message: string;
-    signature: string;
-};
+export type SignedMessageResponse = string | undefined;
 /** Message body encoded as hexadecimal string. */
 export type HexMessage = {
     hex: string;
@@ -22,6 +19,9 @@ export type Base64Message = {
  */
 export type SignMessageRequest = {
     message: HexMessage | Base64Message;
+    metaData?: {
+        [key: string]: string;
+    };
 };
 /**
  * Request to sign and send a token transfer.
@@ -31,6 +31,7 @@ export type SignSendRequest = {
     to: string;
     amount: string;
     expireDate: string;
+    /** Optional wait time in ms for finalization; between MIN_WAITING and MAX_WAITING. */
     waitForFinalization?: number;
 };
 /**
@@ -41,5 +42,6 @@ export type SendConfirmationDataType = ElementType<PagedByIDResponseOffer['data'
 export type SignSendResponse = {
     status: true | false;
     signature?: string;
+    /** Present when `waitForFinalization` is set and indexer returns data. */
     confirmationData?: SendConfirmationDataType;
-};
+} | undefined;

package/dist/cjs/types/token.types.d.ts

@@ -9,13 +9,17 @@ export declare enum CANTON_NETWORK_VARIANTS {
 /**
  * Network metadata for display and routing to indexer/backends.
  */
-export interface NetworkType {
-    baseUrl: string;
+export interface Network {
     id: CANTON_NETWORK_VARIANTS;
     name: string;
-    shortName: string;
-    icon: string;
-    explorer: string;
+    description: string;
+    shortName?: string;
+    icon?: string;
+    synchronizerId?: string;
+    identityProviderId: string;
+    baseUrl: string;
+    explorerUrl?: string;
+    /** Token ID used as the network's native currency reference. */
     nativeTokenId: string;
 }
 /**
@@ -30,7 +34,7 @@ export type TokenData = {
     name: string;
     price: string;
     balanceUsd?: string;
-    network: NetworkType;
+    network: Network;
     imageSrc: string;
 };
 /** Party/network pair used to request balances from the wallet/indexer. */

package/dist/cjs/types/txTriggers.type.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Transaction lifecycle status values used in wallet trigger events.
+ */
+export declare enum TxEventStatus {
+    PENDING = "pending",
+    SIGNED = "signed",
+    EXECUTED = "executed",
+    FAILED = "failed"
+}
+/** Payload included when a transaction is signed. */
+export interface TxChangedSignedPayload {
+    signature: string;
+    signedBy: string;
+    party: string;
+}
+/** Payload included when a transaction reaches execution/finalization. */
+export interface TxChangedExecutedPayload {
+    updateId: string;
+    completionOffset: number;
+}
+/** Trigger event emitted when a transaction is queued/pending. */
+export interface TxChangedPendingEvent {
+    status: TxEventStatus.PENDING;
+    commandId: string;
+}
+/** Trigger event emitted when the wallet signs a transaction. */
+export interface TxChangedSignedEvent {
+    status: TxEventStatus.SIGNED;
+    commandId: string;
+    payload: TxChangedSignedPayload;
+}
+/** Trigger event emitted when a transaction is executed. */
+export interface TxChangedExecutedEvent {
+    status: TxEventStatus.EXECUTED;
+    commandId: string;
+    payload: TxChangedExecutedPayload;
+}
+/** Trigger event emitted when a transaction fails. */
+export interface TxChangedFailedEvent {
+    status: TxEventStatus.FAILED;
+    commandId: string;
+}
+/** Union of all transaction status change events. */
+export type TxChangedEvent = TxChangedPendingEvent | TxChangedSignedEvent | TxChangedExecutedEvent | TxChangedFailedEvent;

package/dist/cjs/types/txTriggers.type.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TxEventStatus = void 0;
+/**
+ * Transaction lifecycle status values used in wallet trigger events.
+ */
+var TxEventStatus;
+(function (TxEventStatus) {
+    TxEventStatus["PENDING"] = "pending";
+    TxEventStatus["SIGNED"] = "signed";
+    TxEventStatus["EXECUTED"] = "executed";
+    TxEventStatus["FAILED"] = "failed";
+})(TxEventStatus = exports.TxEventStatus || (exports.TxEventStatus = {}));
+//# sourceMappingURL=txTriggers.type.js.map

package/dist/cjs/types/txTriggers.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"txTriggers.type.js","sourceRoot":"","sources":["../../../src/types/txTriggers.type.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;AACnB,CAAC,EALW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAKxB"}

package/dist/esm/helpers/handleResponce.helper.d.ts

@@ -1,3 +1,3 @@
 import type { POSSIBLE_RESPONSE_TYPE } from '../types';
-export declare const isPossibleResponseType: (str: string) => str is "CONNECT_RESPONSE" | "DISCONNECT_RESPONSE" | "GET_IS_CONNECTED_RESPONSE" | "GET_ACTIVE_NETWORK_RESPONSE" | "SIGN_MESSAGE_RESPONSE" | "SIGN_SEND_RESPONSE" | "GET_ACCOUNTS_RESPONSE" | "GET_ACTIVE_ACCOUNT_RESPONSE" | "GET_BALANCE_RESPONSE" | "GET_TRANSFERS_HISTORY_RESPONSE" | "GET_TRANSFER_DETAILS_RESPONSE" | "GET_OFFERS_HISTORY_RESPONSE";
+export declare const isPossibleResponseType: (str: string) => str is "GET_IS_CONNECTED_NETWORK_RESPONSE" | "CONNECT_RESPONSE" | "DISCONNECT_RESPONSE" | "GET_IS_CONNECTED_RESPONSE" | "GET_ACTIVE_NETWORK_RESPONSE" | "SIGN_MESSAGE_RESPONSE" | "SIGN_SEND_RESPONSE" | "GET_ACCOUNTS_RESPONSE" | "GET_ACTIVE_ACCOUNT_RESPONSE" | "GET_BALANCE_RESPONSE" | "GET_TRANSFERS_HISTORY_RESPONSE" | "GET_TRANSFER_DETAILS_RESPONSE" | "GET_OFFERS_HISTORY_RESPONSE";
 export declare const isExpectedResponse: (event: MessageEvent, id: string, type?: POSSIBLE_RESPONSE_TYPE) => boolean;

package/dist/esm/helpers/handleResponce.helper.js

@@ -8,14 +8,14 @@ export const isExpectedResponse = (event, id, type) => {
     if (type) {
         return (event.source === window &&
             event.data?.target === WALLET_TARGET &&
-            event.data.type === type &&
-            event.data.id == id);
+            event.data?.type === type &&
+            event.data?.id == id);
     }
     else {
         return (event.source === window &&
             event.data?.target === WALLET_TARGET &&
             isPossibleResponseType(event.data?.type || '') &&
-            event.data.id == id);
+            event.data?.id == id);
     }
 };
 //# sourceMappingURL=handleResponce.helper.js.map

package/dist/esm/helpers/handleResponce.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleResponce.helper.js","sourceRoot":"","sources":["../../../src/helpers/handleResponce.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAiC,EAAE;IACnF,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAmB,EACnB,EAAU,EACV,IAA6B,EACpB,EAAE;IACX,IAAI,IAAI,EAAE;QACR,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,MAAM;YACvB,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa;YACpC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CACpB,CAAC;KACH;SAAM;QACL,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,MAAM;YACvB,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa;YACpC,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CACpB,CAAC;KACH;AACH,CAAC,CAAC"}
+{"version":3,"file":"handleResponce.helper.js","sourceRoot":"","sources":["../../../src/helpers/handleResponce.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAiC,EAAE;IACnF,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAmB,EACnB,EAAU,EACV,IAA6B,EACpB,EAAE;IACX,IAAI,IAAI,EAAE;QACR,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,MAAM;YACvB,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa;YACpC,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI;YACzB,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CACrB,CAAC;KACH;SAAM;QACL,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,MAAM;YACvB,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa;YACpC,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CACrB,CAAC;KACH;AACH,CAAC,CAAC"}

package/dist/esm/index.d.ts

@@ -2,14 +2,18 @@ export * from './types';
 export * from './constants';
 export * from './types';
 export declare const consoleWalletPixelplex: {
+    onAccountsChanged: (onChange?: ((value: import("./types").GetAccountResponse) => void) | undefined) => void;
+    onConnectionStatusChanged: (onChange?: ((value: import("./types").ConnectStatus) => void) | undefined) => void;
+    onTxStatusChanged: (onChange?: ((value: import("./types").TxChangedEvent) => void) | undefined) => void;
     getAccounts: () => Promise<import("./types").GetAccountsResponse>;
-    getActiveAccount: () => Promise<import("./types").GetAccountResponse>;
+    getPrimaryAccount: () => Promise<import("./types").GetAccountResponse>;
     signMessage: (message: import("./types").SignMessageRequest) => Promise<import("./types").SignedMessageResponse>;
-    signSend: (data: import("./types").SignSendRequest) => Promise<import("./types").SignSendResponse>;
-    connect: ({ icon, name }: import("./types").ConnectRequest) => Promise<boolean>;
-    disconnect: () => Promise<boolean>;
-    getIsConnected: () => Promise<boolean>;
-    getActiveNetwork: () => Promise<import("./types").CANTON_NETWORK_VARIANTS>;
+    submitCommands: (data: import("./types").SignSendRequest) => Promise<import("./types").SignSendResponse>;
+    connect: ({ icon, name }: import("./types").ConnectRequest) => Promise<import("./types").ConnectStatus>;
+    disconnect: () => Promise<import("./types").ConnectStatus>;
+    isConnected: () => Promise<boolean>;
+    status: () => Promise<import("./types").ConnectStatus>;
+    getActiveNetwork: () => Promise<import("./types").Network>;
     getBalance: (data: import("./types").GetBalanceRequest) => Promise<import("./types").GetBalanceResponse>;
     getOffers: (data: import("./types").OffersRequest) => Promise<import("./types").OffersResponse>;
     getTransfer: (data: import("./types").TransferRequest) => Promise<import("./types").TransferResponse>;

package/dist/esm/index.js

@@ -1,10 +1,12 @@
 import * as requests from './requests';
+import * as triggersNative from './triggersNative';
 import * as utilsInternal from './utils';
 export * from './types';
 export * from './constants';
 export * from './types';
 export const consoleWalletPixelplex = {
     ...requests,
+    ...triggersNative,
 };
 export const utils = { ...utilsInternal };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,aAAa,MAAM,SAAS,CAAC;AAEzC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,GAAG,QAAQ;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,aAAa,MAAM,SAAS,CAAC;AAEzC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,GAAG,QAAQ;IACX,GAAG,cAAc;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC"}

package/dist/esm/requests/connect.d.ts

@@ -1,15 +1,14 @@
 import type { ConnectRequest, ConnectResponse } from '../types';
 /**
- * Sends a connect request to the wallet extension with optional dApp metadata.
+ * Initiates a connection request to the wallet with optional dApp metadata.
  *
- * @param {string} [name] Human-readable dApp name shown in the wallet.
- * @param {string} [icon] Absolute URL to an icon displayed in the wallet.
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
+ * Emits `${PUBLIC_REQUESTS.CONNECT}_RESPONSE` when the user approves or rejects.
+ * If the dApp origin is not yet connected, the wallet will prompt the user.
+ *
+ * @param {string} [name] Human‑readable dApp name shown in the wallet UI.
+ * @param {string} [icon] Absolute URL to an icon displayed during connect.
+ * @returns {Promise<ConnectResponse>} "connected" or "disconnected" based on user action.
  * @example
- * // Connect with dApp metadata
- * await connect({
- *   name: 'Canton Demo',
- *   icon: 'https://example.com/icon.png',
- * });
+ * await connect({ name: 'Canton Demo', icon: 'https://example.com/icon.png' });
  */
 export declare const connect: ({ icon, name }: ConnectRequest) => Promise<ConnectResponse>;

package/dist/esm/requests/connect.js

@@ -2,17 +2,16 @@ import { WALLET_TARGET } from '../constants';
 import { isExpectedResponse } from '../helpers/handleResponce.helper';
 import { PUBLIC_REQUESTS } from '../types';
 /**
- * Sends a connect request to the wallet extension with optional dApp metadata.
+ * Initiates a connection request to the wallet with optional dApp metadata.
  *
- * @param {string} [name] Human-readable dApp name shown in the wallet.
- * @param {string} [icon] Absolute URL to an icon displayed in the wallet.
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
+ * Emits `${PUBLIC_REQUESTS.CONNECT}_RESPONSE` when the user approves or rejects.
+ * If the dApp origin is not yet connected, the wallet will prompt the user.
+ *
+ * @param {string} [name] Human‑readable dApp name shown in the wallet UI.
+ * @param {string} [icon] Absolute URL to an icon displayed during connect.
+ * @returns {Promise<ConnectResponse>} "connected" or "disconnected" based on user action.
  * @example
- * // Connect with dApp metadata
- * await connect({
- *   name: 'Canton Demo',
- *   icon: 'https://example.com/icon.png',
- * });
+ * await connect({ name: 'Canton Demo', icon: 'https://example.com/icon.png' });
  */
 export const connect = async ({ name, icon, }) => new Promise((resolve) => {
     const id = crypto.randomUUID();

package/dist/esm/requests/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/requests/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,OAAO,GAAiE,KAAK,EAAE,EAC1F,IAAI,EACJ,IAAI,GACL,EAAE,EAAE,CACH,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAE/B,MAAM,CAAC,WAAW,CAChB;QACE,IAAI,EAAE,eAAe,CAAC,OAAO;QAC7B,MAAM,EAAE,aAAa;QACrB,EAAE;QACF,IAAI;QACJ,IAAI;KACL,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,OAAO,WAAW,CAAC,EAAE;YACxE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1B;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/requests/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAiE,KAAK,EAAE,EAC1F,IAAI,EACJ,IAAI,GACL,EAAE,EAAE,CACH,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAE/B,MAAM,CAAC,WAAW,CAChB;QACE,IAAI,EAAE,eAAe,CAAC,OAAO;QAC7B,MAAM,EAAE,aAAa;QACrB,EAAE;QACF,IAAI;QACJ,IAAI;KACL,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,OAAO,WAAW,CAAC,EAAE;YACxE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1B;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}

package/dist/esm/requests/disconnect.d.ts

@@ -1,7 +1,12 @@
 import type { DisconnectResponse } from '../types';
 /**
- * Sends a disconnect request to the wallet extension.
+ * Terminates the current dApp–wallet connection.
  *
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
+ * Emits `${PUBLIC_REQUESTS.DISCONNECT}_RESPONSE` when the user confirms.
+ * After disconnect, most requests will trigger a reconnect prompt.
+ *
+ * @returns {Promise<DisconnectResponse>} "disconnected" when completed.
+ * @example
+ * await disconnect();
  */
 export declare const disconnect: () => Promise<DisconnectResponse>;

package/dist/esm/requests/disconnect.js

@@ -2,9 +2,14 @@ import { WALLET_TARGET } from '../constants';
 import { isExpectedResponse } from '../helpers/handleResponce.helper';
 import { PUBLIC_REQUESTS } from '../types';
 /**
- * Sends a disconnect request to the wallet extension.
+ * Terminates the current dApp–wallet connection.
  *
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
+ * Emits `${PUBLIC_REQUESTS.DISCONNECT}_RESPONSE` when the user confirms.
+ * After disconnect, most requests will trigger a reconnect prompt.
+ *
+ * @returns {Promise<DisconnectResponse>} "disconnected" when completed.
+ * @example
+ * await disconnect();
  */
 export const disconnect = async () => new Promise((resolve) => {
     const id = crypto.randomUUID();

package/dist/esm/requests/disconnect.js.map

@@ -1 +1 @@
-{"version":3,"file":"disconnect.js","sourceRoot":"","sources":["../../../src/requests/disconnect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsC,KAAK,IAAI,EAAE,CACtE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAE/B,MAAM,CAAC,WAAW,CAChB;QACE,IAAI,EAAE,eAAe,CAAC,UAAU;QAChC,MAAM,EAAE,aAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,UAAU,WAAW,CAAC,EAAE;YAC3E,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1B;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}
+{"version":3,"file":"disconnect.js","sourceRoot":"","sources":["../../../src/requests/disconnect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsC,KAAK,IAAI,EAAE,CACtE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAE/B,MAAM,CAAC,WAAW,CAChB;QACE,IAAI,EAAE,eAAe,CAAC,UAAU;QAChC,MAAM,EAAE,aAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,UAAU,WAAW,CAAC,EAAE;YAC3E,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1B;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}

package/dist/esm/requests/getAccounts.d.ts

@@ -1,7 +1,12 @@
 import { type GetAccountsResponse } from '../types';
 /**
- * Fetches all accounts available in the wallet for the user.
+ * Lists all accounts available to the connected dApp origin.
  *
- * @return {Promise<GetAccountsResponse>} Resolves to a list of accounts or undefined.
+ * Emits `${PUBLIC_REQUESTS.GET_ACCOUNTS}_RESPONSE` with an array of wallets.
+ * Requires a connected origin; otherwise the wallet may trigger a connect flow.
+ *
+ * @returns {Promise<GetAccountsResponse>} Accounts array or undefined.
+ * @example
+ * const accounts = await getAccounts();
  */
 export declare const getAccounts: () => Promise<GetAccountsResponse>;

package/dist/esm/requests/getAccounts.js

@@ -2,9 +2,14 @@ import { WALLET_TARGET } from '../constants';
 import { isExpectedResponse } from '../helpers/handleResponce.helper';
 import { PUBLIC_REQUESTS } from '../types';
 /**
- * Fetches all accounts available in the wallet for the user.
+ * Lists all accounts available to the connected dApp origin.
  *
- * @return {Promise<GetAccountsResponse>} Resolves to a list of accounts or undefined.
+ * Emits `${PUBLIC_REQUESTS.GET_ACCOUNTS}_RESPONSE` with an array of wallets.
+ * Requires a connected origin; otherwise the wallet may trigger a connect flow.
+ *
+ * @returns {Promise<GetAccountsResponse>} Accounts array or undefined.
+ * @example
+ * const accounts = await getAccounts();
  */
 export const getAccounts = async () => new Promise((resolve) => {
     const id = crypto.randomUUID();

package/dist/esm/requests/getAccounts.js.map

@@ -1 +1 @@
-{"version":3,"file":"getAccounts.js","sourceRoot":"","sources":["../../../src/requests/getAccounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAA4B,MAAM,UAAU,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuC,KAAK,IAAI,EAAE,CACxE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAE/B,MAAM,CAAC,WAAW,CAChB;QACE,IAAI,EAAE,eAAe,CAAC,YAAY;QAClC,MAAM,EAAE,aAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,YAAY,WAAW,CAAC,EAAE;YAC7E,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1B;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}
+{"version":3,"file":"getAccounts.js","sourceRoot":"","sources":["../../../src/requests/getAccounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAA4B,MAAM,UAAU,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuC,KAAK,IAAI,EAAE,CACxE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAE/B,MAAM,CAAC,WAAW,CAChB;QACE,IAAI,EAAE,eAAe,CAAC,YAAY;QAClC,MAAM,EAAE,aAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,YAAY,WAAW,CAAC,EAAE;YAC7E,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1B;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}

package/dist/esm/requests/getActiveAccount.d.ts

@@ -1,7 +1,12 @@
 import { type GetAccountResponse } from '../types';
 /**
- * Gets the currently active account selected in the wallet.
+ * Returns the active (primary) account selected in the wallet.
  *
- * @return {Promise<GetAccountResponse>} Resolves to the active account or undefined.
+ * Emits `${PUBLIC_REQUESTS.GET_ACTIVE_ACCOUNT}_RESPONSE` with account details.
+ * If the origin is not connected, the wallet may prevent access or prompt connect.
+ *
+ * @returns {Promise<GetAccountResponse>} Active account or undefined.
+ * @example
+ * const account = await getPrimaryAccount();
  */
-export declare const getActiveAccount: () => Promise<GetAccountResponse>;
+export declare const getPrimaryAccount: () => Promise<GetAccountResponse>;

package/dist/esm/requests/getActiveAccount.js

@@ -2,11 +2,16 @@ import { WALLET_TARGET } from '../constants';
 import { isExpectedResponse } from '../helpers/handleResponce.helper';
 import { PUBLIC_REQUESTS } from '../types';
 /**
- * Gets the currently active account selected in the wallet.
+ * Returns the active (primary) account selected in the wallet.
  *
- * @return {Promise<GetAccountResponse>} Resolves to the active account or undefined.
+ * Emits `${PUBLIC_REQUESTS.GET_ACTIVE_ACCOUNT}_RESPONSE` with account details.
+ * If the origin is not connected, the wallet may prevent access or prompt connect.
+ *
+ * @returns {Promise<GetAccountResponse>} Active account or undefined.
+ * @example
+ * const account = await getPrimaryAccount();
  */
-export const getActiveAccount = async () => new Promise((resolve) => {
+export const getPrimaryAccount = async () => new Promise((resolve) => {
     const id = crypto.randomUUID();
     window.postMessage({
         type: PUBLIC_REQUESTS.GET_ACTIVE_ACCOUNT,