Skip to content

Solana quick start

Add Morsel to a Solana dApp. Install the SDK, set chain="solana", connect, send SOL and read the balance, with React, without React, or with no SDK at all.

  • Solana

On Solana, Morsel is one wallet among many. The SDK puts Morsel first and still lists Phantom, Backpack, Solflare and every other Wallet Standard wallet the user has installed, so adding it costs your users nothing.

Solana at a glance

Solana
SDK keysolana
Chain idsolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Older idssolana:mainnet
Native coinSOL, 9 decimals
Public RPChttps://api.mainnet-beta.solana.com
ExplorerSolscan
  • SOL pays every fee.
  • Every Wallet Standard wallet works. The modal lists Morsel first, then each installed wallet that advertises Solana. Almost all of them do.
  • Two ids, one network. Send the CAIP-2 id. The older solana:mainnet still works in Morsel. Some wallets advertise only one of the two, and the SDK matches either.
  • Use your own RPC in production. The public endpoint is rate limited. Pass rpcUrl to WalletProvider.

For every network side by side, see Networks and chain ids.

1. Install

Terminal
npm install @morsel-wallet/adapter @solana/web3.js

The hooks and the connect modal need React 18 or 19, with react-dom. The core works without React.

2. Set the network

App.tsx
import { WalletProvider, WalletModalProvider, WalletModal, ConnectButton } from '@morsel-wallet/adapter';
import { Balance } from './Balance';
import { SendSolana } from './SendSolana';

export default function App() {
  return (
    <WalletProvider chain="solana" autoConnect>
      <WalletModalProvider>
        <ConnectButton />
        <Balance />
        <SendSolana to="RECIPIENT_ADDRESS" />
        <WalletModal />
      </WalletModalProvider>
    </WalletProvider>
  );
}

chain="solana" is your app's network. WalletProvider creates the Morsel adapter, finds the other installed Wallet Standard wallets, and opens a read connection to the public Solana RPC. In production, pass your own endpoint with rpcUrl: a string is for solana only; for several networks pass a record such as { solana: 'https://…' } or a function of the chain.

3. Connect

<ConnectButton /> opens the modal. Morsel comes first, its row reading Works on Solana. The installed wallets that advertise Solana are listed under it as Detected. Once connected, the button becomes an account chip with the Solana mark.

  • Chrome with the Morsel extension: the user approves in the extension.
  • Desktop without it: the modal shows a QR code. The user scans it with the Morsel app and approves on their phone.
  • Phone browser: Continue in Morsel opens your page inside Morsel's browser, where it connects in one tap.

To open the modal from your own button:

TSX
import { useWalletModal } from '@morsel-wallet/adapter';

const { open } = useWalletModal();
<button onClick={() => open()}>Connect</button>;

4. Sign and send a transaction

SendSolana.tsx
import { PublicKey, SystemProgram, Transaction } from '@solana/web3.js';
import { useChain, useWallet } from '@morsel-wallet/adapter';

export function SendSolana({ to }: { to: string }) {
  const { publicKey, sendTransaction } = useWallet();
  const { chain, connection } = useChain();

  async function send() {
    if (!publicKey) return;
    const tx = new Transaction().add(
      SystemProgram.transfer({
        fromPubkey: publicKey,
        toPubkey: new PublicKey(to),
        lamports: 1_000_000, // 0.001 SOL: 9 decimals
      })
    );
    tx.feePayer = publicKey;
    tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;

    const signature = await sendTransaction(tx, connection);
    console.log(chain.explorerTx(signature));
  }

  return <button onClick={send} disabled={!publicKey}>Send 0.001 SOL</button>;
}

sendTransaction asks Morsel to sign for Solana, naming Solana's chain id, then sends through connection. Morsel also checks the transaction itself: a blockhash exists only on the network that issued it, so Morsel asks the networks which one it belongs to and shows the user that network before they sign.

  • To have the wallet broadcast through its own node instead, call signAndSendTransaction(tx). It resolves with the signature. A wallet that can't send by itself signs, and the transaction goes out through useChain().connection.
  • To sign without sending, call signTransaction(tx).

5. Read the balance

Balance.tsx
import { useWallet, useWalletBalance } from '@morsel-wallet/adapter';

export function Balance() {
  const { connected } = useWallet();
  const { balance, symbol, loading } = useWalletBalance();
  if (!connected) return null;
  return <p>{loading ? 'Loading…' : `${balance} ${symbol}`}</p>;
}

With no connection passed, useWalletBalance() reads from useChain().connection, so this shows SOL on Solana, and symbol is 'SOL'. balance is in whole SOL; lamports is the raw amount. Call refetch() after a send.

Without React

The core works in any framework, or none.

solana.ts
import { PublicKey, SystemProgram, Transaction } from '@solana/web3.js';
import { MorselWalletAdapter, connectionFor, svmChain } from '@morsel-wallet/adapter/core';

const chain = svmChain('solana')!;
const connection = connectionFor(chain); // or connectionFor(chain, 'https://your-rpc.example')
const morsel = new MorselWalletAdapter({ chain });

await morsel.connect(); // call it from a click

const lamports = await connection.getBalance(morsel.publicKey!);
console.log(`${lamports / 10 ** chain.native.decimals} ${chain.native.symbol}`);

const tx = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: morsel.publicKey!,
    toPubkey: new PublicKey('RECIPIENT_ADDRESS'),
    lamports: 1_000_000, // 0.001 SOL: 9 decimals
  })
);
tx.feePayer = morsel.publicKey!;
tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;

const signature = await morsel.sendTransaction(tx, connection);
console.log(chain.explorerTx(signature));

svmChain('solana') also accepts the chain id or an older id, and answers null for one it doesn't know. connectionFor throws for an unknown network instead of falling back to Solana. Always pass chain: a MorselWalletAdapter built without one keeps 0.3's behaviour, where the wallet's own network applies.

Without the SDK

Talk to Morsel directly with the chain id. You still build the transaction with @solana/web3.js and a Solana Connection.

The injected provider

In Chrome with the Morsel extension, and inside Morsel's browser on iPhone and Android, Morsel injects window.morsel.

provider.js
import { Connection, PublicKey, SystemProgram, Transaction } from '@solana/web3.js';

const SOLANA = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp';
const connection = new Connection('https://api.mainnet-beta.solana.com');
const provider = window.morsel;

await provider.connect();
const lamports = await connection.getBalance(provider.publicKey);

const tx = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: provider.publicKey,
    toPubkey: new PublicKey('RECIPIENT_ADDRESS'),
    lamports: 1_000_000, // 0.001 SOL: 9 decimals
  })
);
tx.feePayer = provider.publicKey;
tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;

const { signature } = await provider.signAndSendTransaction(tx, { network: SOLANA });

Pass network every time. Without one, window.morsel uses its own network, Solana. An id Morsel doesn't know is refused with 4901.

Wallet Standard

standard.ts
import { getWallets } from '@wallet-standard/app';
import { Connection, PublicKey, SystemProgram, Transaction } from '@solana/web3.js';
import bs58 from 'bs58';

const SOLANA = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp';
const connection = new Connection('https://api.mainnet-beta.solana.com');
const morsel = getWallets().get().find((w) => w.name === 'Morsel');

const { accounts: [account] } = await morsel.features['standard:connect'].connect();
const owner = new PublicKey(account.address);

const tx = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: owner,
    toPubkey: new PublicKey('RECIPIENT_ADDRESS'),
    lamports: 1_000_000, // 0.001 SOL: 9 decimals
  })
);
tx.feePayer = owner;
tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;

const [{ signature }] = await morsel.features['solana:signAndSendTransaction'].signAndSendTransaction({
  account,
  chain: SOLANA,
  transaction: tx.serialize({ requireAllSignatures: false, verifySignatures: false }),
});
console.log(bs58.encode(signature));

chain is required: Morsel refuses a send without one, or with an id it doesn't know. Wallet Standard returns the signature as bytes; bs58 turns it into the usual string. See Wallet Standard.

Test networks

NetworkSDK keyChain idPublic RPC
Solana Devnetsolana-devnetsolana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1, or solana:devnethttps://api.devnet.solana.com
Solana Testnetsolana-testnetsolana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z, or solana:testnethttps://api.testnet.solana.com

Use chain="solana-devnet" while you build. Morsel knows these ids, so a test transaction is never mistaken for a mainnet one.

Next

  • Connect kit: every prop, hook and component, and upgrading from 0.3.
  • Provider API: the injected provider in full.
  • Deep links: send phone users straight into Morsel's browser.

Try one of these