MeshJS Mesh SDK Wallet Skill
AI-assisted Cardano wallet integration using @meshsdk/wallet.
Package Info
npm install @meshsdk/wallet
# or
npm install @meshsdk/core # includes wallet + transaction + provider
Two Wallet Types
| Type | Class | Use Case |
|---|---|---|
| Browser | MeshCardanoBrowserWallet |
Web apps - connect to Eternl, Nami, Flint, etc. |
| Headless | MeshCardanoHeadlessWallet |
Server-side, CLI, backend - from mnemonic/keys |
Quick Reference
Browser Wallet (CIP-30)
import { MeshCardanoBrowserWallet } from '@meshsdk/wallet';
// List installed wallets
const wallets = MeshCardanoBrowserWallet.getInstalledWallets();
// → [{ id: 'eternl', name: 'Eternl', icon: '...', version: '...' }, ...]
// Connect to wallet
const wallet = await MeshCardanoBrowserWallet.enable('eternl');
// Get addresses (Bech32)
const addresses = await wallet.getUsedAddressesBech32();
const changeAddr = await wallet.getChangeAddressBech32();
const stakeAddrs = await wallet.getRewardAddressesBech32();
// Get UTxOs and balance (Mesh format)
const utxos = await wallet.getUtxosMesh();
const balance = await wallet.getBalanceMesh();
const collateral = await wallet.getCollateralMesh();
// Sign and submit
const signedTx = await wallet.signTxReturnFullTx(unsignedTxHex);
const txHash = await wallet.submitTx(signedTx);
// Sign data (CIP-8)
const signature = await wallet.signData(address, 'Hello Cardano!');
Headless Wallet (Server-Side)
import { MeshCardanoHeadlessWallet } from '@meshsdk/wallet';
import { BlockfrostProvider } from '@meshsdk/core';
const provider = new BlockfrostProvider('your-api-key');
// From mnemonic
const wallet = await MeshCardanoHeadlessWallet.fromMnemonic({
mnemonic: ['word1', 'word2', ...], // 24 words
networkId: 0, // 0 = testnet, 1 = mainnet
walletAddressType: 'Base', // 'Base' or 'Enterprise'
fetcher: provider,
submitter: provider,
});
// Same API as browser wallet
const address = await wallet.getChangeAddressBech32();
const utxos = await wallet.getUtxosMesh();
const signedTx = await wallet.signTxReturnFullTx(unsignedTxHex);
Files
- WALLET.md - Complete API reference
- PATTERNS.md - Common wallet patterns
- TROUBLESHOOTING.md - Error solutions
CIP-30 Methods
Standard wallet interface methods:
| Method | Returns | Description |
|---|---|---|
getNetworkId() |
number |
0 = testnet, 1 = mainnet |
getUtxos() |
string[] |
UTxOs in CBOR hex |
getCollateral() |
string[] |
Collateral UTxOs in CBOR hex |
getBalance() |
string |
Balance in CBOR hex |
getUsedAddresses() |
string[] |
Addresses in hex |
getUnusedAddresses() |
string[] |
Addresses in hex |
getChangeAddress() |
string |
Address in hex |
getRewardAddresses() |
string[] |
Stake addresses in hex |
signTx(tx, partial) |
string |
Witness set in CBOR hex |
signData(addr, data) |
DataSignature |
CIP-8 signature |
submitTx(tx) |
string |
Transaction hash |
Mesh Extensions
Enhanced methods for better developer experience:
| Method | Returns | Description |
|---|---|---|
getUtxosMesh() |
UTxO[] |
UTxOs in Mesh format |
getCollateralMesh() |
UTxO[] |
Collateral in Mesh format |
getBalanceMesh() |
Asset[] |
Balance in Mesh format |
getUsedAddressesBech32() |
string[] |
Bech32 addresses |
getUnusedAddressesBech32() |
string[] |
Bech32 addresses |
getChangeAddressBech32() |
string |
Bech32 address |
getRewardAddressesBech32() |
string[] |
Bech32 stake addresses |
signTxReturnFullTx(tx, partial) |
string |
Full signed tx (not just witness) |
Important Notes
- Browser wallet requires user interaction -
enable()prompts the user - Headless wallet needs fetcher - For UTxO queries and signing
- Network ID matters - 0 for testnet/preprod, 1 for mainnet
- Collateral is auto-selected - Returns smallest pure-ADA UTxO >= 5 ADA