@aztec/wallet-sdk 0.0.1-commit.f295ac2 → 0.0.1-commit.fc805bf
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.
- package/README.md +217 -294
- package/dest/base-wallet/base_wallet.d.ts +20 -7
- package/dest/base-wallet/base_wallet.d.ts.map +1 -1
- package/dest/base-wallet/base_wallet.js +29 -11
- package/dest/crypto.d.ts +59 -50
- package/dest/crypto.d.ts.map +1 -1
- package/dest/crypto.js +202 -108
- package/dest/emoji_alphabet.d.ts +35 -0
- package/dest/emoji_alphabet.d.ts.map +1 -0
- package/dest/emoji_alphabet.js +299 -0
- package/dest/extension/handlers/background_connection_handler.d.ts +158 -0
- package/dest/extension/handlers/background_connection_handler.d.ts.map +1 -0
- package/dest/extension/handlers/background_connection_handler.js +258 -0
- package/dest/extension/handlers/content_script_connection_handler.d.ts +56 -0
- package/dest/extension/handlers/content_script_connection_handler.d.ts.map +1 -0
- package/dest/extension/handlers/content_script_connection_handler.js +174 -0
- package/dest/extension/handlers/index.d.ts +12 -0
- package/dest/extension/handlers/index.d.ts.map +1 -0
- package/dest/extension/handlers/index.js +10 -0
- package/dest/extension/handlers/internal_message_types.d.ts +63 -0
- package/dest/extension/handlers/internal_message_types.d.ts.map +1 -0
- package/dest/extension/handlers/internal_message_types.js +22 -0
- package/dest/extension/provider/extension_provider.d.ts +107 -0
- package/dest/extension/provider/extension_provider.d.ts.map +1 -0
- package/dest/extension/provider/extension_provider.js +160 -0
- package/dest/extension/provider/extension_wallet.d.ts +131 -0
- package/dest/extension/provider/extension_wallet.d.ts.map +1 -0
- package/dest/{providers/extension → extension/provider}/extension_wallet.js +48 -95
- package/dest/extension/provider/index.d.ts +3 -0
- package/dest/extension/provider/index.d.ts.map +1 -0
- package/dest/{providers/extension → extension/provider}/index.js +0 -2
- package/dest/manager/index.d.ts +2 -8
- package/dest/manager/index.d.ts.map +1 -1
- package/dest/manager/index.js +0 -6
- package/dest/manager/types.d.ts +88 -6
- package/dest/manager/types.d.ts.map +1 -1
- package/dest/manager/types.js +17 -1
- package/dest/manager/wallet_manager.d.ts +50 -7
- package/dest/manager/wallet_manager.d.ts.map +1 -1
- package/dest/manager/wallet_manager.js +174 -44
- package/dest/types.d.ts +43 -12
- package/dest/types.d.ts.map +1 -1
- package/dest/types.js +3 -2
- package/package.json +10 -9
- package/src/base-wallet/base_wallet.ts +45 -20
- package/src/crypto.ts +237 -113
- package/src/emoji_alphabet.ts +317 -0
- package/src/extension/handlers/background_connection_handler.ts +423 -0
- package/src/extension/handlers/content_script_connection_handler.ts +246 -0
- package/src/extension/handlers/index.ts +25 -0
- package/src/extension/handlers/internal_message_types.ts +69 -0
- package/src/extension/provider/extension_provider.ts +233 -0
- package/src/{providers/extension → extension/provider}/extension_wallet.ts +52 -110
- package/src/extension/provider/index.ts +7 -0
- package/src/manager/index.ts +2 -10
- package/src/manager/types.ts +91 -5
- package/src/manager/wallet_manager.ts +192 -46
- package/src/types.ts +44 -10
- package/dest/providers/extension/extension_provider.d.ts +0 -63
- package/dest/providers/extension/extension_provider.d.ts.map +0 -1
- package/dest/providers/extension/extension_provider.js +0 -124
- package/dest/providers/extension/extension_wallet.d.ts +0 -155
- package/dest/providers/extension/extension_wallet.d.ts.map +0 -1
- package/dest/providers/extension/index.d.ts +0 -6
- package/dest/providers/extension/index.d.ts.map +0 -1
- package/src/providers/extension/extension_provider.ts +0 -167
- package/src/providers/extension/index.ts +0 -5
package/dest/manager/index.d.ts
CHANGED
|
@@ -1,9 +1,3 @@
|
|
|
1
1
|
export { WalletManager } from './wallet_manager.js';
|
|
2
|
-
export type { WalletManagerConfig, ExtensionWalletConfig, WebWalletConfig, WalletProviderType, WalletProvider, ProviderDisconnectionCallback, DiscoverWalletsOptions, } from './types.js';
|
|
3
|
-
|
|
4
|
-
export type { WalletInfo, WalletMessage, WalletResponse, DiscoveryRequest, DiscoveryResponse } from '../types.js';
|
|
5
|
-
export { ChainInfoSchema } from '@aztec/aztec.js/account';
|
|
6
|
-
export type { ChainInfo } from '@aztec/aztec.js/account';
|
|
7
|
-
export { WalletSchema } from '@aztec/aztec.js/wallet';
|
|
8
|
-
export { jsonStringify } from '@aztec/foundation/json-rpc';
|
|
9
|
-
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9tYW5hZ2VyL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNwRCxZQUFZLEVBQ1YsbUJBQW1CLEVBQ25CLHFCQUFxQixFQUNyQixlQUFlLEVBQ2Ysa0JBQWtCLEVBQ2xCLGNBQWMsRUFDZCw2QkFBNkIsRUFDN0Isc0JBQXNCLEdBQ3ZCLE1BQU0sWUFBWSxDQUFDO0FBR3BCLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUNoRCxZQUFZLEVBQUUsVUFBVSxFQUFFLGFBQWEsRUFBRSxjQUFjLEVBQUUsZ0JBQWdCLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFHbEgsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzFELFlBQVksRUFBRSxTQUFTLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUN6RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDdEQsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLDRCQUE0QixDQUFDIn0=
|
|
2
|
+
export type { WalletManagerConfig, ExtensionWalletConfig, WebWalletConfig, WalletProviderType, WalletProvider, PendingConnection, ProviderDisconnectionCallback, DiscoverWalletsOptions, DiscoverySession, } from './types.js';
|
|
3
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9tYW5hZ2VyL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNwRCxZQUFZLEVBQ1YsbUJBQW1CLEVBQ25CLHFCQUFxQixFQUNyQixlQUFlLEVBQ2Ysa0JBQWtCLEVBQ2xCLGNBQWMsRUFDZCxpQkFBaUIsRUFDakIsNkJBQTZCLEVBQzdCLHNCQUFzQixFQUN0QixnQkFBZ0IsR0FDakIsTUFBTSxZQUFZLENBQUMifQ==
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,6BAA6B,EAC7B,sBAAsB,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
|
package/dest/manager/index.js
CHANGED
|
@@ -1,7 +1 @@
|
|
|
1
1
|
export { WalletManager } from './wallet_manager.js';
|
|
2
|
-
// Re-export types and enums from providers for convenience
|
|
3
|
-
export { WalletMessageType } from '../types.js';
|
|
4
|
-
// Re-export commonly needed utilities for wallet integration
|
|
5
|
-
export { ChainInfoSchema } from '@aztec/aztec.js/account';
|
|
6
|
-
export { WalletSchema } from '@aztec/aztec.js/wallet';
|
|
7
|
-
export { jsonStringify } from '@aztec/foundation/json-rpc';
|
package/dest/manager/types.d.ts
CHANGED
|
@@ -1,5 +1,33 @@
|
|
|
1
1
|
import type { ChainInfo } from '@aztec/aztec.js/account';
|
|
2
2
|
import type { Wallet } from '@aztec/aztec.js/wallet';
|
|
3
|
+
/**
|
|
4
|
+
* A pending connection that requires user verification before finalizing.
|
|
5
|
+
*
|
|
6
|
+
* After key exchange, both dApp and wallet compute a verification hash independently.
|
|
7
|
+
* The dApp should display this hash (typically as emojis) and let the user confirm
|
|
8
|
+
* it matches what's shown in their wallet before calling `confirm()`.
|
|
9
|
+
*
|
|
10
|
+
* This protects the dApp from connecting to a malicious wallet that might be
|
|
11
|
+
* intercepting the connection (MITM attack).
|
|
12
|
+
*/
|
|
13
|
+
export interface PendingConnection {
|
|
14
|
+
/**
|
|
15
|
+
* The verification hash computed from the shared secret.
|
|
16
|
+
* Use `hashToEmoji()` to convert to a visual representation for user verification.
|
|
17
|
+
* The user should confirm this matches what their wallet displays.
|
|
18
|
+
*/
|
|
19
|
+
verificationHash: string;
|
|
20
|
+
/**
|
|
21
|
+
* Confirms the connection after user verifies the emojis match.
|
|
22
|
+
* @returns The connected wallet instance
|
|
23
|
+
*/
|
|
24
|
+
confirm(): Promise<Wallet>;
|
|
25
|
+
/**
|
|
26
|
+
* Cancels the pending connection.
|
|
27
|
+
* Call this if the user indicates the emojis don't match.
|
|
28
|
+
*/
|
|
29
|
+
cancel(): void;
|
|
30
|
+
}
|
|
3
31
|
/**
|
|
4
32
|
* Configuration for extension wallets
|
|
5
33
|
*/
|
|
@@ -30,7 +58,7 @@ export interface WalletManagerConfig {
|
|
|
30
58
|
/**
|
|
31
59
|
* Type of wallet provider
|
|
32
60
|
*/
|
|
33
|
-
export type WalletProviderType = 'extension' | 'web'
|
|
61
|
+
export type WalletProviderType = 'extension' | 'web';
|
|
34
62
|
/**
|
|
35
63
|
* Callback type for wallet disconnect events at the provider level.
|
|
36
64
|
*/
|
|
@@ -51,13 +79,32 @@ export interface WalletProvider {
|
|
|
51
79
|
/** Additional metadata */
|
|
52
80
|
metadata?: Record<string, unknown>;
|
|
53
81
|
/**
|
|
54
|
-
*
|
|
82
|
+
* Establishes a secure channel with this wallet provider.
|
|
83
|
+
*
|
|
84
|
+
* This performs the ECDH key exchange and returns a pending connection with the
|
|
85
|
+
* verification hash. The channel is encrypted but NOT yet verified - the dApp
|
|
86
|
+
* should display the hash (as emojis) to the user and let them confirm it
|
|
87
|
+
* matches their wallet before calling `confirm()`.
|
|
88
|
+
*
|
|
55
89
|
* @param appId - Application identifier for the requesting dapp
|
|
90
|
+
* @returns A pending connection with verification hash and confirm/cancel methods
|
|
91
|
+
*
|
|
92
|
+
* @example
|
|
93
|
+
* ```typescript
|
|
94
|
+
* const pending = await provider.establishSecureChannel('my-app');
|
|
95
|
+
*
|
|
96
|
+
* // Show emojis to user for verification
|
|
97
|
+
* const emojis = hashToEmoji(pending.verificationHash);
|
|
98
|
+
* showDialog(`Verify these match your wallet: ${emojis}`);
|
|
99
|
+
*
|
|
100
|
+
* // User confirms emojis match
|
|
101
|
+
* const wallet = await pending.confirm();
|
|
102
|
+
* ```
|
|
56
103
|
*/
|
|
57
|
-
|
|
104
|
+
establishSecureChannel(appId: string): Promise<PendingConnection>;
|
|
58
105
|
/**
|
|
59
106
|
* Disconnects the current wallet and cleans up resources.
|
|
60
|
-
* After calling this, the wallet returned from
|
|
107
|
+
* After calling this, the wallet returned from confirm() should no longer be used.
|
|
61
108
|
* @returns A promise that resolves when disconnection is complete
|
|
62
109
|
*/
|
|
63
110
|
disconnect?(): Promise<void>;
|
|
@@ -79,7 +126,42 @@ export interface WalletProvider {
|
|
|
79
126
|
export interface DiscoverWalletsOptions {
|
|
80
127
|
/** Chain information to filter by */
|
|
81
128
|
chainInfo: ChainInfo;
|
|
82
|
-
/**
|
|
129
|
+
/** Application ID making the request */
|
|
130
|
+
appId: string;
|
|
131
|
+
/** Discovery timeout in milliseconds. Default: 60000 (60s) */
|
|
83
132
|
timeout?: number;
|
|
133
|
+
/**
|
|
134
|
+
* Callback invoked when a wallet provider is discovered.
|
|
135
|
+
* Use this to show wallets to users as they approve them, rather than
|
|
136
|
+
* waiting for the full timeout.
|
|
137
|
+
*/
|
|
138
|
+
onWalletDiscovered?: (provider: WalletProvider) => void;
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* A cancellable discovery session.
|
|
142
|
+
*
|
|
143
|
+
* Returned by `WalletManager.getAvailableWallets()` to allow consumers to
|
|
144
|
+
* cancel discovery when no longer needed (e.g., network changes, user navigates away).
|
|
145
|
+
*
|
|
146
|
+
* @example
|
|
147
|
+
* ```typescript
|
|
148
|
+
* const discovery = WalletManager.configure({...}).getAvailableWallets({...});
|
|
149
|
+
*
|
|
150
|
+
* // Iterate over discovered wallets
|
|
151
|
+
* for await (const wallet of discovery.wallets) {
|
|
152
|
+
* console.log(`Found: ${wallet.name}`);
|
|
153
|
+
* }
|
|
154
|
+
*
|
|
155
|
+
* // Cancel discovery when no longer needed
|
|
156
|
+
* discovery.cancel();
|
|
157
|
+
* ```
|
|
158
|
+
*/
|
|
159
|
+
export interface DiscoverySession {
|
|
160
|
+
/** Async iterator that yields wallet providers as they're discovered */
|
|
161
|
+
wallets: AsyncIterable<WalletProvider>;
|
|
162
|
+
/** Promise that resolves when discovery completes or is cancelled */
|
|
163
|
+
done: Promise<void>;
|
|
164
|
+
/** Cancel discovery immediately and clean up resources */
|
|
165
|
+
cancel: () => void;
|
|
84
166
|
}
|
|
85
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
167
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9tYW5hZ2VyL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBRXJEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sV0FBVyxpQkFBaUI7SUFDaEM7Ozs7T0FJRztJQUNILGdCQUFnQixFQUFFLE1BQU0sQ0FBQztJQUV6Qjs7O09BR0c7SUFDSCxPQUFPLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBRTNCOzs7T0FHRztJQUNILE1BQU0sSUFBSSxJQUFJLENBQUM7Q0FDaEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxxQkFBcUI7SUFDcEMsNENBQTRDO0lBQzVDLE9BQU8sRUFBRSxPQUFPLENBQUM7SUFDakIseURBQXlEO0lBQ3pELFNBQVMsQ0FBQyxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQ3JCLHlEQUF5RDtJQUN6RCxTQUFTLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQztDQUN0QjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGVBQWU7SUFDOUIsa0NBQWtDO0lBQ2xDLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztDQUNoQjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLG1CQUFtQjtJQUNsQyxxQ0FBcUM7SUFDckMsVUFBVSxDQUFDLEVBQUUscUJBQXFCLENBQUM7SUFDbkMsK0JBQStCO0lBQy9CLFVBQVUsQ0FBQyxFQUFFLGVBQWUsQ0FBQztDQUM5QjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxNQUFNLGtCQUFrQixHQUFHLFdBQVcsR0FBRyxLQUFLLENBQUM7QUFFckQ7O0dBRUc7QUFDSCxNQUFNLE1BQU0sNkJBQTZCLEdBQUcsTUFBTSxJQUFJLENBQUM7QUFFdkQ7OztHQUdHO0FBQ0gsTUFBTSxXQUFXLGNBQWM7SUFDN0IseUNBQXlDO0lBQ3pDLEVBQUUsRUFBRSxNQUFNLENBQUM7SUFDWCw4QkFBOEI7SUFDOUIsSUFBSSxFQUFFLGtCQUFrQixDQUFDO0lBQ3pCLG1CQUFtQjtJQUNuQixJQUFJLEVBQUUsTUFBTSxDQUFDO0lBQ2IsZUFBZTtJQUNmLElBQUksQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNkLDBCQUEwQjtJQUMxQixRQUFRLENBQUMsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ25DOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O09Bc0JHO0lBQ0gsc0JBQXNCLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsaUJBQWlCLENBQUMsQ0FBQztJQUNsRTs7OztPQUlHO0lBQ0gsVUFBVSxDQUFDLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzdCOzs7O09BSUc7SUFDSCxZQUFZLENBQUMsQ0FBQyxRQUFRLEVBQUUsNkJBQTZCLEdBQUcsTUFBTSxJQUFJLENBQUM7SUFDbkU7OztPQUdHO0lBQ0gsY0FBYyxDQUFDLElBQUksT0FBTyxDQUFDO0NBQzVCO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsc0JBQXNCO0lBQ3JDLHFDQUFxQztJQUNyQyxTQUFTLEVBQUUsU0FBUyxDQUFDO0lBQ3JCLHdDQUF3QztJQUN4QyxLQUFLLEVBQUUsTUFBTSxDQUFDO0lBQ2QsOERBQThEO0lBQzlELE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNqQjs7OztPQUlHO0lBQ0gsa0JBQWtCLENBQUMsRUFBRSxDQUFDLFFBQVEsRUFBRSxjQUFjLEtBQUssSUFBSSxDQUFDO0NBQ3pEO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQWtCRztBQUNILE1BQU0sV0FBVyxnQkFBZ0I7SUFDL0Isd0VBQXdFO0lBQ3hFLE9BQU8sRUFBRSxhQUFhLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDdkMscUVBQXFFO0lBQ3JFLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDcEIsMERBQTBEO0lBQzFELE1BQU0sRUFBRSxNQUFNLElBQUksQ0FBQztDQUNwQiJ9
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,KAAK,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3B;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,KAAK,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,IAAI,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IACzB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClE;;;;OAIG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;;;;OAIG;IACH,YAAY,CAAC,CAAC,QAAQ,EAAE,6BAA6B,GAAG,MAAM,IAAI,CAAC;IACnE;;;OAGG;IACH,cAAc,CAAC,IAAI,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,qEAAqE;IACrE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB"}
|
package/dest/manager/types.js
CHANGED
|
@@ -1,3 +1,19 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* A cancellable discovery session.
|
|
3
|
+
*
|
|
4
|
+
* Returned by `WalletManager.getAvailableWallets()` to allow consumers to
|
|
5
|
+
* cancel discovery when no longer needed (e.g., network changes, user navigates away).
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* ```typescript
|
|
9
|
+
* const discovery = WalletManager.configure({...}).getAvailableWallets({...});
|
|
10
|
+
*
|
|
11
|
+
* // Iterate over discovered wallets
|
|
12
|
+
* for await (const wallet of discovery.wallets) {
|
|
13
|
+
* console.log(`Found: ${wallet.name}`);
|
|
14
|
+
* }
|
|
15
|
+
*
|
|
16
|
+
* // Cancel discovery when no longer needed
|
|
17
|
+
* discovery.cancel();
|
|
18
|
+
* ```
|
|
3
19
|
*/ export { };
|
|
@@ -1,6 +1,34 @@
|
|
|
1
|
-
import type { DiscoverWalletsOptions,
|
|
1
|
+
import type { DiscoverWalletsOptions, DiscoverySession, WalletManagerConfig } from './types.js';
|
|
2
2
|
/**
|
|
3
|
-
* Manager for wallet discovery, configuration, and connection
|
|
3
|
+
* Manager for wallet discovery, configuration, and connection.
|
|
4
|
+
*
|
|
5
|
+
* This is the main entry point for dApps to discover and connect to wallets.
|
|
6
|
+
*
|
|
7
|
+
* @example Basic usage with async iterator
|
|
8
|
+
* ```typescript
|
|
9
|
+
* const discovery = WalletManager.configure({ extensions: { enabled: true } })
|
|
10
|
+
* .getAvailableWallets({ chainInfo, appId: 'my-app' });
|
|
11
|
+
*
|
|
12
|
+
* // Iterate over discovered wallets
|
|
13
|
+
* for await (const provider of discovery.wallets) {
|
|
14
|
+
* console.log(`Found wallet: ${provider.name}`);
|
|
15
|
+
* }
|
|
16
|
+
*
|
|
17
|
+
* // Or cancel early when done
|
|
18
|
+
* discovery.cancel();
|
|
19
|
+
* ```
|
|
20
|
+
*
|
|
21
|
+
* @example With callback for discovered wallets
|
|
22
|
+
* ```typescript
|
|
23
|
+
* const discovery = manager.getAvailableWallets({
|
|
24
|
+
* chainInfo,
|
|
25
|
+
* appId: 'my-app',
|
|
26
|
+
* onWalletDiscovered: (provider) => console.log(`Found: ${provider.name}`),
|
|
27
|
+
* });
|
|
28
|
+
*
|
|
29
|
+
* // Wait for discovery to complete or cancel it
|
|
30
|
+
* await discovery.done;
|
|
31
|
+
* ```
|
|
4
32
|
*/
|
|
5
33
|
export declare class WalletManager {
|
|
6
34
|
private config;
|
|
@@ -12,11 +40,26 @@ export declare class WalletManager {
|
|
|
12
40
|
static configure(config: WalletManagerConfig): WalletManager;
|
|
13
41
|
/**
|
|
14
42
|
* Discovers all available wallets for a given chain and version.
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
43
|
+
*
|
|
44
|
+
* Returns a `DiscoverySession` with:
|
|
45
|
+
* - `wallets`: AsyncIterable to iterate over discovered wallets
|
|
46
|
+
* - `done`: Promise that resolves when discovery completes or is cancelled
|
|
47
|
+
* - `cancel()`: Function to stop discovery immediately
|
|
48
|
+
*
|
|
49
|
+
* If `onWalletDiscovered` callback is provided, wallets are also streamed via callback.
|
|
50
|
+
*
|
|
51
|
+
* @param options - Discovery options including chain info, appId, and timeout
|
|
52
|
+
* @returns A cancellable discovery session
|
|
18
53
|
*/
|
|
19
|
-
getAvailableWallets(options: DiscoverWalletsOptions):
|
|
54
|
+
getAvailableWallets(options: DiscoverWalletsOptions): DiscoverySession;
|
|
55
|
+
/**
|
|
56
|
+
* Creates a WalletProvider from a discovered wallet.
|
|
57
|
+
* Returns null if the wallet is not allowed by config.
|
|
58
|
+
* @param discoveredWallet - The discovered wallet from extension discovery.
|
|
59
|
+
* @param chainInfo - Network information.
|
|
60
|
+
* @param extensionConfig - Extension wallet configuration.
|
|
61
|
+
*/
|
|
62
|
+
private createProviderFromDiscoveredWallet;
|
|
20
63
|
/**
|
|
21
64
|
* Checks if an extension is allowed based on allow/block lists
|
|
22
65
|
* @param extensionId - The extension ID to check
|
|
@@ -24,4 +67,4 @@ export declare class WalletManager {
|
|
|
24
67
|
*/
|
|
25
68
|
private isExtensionAllowed;
|
|
26
69
|
}
|
|
27
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
70
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2FsbGV0X21hbmFnZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9tYW5hZ2VyL3dhbGxldF9tYW5hZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUtBLE9BQU8sS0FBSyxFQUNWLHNCQUFzQixFQUN0QixnQkFBZ0IsRUFJaEIsbUJBQW1CLEVBRXBCLE1BQU0sWUFBWSxDQUFDO0FBRXBCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E4Qkc7QUFDSCxxQkFBYSxhQUFhO0lBQ3hCLE9BQU8sQ0FBQyxNQUFNLENBR1o7SUFFRixPQUFPLGVBQWlCO0lBRXhCOzs7T0FHRztJQUNILE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLG1CQUFtQixHQUFHLGFBQWEsQ0FPM0Q7SUFFRDs7Ozs7Ozs7Ozs7O09BWUc7SUFDSCxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsc0JBQXNCLEdBQUcsZ0JBQWdCLENBNkVyRTtJQUVEOzs7Ozs7T0FNRztJQUNILE9BQU8sQ0FBQyxrQ0FBa0M7SUE0RTFDOzs7O09BSUc7SUFDSCxPQUFPLENBQUMsa0JBQWtCO0NBVzNCIn0=
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"wallet_manager.d.ts","sourceRoot":"","sources":["../../src/manager/wallet_manager.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"wallet_manager.d.ts","sourceRoot":"","sources":["../../src/manager/wallet_manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAIhB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAGZ;IAEF,OAAO,eAAiB;IAExB;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAO3D;IAED;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CA6ErE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,kCAAkC;IA4E1C;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAW3B"}
|
|
@@ -1,6 +1,36 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { promiseWithResolvers } from '@aztec/foundation/promise';
|
|
2
|
+
import { ExtensionProvider, ExtensionWallet } from '../extension/provider/index.js';
|
|
3
|
+
import { WalletMessageType } from '../types.js';
|
|
2
4
|
/**
|
|
3
|
-
* Manager for wallet discovery, configuration, and connection
|
|
5
|
+
* Manager for wallet discovery, configuration, and connection.
|
|
6
|
+
*
|
|
7
|
+
* This is the main entry point for dApps to discover and connect to wallets.
|
|
8
|
+
*
|
|
9
|
+
* @example Basic usage with async iterator
|
|
10
|
+
* ```typescript
|
|
11
|
+
* const discovery = WalletManager.configure({ extensions: { enabled: true } })
|
|
12
|
+
* .getAvailableWallets({ chainInfo, appId: 'my-app' });
|
|
13
|
+
*
|
|
14
|
+
* // Iterate over discovered wallets
|
|
15
|
+
* for await (const provider of discovery.wallets) {
|
|
16
|
+
* console.log(`Found wallet: ${provider.name}`);
|
|
17
|
+
* }
|
|
18
|
+
*
|
|
19
|
+
* // Or cancel early when done
|
|
20
|
+
* discovery.cancel();
|
|
21
|
+
* ```
|
|
22
|
+
*
|
|
23
|
+
* @example With callback for discovered wallets
|
|
24
|
+
* ```typescript
|
|
25
|
+
* const discovery = manager.getAvailableWallets({
|
|
26
|
+
* chainInfo,
|
|
27
|
+
* appId: 'my-app',
|
|
28
|
+
* onWalletDiscovered: (provider) => console.log(`Found: ${provider.name}`),
|
|
29
|
+
* });
|
|
30
|
+
*
|
|
31
|
+
* // Wait for discovery to complete or cancel it
|
|
32
|
+
* await discovery.done;
|
|
33
|
+
* ```
|
|
4
34
|
*/ export class WalletManager {
|
|
5
35
|
config = {
|
|
6
36
|
extensions: {
|
|
@@ -28,57 +58,157 @@ import { ExtensionProvider, ExtensionWallet } from '../providers/extension/index
|
|
|
28
58
|
}
|
|
29
59
|
/**
|
|
30
60
|
* Discovers all available wallets for a given chain and version.
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
61
|
+
*
|
|
62
|
+
* Returns a `DiscoverySession` with:
|
|
63
|
+
* - `wallets`: AsyncIterable to iterate over discovered wallets
|
|
64
|
+
* - `done`: Promise that resolves when discovery completes or is cancelled
|
|
65
|
+
* - `cancel()`: Function to stop discovery immediately
|
|
66
|
+
*
|
|
67
|
+
* If `onWalletDiscovered` callback is provided, wallets are also streamed via callback.
|
|
68
|
+
*
|
|
69
|
+
* @param options - Discovery options including chain info, appId, and timeout
|
|
70
|
+
* @returns A cancellable discovery session
|
|
71
|
+
*/ getAvailableWallets(options) {
|
|
72
|
+
const { chainInfo, appId } = options;
|
|
73
|
+
const abortController = new AbortController();
|
|
74
|
+
const pendingProviders = [];
|
|
75
|
+
let pendingResolve = null;
|
|
76
|
+
let completed = false;
|
|
77
|
+
const { promise: donePromise, resolve: resolveDone } = promiseWithResolvers();
|
|
78
|
+
const markComplete = ()=>{
|
|
79
|
+
completed = true;
|
|
80
|
+
resolveDone();
|
|
81
|
+
if (pendingResolve) {
|
|
82
|
+
const resolve = pendingResolve;
|
|
83
|
+
pendingResolve = null;
|
|
84
|
+
resolve({
|
|
85
|
+
value: undefined,
|
|
86
|
+
done: true
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
};
|
|
37
90
|
if (this.config.extensions?.enabled) {
|
|
38
|
-
const discoveredWallets = await ExtensionProvider.discoverExtensions(chainInfo, options.timeout);
|
|
39
91
|
const extensionConfig = this.config.extensions;
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
92
|
+
void ExtensionProvider.discoverWallets(chainInfo, {
|
|
93
|
+
appId,
|
|
94
|
+
timeout: options.timeout,
|
|
95
|
+
signal: abortController.signal,
|
|
96
|
+
onWalletDiscovered: (discoveredWallet)=>{
|
|
97
|
+
const provider = this.createProviderFromDiscoveredWallet(discoveredWallet, chainInfo, extensionConfig);
|
|
98
|
+
if (!provider) {
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
// Call user's callback if provided
|
|
102
|
+
options.onWalletDiscovered?.(provider);
|
|
103
|
+
// Also queue for async iterator
|
|
104
|
+
if (pendingResolve) {
|
|
105
|
+
const resolve = pendingResolve;
|
|
106
|
+
pendingResolve = null;
|
|
107
|
+
resolve({
|
|
108
|
+
value: provider,
|
|
109
|
+
done: false
|
|
110
|
+
});
|
|
111
|
+
} else {
|
|
112
|
+
pendingProviders.push(provider);
|
|
113
|
+
}
|
|
43
114
|
}
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
if (extensionWallet) {
|
|
60
|
-
await extensionWallet.disconnect();
|
|
61
|
-
extensionWallet = null;
|
|
62
|
-
}
|
|
63
|
-
},
|
|
64
|
-
onDisconnect: (callback)=>{
|
|
65
|
-
if (extensionWallet) {
|
|
66
|
-
return extensionWallet.onDisconnect(callback);
|
|
115
|
+
}).then(markComplete);
|
|
116
|
+
} else {
|
|
117
|
+
markComplete();
|
|
118
|
+
}
|
|
119
|
+
const wallets = {
|
|
120
|
+
// eslint-disable-next-line jsdoc/require-jsdoc
|
|
121
|
+
[Symbol.asyncIterator] () {
|
|
122
|
+
return {
|
|
123
|
+
// eslint-disable-next-line jsdoc/require-jsdoc
|
|
124
|
+
next () {
|
|
125
|
+
if (pendingProviders.length > 0) {
|
|
126
|
+
return Promise.resolve({
|
|
127
|
+
value: pendingProviders.shift(),
|
|
128
|
+
done: false
|
|
129
|
+
});
|
|
67
130
|
}
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
131
|
+
if (completed) {
|
|
132
|
+
return Promise.resolve({
|
|
133
|
+
value: undefined,
|
|
134
|
+
done: true
|
|
135
|
+
});
|
|
73
136
|
}
|
|
74
|
-
return
|
|
137
|
+
return new Promise((resolve)=>{
|
|
138
|
+
pendingResolve = resolve;
|
|
139
|
+
});
|
|
75
140
|
}
|
|
76
141
|
};
|
|
77
|
-
providers.push(provider);
|
|
78
142
|
}
|
|
143
|
+
};
|
|
144
|
+
return {
|
|
145
|
+
wallets,
|
|
146
|
+
done: donePromise,
|
|
147
|
+
cancel: ()=>abortController.abort()
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* Creates a WalletProvider from a discovered wallet.
|
|
152
|
+
* Returns null if the wallet is not allowed by config.
|
|
153
|
+
* @param discoveredWallet - The discovered wallet from extension discovery.
|
|
154
|
+
* @param chainInfo - Network information.
|
|
155
|
+
* @param extensionConfig - Extension wallet configuration.
|
|
156
|
+
*/ createProviderFromDiscoveredWallet(discoveredWallet, chainInfo, extensionConfig) {
|
|
157
|
+
const { info } = discoveredWallet;
|
|
158
|
+
if (!this.isExtensionAllowed(info.id, extensionConfig)) {
|
|
159
|
+
return null;
|
|
79
160
|
}
|
|
80
|
-
|
|
81
|
-
|
|
161
|
+
let extensionWallet = null;
|
|
162
|
+
const provider = {
|
|
163
|
+
id: info.id,
|
|
164
|
+
type: 'extension',
|
|
165
|
+
name: info.name,
|
|
166
|
+
icon: info.icon,
|
|
167
|
+
metadata: {
|
|
168
|
+
version: info.version
|
|
169
|
+
},
|
|
170
|
+
establishSecureChannel: async (connectAppId)=>{
|
|
171
|
+
const connection = await discoveredWallet.establishSecureChannel();
|
|
172
|
+
provider.metadata = {
|
|
173
|
+
...provider.metadata,
|
|
174
|
+
verificationHash: connection.info.verificationHash
|
|
175
|
+
};
|
|
176
|
+
return {
|
|
177
|
+
verificationHash: connection.info.verificationHash,
|
|
178
|
+
confirm: ()=>{
|
|
179
|
+
return Promise.resolve(ExtensionWallet.create(connection.info.id, connection.port, connection.sharedKey, chainInfo, connectAppId));
|
|
180
|
+
},
|
|
181
|
+
cancel: ()=>{
|
|
182
|
+
// Send disconnect to terminate the session on the extension side
|
|
183
|
+
// but keep the port open so we can retry key exchange
|
|
184
|
+
connection.port.postMessage({
|
|
185
|
+
type: WalletMessageType.DISCONNECT,
|
|
186
|
+
requestId: discoveredWallet.requestId
|
|
187
|
+
});
|
|
188
|
+
// Don't close the port - allow retry with fresh key exchange
|
|
189
|
+
}
|
|
190
|
+
};
|
|
191
|
+
},
|
|
192
|
+
disconnect: async ()=>{
|
|
193
|
+
if (extensionWallet) {
|
|
194
|
+
await extensionWallet.disconnect();
|
|
195
|
+
extensionWallet = null;
|
|
196
|
+
}
|
|
197
|
+
},
|
|
198
|
+
onDisconnect: (callback)=>{
|
|
199
|
+
if (extensionWallet) {
|
|
200
|
+
return extensionWallet.onDisconnect(callback);
|
|
201
|
+
}
|
|
202
|
+
return ()=>{};
|
|
203
|
+
},
|
|
204
|
+
isDisconnected: ()=>{
|
|
205
|
+
if (extensionWallet) {
|
|
206
|
+
return extensionWallet.isDisconnected();
|
|
207
|
+
}
|
|
208
|
+
return true;
|
|
209
|
+
}
|
|
210
|
+
};
|
|
211
|
+
return provider;
|
|
82
212
|
}
|
|
83
213
|
/**
|
|
84
214
|
* Checks if an extension is allowed based on allow/block lists
|
package/dest/types.d.ts
CHANGED
|
@@ -9,13 +9,16 @@ export declare enum WalletMessageType {
|
|
|
9
9
|
DISCOVERY = "aztec-wallet-discovery",
|
|
10
10
|
/** Discovery response from a wallet */
|
|
11
11
|
DISCOVERY_RESPONSE = "aztec-wallet-discovery-response",
|
|
12
|
-
/**
|
|
13
|
-
|
|
14
|
-
/**
|
|
15
|
-
|
|
12
|
+
/** Disconnect message (unencrypted control message, bidirectional) */
|
|
13
|
+
DISCONNECT = "aztec-wallet-disconnect",
|
|
14
|
+
/** Key exchange request sent over MessageChannel */
|
|
15
|
+
KEY_EXCHANGE_REQUEST = "aztec-wallet-key-exchange-request",
|
|
16
|
+
/** Key exchange response sent over MessageChannel */
|
|
17
|
+
KEY_EXCHANGE_RESPONSE = "aztec-wallet-key-exchange-response"
|
|
16
18
|
}
|
|
17
19
|
/**
|
|
18
|
-
* Information about an installed Aztec wallet
|
|
20
|
+
* Information about an installed Aztec wallet.
|
|
21
|
+
* Used during discovery phase before key exchange.
|
|
19
22
|
*/
|
|
20
23
|
export interface WalletInfo {
|
|
21
24
|
/** Unique identifier for the wallet */
|
|
@@ -26,10 +29,16 @@ export interface WalletInfo {
|
|
|
26
29
|
icon?: string;
|
|
27
30
|
/** Wallet version */
|
|
28
31
|
version: string;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Full information about a connected Aztec wallet including crypto material.
|
|
35
|
+
* Available after key exchange completes.
|
|
36
|
+
*/
|
|
37
|
+
export interface ConnectedWalletInfo extends WalletInfo {
|
|
29
38
|
/** Wallet's ECDH public key for secure channel establishment */
|
|
30
39
|
publicKey: ExportedPublicKey;
|
|
31
40
|
/**
|
|
32
|
-
*
|
|
41
|
+
* Verification hash for verification.
|
|
33
42
|
* Both dApp and wallet independently compute this from the ECDH shared secret.
|
|
34
43
|
* Use {@link hashToEmoji} to convert to a visual representation for user verification.
|
|
35
44
|
*/
|
|
@@ -66,27 +75,49 @@ export interface WalletResponse {
|
|
|
66
75
|
walletId: string;
|
|
67
76
|
}
|
|
68
77
|
/**
|
|
69
|
-
* Discovery message for finding installed wallets (public, unencrypted)
|
|
78
|
+
* Discovery message for finding installed wallets (public, unencrypted).
|
|
70
79
|
*/
|
|
71
80
|
export interface DiscoveryRequest {
|
|
72
81
|
/** Message type for discovery */
|
|
73
82
|
type: WalletMessageType.DISCOVERY;
|
|
74
83
|
/** Request ID */
|
|
75
84
|
requestId: string;
|
|
85
|
+
/** Application ID making the request */
|
|
86
|
+
appId: string;
|
|
76
87
|
/** Chain information to check if wallet supports this network */
|
|
77
88
|
chainInfo: ChainInfo;
|
|
78
|
-
/** dApp's ECDH public key for deriving shared secret */
|
|
79
|
-
publicKey: ExportedPublicKey;
|
|
80
89
|
}
|
|
81
90
|
/**
|
|
82
|
-
* Discovery response from a wallet (public, unencrypted)
|
|
91
|
+
* Discovery response from a wallet (public, unencrypted).
|
|
83
92
|
*/
|
|
84
93
|
export interface DiscoveryResponse {
|
|
85
94
|
/** Message type for discovery response */
|
|
86
95
|
type: WalletMessageType.DISCOVERY_RESPONSE;
|
|
87
96
|
/** Request ID matching the discovery request */
|
|
88
97
|
requestId: string;
|
|
89
|
-
/**
|
|
98
|
+
/** Basic wallet information */
|
|
90
99
|
walletInfo: WalletInfo;
|
|
91
100
|
}
|
|
92
|
-
|
|
101
|
+
/**
|
|
102
|
+
* Key exchange request sent over MessageChannel after discovery approval.
|
|
103
|
+
*/
|
|
104
|
+
export interface KeyExchangeRequest {
|
|
105
|
+
/** Message type */
|
|
106
|
+
type: WalletMessageType.KEY_EXCHANGE_REQUEST;
|
|
107
|
+
/** Request ID matching the discovery request */
|
|
108
|
+
requestId: string;
|
|
109
|
+
/** dApp's ECDH public key for deriving shared secret */
|
|
110
|
+
publicKey: ExportedPublicKey;
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Key exchange response sent over MessageChannel.
|
|
114
|
+
*/
|
|
115
|
+
export interface KeyExchangeResponse {
|
|
116
|
+
/** Message type */
|
|
117
|
+
type: WalletMessageType.KEY_EXCHANGE_RESPONSE;
|
|
118
|
+
/** Request ID matching the discovery request */
|
|
119
|
+
requestId: string;
|
|
120
|
+
/** Wallet's ECDH public key for deriving shared secret */
|
|
121
|
+
publicKey: ExportedPublicKey;
|
|
122
|
+
}
|
|
123
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUV6RCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUVyRDs7O0dBR0c7QUFDSCxvQkFBWSxpQkFBaUI7SUFDM0Isa0RBQWtEO0lBQ2xELFNBQVMsMkJBQTJCO0lBQ3BDLHVDQUF1QztJQUN2QyxrQkFBa0Isb0NBQW9DO0lBQ3RELHNFQUFzRTtJQUN0RSxVQUFVLDRCQUE0QjtJQUN0QyxvREFBb0Q7SUFDcEQsb0JBQW9CLHNDQUFzQztJQUMxRCxxREFBcUQ7SUFDckQscUJBQXFCLHVDQUF1QztDQUM3RDtBQUVEOzs7R0FHRztBQUNILE1BQU0sV0FBVyxVQUFVO0lBQ3pCLHVDQUF1QztJQUN2QyxFQUFFLEVBQUUsTUFBTSxDQUFDO0lBQ1gsaUNBQWlDO0lBQ2pDLElBQUksRUFBRSxNQUFNLENBQUM7SUFDYiwrQkFBK0I7SUFDL0IsSUFBSSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2QscUJBQXFCO0lBQ3JCLE9BQU8sRUFBRSxNQUFNLENBQUM7Q0FDakI7QUFFRDs7O0dBR0c7QUFDSCxNQUFNLFdBQVcsbUJBQW9CLFNBQVEsVUFBVTtJQUNyRCxnRUFBZ0U7SUFDaEUsU0FBUyxFQUFFLGlCQUFpQixDQUFDO0lBQzdCOzs7O09BSUc7SUFDSCxnQkFBZ0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztDQUMzQjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGFBQWE7SUFDNUIsK0NBQStDO0lBQy9DLFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsZ0NBQWdDO0lBQ2hDLElBQUksRUFBRSxNQUFNLENBQUM7SUFDYiwrQkFBK0I7SUFDL0IsSUFBSSxFQUFFLE9BQU8sRUFBRSxDQUFDO0lBQ2hCLHdCQUF3QjtJQUN4QixTQUFTLEVBQUUsU0FBUyxDQUFDO0lBQ3JCLHdDQUF3QztJQUN4QyxLQUFLLEVBQUUsTUFBTSxDQUFDO0lBQ2QsNENBQTRDO0lBQzVDLFFBQVEsRUFBRSxNQUFNLENBQUM7Q0FDbEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxjQUFjO0lBQzdCLHNDQUFzQztJQUN0QyxTQUFTLEVBQUUsTUFBTSxDQUFDO0lBQ2xCLGtDQUFrQztJQUNsQyxNQUFNLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDakIsNkJBQTZCO0lBQzdCLEtBQUssQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUNoQix1Q0FBdUM7SUFDdkMsUUFBUSxFQUFFLE1BQU0sQ0FBQztDQUNsQjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGdCQUFnQjtJQUMvQixpQ0FBaUM7SUFDakMsSUFBSSxFQUFFLGlCQUFpQixDQUFDLFNBQVMsQ0FBQztJQUNsQyxpQkFBaUI7SUFDakIsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQix3Q0FBd0M7SUFDeEMsS0FBSyxFQUFFLE1BQU0sQ0FBQztJQUNkLGlFQUFpRTtJQUNqRSxTQUFTLEVBQUUsU0FBUyxDQUFDO0NBQ3RCO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsaUJBQWlCO0lBQ2hDLDBDQUEwQztJQUMxQyxJQUFJLEVBQUUsaUJBQWlCLENBQUMsa0JBQWtCLENBQUM7SUFDM0MsZ0RBQWdEO0lBQ2hELFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsK0JBQStCO0lBQy9CLFVBQVUsRUFBRSxVQUFVLENBQUM7Q0FDeEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxrQkFBa0I7SUFDakMsbUJBQW1CO0lBQ25CLElBQUksRUFBRSxpQkFBaUIsQ0FBQyxvQkFBb0IsQ0FBQztJQUM3QyxnREFBZ0Q7SUFDaEQsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQix3REFBd0Q7SUFDeEQsU0FBUyxFQUFFLGlCQUFpQixDQUFDO0NBQzlCO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsbUJBQW1CO0lBQ2xDLG1CQUFtQjtJQUNuQixJQUFJLEVBQUUsaUJBQWlCLENBQUMscUJBQXFCLENBQUM7SUFDOUMsZ0RBQWdEO0lBQ2hELFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsMERBQTBEO0lBQzFELFNBQVMsRUFBRSxpQkFBaUIsQ0FBQztDQUM5QiJ9
|
package/dest/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;GAGG;AACH,oBAAY,iBAAiB;IAC3B,kDAAkD;IAClD,SAAS,2BAA2B;IACpC,uCAAuC;IACvC,kBAAkB,oCAAoC;IACtD,sEAAsE;IACtE,oBAAoB,sCAAsC;IAC1D,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;GAGG;AACH,oBAAY,iBAAiB;IAC3B,kDAAkD;IAClD,SAAS,2BAA2B;IACpC,uCAAuC;IACvC,kBAAkB,oCAAoC;IACtD,sEAAsE;IACtE,UAAU,4BAA4B;IACtC,oDAAoD;IACpD,oBAAoB,sCAAsC;IAC1D,qDAAqD;IACrD,qBAAqB,uCAAuC;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,gEAAgE;IAChE,SAAS,EAAE,iBAAiB,CAAC;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,wBAAwB;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC;IAClC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,IAAI,EAAE,iBAAiB,CAAC,kBAAkB,CAAC;IAC3C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,IAAI,EAAE,iBAAiB,CAAC,oBAAoB,CAAC;IAC7C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,IAAI,EAAE,iBAAiB,CAAC,qBAAqB,CAAC;IAC9C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,SAAS,EAAE,iBAAiB,CAAC;CAC9B"}
|
package/dest/types.js
CHANGED
|
@@ -4,7 +4,8 @@
|
|
|
4
4
|
*/ export var WalletMessageType = /*#__PURE__*/ function(WalletMessageType) {
|
|
5
5
|
/** Discovery request to find installed wallets */ WalletMessageType["DISCOVERY"] = "aztec-wallet-discovery";
|
|
6
6
|
/** Discovery response from a wallet */ WalletMessageType["DISCOVERY_RESPONSE"] = "aztec-wallet-discovery-response";
|
|
7
|
-
/**
|
|
8
|
-
/**
|
|
7
|
+
/** Disconnect message (unencrypted control message, bidirectional) */ WalletMessageType["DISCONNECT"] = "aztec-wallet-disconnect";
|
|
8
|
+
/** Key exchange request sent over MessageChannel */ WalletMessageType["KEY_EXCHANGE_REQUEST"] = "aztec-wallet-key-exchange-request";
|
|
9
|
+
/** Key exchange response sent over MessageChannel */ WalletMessageType["KEY_EXCHANGE_RESPONSE"] = "aztec-wallet-key-exchange-response";
|
|
9
10
|
return WalletMessageType;
|
|
10
11
|
}({});
|