@usebutr/sui 1.0.0 → 2.0.0

package/dist/index.d.ts

@@ -17,7 +17,7 @@ type SuiSignTransactionInput = {
   chain: string;
   transaction: {
     toJSON: () => Promise<string>;
-  } | string;
+  };
 };
 type SuiSignTransactionOutput = {
   bytes: string;
@@ -31,7 +31,7 @@ type SuiSignAndExecuteTransactionInput = {
   chain: string;
   transaction: {
     toJSON: () => Promise<string>;
-  } | string;
+  };
 };
 type SuiSignAndExecuteTransactionOutput = {
   bytes: string;
@@ -45,22 +45,9 @@ type SuiSignAndExecuteTransactionFeature = {
 //#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 +55,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 +100,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 +115,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;;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;;;;;;;;;cCPT,kBACJ,QAAQ,sBAIR;;;;AAAA,wBAAwB,8BACvB;;;;;cAqIG,sBAAuB,YAAY,SAAS;;;cCxL5C;;;;;;;;;;;;;;;;;;;;;;;;;;cAiBA,iBAAiB,cAAc;;;KChBhC;EACH;EACA;IACE;IACA;IACA;IACA;;;;;;;;cASE,yBAA0B,OAAO,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,23 @@ 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`. */
+/** 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 === "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 tx;
-	throw new TypeError("Sui sendTx/signTransaction expects a @mysten/sui Transaction (with toJSON()) or a base64-encoded string");
+	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({
@@ -71,13 +55,20 @@ const buildSuiAdapter = (wallet, registerDisconnector) => {
 	const signMessage = getFeature(wallet, "sui:signPersonalMessage");
 	const signAndExecute = getFeature(wallet, "sui:signAndExecuteTransaction");
 	const signTx = getFeature(wallet, "sui:signTransaction");
-	const executeTx = async (tx, account) => {
+	/** 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;
 	};
@@ -104,9 +95,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`);
@@ -122,29 +114,21 @@ const buildSuiAdapter = (wallet, registerDisconnector) => {
 		...signTx === void 0 ? {} : { async signTransaction(tx, account) {
 			const wsAccount = core.resolveAccount(account);
 			const transaction = coerceSuiTransaction(tx);
-			return base64ToBytes((await signTx.signTransaction({
+			const output = await signTx.signTransaction({
 				account: wsAccount,
 				chain: core.currentChainId(),
 				transaction
-			})).bytes);
+			});
+			return {
+				bytes: base64ToBytes(output.bytes),
+				signature: base64ToBytes(output.signature)
+			};
 		} }
 	};
 };
 /**
-* 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 { 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 { 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 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: unknown): { toJSON: () => Promise<string> } => {\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    // 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()), 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<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  /** 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: unknown,\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  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    // Async so an unadvertised chain surfaces as a rejection rather than a\n    // synchronous throw; the declared return type is a promise either way.\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    ...(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 {\n              bytes: base64ToBytes(output.bytes),\n              signature: base64ToBytes(output.signature),\n            };\n          },\n        }),\n  };\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,6 +1,6 @@
 {
   "name": "@usebutr/sui",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Wallet Standard adapter for butr (Sui).",
   "license": "MIT",
   "author": "Pedro Filho <pedro@filho.me>",
@@ -25,8 +25,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@usebutr/core": "1.0.0",
-    "@usebutr/wallet-standard-shared": "0.4.0"
+    "@usebutr/core": "2.0.0",
+    "@usebutr/wallet-standard-shared": "0.5.0"
   },
   "devDependencies": {
     "@wallet-standard/app": "^1.1.1",
@@ -47,7 +47,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"