@usebutr/sui 1.0.1 → 2.0.2

package/CHANGELOG.md

@@ -0,0 +1,208 @@
+# @usebutr/sui
+
+## 2.0.2
+
+### Patch Changes
+
+- Updated dependencies [[`bc5b58c`](https://github.com/pedroapfilho/usebutr/commit/bc5b58cd87601be38dbb77a14e16eaaa36e8f012), [`bc5b58c`](https://github.com/pedroapfilho/usebutr/commit/bc5b58cd87601be38dbb77a14e16eaaa36e8f012)]:
+  - @usebutr/wallet-standard-shared@1.0.0
+  - @usebutr/core@2.0.1
+
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [302ae4a]
+  - @usebutr/wallet-standard-shared@0.5.1
+
+## 2.0.0
+
+### Major Changes
+
+- 9b1caa2: Correctness pass across the storage, hydration and connector layers. Several of
+  these change observable behaviour; the ones worth knowing about before upgrading:
+
+  **Breaking**
+
+  - `SuiWallet.signTransaction` now returns `{ bytes, signature }` instead of
+    `Uint8Array`. Sui's `executeTransactionBlock` needs both, and each connector
+    previously returned a different half, so the old value could not be broadcast
+    and a consumer could not tell which half they held. SVM and Bitcoin keep their
+    single-`Uint8Array` shape.
+  - `@usebutr/svm`'s `sendTx` returns the signature base58-encoded, matching the
+    WalletConnect namespace, the Ledger app, Solana explorers and
+    `getSignatureStatuses`. It previously returned base64.
+  - `@usebutr/sui`'s feature input types drop the `string` arm from
+    `transaction`; wallets only ever accepted the `toJSON()` form. Strings and BCS
+    bytes are now wrapped for you, so `sendTx` accepts strictly more than before.
+
+  **Behaviour fixes**
+
+  - `WalletStorage.setPool` and `removePoolEntry` could self-deadlock on a corrupt
+    pool payload, leaving `connectWallet` unresolved and every later pool write
+    jammed for the page's life. Both are fixed, and `readWalletSnapshot` now shares
+    one codec with `WalletStorage` so the server and client decodes cannot drift.
+  - A seeded (SSR) entry whose silent reconnect failed used to stay in the pool
+    backed by a placeholder connector forever, so `useSigner`/`useBalance`
+    reported an error and `useConnectionStatus` reported `"reconnecting"`
+    permanently. Those entries are now dropped.
+  - `useSigner` and `useBalance` stay `idle` for a wallet that is still
+    reconnecting instead of surfacing a placeholder rejection as `status: "error"`.
+  - `useConnectionStatus` lets a live `"connecting"`/`"error"` take precedence over
+    the derived `"reconnecting"`, so an in-flight attempt and a connection error
+    are no longer hidden. New `useIsReconnecting(connectorId?)` answers the
+    per-wallet question directly.
+  - A background restore no longer writes the connect-attempt status or steals
+    `activeConnectorId`, and a superseded `CONNECT_FAILED` no longer overwrites the
+    current attempt.
+  - An externally-disconnected connector is now torn down, not just dropped from
+    the pool, so a cached adapter is not reused while still holding a session.
+  - EVM: a malformed provider response is treated as absent rather than `""`, which
+    previously produced chain `eip155:0`, zero-length signatures, empty transaction
+    hashes and a confident `0 ETH`. `switchChain` gained the same-chain
+    short-circuit `sendTxToChain` already had.
+  - WalletConnect: accounts carry their own chain instead of all being stamped with
+    the active one, so a multi-chain session no longer returns a wrong-chain
+    address. One pairing now covers every configured namespace, the pairing URI
+    survives a reconnect, and concurrent connects share one pairing.
+  - Bitcoin: the sats-connect (Xverse) adapter honours `silent`, so a reload no
+    longer triggers an unsolicited approval prompt, and exposes the payment address
+    as its single account instead of also presenting the ordinals address as
+    spendable.
+  - Polkadot: the injected adapter actually delivers events to subscribers,
+    `switchChain` notifies like its Wallet Standard sibling, and chain resolution
+    prefers the mainnets rather than whatever the wallet listed first.
+  - Ledger: the device session is committed atomically, so a locked device no
+    longer leaves an open transport that reports itself connected, and concurrent
+    connects open one transport.
+  - SVM: `sendTxToChain` submits to the chain you asked for instead of the
+    adapter's current one, and rejects a chain the wallet does not advertise.
+  - `@usebutr/svm`'s `switchChain` capability now counts only `solana:` chains, so
+    a multi-namespace wallet no longer advertises a method that always throws.
+
+  **Testing**
+
+  - `createFakePersistence` is now the real `WalletStorage` over memory drivers
+    rather than a parallel implementation, so it inherits upsert semantics,
+    validation and JSON round-tripping. Two divergences are fixed as a result:
+    `setPool` upserts rather than replaces, and `clearAll` leaves the
+    user-disconnected flag alone.
+  - `createFakeConnectedWallet` rejects being given both an `adapter` and explicit
+    `addresses`/`accounts`, a combination whose halves could disagree.
+
+### Patch Changes
+
+- Updated dependencies [9b1caa2]
+  - @usebutr/wallet-standard-shared@0.5.0
+  - @usebutr/core@2.0.0
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [8ecaf89]
+  - @usebutr/core@1.1.0
+  - @usebutr/wallet-standard-shared@0.4.1
+
+## 1.0.0
+
+### Major Changes
+
+- f0a5116: **Breaking:** the `platform` field is gone from the `PlatformDiscoverer` type in `@usebutr/core`, and from the `evmDiscoverer`, `svmDiscoverer`, `suiDiscoverer`, `bitcoinDiscoverer` and `polkadotDiscoverer` objects that implement it. Nothing read it: the aggregator keys discoverers by `ChainPlatform` in its own registry, so the field only restated the key.
+
+  Migration: read the platform from the `KNOWN_DISCOVERERS` key in `@usebutr/wallets` (`Object.entries(KNOWN_DISCOVERERS)`), or from `adapter.chainPlatform` on a discovered adapter. Custom `PlatformDiscoverer` implementations must drop the `platform` property; keeping it is now an excess-property error.
+
+- f0a5116: **Breaking:** `slugify` is no longer exported from `@usebutr/svm`, `@usebutr/sui` or `@usebutr/bitcoin`. Each package exported a one-argument wrapper that only bound a platform prefix onto the canonical two-argument helper, so three names shadowed one implementation.
+
+  Migration: import `slugify` from `@usebutr/wallet-standard-shared` and pass the platform prefix as the first argument. `slugify(name)` from `@usebutr/svm` becomes `slugify("svm", name)`; the `@usebutr/sui` prefix is `"sui"` and the `@usebutr/bitcoin` prefix is `"btc"`. Adapter ids are byte-for-byte the same.
+
+### Patch Changes
+
+- 7887cf0: Resolve capabilities through `buildWalletCapabilities` from `@usebutr/wallet-standard-shared` instead of a per-package copy of the same object literal. Resolver names, input types and returned flags are unchanged. The injected Polkadot profile now derives its chain count from `POLKADOT_CHAINS_LIST` rather than asserting `switchChain: true` directly; the result is the same.
+- 7887cf0: Move each package's `discover*Adapters` function next to the adapter builder it wraps and drop the single-function `wallet-standard.ts` module. The functions are still exported from the package root under the same names; only an internal file boundary went away.
+- Updated dependencies [7887cf0]
+- Updated dependencies [7887cf0]
+- Updated dependencies [f0a5116]
+- Updated dependencies [f0a5116]
+- Updated dependencies [7887cf0]
+  - @usebutr/core@1.0.0
+  - @usebutr/wallet-standard-shared@0.4.0
+
+## 0.2.7
+
+### Patch Changes
+
+- efe4550: Share the session plumbing behind the Wallet Standard and WalletConnect CAIP adapters. `@usebutr/wallet-standard-shared` now exports `createWalletStandardCore`, which the Bitcoin, Polkadot, Sui and SVM adapters build on; the WalletConnect Bitcoin, Sui and SVM namespaces share an equivalent CAIP core. Every package's public API is unchanged. The one visible difference is a dev-console warning: a failed SVM disconnect now logs `[butr] SVM Wallet Standard disconnect threw:` instead of `[butr] Wallet Standard disconnect threw:`.
+- Updated dependencies [efe4550]
+- Updated dependencies [4467a5e]
+  - @usebutr/wallet-standard-shared@0.3.0
+  - @usebutr/core@0.5.0
+
+## 0.2.6
+
+### Patch Changes
+
+- Updated dependencies [c1309ee]
+  - @usebutr/core@0.4.2
+  - @usebutr/wallet-standard-shared@0.2.6
+
+## 0.2.5
+
+### Patch Changes
+
+- 937dfae: Bump runtime dependency floors (`@wallet-standard/app` 1.1.1, `@ledgerhq/*` latest minors, `@walletconnect/universal-provider` 2.23.10) and modernize public type declarations from method signatures to property function types (oxlint `method-signature-style`). Type-level only — no runtime behavior change.
+- Updated dependencies [937dfae]
+  - @usebutr/core@0.4.1
+  - @usebutr/wallet-standard-shared@0.2.5
+
+## 0.2.4
+
+### Patch Changes
+
+- a46eecd: Ship unminified ESM so downstream bundlers (Vite/esbuild dep pre-bundling) process the package correctly; fixes a ReferenceError in consumer dev servers. The consuming app minifies once at its own build.
+- Updated dependencies [b5322ae]
+- Updated dependencies [d5f32c7]
+- Updated dependencies [a46eecd]
+- Updated dependencies [3f26776]
+  - @usebutr/core@0.4.0
+  - @usebutr/wallet-standard-shared@0.2.4
+
+## 0.2.3
+
+### Patch Changes
+
+- Updated dependencies [886ee1d]
+  - @usebutr/core@0.3.0
+  - @usebutr/wallet-standard-shared@0.2.3
+
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [db5d7e9]
+  - @usebutr/core@0.2.2
+  - @usebutr/wallet-standard-shared@0.2.2
+
+## 0.2.1
+
+### Patch Changes
+
+- f846e77: Wallet-announced icons are trimmed of surrounding whitespace on ingestion. Some wallets ship data-URI icons with a leading newline, which strict consumers reject — Next.js's `<Image>` throws because `src` must not start with a control character. `@usebutr/core` exports a `sanitizeIcon` helper; the EIP-6963 and Wallet Standard adapters apply it, and an all-whitespace icon now resolves to `undefined` rather than a blank string.
+- Updated dependencies [f846e77]
+  - @usebutr/core@0.2.1
+  - @usebutr/wallet-standard-shared@0.2.1
+
+## 0.2.0
+
+### Minor Changes
+
+- b77a477: Shared Wallet Standard protocol types (`WalletStandardWallet`, `WalletStandardWalletAccount`, `WalletStandardAppModule`, `WalletsApp`, `StandardConnectFeature`, `StandardDisconnectFeature`, `StandardEventsFeature`, `StandardEventsListener`) are imported from `@usebutr/wallet-standard-shared` directly — they are no longer re-exported from `@usebutr/svm`, `@usebutr/sui`, or `@usebutr/bitcoin`. Platform-specific feature shapes still ship from their own packages.
+
+  `@usebutr/svm` adapter ids are now platform-prefixed (`wallet-standard:svm-<slug>`), consistent with the `sui-` and `btc-` prefixes. `slugify` in `@usebutr/wallet-standard-shared` requires a non-empty platform prefix.
+
+### Patch Changes
+
+- Updated dependencies [b77a477]
+- Updated dependencies [b77a477]
+  - @usebutr/core@0.2.0
+  - @usebutr/wallet-standard-shared@0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Filho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @usebutr/sui
+
+Wallet Standard adapter for butr (Sui).
+
+Part of [butr](https://www.usebutr.com), a multi-chain wallet discovery and
+connection-state library. Your application owns the picker UI and chain client.
+
+## Install
+
+```bash
+npm install @usebutr/react @usebutr/core @usebutr/sui zustand @wallet-standard/app
+```
+
+React 18+ is a peer dependency of the provider. Discovery does not render a connect modal; add your picker as the provider child. `@wallet-standard/app` is required for Wallet Standard discovery.
+
+## Usage
+
+```tsx
+import type { ReactNode } from "react";
+import { createWalletSource } from "@usebutr/core";
+import { discoverSuiAdapters } from "@usebutr/sui";
+import { WalletManagerProvider } from "@usebutr/react";
+
+const discovery = createWalletSource(discoverSuiAdapters);
+export const WalletProvider = ({ children }: { children: ReactNode }) => (
+  <WalletManagerProvider discovery={discovery}>{children}</WalletManagerProvider>
+);
+```
+
+## Documentation
+
+- [Package reference](https://docs.usebutr.com/api/sui)
+- [Getting started](https://docs.usebutr.com/getting-started/quickstart)
+- [Examples and source](https://github.com/pedroapfilho/usebutr)
+- [Report an issue](https://github.com/pedroapfilho/usebutr/issues)
+
+## License
+
+[MIT](./LICENSE), copyright 2026 Pedro Filho.

package/dist/index.d.ts

@@ -11,13 +11,14 @@ type SuiSignPersonalMessageOutput = {
 };
 type SuiSignPersonalMessageFeature = {
   signPersonalMessage: (input: SuiSignPersonalMessageInput) => Promise<SuiSignPersonalMessageOutput>;
+  version?: string;
 };
 type SuiSignTransactionInput = {
   account: WalletStandardWalletAccount;
   chain: string;
   transaction: {
     toJSON: () => Promise<string>;
-  } | string;
+  };
 };
 type SuiSignTransactionOutput = {
   bytes: string;
@@ -25,13 +26,14 @@ type SuiSignTransactionOutput = {
 };
 type SuiSignTransactionFeature = {
   signTransaction: (input: SuiSignTransactionInput) => Promise<SuiSignTransactionOutput>;
+  version?: string;
 };
 type SuiSignAndExecuteTransactionInput = {
   account: WalletStandardWalletAccount;
   chain: string;
   transaction: {
     toJSON: () => Promise<string>;
-  } | string;
+  };
 };
 type SuiSignAndExecuteTransactionOutput = {
   bytes: string;
@@ -41,26 +43,14 @@ type SuiSignAndExecuteTransactionOutput = {
 };
 type SuiSignAndExecuteTransactionFeature = {
   signAndExecuteTransaction: (input: SuiSignAndExecuteTransactionInput) => Promise<SuiSignAndExecuteTransactionOutput>;
+  version?: string;
 };
 //#endregion
 //#region src/wallet-standard-adapter.d.ts
 /**
- * Adapt a Sui Wallet Standard `Wallet` into a butr `WalletAdapter`.
- *
- * Returns `null` if the wallet doesn't advertise any Sui chain or doesn't
- * expose `standard:connect`. Same posture as `buildSvmAdapter`: gate
- * features on what each wallet advertises, return placeholders for
- * RPC-backed reads (`getBalance`, `getTransactionReceipt`), forward
- * `subscribe` through `standard:events`.
- *
- * **Known limitations**
- *
- *  - `getBalance` returns a `{ value: 0n, symbol: "SUI" }` placeholder.
- *    Consumers wrap `@mysten/sui`'s `SuiClient` for real reads.
- *  - `getTransactionReceipt` returns `"Pending"` for the same reason.
- *  - `switchChain` is local-state-only (mirrors SVM). Sui Wallet Standard
- *    has no "tell the wallet to switch network" RPC; the wallet's UI
- *    controls its global cluster setting.
+ * Sui Wallet Standard has no "switch network" RPC, so `switchChain` moves
+ * butr's view only and the wallet's own UI owns its cluster. Balance and
+ * receipt reads need `@mysten/sui`'s `SuiClient`, which butr doesn't ship.
  */
 declare const buildSuiAdapter: (wallet: WalletStandardWallet,
 /** Optional. Called with a function that pushes a synthetic
@@ -68,20 +58,8 @@ declare const buildSuiAdapter: (wallet: WalletStandardWallet,
  *  layer invokes it on Wallet Standard `unregister`. */
 registerDisconnector?: (emit: () => void) => void) => WalletAdapter | null;
 /**
- * Subscribe to Sui Wallet Standard announcements.
+ * Requires the optional `@wallet-standard/app` peer dep.
  * Spec: https://docs.sui.io/standards/wallet-standard
- *
- * Runtime requires the `@wallet-standard/app` package, which is an
- * **optional peer dependency** of butr.
- *
- * Sui wallets share the same `getWallets()` bus as SVM wallets; Phantom
- * advertises features for SVM, Sui, and Bitcoin from a single Wallet
- * Standard wallet object. `buildSuiAdapter` returns `null` for wallets
- * that don't advertise any `sui:*` features, so we cleanly end up with
- * one adapter per platform on multi-chain wallets.
- *
- * The discovery loop (dynamic import, dedupe, register / unregister
- * bridge) lives in `@usebutr/wallet-standard-shared`.
  */
 declare const discoverSuiAdapters: (onAdapter: (adapter: WalletAdapter) => void) => (() => void);
 //#endregion
@@ -125,15 +103,9 @@ type WalletStandardCapabilityInput = {
   };
 };
 /**
- * Sui Wallet Standard feature → butr capability mapping. The flags that hold
- * for every namespace are documented on `buildWalletCapabilities`.
- *
- * - `sendTransaction = sui:signAndExecuteTransaction present`. The wallet
- *   broadcasts; consumers receive the digest.
- * - `signTransaction = sui:signTransaction present`. Sign-only; consumers
- *   broadcast with their own RPC client (`@mysten/sui`'s SuiClient).
- * - `signMessage = sui:signPersonalMessage present`.
- * - `signIn = false`. Sui has no SIWS-equivalent feature in Wallet Standard.
+ * `signIn` is false: Sui Wallet Standard has no Sign-In-With-Sui feature.
+ * `signAndExecuteTransaction` means the wallet broadcasts, while
+ * `signTransaction` is sign-only and leaves the broadcast to the consumer.
  */
 declare const resolveSuiCapabilities: (input: WalletStandardCapabilityInput) => WalletCapabilities;
 //#endregion
@@ -146,10 +118,8 @@ declare const suiDiscoverer: PlatformDiscoverer;
 //#endregion
 //#region src/signer-augmentation.d.ts
 /**
- * Augment `@usebutr/core`'s `SignerForPlatform` registry with the Sui
- * entry. Sui's `getSigner()` returns the Wallet Standard wallet
- * object, which consumers narrow further via its `features` map (e.g.
- * `wallet.features["sui:signAndExecuteTransaction"]`).
+ * Sui's `getSigner()` hands back the Wallet Standard wallet, which consumers
+ * narrow through its `features` map.
  */
 declare module "@usebutr/core" {
   interface SignerForPlatform {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/wallet-standard-types.ts","../src/wallet-standard-adapter.ts","../src/chains.ts","../src/capabilities.ts","../src/discoverer.ts","../src/signer-augmentation.ts"],"mappings":";;;KAaK;EACH,SAAS;EACT,SAAS;;KAGN;EACH;EACA;;KAGG;EACH,sBACE,OAAO,gCACJ,QAAQ;;KAGV;EACH,SAAS;EACT;EACA;IAAe,cAAc;;;KAG1B;EACH;EACA;;KAGG;EACH,kBAAkB,OAAO,4BAA4B,QAAQ;;KAG1D;EACH,SAAS;EACT;EACA;IAAe,cAAc;;;KAG1B;EACH;EACA;EACA;EACA;;KAGG;EACH,4BACE,OAAO,sCACJ,QAAQ;;;;;;;;;;;;;;;;;;;;;;cCHT,kBACJ,QAAQ,sBAIR;;;;AAAA,wBAAwB,8BACvB;;;;;;;;;;;;;;;;;cAsHG,sBAAuB,YAAY,SAAS;;;cC9K5C;;;;;;;;;;;;;;;;;;;;;;;;;;cAiBA,iBAAiB,cAAc;;;KCrBhC;EACH;EACA;IACE;IACA;IACA;IACA;;;;;;;;;;;;;;cAeE,yBAA0B,OAAO,kCAAgC;;;;;;;cChBjE,eAAe;;;;;;;;;;YCET;IACR,KAAK"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/wallet-standard-types.ts","../src/wallet-standard-adapter.ts","../src/chains.ts","../src/capabilities.ts","../src/discoverer.ts","../src/signer-augmentation.ts"],"mappings":";;;KAOK;EACH,SAAS;EACT,SAAS;;KAGN;EACH;EACA;;KAGG;EACH,sBACE,OAAO,gCACJ,QAAQ;EACb;;KAGG;EACH,SAAS;EACT;EACA;IAAe,cAAc;;;KAG1B;EACH;EACA;;KAGG;EACH,kBAAkB,OAAO,4BAA4B,QAAQ;EAC7D;;KAGG;EACH,SAAS;EACT;EACA;IAAe,cAAc;;;KAG1B;EACH;EACA;EACA;EACA;;KAGG;EACH,4BACE,OAAO,sCACJ,QAAQ;EACb;;;;;;;;;cCII,kBAAe,QACX,sBAIe;;;;AAAA,wBAAC,8BACvB;;;;;cAwIG,sBAAmB,YAAgB,SAAS;;;cCzM5C;;aACM;aAAkB;aAAoB;aAAkB;;;aAEhE;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;;;aAES;aAAmB;aAAqB;aAAkB;;;cAGjE,iBAAiB,cAAc;;;KChBhC;EACH;EACA;IACE;IACA;IACA;IACA;;;;;;;;cASE,yBAAsB,OAAW,kCAAgC;;;;;;;cCVjE,eAAe;;;;;;;;YCAT;IACR,KAAK"}

package/dist/index.js

@@ -1,17 +1,11 @@
-import { base64ToBytes } from "@usebutr/core";
+import { base64ToBytes, bytesToBase64 } from "@usebutr/core";
 import { buildWalletCapabilities, createWalletStandardCore, discoverWalletStandard, getFeature, slugify } from "@usebutr/wallet-standard-shared";
 
 //#region src/capabilities.ts
 /**
-* Sui Wallet Standard feature → butr capability mapping. The flags that hold
-* for every namespace are documented on `buildWalletCapabilities`.
-*
-* - `sendTransaction = sui:signAndExecuteTransaction present`. The wallet
-*   broadcasts; consumers receive the digest.
-* - `signTransaction = sui:signTransaction present`. Sign-only; consumers
-*   broadcast with their own RPC client (`@mysten/sui`'s SuiClient).
-* - `signMessage = sui:signPersonalMessage present`.
-* - `signIn = false`. Sui has no SIWS-equivalent feature in Wallet Standard.
+* `signIn` is false: Sui Wallet Standard has no Sign-In-With-Sui feature.
+* `signAndExecuteTransaction` means the wallet broadcasts, while
+* `signTransaction` is sign-only and leaves the broadcast to the consumer.
 */
 const resolveSuiCapabilities = (input) => buildWalletCapabilities({
 	chainCount: input.chainCount,
@@ -27,33 +21,26 @@ const resolveSuiCapabilities = (input) => buildWalletCapabilities({
 const SUI_PREFIX = "sui:";
 const SUI_DECIMALS = 9;
 const SUI_MAINNET = "sui:mainnet";
-/** Coerce butr's `unknown` tx into the shape `sui:signAndExecuteTransaction`
-*  expects (an object with `toJSON()` returning a Promise<string>). When
-*  consumers pass a base64 string directly, we wrap it in a stub object so
-*  the feature contract stays satisfied without us depending on
-*  `@mysten/sui`. */
+const isSuiSignPersonalMessageFeature = (feature) => "signPersonalMessage" in feature && typeof feature.signPersonalMessage === "function";
+const isSuiSignAndExecuteTransactionFeature = (feature) => "signAndExecuteTransaction" in feature && typeof feature.signAndExecuteTransaction === "function";
+const isSuiSignTransactionFeature = (feature) => "signTransaction" in feature && typeof feature.signTransaction === "function";
+/** Coerce butr's `unknown` tx into the shape the Sui Wallet Standard features
+*  expect: an object with `toJSON()` returning a Promise<string>. A raw string
+*  or BCS byte array is wrapped, because wallets accept only the `toJSON()`
+*  form and a bare string reaches them as a shape they cannot consume. */
 const coerceSuiTransaction = (tx) => {
-	if (typeof tx === "string") return tx;
-	if (typeof tx === "object" && tx !== null && "toJSON" in tx && typeof tx.toJSON === "function") return tx;
-	throw new TypeError("Sui sendTx/signTransaction expects a @mysten/sui Transaction (with toJSON()) or a base64-encoded string");
+	if (typeof tx === "string") return { toJSON: () => Promise.resolve(tx) };
+	if (tx instanceof Uint8Array) {
+		const encoded = bytesToBase64(tx);
+		return { toJSON: () => Promise.resolve(encoded) };
+	}
+	if (typeof tx === "object" && tx !== null && "toJSON" in tx && typeof tx.toJSON === "function") return { toJSON: tx.toJSON };
+	throw new TypeError("Sui sendTx/signTransaction expects a @mysten/sui Transaction (with toJSON()), a base64-encoded string, or BCS bytes");
 };
 /**
-* Adapt a Sui Wallet Standard `Wallet` into a butr `WalletAdapter`.
-*
-* Returns `null` if the wallet doesn't advertise any Sui chain or doesn't
-* expose `standard:connect`. Same posture as `buildSvmAdapter`: gate
-* features on what each wallet advertises, return placeholders for
-* RPC-backed reads (`getBalance`, `getTransactionReceipt`), forward
-* `subscribe` through `standard:events`.
-*
-* **Known limitations**
-*
-*  - `getBalance` returns a `{ value: 0n, symbol: "SUI" }` placeholder.
-*    Consumers wrap `@mysten/sui`'s `SuiClient` for real reads.
-*  - `getTransactionReceipt` returns `"Pending"` for the same reason.
-*  - `switchChain` is local-state-only (mirrors SVM). Sui Wallet Standard
-*    has no "tell the wallet to switch network" RPC; the wallet's UI
-*    controls its global cluster setting.
+* Sui Wallet Standard has no "switch network" RPC, so `switchChain` moves
+* butr's view only and the wallet's own UI owns its cluster. Balance and
+* receipt reads need `@mysten/sui`'s `SuiClient`, which butr doesn't ship.
 */
 const buildSuiAdapter = (wallet, registerDisconnector) => {
 	const core = createWalletStandardCore({
@@ -68,20 +55,27 @@ const buildSuiAdapter = (wallet, registerDisconnector) => {
 		wallet
 	});
 	if (core === null) return null;
-	const signMessage = getFeature(wallet, "sui:signPersonalMessage");
-	const signAndExecute = getFeature(wallet, "sui:signAndExecuteTransaction");
-	const signTx = getFeature(wallet, "sui:signTransaction");
-	const executeTx = async (tx, account) => {
+	const signMessage = getFeature(wallet, "sui:signPersonalMessage", isSuiSignPersonalMessageFeature);
+	const signAndExecute = getFeature(wallet, "sui:signAndExecuteTransaction", isSuiSignAndExecuteTransactionFeature);
+	const signTx = getFeature(wallet, "sui:signTransaction", isSuiSignTransactionFeature);
+	/** Resolve a caller-supplied target into a chain the wallet advertises,
+	*  accepting either a full CAIP-2 id (`sui:testnet`) or a bare reference. */
+	const resolveTargetChain = (targetChainId) => {
+		const candidate = targetChainId.startsWith(SUI_PREFIX) ? targetChainId : `${SUI_PREFIX}${targetChainId}`;
+		if (!wallet.chains.includes(candidate)) throw new Error(`Wallet ${wallet.name} does not advertise chain "${candidate}". Available: ${wallet.chains.join(", ")}`);
+		return candidate;
+	};
+	const executeTx = async (tx, account, chain) => {
 		if (signAndExecute === void 0) throw new Error(`Wallet ${wallet.name} does not advertise sui:signAndExecuteTransaction`);
 		const wsAccount = core.resolveAccount(account);
 		const transaction = coerceSuiTransaction(tx);
 		return (await signAndExecute.signAndExecuteTransaction({
 			account: wsAccount,
-			chain: core.currentChainId(),
+			chain: chain ?? core.currentChainId(),
 			transaction
 		})).digest;
 	};
-	return {
+	const adapter = {
 		...core,
 		capabilities: resolveSuiCapabilities({
 			chainCount: core.chainCount,
@@ -104,9 +98,10 @@ const buildSuiAdapter = (wallet, registerDisconnector) => {
 			await core.connect();
 		},
 		sendTx: (tx, account) => executeTx(tx, account),
-		sendTxToChain: (tx, _targetChainId, account, cb) => {
-			cb?.();
-			return executeTx(tx, account);
+		async sendTxToChain(tx, targetChainId, account, cb) {
+			const target = resolveTargetChain(targetChainId);
+			if (target !== core.currentChainId()) cb?.();
+			return await executeTx(tx, account, target);
 		},
 		async signMessage(msg, account) {
 			if (signMessage === void 0) throw new Error(`Wallet ${wallet.name} does not advertise sui:signPersonalMessage`);
@@ -118,34 +113,26 @@ const buildSuiAdapter = (wallet, registerDisconnector) => {
 				signature: base64ToBytes(output.signature),
 				signedMessage: base64ToBytes(output.bytes)
 			};
-		},
-		...signTx === void 0 ? {} : { async signTransaction(tx, account) {
-			const wsAccount = core.resolveAccount(account);
-			const transaction = coerceSuiTransaction(tx);
-			const output = await signTx.signTransaction({
-				account: wsAccount,
-				chain: core.currentChainId(),
-				transaction
-			});
-			return base64ToBytes(output.bytes);
-		} }
+		}
+	};
+	if (signTx !== void 0) adapter.signTransaction = async (tx, account) => {
+		const wsAccount = core.resolveAccount(account);
+		const transaction = coerceSuiTransaction(tx);
+		const output = await signTx.signTransaction({
+			account: wsAccount,
+			chain: core.currentChainId(),
+			transaction
+		});
+		return {
+			bytes: base64ToBytes(output.bytes),
+			signature: base64ToBytes(output.signature)
+		};
 	};
+	return adapter;
 };
 /**
-* Subscribe to Sui Wallet Standard announcements.
+* Requires the optional `@wallet-standard/app` peer dep.
 * Spec: https://docs.sui.io/standards/wallet-standard
-*
-* Runtime requires the `@wallet-standard/app` package, which is an
-* **optional peer dependency** of butr.
-*
-* Sui wallets share the same `getWallets()` bus as SVM wallets; Phantom
-* advertises features for SVM, Sui, and Bitcoin from a single Wallet
-* Standard wallet object. `buildSuiAdapter` returns `null` for wallets
-* that don't advertise any `sui:*` features, so we cleanly end up with
-* one adapter per platform on multi-chain wallets.
-*
-* The discovery loop (dynamic import, dedupe, register / unregister
-* bridge) lives in `@usebutr/wallet-standard-shared`.
 */
 const discoverSuiAdapters = (onAdapter) => discoverWalletStandard(onAdapter, (wallet, registerDisconnector) => buildSuiAdapter(wallet, registerDisconnector));
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/capabilities.ts","../src/wallet-standard-adapter.ts","../src/chains.ts","../src/discoverer.ts"],"sourcesContent":["import type { WalletCapabilities } from \"@usebutr/core\";\nimport { buildWalletCapabilities } from \"@usebutr/wallet-standard-shared\";\n\ntype WalletStandardCapabilityInput = {\n  chainCount: number;\n  features: {\n    events: boolean;\n    signAndExecuteTransaction: boolean;\n    signMessage: boolean;\n    signTransaction: boolean;\n  };\n};\n\n/**\n * Sui Wallet Standard feature → butr capability mapping. The flags that hold\n * for every namespace are documented on `buildWalletCapabilities`.\n *\n * - `sendTransaction = sui:signAndExecuteTransaction present`. The wallet\n *   broadcasts; consumers receive the digest.\n * - `signTransaction = sui:signTransaction present`. Sign-only; consumers\n *   broadcast with their own RPC client (`@mysten/sui`'s SuiClient).\n * - `signMessage = sui:signPersonalMessage present`.\n * - `signIn = false`. Sui has no SIWS-equivalent feature in Wallet Standard.\n */\nconst resolveSuiCapabilities = (input: WalletStandardCapabilityInput): WalletCapabilities =>\n  buildWalletCapabilities({\n    chainCount: input.chainCount,\n    events: input.features.events,\n    sendTransaction: input.features.signAndExecuteTransaction,\n    signIn: false,\n    signMessage: input.features.signMessage,\n    signTransaction: input.features.signTransaction,\n  });\n\nexport type { WalletStandardCapabilityInput };\nexport { resolveSuiCapabilities };\n","import type { WalletAdapter } from \"@usebutr/core\";\nimport { base64ToBytes } from \"@usebutr/core\";\nimport {\n  createWalletStandardCore,\n  discoverWalletStandard,\n  getFeature,\n  slugify,\n} from \"@usebutr/wallet-standard-shared\";\nimport type { WalletStandardWallet } from \"@usebutr/wallet-standard-shared\";\n\nimport { resolveSuiCapabilities } from \"./capabilities\";\nimport type {\n  SuiSignAndExecuteTransactionFeature,\n  SuiSignPersonalMessageFeature,\n  SuiSignTransactionFeature,\n} from \"./wallet-standard-types\";\n\nconst SUI_PREFIX = \"sui:\";\nconst SUI_DECIMALS = 9;\nconst SUI_MAINNET = \"sui:mainnet\";\n\n/** Coerce butr's `unknown` tx into the shape `sui:signAndExecuteTransaction`\n *  expects (an object with `toJSON()` returning a Promise<string>). When\n *  consumers pass a base64 string directly, we wrap it in a stub object so\n *  the feature contract stays satisfied without us depending on\n *  `@mysten/sui`. */\nconst coerceSuiTransaction = (tx: unknown): { toJSON: () => Promise<string> } | string => {\n  if (typeof tx === \"string\") {\n    return tx;\n  }\n  if (typeof tx === \"object\" && tx !== null && \"toJSON\" in tx && typeof tx.toJSON === \"function\") {\n    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- validated toJSON() above; @mysten/sui Transaction is otherwise untyped here\n    return tx as { toJSON: () => Promise<string> };\n  }\n  throw new TypeError(\n    \"Sui sendTx/signTransaction expects a @mysten/sui Transaction (with toJSON()) or a base64-encoded string\",\n  );\n};\n\n/**\n * Adapt a Sui Wallet Standard `Wallet` into a butr `WalletAdapter`.\n *\n * Returns `null` if the wallet doesn't advertise any Sui chain or doesn't\n * expose `standard:connect`. Same posture as `buildSvmAdapter`: gate\n * features on what each wallet advertises, return placeholders for\n * RPC-backed reads (`getBalance`, `getTransactionReceipt`), forward\n * `subscribe` through `standard:events`.\n *\n * **Known limitations**\n *\n *  - `getBalance` returns a `{ value: 0n, symbol: \"SUI\" }` placeholder.\n *    Consumers wrap `@mysten/sui`'s `SuiClient` for real reads.\n *  - `getTransactionReceipt` returns `\"Pending\"` for the same reason.\n *  - `switchChain` is local-state-only (mirrors SVM). Sui Wallet Standard\n *    has no \"tell the wallet to switch network\" RPC; the wallet's UI\n *    controls its global cluster setting.\n */\nconst buildSuiAdapter = (\n  wallet: WalletStandardWallet,\n  /** Optional. Called with a function that pushes a synthetic\n   *  `disconnected` event to all current subscribers. The discovery\n   *  layer invokes it on Wallet Standard `unregister`. */\n  registerDisconnector?: (emit: () => void) => void,\n): WalletAdapter | null => {\n  const core = createWalletStandardCore({\n    chainPrefix: SUI_PREFIX,\n    id: slugify(\"sui\", wallet.name),\n    label: \"Sui\",\n    namespace: \"sui\",\n    platform: \"Sui\",\n    preferredChainIds: [SUI_MAINNET],\n    registerDisconnector,\n    trackChainChanges: true,\n    wallet,\n  });\n  if (core === null) {\n    return null;\n  }\n\n  const signMessage = getFeature<SuiSignPersonalMessageFeature>(wallet, \"sui:signPersonalMessage\");\n  const signAndExecute = getFeature<SuiSignAndExecuteTransactionFeature>(\n    wallet,\n    \"sui:signAndExecuteTransaction\",\n  );\n  const signTx = getFeature<SuiSignTransactionFeature>(wallet, \"sui:signTransaction\");\n\n  const executeTx = async (tx: unknown, account?: { walletAddress: string }): Promise<string> => {\n    if (signAndExecute === undefined) {\n      throw new Error(`Wallet ${wallet.name} does not advertise sui:signAndExecuteTransaction`);\n    }\n    const wsAccount = core.resolveAccount(account);\n    const transaction = coerceSuiTransaction(tx);\n    const output = await signAndExecute.signAndExecuteTransaction({\n      account: wsAccount,\n      chain: core.currentChainId(),\n      transaction,\n    });\n    return output.digest;\n  };\n\n  return {\n    ...core,\n    capabilities: resolveSuiCapabilities({\n      chainCount: core.chainCount,\n      features: {\n        events: core.hasEvents,\n        signAndExecuteTransaction: Boolean(signAndExecute),\n        signMessage: Boolean(signMessage),\n        signTransaction: Boolean(signTx),\n      },\n    }),\n    chainPlatform: \"sui\",\n\n    getBalance: () =>\n      Promise.resolve({\n        decimals: SUI_DECIMALS,\n        formatted: \"0\",\n        symbol: \"SUI\",\n        value: 0n,\n      }),\n\n    getTransactionReceipt: () => Promise.resolve({ status: \"Pending\" as const }),\n\n    async requestAccounts() {\n      await core.connect();\n    },\n\n    sendTx: (tx, account) => executeTx(tx, account),\n\n    sendTxToChain: (tx, _targetChainId, account, cb) => {\n      cb?.();\n      return executeTx(tx, account);\n    },\n\n    async signMessage(msg, account) {\n      if (signMessage === undefined) {\n        throw new Error(`Wallet ${wallet.name} does not advertise sui:signPersonalMessage`);\n      }\n      const output = await signMessage.signPersonalMessage({\n        account: core.resolveAccount(account),\n        message: msg,\n      });\n      return {\n        signature: base64ToBytes(output.signature),\n        signedMessage: base64ToBytes(output.bytes),\n      };\n    },\n\n    ...(signTx === undefined\n      ? {}\n      : {\n          async signTransaction(tx, account) {\n            const wsAccount = core.resolveAccount(account);\n            const transaction = coerceSuiTransaction(tx);\n            const output = await signTx.signTransaction({\n              account: wsAccount,\n              chain: core.currentChainId(),\n              transaction,\n            });\n            return base64ToBytes(output.bytes);\n          },\n        }),\n  };\n};\n\n/**\n * Subscribe to Sui Wallet Standard announcements.\n * Spec: https://docs.sui.io/standards/wallet-standard\n *\n * Runtime requires the `@wallet-standard/app` package, which is an\n * **optional peer dependency** of butr.\n *\n * Sui wallets share the same `getWallets()` bus as SVM wallets; Phantom\n * advertises features for SVM, Sui, and Bitcoin from a single Wallet\n * Standard wallet object. `buildSuiAdapter` returns `null` for wallets\n * that don't advertise any `sui:*` features, so we cleanly end up with\n * one adapter per platform on multi-chain wallets.\n *\n * The discovery loop (dynamic import, dedupe, register / unregister\n * bridge) lives in `@usebutr/wallet-standard-shared`.\n */\nconst discoverSuiAdapters = (onAdapter: (adapter: WalletAdapter) => void): (() => void) =>\n  discoverWalletStandard(onAdapter, (wallet, registerDisconnector) =>\n    buildSuiAdapter(wallet, registerDisconnector),\n  );\n\nexport { buildSuiAdapter, discoverSuiAdapters };\n","import type { ChainBase } from \"@usebutr/core\";\n\n// Sui wallets follow the Wallet Standard convention of advertising\n// chains as `sui:mainnet` / `sui:testnet` / `sui:devnet` / `sui:localnet`\n// rather than the strict CAIP-2 form (the genesis-checkpoint hash).\n// Sui Wallet, Suiet, Phantom (Sui), and Surf all exchange these short\n// names; the adapter's `switchChain` rejects anything else.\nconst SUI_CHAINS = {\n  devnet: { id: \"sui:devnet\", name: \"Sui Devnet\", namespace: \"sui\", reference: \"devnet\" },\n  localnet: {\n    id: \"sui:localnet\",\n    name: \"Sui Localnet\",\n    namespace: \"sui\",\n    reference: \"localnet\",\n  },\n  mainnet: {\n    id: \"sui:mainnet\",\n    name: \"Sui Mainnet\",\n    namespace: \"sui\",\n    reference: \"mainnet\",\n  },\n  testnet: { id: \"sui:testnet\", name: \"Sui Testnet\", namespace: \"sui\", reference: \"testnet\" },\n} as const satisfies Record<string, ChainBase>;\n\nconst SUI_CHAINS_LIST: ReadonlyArray<ChainBase> = Object.values(SUI_CHAINS);\n\nexport { SUI_CHAINS, SUI_CHAINS_LIST };\n","import type { PlatformDiscoverer } from \"@usebutr/core\";\n\nimport { discoverSuiAdapters } from \"./wallet-standard-adapter\";\n\n/**\n * Sui's `PlatformDiscoverer`: Sui Wallet Standard announcements. No\n * legacy fallback; Sui standardised on Wallet Standard from launch.\n */\nconst suiDiscoverer: PlatformDiscoverer = {\n  subscribe: discoverSuiAdapters,\n};\n\nexport { suiDiscoverer };\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/capabilities.ts","../src/wallet-standard-adapter.ts","../src/chains.ts","../src/discoverer.ts"],"sourcesContent":["import type { WalletCapabilities } from \"@usebutr/core\";\nimport { buildWalletCapabilities } from \"@usebutr/wallet-standard-shared\";\n\ntype WalletStandardCapabilityInput = {\n  chainCount: number;\n  features: {\n    events: boolean;\n    signAndExecuteTransaction: boolean;\n    signMessage: boolean;\n    signTransaction: boolean;\n  };\n};\n\n/**\n * `signIn` is false: Sui Wallet Standard has no Sign-In-With-Sui feature.\n * `signAndExecuteTransaction` means the wallet broadcasts, while\n * `signTransaction` is sign-only and leaves the broadcast to the consumer.\n */\nconst resolveSuiCapabilities = (input: WalletStandardCapabilityInput): WalletCapabilities =>\n  buildWalletCapabilities({\n    chainCount: input.chainCount,\n    events: input.features.events,\n    sendTransaction: input.features.signAndExecuteTransaction,\n    signIn: false,\n    signMessage: input.features.signMessage,\n    signTransaction: input.features.signTransaction,\n  });\n\nexport type { WalletStandardCapabilityInput };\nexport { resolveSuiCapabilities };\n","import type { TransactionInput, WalletAdapter } from \"@usebutr/core\";\nimport { base64ToBytes, bytesToBase64 } from \"@usebutr/core\";\nimport {\n  createWalletStandardCore,\n  discoverWalletStandard,\n  getFeature,\n  slugify,\n} from \"@usebutr/wallet-standard-shared\";\nimport type { WalletStandardFeature, WalletStandardWallet } from \"@usebutr/wallet-standard-shared\";\n\nimport { resolveSuiCapabilities } from \"./capabilities\";\nimport type {\n  SuiSignAndExecuteTransactionFeature,\n  SuiSignPersonalMessageFeature,\n  SuiSignTransactionFeature,\n} from \"./wallet-standard-types\";\n\nconst SUI_PREFIX = \"sui:\";\nconst SUI_DECIMALS = 9;\nconst SUI_MAINNET = \"sui:mainnet\";\n\nconst isSuiSignPersonalMessageFeature = (\n  feature: WalletStandardFeature,\n): feature is WalletStandardFeature & SuiSignPersonalMessageFeature =>\n  \"signPersonalMessage\" in feature && typeof feature.signPersonalMessage === \"function\";\n\nconst isSuiSignAndExecuteTransactionFeature = (\n  feature: WalletStandardFeature,\n): feature is WalletStandardFeature & SuiSignAndExecuteTransactionFeature =>\n  \"signAndExecuteTransaction\" in feature && typeof feature.signAndExecuteTransaction === \"function\";\n\nconst isSuiSignTransactionFeature = (\n  feature: WalletStandardFeature,\n): feature is WalletStandardFeature & SuiSignTransactionFeature =>\n  \"signTransaction\" in feature && typeof feature.signTransaction === \"function\";\n\n/** Coerce butr's `unknown` tx into the shape the Sui Wallet Standard features\n *  expect: an object with `toJSON()` returning a Promise<string>. A raw string\n *  or BCS byte array is wrapped, because wallets accept only the `toJSON()`\n *  form and a bare string reaches them as a shape they cannot consume. */\nconst coerceSuiTransaction = (tx: TransactionInput) => {\n  if (typeof tx === \"string\") {\n    return { toJSON: () => Promise.resolve(tx) };\n  }\n  if (tx instanceof Uint8Array) {\n    const encoded = bytesToBase64(tx);\n    return { toJSON: () => Promise.resolve(encoded) };\n  }\n  if (typeof tx === \"object\" && tx !== null && \"toJSON\" in tx && typeof tx.toJSON === \"function\") {\n    return { toJSON: tx.toJSON };\n  }\n  throw new TypeError(\n    \"Sui sendTx/signTransaction expects a @mysten/sui Transaction (with toJSON()), a base64-encoded string, or BCS bytes\",\n  );\n};\n\n/**\n * Sui Wallet Standard has no \"switch network\" RPC, so `switchChain` moves\n * butr's view only and the wallet's own UI owns its cluster. Balance and\n * receipt reads need `@mysten/sui`'s `SuiClient`, which butr doesn't ship.\n */\nconst buildSuiAdapter = (\n  wallet: WalletStandardWallet,\n  /** Optional. Called with a function that pushes a synthetic\n   *  `disconnected` event to all current subscribers. The discovery\n   *  layer invokes it on Wallet Standard `unregister`. */\n  registerDisconnector?: (emit: () => void) => void,\n): WalletAdapter | null => {\n  const core = createWalletStandardCore({\n    chainPrefix: SUI_PREFIX,\n    id: slugify(\"sui\", wallet.name),\n    label: \"Sui\",\n    namespace: \"sui\",\n    platform: \"Sui\",\n    preferredChainIds: [SUI_MAINNET],\n    registerDisconnector,\n    trackChainChanges: true,\n    wallet,\n  });\n  if (core === null) {\n    return null;\n  }\n\n  const signMessage = getFeature(\n    wallet,\n    \"sui:signPersonalMessage\",\n    isSuiSignPersonalMessageFeature,\n  );\n  const signAndExecute = getFeature(\n    wallet,\n    \"sui:signAndExecuteTransaction\",\n    isSuiSignAndExecuteTransactionFeature,\n  );\n  const signTx = getFeature(wallet, \"sui:signTransaction\", isSuiSignTransactionFeature);\n\n  /** Resolve a caller-supplied target into a chain the wallet advertises,\n   *  accepting either a full CAIP-2 id (`sui:testnet`) or a bare reference. */\n  const resolveTargetChain = (targetChainId: string): string => {\n    const candidate = targetChainId.startsWith(SUI_PREFIX)\n      ? targetChainId\n      : `${SUI_PREFIX}${targetChainId}`;\n    if (!wallet.chains.includes(candidate)) {\n      throw new Error(\n        `Wallet ${wallet.name} does not advertise chain \"${candidate}\". Available: ${wallet.chains.join(\", \")}`,\n      );\n    }\n    return candidate;\n  };\n\n  const executeTx = async (\n    tx: TransactionInput,\n    account?: { walletAddress: string },\n    chain?: string,\n  ): Promise<string> => {\n    if (signAndExecute === undefined) {\n      throw new Error(`Wallet ${wallet.name} does not advertise sui:signAndExecuteTransaction`);\n    }\n    const wsAccount = core.resolveAccount(account);\n    const transaction = coerceSuiTransaction(tx);\n    const output = await signAndExecute.signAndExecuteTransaction({\n      account: wsAccount,\n      chain: chain ?? core.currentChainId(),\n      transaction,\n    });\n    return output.digest;\n  };\n\n  const adapter: WalletAdapter = {\n    ...core,\n    capabilities: resolveSuiCapabilities({\n      chainCount: core.chainCount,\n      features: {\n        events: core.hasEvents,\n        signAndExecuteTransaction: Boolean(signAndExecute),\n        signMessage: Boolean(signMessage),\n        signTransaction: Boolean(signTx),\n      },\n    }),\n    chainPlatform: \"sui\",\n\n    getBalance: () =>\n      Promise.resolve({\n        decimals: SUI_DECIMALS,\n        formatted: \"0\",\n        symbol: \"SUI\",\n        value: 0n,\n      }),\n\n    getTransactionReceipt: () => Promise.resolve({ status: \"Pending\" as const }),\n\n    async requestAccounts() {\n      await core.connect();\n    },\n\n    sendTx: (tx, account) => executeTx(tx, account),\n\n    async sendTxToChain(tx, targetChainId, account, cb) {\n      const target = resolveTargetChain(targetChainId);\n      if (target !== core.currentChainId()) {\n        cb?.();\n      }\n      const digest = await executeTx(tx, account, target);\n      return digest;\n    },\n\n    async signMessage(msg, account) {\n      if (signMessage === undefined) {\n        throw new Error(`Wallet ${wallet.name} does not advertise sui:signPersonalMessage`);\n      }\n      const output = await signMessage.signPersonalMessage({\n        account: core.resolveAccount(account),\n        message: msg,\n      });\n      return {\n        signature: base64ToBytes(output.signature),\n        signedMessage: base64ToBytes(output.bytes),\n      };\n    },\n  };\n\n  if (signTx !== undefined) {\n    adapter.signTransaction = async (tx, account) => {\n      const wsAccount = core.resolveAccount(account);\n      const transaction = coerceSuiTransaction(tx);\n      const output = await signTx.signTransaction({\n        account: wsAccount,\n        chain: core.currentChainId(),\n        transaction,\n      });\n      return {\n        bytes: base64ToBytes(output.bytes),\n        signature: base64ToBytes(output.signature),\n      };\n    };\n  }\n\n  return adapter;\n};\n\n/**\n * Requires the optional `@wallet-standard/app` peer dep.\n * Spec: https://docs.sui.io/standards/wallet-standard\n */\nconst discoverSuiAdapters = (onAdapter: (adapter: WalletAdapter) => void): (() => void) =>\n  discoverWalletStandard(onAdapter, (wallet, registerDisconnector) =>\n    buildSuiAdapter(wallet, registerDisconnector),\n  );\n\nexport { buildSuiAdapter, discoverSuiAdapters };\n","import type { ChainBase } from \"@usebutr/core\";\n\nconst SUI_CHAINS = {\n  devnet: { id: \"sui:devnet\", name: \"Sui Devnet\", namespace: \"sui\", reference: \"devnet\" },\n  localnet: {\n    id: \"sui:localnet\",\n    name: \"Sui Localnet\",\n    namespace: \"sui\",\n    reference: \"localnet\",\n  },\n  mainnet: {\n    id: \"sui:mainnet\",\n    name: \"Sui Mainnet\",\n    namespace: \"sui\",\n    reference: \"mainnet\",\n  },\n  testnet: { id: \"sui:testnet\", name: \"Sui Testnet\", namespace: \"sui\", reference: \"testnet\" },\n} as const satisfies Record<string, ChainBase>;\n\nconst SUI_CHAINS_LIST: ReadonlyArray<ChainBase> = Object.values(SUI_CHAINS);\n\nexport { SUI_CHAINS, SUI_CHAINS_LIST };\n","import type { PlatformDiscoverer } from \"@usebutr/core\";\n\nimport { discoverSuiAdapters } from \"./wallet-standard-adapter\";\n\n/**\n * Sui's `PlatformDiscoverer`: Sui Wallet Standard announcements. No\n * legacy fallback; Sui standardised on Wallet Standard from launch.\n */\nconst suiDiscoverer: PlatformDiscoverer = {\n  subscribe: discoverSuiAdapters,\n};\n\nexport { suiDiscoverer };\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,21 @@
 {
   "name": "@usebutr/sui",
-  "version": "1.0.1",
+  "version": "2.0.2",
   "description": "Wallet Standard adapter for butr (Sui).",
+  "keywords": [
+    "butr",
+    "dapp",
+    "react",
+    "sui",
+    "typescript",
+    "wallet",
+    "wallet-standard",
+    "web3"
+  ],
+  "homepage": "https://docs.usebutr.com/api/sui",
+  "bugs": {
+    "url": "https://github.com/pedroapfilho/usebutr/issues"
+  },
   "license": "MIT",
   "author": "Pedro Filho <pedro@filho.me>",
   "repository": {
@@ -10,7 +24,8 @@
     "directory": "packages/sui"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "type": "module",
   "sideEffects": false,
@@ -25,12 +40,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@usebutr/core": "1.1.0",
-    "@usebutr/wallet-standard-shared": "0.4.1"
+    "@usebutr/core": "2.0.1",
+    "@usebutr/wallet-standard-shared": "1.0.0"
   },
   "devDependencies": {
     "@wallet-standard/app": "^1.1.1",
-    "typescript": "^6.0.3",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.10",
     "@repo/config-vitest": "0.0.0",
     "@repo/typescript-config": "0.0.0"
@@ -47,7 +62,6 @@
     "build": "tsdown",
     "clean": "rm -rf dist",
     "dev": "tsdown --watch",
-    "lint": "oxlint src",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage --passWithNoTests",
     "typecheck": "tsc -p tsconfig.json --noEmit"