#Version

This document is for magic-sdk version 13.2.0 and above. ⁠You can view the open-source repository for this SDK on Github and all versioned releases on NPM.

Note: If you are looking for documentation for a version of magic-sdk below 13.2.0 that utilizes the magic.connect namespace, please refer to the older documentation for the SDK here.

#Configuration & Setup

In order to use the Magic Javascript SDK, you must get a valid publishable API key from the Magic Dashboard. In the examples below, replace the value of YOUR_API_KEY with the value you get from the dashboard. See the quickstart section for more details and installation instructions.

#Constructor

#Magic()

Configure and construct your Magic SDK instance.

#Arguments

1. apiKey: String : Your publishable API Key retrieved from the Magic Dashboard
2. options?: String | Object : A representation of the connected Ethereum network (one of: mainnet, goerli) or a custom object with your custom EVM node configurations.
   • Default: 'mainnet' : Will connect to Ethereum's mainnet network.
   • options.network: Object
     • options.network.rpcUrl: String : A URL pointing to your custom EVM Node.
     • options.network.chainId?: Number : If your node infrastructure requires you to pass an explicit chain ID, you can use this parameter to do so.

#Example

Use presets for Ethereum

01import { Magic } from "magic-sdk"

02

03const magic = new Magic('YOUR_API_KEY', { 

04  network: 'goerli', // connect to Ethereum Testnet!

05});

Use Polygon, Optimism or custom RPC URLs

01import { Magic } from "magic-sdk"

02

03const customNodeOptions = {

04  rpcUrl: 'https://polygon-rpc.com', // your ethereum, polygon, or optimism mainnet/testnet rpc URL

05  chainId: 137 // corresponding chainId for your rpc url

06}

07

08const magic = new Magic('YOUR_API_KEY', { 

09  network: customNodeOptions, // connected to Polygon Mainnet!

10});

#Wallet Module Methods

All methods below are namespaced to the magic.wallet module.

#getInfo()

Get information about the wallet the use is currently logged in with. User must be signed in for this method to return or else it will throw an error.

#Returns

1. Object : Information about the wallet the user is currently signed in with.
   • walletType: 'magic'|'metamask'|'coinbase_wallet'|'wallet_connect'

#Example

01import { Magic } from "magic-sdk"

02

03// after user has already logged in

04const walletInfo = await magic.wallet.getInfo();

05console.log(walletInfo); // { walletType: "magic" | "metamask" | "coinbase_wallet" | "wallet_connect" }

#connectWithUI()

Request the user to connect their wallet to the dapp.

#Returns

1. String[] : An array of user accounts that are connected, with the first element being the current public address of the user.

#Example

01import { Magic } from "magic-sdk"

02

03const accounts = await magic.wallet.connectWithUI();

#showUI()

Displays the wallet widget. This is only supported for users who login with email or Google and not third party wallets such as metamask. User must be signed in for this method to return or else it will throw an error.

#Returns

1. Promise which resolves when the user closes the wallet widget window.
2. Optionally, add a .on() handler to catch the disconnect event emitted when the user logs out from the wallet widget.

#Example

01import { Magic } from "magic-sdk"

02

03// after user has already logged in

04const { walletType } = await magic.wallet.getInfo();

05

06if (walletType === "magic") {

07  magic.wallet.showUI().on('disconnect', () => console.log('user disconnected');

08};

#requestUserInfoWithUI()

Displays the wallet widget within an iframe that prompts the user to consent to sharing information with the requesting dApp with OpenID profile scopes. Currently, the only profile scope that can be requested is a verified email. Collecting a verified email address from third-party wallet users (MetaMask, Coinbase Wallet, etc.) is a premium feature but included in the free trial period (see pricing). User must be signed in for this method to return or else it will throw an error.

#Arguments

1. scope?: Object : The object containing requested OpenID profile scopes.
   • email?: String : If the user should be prompted to provide them email as a required or optional field.

#Returns

1. A promise which returns an Object : Contains result of the requested scopes.
   • email?: String: The email of the user if they consented to providing it in the UI.

#Example

01import { Magic } from "magic-sdk"

02

03// after user has already logged in

04const userInfo = await magic.wallet.requestUserInfoWithUI({ scope: { email: "required" }})

05⁠console.log(userInfo.email); // the user's email if they consented.

#disconnect()

Disconnects the user from the dApp. This is similar to logging a user out in that it will clear the authenticated state for the current user, the iframe, and any third party wallet the user may have signed in with. User must be signed in for this method to return or else it will throw an error.

#Returns

1. A promise that return a boolean: If the user's session was succesfully cleared or not.

#Example

01import { Magic } from "magic-sdk"

02

03await magic.wallet.disconnect() // clears user session

#EVM RPC Methods

Magic supports the following EVM RPC Methods that can be called through a web3 provider library such as web3.js or ethers.js.

• eth_accounts
• get_balance
• eth_estimateGas
• eth_gasPrice
• eth_sendTransaction
• personal_sign
• eth_signTypedData_v3
• eth_signTypedData_v4