@iota/dapp-kit 0.0.0-experimental-20250610130929

package/src/hooks/wallet/useSignAndExecuteTransaction.ts

@@ -0,0 +1,165 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Transaction } from '@iota/iota-sdk/transactions';
+import { toB64 } from '@iota/iota-sdk/utils';
+import type {
+    IotaSignAndExecuteTransactionInput,
+    IotaSignAndExecuteTransactionOutput,
+} from '@iota/wallet-standard';
+import { signTransaction } from '@iota/wallet-standard';
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { useMutation } from '@tanstack/react-query';
+
+import { walletMutationKeys } from '../../constants/walletMutationKeys.js';
+import {
+    WalletFeatureNotSupportedError,
+    WalletNoAccountSelectedError,
+    WalletNotConnectedError,
+} from '../../errors/walletErrors.js';
+import type { PartialBy } from '../../types/utilityTypes.js';
+import { useIotaClient } from '../useIotaClient.js';
+import { useCurrentAccount } from './useCurrentAccount.js';
+import { useCurrentWallet } from './useCurrentWallet.js';
+import { useReportTransactionEffects } from './useReportTransactionEffects.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 function useSignAndExecuteTransaction<
+    Result extends ExecuteTransactionResult = UseSignAndExecuteTransactionResult,
+>({
+    mutationKey,
+    execute,
+    ...mutationOptions
+}: UseSignAndExecuteTransactionMutationOptions<Result> = {}): UseMutationResult<
+    Result,
+    UseSignAndExecuteTransactionError,
+    UseSignAndExecuteTransactionArgs
+> {
+    const { currentWallet, supportedIntents } = useCurrentWallet();
+    const currentAccount = useCurrentAccount();
+    const client = useIotaClient();
+    const { mutate: reportTransactionEffects } = useReportTransactionEffects();
+
+    const executeTransaction: ({
+        bytes,
+        signature,
+    }: {
+        bytes: string;
+        signature: string;
+    }) => Promise<ExecuteTransactionResult> =
+        execute ??
+        (async ({ bytes, signature }) => {
+            const { digest, rawEffects } = await client.executeTransactionBlock({
+                transactionBlock: bytes,
+                signature,
+                options: {
+                    showRawEffects: true,
+                },
+            });
+
+            return {
+                digest,
+                rawEffects,
+                effects: toB64(new Uint8Array(rawEffects!)),
+                bytes,
+                signature,
+            };
+        });
+
+    return useMutation({
+        mutationKey: walletMutationKeys.signAndExecuteTransaction(mutationKey),
+        mutationFn: async ({ transaction, ...signTransactionArgs }): Promise<Result> => {
+            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 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: string;
+
+            if ('effects' in result && result.effects?.bcs) {
+                effects = result.effects.bcs;
+            } else if ('rawEffects' in result) {
+                effects = toB64(new Uint8Array(result.rawEffects!));
+            } else {
+                throw new Error('Could not parse effects from transaction result.');
+            }
+
+            reportTransactionEffects({ effects, account: signerAccount, chain });
+
+            return result as Result;
+        },
+        ...mutationOptions,
+    });
+}

package/src/hooks/wallet/useSignPersonalMessage.ts

@@ -0,0 +1,84 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import type {
+    IotaSignPersonalMessageInput,
+    IotaSignPersonalMessageOutput,
+} from '@iota/wallet-standard';
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { useMutation } from '@tanstack/react-query';
+
+import {
+    WalletFeatureNotSupportedError,
+    WalletNoAccountSelectedError,
+    WalletNotConnectedError,
+} from '../..//errors/walletErrors.js';
+import { walletMutationKeys } from '../../constants/walletMutationKeys.js';
+import type { PartialBy } from '../../types/utilityTypes.js';
+import { useCurrentAccount } from './useCurrentAccount.js';
+import { useCurrentWallet } from './useCurrentWallet.js';
+
+type UseSignPersonalMessageArgs = PartialBy<IotaSignPersonalMessageInput, 'account'>;
+
+type UseSignPersonalMessageResult = IotaSignPersonalMessageOutput;
+
+type UseSignPersonalMessageError =
+    | WalletFeatureNotSupportedError
+    | WalletNoAccountSelectedError
+    | WalletNotConnectedError
+    | Error;
+
+type UseSignPersonalMessageMutationOptions = Omit<
+    UseMutationOptions<
+        UseSignPersonalMessageResult,
+        UseSignPersonalMessageError,
+        UseSignPersonalMessageArgs,
+        unknown
+    >,
+    'mutationFn'
+>;
+
+/**
+ * Mutation hook for prompting the user to sign a message.
+ */
+export function useSignPersonalMessage({
+    mutationKey,
+    ...mutationOptions
+}: UseSignPersonalMessageMutationOptions = {}): UseMutationResult<
+    UseSignPersonalMessageResult,
+    UseSignPersonalMessageError,
+    UseSignPersonalMessageArgs
+> {
+    const { currentWallet } = useCurrentWallet();
+    const currentAccount = useCurrentAccount();
+
+    return useMutation({
+        mutationKey: walletMutationKeys.signPersonalMessage(mutationKey),
+        mutationFn: async (signPersonalMessageArgs) => {
+            if (!currentWallet) {
+                throw new WalletNotConnectedError('No wallet is connected.');
+            }
+
+            const signPersonalMessageFeature = currentWallet.features['iota:signPersonalMessage'];
+            if (!signPersonalMessageFeature) {
+                throw new WalletFeatureNotSupportedError(
+                    "This wallet doesn't support the `signPersonalMessage` feature.",
+                );
+            }
+
+            const signerAccount = signPersonalMessageArgs.account ?? currentAccount;
+            if (!signerAccount) {
+                throw new WalletNoAccountSelectedError(
+                    'No wallet account is selected to sign the personal message with.',
+                );
+            }
+
+            return await signPersonalMessageFeature.signPersonalMessage({
+                ...signPersonalMessageArgs,
+                account: signerAccount,
+            });
+        },
+        ...mutationOptions,
+    });
+}

package/src/hooks/wallet/useSignTransaction.ts

@@ -0,0 +1,117 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Transaction } from '@iota/iota-sdk/transactions';
+import { signTransaction } from '@iota/wallet-standard';
+import type { SignedTransaction, IotaSignTransactionInput } from '@iota/wallet-standard';
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { useMutation } from '@tanstack/react-query';
+
+import { walletMutationKeys } from '../../constants/walletMutationKeys.js';
+import {
+    WalletFeatureNotSupportedError,
+    WalletNoAccountSelectedError,
+    WalletNotConnectedError,
+} from '../../errors/walletErrors.js';
+import type { PartialBy } from '../../types/utilityTypes.js';
+import { useIotaClient } from '../useIotaClient.js';
+import { useCurrentAccount } from './useCurrentAccount.js';
+import { useCurrentWallet } from './useCurrentWallet.js';
+import { useReportTransactionEffects } from './useReportTransactionEffects.js';
+
+type UseSignTransactionArgs = PartialBy<
+    Omit<IotaSignTransactionInput, 'transaction'>,
+    'account' | 'chain'
+> & {
+    transaction: Transaction | string;
+};
+
+interface UseSignTransactionResult extends SignedTransaction {
+    reportTransactionEffects: (effects: string) => void;
+}
+
+type UseSignTransactionError =
+    | WalletFeatureNotSupportedError
+    | WalletNoAccountSelectedError
+    | WalletNotConnectedError
+    | Error;
+
+type UseSignTransactionMutationOptions = Omit<
+    UseMutationOptions<
+        UseSignTransactionResult,
+        UseSignTransactionError,
+        UseSignTransactionArgs,
+        unknown
+    >,
+    'mutationFn'
+>;
+
+/**
+ * Mutation hook for prompting the user to sign a transaction.
+ */
+export function useSignTransaction({
+    mutationKey,
+    ...mutationOptions
+}: UseSignTransactionMutationOptions = {}): UseMutationResult<
+    UseSignTransactionResult,
+    UseSignTransactionError,
+    UseSignTransactionArgs
+> {
+    const { currentWallet } = useCurrentWallet();
+    const currentAccount = useCurrentAccount();
+    const client = useIotaClient();
+
+    const { mutate: reportTransactionEffects } = useReportTransactionEffects();
+
+    return useMutation({
+        mutationKey: walletMutationKeys.signTransaction(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.',
+                );
+            }
+
+            if (!currentWallet.features['iota:signTransaction']) {
+                throw new WalletFeatureNotSupportedError(
+                    "This wallet doesn't support the `signTransaction` feature.",
+                );
+            }
+
+            const { bytes, signature } = await signTransaction(currentWallet, {
+                ...signTransactionArgs,
+                transaction: {
+                    toJSON: async () => {
+                        return typeof transaction === 'string'
+                            ? transaction
+                            : await transaction.toJSON({
+                                  supportedIntents: [],
+                                  client,
+                              });
+                    },
+                },
+                account: signerAccount,
+                chain: signTransactionArgs.chain ?? signerAccount.chains[0],
+            });
+
+            return {
+                bytes,
+                signature,
+                reportTransactionEffects: (effects) => {
+                    reportTransactionEffects({
+                        effects,
+                        account: signerAccount,
+                        chain: signTransactionArgs.chain ?? signerAccount.chains[0],
+                    });
+                },
+            };
+        },
+        ...mutationOptions,
+    });
+}

package/src/hooks/wallet/useSwitchAccount.ts

@@ -0,0 +1,61 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import type { WalletAccount } from '@iota/wallet-standard';
+import type { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { useMutation } from '@tanstack/react-query';
+
+import { walletMutationKeys } from '../../constants/walletMutationKeys.js';
+import { WalletAccountNotFoundError, WalletNotConnectedError } from '../../errors/walletErrors.js';
+import { useCurrentWallet } from './useCurrentWallet.js';
+import { useWalletStore } from './useWalletStore.js';
+
+type SwitchAccountArgs = {
+    account: WalletAccount;
+};
+
+type SwitchAccountResult = void;
+
+type UseSwitchAccountError = WalletNotConnectedError | WalletAccountNotFoundError | Error;
+
+type UseSwitchAccountMutationOptions = Omit<
+    UseMutationOptions<SwitchAccountResult, UseSwitchAccountError, SwitchAccountArgs, unknown>,
+    'mutationFn'
+>;
+
+/**
+ * Mutation hook for switching to a specific wallet account.
+ */
+export function useSwitchAccount({
+    mutationKey,
+    ...mutationOptions
+}: UseSwitchAccountMutationOptions = {}): UseMutationResult<
+    SwitchAccountResult,
+    UseSwitchAccountError,
+    SwitchAccountArgs
+> {
+    const { currentWallet } = useCurrentWallet();
+    const setAccountSwitched = useWalletStore((state) => state.setAccountSwitched);
+
+    return useMutation({
+        mutationKey: walletMutationKeys.switchAccount(mutationKey),
+        mutationFn: async ({ account }) => {
+            if (!currentWallet) {
+                throw new WalletNotConnectedError('No wallet is connected.');
+            }
+
+            const accountToSelect = currentWallet.accounts.find(
+                (walletAccount) => walletAccount.address === account.address,
+            );
+            if (!accountToSelect) {
+                throw new WalletAccountNotFoundError(
+                    `No account with address ${account.address} is connected to ${currentWallet.name}.`,
+                );
+            }
+
+            setAccountSwitched(accountToSelect);
+        },
+        ...mutationOptions,
+    });
+}

package/src/hooks/wallet/useUnsafeBurnerWallet.ts

@@ -0,0 +1,168 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import type { IotaClient } from '@iota/iota-sdk/client';
+import { Ed25519Keypair } from '@iota/iota-sdk/keypairs/ed25519';
+import { Transaction } from '@iota/iota-sdk/transactions';
+import { toB64 } from '@iota/iota-sdk/utils';
+import type {
+    StandardConnectFeature,
+    StandardConnectMethod,
+    StandardEventsFeature,
+    StandardEventsOnMethod,
+    IotaFeatures,
+    IotaSignAndExecuteTransactionMethod,
+    IotaSignPersonalMessageMethod,
+    IotaSignTransactionMethod,
+    Wallet,
+} from '@iota/wallet-standard';
+import { getWallets, ReadonlyWalletAccount, SUPPORTED_CHAINS } from '@iota/wallet-standard';
+import { useEffect } from 'react';
+
+import { useIotaClient } from '../useIotaClient.js';
+
+const WALLET_NAME = 'Unsafe Burner Wallet';
+
+export function useUnsafeBurnerWallet(enabled: boolean) {
+    const iotaClient = useIotaClient();
+
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        const unregister = registerUnsafeBurnerWallet(iotaClient);
+        return unregister;
+    }, [enabled, iotaClient]);
+}
+
+function registerUnsafeBurnerWallet(iotaClient: IotaClient) {
+    const walletsApi = getWallets();
+    const registeredWallets = walletsApi.get();
+
+    if (registeredWallets.find((wallet) => wallet.name === WALLET_NAME)) {
+        console.warn(
+            'registerUnsafeBurnerWallet: Unsafe Burner Wallet already registered, skipping duplicate registration.',
+        );
+        return;
+    }
+
+    console.warn(
+        'Your application is currently using the unsafe burner wallet. Make sure that this wallet is disabled in production.',
+    );
+
+    const keypair = new Ed25519Keypair();
+    const account = new ReadonlyWalletAccount({
+        address: keypair.getPublicKey().toIotaAddress(),
+        publicKey: keypair.getPublicKey().toIotaBytes(),
+        chains: ['iota:unknown'],
+        features: ['iota:signTransaction', 'iota:signAndExecuteTransaction'],
+    });
+
+    class UnsafeBurnerWallet implements Wallet {
+        get version() {
+            return '1.0.0' as const;
+        }
+
+        get name() {
+            return WALLET_NAME;
+        }
+
+        get icon() {
+            return 'data:image/png;base64,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' as const;
+        }
+
+        // Return the IOTA chains that your wallet supports.
+        get chains() {
+            return SUPPORTED_CHAINS;
+        }
+
+        get accounts() {
+            return [account];
+        }
+
+        get features(): StandardConnectFeature & StandardEventsFeature & IotaFeatures {
+            return {
+                'standard:connect': {
+                    version: '1.0.0',
+                    connect: this.#connect,
+                },
+                'standard:events': {
+                    version: '1.0.0',
+                    on: this.#on,
+                },
+                'iota:signPersonalMessage': {
+                    version: '1.0.0',
+                    signPersonalMessage: this.#signPersonalMessage,
+                },
+                'iota:signTransaction': {
+                    version: '2.0.0',
+                    signTransaction: this.#signTransaction,
+                },
+                'iota:signAndExecuteTransaction': {
+                    version: '2.0.0',
+                    signAndExecuteTransaction: this.#signAndExecuteTransaction,
+                },
+            };
+        }
+
+        #on: StandardEventsOnMethod = () => {
+            return () => {};
+        };
+
+        #connect: StandardConnectMethod = async () => {
+            return { accounts: this.accounts };
+        };
+
+        #signPersonalMessage: IotaSignPersonalMessageMethod = async (messageInput) => {
+            const { bytes, signature } = await keypair.signPersonalMessage(messageInput.message);
+            return { bytes, signature };
+        };
+
+        #signTransaction: IotaSignTransactionMethod = async (transactionInput) => {
+            const { bytes, signature } = await Transaction.from(
+                await transactionInput.transaction.toJSON(),
+            ).sign({
+                client: iotaClient,
+                signer: keypair,
+            });
+
+            transactionInput.signal?.throwIfAborted();
+
+            return {
+                bytes,
+                signature: signature,
+            };
+        };
+
+        #signAndExecuteTransaction: IotaSignAndExecuteTransactionMethod = async (
+            transactionInput,
+        ) => {
+            const { bytes, signature } = await Transaction.from(
+                await transactionInput.transaction.toJSON(),
+            ).sign({
+                client: iotaClient,
+                signer: keypair,
+            });
+
+            transactionInput.signal?.throwIfAborted();
+
+            const { rawEffects, digest } = await iotaClient.executeTransactionBlock({
+                signature,
+                transactionBlock: bytes,
+                options: {
+                    showRawEffects: true,
+                },
+            });
+
+            return {
+                bytes,
+                signature,
+                digest,
+                effects: toB64(new Uint8Array(rawEffects!)),
+            };
+        };
+    }
+
+    return walletsApi.register(new UnsafeBurnerWallet());
+}

package/src/hooks/wallet/useWalletPropertiesChanged.ts

@@ -0,0 +1,30 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import { useEffect } from 'react';
+
+import { useCurrentWallet } from './useCurrentWallet.js';
+import { useWalletStore } from './useWalletStore.js';
+
+/**
+ * Internal hook for easily handling various changes in properties for a wallet.
+ */
+export function useWalletPropertiesChanged() {
+    const { currentWallet } = useCurrentWallet();
+    const updateWalletAccounts = useWalletStore((state) => state.updateWalletAccounts);
+
+    useEffect(() => {
+        const unsubscribeFromEvents = currentWallet?.features['standard:events'].on(
+            'change',
+            ({ accounts }) => {
+                // TODO: We should handle features changing that might make the list of wallets
+                // or even the current wallet incompatible with the dApp.
+                if (accounts) {
+                    updateWalletAccounts(accounts);
+                }
+            },
+        );
+        return unsubscribeFromEvents;
+    }, [currentWallet?.features, updateWalletAccounts]);
+}

package/src/hooks/wallet/useWalletStore.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import { useContext } from 'react';
+import { useStore } from 'zustand';
+
+import { WalletContext } from '../../contexts/walletContext.js';
+import type { StoreState } from '../../walletStore.js';
+
+export function useWalletStore<T>(selector: (state: StoreState) => T): T {
+    const store = useContext(WalletContext);
+    if (!store) {
+        throw new Error(
+            'Could not find WalletContext. Ensure that you have set up the WalletProvider.',
+        );
+    }
+    return useStore(store, selector);
+}

package/src/hooks/wallet/useWallets.ts

@@ -0,0 +1,12 @@
+// Copyright (c) Mysten Labs, Inc.
+// Modifications Copyright (c) 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import { useWalletStore } from './useWalletStore.js';
+
+/**
+ * Retrieves a list of registered wallets available to the dApp sorted by preference.
+ */
+export function useWallets() {
+    return useWalletStore((state) => state.wallets);
+}