MetaMask SDK

MetaMask SDK enables developers to easily connect their dapps with the MetaMask browser extension and MetaMask Mobile.

It supports the following dapp platforms:

Javascript-based apps
Gaming apps
- Unity
- Unreal Engine (coming soon)
Mobile Native apps
- iOS
- Android

Read more about setting up MetaMask SDK and MetaMask SDK concepts.

This repository contains the JavaScript SDK and examples. You can also see the Android SDK repository and the iOS SDK repository.

Features

Session persistence
Multi MetaMask provider (let user choose between browser extension and mobile wallet)
Batch RPC calls (send multiple requests to your wallet at once)
Read-only RPC calls and Infura integration
Wagmi hook integration (alpha)
i18n
Full modal UI customization
Smart contract library (coming soon)

Get started

Install the SDK:

yarn add @metamask/sdk

npm i @metamask/sdk

Web dapps

See the following examples:

Read the documentation for using the SDK with JavaScript for more information.

React Native

We recommend using React Native v0.71.4 or higher to avoid performance issues on Android.

See the React Native example and read the documentation for using the SDK with React Native for more information.

Node.js

See the Node.js example and read the documentation for using the SDK with Node.js for more information.

Electron

See the Electron example and read the documentation for using the SDK with Electron for more information.

SDK options

See the full list of JavaScript SDK options.

Contributing

To contribute to MetaMask SDK, see the contribution guidelines.

Contacts

Fill out this form for a complimentary design optimization workshop.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.32.1

Added

chore: updates assets (#1220)

0.32.0

Added

feat: setup stencil development environment with component preview (#1196)

Fixed

fix: user rejection bug (#1202)

0.31.5

Added

chore: add analytics to install modal (#1189)

Fixed

fix: correct event handler binding in modal components (#1191)
fix: remove console log when render install modal (#1190)

0.31.2

Fixed

Set initial modal tab based on preferDesktop option (#1158)

0.31.1

Changed

fix: Tell webpack about dynamic import + fixed polyfills (#1151)

0.31.0

Changed

refactor(sdk-install-modal-web): migrate from i18next to custom SimpleI18n implementation (#1141)
refactor(sdk-install-modal-web): migrate to StencilJS + Lazy Loading (#1139)
style: add inline styles to div elements (#1138)
refactor: replace qr-code-styling with smaller library (#1129)