Skip to main content

useMagic() function

Hook for connecting to an email wallet using magic link. This enables users without their own wallets to connect to your application and sign transactions securely using their email.

import { useMagic } from "@thirdweb-dev/react";

Example

Before using this hook, you first need to set up the magic configuration in your ThirdwebProvider, including your magic API key.

// Add the magic configuration object to your wallet connectors
const connectors = [
"metamask",
"walletConnect",
"walletLink",
{
name: "magic",
options: {
apiKey: "your-magic-api-key",
}
}
]

// Add the above to the walletConnectors prop of your <ThirdwebProvider />
const Provider = ({ children }) => (
return (
<ThirdwebProvider
walletConnectors={connectors}
// Specify remaining parameters
...
>
{children}
</ThirdwebProvider>
)
}

In order to use the hook to connect users with magic link, you just need to provide the users email to the connect function.

You can setup the hook with the following configuration:

import { useMagic } from "@thirdweb-dev/react";
import { useState } from "react";

const LoginWithMagicLink = () => {
const connectWithMagic = useMagic();
const [email, setEmail] = useState();

return (
<div>
<input value={email} onChange={(e) => setEmail(e.target.value)} />
<button onClick={() => connectWithMagic({ email })}>Login</button>
</div>
);
};

Signature:

export declare function useMagic(): (
configuration: LoginWithMagicLinkConfiguration,
) => Promise<{
data?: import("wagmi").ConnectorData<any> | undefined;
error?: Error | undefined;
}>;

Returns:

(configuration: LoginWithMagicLinkConfiguration) => Promise<{ data?: import("wagmi").ConnectorData<any> | undefined; error?: Error | undefined; }>