Clusters
  • Introduction
    • Overview
    • Concepts
      • Cluster Name
      • Wallet Name
    • Features
      • Communities
      • Multichain
      • Wallet Bundles
      • Antisquatting
      • Wallet Generation
      • Selective Wallet Sharing
  • Getting started
    • Javascript
      • Authentication
      • Clusters
      • Address → Cluster Name
      • Cluster Name → Address
      • Registration
        • Communities
      • Event Indexing
    • API
      • v1
        • Authentication
        • Clusters
        • Address → Cluster Name
        • Cluster Name → Address
        • Registration
          • Communities
        • Event Indexing
      • v0.1 (Deprecated)
        • Address → Cluster
        • Cluster → Address
        • Cluster → Metadata
        • Registration
        • Managing Wallets
  • Resources
    • Smart Contracts
    • Address Types
    • Using Clusters for ETH->SOL Airdrops
  • Integration Guides
    • Convert hex address to clusters name
    • Registering a name
      • Ethereum Networks
      • Solana
    • Whitelabel Communities Registration Flow
Powered by GitBook
On this page
  1. Introduction
  2. Concepts

Wallet Name

A cluster is a bundle of addresses where each address has its own unique name. For example, my cluster might be foobar/ and I'd have three wallets each named foobar/cold, foobar/memecoins, and foobar/gaming, respectively. The part before the / slash is called the cluster name, the part after the / slash is called the wallet name.

Requirements

  • Uniqueness: There cannot be 2 wallet names that are the same under a namespace. So you cannot have an EVM address called foobar/defi and a solana address that is also called foobar/defi

  • Length: There are currently no limit to how long a wallet name should be. But it's encouraged to keep it under 10 characters.

  • Allowed Characters: Supported characters include a-z, 0-9, underscores (_), and dashes (-)

  • Case Sensitivity: Cluster names are case insensitive. So foobar/defi and foobar/Defi will be treated the same.

Data structure - A wallet consists of:

  • Cluster Name: What cluster name that wallet is attaached to

  • Wallet name: The shorthand name you give your wallet address

  • Address: The full length address of the wallet. It's then converted and stored in bytes32 format.

  • Verification: Verified wallets are unique to the entire ecosystem. You can't have a wallet verified on 2 clusters at a time. This represents priority when querying names.

    • For example: If 0x123 is on foobar/cold and 0x123 is also on rye/hot but verified, rye/hot will have priority when resolving a cluster via an address.

PreviousCluster NameNextFeatures

Last updated 6 months ago