Skip to main content

Zazen Snap Knowledge Base

Welcome to the Zazen Snap Knowledge Base. This guide provides detailed instructions on how to install, use, and troubleshoot the Zazen Snap within MetaMask and the Zenchain Station dApp.

Table of Contents

  1. Introduction
  2. Installation
  3. Using Zazen with Zenchain Station dApp
  4. Technical and Security Considerations
  5. Troubleshooting
  6. Frequently Asked Questions
  7. Support

1. Introduction​

Zazen is a MetaMask Snap that securely stores your validator node cloud access keys within MetaMask. By integrating with the Zenchain Station dApp, Zazen simplifies the process of deploying and accessing your validator nodes without the need for external password managers or manual key handling.

Video instructions for how to set up Zazen Snap for Zenchain Station: image

2. Installation​

warning

The Zenchain team has submitted the Zazen Snap to be listed in the MetaMask Snap directory. While we wait for the MetaMask team to approve it, the Zazen Snap can only be installed using MetaMask Flask.

MetaMask Flask is a development version of MetaMask that should only be used for testing purposes. It may have bugs or security flaws. The MetaMask team recommends against importing an account with funds into it.

If you are a developer, or if you are simply too excited to wait, please install MetaMask Flask before continuing.

Prerequisites:

  • MetaMask: Installed in your browser.
  • MetaMask Snaps: Enabled in your MetaMask settings.
  • Zenchain Station dApp: Accessible at https://node.zenchain.io.

Steps:

  1. Navigate to Zenchain Station: Go to https://node.zenchain.io.
  2. Connect Wallet: Click on the "Connect Wallet" button in the upper right corner.
  3. Install Zazen Snap: The dApp will prompt you to install the Zazen Snap if it's not already installed.
  4. Grant Permissions: Approve the installation and grant the snap_manageState permission when prompted by MetaMask.
  5. Confirmation: Once installed, no further action is needed. Zazen will operate in the background.

3. Using Zazen with Zenchain Station dApp​

  • Submit Cloud Access Keys: When setting up your node in the Zenchain Station dApp, you will be asked to input your cloud access keys (e.g., OnFinality keys).
  • Automatic Storage: Upon submission, Zazen automatically encrypts and stores your keys within MetaMask.
  • Future Access: The next time you use the dApp, Zazen will retrieve your keys automatically, so you won't need to re-enter them.
  • No Direct Interaction Required: Users do not need to interact with Zazen directly or use any JSON-RPC methods.

4. Technical and Security Considerations​

  • Encrypted Storage: Your cloud access keys are encrypted and securely stored within MetaMask.
  • Accessibility: The encrypted storage is only accessible when MetaMask is unlocked.
  • Permissions: Zazen operates with the snap_manageState permission, which you grant during installation.
  • Data Privacy: Your keys remain on your device and are not transmitted to any external servers other than your cloud provider when deploying nodes.

5. Troubleshooting​

When using Zazen Snap and the MetaMask Snaps platform, you might encounter issues either with the platform itself or specifically with the Zazen Snap. Below are some troubleshooting steps to help you resolve common problems.

Distinguishing Between Platform and Snap Issues

  • Platform Issues: These affect the MetaMask Snaps platform as a whole and might impact multiple or all installed Snaps.
  • Snap-Specific Issues: These are problems isolated to the Zazen Snap.

Troubleshooting MetaMask Snaps Platform Issues

  1. Update MetaMask Extension:

    • Ensure you are using the latest version of the MetaMask browser extension.
    • To update, go to your browser's extension settings and check for updates.
    • Note: MetaMask Snaps are currently not available on MetaMask Mobile.

  2. Contact MetaMask Support:

    • If updating doesn't resolve the issue, reach out to MetaMask Support.
    • Visit the MetaMask Support page and click on "Start a Conversation" to get assistance.

Troubleshooting Zazen Snap Issues

  1. Update Zazen Snap:

    • Visit the Zenchain Station dApp where you installed the Zazen Snap.
    • Ensure you have the latest version of the Snap installed.
    • The dApp may prompt you to update if a new version is available.

  2. Reinstall Zazen Snap:

    • If updating doesn't help, try uninstalling and reinstalling the Snap.

    • To Uninstall:

      • Open MetaMask and navigate to the Snaps settings.
      • Find Zazen Snap and select "Remove" or "Uninstall."

    • To Reinstall:

      • Go back to the Zenchain Station dApp.
      • Reconnect your wallet, and the dApp will prompt you to install the Snap again.

  3. Contact for Zazen Snap Support:

    • If you're still experiencing issues, reach out to us.

6. Frequently Asked Questions​

For common questions and answers, please refer to the FAQ Document provided.

7. Support​

If you need additional assistance:

Thank you for using Zazen Snap! We are committed to providing a secure and efficient way to manage your Zenchain validator node cloud access keys. If you have any feedback or suggestions for future features, please don't hesitate to contact us.