---

Mesh is an open-source TypeScript and JavaScript SDK for building applications on the Cardano blockchain. It handles the hard parts of Cardano development, such as coin selection, fee calculation, CBOR serialization and script evaluation, so you can focus on your app.

With Mesh you can:

• Build transactions with MeshTxBuilder: send ADA and native tokens, mint and burn NFTs, stake, vote in governance, and spend from Plutus and Aiken scripts.
• Connect wallets in the browser through CIP-30 (such as Eternl) with BrowserWallet, or sign server-side from a mnemonic or private key with MeshWallet.
• Use ready-made smart contracts for escrow, marketplaces, vesting, swaps and more, each with on-chain code and off-chain TypeScript.
• Query and submit through Blockfrost, Koios, Maestro, Ogmios, Yaci and other blockchain providers.
• Test offline against a local ledger with the Scalus emulator.

Mesh runs in Node.js, the browser, Next.js and other modern frameworks.

Quick start

Create a new Cardano dApp from a template with the Mesh CLI:

npx meshjs your-app-name

Or add Mesh to an existing project:

npm install @meshsdk/core

Example: send ADA from a browser wallet

import { BlockfrostProvider, BrowserWallet, MeshTxBuilder } from "@meshsdk/core";

const provider = new BlockfrostProvider("<BLOCKFROST_PROJECT_ID>");
const wallet = await BrowserWallet.enable("eternl");

const txBuilder = new MeshTxBuilder({ fetcher: provider, submitter: provider });

const unsignedTx = await txBuilder
  .txOut("addr_test1...", [{ unit: "lovelace", quantity: "5000000" }])
  .changeAddress(await wallet.getChangeAddress())
  .selectUtxosFrom(await wallet.getUtxos())
  .complete();

const signedTx = await wallet.signTx(unsignedTx);
const txHash = await provider.submitTx(signedTx);

Try this and many more transactions interactively in the Mesh playground.

Packages

This monorepo publishes the core Mesh packages to npm under the @meshsdk scope. Most apps only need @meshsdk/core, which re-exports transactions, wallets, providers and common utilities.

Packages in other repositories

These @meshsdk packages are developed in their own repositories:

Architecture

graph TD
  core["@meshsdk/core"]
  common["@meshsdk/common"]
  core_csl["@meshsdk/core-csl"]
  core_cst["@meshsdk/core-cst"]
  provider["@meshsdk/provider"]
  transaction["@meshsdk/transaction"]
  wallet["@meshsdk/wallet"]
  contract["@meshsdk/contract"]
  emulator["@meshsdk/scalus-emulator"]
  whisky["@sidan-lab/whisky-js"]
  cardano_sdk["@cardano-sdk/*"]
  harmoniclabs["@harmoniclabs/*"]

  contract --> core
  core --> provider
  core --> transaction
  core --> wallet
  core --> core_cst
  wallet --> transaction
  transaction --> core_cst
  emulator --> core_cst

  subgraph serializers
    core_csl --> whisky
    core_cst --> cardano_sdk
    core_cst --> harmoniclabs
  end

  core_cst --> common
  core_csl --> common

  click core_csl "https://docs.meshjs.dev/core-csl" _parent
  click core_cst "https://docs.meshjs.dev/core-cst" _parent
  click provider "https://github.com/MeshJS/providers" _parent
  click transaction "https://docs.meshjs.dev/transactions" _parent
  click wallet "https://github.com/MeshJS/wallet" _parent
  click contract "https://docs.meshjs.dev/contracts" _parent

Cardano smart contracts library

@meshsdk/contract includes open-source Cardano smart contracts, each with on-chain Aiken code, off-chain TypeScript, documentation and a live demo.

Developing Mesh

Mesh is a Turborepo monorepo using npm workspaces. You need Node.js 18 or later.

git clone https://github.com/MeshJS/mesh.git
cd mesh
npm install
npm run build

Contributing

Contributions of all kinds are welcome: bug fixes, new features, documentation, tests, and help triaging issues and pull requests.

• Read the contributing guide and Code of Conduct.
• See the developer docs for coding and pull request guidelines.
• Report bugs and request features in GitHub issues, or ask questions on Discord.

Using an AI coding assistant? MeshJS/skills gives Claude Code, Cursor, Codex and other tools deep knowledge of the Mesh SDK.

License

Mesh is released under the Apache 2.0 License.