@mysten-incubation/dev-wallet 0.0.0

package/README.md

@@ -0,0 +1,250 @@
+# @mysten-incubation/dev-wallet
+
+A development-only wallet for building and testing Sui dApps.
+
+> [!WARNING] This wallet is for development and testing only. Do not use it to store real funds. A
+> console warning is emitted automatically in production builds.
+
+> [!CAUTION] **Pre-1.0:** This package is under active development. Minor versions may contain
+> breaking changes until the API stabilizes at 1.0.
+
+## Why use a dev wallet?
+
+- **Localnet and custom networks** — production wallets don't connect to localnet. This wallet
+  connects to any network URL you give it.
+- **Separate from mainnet credentials** — your dev keys never touch your real wallet. Ephemeral keys
+  disappear on page refresh; persistent keys stay scoped to the browser.
+- **E2E testing without manual approval** — set `autoApprove: true` and the wallet signs
+  automatically. No click-through, no popups, works in headless CI.
+- **Preserve assets across page loads** — use the WebCrypto adapter and your faucet coins survive
+  browser refresh.
+- **No browser extension required** — embed the wallet directly in your app. Perfect for demos,
+  tutorials, and hackathons where asking users to install a wallet extension is friction.
+- **Same account you publish contracts from** — connect to the `sui` CLI and sign transactions with
+  the same address that ran `sui move publish`, so you can access AdminCap and other owned objects.
+- **Works across multiple apps** — run the wallet as a standalone web app and connect any number of
+  dApps to it via popup.
+
+## Installation
+
+```bash
+npm install @mysten-incubation/dev-wallet
+```
+
+## Quick start
+
+A single `devWalletInitializer` call covers most use cases. Tweak the options for your scenario:
+
+```typescript
+import { createDAppKit } from '@mysten/dapp-kit-react';
+import { devWalletInitializer } from '@mysten-incubation/dev-wallet';
+import { WebCryptoSignerAdapter } from '@mysten-incubation/dev-wallet/adapters';
+
+const dAppKit = createDAppKit({
+	networks: ['devnet', 'testnet', 'localnet'],
+	walletInitializers: [
+		devWalletInitializer({
+			// Keys persist in IndexedDB — faucet once, keep your coins across reloads
+			adapters: [new WebCryptoSignerAdapter()],
+			// Skip the wallet picker — connect immediately on load
+			autoConnect: true,
+			// Show the floating wallet panel (accounts, balances, objects)
+			mountUI: true,
+			// Auto-create an account on first visit (default: true)
+			createInitialAccount: true,
+			// Sign without approval modals — great for E2E tests and CI
+			// autoApprove: true,
+		}),
+	],
+});
+```
+
+## Pick your setup
+
+### dApp Kit plugin (easiest)
+
+If your app uses `@mysten/dapp-kit-react`, embed the wallet directly. It inherits your dApp Kit
+network config automatically.
+
+```typescript
+import { createDAppKit } from '@mysten/dapp-kit-react';
+import { devWalletInitializer } from '@mysten-incubation/dev-wallet';
+import { WebCryptoSignerAdapter } from '@mysten-incubation/dev-wallet/adapters';
+
+const dAppKit = createDAppKit({
+	networks: ['devnet', 'testnet', 'localnet'],
+	walletInitializers: [
+		devWalletInitializer({
+			adapters: [new WebCryptoSignerAdapter()],
+			autoConnect: true,
+			mountUI: true,
+		}),
+	],
+});
+```
+
+The wallet appears in the dApp Kit wallet picker. An initial account is created automatically.
+
+### Standalone wallet
+
+Run a self-contained wallet as a separate web app — signing works via popup, same as a production
+browser wallet.
+
+```bash
+npx @mysten-incubation/dev-wallet serve
+```
+
+Register it through `walletInitializers` using `devWalletClientInitializer`:
+
+```typescript
+import { createDAppKit } from '@mysten/dapp-kit-react';
+import { devWalletClientInitializer } from '@mysten-incubation/dev-wallet/client';
+
+const dAppKit = createDAppKit({
+	networks: ['devnet'],
+	walletInitializers: [devWalletClientInitializer({ origin: 'http://localhost:5174' })],
+});
+```
+
+Or register directly without dApp Kit:
+
+```typescript
+import { DevWalletClient } from '@mysten-incubation/dev-wallet/client';
+
+DevWalletClient.register({ origin: 'http://localhost:5174' });
+```
+
+The default port is 5174. Use `--port` to set a different port.
+
+The standalone wallet includes WebCrypto and InMemory adapters by default. If `sui` is on your PATH,
+the CLI adapter is also available — so you can sign with the same address you published contracts
+from. Great for teams, multi-app development, and when you can't modify the dApp source.
+
+### Manual setup (no framework)
+
+If you're not using dApp Kit or React, create and register the wallet directly. Localnet, devnet,
+and testnet are configured out of the box — no URLs needed.
+
+```typescript
+import { DevWallet } from '@mysten-incubation/dev-wallet';
+import { WebCryptoSignerAdapter } from '@mysten-incubation/dev-wallet/adapters';
+import { mountDevWallet } from '@mysten-incubation/dev-wallet/ui';
+
+const adapter = new WebCryptoSignerAdapter();
+await adapter.initialize();
+await adapter.createAccount({ label: 'Dev Account' });
+
+const wallet = new DevWallet({ adapters: [adapter] });
+wallet.register();
+mountDevWallet(wallet);
+```
+
+## Which adapter should I use?
+
+| Adapter                  | Keys stored             | Persists across reload | Best for                                        | Caveats                          |
+| ------------------------ | ----------------------- | ---------------------- | ----------------------------------------------- | -------------------------------- |
+| `InMemorySignerAdapter`  | Memory (Ed25519)        | No                     | Quick prototyping, throwaway tests              | New keys every page load         |
+| `WebCryptoSignerAdapter` | IndexedDB (Secp256r1)   | Yes                    | Persistent dev wallet, keeping faucet coins     | Browser-scoped, not exportable   |
+| `RemoteCliAdapter`       | `sui` CLI keystore      | Yes (via CLI)          | Using same address you published contracts from | No personal message signing      |
+| `PasskeySignerAdapter`   | OS keychain (Secp256r1) | Yes                    | Testing passkey/biometric flows                 | Requires user gesture every sign |
+
+**Start here:** `WebCryptoSignerAdapter` — keys persist across page reloads, faucet once and keep
+your coins. Best default for development.
+
+**Fully ephemeral:** `InMemorySignerAdapter` — fresh keys every page load. Useful when you
+specifically need a guaranteed clean slate.
+
+**Match your deployed contracts:** `RemoteCliAdapter` — use the same address that ran
+`sui move publish`.
+
+You can use multiple adapters at the same time. The wallet aggregates accounts from all of them:
+
+```typescript
+devWalletInitializer({
+	adapters: [new WebCryptoSignerAdapter(), new InMemorySignerAdapter()],
+	mountUI: true,
+});
+```
+
+## Options reference
+
+Options for `devWalletInitializer` (dApp Kit plugin) and `DevWallet` constructor:
+
+| Option                 | Type                              | Default                   | Description                                                                                   |
+| ---------------------- | --------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------- |
+| `adapters`             | `BaseSignerAdapter[]`             | _(required)_              | Signer adapters that provide accounts and signing                                             |
+| `autoConnect`          | `boolean`                         | `false`                   | Skip wallet picker — connect the first available account on load                              |
+| `autoApprove`          | `boolean \| (request) => boolean` | `false`                   | Sign without showing the approval modal. Pass a function for fine-grained control (see below) |
+| `mountUI`              | `boolean`                         | `false`                   | Show the floating wallet panel (accounts, balances, objects)                                  |
+| `createInitialAccount` | `boolean`                         | `true`                    | Auto-create an account on first visit if the adapter has none                                 |
+| `name`                 | `string`                          | `'Dev Wallet'`            | Wallet name shown in the wallet picker                                                        |
+| `networks`             | `Record<string, string>`          | devnet, testnet, localnet | Custom network URLs (only needed for non-default networks like staging)                       |
+
+### Fine-grained `autoApprove`
+
+Pass a function to approve only specific request types or chains:
+
+```typescript
+devWalletInitializer({
+	adapters: [new WebCryptoSignerAdapter()],
+	autoApprove: (request) => request.type === 'sign-transaction',
+	autoConnect: true,
+});
+```
+
+Note: `RemoteCliAdapter` and `PasskeySignerAdapter` never auto-sign regardless of this setting.
+
+## Using the CLI adapter
+
+The Remote CLI adapter connects to your local `sui` CLI over HTTP. Private keys never leave the
+`sui` binary — only transaction bytes are sent for signing.
+
+The easiest way is the standalone wallet:
+
+```bash
+npx @mysten-incubation/dev-wallet serve
+```
+
+The terminal prints a URL with an auth token (e.g. `http://localhost:5174/?token=abc123`). Open it
+in your browser — the token is saved automatically so popups can authenticate with the CLI signer.
+
+To import a CLI account:
+
+1. Click the **+** button on the Accounts tab (or go to Settings to verify the CLI Signer shows
+   "Connected")
+2. Switch to the **Import** tab in the Add Account dialog
+3. Select the address you want from the list (these come from your `sui` keystore)
+4. Click **Import**
+
+The imported account now appears alongside your other wallet accounts. When a dApp requests a
+signature with that address, the transaction bytes are sent to the local `sui keytool sign` command
+— your private key never leaves the CLI.
+
+> **Note:** The CLI signer supports transaction signing only. Personal message signing
+> (`sui keytool sign` only accepts TransactionData) will show an error. Use a WebCrypto or InMemory
+> account for `signPersonalMessage`.
+
+### Bookmarklet
+
+The standalone wallet also serves a bookmarklet for quick injection into any dApp. You can find it
+in the **Settings** tab — drag it to your bookmarks bar, or copy the console snippet from the
+terminal output. Clicking the bookmarklet on any page registers the standalone wallet without
+needing to modify the dApp's source code.
+
+## Imports
+
+| Import                                   | What you get                                                                                                       |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `@mysten-incubation/dev-wallet`          | `DevWallet`, `devWalletInitializer`, `DEFAULT_NETWORK_URLS`, config types                                          |
+| `@mysten-incubation/dev-wallet/adapters` | `InMemorySignerAdapter`, `WebCryptoSignerAdapter`, `PasskeySignerAdapter`, `RemoteCliAdapter`, `BaseSignerAdapter` |
+| `@mysten-incubation/dev-wallet/ui`       | `mountDevWallet()`, Lit web components                                                                             |
+| `@mysten-incubation/dev-wallet/react`    | `useDevWallet` hook, `DevWalletProvider`, React-wrapped Lit components                                             |
+| `@mysten-incubation/dev-wallet/client`   | `DevWalletClient`, `devWalletClientInitializer` for standalone wallet popup mode                                   |
+| `@mysten-incubation/dev-wallet/server`   | `parseWalletRequest()`, `createCliSigningMiddleware()` for standalone wallet and CLI signing                       |
+
+## Limitations
+
+- **Not for production** — emits a console warning when `NODE_ENV=production`
+- **RemoteCLI cannot sign personal messages** — `sui keytool sign` only supports transaction data
+- **RemoteCLI and Passkey never auto-sign** — they always require explicit interaction, regardless
+  of the `autoApprove` setting

package/dist/_virtual/_@oxc-project_runtime@0.107.0/helpers/decorate.mjs

@@ -0,0 +1,10 @@
+//#region \0@oxc-project+runtime@0.107.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+export { __decorate };

package/dist/adapters/base-adapter.d.mts

@@ -0,0 +1,33 @@
+import { ManagedAccount, SignerAdapter } from "../types.mjs";
+
+//#region src/adapters/base-adapter.d.ts
+/**
+ * Abstract base class implementing the shared boilerplate of {@link SignerAdapter}.
+ *
+ * Subclasses only need to implement `initialize()`, `id`, and `name`.
+ * All account list management, listener notification, and cleanup are handled here.
+ */
+declare abstract class BaseSignerAdapter implements SignerAdapter {
+  #private;
+  abstract readonly id: string;
+  abstract readonly name: string;
+  readonly allowAutoSign: boolean;
+  abstract initialize(): Promise<void>;
+  getAccounts(): ManagedAccount[];
+  getAccount(address: string): ManagedAccount | undefined;
+  onAccountsChanged(callback: (accounts: ManagedAccount[]) => void): () => void;
+  destroy(): void;
+  protected get _accounts(): readonly ManagedAccount[];
+  protected setInitialAccounts(accounts: ManagedAccount[]): void;
+  protected addAccount(account: ManagedAccount): void;
+  protected removeAccountByAddress(address: string): boolean;
+  /** Replace an account by address (e.g. after rename). */
+  protected replaceAccount(address: string, account: ManagedAccount): boolean;
+  /** Rename an account by rebuilding its ManagedAccount with a new label. */
+  protected _performRename(address: string, label: string): boolean;
+  protected getDefaultLabel(): string;
+  protected notifyListeners(): void;
+}
+//#endregion
+export { BaseSignerAdapter };
+//# sourceMappingURL=base-adapter.d.mts.map

package/dist/adapters/base-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.mts","names":[],"sources":["../../src/adapters/base-adapter.ts"],"mappings":";;;;;AAYA;;;;uBAAsB,iBAAA,YAA6B,aAAA;EAAA;oBAChC,EAAA;EAAA,kBACA,IAAA;EAAA,SACT,aAAA;EAAA,SAKA,UAAA,CAAA,GAAc,OAAA;EAEvB,WAAA,CAAA,GAAe,cAAA;EAIf,UAAA,CAAW,OAAA,WAAkB,cAAA;EAI7B,iBAAA,CAAkB,QAAA,GAAW,QAAA,EAAU,cAAA;EAOvC,OAAA,CAAA;EAAA,cAOc,SAAA,CAAA,YAAsB,cAAA;EAAA,UAI1B,kBAAA,CAAmB,QAAA,EAAU,cAAA;EAAA,UAK7B,UAAA,CAAW,OAAA,EAAS,cAAA;EAAA,UAKpB,sBAAA,CAAuB,OAAA;EA3CxB;EAAA,UAoDC,cAAA,CAAe,OAAA,UAAiB,OAAA,EAAS,cAAA;EA/C5B;EAAA,UAwDb,cAAA,CAAe,OAAA,UAAiB,KAAA;EAAA,UAMhC,eAAA,CAAA;EAAA,UAIA,eAAA,CAAA;AAAA"}

package/dist/adapters/base-adapter.mjs

@@ -0,0 +1,77 @@
+import { buildManagedAccount } from "./build-managed-account.mjs";
+
+//#region src/adapters/base-adapter.ts
+/**
+* Abstract base class implementing the shared boilerplate of {@link SignerAdapter}.
+*
+* Subclasses only need to implement `initialize()`, `id`, and `name`.
+* All account list management, listener notification, and cleanup are handled here.
+*/
+var BaseSignerAdapter = class {
+	constructor() {
+		this.allowAutoSign = true;
+	}
+	#accounts = [];
+	#listeners = new Set();
+	getAccounts() {
+		return [...this.#accounts];
+	}
+	getAccount(address) {
+		return this.#accounts.find((account) => account.address === address);
+	}
+	onAccountsChanged(callback) {
+		this.#listeners.add(callback);
+		return () => {
+			this.#listeners.delete(callback);
+		};
+	}
+	destroy() {
+		this.#accounts = [];
+		this.#listeners.clear();
+	}
+	get _accounts() {
+		return this.#accounts;
+	}
+	setInitialAccounts(accounts) {
+		this.#accounts = accounts;
+		this.notifyListeners();
+	}
+	addAccount(account) {
+		this.#accounts.push(account);
+		this.notifyListeners();
+	}
+	removeAccountByAddress(address) {
+		const index = this.#accounts.findIndex((a) => a.address === address);
+		if (index === -1) return false;
+		this.#accounts.splice(index, 1);
+		this.notifyListeners();
+		return true;
+	}
+	/** Replace an account by address (e.g. after rename). */
+	replaceAccount(address, account) {
+		const index = this.#accounts.findIndex((a) => a.address === address);
+		if (index === -1) return false;
+		this.#accounts[index] = account;
+		this.notifyListeners();
+		return true;
+	}
+	/** Rename an account by rebuilding its ManagedAccount with a new label. */
+	_performRename(address, label) {
+		const account = this.getAccount(address);
+		if (!account) return false;
+		return this.replaceAccount(address, buildManagedAccount(account.signer, address, label));
+	}
+	getDefaultLabel() {
+		return `Account ${this.getAccounts().length + 1}`;
+	}
+	notifyListeners() {
+		const accounts = this.getAccounts();
+		for (const listener of this.#listeners) {
+			listener(accounts);
+		}
+	}
+};
+
+//#endregion
+export { BaseSignerAdapter };
+//# sourceMappingURL=base-adapter.mjs.map

package/dist/adapters/base-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.mjs","names":["#accounts","#listeners"],"sources":["../../src/adapters/base-adapter.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ManagedAccount, SignerAdapter } from '../types.js';\nimport { buildManagedAccount } from './build-managed-account.js';\n\n/**\n * Abstract base class implementing the shared boilerplate of {@link SignerAdapter}.\n *\n * Subclasses only need to implement `initialize()`, `id`, and `name`.\n * All account list management, listener notification, and cleanup are handled here.\n */\nexport abstract class BaseSignerAdapter implements SignerAdapter {\n\tabstract readonly id: string;\n\tabstract readonly name: string;\n\treadonly allowAutoSign: boolean = true;\n\n\t#accounts: ManagedAccount[] = [];\n\t#listeners = new Set<(accounts: ManagedAccount[]) => void>();\n\n\tabstract initialize(): Promise<void>;\n\n\tgetAccounts(): ManagedAccount[] {\n\t\treturn [...this.#accounts];\n\t}\n\n\tgetAccount(address: string): ManagedAccount | undefined {\n\t\treturn this.#accounts.find((account) => account.address === address);\n\t}\n\n\tonAccountsChanged(callback: (accounts: ManagedAccount[]) => void): () => void {\n\t\tthis.#listeners.add(callback);\n\t\treturn () => {\n\t\t\tthis.#listeners.delete(callback);\n\t\t};\n\t}\n\n\tdestroy(): void {\n\t\tthis.#accounts = [];\n\t\tthis.#listeners.clear();\n\t}\n\n\t// ── Protected helpers for subclasses ─────────────────────────────────────\n\n\tprotected get _accounts(): readonly ManagedAccount[] {\n\t\treturn this.#accounts;\n\t}\n\n\tprotected setInitialAccounts(accounts: ManagedAccount[]): void {\n\t\tthis.#accounts = accounts;\n\t\tthis.notifyListeners();\n\t}\n\n\tprotected addAccount(account: ManagedAccount): void {\n\t\tthis.#accounts.push(account);\n\t\tthis.notifyListeners();\n\t}\n\n\tprotected removeAccountByAddress(address: string): boolean {\n\t\tconst index = this.#accounts.findIndex((a) => a.address === address);\n\t\tif (index === -1) return false;\n\t\tthis.#accounts.splice(index, 1);\n\t\tthis.notifyListeners();\n\t\treturn true;\n\t}\n\n\t/** Replace an account by address (e.g. after rename). */\n\tprotected replaceAccount(address: string, account: ManagedAccount): boolean {\n\t\tconst index = this.#accounts.findIndex((a) => a.address === address);\n\t\tif (index === -1) return false;\n\t\tthis.#accounts[index] = account;\n\t\tthis.notifyListeners();\n\t\treturn true;\n\t}\n\n\t/** Rename an account by rebuilding its ManagedAccount with a new label. */\n\tprotected _performRename(address: string, label: string): boolean {\n\t\tconst account = this.getAccount(address);\n\t\tif (!account) return false;\n\t\treturn this.replaceAccount(address, buildManagedAccount(account.signer, address, label));\n\t}\n\n\tprotected getDefaultLabel(): string {\n\t\treturn `Account ${this.getAccounts().length + 1}`;\n\t}\n\n\tprotected notifyListeners(): void {\n\t\tconst accounts = this.getAccounts();\n\t\tfor (const listener of this.#listeners) {\n\t\t\tlistener(accounts);\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;AAYA,IAAsB,oBAAtB,MAAiE;;uBAG9B;;CAElC,YAA8B,EAAE;CAChC,aAAa,IAAI,KAA2C;CAI5D,cAAgC;AAC/B,SAAO,CAAC,GAAG,MAAKA,SAAU;;CAG3B,WAAW,SAA6C;AACvD,SAAO,MAAKA,SAAU,MAAM,YAAY,QAAQ,YAAY,QAAQ;;CAGrE,kBAAkB,UAA4D;AAC7E,QAAKC,UAAW,IAAI,SAAS;AAC7B,eAAa;AACZ,SAAKA,UAAW,OAAO,SAAS;;;CAIlC,UAAgB;AACf,QAAKD,WAAY,EAAE;AACnB,QAAKC,UAAW,OAAO;;CAKxB,IAAc,YAAuC;AACpD,SAAO,MAAKD;;CAGb,AAAU,mBAAmB,UAAkC;AAC9D,QAAKA,WAAY;AACjB,OAAK,iBAAiB;;CAGvB,AAAU,WAAW,SAA+B;AACnD,QAAKA,SAAU,KAAK,QAAQ;AAC5B,OAAK,iBAAiB;;CAGvB,AAAU,uBAAuB,SAA0B;EAC1D,MAAM,QAAQ,MAAKA,SAAU,WAAW,MAAM,EAAE,YAAY,QAAQ;AACpE,MAAI,UAAU,CAAC,EAAG,QAAO;AACzB,QAAKA,SAAU,OAAO,OAAO,EAAE;AAC/B,OAAK,iBAAiB;AACtB,SAAO;;;CAIR,AAAU,eAAe,SAAiB,SAAkC;EAC3E,MAAM,QAAQ,MAAKA,SAAU,WAAW,MAAM,EAAE,YAAY,QAAQ;AACpE,MAAI,UAAU,CAAC,EAAG,QAAO;AACzB,QAAKA,SAAU,SAAS;AACxB,OAAK,iBAAiB;AACtB,SAAO;;;CAIR,AAAU,eAAe,SAAiB,OAAwB;EACjE,MAAM,UAAU,KAAK,WAAW,QAAQ;AACxC,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,KAAK,eAAe,SAAS,oBAAoB,QAAQ,QAAQ,SAAS,MAAM,CAAC;;CAGzF,AAAU,kBAA0B;AACnC,SAAO,WAAW,KAAK,aAAa,CAAC,SAAS;;CAG/C,AAAU,kBAAwB;EACjC,MAAM,WAAW,KAAK,aAAa;AACnC,OAAK,MAAM,YAAY,MAAKC,WAAY;AACvC,YAAS,SAAS"}

package/dist/adapters/browser.d.mts

@@ -0,0 +1,8 @@
+import { CreateAccountOptions, ImportAccountOptions, ManagedAccount, SignerAdapter } from "../types.mjs";
+import { BaseSignerAdapter } from "./base-adapter.mjs";
+import { buildManagedAccount } from "./build-managed-account.mjs";
+import { InMemorySignerAdapter } from "./in-memory-adapter.mjs";
+import { CliProxySigner, RemoteCliAdapter } from "./remote-cli-adapter.mjs";
+import { WebCryptoSignerAdapter } from "./webcrypto-adapter.mjs";
+import { PasskeySignerAdapter } from "./passkey-adapter.mjs";
+export { BaseSignerAdapter, CliProxySigner, type CreateAccountOptions, type ImportAccountOptions, InMemorySignerAdapter, type ManagedAccount, PasskeySignerAdapter, RemoteCliAdapter, type SignerAdapter, WebCryptoSignerAdapter, buildManagedAccount };

package/dist/adapters/browser.mjs

@@ -0,0 +1,8 @@
+import { buildManagedAccount } from "./build-managed-account.mjs";
+import { BaseSignerAdapter } from "./base-adapter.mjs";
+import { InMemorySignerAdapter } from "./in-memory-adapter.mjs";
+import { CliProxySigner, RemoteCliAdapter } from "./remote-cli-adapter.mjs";
+import { WebCryptoSignerAdapter } from "./webcrypto-adapter.mjs";
+import { PasskeySignerAdapter } from "./passkey-adapter.mjs";
+
+export { BaseSignerAdapter, CliProxySigner, InMemorySignerAdapter, PasskeySignerAdapter, RemoteCliAdapter, WebCryptoSignerAdapter, buildManagedAccount };

package/dist/adapters/build-managed-account.d.mts

@@ -0,0 +1,12 @@
+import { ManagedAccount } from "../types.mjs";
+import { IdentifierString } from "@mysten/wallet-standard";
+import { Signer } from "@mysten/sui/cryptography";
+
+//#region src/adapters/build-managed-account.d.ts
+/**
+ * Build a {@link ManagedAccount} from a signer, address, label, and optional feature list.
+ */
+declare function buildManagedAccount(signer: Signer, address: string, label: string, features?: readonly IdentifierString[]): ManagedAccount;
+//#endregion
+export { buildManagedAccount };
+//# sourceMappingURL=build-managed-account.d.mts.map

package/dist/adapters/build-managed-account.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-managed-account.d.mts","names":[],"sources":["../../src/adapters/build-managed-account.ts"],"mappings":";;;;;;;AAkBA;iBAAgB,mBAAA,CACf,MAAA,EAAQ,MAAA,EACR,OAAA,UACA,KAAA,UACA,QAAA,YAAoB,gBAAA,KAClB,cAAA"}

package/dist/adapters/build-managed-account.mjs

@@ -0,0 +1,30 @@
+import { ReadonlyWalletAccount, SUI_CHAINS } from "@mysten/wallet-standard";
+
+//#region src/adapters/build-managed-account.ts
+const DEFAULT_FEATURES = [
+	"sui:signTransaction",
+	"sui:signAndExecuteTransaction",
+	"sui:signPersonalMessage"
+];
+/**
+* Build a {@link ManagedAccount} from a signer, address, label, and optional feature list.
+*/
+function buildManagedAccount(signer, address, label, features) {
+	const walletAccount = new ReadonlyWalletAccount({
+		address,
+		label,
+		publicKey: signer.getPublicKey().toSuiBytes(),
+		chains: [...SUI_CHAINS],
+		features: [...features ?? DEFAULT_FEATURES]
+	});
+	return {
+		address,
+		label,
+		signer,
+		walletAccount
+	};
+}
+
+//#endregion
+export { buildManagedAccount };
+//# sourceMappingURL=build-managed-account.mjs.map

package/dist/adapters/build-managed-account.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-managed-account.mjs","names":[],"sources":["../../src/adapters/build-managed-account.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { Signer } from '@mysten/sui/cryptography';\nimport type { IdentifierString } from '@mysten/wallet-standard';\nimport { ReadonlyWalletAccount, SUI_CHAINS } from '@mysten/wallet-standard';\n\nimport type { ManagedAccount } from '../types.js';\n\nconst DEFAULT_FEATURES: IdentifierString[] = [\n\t'sui:signTransaction',\n\t'sui:signAndExecuteTransaction',\n\t'sui:signPersonalMessage',\n];\n\n/**\n * Build a {@link ManagedAccount} from a signer, address, label, and optional feature list.\n */\nexport function buildManagedAccount(\n\tsigner: Signer,\n\taddress: string,\n\tlabel: string,\n\tfeatures?: readonly IdentifierString[],\n): ManagedAccount {\n\tconst walletAccount = new ReadonlyWalletAccount({\n\t\taddress,\n\t\tlabel,\n\t\tpublicKey: signer.getPublicKey().toSuiBytes(),\n\t\tchains: [...SUI_CHAINS],\n\t\tfeatures: [...(features ?? DEFAULT_FEATURES)],\n\t});\n\treturn { address, label, signer, walletAccount };\n}\n"],"mappings":";;;AASA,MAAM,mBAAuC;CAC5C;CACA;CACA;CACA;;;;AAKD,SAAgB,oBACf,QACA,SACA,OACA,UACiB;CACjB,MAAM,gBAAgB,IAAI,sBAAsB;EAC/C;EACA;EACA,WAAW,OAAO,cAAc,CAAC,YAAY;EAC7C,QAAQ,CAAC,GAAG,WAAW;EACvB,UAAU,CAAC,GAAI,YAAY,iBAAkB;EAC7C,CAAC;AACF,QAAO;EAAE;EAAS;EAAO;EAAQ;EAAe"}

package/dist/adapters/idb-store.mjs

@@ -0,0 +1,73 @@
+//#region src/adapters/idb-store.ts
+/**
+* Minimal IndexedDB key-value store replacing the `idb-keyval` package.
+*
+* The database connection is opened lazily on first use and reused for all
+* subsequent operations.
+*/
+var IDBStore = class {
+	#dbName;
+	#storeName;
+	#db = null;
+	constructor(dbName, storeName) {
+		this.#dbName = dbName;
+		this.#storeName = storeName;
+	}
+	get(key) {
+		return this.#withTx("readonly", (s) => s.get(key));
+	}
+	async set(key, value) {
+		await this.#withTx("readwrite", (s) => s.put(value, key));
+	}
+	del(key) {
+		return this.#withTx("readwrite", (s) => s.delete(key));
+	}
+	entries() {
+		return this.#open().then((db) => new Promise((resolve, reject) => {
+			const tx = db.transaction(this.#storeName, "readonly");
+			const objectStore = tx.objectStore(this.#storeName);
+			const results = [];
+			const cursor = objectStore.openCursor();
+			cursor.onsuccess = () => {
+				const c = cursor.result;
+				if (c) {
+					results.push([c.key, c.value]);
+					c.continue();
+				}
+			};
+			tx.oncomplete = () => resolve(results);
+			tx.onerror = () => reject(tx.error);
+		}));
+	}
+	#open() {
+		if (!this.#db) {
+			this.#db = new Promise((resolve, reject) => {
+				const request = indexedDB.open(this.#dbName);
+				request.onupgradeneeded = () => {
+					if (!request.result.objectStoreNames.contains(this.#storeName)) {
+						request.result.createObjectStore(this.#storeName);
+					}
+				};
+				request.onsuccess = () => resolve(request.result);
+				request.onerror = () => {
+					this.#db = null;
+					reject(request.error);
+				};
+			});
+		}
+		return this.#db;
+	}
+	#withTx(mode, fn) {
+		return this.#open().then((db) => new Promise((resolve, reject) => {
+			const tx = db.transaction(this.#storeName, mode);
+			const req = fn(tx.objectStore(this.#storeName));
+			tx.oncomplete = () => resolve(req.result);
+			tx.onerror = () => reject(tx.error);
+			tx.onabort = () => reject(tx.error);
+		}));
+	}
+};
+
+//#endregion
+export { IDBStore };
+//# sourceMappingURL=idb-store.mjs.map

package/dist/adapters/idb-store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-store.mjs","names":["#dbName","#storeName","#withTx","#open","#db"],"sources":["../../src/adapters/idb-store.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Minimal IndexedDB key-value store replacing the `idb-keyval` package.\n *\n * The database connection is opened lazily on first use and reused for all\n * subsequent operations.\n */\nexport class IDBStore {\n\t#dbName: string;\n\t#storeName: string;\n\t#db: Promise<IDBDatabase> | null = null;\n\n\tconstructor(dbName: string, storeName: string) {\n\t\tthis.#dbName = dbName;\n\t\tthis.#storeName = storeName;\n\t}\n\n\tget<T>(key: IDBValidKey): Promise<T | undefined> {\n\t\treturn this.#withTx('readonly', (s) => s.get(key) as IDBRequest<T | undefined>);\n\t}\n\n\tasync set(key: IDBValidKey, value: unknown): Promise<void> {\n\t\tawait this.#withTx('readwrite', (s) => s.put(value, key));\n\t}\n\n\tdel(key: IDBValidKey): Promise<void> {\n\t\treturn this.#withTx('readwrite', (s) => s.delete(key) as IDBRequest<void>);\n\t}\n\n\tentries<K extends IDBValidKey, V>(): Promise<[K, V][]> {\n\t\treturn this.#open().then(\n\t\t\t(db) =>\n\t\t\t\tnew Promise((resolve, reject) => {\n\t\t\t\t\tconst tx = db.transaction(this.#storeName, 'readonly');\n\t\t\t\t\tconst objectStore = tx.objectStore(this.#storeName);\n\t\t\t\t\tconst results: [K, V][] = [];\n\t\t\t\t\tconst cursor = objectStore.openCursor();\n\t\t\t\t\tcursor.onsuccess = () => {\n\t\t\t\t\t\tconst c = cursor.result;\n\t\t\t\t\t\tif (c) {\n\t\t\t\t\t\t\tresults.push([c.key as K, c.value as V]);\n\t\t\t\t\t\t\tc.continue();\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t\ttx.oncomplete = () => resolve(results);\n\t\t\t\t\ttx.onerror = () => reject(tx.error);\n\t\t\t\t}),\n\t\t);\n\t}\n\n\t#open(): Promise<IDBDatabase> {\n\t\tif (!this.#db) {\n\t\t\tthis.#db = new Promise((resolve, reject) => {\n\t\t\t\tconst request = indexedDB.open(this.#dbName);\n\t\t\t\trequest.onupgradeneeded = () => {\n\t\t\t\t\tif (!request.result.objectStoreNames.contains(this.#storeName)) {\n\t\t\t\t\t\trequest.result.createObjectStore(this.#storeName);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\trequest.onsuccess = () => resolve(request.result);\n\t\t\t\trequest.onerror = () => {\n\t\t\t\t\tthis.#db = null;\n\t\t\t\t\treject(request.error);\n\t\t\t\t};\n\t\t\t});\n\t\t}\n\t\treturn this.#db;\n\t}\n\n\t#withTx<T>(\n\t\tmode: IDBTransactionMode,\n\t\tfn: (objectStore: IDBObjectStore) => IDBRequest<T>,\n\t): Promise<T> {\n\t\treturn this.#open().then(\n\t\t\t(db) =>\n\t\t\t\tnew Promise((resolve, reject) => {\n\t\t\t\t\tconst tx = db.transaction(this.#storeName, mode);\n\t\t\t\t\tconst req = fn(tx.objectStore(this.#storeName));\n\t\t\t\t\ttx.oncomplete = () => resolve(req.result);\n\t\t\t\t\ttx.onerror = () => reject(tx.error);\n\t\t\t\t\ttx.onabort = () => reject(tx.error);\n\t\t\t\t}),\n\t\t);\n\t}\n}\n"],"mappings":";;;;;;;AASA,IAAa,WAAb,MAAsB;CACrB;CACA;CACA,MAAmC;CAEnC,YAAY,QAAgB,WAAmB;AAC9C,QAAKA,SAAU;AACf,QAAKC,YAAa;;CAGnB,IAAO,KAA0C;AAChD,SAAO,MAAKC,OAAQ,aAAa,MAAM,EAAE,IAAI,IAAI,CAA8B;;CAGhF,MAAM,IAAI,KAAkB,OAA+B;AAC1D,QAAM,MAAKA,OAAQ,cAAc,MAAM,EAAE,IAAI,OAAO,IAAI,CAAC;;CAG1D,IAAI,KAAiC;AACpC,SAAO,MAAKA,OAAQ,cAAc,MAAM,EAAE,OAAO,IAAI,CAAqB;;CAG3E,UAAuD;AACtD,SAAO,MAAKC,MAAO,CAAC,MAClB,OACA,IAAI,SAAS,SAAS,WAAW;GAChC,MAAM,KAAK,GAAG,YAAY,MAAKF,WAAY,WAAW;GACtD,MAAM,cAAc,GAAG,YAAY,MAAKA,UAAW;GACnD,MAAM,UAAoB,EAAE;GAC5B,MAAM,SAAS,YAAY,YAAY;AACvC,UAAO,kBAAkB;IACxB,MAAM,IAAI,OAAO;AACjB,QAAI,GAAG;AACN,aAAQ,KAAK,CAAC,EAAE,KAAU,EAAE,MAAW,CAAC;AACxC,OAAE,UAAU;;;AAGd,MAAG,mBAAmB,QAAQ,QAAQ;AACtC,MAAG,gBAAgB,OAAO,GAAG,MAAM;IAClC,CACH;;CAGF,QAA8B;AAC7B,MAAI,CAAC,MAAKG,IAAK;AACd,SAAKA,KAAM,IAAI,SAAS,SAAS,WAAW;IAC3C,MAAM,UAAU,UAAU,KAAK,MAAKJ,OAAQ;AAC5C,YAAQ,wBAAwB;AAC/B,SAAI,CAAC,QAAQ,OAAO,iBAAiB,SAAS,MAAKC,UAAW,EAAE;AAC/D,cAAQ,OAAO,kBAAkB,MAAKA,UAAW;;;AAGnD,YAAQ,kBAAkB,QAAQ,QAAQ,OAAO;AACjD,YAAQ,gBAAgB;AACvB,WAAKG,KAAM;AACX,YAAO,QAAQ,MAAM;;KAErB;;AAEH,SAAO,MAAKA;;CAGb,QACC,MACA,IACa;AACb,SAAO,MAAKD,MAAO,CAAC,MAClB,OACA,IAAI,SAAS,SAAS,WAAW;GAChC,MAAM,KAAK,GAAG,YAAY,MAAKF,WAAY,KAAK;GAChD,MAAM,MAAM,GAAG,GAAG,YAAY,MAAKA,UAAW,CAAC;AAC/C,MAAG,mBAAmB,QAAQ,IAAI,OAAO;AACzC,MAAG,gBAAgB,OAAO,GAAG,MAAM;AACnC,MAAG,gBAAgB,OAAO,GAAG,MAAM;IAClC,CACH"}

package/dist/adapters/in-memory-adapter.d.mts

@@ -0,0 +1,16 @@
+import { CreateAccountOptions, ImportAccountOptions, ManagedAccount } from "../types.mjs";
+import { BaseSignerAdapter } from "./base-adapter.mjs";
+
+//#region src/adapters/in-memory-adapter.d.ts
+declare class InMemorySignerAdapter extends BaseSignerAdapter {
+  readonly id = "in-memory";
+  readonly name = "In-Memory Signer";
+  initialize(): Promise<void>;
+  createAccount(options?: CreateAccountOptions): Promise<ManagedAccount>;
+  importAccount(options: ImportAccountOptions): Promise<ManagedAccount>;
+  renameAccount(address: string, label: string): Promise<boolean>;
+  removeAccount(address: string): Promise<boolean>;
+}
+//#endregion
+export { InMemorySignerAdapter };
+//# sourceMappingURL=in-memory-adapter.d.mts.map

package/dist/adapters/in-memory-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-adapter.d.mts","names":[],"sources":["../../src/adapters/in-memory-adapter.ts"],"mappings":";;;;cASa,qBAAA,SAA8B,iBAAA;EAAA,SACjC,EAAA;EAAA,SACA,IAAA;EAEH,UAAA,CAAA,GAAc,OAAA;EAId,aAAA,CAAc,OAAA,GAAU,oBAAA,GAAuB,OAAA,CAAQ,cAAA;EAUvD,aAAA,CAAc,OAAA,EAAS,oBAAA,GAAuB,OAAA,CAAQ,cAAA;EAgBtD,aAAA,CAAc,OAAA,UAAiB,KAAA,WAAgB,OAAA;EAI/C,aAAA,CAAc,OAAA,WAAkB,OAAA;AAAA"}

package/dist/adapters/in-memory-adapter.mjs

@@ -0,0 +1,44 @@
+import { buildManagedAccount } from "./build-managed-account.mjs";
+import { BaseSignerAdapter } from "./base-adapter.mjs";
+import { Ed25519Keypair } from "@mysten/sui/keypairs/ed25519";
+
+//#region src/adapters/in-memory-adapter.ts
+var InMemorySignerAdapter = class extends BaseSignerAdapter {
+	constructor(..._args) {
+		super(..._args);
+		this.id = "in-memory";
+		this.name = "In-Memory Signer";
+	}
+	async initialize() {}
+	async createAccount(options) {
+		const keypair = new Ed25519Keypair();
+		const address = keypair.getPublicKey().toSuiAddress();
+		const label = options?.label ?? this.getDefaultLabel();
+		const managedAccount = buildManagedAccount(keypair, address, label);
+		this.addAccount(managedAccount);
+		return managedAccount;
+	}
+	async importAccount(options) {
+		const signer = options.signer;
+		if (!signer) {
+			throw new Error("In-memory adapter requires a signer to import");
+		}
+		const address = signer.toSuiAddress();
+		const existing = this.getAccount(address);
+		if (existing) return existing;
+		const label = options.label ?? this.getDefaultLabel();
+		const managedAccount = buildManagedAccount(signer, address, label);
+		this.addAccount(managedAccount);
+		return managedAccount;
+	}
+	async renameAccount(address, label) {
+		return this._performRename(address, label);
+	}
+	async removeAccount(address) {
+		return this.removeAccountByAddress(address);
+	}
+};
+
+//#endregion
+export { InMemorySignerAdapter };
+//# sourceMappingURL=in-memory-adapter.mjs.map

package/dist/adapters/in-memory-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-adapter.mjs","names":[],"sources":["../../src/adapters/in-memory-adapter.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';\n\nimport type { CreateAccountOptions, ImportAccountOptions, ManagedAccount } from '../types.js';\nimport { BaseSignerAdapter } from './base-adapter.js';\nimport { buildManagedAccount } from './build-managed-account.js';\n\nexport class InMemorySignerAdapter extends BaseSignerAdapter {\n\treadonly id = 'in-memory';\n\treadonly name = 'In-Memory Signer';\n\n\tasync initialize(): Promise<void> {\n\t\t// No-op for in-memory adapter\n\t}\n\n\tasync createAccount(options?: CreateAccountOptions): Promise<ManagedAccount> {\n\t\tconst keypair = new Ed25519Keypair();\n\t\tconst address = keypair.getPublicKey().toSuiAddress();\n\t\tconst label = options?.label ?? this.getDefaultLabel();\n\n\t\tconst managedAccount = buildManagedAccount(keypair, address, label);\n\t\tthis.addAccount(managedAccount);\n\t\treturn managedAccount;\n\t}\n\n\tasync importAccount(options: ImportAccountOptions): Promise<ManagedAccount> {\n\t\tconst signer = options.signer;\n\t\tif (!signer) {\n\t\t\tthrow new Error('In-memory adapter requires a signer to import');\n\t\t}\n\t\tconst address = signer.toSuiAddress();\n\n\t\tconst existing = this.getAccount(address);\n\t\tif (existing) return existing;\n\n\t\tconst label = options.label ?? this.getDefaultLabel();\n\t\tconst managedAccount = buildManagedAccount(signer, address, label);\n\t\tthis.addAccount(managedAccount);\n\t\treturn managedAccount;\n\t}\n\n\tasync renameAccount(address: string, label: string): Promise<boolean> {\n\t\treturn this._performRename(address, label);\n\t}\n\n\tasync removeAccount(address: string): Promise<boolean> {\n\t\treturn this.removeAccountByAddress(address);\n\t}\n}\n"],"mappings":";;;;;AASA,IAAa,wBAAb,cAA2C,kBAAkB;;;YAC9C;cACE;;CAEhB,MAAM,aAA4B;CAIlC,MAAM,cAAc,SAAyD;EAC5E,MAAM,UAAU,IAAI,gBAAgB;EACpC,MAAM,UAAU,QAAQ,cAAc,CAAC,cAAc;EACrD,MAAM,QAAQ,SAAS,SAAS,KAAK,iBAAiB;EAEtD,MAAM,iBAAiB,oBAAoB,SAAS,SAAS,MAAM;AACnE,OAAK,WAAW,eAAe;AAC/B,SAAO;;CAGR,MAAM,cAAc,SAAwD;EAC3E,MAAM,SAAS,QAAQ;AACvB,MAAI,CAAC,QAAQ;AACZ,SAAM,IAAI,MAAM,gDAAgD;;EAEjE,MAAM,UAAU,OAAO,cAAc;EAErC,MAAM,WAAW,KAAK,WAAW,QAAQ;AACzC,MAAI,SAAU,QAAO;EAErB,MAAM,QAAQ,QAAQ,SAAS,KAAK,iBAAiB;EACrD,MAAM,iBAAiB,oBAAoB,QAAQ,SAAS,MAAM;AAClE,OAAK,WAAW,eAAe;AAC/B,SAAO;;CAGR,MAAM,cAAc,SAAiB,OAAiC;AACrE,SAAO,KAAK,eAAe,SAAS,MAAM;;CAG3C,MAAM,cAAc,SAAmC;AACtD,SAAO,KAAK,uBAAuB,QAAQ"}

package/dist/adapters/passkey-adapter.d.mts

@@ -0,0 +1,31 @@
+import { CreateAccountOptions, ManagedAccount } from "../types.mjs";
+import { BaseSignerAdapter } from "./base-adapter.mjs";
+import { PasskeyProvider } from "@mysten/sui/keypairs/passkey";
+
+//#region src/adapters/passkey-adapter.d.ts
+/**
+ * Signer adapter backed by WebAuthn passkeys. Each signing operation triggers a
+ * browser biometric/PIN prompt. Account metadata is persisted in IndexedDB;
+ * private keys are managed by the browser/OS and never enter JavaScript.
+ *
+ * Browser only — requires `navigator.credentials` and `indexedDB`.
+ */
+declare class PasskeySignerAdapter extends BaseSignerAdapter {
+  #private;
+  readonly id = "passkey";
+  readonly name = "Passkey Signer";
+  readonly allowAutoSign = false;
+  constructor(options?: {
+    dbName?: string;
+    storeName?: string;
+    provider?: PasskeyProvider;
+  });
+  initialize(): Promise<void>;
+  protected getDefaultLabel(): string;
+  createAccount(options?: CreateAccountOptions): Promise<ManagedAccount>;
+  renameAccount(address: string, label: string): Promise<boolean>;
+  removeAccount(address: string): Promise<boolean>;
+}
+//#endregion
+export { PasskeySignerAdapter };
+//# sourceMappingURL=passkey-adapter.d.mts.map

package/dist/adapters/passkey-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkey-adapter.d.mts","names":[],"sources":["../../src/adapters/passkey-adapter.ts"],"mappings":";;;;;;;AAgCA;;;;;cAAa,oBAAA,SAA6B,iBAAA;EAAA;WAChC,EAAA;EAAA,SACA,IAAA;EAAA,SACA,aAAA;cAKG,OAAA;IAAY,MAAA;IAAiB,SAAA;IAAoB,QAAA,GAAW,eAAA;EAAA;EAiBlE,UAAA,CAAA,GAAc,OAAA;EAAA,UAsBD,eAAA,CAAA;EAIb,aAAA,CAAc,OAAA,GAAU,oBAAA,GAAoB,OAAA,CAAA,cAAA;EAY5C,aAAA,CAAc,OAAA,UAAiB,KAAA,WAAgB,OAAA;EAM/C,aAAA,CAAc,OAAA,WAAkB,OAAA;AAAA"}