@mysten-incubation/dev-wallet 0.3.0 → 0.4.0

package/dist/wallet/mount-and-register.mjs

@@ -0,0 +1,46 @@
+import { DevWallet } from "./dev-wallet.mjs";
+//#region src/wallet/mount-and-register.ts
+/**
+* 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.
+*/
+async function mountAndRegisterDevWallet(options) {
+	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) {
+		if (!walletConfig.adapters.some((a) => a.getAccounts().length > 0)) {
+			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;
+	if (mountUI && typeof document !== "undefined") {
+		const { mountDevWallet } = await import("../ui/mount.mjs");
+		unmountUI = mountDevWallet(wallet, {
+			container,
+			dockStyle
+		});
+	}
+	const unregister = wallet.register();
+	return {
+		wallet,
+		dispose() {
+			unmountUI?.();
+			unregister();
+			wallet.destroy();
+		}
+	};
+}
+//#endregion
+export { mountAndRegisterDevWallet };
+
+//# sourceMappingURL=mount-and-register.mjs.map

package/dist/wallet/mount-and-register.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-and-register.mjs","names":[],"sources":["../../src/wallet/mount-and-register.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { DevWalletDockStyle } from '../ui/dev-wallet-panel.js';\nimport { DevWallet, type DevWalletConfig } from './dev-wallet.js';\n\nexport interface MountAndRegisterDevWalletOptions extends DevWalletConfig {\n\t/** Call `adapter.initialize()` on every adapter before registering. Defaults to true. */\n\tautoInitialize?: boolean;\n\t/**\n\t * Create an initial account after initialization when no adapter has any\n\t * accounts (uses the first adapter that supports `createAccount`). Defaults\n\t * to false — most managed/remote adapters (devstack, CLI) bring their own\n\t * accounts and must NOT have a throwaway one fabricated.\n\t */\n\tcreateInitialAccount?: boolean;\n\t/** Mount the floating wallet drawer UI (no-op when `document` is undefined). Defaults to true. */\n\tmountUI?: boolean;\n\t/** Floating dock presentation when `mountUI` is true. */\n\tdockStyle?: DevWalletDockStyle;\n\t/** Container element for the UI drawer. Defaults to `document.body`. */\n\tcontainer?: HTMLElement;\n\t/** Called with the `DevWallet` once constructed, before the UI is mounted\n\t *  and the wallet is registered. */\n\tonWalletCreated?: (wallet: DevWallet) => void;\n}\n\nexport interface MountAndRegisterDevWalletResult {\n\treadonly wallet: DevWallet;\n\t/** Unmount the UI, unregister from wallet-standard, and destroy the wallet (+ adapters). */\n\treadonly dispose: () => void;\n}\n\n/**\n * Construct a {@link DevWallet} from adapters, initialize the adapters, mount\n * the drawer UI, register it with the wallet-standard registry, and return the\n * wallet plus a single `dispose()` that tears all of that down again.\n *\n * This is the imperative \"bring a dev wallet up on the page\" path shared by the\n * React hook (`useDevWallet`), the dApp-Kit initializer (`devWalletInitializer`),\n * and the devstack page-register entry (`src/inject`). Those call sites only\n * differ in HOW they obtain `adapters` / `networks` — the construct → init →\n * mount → register → dispose sequence is identical, so it lives here once.\n */\nexport async function mountAndRegisterDevWallet(\n\toptions: MountAndRegisterDevWalletOptions,\n): Promise<MountAndRegisterDevWalletResult> {\n\tconst {\n\t\tautoInitialize = true,\n\t\tcreateInitialAccount = false,\n\t\tmountUI = true,\n\t\tdockStyle,\n\t\tcontainer,\n\t\tonWalletCreated,\n\t\t...walletConfig\n\t} = options;\n\n\tif (autoInitialize) {\n\t\tawait Promise.all(walletConfig.adapters.map((a) => a.initialize()));\n\t}\n\n\tif (createInitialAccount) {\n\t\tconst hasAccounts = walletConfig.adapters.some((a) => a.getAccounts().length > 0);\n\t\tif (!hasAccounts) {\n\t\t\tconst creatableAdapter = walletConfig.adapters.find(\n\t\t\t\t(a) => a.createAccount && a.getAccounts().length === 0,\n\t\t\t);\n\t\t\tif (creatableAdapter?.createAccount) {\n\t\t\t\tawait creatableAdapter.createAccount({ label: 'Dev Account' });\n\t\t\t}\n\t\t}\n\t}\n\n\tconst wallet = new DevWallet(walletConfig);\n\tonWalletCreated?.(wallet);\n\n\tlet unmountUI: (() => void) | undefined;\n\tif (mountUI && typeof document !== 'undefined') {\n\t\tconst { mountDevWallet } = await import('../ui/mount.js');\n\t\tunmountUI = mountDevWallet(wallet, { container, dockStyle });\n\t}\n\n\tconst unregister = wallet.register();\n\n\treturn {\n\t\twallet,\n\t\tdispose() {\n\t\t\tunmountUI?.();\n\t\t\tunregister();\n\t\t\twallet.destroy();\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;AA4CA,eAAsB,0BACrB,SAC2C;CAC3C,MAAM,EACL,iBAAiB,MACjB,uBAAuB,OACvB,UAAU,MACV,WACA,WACA,iBACA,GAAG,iBACA;CAEJ,IAAI,gBACH,MAAM,QAAQ,IAAI,aAAa,SAAS,KAAK,MAAM,EAAE,WAAW,CAAC,CAAC;CAGnE,IAAI,sBAEH;MAAI,CADgB,aAAa,SAAS,MAAM,MAAM,EAAE,YAAY,CAAC,CAAC,SAAS,CAC1E,GAAa;GACjB,MAAM,mBAAmB,aAAa,SAAS,MAC7C,MAAM,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAC,WAAW,CACtD;GACA,IAAI,kBAAkB,eACrB,MAAM,iBAAiB,cAAc,EAAE,OAAO,cAAc,CAAC;EAE/D;;CAGD,MAAM,SAAS,IAAI,UAAU,YAAY;CACzC,kBAAkB,MAAM;CAExB,IAAI;CACJ,IAAI,WAAW,OAAO,aAAa,aAAa;EAC/C,MAAM,EAAE,mBAAmB,MAAM,OAAO;EACxC,YAAY,eAAe,QAAQ;GAAE;GAAW;EAAU,CAAC;CAC5D;CAEA,MAAM,aAAa,OAAO,SAAS;CAEnC,OAAO;EACN;EACA,UAAU;GACT,YAAY;GACZ,WAAW;GACX,OAAO,QAAQ;EAChB;CACD;AACD"}

package/dist/wallet/signing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"signing.d.mts","names":[],"sources":["../../src/wallet/signing.ts"],"mappings":";;;;KAQK,kBAAA;AAAA,UAKK,qBAAA;EACT,IAAA,EAAM,kBAAA;EACN,MAAA,EAAQ,MAAA;EACR,IAAA,WAAe,UAAA;EACf,MAAA,GAAS,iBAAA;AAAA;AAAA,KAGE,aAAA;EACP,IAAA;EAA+B,KAAA;EAAe,SAAA;AAAA;EAC9C,IAAA;EAA0B,KAAA;EAAe,SAAA;AAAA;EAE3C,IAAA;EACA,KAAA;EACA,SAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,iBAImB,cAAA,CAAA;EACrB,IAAA;EACA,MAAA;EACA,IAAA;EACA;AAAA,GACE,qBAAA,GAAwB,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"signing.d.mts","names":[],"sources":["../../src/wallet/signing.ts"],"mappings":";;;;KAQK,kBAAA;AAAA,UAKK,qBAAA;EACT,IAAA,EAAM,kBAAA;EACN,MAAA,EAAQ,MAAA;EACR,IAAA,WAAe,UAAA;EACf,MAAA,GAAS,iBAAA;AAAA;AAAA,KAGE,aAAA;EACP,IAAA;EAA+B,KAAA;EAAe,SAAA;AAAA;EAC9C,IAAA;EAA0B,KAAA;EAAe,SAAA;AAAA;EAE3C,IAAA;EACA,KAAA;EACA,SAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,iBAImB,cAAA;EACrB,IAAA;EACA,MAAA;EACA,IAAA;EACA;AAAA,GACE,qBAAA,GAAwB,OAAA,CAAQ,aAAA"}

package/dist/wallet/signing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signing.mjs","names":[],"sources":["../../src/wallet/signing.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ClientWithCoreApi } from '@mysten/sui/client';\nimport type { Signer } from '@mysten/sui/cryptography';\nimport { Transaction } from '@mysten/sui/transactions';\nimport { fromBase64, toBase64 } from '@mysten/sui/utils';\n\ntype SigningRequestType =\n\t| 'sign-personal-message'\n\t| 'sign-transaction'\n\t| 'sign-and-execute-transaction';\n\ninterface ExecuteSigningOptions {\n\ttype: SigningRequestType;\n\tsigner: Signer;\n\tdata: string | Uint8Array;\n\tclient?: ClientWithCoreApi;\n}\n\nexport type SigningResult =\n\t| { type: 'sign-personal-message'; bytes: string; signature: string }\n\t| { type: 'sign-transaction'; bytes: string; signature: string }\n\t| {\n\t\t\ttype: 'sign-and-execute-transaction';\n\t\t\tbytes: string;\n\t\t\tsignature: string;\n\t\t\tdigest: string;\n\t\t\teffects: string;\n\t  };\n\n// Shared between the embedded DevWallet and the standalone popup request-handler.\nexport async function executeSigning({\n\ttype,\n\tsigner,\n\tdata,\n\tclient,\n}: ExecuteSigningOptions): Promise<SigningResult> {\n\tswitch (type) {\n\t\tcase 'sign-personal-message': {\n\t\t\tif (!(data instanceof Uint8Array)) {\n\t\t\t\tthrow new Error('sign-personal-message expects data to be a Uint8Array');\n\t\t\t}\n\t\t\tconst { bytes, signature } = await signer.signPersonalMessage(data);\n\t\t\treturn { type, bytes, signature };\n\t\t}\n\t\tcase 'sign-transaction': {\n\t\t\tif (!client) throw new Error('No client provided for sign-transaction');\n\t\t\tif (typeof data !== 'string') {\n\t\t\t\tthrow new Error('sign-transaction expects data to be a JSON string');\n\t\t\t}\n\t\t\tconst tx = Transaction.from(data);\n\t\t\tconst { bytes, signature } = await tx.sign({ client, signer });\n\t\t\treturn { type, bytes, signature };\n\t\t}\n\t\tcase 'sign-and-execute-transaction': {\n\t\t\tif (!client) throw new Error('No client provided for sign-and-execute-transaction');\n\t\t\tif (typeof data !== 'string') {\n\t\t\t\tthrow new Error('sign-and-execute-transaction expects data to be a JSON string');\n\t\t\t}\n\t\t\tconst tx = Transaction.from(data);\n\t\t\tconst { bytes, signature } = await tx.sign({ client, signer });\n\t\t\tconst result = await client.core.executeTransaction({\n\t\t\t\ttransaction: fromBase64(bytes),\n\t\t\t\tsignatures: [signature],\n\t\t\t\tinclude: { effects: true },\n\t\t\t});\n\t\t\tconst txResult = result.Transaction ?? result.FailedTransaction;\n\t\t\tif (!txResult) {\n\t\t\t\tthrow new Error('Transaction execution returned empty result');\n\t\t\t}\n\t\t\tif (!txResult.status.success) {\n\t\t\t\tthrow new Error(txResult.status.error?.message ?? 'Transaction execution failed');\n\t\t\t}\n\t\t\treturn {\n\t\t\t\ttype,\n\t\t\t\tbytes,\n\t\t\t\tsignature,\n\t\t\t\tdigest: txResult.digest,\n\t\t\t\t// Empty string when effects BCS is unavailable — the wallet-standard protocol requires a string\n\t\t\t\teffects: txResult.effects?.bcs ? toBase64(txResult.effects.bcs) : '',\n\t\t\t};\n\t\t}\n\t}\n}\n"],"mappings":";;;AAgCA,eAAsB,eAAe,EACpC,MACA,QACA,MACA,UACiD;AACjD,SAAQ,MAAR;EACC,KAAK,yBAAyB;AAC7B,OAAI,EAAE,gBAAgB,YACrB,OAAM,IAAI,MAAM,wDAAwD;GAEzE,MAAM,EAAE,OAAO,cAAc,MAAM,OAAO,oBAAoB,KAAK;AACnE,UAAO;IAAE;IAAM;IAAO;IAAW;;EAElC,KAAK,oBAAoB;AACxB,OAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,0CAA0C;AACvE,OAAI,OAAO,SAAS,SACnB,OAAM,IAAI,MAAM,oDAAoD;GAGrE,MAAM,EAAE,OAAO,cAAc,MADlB,YAAY,KAAK,KACO,CAAG,KAAK;IAAE;IAAQ;IAAQ,CAAC;AAC9D,UAAO;IAAE;IAAM;IAAO;IAAW;;EAElC,KAAK,gCAAgC;AACpC,OAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,sDAAsD;AACnF,OAAI,OAAO,SAAS,SACnB,OAAM,IAAI,MAAM,gEAAgE;GAGjF,MAAM,EAAE,OAAO,cAAc,MADlB,YAAY,KAAK,KACO,CAAG,KAAK;IAAE;IAAQ;IAAQ,CAAC;GAC9D,MAAM,SAAS,MAAM,OAAO,KAAK,mBAAmB;IACnD,aAAa,WAAW,MAAM;IAC9B,YAAY,CAAC,UAAU;IACvB,SAAS,EAAE,SAAS,MAAM;IAC1B,CAAC;GACF,MAAM,WAAW,OAAO,eAAe,OAAO;AAC9C,OAAI,CAAC,SACJ,OAAM,IAAI,MAAM,8CAA8C;AAE/D,OAAI,CAAC,SAAS,OAAO,QACpB,OAAM,IAAI,MAAM,SAAS,OAAO,OAAO,WAAW,+BAA+B;AAElF,UAAO;IACN;IACA;IACA;IACA,QAAQ,SAAS;IAEjB,SAAS,SAAS,SAAS,MAAM,SAAS,SAAS,QAAQ,IAAI,GAAG;IAClE"}
+{"version":3,"file":"signing.mjs","names":[],"sources":["../../src/wallet/signing.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ClientWithCoreApi } from '@mysten/sui/client';\nimport type { Signer } from '@mysten/sui/cryptography';\nimport { Transaction } from '@mysten/sui/transactions';\nimport { fromBase64, toBase64 } from '@mysten/sui/utils';\n\ntype SigningRequestType =\n\t| 'sign-personal-message'\n\t| 'sign-transaction'\n\t| 'sign-and-execute-transaction';\n\ninterface ExecuteSigningOptions {\n\ttype: SigningRequestType;\n\tsigner: Signer;\n\tdata: string | Uint8Array;\n\tclient?: ClientWithCoreApi;\n}\n\nexport type SigningResult =\n\t| { type: 'sign-personal-message'; bytes: string; signature: string }\n\t| { type: 'sign-transaction'; bytes: string; signature: string }\n\t| {\n\t\t\ttype: 'sign-and-execute-transaction';\n\t\t\tbytes: string;\n\t\t\tsignature: string;\n\t\t\tdigest: string;\n\t\t\teffects: string;\n\t  };\n\n// Shared between the embedded DevWallet and the standalone popup request-handler.\nexport async function executeSigning({\n\ttype,\n\tsigner,\n\tdata,\n\tclient,\n}: ExecuteSigningOptions): Promise<SigningResult> {\n\tswitch (type) {\n\t\tcase 'sign-personal-message': {\n\t\t\tif (!(data instanceof Uint8Array)) {\n\t\t\t\tthrow new Error('sign-personal-message expects data to be a Uint8Array');\n\t\t\t}\n\t\t\tconst { bytes, signature } = await signer.signPersonalMessage(data);\n\t\t\treturn { type, bytes, signature };\n\t\t}\n\t\tcase 'sign-transaction': {\n\t\t\tif (!client) throw new Error('No client provided for sign-transaction');\n\t\t\tif (typeof data !== 'string') {\n\t\t\t\tthrow new Error('sign-transaction expects data to be a JSON string');\n\t\t\t}\n\t\t\tconst tx = Transaction.from(data);\n\t\t\tconst { bytes, signature } = await tx.sign({ client, signer });\n\t\t\treturn { type, bytes, signature };\n\t\t}\n\t\tcase 'sign-and-execute-transaction': {\n\t\t\tif (!client) throw new Error('No client provided for sign-and-execute-transaction');\n\t\t\tif (typeof data !== 'string') {\n\t\t\t\tthrow new Error('sign-and-execute-transaction expects data to be a JSON string');\n\t\t\t}\n\t\t\tconst tx = Transaction.from(data);\n\t\t\tconst { bytes, signature } = await tx.sign({ client, signer });\n\t\t\tconst result = await client.core.executeTransaction({\n\t\t\t\ttransaction: fromBase64(bytes),\n\t\t\t\tsignatures: [signature],\n\t\t\t\tinclude: { effects: true },\n\t\t\t});\n\t\t\tconst txResult = result.Transaction ?? result.FailedTransaction;\n\t\t\tif (!txResult) {\n\t\t\t\tthrow new Error('Transaction execution returned empty result');\n\t\t\t}\n\t\t\tif (!txResult.status.success) {\n\t\t\t\tthrow new Error(txResult.status.error?.message ?? 'Transaction execution failed');\n\t\t\t}\n\t\t\treturn {\n\t\t\t\ttype,\n\t\t\t\tbytes,\n\t\t\t\tsignature,\n\t\t\t\tdigest: txResult.digest,\n\t\t\t\t// Empty string when effects BCS is unavailable — the wallet-standard protocol requires a string\n\t\t\t\teffects: txResult.effects?.bcs ? toBase64(txResult.effects.bcs) : '',\n\t\t\t};\n\t\t}\n\t}\n}\n"],"mappings":";;;AAgCA,eAAsB,eAAe,EACpC,MACA,QACA,MACA,UACiD;CACjD,QAAQ,MAAR;EACC,KAAK,yBAAyB;GAC7B,IAAI,EAAE,gBAAgB,aACrB,MAAM,IAAI,MAAM,uDAAuD;GAExE,MAAM,EAAE,OAAO,cAAc,MAAM,OAAO,oBAAoB,IAAI;GAClE,OAAO;IAAE;IAAM;IAAO;GAAU;EACjC;EACA,KAAK,oBAAoB;GACxB,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,yCAAyC;GACtE,IAAI,OAAO,SAAS,UACnB,MAAM,IAAI,MAAM,mDAAmD;GAGpE,MAAM,EAAE,OAAO,cAAc,MADlB,YAAY,KAAK,IACO,CAAA,CAAG,KAAK;IAAE;IAAQ;GAAO,CAAC;GAC7D,OAAO;IAAE;IAAM;IAAO;GAAU;EACjC;EACA,KAAK,gCAAgC;GACpC,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,qDAAqD;GAClF,IAAI,OAAO,SAAS,UACnB,MAAM,IAAI,MAAM,+DAA+D;GAGhF,MAAM,EAAE,OAAO,cAAc,MADlB,YAAY,KAAK,IACO,CAAA,CAAG,KAAK;IAAE;IAAQ;GAAO,CAAC;GAC7D,MAAM,SAAS,MAAM,OAAO,KAAK,mBAAmB;IACnD,aAAa,WAAW,KAAK;IAC7B,YAAY,CAAC,SAAS;IACtB,SAAS,EAAE,SAAS,KAAK;GAC1B,CAAC;GACD,MAAM,WAAW,OAAO,eAAe,OAAO;GAC9C,IAAI,CAAC,UACJ,MAAM,IAAI,MAAM,6CAA6C;GAE9D,IAAI,CAAC,SAAS,OAAO,SACpB,MAAM,IAAI,MAAM,SAAS,OAAO,OAAO,WAAW,8BAA8B;GAEjF,OAAO;IACN;IACA;IACA;IACA,QAAQ,SAAS;IAEjB,SAAS,SAAS,SAAS,MAAM,SAAS,SAAS,QAAQ,GAAG,IAAI;GACnE;EACD;CACD;AACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mysten-incubation/dev-wallet",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "A modular dev wallet for Sui",
   "license": "Apache-2.0",
   "author": "Mysten Labs <build@mystenlabs.com>",
@@ -19,6 +19,10 @@
       "types": "./dist/adapters/browser.d.mts",
       "import": "./dist/adapters/browser.mjs"
     },
+    "./inject": {
+      "types": "./dist/inject/index.d.mts",
+      "import": "./dist/inject/index.mjs"
+    },
     "./ui": {
       "types": "./dist/ui/index.d.mts",
       "import": "./dist/ui/index.mjs"
@@ -63,34 +67,34 @@
   "homepage": "https://github.com/MystenLabs/ts-sdks-incubation/tree/main/packages/dev-wallet#readme",
   "devDependencies": {
     "@lit/react": "^1.0.8",
-    "@mysten/signers": "^1.0.1",
-    "@mysten/sui": "^2.17.0",
+    "@mysten/signers": "^1.1.0",
+    "@mysten/sui": "^2.18.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.1",
-    "@types/node": "^25.0.8",
-    "@types/react": "^19.2.8",
-    "@vitest/browser": "^4.1.6",
-    "@vitest/browser-playwright": "^4.1.6",
-    "happy-dom": "^20.1.0",
-    "playwright": "*",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "typescript": "^5.9.3",
-    "vite": "^7.3.1",
-    "vitest": "^4.1.6"
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
+    "@vitest/browser": "^4.1.8",
+    "@vitest/browser-playwright": "^4.1.8",
+    "happy-dom": "^20.10.3",
+    "playwright": "^1.60.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.16",
+    "vitest": "^4.1.8"
   },
   "dependencies": {
-    "@hono/node-server": "^1.19.9",
-    "@mysten/utils": "^0.3.1",
-    "@mysten/wallet-sdk": "^0.1.1",
-    "@mysten/wallet-standard": "^0.20.1",
-    "@mysten/window-wallet-core": "^0.1.4",
-    "hono": "^4.12.3",
-    "lit": "^3.3.2"
+    "@hono/node-server": "^2.0.4",
+    "@mysten/utils": "^0.4.0",
+    "@mysten/wallet-sdk": "^0.4.0",
+    "@mysten/wallet-standard": "^0.21.0",
+    "@mysten/window-wallet-core": "^0.2.0",
+    "hono": "^4.12.25",
+    "lit": "^3.3.3"
   },
   "peerDependencies": {
     "@lit/react": "^1.0.8",
-    "@mysten/signers": "^1.0.1",
+    "@mysten/signers": "^1.1.0",
     "@mysten/sui": "^2.17.0",
     "@types/react": ">=17.0.0",
     "react": ">=17.0.0"

package/src/index.ts

@@ -2,6 +2,11 @@
 // SPDX-License-Identifier: Apache-2.0
 
 export { DevWallet, DEFAULT_NETWORK_URLS } from './wallet/dev-wallet.js';
+export { mountAndRegisterDevWallet } from './wallet/mount-and-register.js';
+export type {
+	MountAndRegisterDevWalletOptions,
+	MountAndRegisterDevWalletResult,
+} from './wallet/mount-and-register.js';
 export { devWalletInitializer } from './wallet/initializer.js';
 export type { DevWalletInitializerConfig } from './wallet/initializer.js';
 export type { SigningResult } from './wallet/signing.js';

package/src/inject/index.ts

@@ -0,0 +1,183 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+//
+// Page-register entry for the devstack dev wallet.
+//
+// This is the single function the devstack Vite plugin injects into a dev
+// page. It builds the token-based `DevstackSignerAdapter` (headless — signs
+// over HTTP, no popup) + the routed-RPC network map, then hands those to the
+// shared `mountAndRegisterDevWallet` core helper, which constructs the
+// `DevWallet`, registers it via wallet-standard (so dApp Kit auto-discovers
+// it), and mounts the floating wallet UI. The ONLY logic that lives here is
+// the devstack-integration glue: the adapter-from-config and the routed-RPC
+// network map.
+//
+// The wallet does NOT pre-connect or seed dApp Kit storage: a fresh page
+// loads disconnected, dApp Kit's own `autoConnect` only re-connects a genuine
+// prior session, and the Playwright `connectAs` helper performs an explicit
+// connection through dApp Kit's public API. That test bridge is registered
+// app-side via `@mysten-incubation/devstack/dapp-kit`'s
+// `registerDAppKitForTesting(dAppKit)` (DEV-only) — it needs the app's dApp
+// Kit instance, which the wallet has no reference to.
+
+import type { AutoApprovePolicy, DevWallet } from '../wallet/dev-wallet.js';
+import { mountAndRegisterDevWallet } from '../wallet/mount-and-register.js';
+import { DevstackSignerAdapter } from '../adapters/devstack-adapter.js';
+import { WebCryptoSignerAdapter } from '../adapters/webcrypto-adapter.js';
+
+/** Shape of a single entry in the generated `accounts` map
+ *  (`generated-extras/accounts.ts`). Only `address` is consumed here. */
+export interface DevstackAccountInfo {
+	readonly address: string;
+	readonly name?: string;
+}
+
+export interface RegisterDevstackDevWalletConfig {
+	/** Wallet-app origin (`devWallet.walletUrl`). */
+	readonly serverOrigin: string;
+	/** Bearer token (`parseDevstackToken(devWallet.pairUrl)`), or null. */
+	readonly token?: string | null;
+	/** Generated name→account map (`accounts` from `generated-extras/accounts.ts`). */
+	readonly accounts: Readonly<Record<string, DevstackAccountInfo>>;
+	/** RPC endpoint the wallet uses to execute `signAndExecuteTransaction`
+	 *  (and simulate). MUST be the SAME routed RPC the app's dApp Kit client
+	 *  uses (`config.networks[config.network].rpc`) — a raw `127.0.0.1:9000`
+	 *  is CORS-blocked from the routed page origin. When omitted the wallet
+	 *  falls back to localnet defaults (only correct for non-routed setups). */
+	readonly rpcUrl?: string;
+	/** Network name the wallet's accounts are scoped to (e.g. `'localnet'`
+	 *  from `devWallet.network`). The wallet advertises the wallet-standard
+	 *  chain `sui:<network>` derived from it; defaults to `localnet`. */
+	readonly network?: string;
+	/** Auto-approve all signing requests (headless e2e). Defaults to false. */
+	readonly autoApprove?: AutoApprovePolicy;
+	/** Mount the floating wallet drawer UI. Defaults to true. */
+	readonly mountUI?: boolean;
+	/** Wallet display name. Defaults to `'Devstack'`. */
+	readonly name?: string;
+}
+
+export interface RegisterDevstackDevWalletResult {
+	readonly wallet: DevWallet;
+	/** Unregister the wallet, unmount the UI, and tear down the adapter. */
+	readonly dispose: () => void;
+}
+
+/** Global marker so tests / the plugin can assert injection happened. */
+declare global {
+	// eslint-disable-next-line no-var
+	var __DEV_WALLET_INJECTED__: boolean | undefined;
+	/** In-flight (or settled) registration promise. Published BEFORE the first
+	 *  `await` so concurrent evaluations (HMR / double import) coalesce onto a
+	 *  single registration instead of each constructing + registering + mounting
+	 *  their own wallet. See `registerDevstackDevWallet`. */
+	// eslint-disable-next-line no-var
+	var __devstackDevWalletPromise__: Promise<RegisterDevstackDevWalletResult> | undefined;
+}
+
+/**
+ * Construct + register the devstack dev wallet on the current page and wire
+ * the Playwright `connectAs` slot. Idempotent: a second call is a no-op and
+ * returns the existing instance.
+ *
+ * Idempotency is enforced SYNCHRONOUSLY: an in-flight registration promise is
+ * published on `globalThis.__devstackDevWalletPromise__` before the first
+ * `await`, so two evaluations that race in before the first one finishes both
+ * resolve to the SAME wallet instead of double-registering.
+ */
+export function registerDevstackDevWallet(
+	config: RegisterDevstackDevWalletConfig,
+): Promise<RegisterDevstackDevWalletResult> {
+	const g = globalThis as {
+		__devstackDevWallet__?: RegisterDevstackDevWalletResult;
+		__devstackDevWalletPromise__?: Promise<RegisterDevstackDevWalletResult>;
+	};
+	// Fast path: a prior call already completed.
+	if (g.__devstackDevWallet__ !== undefined) return Promise.resolve(g.__devstackDevWallet__);
+	// In-flight path: a prior call is still booting — share its promise. This
+	// guard runs before any `await`, so it closes the double-init window that a
+	// post-registration-only marker leaves open under HMR / double import.
+	if (g.__devstackDevWalletPromise__ !== undefined) return g.__devstackDevWalletPromise__;
+
+	const promise = registerDevstackDevWalletImpl(config);
+	g.__devstackDevWalletPromise__ = promise;
+	// On failure, clear the in-flight promise so a later call can retry instead
+	// of being stuck awaiting a rejected registration.
+	promise.catch(() => {
+		if (g.__devstackDevWalletPromise__ === promise) {
+			g.__devstackDevWalletPromise__ = undefined;
+		}
+	});
+	return promise;
+}
+
+async function registerDevstackDevWalletImpl(
+	config: RegisterDevstackDevWalletConfig,
+): Promise<RegisterDevstackDevWalletResult> {
+	const { mountUI = true, autoApprove = false } = config;
+	globalThis.__DEV_WALLET_INJECTED__ = true;
+
+	const adapter = new DevstackSignerAdapter({
+		serverOrigin: config.serverOrigin,
+		token: config.token ?? null,
+		name: config.name ?? 'Devstack',
+	});
+
+	// The wallet EXECUTES (and simulates) `signAndExecuteTransaction` with
+	// its OWN client — adapter signing is HTTP (server-side keys), but
+	// execution goes through the wallet's network client. That client MUST
+	// hit the same routed RPC the app's dApp Kit uses (a raw 127.0.0.1 RPC
+	// is CORS-blocked from the routed page origin).
+	//
+	// Expose a SINGLE network — the active stack's — so the wallet's network
+	// switcher shows one entry that matches dApp Kit, not a list of unused
+	// devnet/testnet/mainnet. `mountAndRegisterDevWallet` advertises the
+	// wallet-standard chain `sui:<network>` derived from this key, matching the
+	// `sui:<network>` dApp Kit forwards for signing — the `sui:` prefix lives
+	// only here, at the wallet-standard boundary.
+	const rpcUrl = config.rpcUrl ?? 'http://127.0.0.1:9000';
+	const activeNetwork = config.network ?? 'localnet';
+	const networks: Record<string, string> = { [activeNetwork]: rpcUrl };
+
+	// Delegate the construct → init-adapter → mount-UI → register → dispose
+	// sequence to the shared dev-wallet core helper. Two adapters: the
+	// `DevstackSignerAdapter` brings the stack's server-resolved accounts
+	// (alice/bob/carol — headless HTTP signing), and a `WebCryptoSignerAdapter`
+	// lets the user create their OWN accounts in the wallet UI, persisted in
+	// IndexedDB across reloads (non-extractable WebCrypto keys, NOT in-memory).
+	// `createInitialAccount` stays off — the devstack adapter already supplies
+	// accounts, so we never fabricate a throwaway key; the WebCrypto adapter
+	// starts empty until the user adds one.
+	const { wallet, dispose: disposeWallet } = await mountAndRegisterDevWallet({
+		adapters: [adapter, new WebCryptoSignerAdapter()],
+		name: config.name ?? 'Devstack',
+		autoApprove,
+		// Auto-approve `standard:connect` whenever signing is auto-approved — both
+		// are the headless-e2e signal (`DEVSTACK_AUTO_APPROVE`). The test bridge's
+		// explicit `connectWallet(...)` invokes the wallet's connect; without this
+		// it would queue a pending request and block on UI approval that never
+		// comes. In normal dev (no auto-approve) a human approves the connect.
+		autoConnect: Boolean(autoApprove),
+		networks,
+		activeNetwork,
+		mountUI,
+	});
+
+	const result: RegisterDevstackDevWalletResult = {
+		wallet,
+		dispose() {
+			disposeWallet();
+			globalThis.__DEV_WALLET_INJECTED__ = false;
+			delete (globalThis as { __devstackDevWallet__?: unknown }).__devstackDevWallet__;
+			// Clear the in-flight/settled registration promise too, so a
+			// subsequent `registerDevstackDevWallet` re-initializes rather than
+			// handing back the disposed instance.
+			delete (globalThis as { __devstackDevWalletPromise__?: unknown })
+				.__devstackDevWalletPromise__;
+		},
+	};
+	(
+		globalThis as { __devstackDevWallet__?: RegisterDevstackDevWalletResult }
+	).__devstackDevWallet__ = result;
+	return result;
+}

package/src/react/useDevWallet.ts

@@ -3,21 +3,15 @@
 
 import { useEffect, useMemo, useRef, useState } from 'react';
 
-import { mountDevWallet } from '../ui/mount.js';
-import type { DevWalletDockStyle } from '../ui/dev-wallet-panel.js';
-import { DevWallet, type DevWalletConfig } from '../wallet/dev-wallet.js';
+import type { DevWallet } from '../wallet/dev-wallet.js';
+import {
+	mountAndRegisterDevWallet,
+	type MountAndRegisterDevWalletOptions,
+} from '../wallet/mount-and-register.js';
 
-export interface UseDevWalletOptions extends DevWalletConfig {
-	/** Whether to call adapter.initialize() automatically. Defaults to true. */
-	autoInitialize?: boolean;
+export interface UseDevWalletOptions extends MountAndRegisterDevWalletOptions {
 	/** Whether to create an initial account after initialization (if adapter supports it). Defaults to true. */
 	createInitialAccount?: boolean;
-	/** Whether to mount the floating wallet drawer UI. Defaults to true. */
-	mountUI?: boolean;
-	/** Floating dock presentation when `mountUI` is true. Defaults to `corner-pill`. */
-	dockStyle?: DevWalletDockStyle;
-	/** Container element for the UI drawer. Defaults to document.body. */
-	container?: HTMLElement;
 }
 
 export interface UseDevWalletResult {
@@ -50,71 +44,32 @@ export function useDevWallet(options: UseDevWalletOptions): UseDevWalletResult {
 	optionsRef.current = options;
 
 	useEffect(() => {
-		const {
-			autoInitialize = true,
-			createInitialAccount = true,
-			mountUI = true,
-			dockStyle,
-			container,
-			...walletConfig
-		} = optionsRef.current;
-
 		let cancelled = false;
-		let unregister: (() => void) | undefined;
-		let unmountUI: (() => void) | undefined;
-
-		let devWallet: DevWallet;
-		try {
-			devWallet = new DevWallet(walletConfig);
-		} catch (err) {
-			setError(err instanceof Error ? err : new Error(String(err)));
-			setLoading(false);
-			return;
-		}
-
-		async function setup() {
-			if (autoInitialize) {
-				await Promise.all(walletConfig.adapters.map((a) => a.initialize()));
-			}
-			if (cancelled) return;
-
-			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' });
-					}
+		let dispose: (() => void) | undefined;
+
+		// The hook keeps `createInitialAccount` defaulting to TRUE: its typical
+		// adapters (WebCrypto / InMemory) start empty and need a starter account,
+		// whereas the core helper defaults it off for managed/remote adapters.
+		mountAndRegisterDevWallet({ createInitialAccount: true, ...optionsRef.current })
+			.then((result) => {
+				if (cancelled) {
+					result.dispose();
+					return;
 				}
-			}
-			if (cancelled) return;
-
-			unregister = devWallet.register();
-
-			if (mountUI && typeof document !== 'undefined') {
-				unmountUI = mountDevWallet(devWallet, { container, dockStyle });
-			}
-
-			if (!cancelled) {
-				setWallet(devWallet);
+				dispose = result.dispose;
+				setWallet(result.wallet);
 				setLoading(false);
-			}
-		}
-
-		setup().catch((err) => {
-			if (!cancelled) {
-				setError(err instanceof Error ? err : new Error(String(err)));
-				setLoading(false);
-			}
-		});
+			})
+			.catch((err) => {
+				if (!cancelled) {
+					setError(err instanceof Error ? err : new Error(String(err)));
+					setLoading(false);
+				}
+			});
 
 		return () => {
 			cancelled = true;
-			unmountUI?.();
-			unregister?.();
-			devWallet.destroy();
+			dispose?.();
 		};
 	}, []); // eslint-disable-line react-hooks/exhaustive-deps
 

package/src/ui/dev-wallet-signing.ts

@@ -596,6 +596,8 @@ export class DevWalletSigning extends LitElement {
 				return `${arg.bytes.slice(0, 16)}${arg.bytes.length > 16 ? '...' : ''}`;
 			case 'Object':
 				return formatAddress(arg.object.objectId);
+			case 'Withdrawal':
+				return `Withdraw ${arg.amount} ${getCoinSymbol(arg.coinType)} from ${arg.withdrawFrom}`;
 			case 'Unknown':
 				return 'unknown';
 		}

package/src/wallet/dev-wallet.ts

@@ -115,12 +115,19 @@ export class DevWallet implements Wallet {
 	readonly #clientFactory: (network: string, url: string) => ClientWithCoreApi;
 	readonly #persistNetworks: boolean;
 	#accounts: ReadonlyWalletAccount[];
+	#selectedAddress: string | null = null;
 	#events: Emitter<WalletEventsMap>;
 	#unsubscribeAdapters: (() => void)[];
 	#pendingRequest: WalletRequest | null;
 	#requestListeners: Set<(request: PendingSigningRequest | null) => void>;
 	#pendingConnect: ConnectRequest | null;
 	#connectListeners: Set<(request: PendingConnectRequest | null) => void>;
+	/** Fired every time a dApp invokes `standard:connect` (the wallet's
+	 *  authoritative "a dApp is connecting" signal). Distinct from
+	 *  `#connectListeners`, which track the *pending-request* lifecycle for the
+	 *  approval UI. Consumers (e.g. the inject's `selectAccount`) use this to
+	 *  observe that the dApp has reached the wallet rather than racing a timer. */
+	#connectedListeners: Set<() => void>;
 	#destroyed = false;
 
 	constructor(config: DevWalletConfig) {
@@ -145,6 +152,7 @@ export class DevWallet implements Wallet {
 		this.#requestListeners = new Set();
 		this.#pendingConnect = null;
 		this.#connectListeners = new Set();
+		this.#connectedListeners = new Set();
 
 		this.#setupAdapterListeners();
 	}
@@ -166,7 +174,42 @@ export class DevWallet implements Wallet {
 	}
 
 	get accounts(): readonly ReadonlyWalletAccount[] {
-		return this.#accounts;
+		return this.#exposedAccounts();
+	}
+
+	/**
+	 * Narrow the accounts this wallet exposes to dApps (via the
+	 * wallet-standard `accounts` array + `change` events) to a single
+	 * address, or pass `null` to expose all aggregated accounts again.
+	 *
+	 * Used by the devstack page-register entry to drive headless account
+	 * selection: dApp Kit reflects the `change` event by switching its
+	 * connected account to the now-single exposed account (or, if not yet
+	 * connected, auto-connects to it). No reference to the app's dApp Kit
+	 * instance is required — selection rides the wallet-standard protocol.
+	 */
+	setSelectedAccount(address: string | null): void {
+		if (address !== null) {
+			const match = this.#accounts.find((a) => a.address.toLowerCase() === address.toLowerCase());
+			if (match === undefined) {
+				const available = this.#accounts.map((a) => a.address).join(', ');
+				throw new Error(
+					`No dev-wallet account for address "${address}". Available: ${available || '(none)'}`,
+				);
+			}
+			this.#selectedAddress = match.address;
+		} else {
+			this.#selectedAddress = null;
+		}
+		this.#events.emit('change', { accounts: this.#exposedAccounts() });
+	}
+
+	/** Accounts exposed to dApps — narrowed to the selected address when set. */
+	#exposedAccounts(): ReadonlyWalletAccount[] {
+		if (this.#selectedAddress === null) return this.#accounts;
+		return this.#accounts.filter(
+			(a) => a.address.toLowerCase() === this.#selectedAddress!.toLowerCase(),
+		);
 	}
 
 	get features(): StandardConnectFeature &
@@ -311,6 +354,7 @@ export class DevWallet implements Wallet {
 		}
 		this.#requestListeners.clear();
 		this.#connectListeners.clear();
+		this.#connectedListeners.clear();
 		this.#events.all.clear();
 	}
 
@@ -410,6 +454,29 @@ export class DevWallet implements Wallet {
 		}
 	}
 
+	/**
+	 * Subscribe to the "a dApp invoked `standard:connect`" edge. Returns an
+	 * unsubscribe function. Used by the page-register entry to gate its
+	 * narrow→widen account-selection on an OBSERVED connect rather than a fixed
+	 * timer (see `src/inject/index.ts`).
+	 */
+	onDAppConnected(callback: () => void): () => void {
+		this.#connectedListeners.add(callback);
+		return () => {
+			this.#connectedListeners.delete(callback);
+		};
+	}
+
+	#notifyConnectedListeners() {
+		for (const listener of this.#connectedListeners) {
+			try {
+				listener();
+			} catch (error) {
+				console.error('[dev-wallet] onDAppConnected listener threw:', error);
+			}
+		}
+	}
+
 	#aggregateAccounts(): ReadonlyWalletAccount[] {
 		return this.#adapters.flatMap((a) => a.getAccounts().map((acc) => acc.walletAccount));
 	}
@@ -418,7 +485,7 @@ export class DevWallet implements Wallet {
 		for (const adapter of this.#adapters) {
 			const unsub = adapter.onAccountsChanged(() => {
 				this.#accounts = this.#aggregateAccounts();
-				this.#events.emit('change', { accounts: this.#accounts });
+				this.#events.emit('change', { accounts: this.#exposedAccounts() });
 			});
 			this.#unsubscribeAdapters.push(unsub);
 		}
@@ -430,6 +497,12 @@ export class DevWallet implements Wallet {
 	};
 
 	#connect: StandardConnectMethod = async () => {
+		// Notify observers that a dApp has invoked `standard:connect`. This is
+		// the wallet's authoritative "a dApp reached us" edge — fired before we
+		// branch on auto/queued so it covers both the silent auto-connect path
+		// and an interactive connect.
+		this.#notifyConnectedListeners();
+
 		// Auto-connect: return all accounts immediately
 		if (this.#autoConnect) {
 			return { accounts: this.accounts };