/open-rarity

Reference implementation of the OpenRarity protocol with Python.

Primary LanguagePythonApache License 2.0Apache-2.0

OpenRarity

Version Test CI License

OpenRarity

We’re excited to announce OpenRarity(Beta), a new rarity protocol we’re building for the NFT community. Our objective is to provide a transparent rarity calculation that is entirely open-source, objective, and reproducible.

With the explosion of new collections, marketplaces and tooling in the NFT ecosystem, we realized that rarity ranks often differed across platforms which could lead to confusion for buyers, sellers and creators. We believe it’s important to find a way to provide a unified and consistent set of rarity rankings across all platforms to help build more trust and transparency in the industry.

We are releasing the OpenRarity library in a Beta preview to crowdsource feedback from the community and incorporate it into the library evolution.

See the full announcement in the blog post.

Developer documentation

Read developer documentation on how to integrate with OpenRarity.

Setup and run tests locally

poetry install # install dependencies locally
poetry run pytest # run tests

Some tests are skipped by default due to it being more integration/slow tests. To run resolver tests:

poetry run pytest -k test_testset_resolver --run-resolvers

Library usage

You can install open rarity as a python package to use OpenRarity in your project:

pip install open-rarity

Please refer to the scripts/ folder for an example of how to use the library.

If you have downloaded the repo, you can use OpenRarity shell tool to generate json or csv outputs of OpenRarity scoring and ranks for any collections:

python -m scripts.score_real_collections boredapeyachtclub proof-moonbirds

Read developer documentation for advanced library usage

Contributions guide and governance

OpenRarity is a community effort to improve rarity computation for NFTs (Non-Fungible Tokens). The core collaboration group consists of four primary contributors: Curio, icy.tools, OpenSea and Proof

OpenRarity is an open-source project and all contributions are welcome. Consider following steps when you request/propose contribution:

  • Have a question? Submit it on OpenRarity GitHub discussions page
  • Create GitHub issue/bug with description of the problem link
  • Submit Pull Request with proposed changes
  • To merge the change in the main branch you required to get at least 2 approvals from the project maintainer list
  • Always add a unit test with your changes

We use git-precommit hooks in OpenRarity repo. Install it with the following command

poetry run pre-commit install

Project Setup and Core technologies

We used the following core technologies in OpenRarity:

  • Python ≥ 3.10.x
  • Poetry for dependency management
  • Numpy ≥1.23.1
  • PyTest for unit tests

License

Apache 2.0 , OpenSea, ICY, Curio, PROOF