Skip to main content
Namoshi is the primary naming service for the Citrea ecosystem. Citrea is the first rollup that enhances the capabilities of Bitcoin with EVM-compatible smart contracts.

Chain Information

To interact with Namoshi, you must configure your application to use the Citrea Mainnet.

Core Contract Addresses

Configuring Viem / Wagmi

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

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.