@console-wallet/dapp-sdk 0.0.23 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. package/CHANGELOG.md +208 -0
  2. package/README.md +29 -16
  3. package/dist/cjs/helpers/handleResponce.helper.d.ts +1 -1
  4. package/dist/cjs/helpers/handleResponce.helper.js +3 -3
  5. package/dist/cjs/helpers/handleResponce.helper.js.map +1 -1
  6. package/dist/cjs/index.d.ts +10 -6
  7. package/dist/cjs/index.js +2 -0
  8. package/dist/cjs/index.js.map +1 -1
  9. package/dist/cjs/requests/connect.d.ts +8 -9
  10. package/dist/cjs/requests/connect.js +8 -9
  11. package/dist/cjs/requests/connect.js.map +1 -1
  12. package/dist/cjs/requests/disconnect.d.ts +7 -2
  13. package/dist/cjs/requests/disconnect.js +7 -2
  14. package/dist/cjs/requests/disconnect.js.map +1 -1
  15. package/dist/cjs/requests/getAccounts.d.ts +7 -2
  16. package/dist/cjs/requests/getAccounts.js +7 -2
  17. package/dist/cjs/requests/getAccounts.js.map +1 -1
  18. package/dist/cjs/requests/getActiveAccount.d.ts +8 -3
  19. package/dist/cjs/requests/getActiveAccount.js +10 -5
  20. package/dist/cjs/requests/getActiveAccount.js.map +1 -1
  21. package/dist/cjs/requests/getActiveNetwork.d.ts +9 -4
  22. package/dist/cjs/requests/getActiveNetwork.js +7 -2
  23. package/dist/cjs/requests/getActiveNetwork.js.map +1 -1
  24. package/dist/cjs/requests/getBalance.d.ts +7 -5
  25. package/dist/cjs/requests/getBalance.js +7 -5
  26. package/dist/cjs/requests/getBalance.js.map +1 -1
  27. package/dist/cjs/requests/getIsConnected.d.ts +9 -4
  28. package/dist/cjs/requests/getIsConnected.js +10 -5
  29. package/dist/cjs/requests/getIsConnected.js.map +1 -1
  30. package/dist/cjs/requests/getOffers.d.ts +7 -9
  31. package/dist/cjs/requests/getOffers.js +7 -9
  32. package/dist/cjs/requests/getOffers.js.map +1 -1
  33. package/dist/cjs/requests/getStatus.d.ts +12 -0
  34. package/dist/cjs/requests/getStatus.js +33 -0
  35. package/dist/cjs/requests/getStatus.js.map +1 -0
  36. package/dist/cjs/requests/getTransfer.d.ts +7 -9
  37. package/dist/cjs/requests/getTransfer.js +7 -9
  38. package/dist/cjs/requests/getTransfer.js.map +1 -1
  39. package/dist/cjs/requests/getTransfers.d.ts +7 -7
  40. package/dist/cjs/requests/getTransfers.js +7 -7
  41. package/dist/cjs/requests/index.d.ts +2 -1
  42. package/dist/cjs/requests/index.js +2 -1
  43. package/dist/cjs/requests/index.js.map +1 -1
  44. package/dist/cjs/requests/signMessage.d.ts +7 -6
  45. package/dist/cjs/requests/signMessage.js +7 -6
  46. package/dist/cjs/requests/signMessage.js.map +1 -1
  47. package/dist/cjs/requests/{signSend.d.ts → submitCommands.d.ts} +5 -2
  48. package/dist/cjs/requests/{signSend.js → submitCommands.js} +8 -5
  49. package/dist/cjs/requests/submitCommands.js.map +1 -0
  50. package/dist/cjs/triggersNative/index.d.ts +3 -0
  51. package/dist/cjs/triggersNative/index.js +7 -0
  52. package/dist/cjs/triggersNative/index.js.map +1 -0
  53. package/dist/cjs/triggersNative/onAccountsChanged.d.ts +18 -0
  54. package/dist/cjs/triggersNative/onAccountsChanged.js +59 -0
  55. package/dist/cjs/triggersNative/onAccountsChanged.js.map +1 -0
  56. package/dist/cjs/triggersNative/onConnectionStatusChanged.d.ts +17 -0
  57. package/dist/cjs/triggersNative/onConnectionStatusChanged.js +48 -0
  58. package/dist/cjs/triggersNative/onConnectionStatusChanged.js.map +1 -0
  59. package/dist/cjs/triggersNative/onTxChanged.d.ts +17 -0
  60. package/dist/cjs/triggersNative/onTxChanged.js +33 -0
  61. package/dist/cjs/triggersNative/onTxChanged.js.map +1 -0
  62. package/dist/cjs/types/account.type.d.ts +65 -15
  63. package/dist/cjs/types/communication.types.d.ts +7 -0
  64. package/dist/cjs/types/communication.types.js +1 -0
  65. package/dist/cjs/types/communication.types.js.map +1 -1
  66. package/dist/cjs/types/connect.type.d.ts +8 -4
  67. package/dist/cjs/types/index.d.ts +1 -0
  68. package/dist/cjs/types/index.js +1 -0
  69. package/dist/cjs/types/index.js.map +1 -1
  70. package/dist/cjs/types/signed.type.d.ts +7 -5
  71. package/dist/cjs/types/token.types.d.ts +10 -6
  72. package/dist/cjs/types/txTriggers.type.d.ts +44 -0
  73. package/dist/cjs/types/txTriggers.type.js +14 -0
  74. package/dist/cjs/types/txTriggers.type.js.map +1 -0
  75. package/dist/esm/helpers/handleResponce.helper.d.ts +1 -1
  76. package/dist/esm/helpers/handleResponce.helper.js +3 -3
  77. package/dist/esm/helpers/handleResponce.helper.js.map +1 -1
  78. package/dist/esm/index.d.ts +10 -6
  79. package/dist/esm/index.js +2 -0
  80. package/dist/esm/index.js.map +1 -1
  81. package/dist/esm/requests/connect.d.ts +8 -9
  82. package/dist/esm/requests/connect.js +8 -9
  83. package/dist/esm/requests/connect.js.map +1 -1
  84. package/dist/esm/requests/disconnect.d.ts +7 -2
  85. package/dist/esm/requests/disconnect.js +7 -2
  86. package/dist/esm/requests/disconnect.js.map +1 -1
  87. package/dist/esm/requests/getAccounts.d.ts +7 -2
  88. package/dist/esm/requests/getAccounts.js +7 -2
  89. package/dist/esm/requests/getAccounts.js.map +1 -1
  90. package/dist/esm/requests/getActiveAccount.d.ts +8 -3
  91. package/dist/esm/requests/getActiveAccount.js +8 -3
  92. package/dist/esm/requests/getActiveAccount.js.map +1 -1
  93. package/dist/esm/requests/getActiveNetwork.d.ts +9 -4
  94. package/dist/esm/requests/getActiveNetwork.js +7 -2
  95. package/dist/esm/requests/getActiveNetwork.js.map +1 -1
  96. package/dist/esm/requests/getBalance.d.ts +7 -5
  97. package/dist/esm/requests/getBalance.js +7 -5
  98. package/dist/esm/requests/getBalance.js.map +1 -1
  99. package/dist/esm/requests/getIsConnected.d.ts +9 -4
  100. package/dist/esm/requests/getIsConnected.js +8 -3
  101. package/dist/esm/requests/getIsConnected.js.map +1 -1
  102. package/dist/esm/requests/getOffers.d.ts +7 -9
  103. package/dist/esm/requests/getOffers.js +7 -9
  104. package/dist/esm/requests/getOffers.js.map +1 -1
  105. package/dist/esm/requests/getStatus.d.ts +12 -0
  106. package/dist/esm/requests/getStatus.js +29 -0
  107. package/dist/esm/requests/getStatus.js.map +1 -0
  108. package/dist/esm/requests/getTransfer.d.ts +7 -9
  109. package/dist/esm/requests/getTransfer.js +7 -9
  110. package/dist/esm/requests/getTransfer.js.map +1 -1
  111. package/dist/esm/requests/getTransfers.d.ts +7 -7
  112. package/dist/esm/requests/getTransfers.js +7 -7
  113. package/dist/esm/requests/index.d.ts +2 -1
  114. package/dist/esm/requests/index.js +2 -1
  115. package/dist/esm/requests/index.js.map +1 -1
  116. package/dist/esm/requests/signMessage.d.ts +7 -6
  117. package/dist/esm/requests/signMessage.js +7 -6
  118. package/dist/esm/requests/signMessage.js.map +1 -1
  119. package/dist/esm/requests/{signSend.d.ts → submitCommands.d.ts} +5 -2
  120. package/dist/esm/requests/{signSend.js → submitCommands.js} +6 -3
  121. package/dist/esm/requests/submitCommands.js.map +1 -0
  122. package/dist/esm/triggersNative/index.d.ts +3 -0
  123. package/dist/esm/triggersNative/index.js +4 -0
  124. package/dist/esm/triggersNative/index.js.map +1 -0
  125. package/dist/esm/triggersNative/onAccountsChanged.d.ts +18 -0
  126. package/dist/esm/triggersNative/onAccountsChanged.js +55 -0
  127. package/dist/esm/triggersNative/onAccountsChanged.js.map +1 -0
  128. package/dist/esm/triggersNative/onConnectionStatusChanged.d.ts +17 -0
  129. package/dist/esm/triggersNative/onConnectionStatusChanged.js +44 -0
  130. package/dist/esm/triggersNative/onConnectionStatusChanged.js.map +1 -0
  131. package/dist/esm/triggersNative/onTxChanged.d.ts +17 -0
  132. package/dist/esm/triggersNative/onTxChanged.js +29 -0
  133. package/dist/esm/triggersNative/onTxChanged.js.map +1 -0
  134. package/dist/esm/types/account.type.d.ts +65 -15
  135. package/dist/esm/types/communication.types.d.ts +7 -0
  136. package/dist/esm/types/communication.types.js +1 -0
  137. package/dist/esm/types/communication.types.js.map +1 -1
  138. package/dist/esm/types/connect.type.d.ts +8 -4
  139. package/dist/esm/types/index.d.ts +1 -0
  140. package/dist/esm/types/index.js +1 -0
  141. package/dist/esm/types/index.js.map +1 -1
  142. package/dist/esm/types/signed.type.d.ts +7 -5
  143. package/dist/esm/types/token.types.d.ts +10 -6
  144. package/dist/esm/types/txTriggers.type.d.ts +44 -0
  145. package/dist/esm/types/txTriggers.type.js +11 -0
  146. package/dist/esm/types/txTriggers.type.js.map +1 -0
  147. package/package.json +1 -1
  148. package/dist/cjs/requests/signSend.js.map +0 -1
  149. package/dist/esm/requests/signSend.js.map +0 -1
package/CHANGELOG.md ADDED
@@ -0,0 +1,208 @@
1
+ # Changelog
2
+
3
+ Human‑readable diff between `0.0.24` and `1.0.0` .
4
+
5
+ ## What Changed
6
+
7
+ ### New APIs
8
+
9
+ - `status()` — returns current connection status (`ConnectResponse`).
10
+ - Watch helpers:
11
+ - `onAccountsChanged(onChange)` — callback receives `GetAccountResponse`.
12
+ - `onConnectionStatusChanged(onChange)` — callback receives `ConnectResponse`.
13
+ - `onTxStatusChanged(onChange)` — callback receives `TxChangedEvent`.
14
+
15
+ ### API Renames and Alignments
16
+
17
+ - `signSend(...)` → `submitCommands(...)` (same payload/flow, updated name).
18
+ - `getActiveAccount()` → `getPrimaryAccount()` (clarifies the wallet-selected account).
19
+ - `getTransfers(...)` → `getTokenTransfers(...)` (name reflects token transfer history).
20
+
21
+ ### Request/Response Types
22
+
23
+ - Requests: `SignSendRequest`, `SignMessageRequest`, `TokenTransfersRequest`, `OffersRequest`, `TransferRequest`, `GetBalanceRequest`.
24
+ - Responses: `SignSendResponse`, `SignedMessageResponse`, `TokenTransfersResponse`, `OffersResponse`, `TransferResponse`, `GetBalanceResponse`.
25
+ - Connection: `ConnectRequest`, `ConnectResponse`, `DisconnectResponse`, `NetworkStatus`.
26
+ - Network metadata: `Network`, `CANTON_NETWORK_VARIANTS`.
27
+
28
+ ### Type Updates (Network, Wallet)
29
+
30
+ - `Network` (in `src/types/token.types.ts`): clarified fields and added documentation for `nativeTokenId`.
31
+ - Shape: `{ id: CANTON_NETWORK_VARIANTS; name; description; shortName?; icon?; synchronizerId?; identityProviderId; baseUrl; explorerUrl?; nativeTokenId }`
32
+ - Example:
33
+ ```ts
34
+ const network: Network = {
35
+ id: CANTON_NETWORK_VARIANTS.CANTON_NETWORK_DEV,
36
+ name: 'Canton Devnet',
37
+ description: 'Development network',
38
+ identityProviderId: 'auth-dev',
39
+ baseUrl: 'https://devnet.ccview.io',
40
+ explorerUrl: 'https://explorer.devnet.ccview.io',
41
+ nativeTokenId: 'CANTON_COIN',
42
+ };
43
+ ```
44
+
45
+ - `Wallet` (in `src/types/account.type.ts`): clarified fields and associated helper types.
46
+ - Key fields: `primary`, `status ('initialized' | 'allocated')`, `partyId` (template literal type `${string}::${string}`), `hint`, `publicKey`, `namespace`, `networkId: CANTON_NETWORK_VARIANTS`, `signingProviderId`, `externalTxId?`, `topologyTransactions?`.
47
+ - Responses:
48
+ - `GetAccountsResponse = Wallet[] | undefined`
49
+ - `GetAccountResponse = Wallet | undefined`
50
+ - Example:
51
+ ```ts
52
+ const wallet: Wallet = {
53
+ primary: true,
54
+ status: 'initialized',
55
+ partyId: 'partyHint::partyId',
56
+ hint: 'partyHint',
57
+ publicKey: '0xabcdef...',
58
+ namespace: 'namespace-1',
59
+ networkId: CANTON_NETWORK_VARIANTS.CANTON_NETWORK_DEV,
60
+ signingProviderId: 'provider-123',
61
+ };
62
+ ```
63
+
64
+ - `TokenData` / Balance types:
65
+ - `TokenData` includes `price` and optional `balanceUsd` for convenience.
66
+ - `GetBalanceResponse` returns `{ tokens: TokenData[]; isSplitedBalance: boolean; price: string }`.
67
+
68
+ These updates are documentation‑focused (no breaking changes), improving intellisense and clarity around type shapes.
69
+
70
+ ### Additional Type Updates
71
+
72
+ - Connection types (in `src/types/connect.type.ts`):
73
+ - `ConnectRequest`: `{ icon?: string; name?: string }`
74
+ - `ConnectStatus`: `'connected' | 'disconnected'`
75
+ - `NetworkStatus`: `boolean`
76
+ - `ConnectResponse`: `ConnectStatus`
77
+ - `DisconnectResponse`: `ConnectStatus`
78
+ - `ConnectRequestInternal`: `{ referer: `http://${string}` | `https://${string}` }` (wallet-internal)
79
+ - Example:
80
+ ```ts
81
+ const connectPayload: ConnectRequest = { name: 'My dApp', icon: 'https://...' };
82
+ const status: ConnectResponse = 'connected';
83
+ ```
84
+
85
+ - Signing types (in `src/types/signed.type.ts`):
86
+ - `SignMessageRequest`: `{ message: { hex } | { base64 }; metaData?: Record<string,string> }`
87
+ - `SignedMessageResponse`: `string | undefined`
88
+ - `SignSendRequest`: `{ from; to; amount; expireDate; waitForFinalization?: number }`
89
+ - `SignSendResponse`: `{ status: boolean; signature?: string; confirmationData?: SendConfirmationDataType } | undefined`
90
+ - Example:
91
+ ```ts
92
+ const msgReq: SignMessageRequest = { message: { hex: '0xabc123' } };
93
+ const txReq: SignSendRequest = {
94
+ from: 'party::A',
95
+ to: 'party::B',
96
+ amount: '10',
97
+ expireDate: '2025-01-01',
98
+ };
99
+ ```
100
+
101
+ - History/indexer types (in `src/types/history.types.ts`):
102
+ - `TokenTransfersQuery`: parameters of `api.indexer.tokenTransferByPartyIdV2`
103
+ - `TokenTransfersRequest`: `{ query: TokenTransfersQuery; network: CANTON_NETWORK_VARIANTS }`
104
+ - `TokenTransfersResponse`: `PagedByCombinedCursorResponseTokenTransferSummary | null`
105
+ - `OffersQuery`: parameters of `api.indexer.offerBySenderPartyV2`
106
+ - `OffersRequest`: `{ query: OffersQuery; network: CANTON_NETWORK_VARIANTS }`
107
+ - `OffersResponse`: `PagedByCombinedCursorResponseOffer | null`
108
+ - `TransferRequest`: `{ eventId: string; network: CANTON_NETWORK_VARIANTS }`
109
+ - `TransferResponse`: `Awaited<ReturnType<typeof api.indexer.tokenTransferByEventIdV2>> | null`
110
+
111
+ - Helper utility types (in `src/types/helpers.types.ts`):
112
+ - `DiscriminantKeys<T>`: keys of `T` when object
113
+ - `ChildOf<T, K>`: type of property `K` from `T`
114
+ - `ElementType<T>`: element type of array `T`
115
+
116
+ - Trigger types (in `src/types/txTriggers.type.ts`):
117
+ - `TxEventStatus`: `'pending' | 'signed' | 'executed' | 'failed'`
118
+ - Event payloads: `TxChangedSignedPayload`, `TxChangedExecutedPayload`
119
+ - Event unions: `TxChangedEvent = Pending | Signed | Executed | Failed`
120
+ - Example:
121
+ ```ts
122
+ const evSigned: TxChangedEvent = {
123
+ status: TxEventStatus.SIGNED,
124
+ commandId: 'cmd-123',
125
+ payload: { signature: '0x..', signedBy: 'party::A', party: 'party::A' },
126
+ };
127
+ ```
128
+
129
+ ### Documentation and Hints
130
+
131
+ - README updated:
132
+ - Supported Requests table aligned to new names and types.
133
+ - New Watch Requests table (subscribe methods with payload types).
134
+ - JSDoc standardized across requests and types for consistent intellisense.
135
+
136
+ ## Migration Guide (Before → After)
137
+
138
+ ### Signing and Sending
139
+
140
+ - Before: `signSend(data)`
141
+ - After: `submitCommands(data)`
142
+
143
+ Example:
144
+
145
+ ```ts
146
+ // before
147
+ const res = await consoleWalletPixelplex.signSend({ from, to, amount, expireDate });
148
+
149
+ // after
150
+ const res = await consoleWalletPixelplex.submitCommands({ from, to, amount, expireDate });
151
+ ```
152
+
153
+ ### Account Access
154
+
155
+ - Before: `getActiveAccount()`
156
+ - After: `getPrimaryAccount()`
157
+
158
+ ```ts
159
+ const account = await consoleWalletPixelplex.getPrimaryAccount();
160
+ ```
161
+
162
+ ### Transfers
163
+
164
+ - Before: `getTransfers({ ... })`
165
+ - After: `getTokenTransfers({ query, network })`
166
+
167
+ ```ts
168
+ const transfers = await consoleWalletPixelplex.getTokenTransfers({ query, network });
169
+ ```
170
+
171
+ ### Connection Status
172
+
173
+ - New: `status()` returns `ConnectResponse` (`'connected' | 'disconnected'`).
174
+ - `isConnected()` returns `NetworkStatus` (`boolean`).
175
+
176
+ ```ts
177
+ const s = await consoleWalletPixelplex.status(); // 'connected' | 'disconnected'
178
+ const ok = await consoleWalletPixelplex.isConnected(); // true | false
179
+ ```
180
+
181
+ ### Watchers
182
+
183
+ ```ts
184
+ onAccountsChanged((acc) => {
185
+ /* acc: GetAccountResponse */
186
+ });
187
+ onConnectionStatusChanged((st) => {
188
+ /* st: ConnectResponse */
189
+ });
190
+ onTxStatusChanged((ev) => {
191
+ /* ev: TxChangedEvent */
192
+ });
193
+ ```
194
+
195
+ ## File‑Level Diff (Curated)
196
+
197
+ - Added: `src/requests/getStatus.ts` (new `status()` request).
198
+ - Added: `src/triggersNative/index.ts`, `onAccountsChanged.ts`, `onConnectionStatusChanged.ts`, `onTxChanged.ts`.
199
+ - Added: `src/types/txTriggers.type.ts`.
200
+ - Renamed: `src/requests/signSend.ts` → `src/requests/submitCommands.ts`.
201
+ - Updated: request modules and types to reflect new names and stricter typing.
202
+ - Updated: `README.md` to include the Watch Requests section and revised Supported Requests.
203
+
204
+ ## Commits Unique to `DWE-306`
205
+
206
+ - 734e148 (2025‑11‑27) feat(DWE‑307): update hints
207
+ - e93f2f3 (2025‑11‑26) feat(DWE‑307): update types and request according to DA
208
+ - 8f25650 (2025‑11‑25) feat(DWE‑306): added DA watch request
package/README.md CHANGED
@@ -83,18 +83,31 @@ Each request is automatically tagged with a **unique request ID** to ensure reli
83
83
 
84
84
  | Method | Description | Request Payload | Response |
85
85
  | ------------------------ | --------------------------------------------------------------------------- | --------------------------------- | ------------------------- |
86
- | `getAccounts()` | Retrieves the account(s) basic data. | — | `GetAccountsResponse` |
87
- | `getActiveAccount()` | Returns the currently **selected** account in the Wallet. | — | `GetAccountResponse` |
88
- | `getActiveNetwork()` | Returns the currently **selected network**. | — | `CANTON_NETWORK_VARIANTS` |
89
- | `signMessage(message)` | Requests the user to sign a message in hex or base64 format. | `{ message: SignMessageRequest }` | `SignedMessageResponse` |
90
- | `signSend(data)` | Signs and broadcasts a transaction to send **Canton Coin**. | `SignSendRequest` | `SignSendResponse` |
91
- | `connect(data)` | Prompts the user to connect their Console Wallet to the DApp. | `ConnectRequest` | `boolean` |
92
- | `getIsConnected()` | Checks if the DApp is already connected to the wallet. | — | `boolean` |
93
- | `disconnect()` | Disconnects the DApp from the wallet. | — | `boolean` |
94
- | `getBalance()` | Check party balance on any network. Also provide current Canton Coin price. | `GetBalanceRequest` | `GetBalanceResponse` |
95
- | `getTokenTransfers()` | Check party token transfers with pagination. | `GetTokenTransfersRequest` | `GetTokenTransfersResponse` |
96
- | `getTokenTransfer()` | Check party token transfer details. | `GetTokenTransferRequest` | `GetTokenTransferResponse` |
97
- | `getOffers()` | Check party offers with pagination. | `GetOffersRequest` | `GetOffersResponse` |
86
+ | `getAccounts()` | Retrieves the account(s) basic data. | — | `GetAccountsResponse` |
87
+ | `getPrimaryAccount()` | Returns the currently selected account in the Wallet. | — | `GetAccountResponse` |
88
+ | `getActiveNetwork()` | Returns the currently selected network metadata. | — | `Network` |
89
+ | `signMessage(message)` | Requests the user to sign a message (hex/base64). | `SignMessageRequest` | `SignedMessageResponse` |
90
+ | `submitCommands(data)` | Signs and broadcasts a transaction to send Canton Coin. | `SignSendRequest` | `SignSendResponse` |
91
+ | `connect(data)` | Prompts the user to connect their Console Wallet to the DApp. | `ConnectRequest` | `ConnectResponse` |
92
+ | `status()` | Returns current connection status for the dApp origin. | — | `ConnectResponse` |
93
+ | `isConnected()` | Checks if the network available. | — | `NetworkStatus` |
94
+ | `disconnect()` | Disconnects the DApp from the wallet. | | `DisconnectResponse` |
95
+ | `getBalance()` | Check party balance; includes current Canton Coin price. | `GetBalanceRequest` | `GetBalanceResponse` |
96
+ | `getTokenTransfers()` | Check party token transfers with pagination. | `TokenTransfersRequest` | `TokenTransfersResponse` |
97
+ | `getTransfer()` | Check party token transfer details. | `TransferRequest` | `TransferResponse` |
98
+ | `getOffers()` | Check party offers with pagination. | `OffersRequest` | `OffersResponse` |
99
+
100
+ ---
101
+
102
+ ## 👀 Watch Requests
103
+
104
+ The SDK also provides subscription-style helpers to watch for changes from the Console Wallet. These functions register a callback and invoke it whenever the corresponding state changes.
105
+
106
+ | Method | Description | Callback Payload |
107
+ | ------------------------------ | --------------------------------------------------------- | ------------------------ |
108
+ | `onAccountsChanged(onChange)` | Subscribes to active account changes | `GetAccountResponse` |
109
+ | `onConnectionStatusChanged(onChange)` | Subscribes to wallet connection status changes | `ConnectResponse` |
110
+ | `onTxStatusChanged(onChange)` | Subscribes to transaction status lifecycle updates | `TxChangedEvent` |
98
111
 
99
112
  ---
100
113
 
@@ -128,9 +141,9 @@ const handleSignSend = async () => {
128
141
  ## 📦 Installation
129
142
 
130
143
  ```bash
131
- npm install console-wallet-dapp-templ
144
+ npm install @console-wallet/dapp-sdk
132
145
  # or
133
- yarn add console-wallet-dapp-templ
146
+ yarn add @console-wallet/dapp-sdk
134
147
 
135
148
  ```
136
149
 
@@ -154,8 +167,8 @@ const handleConnect = async () => {
154
167
 
155
168
  const handleCheckConnection = async () => {
156
169
  try {
157
- const isConnected = await consoleWalletPixelplex.getIsConnected();
158
- setConnectionStatus(isConnected ? 'Connected' : 'Not connected');
170
+ const connected = await consoleWalletPixelplex.status();
171
+ setConnectionStatus(connected);
159
172
  } catch (error) {
160
173
  console.error('Error checking connection:', error);
161
174
  }
@@ -1,3 +1,3 @@
1
1
  import type { POSSIBLE_RESPONSE_TYPE } from '../types';
2
- 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";
2
+ 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";
3
3
  export declare const isExpectedResponse: (event: MessageEvent, id: string, type?: POSSIBLE_RESPONSE_TYPE) => boolean;
@@ -12,14 +12,14 @@ const isExpectedResponse = (event, id, type) => {
12
12
  if (type) {
13
13
  return (event.source === window &&
14
14
  event.data?.target === constants_1.WALLET_TARGET &&
15
- event.data.type === type &&
16
- event.data.id == id);
15
+ event.data?.type === type &&
16
+ event.data?.id == id);
17
17
  }
18
18
  else {
19
19
  return (event.source === window &&
20
20
  event.data?.target === constants_1.WALLET_TARGET &&
21
21
  (0, exports.isPossibleResponseType)(event.data?.type || '') &&
22
- event.data.id == id);
22
+ event.data?.id == id);
23
23
  }
24
24
  };
25
25
  exports.isExpectedResponse = isExpectedResponse;
@@ -1 +1 @@
1
- {"version":3,"file":"handleResponce.helper.js","sourceRoot":"","sources":["../../../src/helpers/handleResponce.helper.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,oCAA2C;AAGpC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAiC,EAAE;IACnF,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,uBAAe,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC;AAC/D,CAAC,CAAC;AAHW,QAAA,sBAAsB,0BAGjC;AAEK,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,yBAAa;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,yBAAa;YACpC,IAAA,8BAAsB,EAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CACpB,CAAC;KACH;AACH,CAAC,CAAC;AApBW,QAAA,kBAAkB,sBAoB7B"}
1
+ {"version":3,"file":"handleResponce.helper.js","sourceRoot":"","sources":["../../../src/helpers/handleResponce.helper.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,oCAA2C;AAGpC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAiC,EAAE;IACnF,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,uBAAe,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC;AAC/D,CAAC,CAAC;AAHW,QAAA,sBAAsB,0BAGjC;AAEK,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,yBAAa;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,yBAAa;YACpC,IAAA,8BAAsB,EAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CACrB,CAAC;KACH;AACH,CAAC,CAAC;AApBW,QAAA,kBAAkB,sBAoB7B"}
@@ -2,14 +2,18 @@ export * from './types';
2
2
  export * from './constants';
3
3
  export * from './types';
4
4
  export declare const consoleWalletPixelplex: {
5
+ onAccountsChanged: (onChange?: ((value: import("./types").GetAccountResponse) => void) | undefined) => void;
6
+ onConnectionStatusChanged: (onChange?: ((value: import("./types").ConnectStatus) => void) | undefined) => void;
7
+ onTxStatusChanged: (onChange?: ((value: import("./types").TxChangedEvent) => void) | undefined) => void;
5
8
  getAccounts: () => Promise<import("./types").GetAccountsResponse>;
6
- getActiveAccount: () => Promise<import("./types").GetAccountResponse>;
9
+ getPrimaryAccount: () => Promise<import("./types").GetAccountResponse>;
7
10
  signMessage: (message: import("./types").SignMessageRequest) => Promise<import("./types").SignedMessageResponse>;
8
- signSend: (data: import("./types").SignSendRequest) => Promise<import("./types").SignSendResponse>;
9
- connect: ({ icon, name }: import("./types").ConnectRequest) => Promise<boolean>;
10
- disconnect: () => Promise<boolean>;
11
- getIsConnected: () => Promise<boolean>;
12
- getActiveNetwork: () => Promise<import("./types").CANTON_NETWORK_VARIANTS>;
11
+ submitCommands: (data: import("./types").SignSendRequest) => Promise<import("./types").SignSendResponse>;
12
+ connect: ({ icon, name }: import("./types").ConnectRequest) => Promise<import("./types").ConnectStatus>;
13
+ disconnect: () => Promise<import("./types").ConnectStatus>;
14
+ isConnected: () => Promise<boolean>;
15
+ status: () => Promise<import("./types").ConnectStatus>;
16
+ getActiveNetwork: () => Promise<import("./types").Network>;
13
17
  getBalance: (data: import("./types").GetBalanceRequest) => Promise<import("./types").GetBalanceResponse>;
14
18
  getOffers: (data: import("./types").OffersRequest) => Promise<import("./types").OffersResponse>;
15
19
  getTransfer: (data: import("./types").TransferRequest) => Promise<import("./types").TransferResponse>;
package/dist/cjs/index.js CHANGED
@@ -3,12 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.utils = exports.consoleWalletPixelplex = void 0;
4
4
  const tslib_1 = require("tslib");
5
5
  const requests = tslib_1.__importStar(require("./requests"));
6
+ const triggersNative = tslib_1.__importStar(require("./triggersNative"));
6
7
  const utilsInternal = tslib_1.__importStar(require("./utils"));
7
8
  tslib_1.__exportStar(require("./types"), exports);
8
9
  tslib_1.__exportStar(require("./constants"), exports);
9
10
  tslib_1.__exportStar(require("./types"), exports);
10
11
  exports.consoleWalletPixelplex = {
11
12
  ...requests,
13
+ ...triggersNative,
12
14
  };
13
15
  exports.utils = { ...utilsInternal };
14
16
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,6DAAuC;AACvC,+DAAyC;AAEzC,kDAAwB;AACxB,sDAA4B;AAC5B,kDAAwB;AAEX,QAAA,sBAAsB,GAAG;IACpC,GAAG,QAAQ;CACZ,CAAC;AAEW,QAAA,KAAK,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,6DAAuC;AACvC,yEAAmD;AACnD,+DAAyC;AAEzC,kDAAwB;AACxB,sDAA4B;AAC5B,kDAAwB;AAEX,QAAA,sBAAsB,GAAG;IACpC,GAAG,QAAQ;IACX,GAAG,cAAc;CAClB,CAAC;AAEW,QAAA,KAAK,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC"}
@@ -1,15 +1,14 @@
1
1
  import type { ConnectRequest, ConnectResponse } from '../types';
2
2
  /**
3
- * Sends a connect request to the wallet extension with optional dApp metadata.
3
+ * Initiates a connection request to the wallet with optional dApp metadata.
4
4
  *
5
- * @param {string} [name] Human-readable dApp name shown in the wallet.
6
- * @param {string} [icon] Absolute URL to an icon displayed in the wallet.
7
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
5
+ * Emits `${PUBLIC_REQUESTS.CONNECT}_RESPONSE` when the user approves or rejects.
6
+ * If the dApp origin is not yet connected, the wallet will prompt the user.
7
+ *
8
+ * @param {string} [name] Human‑readable dApp name shown in the wallet UI.
9
+ * @param {string} [icon] Absolute URL to an icon displayed during connect.
10
+ * @returns {Promise<ConnectResponse>} "connected" or "disconnected" based on user action.
8
11
  * @example
9
- * // Connect with dApp metadata
10
- * await connect({
11
- * name: 'Canton Demo',
12
- * icon: 'https://example.com/icon.png',
13
- * });
12
+ * await connect({ name: 'Canton Demo', icon: 'https://example.com/icon.png' });
14
13
  */
15
14
  export declare const connect: ({ icon, name }: ConnectRequest) => Promise<ConnectResponse>;
@@ -5,17 +5,16 @@ const constants_1 = require("../constants");
5
5
  const handleResponce_helper_1 = require("../helpers/handleResponce.helper");
6
6
  const types_1 = require("../types");
7
7
  /**
8
- * Sends a connect request to the wallet extension with optional dApp metadata.
8
+ * Initiates a connection request to the wallet with optional dApp metadata.
9
9
  *
10
- * @param {string} [name] Human-readable dApp name shown in the wallet.
11
- * @param {string} [icon] Absolute URL to an icon displayed in the wallet.
12
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
10
+ * Emits `${PUBLIC_REQUESTS.CONNECT}_RESPONSE` when the user approves or rejects.
11
+ * If the dApp origin is not yet connected, the wallet will prompt the user.
12
+ *
13
+ * @param {string} [name] Human‑readable dApp name shown in the wallet UI.
14
+ * @param {string} [icon] Absolute URL to an icon displayed during connect.
15
+ * @returns {Promise<ConnectResponse>} "connected" or "disconnected" based on user action.
13
16
  * @example
14
- * // Connect with dApp metadata
15
- * await connect({
16
- * name: 'Canton Demo',
17
- * icon: 'https://example.com/icon.png',
18
- * });
17
+ * await connect({ name: 'Canton Demo', icon: 'https://example.com/icon.png' });
19
18
  */
20
19
  const connect = async ({ name, icon, }) => new Promise((resolve) => {
21
20
  const id = crypto.randomUUID();
@@ -1 +1 @@
1
- {"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/requests/connect.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAA2C;AAG3C;;;;;;;;;;;;GAYG;AACI,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,uBAAe,CAAC,OAAO;QAC7B,MAAM,EAAE,yBAAa;QACrB,EAAE;QACF,IAAI;QACJ,IAAI;KACL,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,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;AA1BQ,QAAA,OAAO,WA0Bf"}
1
+ {"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/requests/connect.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAA2C;AAG3C;;;;;;;;;;;GAWG;AACI,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,uBAAe,CAAC,OAAO;QAC7B,MAAM,EAAE,yBAAa;QACrB,EAAE;QACF,IAAI;QACJ,IAAI;KACL,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,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;AA1BQ,QAAA,OAAO,WA0Bf"}
@@ -1,7 +1,12 @@
1
1
  import type { DisconnectResponse } from '../types';
2
2
  /**
3
- * Sends a disconnect request to the wallet extension.
3
+ * Terminates the current dApp–wallet connection.
4
4
  *
5
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
5
+ * Emits `${PUBLIC_REQUESTS.DISCONNECT}_RESPONSE` when the user confirms.
6
+ * After disconnect, most requests will trigger a reconnect prompt.
7
+ *
8
+ * @returns {Promise<DisconnectResponse>} "disconnected" when completed.
9
+ * @example
10
+ * await disconnect();
6
11
  */
7
12
  export declare const disconnect: () => Promise<DisconnectResponse>;
@@ -5,9 +5,14 @@ const constants_1 = require("../constants");
5
5
  const handleResponce_helper_1 = require("../helpers/handleResponce.helper");
6
6
  const types_1 = require("../types");
7
7
  /**
8
- * Sends a disconnect request to the wallet extension.
8
+ * Terminates the current dApp–wallet connection.
9
9
  *
10
- * @return {Promise<boolean>} Resolves to true if the user approves the connection, false otherwise.
10
+ * Emits `${PUBLIC_REQUESTS.DISCONNECT}_RESPONSE` when the user confirms.
11
+ * After disconnect, most requests will trigger a reconnect prompt.
12
+ *
13
+ * @returns {Promise<DisconnectResponse>} "disconnected" when completed.
14
+ * @example
15
+ * await disconnect();
11
16
  */
12
17
  const disconnect = async () => new Promise((resolve) => {
13
18
  const id = crypto.randomUUID();
@@ -1 +1 @@
1
- {"version":3,"file":"disconnect.js","sourceRoot":"","sources":["../../../src/requests/disconnect.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAA2C;AAG3C;;;;GAIG;AACI,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,uBAAe,CAAC,UAAU;QAChC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,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;AArBQ,QAAA,UAAU,cAqBlB"}
1
+ {"version":3,"file":"disconnect.js","sourceRoot":"","sources":["../../../src/requests/disconnect.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAA2C;AAG3C;;;;;;;;;GASG;AACI,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,uBAAe,CAAC,UAAU;QAChC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,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;AArBQ,QAAA,UAAU,cAqBlB"}
@@ -1,7 +1,12 @@
1
1
  import { type GetAccountsResponse } from '../types';
2
2
  /**
3
- * Fetches all accounts available in the wallet for the user.
3
+ * Lists all accounts available to the connected dApp origin.
4
4
  *
5
- * @return {Promise<GetAccountsResponse>} Resolves to a list of accounts or undefined.
5
+ * Emits `${PUBLIC_REQUESTS.GET_ACCOUNTS}_RESPONSE` with an array of wallets.
6
+ * Requires a connected origin; otherwise the wallet may trigger a connect flow.
7
+ *
8
+ * @returns {Promise<GetAccountsResponse>} Accounts array or undefined.
9
+ * @example
10
+ * const accounts = await getAccounts();
6
11
  */
7
12
  export declare const getAccounts: () => Promise<GetAccountsResponse>;
@@ -5,9 +5,14 @@ const constants_1 = require("../constants");
5
5
  const handleResponce_helper_1 = require("../helpers/handleResponce.helper");
6
6
  const types_1 = require("../types");
7
7
  /**
8
- * Fetches all accounts available in the wallet for the user.
8
+ * Lists all accounts available to the connected dApp origin.
9
9
  *
10
- * @return {Promise<GetAccountsResponse>} Resolves to a list of accounts or undefined.
10
+ * Emits `${PUBLIC_REQUESTS.GET_ACCOUNTS}_RESPONSE` with an array of wallets.
11
+ * Requires a connected origin; otherwise the wallet may trigger a connect flow.
12
+ *
13
+ * @returns {Promise<GetAccountsResponse>} Accounts array or undefined.
14
+ * @example
15
+ * const accounts = await getAccounts();
11
16
  */
12
17
  const getAccounts = async () => new Promise((resolve) => {
13
18
  const id = crypto.randomUUID();
@@ -1 +1 @@
1
- {"version":3,"file":"getAccounts.js","sourceRoot":"","sources":["../../../src/requests/getAccounts.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAAqE;AAErE;;;;GAIG;AACI,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,uBAAe,CAAC,YAAY;QAClC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,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;AArBQ,QAAA,WAAW,eAqBnB"}
1
+ {"version":3,"file":"getAccounts.js","sourceRoot":"","sources":["../../../src/requests/getAccounts.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAAqE;AAErE;;;;;;;;;GASG;AACI,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,uBAAe,CAAC,YAAY;QAClC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,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;AArBQ,QAAA,WAAW,eAqBnB"}
@@ -1,7 +1,12 @@
1
1
  import { type GetAccountResponse } from '../types';
2
2
  /**
3
- * Gets the currently active account selected in the wallet.
3
+ * Returns the active (primary) account selected in the wallet.
4
4
  *
5
- * @return {Promise<GetAccountResponse>} Resolves to the active account or undefined.
5
+ * Emits `${PUBLIC_REQUESTS.GET_ACTIVE_ACCOUNT}_RESPONSE` with account details.
6
+ * If the origin is not connected, the wallet may prevent access or prompt connect.
7
+ *
8
+ * @returns {Promise<GetAccountResponse>} Active account or undefined.
9
+ * @example
10
+ * const account = await getPrimaryAccount();
6
11
  */
7
- export declare const getActiveAccount: () => Promise<GetAccountResponse>;
12
+ export declare const getPrimaryAccount: () => Promise<GetAccountResponse>;
@@ -1,15 +1,20 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getActiveAccount = void 0;
3
+ exports.getPrimaryAccount = void 0;
4
4
  const constants_1 = require("../constants");
5
5
  const handleResponce_helper_1 = require("../helpers/handleResponce.helper");
6
6
  const types_1 = require("../types");
7
7
  /**
8
- * Gets the currently active account selected in the wallet.
8
+ * Returns the active (primary) account selected in the wallet.
9
9
  *
10
- * @return {Promise<GetAccountResponse>} Resolves to the active account or undefined.
10
+ * Emits `${PUBLIC_REQUESTS.GET_ACTIVE_ACCOUNT}_RESPONSE` with account details.
11
+ * If the origin is not connected, the wallet may prevent access or prompt connect.
12
+ *
13
+ * @returns {Promise<GetAccountResponse>} Active account or undefined.
14
+ * @example
15
+ * const account = await getPrimaryAccount();
11
16
  */
12
- const getActiveAccount = async () => new Promise((resolve) => {
17
+ const getPrimaryAccount = async () => new Promise((resolve) => {
13
18
  const id = crypto.randomUUID();
14
19
  window.postMessage({
15
20
  type: types_1.PUBLIC_REQUESTS.GET_ACTIVE_ACCOUNT,
@@ -24,5 +29,5 @@ const getActiveAccount = async () => new Promise((resolve) => {
24
29
  }
25
30
  window.addEventListener('message', handleResponse);
26
31
  });
27
- exports.getActiveAccount = getActiveAccount;
32
+ exports.getPrimaryAccount = getPrimaryAccount;
28
33
  //# sourceMappingURL=getActiveAccount.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"getActiveAccount.js","sourceRoot":"","sources":["../../../src/requests/getActiveAccount.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAAoE;AAEpE;;;;GAIG;AACI,MAAM,gBAAgB,GAAsC,KAAK,IAAI,EAAE,CAC5E,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,uBAAe,CAAC,kBAAkB;QACxC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,CAAC,kBAAkB,WAAW,CAAC,EAAE;YACnF,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;AArBQ,QAAA,gBAAgB,oBAqBxB"}
1
+ {"version":3,"file":"getActiveAccount.js","sourceRoot":"","sources":["../../../src/requests/getActiveAccount.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAAoE;AAEpE;;;;;;;;;GASG;AACI,MAAM,iBAAiB,GAAsC,KAAK,IAAI,EAAE,CAC7E,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,uBAAe,CAAC,kBAAkB;QACxC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,CAAC,kBAAkB,WAAW,CAAC,EAAE;YACnF,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;AArBQ,QAAA,iBAAiB,qBAqBzB"}
@@ -1,7 +1,12 @@
1
- import type { CANTON_NETWORK_VARIANTS } from '../types';
1
+ import type { Network } from '../types';
2
2
  /**
3
- * Retrieves the currently active Canton network selected in the wallet.
3
+ * Retrieves the currently selected network in the wallet.
4
4
  *
5
- * @return {Promise<CANTON_NETWORK_VARIANTS>} Resolves to the active network variant.
5
+ * Emits `${PUBLIC_REQUESTS.GET_ACTIVE_NETWORK}_RESPONSE` with network information.
6
+ * Origin should be connected; otherwise a connect flow may be required.
7
+ *
8
+ * @returns {Promise<Network>} Active network data.
9
+ * @example
10
+ * const network = await getActiveNetwork();
6
11
  */
7
- export declare const getActiveNetwork: () => Promise<CANTON_NETWORK_VARIANTS>;
12
+ export declare const getActiveNetwork: () => Promise<Network>;
@@ -5,9 +5,14 @@ const constants_1 = require("../constants");
5
5
  const handleResponce_helper_1 = require("../helpers/handleResponce.helper");
6
6
  const types_1 = require("../types");
7
7
  /**
8
- * Retrieves the currently active Canton network selected in the wallet.
8
+ * Retrieves the currently selected network in the wallet.
9
9
  *
10
- * @return {Promise<CANTON_NETWORK_VARIANTS>} Resolves to the active network variant.
10
+ * Emits `${PUBLIC_REQUESTS.GET_ACTIVE_NETWORK}_RESPONSE` with network information.
11
+ * Origin should be connected; otherwise a connect flow may be required.
12
+ *
13
+ * @returns {Promise<Network>} Active network data.
14
+ * @example
15
+ * const network = await getActiveNetwork();
11
16
  */
12
17
  const getActiveNetwork = async () => new Promise((resolve) => {
13
18
  const id = crypto.randomUUID();
@@ -1 +1 @@
1
- {"version":3,"file":"getActiveNetwork.js","sourceRoot":"","sources":["../../../src/requests/getActiveNetwork.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAA2C;AAG3C;;;;GAIG;AACI,MAAM,gBAAgB,GAA2C,KAAK,IAAI,EAAE,CACjF,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,uBAAe,CAAC,kBAAkB;QACxC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,CAAC,kBAAkB,WAAW,CAAC,EAAE;YACnF,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;AArBQ,QAAA,gBAAgB,oBAqBxB"}
1
+ {"version":3,"file":"getActiveNetwork.js","sourceRoot":"","sources":["../../../src/requests/getActiveNetwork.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,4EAAsE;AACtE,oCAA2C;AAG3C;;;;;;;;;GASG;AACI,MAAM,gBAAgB,GAA2B,KAAK,IAAI,EAAE,CACjE,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,uBAAe,CAAC,kBAAkB;QACxC,MAAM,EAAE,yBAAa;QACrB,EAAE;KACH,EACD,GAAG,CACJ,CAAC;IAEF,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,IAAA,0CAAkB,EAAC,KAAK,EAAE,EAAE,EAAE,GAAG,uBAAe,CAAC,kBAAkB,WAAW,CAAC,EAAE;YACnF,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;AArBQ,QAAA,gBAAgB,oBAqBxB"}
@@ -1,13 +1,15 @@
1
1
  import { GetBalanceRequest, GetBalanceResponse } from '../types';
2
2
  /**
3
- * Retrieves token balances for a given party on a specified network.
3
+ * Fetches token balances and pricing details for the provided party.
4
4
  *
5
- * @param {GetBalanceRequest} data Request payload.
5
+ * Emits `${PUBLIC_REQUESTS.GET_BALANCE}_RESPONSE` with balances and metadata.
6
+ * Origin should be connected; otherwise a connect flow may be required.
7
+ *
8
+ * @param {GetBalanceRequest} data Request payload with partyId and options.
6
9
  * @param {string} data.party Party identifier to query balances for.
7
10
  * @param {CANTON_NETWORK_VARIANTS} data.network Canton network to query against.
8
- * @return {Promise<GetBalanceResponse>} Resolves to token list, split flag, and price.
11
+ * @returns {Promise<GetBalanceResponse>} Tokens, split flag, and optional price.
9
12
  * @example
10
- * // Query balances for party on TEST network
11
- * await getBalance({ party: "party-hint:1220...a1b2", network: CANTON_NETWORK_VARIANTS.CANTON_NETWORK_TEST });
13
+ * const res = await getBalance({ party: "123::122", network: CANTON_NETWORK_DEV });
12
14
  */
13
15
  export declare const getBalance: (data: GetBalanceRequest) => Promise<GetBalanceResponse>;