> ## Documentation Index
> Fetch the complete documentation index at: https://docs.namoshi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Namoshi Documentation

> The decentralized identity protocol for the Bitcoin ecosystem on Citrea

## Welcome to Namoshi

Namoshi is a distributed, open, and extensible naming system based on the Citrea blockchain. It brings human-readable identities to the Bitcoin ecosystem through **.btc** and **.citrea** domains.

<CardGroup cols={2}>
  <Card icon="book-sparkles" href="/protocol/introduction" title="Protocol Overview">
    Learn about the core architecture of Namoshi, including the Registry and Resolvers.
  </Card>

  <Card icon="code" href="/web/addresses" title="Integration Guide">
    Start integrating Namoshi names and avatars into your dApp on Citrea.
  </Card>
</CardGroup>

## The Identity Protocol for Citrea

Namoshi isn't just a naming service; it's the foundation for decentralized identity on Citrea. By mapping complex addresses to simple names, we enable a more social and accessible Web3 experience.

<CardGroup cols={2}>
  <Card icon="box-archive" href="/protocol/name-wrapper" title="Name Wrapping">
    Every Namoshi name can be wrapped as an ERC-1155 NFT, allowing for subdomain management and advanced permission controls through fuses.
  </Card>

  <Card icon="arrows-left-right" href="/protocol/reverse-registrar" title="Reverse Resolution">
    Ensure your identity follows you by mapping your Citrea address back to your preferred Namoshi primary name.
  </Card>
</CardGroup>

## Developer Resources

<CardGroup cols={3}>
  <Card icon="network-wired" href="/protocol/citrea-mainnet" title="Citrea Mainnet">
    Technical details and contract addresses.
  </Card>

  <Card icon="wallet" href="/guides/integration/wallet-button" title="Wallet Integration">
    Hooks and UI best practices.
  </Card>

  <Card icon="users" href="/guides/integration/leaderboards" title="Social Features">
    Profiles and batch name resolution.
  </Card>
</CardGroup>