Cosmos Wallet and Freighter compatible

Your Stellar account, inside MetaMask.

Stellar and Soroban accounts, payments and signatures without leaving MetaMask, with the Stellar Snap.

Stellar networks
3
Standard API
SEP-43
Extra extensions
0

Features

All of Stellar, without leaving MetaMask.

The Stellar Snap adds a full Stellar wallet to MetaMask, with its own screen inside the extension.

  • Stellar accounts

    Create several accounts from your MetaMask Secret Recovery Phrase, or import a secret key or a recovery phrase.

  • Send and receive

    Send XLM and other assets after reviewing the fee and memo, and receive with a QR code.

  • Assets and trustlines

    Add assets from the Cosmos Pay registry, or any other by its code and issuer, and remove them when you no longer use them.

  • Swaps

    Swap assets on the Stellar DEX with Cosmos Pay quotes. The Snap checks every transaction before asking for your signature.

  • Soroban and messages

    Sign Soroban contract authorizations seeing the contract, function and arguments, and sign messages with SEP-53.

  • Linked EVM account

    Link your MetaMask 0x address to your Stellar account with signatures anyone can verify.

Get started

Ready in three steps.

  1. Install MetaMask

    Add the MetaMask extension to your desktop browser, if you don't have it yet.

  2. Add the Stellar Snap

    Click "Install in MetaMask" on this page and approve the permissions MetaMask shows you.

  3. Use your Stellar account

    In MetaMask, open the ⋮ menu → Snaps → Stellar Snap. From there you send, receive, swap and manage your accounts.

For developers

Connect your dApp with a standard API.

The @cosmosapp/stellar-metamask-adapter adapter implements SEP-43: on mainnet it uses MetaMask's built-in Stellar support, and on testnet and futurenet, the Stellar Snap.

  • SEP-43: the same methods and error codes as other Stellar wallets.
  • Stellar Wallets Kit: a module that adds MetaMask to the wallet picker.
  • Freighter API: dApps built for Freighter work through a bundler alias, without changing their code.
View the code on GitHub (opens in a new tab)
Connect and sign with SEP-43
import { HybridStellarAdapter } from '@cosmosapp/stellar-metamask-adapter';

const wallet = new HybridStellarAdapter();

// MetaMask's Stellar support signs on mainnet; the Stellar Snap, on testnet
const { address } = await wallet.requestAccess();

// Transactions and Soroban authorizations, as in every SEP-43 wallet
const { signedTxXdr } = await wallet.signTransaction(xdr);
const { signedAuthEntry } = await wallet.signAuthEntry(authEntryXdr);

// Switch networks and follow the account the user picks
await wallet.switchNetwork('testnet');
wallet.onChange(({ address, network }) => render(address, network));

FAQ

What you need to know.

What is Stellar Snap?

It's an open-source MetaMask Snap that adds Stellar and Soroban accounts to MetaMask, with its own screen inside the extension. It's a product of Cosmos Pay and Cosmos.

Is it an official MetaMask product?

No. Stellar Snap is an independent project: it isn't affiliated with, sponsored or endorsed by MetaMask, Consensys or the Stellar Development Foundation.

Which Stellar networks does it support?

All three. On testnet and futurenet, the Stellar Snap signs. On mainnet, the adapter uses MetaMask's built-in Stellar support and, if your version doesn't have it, the Snap.

Where are my keys?

In MetaMask. Accounts are derived from your Secret Recovery Phrase with SEP-0005, as in other Stellar wallets, and keys never leave MetaMask. For an imported account, only its secret key is stored, encrypted by MetaMask.

How much does it cost?

Installing and using it is free. You pay Stellar network fees, and swaps include a Cosmos Pay platform fee that you see in the quote before confirming.

Do I need another wallet or extension?

No. You only need MetaMask: the Snap runs inside the extension, and Stellar dApps connect through it.

How do I integrate it into my dApp?

With the SEP-43 adapter, the Stellar Wallets Kit module or the Freighter-compatible API. The code and the integration guide are on GitHub (opens in a new tab).