@mysten-incubation/dev-wallet 0.3.0 → 0.4.1

package/src/wallet/initializer.ts

@@ -6,7 +6,8 @@ import type { WalletIcon } from '@mysten/wallet-standard';
 
 import type { DevWalletDockStyle } from '../ui/dev-wallet-panel.js';
 import type { SignerAdapter } from '../types.js';
-import { DevWallet, type AutoApprovePolicy } from './dev-wallet.js';
+import type { DevWallet, AutoApprovePolicy } from './dev-wallet.js';
+import { mountAndRegisterDevWallet } from './mount-and-register.js';
 
 /**
  * Configuration for the dev wallet initializer.
@@ -66,26 +67,6 @@ export function devWalletInitializer(config: DevWalletInitializerConfig): {
 	return {
 		id: 'dev-wallet-initializer',
 		async initialize({ networks, getClient }) {
-			const { autoInitialize = true, createInitialAccount = true, mountUI = false } = config;
-
-			// Initialize adapters
-			if (autoInitialize) {
-				await Promise.all(config.adapters.map((a) => a.initialize()));
-			}
-
-			// Create initial account if needed
-			if (createInitialAccount) {
-				const hasAccounts = config.adapters.some((a) => a.getAccounts().length > 0);
-				if (!hasAccounts) {
-					const creatableAdapter = config.adapters.find(
-						(a) => a.createAccount && a.getAccounts().length === 0,
-					);
-					if (creatableAdapter?.createAccount) {
-						await creatableAdapter.createAccount({ label: 'Dev Account' });
-					}
-				}
-			}
-
 			// Map dApp Kit networks to DevWallet format.
 			// DevWallet needs a Record<string, string> of network name → URL, but
 			// the clientFactory we provide delegates to getClient, so the URLs are
@@ -95,7 +76,13 @@ export function devWalletInitializer(config: DevWalletInitializerConfig): {
 				networkUrls[network] = `dapp-kit://${network}`;
 			}
 
-			const wallet = new DevWallet({
+			// Delegate the construct → init-adapter → mount-UI → register → dispose
+			// sequence to the shared core helper; this initializer only supplies the
+			// dApp-Kit-sourced networks + client factory and the `onWalletCreated`
+			// hook. `createInitialAccount`/`autoInitialize` default to TRUE here (the
+			// initializer's historical behavior — its adapters start empty); `mountUI`
+			// defaults to FALSE (dApp Kit typically renders its own connect UI).
+			const { dispose } = await mountAndRegisterDevWallet({
 				adapters: config.adapters,
 				networks: networkUrls,
 				name: config.name,
@@ -103,28 +90,15 @@ export function devWalletInitializer(config: DevWalletInitializerConfig): {
 				autoApprove: config.autoApprove,
 				autoConnect: config.autoConnect,
 				clientFactory: (network) => getClient(network),
+				autoInitialize: config.autoInitialize ?? true,
+				createInitialAccount: config.createInitialAccount ?? true,
+				mountUI: config.mountUI ?? false,
+				dockStyle: config.dockStyle,
+				container: config.container,
+				onWalletCreated: config.onWalletCreated,
 			});
 
-			config.onWalletCreated?.(wallet);
-
-			// Mount UI if requested
-			let unmountUI: (() => void) | undefined;
-			if (mountUI && typeof document !== 'undefined') {
-				const { mountDevWallet } = await import('../ui/mount.js');
-				unmountUI = mountDevWallet(wallet, {
-					container: config.container,
-					dockStyle: config.dockStyle,
-				});
-			}
-
-			const unregister = wallet.register();
-			return {
-				unregister() {
-					unmountUI?.();
-					unregister();
-					wallet.destroy();
-				},
-			};
+			return { unregister: dispose };
 		},
 	};
 }

package/src/wallet/mount-and-register.ts

@@ -0,0 +1,93 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+import type { DevWalletDockStyle } from '../ui/dev-wallet-panel.js';
+import { DevWallet, type DevWalletConfig } from './dev-wallet.js';
+
+export interface MountAndRegisterDevWalletOptions extends DevWalletConfig {
+	/** Call `adapter.initialize()` on every adapter before registering. Defaults to true. */
+	autoInitialize?: boolean;
+	/**
+	 * Create an initial account after initialization when no adapter has any
+	 * accounts (uses the first adapter that supports `createAccount`). Defaults
+	 * to false — most managed/remote adapters (devstack, CLI) bring their own
+	 * accounts and must NOT have a throwaway one fabricated.
+	 */
+	createInitialAccount?: boolean;
+	/** Mount the floating wallet drawer UI (no-op when `document` is undefined). Defaults to true. */
+	mountUI?: boolean;
+	/** Floating dock presentation when `mountUI` is true. */
+	dockStyle?: DevWalletDockStyle;
+	/** Container element for the UI drawer. Defaults to `document.body`. */
+	container?: HTMLElement;
+	/** Called with the `DevWallet` once constructed, before the UI is mounted
+	 *  and the wallet is registered. */
+	onWalletCreated?: (wallet: DevWallet) => void;
+}
+
+export interface MountAndRegisterDevWalletResult {
+	readonly wallet: DevWallet;
+	/** Unmount the UI, unregister from wallet-standard, and destroy the wallet (+ adapters). */
+	readonly dispose: () => void;
+}
+
+/**
+ * Construct a {@link DevWallet} from adapters, initialize the adapters, mount
+ * the drawer UI, register it with the wallet-standard registry, and return the
+ * wallet plus a single `dispose()` that tears all of that down again.
+ *
+ * This is the imperative "bring a dev wallet up on the page" path shared by the
+ * React hook (`useDevWallet`), the dApp-Kit initializer (`devWalletInitializer`),
+ * and the devstack page-register entry (`src/inject`). Those call sites only
+ * differ in HOW they obtain `adapters` / `networks` — the construct → init →
+ * mount → register → dispose sequence is identical, so it lives here once.
+ */
+export async function mountAndRegisterDevWallet(
+	options: MountAndRegisterDevWalletOptions,
+): Promise<MountAndRegisterDevWalletResult> {
+	const {
+		autoInitialize = true,
+		createInitialAccount = false,
+		mountUI = true,
+		dockStyle,
+		container,
+		onWalletCreated,
+		...walletConfig
+	} = options;
+
+	if (autoInitialize) {
+		await Promise.all(walletConfig.adapters.map((a) => a.initialize()));
+	}
+
+	if (createInitialAccount) {
+		const hasAccounts = walletConfig.adapters.some((a) => a.getAccounts().length > 0);
+		if (!hasAccounts) {
+			const creatableAdapter = walletConfig.adapters.find(
+				(a) => a.createAccount && a.getAccounts().length === 0,
+			);
+			if (creatableAdapter?.createAccount) {
+				await creatableAdapter.createAccount({ label: 'Dev Account' });
+			}
+		}
+	}
+
+	const wallet = new DevWallet(walletConfig);
+	onWalletCreated?.(wallet);
+
+	let unmountUI: (() => void) | undefined;
+	if (mountUI && typeof document !== 'undefined') {
+		const { mountDevWallet } = await import('../ui/mount.js');
+		unmountUI = mountDevWallet(wallet, { container, dockStyle });
+	}
+
+	const unregister = wallet.register();
+
+	return {
+		wallet,
+		dispose() {
+			unmountUI?.();
+			unregister();
+			wallet.destroy();
+		},
+	};
+}

package/dist/standalone/assets/in-memory-adapter-qRkNfj9O.js

@@ -1 +0,0 @@
-import{c as R,d as F,e as U,f as w,k as S,h as E,g as V,s as b,t as x,i as H,K as _,j as u,l as B,P as K,E as C,m as N,B as $,b as v}from"./main-DDltQnzR.js";function z(n,e,t,r){F(n);const i=U({dkLen:32,asyncTick:10},r),{c:s,dkLen:c,asyncTick:o}=i;if(w(s,"c"),w(c,"dkLen"),w(o,"asyncTick"),s<1)throw new Error("iterations (c) must be >= 1");const y=S(e,"password"),d=S(t,"salt"),p=new Uint8Array(c),f=E.create(n,y),a=f._cloneInto().update(d);return{c:s,dkLen:c,asyncTick:o,DK:p,PRF:f,PRFSalt:a}}function M(n,e,t,r,i){return n.destroy(),e.destroy(),r&&r.destroy(),V(i),t}function O(n,e,t,r){const{c:i,dkLen:s,DK:c,PRF:o,PRFSalt:y}=z(n,e,t,r);let d;const p=new Uint8Array(4),f=R(p),a=new Uint8Array(o.outputLen);for(let A=1,m=0;m<s;A++,m+=o.outputLen){const g=c.subarray(m,m+o.outputLen);f.setInt32(0,A,!1),(d=y._cloneInto(d)).update(p).digestInto(a),g.set(a.subarray(0,g.length));for(let k=1;k<i;k++){o._cloneInto(d).update(a).digestInto(a);for(let h=0;h<g.length;h++)g[h]^=a[h]}}return M(o,y,c,d,a)}function T(n){if(typeof n!="string")throw new TypeError("invalid mnemonic type: "+typeof n);return n.normalize("NFKD")}function j(n){const e=T(n),t=e.split(" ");if(![12,15,18,21,24].includes(t.length))throw new Error("Invalid mnemonic");return{nfkd:e,words:t}}const q=n=>T("mnemonic"+n);function W(n,e=""){return O(b,j(n).nfkd,q(e),{c:2048,dkLen:64})}function I(n){return!!new RegExp("^m\\/44'\\/784'\\/[0-9]+'\\/[0-9]+'\\/[0-9]+'+$").test(n)}function Y(n){return W(n,"")}function Z(n){return x(Y(n))}const G="ed25519 seed",J=2147483648,Q=new RegExp("^m(\\/[0-9]+')+$"),L=n=>n.replace("'",""),X=n=>{const e=E.create(b,new TextEncoder().encode(G)).update(H(n)).digest();return{key:e.slice(0,32),chainCode:e.slice(32)}},ee=({key:n,chainCode:e},t)=>{const r=new ArrayBuffer(4);new DataView(r).setUint32(0,t);const i=new Uint8Array(1+n.length+r.byteLength);i.set(new Uint8Array(1).fill(0)),i.set(n,1),i.set(new Uint8Array(r,0,r.byteLength),n.length+1);const s=E.create(b,e).update(i).digest();return{key:s.slice(0,32),chainCode:s.slice(32)}},te=n=>Q.test(n)?!n.split("/").slice(1).map(L).some(isNaN):!1,P=(n,e,t=J)=>{if(!te(n))throw new Error("Invalid derivation path");const{key:r,chainCode:i}=X(e);return n.split("/").slice(1).map(L).map(s=>parseInt(s,10)).reduce((s,c)=>ee(s,c+t),{key:r,chainCode:i})},D="m/44'/784'/0'/0'/0'";var ne=class l extends _{constructor(e){if(super(),e)this.keypair={publicKey:e.publicKey,secretKey:e.secretKey.slice(0,32)};else{const t=u.utils.randomSecretKey();this.keypair={publicKey:u.getPublicKey(t),secretKey:t}}}getKeyScheme(){return"ED25519"}static generate(){const e=u.utils.randomSecretKey();return new l({publicKey:u.getPublicKey(e),secretKey:e})}static fromSecretKey(e,t){if(typeof e=="string"){const s=B(e);if(s.scheme!=="ED25519")throw new Error(`Expected a ED25519 keypair, got ${s.scheme}`);return this.fromSecretKey(s.secretKey,t)}const r=e.length;if(r!==K)throw new Error(`Wrong secretKey size. Expected ${K} bytes, got ${r}.`);const i={publicKey:u.getPublicKey(e),secretKey:e};if(!t||!t.skipValidation){const s=new TextEncoder().encode("sui validation"),c=u.sign(s,e);if(!u.verify(c,s,i.publicKey))throw new Error("provided secretKey is invalid")}return new l(i)}getPublicKey(){return new C(this.keypair.publicKey)}getSecretKey(){return N(this.keypair.secretKey.slice(0,K),this.getKeyScheme())}async sign(e){return u.sign(e,this.keypair.secretKey)}static deriveKeypair(e,t){if(t==null&&(t=D),!I(t))throw new Error("Invalid derivation path");const{key:r}=P(t,Z(e));return l.fromSecretKey(r)}static deriveKeypairFromSeed(e,t){if(t==null&&(t=D),!I(t))throw new Error("Invalid derivation path");const r=typeof e=="string"?e:x(e),{key:i}=P(t,r);return l.fromSecretKey(i)}};class se extends ${constructor(){super(...arguments),this.id="in-memory",this.name="In-Memory Signer"}async initialize(){}async createAccount(e){const t=new ne,r=t.getPublicKey().toSuiAddress(),i=e?.label??this.getDefaultLabel(),s=v(t,r,i);return this.addAccount(s),s}async importAccount(e){const t=e.signer;if(!t)throw new Error("In-memory adapter requires a signer to import");const r=t.toSuiAddress(),i=this.getAccount(r);if(i)return i;const s=e.label??this.getDefaultLabel(),c=v(t,r,s);return this.addAccount(c),c}async renameAccount(e,t){return this._performRename(e,t)}async removeAccount(e){return this.removeAccountByAddress(e)}}export{se as InMemorySignerAdapter};