So you want to add Kroma to MetaMask, but MetaMask doesn’t list it in the built-in network directory yet. You’re not alone — many newer Ethereum Layer 2 networks require a quick manual setup, and Kroma is one of them. The good news: the whole process takes about two minutes once you know where to find the right network details.
In this guide, you’ll learn exactly what Kroma is and why you’d bother adding it, how to add it to MetaMask automatically or manually step by step, how to verify the setup worked, and the common mistakes that trip people up. Everything is explained in plain English, with honest caveats about what to double-check as of this guide’s writing.
id=”what-is-kroma”>What Kroma Is and How It Works
Kroma is an Ethereum Layer 2 network — a separate blockchain built on top of Ethereum that processes transactions more cheaply and quickly, then settles the results back to Ethereum mainnet. It uses optimistic rollup technology, which is the same family of design as the more well-known optimistic rollups on the market. If you’ve used Optimism or Arbitrum before, Kroma will feel familiar.
The network was built by Lightscale, a Korean blockchain development team, and launched its mainnet in the mid-2020s. It is EVM-compatible, which means the same Ethereum wallet addresses, smart contract standards, and tools you already use work on Kroma without changes. Your MetaMask address on Kroma is identical to your Ethereum address — the network just reads your existing wallet on a different chain.
Kroma’s gas token is ETH, just like Ethereum mainnet. There is no separate Kroma gas token you need to buy — you pay for transactions in ETH, which you bridge over from Ethereum or another supported network. This is a deliberate design choice that keeps things simple: if you can hold ETH, you can pay for Kroma transactions.
At a general level, Kroma’s pitch is that it aims for cost efficiency and a gaming- and consumer-friendly ecosystem. Like most newer Layer 2s, it is still maturing — the ecosystem is smaller than the giant L2s, and you should expect fewer apps, fewer liquidity venues, and less battle-testing than you’d find on older networks. That’s not a reason to avoid it, but it is a reason to start small and treat it as an experiment rather than a home for your entire portfolio.
Why You’d Want to Add Kroma to MetaMask
The most common reason people add Kroma to MetaMask is to interact with something that lives on Kroma: a specific app, a bridge, an NFT project, or an airdrop claim. Without the Kroma network configured in your wallet, MetaMask literally cannot display Kroma balances or send Kroma transactions — the wallet needs the network’s RPC details to talk to it.
A second reason is cost. Transacting on Ethereum mainnet can be expensive during busy periods, and Layer 2 networks like Kroma generally offer much lower fees for the same types of operations. If an app you want to use exists on both Ethereum and Kroma, the Kroma version is typically cheaper to interact with.
Third, some users add new networks speculatively — to be ready for future airdrops or ecosystem opportunities. This is a legitimate reason, but be honest with yourself about it: adding a network costs nothing, but bridging funds to it and interacting with unfamiliar contracts carries real risk. Never move money you can’t afford to lose into a brand-new ecosystem just because you heard a rumor about a token drop.
Finally, developers and curious learners add networks like Kroma simply to explore. Kroma’s testnet (Kroma Sepolia) exists for exactly this purpose, and experimenting there costs nothing but test tokens. If you’re adding mainnet Kroma for real transactions, keep the amounts small until you’re comfortable.
What You Need Before You Start
Before you add Kroma to MetaMask, make sure you have these basics covered:
- MetaMask installed. The browser extension or mobile app, updated to a recent version. If you haven’t set up a wallet yet, do that first and securely back up your seed phrase.
- The Kroma network details. You’ll need the network name, RPC URL, chain ID, currency symbol, and block explorer address. The official details, as of this guide’s writing, are:
- Network name: Kroma
- RPC URL: https://api.kroma.network (the official endpoint; third-party alternatives like dRPC also publish Kroma endpoints)
- Chain ID: 255 (decimal; 0xff in hexadecimal)
- Currency symbol: ETH
- Block explorer URL: https://blockscout.kroma.network
A note on honesty: endpoints can change. Before pasting any RPC URL, take thirty seconds to cross-check it against a trusted source — MetaMask’s own network directory, the Kroma official documentation at the official Kroma site (type the address yourself), or a well-established chain directory. If the values above ever disagree with those sources, trust the sources.
- A healthy suspicion of strangers. If anyone sends you “the Kroma RPC details” in a DM, on Telegram, or in a Discord server, do not use them. Malicious RPC endpoints are a real phishing vector. More on that below.
Method 1: Add Kroma Automatically (One-Click)
The fastest way to add Kroma is through a one-click “add to wallet” button provided by a trusted chain directory. These buttons use the wallet_addEthereumChain request, a standard MetaMask feature that lets a website propose a network for you to approve.
Here’s how it works:
- Open MetaMask in your browser and unlock it.
- Navigate to a reputable chain directory. Chainlist is the most widely used one — search for it yourself and verify you’re on the genuine site before connecting anything. Type the address yourself rather than clicking a link from social media.
- Search for Kroma in the directory’s search bar.
- Click the “Add to MetaMask” button on the Kroma entry.
- MetaMask will pop up asking you to approve adding the network. Review the details shown in the popup — network name Kroma, chain ID 255, currency ETH — and click Approve.
- You’ll be asked whether you want to switch to Kroma now. Click Switch network if you want to start using it immediately, or close the popup to stay on your current network.
That’s it. Kroma should now appear in your MetaMask network dropdown. If you’d like to compare the one-click and manual methods, see the table below.
| Factor | One-click (chain directory) | Manual entry |
|---|---|---|
| Speed | Seconds — one approval click | About two minutes of typing |
| Risk of typos | Very low — details pre-filled | Moderate — you type the chain ID and URL yourself |
| Trust involved | You trust the directory listing | You trust your own source for the details |
| Best for | Most beginners | Privacy-minded users who avoid connecting wallets to sites |
| Works on mobile | Yes, via the in-app browser | Yes, via Settings → Networks |
Method 2: Add Kroma Manually, Step by Step
If you’d rather not connect your wallet to any website — or if the one-click button isn’t cooperating — manual entry is straightforward. Follow these steps in the MetaMask browser extension:
- Open MetaMask and click the network dropdown at the top (it usually says “Ethereum Mainnet” or whichever network you’re on).
- Click “Add network” at the bottom of the list.
- MetaMask opens a new tab with a network directory. Scroll to the bottom and click “Add a network manually”.
- Fill in the fields exactly as follows (double-check each one before saving):
- Network name: Kroma
- New RPC URL: https://api.kroma.network
- Chain ID: 255
- Currency symbol: ETH
- Block explorer URL: https://blockscout.kroma.network
- Click Save. MetaMask will validate the details — if the chain ID and RPC are correct, it saves the network.
- You’ll be prompted to switch to Kroma. Do so if you’re ready, or skip it and switch later from the network dropdown.
On MetaMask mobile: tap the menu, go to Settings → Networks → Add Network → Custom network, and enter the same details. The flow is the same, just rearranged for a smaller screen.
One thing worth knowing: MetaMask asks for the chain ID as a plain number (255), not the hexadecimal version. If a source gives you 0xff, that’s the same value — MetaMask accepts the decimal form, so enter 255.
How to Verify Kroma Was Added Correctly
Don’t just assume it worked — a thirty-second check saves you from the confusion of sending funds to a misconfigured network later.
- Check the dropdown. Click the network selector in MetaMask. You should see Kroma listed among your networks, with the correct icon if MetaMask recognizes it.
- Switch to it. Select Kroma. The wallet header should show Kroma, and your balance line should read ETH with a zero balance (unless you’ve already bridged funds).
- Confirm the chain ID matches. You can verify the network details by going to Settings → Networks → Kroma in MetaMask and reviewing the saved fields. Chain ID should read 255.
- Open the block explorer. Visit the Kroma block explorer (https://blockscout.kroma.network — type it yourself) and paste your wallet address into the search bar. If the address page loads and shows the network as Kroma, everything lines up.
- Test with a tiny amount first. When you eventually bridge ETH to Kroma, start with a small amount and confirm it arrives before moving larger sums. This is the single most valuable habit in all of crypto.
If you’re unsure whether a dapp is really connecting to Kroma, the network name shown in MetaMask’s connection prompt is your source of truth. Scam sites sometimes mimic legitimate apps while quietly requesting a connection to a different network — always read the popup.
For more on moving between networks safely in general, see our guide on how to switch networks in MetaMask safely, which covers the habits that prevent most cross-network mistakes.
Common Mistakes (and How to Fix Them)
Most problems adding Kroma come down to one of these:
- Wrong chain ID. Typing 225 instead of 255, or pasting a testnet chain ID (Kroma Sepolia uses a different one). Fix: delete the network in Settings → Networks and re-add it with chain ID 255.
- Copy-pasting an RPC URL from a random source. A malicious RPC endpoint can’t steal your funds directly, but it can spy on your activity, censor your transactions, or feed you false data. Fix: only use endpoints from Kroma’s official documentation or established providers, and cross-check before pasting.
- Adding the testnet by accident. Kroma Sepolia is the test network — it uses test ETH with no real value. If you added Kroma but see a network named “Kroma Sepolia,” you added the wrong one. Fix: add mainnet separately with the details in this guide.
- Expecting your Ethereum balance to appear. Balances don’t follow you across networks. Your ETH on Ethereum mainnet will not show up when you switch to Kroma — you need to bridge it over first. This is normal and not a bug.
- Sending tokens to the Kroma address from an exchange without checking support. Some exchanges don’t support Kroma withdrawals at all. If you withdraw to your address while the exchange is actually sending on a different network, funds can end up somewhere unexpected. Fix: always confirm the exchange explicitly supports the Kroma network before withdrawing.
- Bridging to Kroma for the first time and panicking when funds don’t arrive instantly. Bridges take time — sometimes minutes, sometimes longer depending on the route and network congestion. Check the transaction on the Kroma block explorer before assuming something went wrong.
If you ever need to remove a network, go to Settings → Networks, select it, and delete it. This doesn’t affect your funds — your address and assets live on the blockchain, not in MetaMask’s settings.
Frequently Asked Questions
The Bottom Line
Adding Kroma to MetaMask is a two-minute job: use a trusted chain directory’s one-click button, or enter the details manually — network name Kroma, RPC https://api.kroma.network, chain ID 255, currency ETH. Verify the setup by checking the network dropdown and the block explorer, start with small amounts, and never paste RPC details from untrusted sources.
Kroma is a legitimate young Layer 2 with the usual young-network caveats: smaller ecosystem, less battle-testing, and the standard bridge and smart-contract risks. Treat your first interactions as experiments, keep amounts modest, and you’ll be set up safely. For a broader walkthrough of adding other networks, our Polygon setup guide and Soneium setup guide follow the same pattern.
This guide is for education only — not financial advice.
