# Project Overview

## Mission

Make the semantic of each blockchain entity universally accessible, and understandable, cultivating an ecosystem where information is transparent, reliable, and readily available for all.

## Motivation

Blockchain label data is predominantly confined within walled gardens, primarily driven by commercial interests, as label sourcing, curation, and serving can be costly. This limitation hinders the democratization of blockchain data and slows down development efficiency. We aim to create an open system that enables systematic label sourcing, ensures data quality, rewards contributors, and maintains an open dataset accessible to the community.

## End Game

The ultimate objective is establishing a robust, high-quality blockchain entity metadata infrastructure, serving as a fundamental public resource for the crypto community. This foundation will empower the crypto community to host and access the data, enabling seamless integration and allowing community members to confidently rely on this critical infrastructure for their projects and initiatives.

## Governance Entity

The ideal goal of the governance model is to build a versatile and sustainable DAO to enable a collaborative approach to source and curate this data, leveraging the collective intelligence and resources of the global blockchain community.To bridge to the DAO version - Microscope protocol unique interest group governance (Microscope protocol SIGG).

1. It consists of **7** governance members from the core development team and representatives.
2. Key decisions are made through this group until the DAO is established.
3. SIGG is responsible for initiating and coordinating development and community efforts, and here are some of its responsibility.
   * Guiding vision: The president may help define and maintain the DAO's mission, values, and long-term goals, ensuring that community decisions align with the organization's objectives.
   * Facilitating communication: The president could liaise between the DAO members and external stakeholders, including partners, regulators, and the broader community. This may involve communicating the DAO's progress, challenges, and successes to maintain transparency.
   * Coordinating efforts: The president may help streamline efforts by organizing and coordinating working groups or committees focused on specific tasks or projects within the DAO.
   * Conflict resolution: As a neutral party, the president may assist in resolving disputes or disagreements among members, fostering a healthy and collaborative environment.
   * Encouraging participation: The president could motivate and inspire members to actively contribute to the DAO's initiatives and governance processes.
   * Continuous improvement: The president may work with members to assess the DAO's governance structure and processes, identifying areas for improvement and implementing changes as needed.
4. A president's role is defined as facilitating coordination within SIGG.

## Definition of Roles

**SIGG members**: a group of key members who contribute to the vision and mission of Microscope protocol, to transit the group to be a sustainable DAO.

**Core dev**: core developer contributes to the code base.

**Members**: people and entities that contribute to the community in some form.

## Community Contacts

<https://discord.gg/qNW9s6hmUq>

<https://leozc.notion.site/Open-Blockchain-Meta-438374dfd880436eaf996e5897e5ff93>

## Reference

<https://lexnode.substack.com/p/defining-real-and-fake-daos>

Original Doc: [OpenMeta Mission and Governance draft](https://docs.google.com/document/d/1mCttbfbZQA-ntj9JynqL83XWF-ElzXZq3ZtRgcjSdJs/edit#)


# Operation Principles

Here are some principles to keep in mind when contributing to open metadata

## **Collaboration**

Collaboration is at the heart of metadata development, and therefore, contributions should be made with an **`open`**, **`respectful`**, and mutually beneficial mindset. This entails sharing ideas, knowledge, and constructive feedback in a respectful manner that promotes open dialogue and constructive debate.

## **Consistency**

Conforming to established guidelines and best practices is essential for ensuring consistency in metadata. As such, contributors should strive to align their contributions with existing **`standards`** and **`conventions`**, to maintain coherence and facilitate interoperability with other systems and tools.

## **Quality**

The open metadata community prioritizes contributions of the highest quality. To maintain consistency with existing standards and conventions, contributors should adhere to established guidelines and best practices. It is crucial that metadata is accurate and reliable in order to be valuable, therefore, contributors must ensure that their contributions are both **`correct`** and **`up-to-date`**.

## **Community**

The open metadata community is built on the principle of openness. This means that contributions should be **`transparent`**, **`accessible`**, and **`available`** for reuse by others. The community also welcomes contributions from all individuals regardless of their background, experience, or skill level. Everyone has something valuable to contribute.

## **Privacy**

Metadata privacy is a critical consideration in contributing to open metadata. To safeguard against the disclosure of personally identifiable information (PII) and individual notations, contributors should **`prioritize public entities`** and refrain from providing sensitive or private information in their contributions.


# FAQ

## **On using data**

### **Q1:** What data that the project aims to offer?

A: The primary objective of Microscope protocol is to foster collaboration in annotating crypto addresses with labels. These labels comprise four main elements: <mark style="color:red;">**`category`**</mark>(e.g., "CEX", "Hot wallet"), <mark style="color:red;">**`entity`**</mark>(e.g., "Uniswap", "Coinbase"), <mark style="color:red;">**`name`**</mark>(e.g., "Uniswap-1") and <mark style="color:red;">**`source`**</mark> (e.g., “ground-truth”, “ML”). As a demonstration, we believe that using this label data alongside additional data and analytics technology could enable the development of applications for on-chain security, reputation scoring, AML compliance, and more. For further details, please refer to the respective pages: [label data schema](/onboarding/data/schema),[ <mark style="color:blue;">all categories</mark>](/onboarding/data/categories), [tracked entities](/onboarding/data/entity) and [possible sources](/onboarding/data/source). (Note: The structure, categories, and design documentation are subject to community-driven iteration and improvement over time.)​

### **Q2:** What are the constraints when developing applications using annotated data?

A: We, the founding contributors to this project, reached a consensus to adopt the Apache License ([https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0**)). We would like to share some thoughts around the decision as well. Our ultimate goal is to establish data as a fundamental building block, enabling applications that aim to enhance the overall quality of the Web3 and cryptocurrency sectors. Nevertheless, the precise policy will be formulated, taking into account an incentive mechanism that fosters a robust and continually evolving system. Regardless, the applications we aspire to support or empower may tackle issues in areas such as security, compliance, and reputation scoring, among others, but are by no means limited to these.

## **On contributing**

### **Q3:** Who can contribute?

&#x41;**:** Contributions to this project are welcomed from both organizations and individuals, encompassing various roles. We are looking for contributions in creating accurate labeled data, developing software, designing taxonomy, evangelizing our efforts, and promoting applications, among other potential roles. Initially, we will focus on inviting a select group of industry organizations to establish a foundational batch of label data, essential infrastructure, and community policy drafts. In the long term, we envision a fully community-driven, permissionless project that welcomes diverse contributions from individuals and organizations, continuously enriching the label data. Our goal is to make it the de-facto source for the most comprehensive blockchain label datasets, enabling the development of related data applications.

### ​**Q4:** What are responsibilities and rewards, if you make contributions?

A: In terms of responsibilities and rewards, we welcome and appreciate voluntary contributions. As our project aims to serve as a mission-critical building block for empowering impactful initiatives that enhance security, compliance, and trustworthiness in web3, we expect contributors to commit to the quality of their work. This includes the accuracy of data labels (or transparent communication of uncertainties) and the development of robust software, among other role-specific tasks. While we will not penalize well-intentioned contributors, we will reward contributions based on various factors such as impact, quality, and scarcity. We are working on details.

**​**

## **On understanding data**

### **Q5:** What is a data schema, and what are the essential elements of a labeled data record?

&#x41;**:** To facilitate data sharing and labeling collaboration, we have designed a [<mark style="color:blue;">**`common`**</mark> <mark style="color:blue;">**`schema`**</mark>](/onboarding/data/schema)  and taxonomy system that all contributed labeled data records can fit into. This system enables a seamless two-way pipelines for label contribution and consumption. Each member organization can maintain their **`own schema`**, which can exchange information with data in the common schema. For the taxonomy system, we have identified key elements and their possible values, along with their definitions, in separate pages for [<mark style="color:blue;">**`categories`**</mark>](/onboarding/data/categories) , [**`entities`**](/onboarding/data/entity), and [**`sources`**](/onboarding/data/source). These elements provide a consistent and standardized way of categorizing and labeling data, which can be used across multiple datasets and organizations in our project.


# Data

{% content-ref url="/pages/4ii5YpXJTAxmmKSnhaWV" %}
[Schema](/onboarding/data/schema)
{% endcontent-ref %}

{% content-ref url="/pages/xY3LYUadBQNRKcFXTgTY" %}
[Chain](/onboarding/data/chain)
{% endcontent-ref %}

{% content-ref url="/pages/GJqfnczGxlGixWu0jnFV" %}
[Entity](/onboarding/data/entity)
{% endcontent-ref %}

{% content-ref url="/pages/jFDW7XyUkDFZoAfo9hnI" %}
[Name](/onboarding/data/name)
{% endcontent-ref %}

{% content-ref url="/pages/TSUReTKQEkrFabVGLB6W" %}
[Categories](/onboarding/data/categories)
{% endcontent-ref %}

{% content-ref url="/pages/taD6LdrXEODKI9sKzoTI" %}
[Source](/onboarding/data/source)
{% endcontent-ref %}

{% content-ref url="/pages/Rhz7KFAAibuNXn89xsF2" %}
[Submitted By and Submitted On](/onboarding/data/submitted-by-and-submitted-on)
{% endcontent-ref %}

<br>


# Schema

Our project's primary objective is to foster industry-wide data sharing by employing a common schema to define data structures. Simultaneously, each participating organization can maintain their own schema with variations from the common one, streamlining the process of transferring data to the Microscope protocol database.

1. [Meta Schema](https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/schema/meta_schema.json): defines the common structure of blockchain label data in this project. We have designed the schema with primary objectives focused on enabling capabilities such as comprehensive blockchain label data sharing, version control for taxonomy iteration, contribution measurement, and potential tracking of data record consumption
2. Examples of per-organization schemas:
   * [Coinbase](https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/schemas/coinbase_schema.json): <https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/schemas/coinbase_schema.json>
   * [Chaintool](https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/schemas/chaintool_schema.json): <https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/schemas/chaintool_schema.json>

{% code lineNumbers="true" %}

```javascript
{
    "$schema": "<http://json-schema.org/draft-07/schema#>",
    "title": "ChainMeta",
    "description": "An object designed to uniformly describe blockchain metadata from different providers",
    "type": "object",
    "required": [
        "community",
        "provider",
        "version",
        "revision",
        "introduction",
        "chainmetadata"
    ],
    "properties": {
        "community": {
            "description": "The community name of this open source project",
            "type": "string",
            "enum": [
                "openchainmeta"
            ]
        },
        "provider": {
            "description": "Basic information of the data provider",
            "type": "object",
            "required": [
                "provider_name",
                "provider_id",
                "provider_signature"
            ],
            "properties": {
                "provider_name": {
                    "description": "Provider's name",
                    "type": "string"
                },
                "provider_id": {
                    "description": "Provider's unique id",
                    "type": "string",
                    "pattern": "^ocm[0-9]{6}$"
                },
                "provider_signature": {
                    "description": "Provider's signature",
                    "type": "string"
                }
            }
        },
        "version": {
            "description": "The version of provider's metadata",
            "type": "string"
        },
        "revision": {
            "description": "The revision of provider's metadata",
            "type": "integer"
        },
        "introduction": {
            "description": "Introduction of provider's metadata",
            "type": "string",
            "format": "uri"
        },
        "chainmetadata": {
            "description": "Details of provider's metadata",
            "type": "object",
            "required": [
                "schema",
                "artifact"
            ],
            "properties": {
                "schema": {
                    "description": "Schema of provider's metadata, explain how data is read",
                    "type": "string",
                    "format": "uri"
                },
                "artifact": {
                    "description": "Storage details of provider's metadata",
                    "type": "array",
                    "minItems": 1,
                    "items": {
                        "type": "object",
                        "required": [
                            "path",
                            "fileformat",
                            "signature"
                        ],
                        "properties": {
                            "artifact_type": {
                                "description": "Type of artifact",
                                "type": "string",
                                "enum": [
                                    "s3",
                                    "remote path",
                                    "local file"
                                ]
                            },
                            "path": {
                                "description": "Path of the metadata file",
                                "type": "string",
                                "format": "uri"
                            },
                            "fileformat": {
                                "description": "Format of the metadata file",
                                "type": "string",
                                "enum": [
                                    "json",
                                    "parquet",
                                    "csv"
                                ]
                            },
                            "signature": {
                                "description": "Signature of the metadata file",
                                "type": "string"
                            }
                        }
                    }
                }
            }
        }
    }
}
```

{% endcode %}


# Chain

> Github：<https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/config/chains.json>

## Description

This field provide information about which blockchain network that a given address belongs to, which include both L1 and L2 networks.


# Entity

{% hint style="info" %}
*Please note that while the information presented on this page is intended for **human consumption** and is accurate to the best of our knowledge, the official **source of truth** for our project is the corresponding codified files hosted on GitHub. We strive to maintain up-to-date and accurate information on this page, but please refer to the GitHub repository for the most current and reliable information.*&#x20;
{% endhint %}

> Github: <https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/config/entities.json>

## Description

The ‘Entity’ field, together with the ‘Name’ fields, contains the actual label information for a given address. It provides the information about whether a given address belongs to a specific entity - for example, the user may find an address with the address name ‘Binance deposit address’ and ‘Binance por address’ both under entity ‘Binance’.<br>


# Name

## Description

The ‘Name’ field, together with the ‘Entity’ fields, contain the actual label information for a given address. It provides address ownership information - for example, it tells users whether this is a Binance address or it is a Coinbase address.


# Categories

> Github: <https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/config/categories.json>

## Description

This field provides information about any common characteristics that that a particular group of labelled addresses are shared with each other. It can be for functionality characteristics such as whether a specific address is used by CEX or DeFi protocols or it can be behaviour characteristics such as whether a specific address is a risky address (e.g. participated in any illicit activities). Each single address can have more than one categories assigned.

The list of values that are available for ’Categories’ are in the table below:

<table><thead><tr><th width="104" align="center">INDEX</th><th width="153" align="center">CATEGORY</th><th width="328">DESCRIPTION</th><th align="center">EXAMPLE</th></tr></thead><tbody><tr><td align="center">1</td><td align="center">Cold Storage</td><td>An offline wallet used to securely store large amounts of cryptocurrency for extended periods of time.</td><td align="center">Ledger Nano X</td></tr><tr><td align="center">2</td><td align="center">Hot wallet</td><td>An online wallet that offers easy and quick access to cryptocurrency funds for everyday use.</td><td align="center">Coinbase Wallet</td></tr><tr><td align="center">3</td><td align="center">Deprecated</td><td>A smart contract that is no longer in use and has been deprecated by the protocol or development team.</td><td align="center">EIP-20</td></tr><tr><td align="center">4</td><td align="center">Multisig</td><td>An address that requires approval from multiple parties to access cryptocurrency funds, providing an additional layer of security. Commonly used by exchanges and institutional investors.</td><td align="center">Gnosis Safe Multisig</td></tr><tr><td align="center">5</td><td align="center">Vault</td><td>A smart contract-based system that automatically invests cryptocurrency funds to generate yield for users, commonly used in decentralized finance (DeFi) applications and managed by the protocol or community.</td><td align="center">Yearn Finance Vault</td></tr><tr><td align="center">6</td><td align="center">Vault User</td><td>An address that interacted with a smart contract-based system that automatically invests cryptocurrency funds to generate yield for users, commonly used in decentralized finance (DeFi) applications and managed by the protocol or community.</td><td align="center">Yearn Finance Vault User</td></tr><tr><td align="center">7</td><td align="center">Vulnerable</td><td>An address whose private keys have been compromised or are publicly available, exposing it to the risk of unauthorized access or theft.</td><td align="center">Mt. Gox hack victim</td></tr><tr><td align="center">8</td><td align="center">Smart Contract</td><td>An address used by developers or teams to deploy smart contracts on a blockchain for decentralized applications or other projects.</td><td align="center">Uniswap</td></tr><tr><td align="center">9</td><td align="center">NFT</td><td>An address controlled by an NFT marketplace that facilitates the buying, selling, or trading of non-fungible tokens.</td><td align="center">OpenSea</td></tr><tr><td align="center">10</td><td align="center">DEX</td><td>An address or wallet used in decentralized exchanges to facilitate peer-to-peer trading of cryptocurrencies without a central authority.</td><td align="center">Uniswap</td></tr><tr><td align="center">11</td><td align="center">DEX User</td><td>An address that interacted with a smart contract for a decentralized exchange used to facilitate peer-to-peer trading of cryptocurrencies without a central authority.</td><td align="center">Uniswap User</td></tr><tr><td align="center">12</td><td align="center">CEX</td><td>A centralized exchange (CEX) that allows users to trade cryptocurrencies in exchange for fiat or other cryptocurrencies.</td><td align="center">Binance</td></tr><tr><td align="center">13</td><td align="center">Exchange</td><td>Addresses used by centralized or decentralized exchanges to interact with smart contracts and blockchain networks.</td><td align="center">OKX</td></tr><tr><td align="center">14</td><td align="center">ATM</td><td>Related to a cryptocurrency ATM that allows users to buy or sell cryptocurrencies using cash or debit/credit cards.</td><td align="center">Bitcoin Depot</td></tr><tr><td align="center">15</td><td align="center">Auction</td><td>Related to an auction that can be held by a variety of entities, including law enforcement agencies (LEA).</td><td align="center">US Marshals Service Bitcoin Auction</td></tr><tr><td align="center">16</td><td align="center">Gambling</td><td>Related to a gambling website that allows users to place bets on various games using cryptocurrencies.</td><td align="center">Bitcasino.io</td></tr><tr><td align="center">17</td><td align="center">Gaming</td><td>Related to a gaming platform or game that allows users to buy, sell or trade digital assets or in-game items.</td><td align="center">Axie Infinity</td></tr><tr><td align="center">18</td><td align="center">LE (Law Enforcement)</td><td>An address or wallet certified to belong to a law enforcement agency (LE).</td><td align="center">FBI</td></tr><tr><td align="center">19</td><td align="center">Lending</td><td>Related to lending or borrowing activities in the crypto space, such as those belonging to lending platforms or peer-to-peer lending services.</td><td align="center"><p>BlockFi, </p><p>Celsius Network, Aave, Compound, Nexo</p></td></tr><tr><td align="center">20</td><td align="center">Lending User</td><td>An address that interacted with a smart contract belonging to lending platforms or peer-to-peer lending services.</td><td align="center">BlockFi User</td></tr><tr><td align="center">21</td><td align="center">Merchant</td><td>Addresses or wallets that are associated with merchants who accept payment in cryptocurrencies.</td><td align="center"><p>Overstock.com, Starbucks, </p><p>Tesla, </p><p>Microsoft</p></td></tr><tr><td align="center">22</td><td align="center">Mixer</td><td>Addresses or wallets that are associated with crypto mixers or tumblers, which are services that mix multiple transactions together in order to obfuscate the origin of the funds.</td><td align="center">Wasabi Wallet, Samurai Wallet, CoinJoin</td></tr><tr><td align="center">23</td><td align="center">Payment Processor</td><td>Related to a business that facilitates transactions between buyers and sellers using cryptocurrency as payment.</td><td align="center">BitPay</td></tr><tr><td align="center">24</td><td align="center">Business or Services, Other</td><td>Related to a business or service that operates within the crypto ecosystem but does not fit into any of the other categories.</td><td align="center">Crypto tax service provider</td></tr><tr><td align="center">25</td><td align="center">Token Team</td><td>An address or wallet that is controlled by the team responsible for creating and maintaining a particular cryptocurrency token.</td><td align="center">Ethereum Foundation</td></tr><tr><td align="center">26</td><td align="center">Ethereum Foundation</td><td>An address or wallet that is involved in the sale or exchange of weapons using cryptocurrency.</td><td align="center">DarkMarket</td></tr><tr><td align="center">27</td><td align="center">Marketplace Aggregator</td><td>Related to a business or service that consolidates data from multiple decentralized exchanges or NFT markets in order to provide users with a comprehensive view of the market.</td><td align="center">1inch</td></tr><tr><td align="center">28</td><td align="center">L2</td><td>An address or wallet associated with a layer 2 scaling solution built on top of the Ethereum network.</td><td align="center">Polygon</td></tr><tr><td align="center">29</td><td align="center">Insurance</td><td>Related to A business or service that provides insurance coverage for cryptocurrency assets stored on the blockchain.</td><td align="center">Nexus Mutual</td></tr><tr><td align="center">30</td><td align="center">Asset Management</td><td>Related to A business or service that manages cryptocurrency assets on behalf of clients.</td><td align="center">Grayscale Investments</td></tr><tr><td align="center">31</td><td align="center">Streaming</td><td>Related to A business or service that provides streaming media content using cryptocurrency payments.</td><td align="center">Livepeer</td></tr><tr><td align="center">32</td><td align="center">Infra</td><td>Related to A business or service that provides infrastructure services to support the operation of blockchain networks.</td><td align="center">Infura</td></tr><tr><td align="center">33</td><td align="center">Oracle</td><td>Related to A service that provides off-chain data to smart contracts. Oracles allow smart contracts to interact with external data sources, making them more versatile and useful.</td><td align="center">Chainlink</td></tr><tr><td align="center">34</td><td align="center">DAO</td><td>Related to A DAO is an organization that is run by rules encoded as computer programs called smart contracts.</td><td align="center">MakerDAO</td></tr><tr><td align="center">35</td><td align="center">Yield</td><td>Related to a yield service allows users to earn interest on their cryptocurrency deposits.</td><td align="center">Aave</td></tr><tr><td align="center">36</td><td align="center">Yield Aggregator User</td><td>An address that interacted with a smart contract used for yield farming strategies where users can deposit cryptocurrencies to earn rewards and/or fees on a decentralized platform.</td><td align="center">Aave User</td></tr><tr><td align="center">37</td><td align="center">Wallet</td><td>A wallet is a software or hardware device used to store cryptocurrency private keys and sign transactions.</td><td align="center">MetaMask</td></tr><tr><td align="center">38</td><td align="center">Fund</td><td>A fund is an entity that pools capital from multiple investors and uses it to invest in a variety of assets, including cryptocurrencies.</td><td align="center">Grayscale Bitcoin Trust</td></tr><tr><td align="center">39</td><td align="center">Derivatives</td><td>A derivatives entity is an organization that specializes in trading cryptocurrency derivatives, such as futures, options, and swaps.</td><td align="center">Deribit</td></tr><tr><td align="center">40</td><td align="center">E-Commerce</td><td>An e-commerce entity is an organization that uses cryptocurrency as a payment method for goods and services.</td><td align="center">Overstock.com</td></tr><tr><td align="center">41</td><td align="center">Identity</td><td>An identity entity is an organization that provides on-chain identity-related products, such as decentralized identifiers (DIDs) and verifiable credentials.</td><td align="center">uPort</td></tr><tr><td align="center">42</td><td align="center">Mining Pool</td><td>An organization that brings together multiple miners to collectively mine cryptocurrency.</td><td align="center"><p>F2Pool, </p><p>Slush Pool, BTC.com</p></td></tr><tr><td align="center">43</td><td align="center">Liquid Staking</td><td>Companies that allow users to stake their PoS tokens and receive liquid staking derivatives in exchange.</td><td align="center"><p>Staked, </p><p>Lido, </p><p>Ankr, </p><p>StakeWise</p></td></tr><tr><td align="center">44</td><td align="center">Payments</td><td>Associated with companies providing on-chain payment processing services, allowing users to send and receive cryptocurrency payments on the blockchain.</td><td align="center"><p>BitPay, </p><p>Coinbase Commerce</p></td></tr><tr><td align="center">45</td><td align="center">Sidechain</td><td>Associated with sidechain solutions built on top of the Ethereum blockchain, allowing developers to deploy decentralized applications with increased throughput and scalability.</td><td align="center"><p>Polygon, </p><p>xDai</p></td></tr><tr><td align="center">46</td><td align="center">Router</td><td>Associated with router services that allow users to swap tokens across multiple liquidity pools.</td><td align="center"><p>1inch, </p><p>Uniswap</p></td></tr><tr><td align="center">47</td><td align="center">Coin Swapper</td><td>Associated with services that allow users to swap one cryptocurrency for another without requiring users to deposit funds into the service wallet first.</td><td align="center">ShapeShift, Changelly</td></tr><tr><td align="center">48</td><td align="center">Sport</td><td>Associated with sport-related products or services, including fantasy sports, sports betting, and collectibles.</td><td align="center">NBA Top Shot, Sorare</td></tr><tr><td align="center">49</td><td align="center">Privacy (not Mixer)</td><td>Associated with products or services that provide privacy solutions on the blockchain.</td><td align="center">Tornado Cash, Incognito</td></tr><tr><td align="center">50</td><td align="center">Validator</td><td>Associated with validators that help secure Proof-of-Stake (PoS) blockchain networks.</td><td align="center"><p>Staked, </p><p>Figment Networks</p></td></tr><tr><td align="center">51</td><td align="center">Charity</td><td>Controlled by an organization that accepts crypto donations for charitable causes</td><td align="center">The Giving Block</td></tr><tr><td align="center">52</td><td align="center">Donation</td><td>Controlled by an organization that accepts crypto donations for any purpose</td><td align="center">Red Cross</td></tr><tr><td align="center">53</td><td align="center">Deployer</td><td>Addresses that has been used to deploy smart contracts</td><td align="center">OpenZeppelin Smart Contract SDK</td></tr><tr><td align="center">54</td><td align="center">Company Funds</td><td>Addresses managed by companies, projects or foundations, which are usually used for treasury management, paying salaries or other expenses</td><td align="center">ConsenSys</td></tr><tr><td align="center">55</td><td align="center">Eth 2 staker</td><td>Addresses that have staked Ether at the Ethereum 2.0 Beacon Chain to help secure the network and earn rewards</td><td align="center">Prysmatic Labs</td></tr><tr><td align="center">56</td><td align="center">Yield Farming</td><td>Addresses used for yield farming strategies where users can deposit cryptocurrencies to earn rewards and/or fees on a decentralized platform</td><td align="center">SushiSwap</td></tr><tr><td align="center">57</td><td align="center">ICO</td><td>Addresses used to receive funds during an initial coin offering (ICO) or other crowdfunding mechanisms</td><td align="center">EOS</td></tr><tr><td align="center">58</td><td align="center">Stablecoin</td><td>Addresses used for stablecoin projects, including centralized and decentralized stablecoins</td><td align="center">Tether</td></tr><tr><td align="center">59</td><td align="center">Staking</td><td>Addresses used for staking, where users can lock up their cryptocurrency to help secure a network and earn rewards</td><td align="center">Tezos</td></tr><tr><td align="center">60</td><td align="center">Token Sale</td><td>Addresses used during a token sale where users can buy tokens at an initial price, including initial coin offerings (ICO) and initial dex offerings (IDO)</td><td align="center">Uniswap</td></tr><tr><td align="center">61</td><td align="center">Defi</td><td>Addresses used for decentralized finance (DeFi) projects, including decentralized exchanges, yield farming, lending, and more.</td><td align="center">Aave</td></tr><tr><td align="center">62</td><td align="center">Defi User</td><td>An address that interacted with a smart contract used for decentralized finance (DeFi) projects, including decentralized exchanges, yield farming, lending, and more.</td><td align="center">Aave User</td></tr><tr><td align="center">63</td><td align="center">Advertising</td><td>Addresses used for advertising-related activities in the crypto environment.</td><td align="center">Google Ads, Facebook Ads</td></tr><tr><td align="center">64</td><td align="center">Energy</td><td>Addresses used by entities that are bringing energy-related products into the blockchain.</td><td align="center">WePower</td></tr><tr><td align="center">65</td><td align="center">FIAT</td><td>Addresses controlled by businesses that allow customers to trade fiat currencies.</td><td align="center">Coinbase, Binance</td></tr><tr><td align="center">66</td><td align="center">KYC</td><td>Used for exchanges or other service that require customers to provide a valid ID document to trade fiat-to-crypto or crypto-to-crypto.</td><td align="center">Coinbase, Gemini</td></tr><tr><td align="center">67</td><td align="center">NO KYC</td><td>Used for exchanges or other service that do not require customers to provide a valid ID document to trade fiat-to-crypto or crypto-to-crypto.</td><td align="center">LocalBitcoins, Bisq</td></tr><tr><td align="center">68</td><td align="center">Darknet</td><td>Addresses belonging to services hosted on the dark web, or being involved in dark web transactions.</td><td align="center">Silk Road, AlphaBay</td></tr><tr><td align="center">69</td><td align="center">Money Laundering</td><td>Addresses certified belonging to money laundering activities.</td><td align="center">Liberty Reserve</td></tr><tr><td align="center">70</td><td align="center">Malware</td><td>Addresses belonging to malware campaigns.</td><td align="center">WannaCry ransomware, Emotet malware</td></tr><tr><td align="center">71</td><td align="center">Ransom</td><td>Addresses that have been identified as being involved in ransomware attacks.</td><td align="center">WannaCry ransomware campaign</td></tr><tr><td align="center">72</td><td align="center">Scam</td><td>Addresses that have been identified as being involved in fraudulent activities or scams.</td><td align="center">PlusToken scam</td></tr><tr><td align="center">73</td><td align="center">Terrorism</td><td>Addresses that have been identified as being involved in financing terrorism.</td><td align="center">ISIS</td></tr><tr><td align="center">74</td><td align="center">Theft</td><td>Addresses that have been identified as being involved in theft or hacking of cryptocurrencies.</td><td align="center">Cryptopia hack</td></tr><tr><td align="center">75</td><td align="center">Sanctioned</td><td>Addresses that have been sanctioned by some government in the world (excluding the US).</td><td align="center">Al-Qassam Brigades</td></tr><tr><td align="center">76</td><td align="center">Phishing</td><td>Addresses related to phishing scams.</td><td align="center">N/A</td></tr><tr><td align="center">77</td><td align="center">Ponzi</td><td>Addresses related to Ponzi schemes.</td><td align="center">N/A</td></tr><tr><td align="center">78</td><td align="center">Spam</td><td>Addresses related to spamming.</td><td align="center">N/A</td></tr><tr><td align="center">79</td><td align="center">Fake KYC</td><td>Addresses related to fake KYC procedures.</td><td align="center">BitMax.io</td></tr><tr><td align="center">80</td><td align="center">Malicious Mining Activities</td><td>Addresses used for mining cryptocurrencies with malware or botnets.</td><td align="center">N/A</td></tr><tr><td align="center">81</td><td align="center">Financial Crime, Other</td><td>Addresses related to financial crimes such as money laundering, fraud, and tax evasion.</td><td align="center">N/A</td></tr><tr><td align="center">82</td><td align="center">Cybercrime</td><td>Addresses related to cybercrimes such as hacking, data theft, and ransomware.</td><td align="center">N/A</td></tr><tr><td align="center">83</td><td align="center">Honeypot</td><td>Addresses related to fake tokens or ICOs that are designed to scam investors or traders.</td><td align="center"></td></tr><tr><td align="center">84</td><td align="center">Black Mail Activities</td><td>Addresses that threaten to reveal sensitive information or personal data in exchange for ransom payments.</td><td align="center"></td></tr><tr><td align="center">85</td><td align="center">Constrained by Service</td><td>Addresses that have been restricted or blocked from using centralized or decentralized exchanges due to suspicious activities or high risk status.</td><td align="center"></td></tr><tr><td align="center">86</td><td align="center">High Risk, Other</td><td>Addresses that are associated with suspicious, fraudulent, or illigal activities that are not covered by other categories.</td><td align="center"></td></tr><tr><td align="center">87</td><td align="center">Dapp, Other</td><td>Addresses used by decentralized applications (dApps) to interact with smart contracts and blockchain networks.</td><td align="center"></td></tr><tr><td align="center">88</td><td align="center">Bridging</td><td>Addresses used by platforms or projects that provide interoperability solutions to connect different blockchain networks.</td><td align="center">ChainBridge</td></tr><tr><td align="center">89</td><td align="center">Bridge User</td><td>An address that interacted with a smart contract used by platforms or projects that provide interoperability solutions to connect different blockchain networks.</td><td align="center">ChainBridge User</td></tr><tr><td align="center">90</td><td align="center">Multichain</td><td>Addresses used by platforms or projects that enable communication and transfer of assets between multiple blockchain networks.</td><td align="center">Cosmos</td></tr><tr><td align="center">91</td><td align="center">Factory Contract</td><td>Smart contracts used to create and deploy multiple instances of other smart contracts.</td><td align="center">OpenZeppelin</td></tr><tr><td align="center">92</td><td align="center">Fraud Proof</td><td>Smart contracts used to prove fraudulent activities or invalid state transitions on layer 2 protocols.</td><td align="center">OptimismFraudProof</td></tr><tr><td align="center">93</td><td align="center">Genesis</td><td>Genesis addresses used to mint/burn.</td><td align="center"></td></tr><tr><td align="center">94</td><td align="center">MEV Bot</td><td>Addresses used by MEV bots for transaction extraction and prioritization.</td><td align="center">Archer DAO</td></tr><tr><td align="center">95</td><td align="center">Proxy</td><td>Contract that acts as a proxy to another contract and is used to upgrade the logic of the target contract without changing its address.</td><td align="center">OpenZeppelin Proxy</td></tr></tbody></table>


# Source

{% hint style="info" %}
Please note that while the information presented on this page is intended for **human consumption** and is accurate to the best of our knowledge, the official **source of truth** for our project is the corresponding codified files hosted on GitHub. We strive to maintain up-to-date and accurate information on this page, but please refer to the GitHub repository for the most current and reliable information.
{% endhint %}

> Github: <https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/config/sources.json>

## Description

The ‘Source’ field provides information about where are the address labels (i.e. the address name and address entity name) from. The list of values available for this fields are provided in the table below:

<table><thead><tr><th width="149.33333333333331" align="center">Value</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td align="center">Ground Truth</td><td><p>Generated from: </p><p>1) direct interactions (transactions) with the labelled entity, or </p><p>2) official sources like OFAC or On-chain protocol page (e.g. Uniswap documentations)</p></td><td>Initiated deposit and withdrawals transactions against Binance to identify Binance addresses on chain.</td></tr><tr><td align="center">External</td><td>Generated from external parties that are available to general public - e.g like Twitter, Discord, Etherscan, etc</td><td>Binance PoR addresses from Binance’s official website</td></tr><tr><td align="center">Heuristics</td><td>Generated from rule based approaches that are used to clusterize addresses on chain based on their transaction patterns - e.g. common-spend, core addresses, change, etc</td><td>Common-spend clusterizers running on Airflow for UTXO based chain - e.g. Bitcoin, Dogecoin</td></tr><tr><td align="center">Machine Learning</td><td>Generated from machine learning based models</td><td>Based on ground-truth labels, we using GCN, XGB models to train and predict label for new addresses.</td></tr></tbody></table>

<br>


# Submitted By and Submitted On

These two fields provides information about the timestamps of the metadata entries was last updated and the user identifier (e.g. user-id, DID, crypto addresses) of whom submitted the data.


# Community

## **What is the process of altering the common taxonomy?**

To enable effective data sharing and collaboration in the rapidly evolving web3 industry, it's crucial to update the taxonomy regularly and stay current with the latest concepts and technologies.

We will summarize those steps to maintaining the common taxonomy by involving community as below:

1. **Proposal for changes**: A proposal is made to add or delete a term from the taxonomy. This may involve a discussion and review process to ensure that the proposed change is necessary and appropriate.
2. **Call for community discussion or voting**: Once a proposal has been made, it may be necessary to solicit feedback from the community or hold a vote to determine whether the proposed change should be implemented. This will depend on the governance structure and decision-making processes in place for the taxonomy.
3. **Updating the taxonomy**: If the proposed change is approved, the taxonomy is updated to reflect the addition or deletion of the term. This may involve revising the structure of the taxonomy or updating associated documentation and resources.
4. **Testing the workflow of updating taxonomy**: After the taxonomy has been updated, it is important to test the workflow of updating existing data to ensure that the change has been implemented correctly and does not introduce any errors or inconsistencies.
5. **Communication**: Finally, the change should be communicated to the relevant stakeholders, including users of the taxonomy and any downstream systems or users that may be impacted by the change.

TODO: we will discuss the different treatment when dealing with adding a term or deleting an existing terms, particularly the ramification of those potential changes on existing data.

## **How to address label conflict?**

To address the issue of a single crypto address having different labels from multiple contributors, we could consider implementing a consensus-based approach or a weighted voting system, which would help resolve conflicts without relying on experts for every address. Here are two possible solutions:

1. **Consensus-based approach**:&#x20;

   In this method, you can require a certain threshold of agreement among contributors before accepting a label for an address. When multiple contributors provide labels for the same address, the system would compare the labels and select the one that reaches the consensus threshold. This threshold can be set based on the desired level of confidence and the size of the contributor community. By setting a reasonable consensus threshold, you can minimize the need for expert intervention while maintaining data quality.
2. **Weighted voting system**:&#x20;

   In a weighted voting system, you can assign different weights to the votes of contributors based on their expertise, reputation, or past performance. This allows the opinions of more experienced or reliable contributors to have a greater impact on the final label. You can also implement a mechanism to update contributors' weights over time, based on the accuracy of their annotations or feedback from other contributors. By using a weighted voting system, you can efficiently resolve label conflicts while minimizing the need for expert verification.

TODO: we should determine which approach we should go


# Team

## Governance Team

[Leo Liang](https://www.linkedin.com/in/leoliang/)

[Ming Jiang](https://www.linkedin.com/in/ming2jiang1/)

[Yi Zhang](https://www.linkedin.com/in/beingzy/)

[Vincent Wen](https://www.linkedin.com/in/siwen/)

[Eskil Tsu](https://www.linkedin.com/in/yufeng-xu-9856a716/)

## Contributors

[Boyang Xu](https://www.linkedin.com/in/boyang-xu-19713090/)

Chris Steege

[David Lai](https://www.linkedin.com/in/david-lai/)

[Eskil Tsu](https://www.linkedin.com/in/yufeng-xu-9856a716/)

Jiacheng Xu

Johnny Yang

[Ken Yip](https://www.linkedin.com/in/ken-yip/)

[Leo Liang](https://www.linkedin.com/in/leoliang/)

[Micheal Kremer](https://www.linkedin.com/in/kremer-michael/)

[Ming Jiang](https://www.linkedin.com/in/ming2jiang1/)

[Ruiying Jiang](< https://www.linkedin.com/in/ryjiangx >)

[Sid Shekhar](https://www.linkedin.com/in/sidshekhar/)&#x20;

[Tammy Yang](https://www.linkedin.com/in/tammy-yang-369b1957/)

[Turan Vural](https://www.linkedin.com/in/turanzv/)

[Vincent Wen](https://www.linkedin.com/in/siwen/)

[Wei Cui](https://www.linkedin.com/in/wei-cui16/)

[Yi Dong](https://www.linkedin.com/in/yi-dong-sky/)

[Yi Zhang](https://www.linkedin.com/in/beingzy/)

[Zhanwu Xiong](https://www.linkedin.com/in/zhanwu/)


