Skip to main content

Install MetaMask Astar Wallet Snap

Astar Snap Deprecation

Astar Snap will soon be deprecated and permanently disabled. This means any assets stored within the Snap will no longer be accessible through it.

To avoid losing access to your funds, we strongly recommend that you migrate your assets as soon as possible to a supported external wallet, either on Astar EVM or Astar Substrate.

What should you do?

  1. Choose a supported wallet from our list (e.g., Polkadot.js, Talisman, MetaMask).
  2. Follow the migration steps for the wallet of your choice.
  3. Ensure your assets are safely transferred out of Astar Snap.

πŸ“˜ You can find detailed wallet guides and setup instructions in our Getting Started section.

πŸ‘Ύ If you need help, feel free to reach out via our Discord community.

Migrate your funds

To ensure your assets remain safe and accessible, please follow these simple steps to transfer your funds out of Astar Snap:

  1. Go to the Astar Portal and connect using your Astar Snap. Then go to the Transfer section.
  2. Enter the address of the destination. This can be any supported Astar EVM or Substrate wallet.
  3. We recommend sending your full balance. Any remaining funds in Astar Snap may become inaccessible once the feature is deprecated. Confirm and sign the transaction. That’s it!

βœ… Your funds will now be safe in your new wallet.

Update your Astar Snap

If you're not using Astar Snap version 0.9.1, please update it here before transferring your assets.

Introduction​

The Astar Wallet Snap extends MetaMask's functionality, specifically for blockchains built with Substrate technology. The Astar Wallet Snap enables you to quickly generate a Substrate wallet with MetaMask for signing transactions and interacting with decentralized applications (dApps) that utilize the @polkadot/extension-dapp package. You can seamlessly interact with all dApps in the Astar ecosystem through MetaMask, thereby expanding MetaMask's utility beyond Ethereum and EVM-compatible networks.

note

Snap-based accounts are derived from the private key associated with your MetaMask account (your seed phrase), so funds cannot be lost even in the event support for a particular Snap is discontinued.

How to install​

Follow these steps to interact with the Astar Wallet snap Portal. The source code for the example dApp is available as part of the repository. This guide assumes that MetaMask is installed and properly configured.

Connect to the Portal​

Click the webpage button labeled "Astar Snap" with the MetaMask logo.


Connect to the Portal
Connect to the Portal

Review & Accept Third-Party Software Notice​

Click the arrow to view the entire third-party software notice and, if you accept it, click the MetaMask "Third-party software notice" button labeled "Accept" to accept the MetaMask third-party software notice.


Review 3rd-Party Software Notice
Review 3rd-Party Software Notice


Accept 3rd-Party Software Notice
Accept 3rd-Party Software Notice

Review & Accept Connection Request​

Review the connection request and, if you accept it, click the MetaMask "Connection request" button labeled "Connect" to accept the Astar Wallet snap connection request.


Connection Request
Connection Request

Review Snap Permissions & Begin Installation​

Click the arrow to view the entire list of permissions required by the Astar Wallet snap and, if you accept them, click the MetaMask "Install snap" button labeled "Install" to begin installing the Astar Wallet snap.


Review Permissions
Review Permissions


Begin Installation
Begin Installation

Confirm Elevated Permissions & Complete Installation​

Because the Astar Wallet snap has permission to control accounts for the Astar & Shiden Networks (whose tokens carry real economic value), it's necessary to review and confirm this elevated level of access. If you accept this elevated level of access, check the boxes and click the MetaMask "Proceed with caution" button labeled "Confirm" to confirm the elevated level of access and install the Astar Wallet snap. Click the MetaMask "Installation complete" button labeled "OK" to continue to the example dApp.


Confirm Elevated Permissions
Confirm Elevated Permissions


Installation is Complete
Installation is Complete

Connect the Snap Wallet​

The Astar Snap Wallet is now configured. Notice the address was derived using the entropy from your MetaMask seed phrase and the snapId. The public key does not depend on the network and will always be the same.


Connect
Connect


Account Details
Account Details

How to Remove​

In MetaMask, click on the tripple dot icon on the top right of the extention, then Snap, lastly click on Astar Wallet, scroll to the bottom and click Remove Astar Wallet

This action will not destroy your account or your funds. But deleting your MetaMask account and/or seed could.


Remove Astar Wallet
Remove Astar Wallet


Remove Snap
Remove Snap

How to Restore​

Simply reconnect to the Portal and choose the Astar Snap Wallet again. You will obtain the same address as before with all the funds attached.

Disclaimer​

XCM is not recommended

Conclusion​

That concludes the Astar Wallet snap Portal install instructions. If you have any questions or believe you have found an error or bug, please open an Issue.