Skip to main content

Getting started

These are the core components of the Immutable X stack:

  • API - Our API contains both the read and write functionality required to build applications without building a backend.
  • Immutable X SDK - Our TypeScript SDK implementation makes it easy for you to integrate the protocol easily into websites.
  • Link - Immutable X projects can embed the Link UI directly into their site’s transaction flow.
  • ZK-Rollups - Immutable X combines NFT-specific exchange and proof logic with the cutting edge rollup technology developed by StarkWare.

Learn more about Immutable X architecture

Prepare to test

No matter what your goal is for building on Immutable X — for example: drop an NFT collection, launch a marketplace or ecosystem product, integrate with your crypto game — there are three things you’ll need to get started:


To hold tokens or trade on Immutable X, you need an Ethereum wallet. Currently we support MetaMask, which is a crypto-wallet that’s accessible as a browser extension. It allows you to store and transact Ethereum, and access the services of decentralized applications, known as dApps.

MetaMask also makes it really easy to access testnet blockchains like Ropsten, which is what we use, and provides you with a wallet address, which you’ll need to register an account with us.

To create a MetaMask wallet:

  1. Open to install the browser extension.
  2. Follow the steps in the plugin to create a new wallet, then record and store your seed phrase in a safe location.
  3. Change the network selection from Main Ethereum Network to Ropsten Test Network.

Again, be mindful of how you store your seed phrase. If you lose this, you will lose access to your wallet forever, and neither we nor MetaMask are able to restore it for you.

Already have a wallet?

If you already have an Ethereum wallet, you can import it into MetaMask.

Test ETH

In order to make transactions while testing on Ropsten, you’ll need to fund your wallet with some ETH. Here are some faucets where you can get some:

Sometimes all faucets are dried up at once. There are others. Join the conversation in Discord for help or advice on stuff like this.

Register a user account

To begin testing, you need to register as a user with Immutable X. Registration sets up an account using the private key from your MetaMask wallet.

To register, visit the testnet version of our marketplace, then click Connect Wallet and follow the prompts. You'll need to repeat these steps again when registering on mainnet, by visiting:

Registration enables you to use our authentication system, which protects your project's administrative-level assets from being accessed or updated by someone else. Learn more about user security.