Namoshi on Citrea

Property	Value
Network Name	Citrea Mainnet
Chain ID	`4114`
RPC URL	`https://rpc.mainnet.citrea.xyz`
Currency Symbol	`cBTC`
Block Explorer	explorer.mainnet.citrea.xyz

Property

Value

Network Name

Citrea Mainnet

Chain ID

4114

RPC URL

https://rpc.mainnet.citrea.xyz

Currency Symbol

cBTC

Block Explorer

explorer.mainnet.citrea.xyz

Contract	Address
Namoshi Registry	0x9fA2e2370dF8014EE485172bF79d10D6756034A8
Universal Resolver	0xc5Ed1fA34AD1F23F0cD2E36DB288290488B1B493
Base Registrar	0xDB814a8C706e040F6615F37509ae3a38721577e8
Controller	0xa08728ca65b6b980059dB463AD2714dfffa848cf

Contract

Address

Namoshi Registry

0x9fA2e2370dF8014EE485172bF79d10D6756034A8

Universal Resolver

0xc5Ed1fA34AD1F23F0cD2E36DB288290488B1B493

Base Registrar

0xDB814a8C706e040F6615F37509ae3a38721577e8

Controller

0xa08728ca65b6b980059dB463AD2714dfffa848cf

Configuring Viem / Wagmi

You can define the Citrea chain in your application using the following configuration:

import { defineChain } from 'viem'

export const citrea = defineChain({
  id: 4114,
  name: 'Citrea Mainnet',
  nativeCurrency: {
    name: 'Bitcoin',
    symbol: 'cBTC',
    decimals: 18,
  },
  rpcUrls: {
    default: {
      http: ['https://rpc.mainnet.citrea.xyz'],
    },
  },
  blockExplorers: {
    default: {
      name: 'Citrea Explorer',
      url: 'https://explorer.mainnet.citrea.xyz',
    },
  },
  contracts: {
    ensRegistry: {
      address: '0x9fA2e2370dF8014EE485172bF79d10D6756034A8',
    },
    ensUniversalResolver: {
      address: '0xc5Ed1fA34AD1F23F0cD2E36DB288290488B1B493',
    },
  },
})

Important: Resolution Configuration

For Wagmi and Viem hooks (like useEnsName, useEnsAddress, or getEnsAddress) to work on Citrea, your chain definition must explicitly include the Namoshi contract addresses in the contracts object.

Without these addresses, the libraries will default to looking for ENS on Ethereum Mainnet, which will fail to resolve your .btc and .citrea names.

Always verify that ensRegistry and ensUniversalResolver are pointing to the Namoshi addresses listed above in your wagmi config or viem public client.

Introduction

Core Concepts

Chain Information

Core Contract Addresses

Configuring Viem / Wagmi

Important: Resolution Configuration