Skip to main content

Building on Mintlayer

Mintlayer gives you the primitives, UTXO-based transactions, native token issuance (MLS-01/MLS-02), on-chain orders, and Bitcoin anchoring, plus the tooling to build on top of them. This page maps out what to use for what.

Local development setup​

For ports, RPC authentication, WebSocket subscriptions, regtest, and the WASM wrappers, start with the Developer Setup quick reference. For guided SDK walkthroughs of the workflows covered by the wallet-cli guides (tokens, NFTs, staking, orders, atomic swaps), see the Guides for Developers.

Integrate a wallet into your dApp​

  • Mojito Inject, the Mojito browser extension injects a window.mojito provider, similar to MetaMask's window.ethereum. Request accounts, sign, and send transactions directly from your frontend.
  • JavaScript SDK, a typed Client for the Mojito wallet extension, plus standalone key/mnemonic providers and a headless WalletState engine for scripts and bots.

Use a full SDK​

  • Go SDK, full coverage of the node, indexer, and wallet RPCs plus the embedded WASM cryptography runtime (no CGO). Recommended for services, exchanges, and backends.
  • Rust SDK, async sub-clients for the node, indexer, and wallet RPCs plus native cryptography and transaction building backed by mintlayer-core (opt-in crypto feature).
  • Python SDK, the Go SDK ported to Python: synchronous RPC clients plus the WASM cryptography runtime bundled via wasmtime.

Accept addresses from users​

Mintlayer addresses are Bech32m, and their checksum can locate up to two mistyped characters: implement address typo recovery to suggest a fix whenever a user pastes a broken address (and validate the network prefix while you are at it).

Query chain data​

  • API, the indexer REST API for blockchain data (blocks, transactions, tokens, addresses), backed by PostgreSQL. Start with the endpoint reference.
  • You can run the whole indexing stack yourself with Docker Compose, see Running the API server stack.

Cross-chain​

  • Atomic Swap with Bitcoin, trustless BTC ⇄ ML swaps using Hash Time-Locked Contracts, directly on-chain.
  • Bridge, transfer fungible tokens between Mintlayer and Ethereum.

Automate wallets​

  • Wallet RPC, full JSON-RPC 2.0 API for wallet management, transactions, staking, and token operations. Suitable for exchanges, custodians, and back-office services.
  • Node, chain queries, peer management, and block submission over the node's RPC interface.

Integrate AI agents​

  • MCP, hosted MCP endpoint that lets MCP-compatible AI assistants interact with Mintlayer services.
  • Agent-facing documentation: fetch /llms.txt for a machine-readable index of this whole site.

Understand the protocol​