@iota/dapp-kit 0.0.0-experimental-20250610130929

package/dist/cjs/hooks/wallet/useDisconnectWallet.js

@@ -0,0 +1,132 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/wallet/useDisconnectWallet.ts
+var useDisconnectWallet_exports = {};
+__export(useDisconnectWallet_exports, {
+  useDisconnectWallet: () => useDisconnectWallet
+});
+module.exports = __toCommonJS(useDisconnectWallet_exports);
+var import_react_query = require("@tanstack/react-query");
+
+// src/constants/walletMutationKeys.ts
+var walletMutationKeys = {
+  all: { baseScope: "wallet" },
+  connectWallet: formMutationKeyFn("connect-wallet"),
+  autoconnectWallet: formMutationKeyFn("autoconnect-wallet"),
+  disconnectWallet: formMutationKeyFn("disconnect-wallet"),
+  signPersonalMessage: formMutationKeyFn("sign-personal-message"),
+  signTransaction: formMutationKeyFn("sign-transaction"),
+  signAndExecuteTransaction: formMutationKeyFn("sign-and-execute-transaction"),
+  switchAccount: formMutationKeyFn("switch-account"),
+  reportTransactionEffects: formMutationKeyFn("report-transaction-effects")
+};
+function formMutationKeyFn(baseEntity) {
+  return function mutationKeyFn(additionalKeys = []) {
+    return [{ ...walletMutationKeys.all, baseEntity }, ...additionalKeys];
+  };
+}
+
+// src/errors/walletErrors.ts
+var WalletNotConnectedError = class extends Error {
+};
+
+// src/hooks/wallet/useWalletStore.ts
+var import_react2 = require("react");
+var import_zustand = require("zustand");
+
+// src/contexts/walletContext.ts
+var import_react = require("react");
+var WalletContext = (0, import_react.createContext)(null);
+
+// src/hooks/wallet/useWalletStore.ts
+function useWalletStore(selector) {
+  const store = (0, import_react2.useContext)(WalletContext);
+  if (!store) {
+    throw new Error(
+      "Could not find WalletContext. Ensure that you have set up the WalletProvider."
+    );
+  }
+  return (0, import_zustand.useStore)(store, selector);
+}
+
+// src/hooks/wallet/useCurrentWallet.ts
+function useCurrentWallet() {
+  const currentWallet = useWalletStore((state) => state.currentWallet);
+  const connectionStatus = useWalletStore((state) => state.connectionStatus);
+  const supportedIntents = useWalletStore((state) => state.supportedIntents);
+  switch (connectionStatus) {
+    case "connecting":
+      return {
+        connectionStatus,
+        currentWallet: null,
+        isDisconnected: false,
+        isConnecting: true,
+        isConnected: false,
+        supportedIntents: []
+      };
+    case "disconnected":
+      return {
+        connectionStatus,
+        currentWallet: null,
+        isDisconnected: true,
+        isConnecting: false,
+        isConnected: false,
+        supportedIntents: []
+      };
+    case "connected": {
+      return {
+        connectionStatus,
+        currentWallet,
+        isDisconnected: false,
+        isConnecting: false,
+        isConnected: true,
+        supportedIntents
+      };
+    }
+  }
+}
+
+// src/hooks/wallet/useDisconnectWallet.ts
+function useDisconnectWallet({
+  mutationKey,
+  ...mutationOptions
+} = {}) {
+  const { currentWallet } = useCurrentWallet();
+  const setWalletDisconnected = useWalletStore((state) => state.setWalletDisconnected);
+  return (0, import_react_query.useMutation)({
+    mutationKey: walletMutationKeys.disconnectWallet(mutationKey),
+    mutationFn: async () => {
+      if (!currentWallet) {
+        throw new WalletNotConnectedError("No wallet is connected.");
+      }
+      try {
+        await currentWallet.features["standard:disconnect"]?.disconnect();
+      } catch (error) {
+        console.error(
+          "Failed to disconnect the application from the current wallet.",
+          error
+        );
+      }
+      setWalletDisconnected();
+    },
+    ...mutationOptions
+  });
+}
+//# sourceMappingURL=useDisconnectWallet.js.map

package/dist/cjs/hooks/wallet/useDisconnectWallet.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/hooks/wallet/useDisconnectWallet.ts", "../../../../src/constants/walletMutationKeys.ts", "../../../../src/errors/walletErrors.ts", "../../../../src/hooks/wallet/useWalletStore.ts", "../../../../src/contexts/walletContext.ts", "../../../../src/hooks/wallet/useCurrentWallet.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';\nimport { useMutation } from '@tanstack/react-query';\n\nimport { walletMutationKeys } from '../../constants/walletMutationKeys.js';\nimport { WalletNotConnectedError } from '../../errors/walletErrors.js';\nimport { useCurrentWallet } from './useCurrentWallet.js';\nimport { useWalletStore } from './useWalletStore.js';\n\ntype UseDisconnectWalletError = WalletNotConnectedError | Error;\n\ntype UseDisconnectWalletMutationOptions = Omit<\n    UseMutationOptions<void, UseDisconnectWalletError, void, unknown>,\n    'mutationFn'\n>;\n\n/**\n * Mutation hook for disconnecting from an active wallet connection, if currently connected.\n */\nexport function useDisconnectWallet({\n    mutationKey,\n    ...mutationOptions\n}: UseDisconnectWalletMutationOptions = {}): UseMutationResult<\n    void,\n    UseDisconnectWalletError,\n    void\n> {\n    const { currentWallet } = useCurrentWallet();\n    const setWalletDisconnected = useWalletStore((state) => state.setWalletDisconnected);\n\n    return useMutation({\n        mutationKey: walletMutationKeys.disconnectWallet(mutationKey),\n        mutationFn: async () => {\n            if (!currentWallet) {\n                throw new WalletNotConnectedError('No wallet is connected.');\n            }\n\n            try {\n                // Wallets aren't required to implement the disconnect feature, so we'll\n                // optionally call the disconnect feature if it exists and reset the UI\n                // state on the frontend at a minimum.\n                await currentWallet.features['standard:disconnect']?.disconnect();\n            } catch (error) {\n                console.error(\n                    'Failed to disconnect the application from the current wallet.',\n                    error,\n                );\n            }\n\n            setWalletDisconnected();\n        },\n        ...mutationOptions,\n    });\n}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { MutationKey } from '@tanstack/react-query';\n\nexport const walletMutationKeys = {\n    all: { baseScope: 'wallet' },\n    connectWallet: formMutationKeyFn('connect-wallet'),\n    autoconnectWallet: formMutationKeyFn('autoconnect-wallet'),\n    disconnectWallet: formMutationKeyFn('disconnect-wallet'),\n    signPersonalMessage: formMutationKeyFn('sign-personal-message'),\n    signTransaction: formMutationKeyFn('sign-transaction'),\n    signAndExecuteTransaction: formMutationKeyFn('sign-and-execute-transaction'),\n    switchAccount: formMutationKeyFn('switch-account'),\n    reportTransactionEffects: formMutationKeyFn('report-transaction-effects'),\n};\n\nfunction formMutationKeyFn(baseEntity: string) {\n    return function mutationKeyFn(additionalKeys: MutationKey = []) {\n        return [{ ...walletMutationKeys.all, baseEntity }, ...additionalKeys];\n    };\n}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * An error that is instantiated when someone attempts to perform an action that requires an active wallet connection.\n */\nexport class WalletNotConnectedError extends Error {}\n\n/**\n * An error that is instantiated when someone attempts to perform an action that requires a selected wallet account.\n * This is more of an edge case stemming from the fact that wallets don't technically require you to authorize any\n * accounts when connecting a wallet.\n */\nexport class WalletNoAccountSelectedError extends Error {}\n\n/**\n * An error that is instantiated when someone attempts to perform an action that isn't supported by a wallet.\n */\nexport class WalletFeatureNotSupportedError extends Error {}\n\n/**\n * An error that is instantiated when a wallet account can't be found for a specific wallet.\n */\nexport class WalletAccountNotFoundError extends Error {}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { useContext } from 'react';\nimport { useStore } from 'zustand';\n\nimport { WalletContext } from '../../contexts/walletContext.js';\nimport type { StoreState } from '../../walletStore.js';\n\nexport function useWalletStore<T>(selector: (state: StoreState) => T): T {\n    const store = useContext(WalletContext);\n    if (!store) {\n        throw new Error(\n            'Could not find WalletContext. Ensure that you have set up the WalletProvider.',\n        );\n    }\n    return useStore(store, selector);\n}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { createContext } from 'react';\n\nimport type { WalletStore } from '../walletStore.js';\n\nexport const WalletContext = createContext<WalletStore | null>(null);\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { useWalletStore } from './useWalletStore.js';\n\n/**\n * Retrieves the wallet that is currently connected to the dApp, if one exists.\n */\nexport function useCurrentWallet() {\n    const currentWallet = useWalletStore((state) => state.currentWallet);\n    const connectionStatus = useWalletStore((state) => state.connectionStatus);\n    const supportedIntents = useWalletStore((state) => state.supportedIntents);\n\n    switch (connectionStatus) {\n        case 'connecting':\n            return {\n                connectionStatus,\n                currentWallet: null,\n                isDisconnected: false,\n                isConnecting: true,\n                isConnected: false,\n                supportedIntents: [],\n            } as const;\n        case 'disconnected':\n            return {\n                connectionStatus,\n                currentWallet: null,\n                isDisconnected: true,\n                isConnecting: false,\n                isConnected: false,\n                supportedIntents: [],\n            } as const;\n        case 'connected': {\n            return {\n                connectionStatus,\n                currentWallet: currentWallet!,\n                isDisconnected: false,\n                isConnecting: false,\n                isConnected: true,\n                supportedIntents,\n            } as const;\n        }\n    }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,yBAA4B;;;ACCrB,IAAM,qBAAqB;AAAA,EAC9B,KAAK,EAAE,WAAW,SAAS;AAAA,EAC3B,eAAe,kBAAkB,gBAAgB;AAAA,EACjD,mBAAmB,kBAAkB,oBAAoB;AAAA,EACzD,kBAAkB,kBAAkB,mBAAmB;AAAA,EACvD,qBAAqB,kBAAkB,uBAAuB;AAAA,EAC9D,iBAAiB,kBAAkB,kBAAkB;AAAA,EACrD,2BAA2B,kBAAkB,8BAA8B;AAAA,EAC3E,eAAe,kBAAkB,gBAAgB;AAAA,EACjD,0BAA0B,kBAAkB,4BAA4B;AAC5E;AAEA,SAAS,kBAAkB,YAAoB;AAC3C,SAAO,SAAS,cAAc,iBAA8B,CAAC,GAAG;AAC5D,WAAO,CAAC,EAAE,GAAG,mBAAmB,KAAK,WAAW,GAAG,GAAG,cAAc;AAAA,EACxE;AACJ;;;ACfO,IAAM,0BAAN,cAAsC,MAAM;AAAC;;;ACHpD,IAAAA,gBAA2B;AAC3B,qBAAyB;;;ACDzB,mBAA8B;AAIvB,IAAM,oBAAgB,4BAAkC,IAAI;;;ADE5D,SAAS,eAAkB,UAAuC;AACrE,QAAM,YAAQ,0BAAW,aAAa;AACtC,MAAI,CAAC,OAAO;AACR,UAAM,IAAI;AAAA,MACN;AAAA,IACJ;AAAA,EACJ;AACA,aAAO,yBAAS,OAAO,QAAQ;AACnC;;;AETO,SAAS,mBAAmB;AAC/B,QAAM,gBAAgB,eAAe,CAAC,UAAU,MAAM,aAAa;AACnE,QAAM,mBAAmB,eAAe,CAAC,UAAU,MAAM,gBAAgB;AACzE,QAAM,mBAAmB,eAAe,CAAC,UAAU,MAAM,gBAAgB;AAEzE,UAAQ,kBAAkB;AAAA,IACtB,KAAK;AACD,aAAO;AAAA,QACH;AAAA,QACA,eAAe;AAAA,QACf,gBAAgB;AAAA,QAChB,cAAc;AAAA,QACd,aAAa;AAAA,QACb,kBAAkB,CAAC;AAAA,MACvB;AAAA,IACJ,KAAK;AACD,aAAO;AAAA,QACH;AAAA,QACA,eAAe;AAAA,QACf,gBAAgB;AAAA,QAChB,cAAc;AAAA,QACd,aAAa;AAAA,QACb,kBAAkB,CAAC;AAAA,MACvB;AAAA,IACJ,KAAK,aAAa;AACd,aAAO;AAAA,QACH;AAAA,QACA;AAAA,QACA,gBAAgB;AAAA,QAChB,cAAc;AAAA,QACd,aAAa;AAAA,QACb;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACJ;;;ALtBO,SAAS,oBAAoB;AAAA,EAChC;AAAA,EACA,GAAG;AACP,IAAwC,CAAC,GAIvC;AACE,QAAM,EAAE,cAAc,IAAI,iBAAiB;AAC3C,QAAM,wBAAwB,eAAe,CAAC,UAAU,MAAM,qBAAqB;AAEnF,aAAO,gCAAY;AAAA,IACf,aAAa,mBAAmB,iBAAiB,WAAW;AAAA,IAC5D,YAAY,YAAY;AACpB,UAAI,CAAC,eAAe;AAChB,cAAM,IAAI,wBAAwB,yBAAyB;AAAA,MAC/D;AAEA,UAAI;AAIA,cAAM,cAAc,SAAS,qBAAqB,GAAG,WAAW;AAAA,MACpE,SAAS,OAAO;AACZ,gBAAQ;AAAA,UACJ;AAAA,UACA;AAAA,QACJ;AAAA,MACJ;AAEA,4BAAsB;AAAA,IAC1B;AAAA,IACA,GAAG;AAAA,EACP,CAAC;AACL;",
+  "names": ["import_react"]
+}

package/dist/cjs/hooks/wallet/useReportTransactionEffects.d.ts

@@ -0,0 +1,15 @@
+import type { IotaReportTransactionEffectsInput } from '@iota/wallet-standard';
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import type { WalletFeatureNotSupportedError } from '../../errors/walletErrors.js';
+import { WalletNoAccountSelectedError, WalletNotConnectedError } from '../../errors/walletErrors.js';
+import type { PartialBy } from '../../types/utilityTypes.js';
+type UseReportTransactionEffectsArgs = Omit<PartialBy<IotaReportTransactionEffectsInput, 'account' | 'chain'>, 'effects'> & {
+    effects: string | number[];
+};
+type UseReportTransactionEffectsError = WalletFeatureNotSupportedError | WalletNoAccountSelectedError | WalletNotConnectedError | Error;
+type UseReportTransactionEffectsMutationOptions = Omit<UseMutationOptions<void, UseReportTransactionEffectsError, UseReportTransactionEffectsArgs, unknown>, 'mutationFn'>;
+/**
+ * Mutation hook for prompting the user to sign a message.
+ */
+export declare function useReportTransactionEffects({ mutationKey, ...mutationOptions }?: UseReportTransactionEffectsMutationOptions): UseMutationResult<void, UseReportTransactionEffectsError, UseReportTransactionEffectsArgs>;
+export {};

package/dist/cjs/hooks/wallet/useReportTransactionEffects.js

@@ -0,0 +1,148 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/wallet/useReportTransactionEffects.ts
+var useReportTransactionEffects_exports = {};
+__export(useReportTransactionEffects_exports, {
+  useReportTransactionEffects: () => useReportTransactionEffects
+});
+module.exports = __toCommonJS(useReportTransactionEffects_exports);
+var import_utils = require("@iota/iota-sdk/utils");
+var import_react_query = require("@tanstack/react-query");
+
+// src/constants/walletMutationKeys.ts
+var walletMutationKeys = {
+  all: { baseScope: "wallet" },
+  connectWallet: formMutationKeyFn("connect-wallet"),
+  autoconnectWallet: formMutationKeyFn("autoconnect-wallet"),
+  disconnectWallet: formMutationKeyFn("disconnect-wallet"),
+  signPersonalMessage: formMutationKeyFn("sign-personal-message"),
+  signTransaction: formMutationKeyFn("sign-transaction"),
+  signAndExecuteTransaction: formMutationKeyFn("sign-and-execute-transaction"),
+  switchAccount: formMutationKeyFn("switch-account"),
+  reportTransactionEffects: formMutationKeyFn("report-transaction-effects")
+};
+function formMutationKeyFn(baseEntity) {
+  return function mutationKeyFn(additionalKeys = []) {
+    return [{ ...walletMutationKeys.all, baseEntity }, ...additionalKeys];
+  };
+}
+
+// src/errors/walletErrors.ts
+var WalletNotConnectedError = class extends Error {
+};
+var WalletNoAccountSelectedError = class extends Error {
+};
+
+// src/hooks/wallet/useWalletStore.ts
+var import_react2 = require("react");
+var import_zustand = require("zustand");
+
+// src/contexts/walletContext.ts
+var import_react = require("react");
+var WalletContext = (0, import_react.createContext)(null);
+
+// src/hooks/wallet/useWalletStore.ts
+function useWalletStore(selector) {
+  const store = (0, import_react2.useContext)(WalletContext);
+  if (!store) {
+    throw new Error(
+      "Could not find WalletContext. Ensure that you have set up the WalletProvider."
+    );
+  }
+  return (0, import_zustand.useStore)(store, selector);
+}
+
+// src/hooks/wallet/useCurrentAccount.ts
+function useCurrentAccount() {
+  return useWalletStore((state) => state.currentAccount);
+}
+
+// src/hooks/wallet/useCurrentWallet.ts
+function useCurrentWallet() {
+  const currentWallet = useWalletStore((state) => state.currentWallet);
+  const connectionStatus = useWalletStore((state) => state.connectionStatus);
+  const supportedIntents = useWalletStore((state) => state.supportedIntents);
+  switch (connectionStatus) {
+    case "connecting":
+      return {
+        connectionStatus,
+        currentWallet: null,
+        isDisconnected: false,
+        isConnecting: true,
+        isConnected: false,
+        supportedIntents: []
+      };
+    case "disconnected":
+      return {
+        connectionStatus,
+        currentWallet: null,
+        isDisconnected: true,
+        isConnecting: false,
+        isConnected: false,
+        supportedIntents: []
+      };
+    case "connected": {
+      return {
+        connectionStatus,
+        currentWallet,
+        isDisconnected: false,
+        isConnecting: false,
+        isConnected: true,
+        supportedIntents
+      };
+    }
+  }
+}
+
+// src/hooks/wallet/useReportTransactionEffects.ts
+function useReportTransactionEffects({
+  mutationKey,
+  ...mutationOptions
+} = {}) {
+  const { currentWallet } = useCurrentWallet();
+  const currentAccount = useCurrentAccount();
+  return (0, import_react_query.useMutation)({
+    mutationKey: walletMutationKeys.reportTransactionEffects(mutationKey),
+    mutationFn: async ({
+      effects,
+      chain = currentWallet?.chains[0],
+      account = currentAccount
+    }) => {
+      if (!currentWallet) {
+        throw new WalletNotConnectedError("No wallet is connected.");
+      }
+      if (!account) {
+        throw new WalletNoAccountSelectedError(
+          "No wallet account is selected to report transaction effects for"
+        );
+      }
+      const reportTransactionEffectsFeature = currentWallet.features["iota:reportTransactionEffects"];
+      if (reportTransactionEffectsFeature) {
+        return await reportTransactionEffectsFeature.reportTransactionEffects({
+          effects: Array.isArray(effects) ? (0, import_utils.toB64)(new Uint8Array(effects)) : effects,
+          account,
+          chain: chain ?? currentWallet?.chains[0]
+        });
+      }
+    },
+    ...mutationOptions
+  });
+}
+//# sourceMappingURL=useReportTransactionEffects.js.map

package/dist/cjs/hooks/wallet/useReportTransactionEffects.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/hooks/wallet/useReportTransactionEffects.ts", "../../../../src/constants/walletMutationKeys.ts", "../../../../src/errors/walletErrors.ts", "../../../../src/hooks/wallet/useWalletStore.ts", "../../../../src/contexts/walletContext.ts", "../../../../src/hooks/wallet/useCurrentAccount.ts", "../../../../src/hooks/wallet/useCurrentWallet.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { toB64 } from '@iota/iota-sdk/utils';\nimport type { IotaReportTransactionEffectsInput } from '@iota/wallet-standard';\nimport type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';\nimport { useMutation } from '@tanstack/react-query';\n\nimport { walletMutationKeys } from '../../constants/walletMutationKeys.js';\nimport type { WalletFeatureNotSupportedError } from '../../errors/walletErrors.js';\nimport {\n    WalletNoAccountSelectedError,\n    WalletNotConnectedError,\n} from '../../errors/walletErrors.js';\nimport type { PartialBy } from '../../types/utilityTypes.js';\nimport { useCurrentAccount } from './useCurrentAccount.js';\nimport { useCurrentWallet } from './useCurrentWallet.js';\n\ntype UseReportTransactionEffectsArgs = Omit<\n    PartialBy<IotaReportTransactionEffectsInput, 'account' | 'chain'>,\n    'effects'\n> & {\n    effects: string | number[];\n};\n\ntype UseReportTransactionEffectsError =\n    | WalletFeatureNotSupportedError\n    | WalletNoAccountSelectedError\n    | WalletNotConnectedError\n    | Error;\n\ntype UseReportTransactionEffectsMutationOptions = Omit<\n    UseMutationOptions<\n        void,\n        UseReportTransactionEffectsError,\n        UseReportTransactionEffectsArgs,\n        unknown\n    >,\n    'mutationFn'\n>;\n\n/**\n * Mutation hook for prompting the user to sign a message.\n */\nexport function useReportTransactionEffects({\n    mutationKey,\n    ...mutationOptions\n}: UseReportTransactionEffectsMutationOptions = {}): UseMutationResult<\n    void,\n    UseReportTransactionEffectsError,\n    UseReportTransactionEffectsArgs\n> {\n    const { currentWallet } = useCurrentWallet();\n    const currentAccount = useCurrentAccount();\n\n    return useMutation({\n        mutationKey: walletMutationKeys.reportTransactionEffects(mutationKey),\n        mutationFn: async ({\n            effects,\n            chain = currentWallet?.chains[0],\n            account = currentAccount,\n        }) => {\n            if (!currentWallet) {\n                throw new WalletNotConnectedError('No wallet is connected.');\n            }\n\n            if (!account) {\n                throw new WalletNoAccountSelectedError(\n                    'No wallet account is selected to report transaction effects for',\n                );\n            }\n\n            const reportTransactionEffectsFeature =\n                currentWallet.features['iota:reportTransactionEffects'];\n\n            if (reportTransactionEffectsFeature) {\n                return await reportTransactionEffectsFeature.reportTransactionEffects({\n                    effects: Array.isArray(effects) ? toB64(new Uint8Array(effects)) : effects,\n                    account,\n                    chain: chain ?? currentWallet?.chains[0],\n                });\n            }\n        },\n        ...mutationOptions,\n    });\n}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { MutationKey } from '@tanstack/react-query';\n\nexport const walletMutationKeys = {\n    all: { baseScope: 'wallet' },\n    connectWallet: formMutationKeyFn('connect-wallet'),\n    autoconnectWallet: formMutationKeyFn('autoconnect-wallet'),\n    disconnectWallet: formMutationKeyFn('disconnect-wallet'),\n    signPersonalMessage: formMutationKeyFn('sign-personal-message'),\n    signTransaction: formMutationKeyFn('sign-transaction'),\n    signAndExecuteTransaction: formMutationKeyFn('sign-and-execute-transaction'),\n    switchAccount: formMutationKeyFn('switch-account'),\n    reportTransactionEffects: formMutationKeyFn('report-transaction-effects'),\n};\n\nfunction formMutationKeyFn(baseEntity: string) {\n    return function mutationKeyFn(additionalKeys: MutationKey = []) {\n        return [{ ...walletMutationKeys.all, baseEntity }, ...additionalKeys];\n    };\n}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * An error that is instantiated when someone attempts to perform an action that requires an active wallet connection.\n */\nexport class WalletNotConnectedError extends Error {}\n\n/**\n * An error that is instantiated when someone attempts to perform an action that requires a selected wallet account.\n * This is more of an edge case stemming from the fact that wallets don't technically require you to authorize any\n * accounts when connecting a wallet.\n */\nexport class WalletNoAccountSelectedError extends Error {}\n\n/**\n * An error that is instantiated when someone attempts to perform an action that isn't supported by a wallet.\n */\nexport class WalletFeatureNotSupportedError extends Error {}\n\n/**\n * An error that is instantiated when a wallet account can't be found for a specific wallet.\n */\nexport class WalletAccountNotFoundError extends Error {}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { useContext } from 'react';\nimport { useStore } from 'zustand';\n\nimport { WalletContext } from '../../contexts/walletContext.js';\nimport type { StoreState } from '../../walletStore.js';\n\nexport function useWalletStore<T>(selector: (state: StoreState) => T): T {\n    const store = useContext(WalletContext);\n    if (!store) {\n        throw new Error(\n            'Could not find WalletContext. Ensure that you have set up the WalletProvider.',\n        );\n    }\n    return useStore(store, selector);\n}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { createContext } from 'react';\n\nimport type { WalletStore } from '../walletStore.js';\n\nexport const WalletContext = createContext<WalletStore | null>(null);\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { WalletAccount } from '@iota/wallet-standard';\n\nimport { useWalletStore } from './useWalletStore.js';\n\n/**\n * Retrieves the wallet account that is currently selected, if one exists.\n */\nexport function useCurrentAccount(): WalletAccount | null {\n    return useWalletStore((state) => state.currentAccount);\n}\n", "// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { useWalletStore } from './useWalletStore.js';\n\n/**\n * Retrieves the wallet that is currently connected to the dApp, if one exists.\n */\nexport function useCurrentWallet() {\n    const currentWallet = useWalletStore((state) => state.currentWallet);\n    const connectionStatus = useWalletStore((state) => state.connectionStatus);\n    const supportedIntents = useWalletStore((state) => state.supportedIntents);\n\n    switch (connectionStatus) {\n        case 'connecting':\n            return {\n                connectionStatus,\n                currentWallet: null,\n                isDisconnected: false,\n                isConnecting: true,\n                isConnected: false,\n                supportedIntents: [],\n            } as const;\n        case 'disconnected':\n            return {\n                connectionStatus,\n                currentWallet: null,\n                isDisconnected: true,\n                isConnecting: false,\n                isConnected: false,\n                supportedIntents: [],\n            } as const;\n        case 'connected': {\n            return {\n                connectionStatus,\n                currentWallet: currentWallet!,\n                isDisconnected: false,\n                isConnecting: false,\n                isConnected: true,\n                supportedIntents,\n            } as const;\n        }\n    }\n}\n"],
+  "mappings": "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",
+  "names": ["import_react"]
+}

package/dist/cjs/hooks/wallet/useSignAndExecuteTransaction.d.ts

@@ -0,0 +1,29 @@
+import type { Transaction } from '@iota/iota-sdk/transactions';
+import type { IotaSignAndExecuteTransactionInput, IotaSignAndExecuteTransactionOutput } from '@iota/wallet-standard';
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { WalletFeatureNotSupportedError, WalletNoAccountSelectedError, WalletNotConnectedError } from '../../errors/walletErrors.js';
+import type { PartialBy } from '../../types/utilityTypes.js';
+type UseSignAndExecuteTransactionArgs = PartialBy<Omit<IotaSignAndExecuteTransactionInput, 'transaction'>, 'account' | 'chain'> & {
+    transaction: Transaction | string;
+};
+type UseSignAndExecuteTransactionResult = IotaSignAndExecuteTransactionOutput;
+type UseSignAndExecuteTransactionError = WalletFeatureNotSupportedError | WalletNoAccountSelectedError | WalletNotConnectedError | Error;
+type ExecuteTransactionResult = {
+    digest: string;
+    rawEffects?: number[];
+} | {
+    effects?: {
+        bcs?: string;
+    };
+};
+type UseSignAndExecuteTransactionMutationOptions<Result extends ExecuteTransactionResult> = Omit<UseMutationOptions<Result, UseSignAndExecuteTransactionError, UseSignAndExecuteTransactionArgs, unknown>, 'mutationFn'> & {
+    execute?: ({ bytes, signature }: {
+        bytes: string;
+        signature: string;
+    }) => Promise<Result>;
+};
+/**
+ * Mutation hook for prompting the user to sign and execute a transaction.
+ */
+export declare function useSignAndExecuteTransaction<Result extends ExecuteTransactionResult = UseSignAndExecuteTransactionResult>({ mutationKey, execute, ...mutationOptions }?: UseSignAndExecuteTransactionMutationOptions<Result>): UseMutationResult<Result, UseSignAndExecuteTransactionError, UseSignAndExecuteTransactionArgs>;
+export {};

package/dist/cjs/hooks/wallet/useSignAndExecuteTransaction.js

@@ -0,0 +1,252 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/wallet/useSignAndExecuteTransaction.ts
+var useSignAndExecuteTransaction_exports = {};
+__export(useSignAndExecuteTransaction_exports, {
+  useSignAndExecuteTransaction: () => useSignAndExecuteTransaction
+});
+module.exports = __toCommonJS(useSignAndExecuteTransaction_exports);
+var import_utils2 = require("@iota/iota-sdk/utils");
+var import_wallet_standard = require("@iota/wallet-standard");
+var import_react_query2 = require("@tanstack/react-query");
+
+// src/constants/walletMutationKeys.ts
+var walletMutationKeys = {
+  all: { baseScope: "wallet" },
+  connectWallet: formMutationKeyFn("connect-wallet"),
+  autoconnectWallet: formMutationKeyFn("autoconnect-wallet"),
+  disconnectWallet: formMutationKeyFn("disconnect-wallet"),
+  signPersonalMessage: formMutationKeyFn("sign-personal-message"),
+  signTransaction: formMutationKeyFn("sign-transaction"),
+  signAndExecuteTransaction: formMutationKeyFn("sign-and-execute-transaction"),
+  switchAccount: formMutationKeyFn("switch-account"),
+  reportTransactionEffects: formMutationKeyFn("report-transaction-effects")
+};
+function formMutationKeyFn(baseEntity) {
+  return function mutationKeyFn(additionalKeys = []) {
+    return [{ ...walletMutationKeys.all, baseEntity }, ...additionalKeys];
+  };
+}
+
+// src/errors/walletErrors.ts
+var WalletNotConnectedError = class extends Error {
+};
+var WalletNoAccountSelectedError = class extends Error {
+};
+var WalletFeatureNotSupportedError = class extends Error {
+};
+
+// src/hooks/useIotaClient.ts
+var import_react2 = require("react");
+
+// src/components/IotaClientProvider.tsx
+var import_client = require("@iota/iota-sdk/client");
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var IotaClientContext = (0, import_react.createContext)(null);
+var DEFAULT_NETWORKS = {
+  localnet: { url: (0, import_client.getNetwork)(import_client.Network.Localnet)?.url }
+};
+
+// src/hooks/useIotaClient.ts
+function useIotaClientContext() {
+  const iotaClient = (0, import_react2.useContext)(IotaClientContext);
+  if (!iotaClient) {
+    throw new Error(
+      "Could not find IotaClientContext. Ensure that you have set up the IotaClientProvider"
+    );
+  }
+  return iotaClient;
+}
+function useIotaClient() {
+  return useIotaClientContext().client;
+}
+
+// src/hooks/wallet/useWalletStore.ts
+var import_react4 = require("react");
+var import_zustand = require("zustand");
+
+// src/contexts/walletContext.ts
+var import_react3 = require("react");
+var WalletContext = (0, import_react3.createContext)(null);
+
+// src/hooks/wallet/useWalletStore.ts
+function useWalletStore(selector) {
+  const store = (0, import_react4.useContext)(WalletContext);
+  if (!store) {
+    throw new Error(
+      "Could not find WalletContext. Ensure that you have set up the WalletProvider."
+    );
+  }
+  return (0, import_zustand.useStore)(store, selector);
+}
+
+// src/hooks/wallet/useCurrentAccount.ts
+function useCurrentAccount() {
+  return useWalletStore((state) => state.currentAccount);
+}
+
+// src/hooks/wallet/useCurrentWallet.ts
+function useCurrentWallet() {
+  const currentWallet = useWalletStore((state) => state.currentWallet);
+  const connectionStatus = useWalletStore((state) => state.connectionStatus);
+  const supportedIntents = useWalletStore((state) => state.supportedIntents);
+  switch (connectionStatus) {
+    case "connecting":
+      return {
+        connectionStatus,
+        currentWallet: null,
+        isDisconnected: false,
+        isConnecting: true,
+        isConnected: false,
+        supportedIntents: []
+      };
+    case "disconnected":
+      return {
+        connectionStatus,
+        currentWallet: null,
+        isDisconnected: true,
+        isConnecting: false,
+        isConnected: false,
+        supportedIntents: []
+      };
+    case "connected": {
+      return {
+        connectionStatus,
+        currentWallet,
+        isDisconnected: false,
+        isConnecting: false,
+        isConnected: true,
+        supportedIntents
+      };
+    }
+  }
+}
+
+// src/hooks/wallet/useReportTransactionEffects.ts
+var import_utils = require("@iota/iota-sdk/utils");
+var import_react_query = require("@tanstack/react-query");
+function useReportTransactionEffects({
+  mutationKey,
+  ...mutationOptions
+} = {}) {
+  const { currentWallet } = useCurrentWallet();
+  const currentAccount = useCurrentAccount();
+  return (0, import_react_query.useMutation)({
+    mutationKey: walletMutationKeys.reportTransactionEffects(mutationKey),
+    mutationFn: async ({
+      effects,
+      chain = currentWallet?.chains[0],
+      account = currentAccount
+    }) => {
+      if (!currentWallet) {
+        throw new WalletNotConnectedError("No wallet is connected.");
+      }
+      if (!account) {
+        throw new WalletNoAccountSelectedError(
+          "No wallet account is selected to report transaction effects for"
+        );
+      }
+      const reportTransactionEffectsFeature = currentWallet.features["iota:reportTransactionEffects"];
+      if (reportTransactionEffectsFeature) {
+        return await reportTransactionEffectsFeature.reportTransactionEffects({
+          effects: Array.isArray(effects) ? (0, import_utils.toB64)(new Uint8Array(effects)) : effects,
+          account,
+          chain: chain ?? currentWallet?.chains[0]
+        });
+      }
+    },
+    ...mutationOptions
+  });
+}
+
+// src/hooks/wallet/useSignAndExecuteTransaction.ts
+function useSignAndExecuteTransaction({
+  mutationKey,
+  execute,
+  ...mutationOptions
+} = {}) {
+  const { currentWallet, supportedIntents } = useCurrentWallet();
+  const currentAccount = useCurrentAccount();
+  const client = useIotaClient();
+  const { mutate: reportTransactionEffects } = useReportTransactionEffects();
+  const executeTransaction = execute ?? (async ({ bytes, signature }) => {
+    const { digest, rawEffects } = await client.executeTransactionBlock({
+      transactionBlock: bytes,
+      signature,
+      options: {
+        showRawEffects: true
+      }
+    });
+    return {
+      digest,
+      rawEffects,
+      effects: (0, import_utils2.toB64)(new Uint8Array(rawEffects)),
+      bytes,
+      signature
+    };
+  });
+  return (0, import_react_query2.useMutation)({
+    mutationKey: walletMutationKeys.signAndExecuteTransaction(mutationKey),
+    mutationFn: async ({ transaction, ...signTransactionArgs }) => {
+      if (!currentWallet) {
+        throw new WalletNotConnectedError("No wallet is connected.");
+      }
+      const signerAccount = signTransactionArgs.account ?? currentAccount;
+      if (!signerAccount) {
+        throw new WalletNoAccountSelectedError(
+          "No wallet account is selected to sign the transaction with."
+        );
+      }
+      const chain = signTransactionArgs.chain ?? signerAccount?.chains[0];
+      if (!currentWallet.features["iota:signTransaction"]) {
+        throw new WalletFeatureNotSupportedError(
+          "This wallet doesn't support the `signTransaction` feature."
+        );
+      }
+      const { signature, bytes } = await (0, import_wallet_standard.signTransaction)(currentWallet, {
+        ...signTransactionArgs,
+        transaction: {
+          async toJSON() {
+            return typeof transaction === "string" ? transaction : await transaction.toJSON({
+              supportedIntents,
+              client
+            });
+          }
+        },
+        account: signerAccount,
+        chain: signTransactionArgs.chain ?? signerAccount.chains[0]
+      });
+      const result = await executeTransaction({ bytes, signature });
+      let effects;
+      if ("effects" in result && result.effects?.bcs) {
+        effects = result.effects.bcs;
+      } else if ("rawEffects" in result) {
+        effects = (0, import_utils2.toB64)(new Uint8Array(result.rawEffects));
+      } else {
+        throw new Error("Could not parse effects from transaction result.");
+      }
+      reportTransactionEffects({ effects, account: signerAccount, chain });
+      return result;
+    },
+    ...mutationOptions
+  });
+}
+//# sourceMappingURL=useSignAndExecuteTransaction.js.map