v0.3.0: New assets endpoints

CHANGELOG.md

@@ -1,4 +1,19 @@
 # Change Log
+
+## v0.3.0-beta - May 7, 2025
+* Added new endpoints methods : 
+    * get_assets_issuances(): Returns a list of issued assets.
+    * get_assets_issuances_by_index() : Returns an asset issuance by universe index
+    * get_ownerships_assets(): Returns a list of asset owners. Asset name and issuer are required. Issuer defaults to zero address.
+    * get_ownerships_assets_by_index(): Returns an asset ownership by universe index.
+    * get_assets_possessions(): Returns a list of asset possessors. Asset name and issuer are required. Issuer defaults to zero address.
+    * get_assets_possessions_by_index(): Returns an asset possession by universe index.
+    * get_assets_owners_per_asset(): Returns the asset owners per asset
+* Added a function to check the input index and validate before making the query.
+* Added more information to the response returned by the get_rich_list method, such as epoch, tick and more.
+* Added new exceptions to handle new errors.
+* Fixed get_rich_list method test.
+
 ## v0.2.6-beta - December 26, 2024
 * Added a check function to verify and validate the wallet ID before making a call to the Qubic network
 * Optimized network calls by preventing invalid requests

README.md

@@ -3,7 +3,7 @@ Currently, QubiPy is in a very early development phase, so please take this into
 
 Please visit the [Change log](https://github.com/QubiPy-Labs/QubiPy/blob/main/docs/changelog.md) to see all changes.
 
-![release](https://img.shields.io/badge/release-v0.2.6--beta-blue)
+![release](https://img.shields.io/badge/release-v0.3.0--beta-blue)
 ![python](https://img.shields.io/badge/python-3.10_%7C_3.11_%7C_3.12-blue)
 ![Python Package](https://github.com/QubiPy-Labs/QubiPy/actions/workflows/python-package.yml/badge.svg)
 ![Code Quality](https://github.com/QubiPy-Labs/QubiPy/actions/workflows/pylint.yml/badge.svg)

docs/changelog.md

@@ -1,4 +1,19 @@
 # Change Log
+
+## v0.3.0-beta - May 7, 2025
+* Added new endpoints methods : 
+    * get_assets_issuances(): Returns a list of issued assets.
+    * get_assets_issuances_by_index() : Returns an asset issuance by universe index
+    * get_ownerships_assets(): Returns a list of asset owners. Asset name and issuer are required. Issuer defaults to zero address.
+    * get_ownerships_assets_by_index(): Returns an asset ownership by universe index.
+    * get_assets_possessions(): Returns a list of asset possessors. Asset name and issuer are required. Issuer defaults to zero address.
+    * get_assets_possessions_by_index(): Returns an asset possession by universe index.
+    * get_assets_owners_per_asset(): Returns the asset owners per asset
+* Added a function to check the input index and validate before making the query.
+* Added more information to the response returned by the get_rich_list method, such as epoch, tick and more.
+* Added new exceptions to handle new errors.
+* Fixed get_rich_list method test.
+
 ## v0.2.6-beta - December 26, 2024
 * Added a check function to verify and validate the wallet ID before making a call to the Qubic network
 * Optimized network calls by preventing invalid requests

docs/index.md

@@ -1,11 +1,11 @@
 # Welcome to the **QubiPy** official documentation, a Python Library for the QUBIC RPC API
 
-!!! note "Beta Version: 0.2.6"
+!!! note "Beta Version: 0.3.0"
     QubiPy is currently in beta. While functional, some features might change before the stable release.
 
 **QubiPy** is a Python library that provides RPC and Core client functionality. You can interact quickly and easily with the Qubic RPC API using the different methods offered by this library.
 
-![release](https://img.shields.io/badge/release-v0.2.6--beta-blue)
+![release](https://img.shields.io/badge/release-v0.3.0--beta-blue)
 ![python](https://img.shields.io/badge/python-3.10_%7C_3.11_%7C_3.12-blue)
 ![Python Package](https://github.com/QubiPy-Labs/QubiPy/actions/workflows/python-package.yml/badge.svg)
 ![Code Quality](https://github.com/QubiPy-Labs/QubiPy/actions/workflows/pylint.yml/badge.svg)

qubipy/endpoints_rpc.py

@@ -46,4 +46,20 @@
 
 LATEST_STATS = '/latest-stats'
 
-RICH_LIST = '/rich-list'
+RICH_LIST = '/rich-list'
+
+# Testing
+
+ASSETS_ISSUANCE = '/assets/issuances'
+
+ASSETS_ISSUANCE_INDEX = '/assets/issuances/{index}'
+
+ASSETS_OWNERSHIPS = '/assets/ownerships'
+
+ASSETS_OWNERSHIPS_INDEX = '/assets/ownerships/{index}'
+
+ASSETS_POSSESSIONS = '/assets/possessions'
+
+ASSETS_POSSESSIONS_INDEX = '/assets/possessions/{index}'
+
+ASSETS_OWNERS = '/issuers/{issuer_identity}/assets/{asset_name}/owners'

qubipy/exceptions.py

@@ -40,3 +40,9 @@ class QubiPy_Exceptions(Exception):
 
     INVALID_TX_BYTES = "A bytes-like object is required for broadcasting a transaction"
 
+    INVALID_INDEX = "You must enter a valid index."
+
+    INVALID_ASSET_NAME = "You must at least indicate the name of the asset, for example 'MLM'."
+
+    INVALID_IDENTITY_ASSET = "You must enter a valid ID and a valid asset name."
+