Keyboard shortcuts

Press ← or β†’ to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

snaK User Guide

This guide walks you through the steps to connect your MetaMask wallet to the Kadena Snap, install it, approve permissions, and perform basic operations like switching networks and sending $KDA.

πŸ’» Note: The Kadena Snap is only available in the MetaMask browser extension. Users must switch to desktop to interact with the Kadena Snap.

What is snaK?

Kadena Snap is a custom MetaMask Snap that allows users to interact directly with the Kadena blockchain. It enables you to:

  • Manage Kadena accounts securely inside MetaMask
  • Perform cross-chain transfers across Kadena's 20 chains
  • Sign and send transactions using $KDA
  • View account balances and activity
  • Use gas stations to simplify fees
  • Buy KDA through integrated fiat onramps

The Kadena Snap is fully isolated, permissions-based, and built using MetaMask’s secure extensibility model.

Who is this guide for?

This guide is intended for:

  • Users who want to manage $KDA from within MetaMask
  • Developers building dApps that integrate with the Kadena Snap
  • Testers exploring the Kadena Snap functionalities on testnet

No prior knowledge of Kadena or Snaps is required, though basic familiarity with MetaMask is helpful.

What you'll need

Before getting started, make sure you have:

  • βœ… MetaMask installed in your browser
  • βœ… Access to a Snap-compatible dApp (or localhost test setup)
  • βœ… Some $KDA (use the faucet if testing)
  • βœ… Basic understanding of MetaMask permissions

πŸ’‘ You can install the Kadena Snap even without a dApp using the MetaMask Snap Directory.

What this guide covers

This guide includes:

  • Connecting your MetaMask wallet
  • Installing and approving the Kadena Snap
  • Using the Kadena Snap to send transactions
  • Switching to the testnet (optional)
  • Funding accounts via faucet
  • Using advanced Snap features like cross-chain transfers

You’re now ready to explore the Kadena Snap and unlock full-chain functionality from right inside MetaMask.

Troubleshooting

Common Issues

  • Accounts not appearing?
    βœ… Ensure MetaMask is fully unlocked
    βœ… Check that the Kadena Snap is properly installed
    βœ… Refresh the dApp page

  • Transactions failing?
    πŸ”Ή Verify you have enough KDA for gas
    πŸ”Ή Confirm the correct chain is selected
    πŸ”Ή Verify you are connected to the correct network
    πŸ”Ή Check network status at status.kadena.io

  • Connection problems?
    πŸ”„ Try reconnecting your wallet
    πŸ”„ Reinstall the Kadena Snap if needed (accounts will recover)

Security Guidelines

⚠️ Important Security Notes

  • Your KDA accounts are generated from your MetaMask seed phrase

  • The same security practices for ETH apply to your KDA:

    • Never share your recovery phrase
    • Use a hardware wallet for maximum security
    • Be cautious of phishing sites
  • Always verify:

    • Transaction details in MetaMask popups
    • Website URLs before connecting
    • Contract addresses when interacting with dApps

πŸ”’ Best Practices

  • Regularly review connected sites in MetaMask
  • Keep your browser and MetaMask updated
  • Consider using a dedicated browser and/or wallet for Kadena Snap