release v1.9.x, v25.01.x

.gitignore

@@ -75,4 +75,4 @@ target/
 #credentials
 examples/config.json
 
-.env
+.env

.openapi-generator-ignore

@@ -27,3 +27,4 @@ docs/BulkApi.md
 .gitlab-ci.yml
 test/*
 git_push.sh
+.gitignore

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Please see the [changelog of GraphSense OpenAPI](https://github.com/graphsense/graphsense-openapi/blob/master/CHANGELOG.md) for changes related to the API.
 
+## [25.01.1/1.9.1] - 2025-01-20
+
+### Changed
+- Update to REST version 24.01.0
+### Added
+- added tag_type field in tag endpoints, make entity id in tags optional
+
 ## [24.11.1/1.8.1] - 2024-11-27
 
 ### Added

Makefile

@@ -1,3 +1,5 @@
+-include .env
+
 generate-openapi-client:
 	docker run --rm \
 		-v "${PWD}:/build:Z" \
@@ -10,5 +12,7 @@ generate-openapi-client:
 		--additional-properties=packageName=graphsense \
 		--additional-properties=projectName=graphsense-python
 
+run-examples:
+	API_KEY=$(API_KEY) python test_examples.py
 
-.PHONY: generate-openapi-client
+.PHONY: generate-openapi-client run-examples

README.md

@@ -3,8 +3,8 @@ GraphSense API provides programmatic access to various ledgers' addresses, entit
 
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 1.8.0
-- Package version: 1.8.1
+- API version: 1.9.4
+- Package version: 1.9.4
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 
 ## Requirements.

docs/AddressTag.md

@@ -9,9 +9,9 @@ Name | Type | Description | Notes
 **tagpack_is_public** | **bool** | whether the address is public | 
 **tagpack_creator** | **str** | Tagpack creator | 
 **is_cluster_definer** | **bool** | whether the address tag applies to the entity level | 
+**tag_type** | **str** | kind of tag e.g. Mention; representing a mention of an address, or Actor; representing an actor saying something about the actor behind the address. | 
 **currency** | **str** | crypto currency code | 
 **address** | **str** | Address | 
-**entity** | **int** | Entity id | 
 **category** | **str** | Category | [optional] 
 **concepts** | **[str]** | A list additional concepts/categories | [optional] 
 **actor** | **str** | id of the actor that controlls the address | [optional] 
@@ -22,6 +22,7 @@ Name | Type | Description | Notes
 **confidence** | **str** | Confidence name | [optional] 
 **confidence_level** | **int** | Confidence level | [optional] 
 **inherited_from** | **str** | if the tag was inherited from cluster | [optional]  if omitted the server will use the default value of "cluster"
+**entity** | **int** | Entity id | [optional] 
 **any string name** | **bool, date, datetime, dict, float, int, list, str, none_type** | any string name can be used but the value must be the correct type | [optional]
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

docs/AddressTagAllOf.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **address** | **str** | Address | 
-**entity** | **int** | Entity id | 
+**entity** | **int** | Entity id | [optional] 
 **any string name** | **bool, date, datetime, dict, float, int, list, str, none_type** | any string name can be used but the value must be the correct type | [optional]
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

docs/AddressesApi.md

@@ -23,6 +23,7 @@ Get an address
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import addresses_api
 from graphsense.model.address import Address
@@ -118,6 +119,7 @@ Get the entity of an address
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import addresses_api
 from graphsense.model.entity import Entity
@@ -213,6 +215,7 @@ Get attribution tag summary for a given address
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import addresses_api
 from graphsense.model.tag_summary import TagSummary
@@ -308,6 +311,7 @@ Get outgoing transactions between two addresses
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import addresses_api
 from graphsense.model.height import Height
@@ -414,6 +418,7 @@ Get an address's neighbors in the address graph
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import addresses_api
 from graphsense.model.neighbor_addresses import NeighborAddresses
@@ -521,6 +526,7 @@ Get all transactions an address has been involved in
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import addresses_api
 from graphsense.model.height import Height
@@ -629,6 +635,7 @@ Get attribution tags for a given address
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import addresses_api
 from graphsense.model.address_tags import AddressTags

docs/BlocksApi.md

@@ -19,6 +19,7 @@ Get a block by its height
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import blocks_api
 from graphsense.model.block import Block
@@ -104,6 +105,7 @@ Get the closest blocks given a timestamp
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import blocks_api
 from graphsense.model.block_at_date import BlockAtDate
@@ -188,6 +190,7 @@ Get block transactions
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import blocks_api
 from graphsense.model.tx import Tx

docs/EntitiesApi.md

@@ -23,6 +23,7 @@ Get an entity
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import entities_api
 from graphsense.model.entity import Entity
@@ -120,6 +121,7 @@ Get address tags for a given entity
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import entities_api
 from graphsense.model.address_tags import AddressTags
@@ -217,6 +219,7 @@ Get an entity's addresses
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import entities_api
 from graphsense.model.entity_addresses import EntityAddresses
@@ -314,6 +317,7 @@ Get transactions between two entities
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import entities_api
 from graphsense.model.height import Height
@@ -420,6 +424,7 @@ Get an entity's direct neighbors
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import entities_api
 from graphsense.model.neighbor_entities import NeighborEntities
@@ -529,6 +534,7 @@ Get all transactions an entity has been involved in
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import entities_api
 from graphsense.model.height import Height
@@ -637,6 +643,7 @@ Search deeply for matching neighbors
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import entities_api
 from graphsense.model.search_result_level1 import SearchResultLevel1

docs/GeneralApi.md

@@ -17,6 +17,7 @@ Get statistics of supported currencies
 
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import general_api
 from graphsense.model.stats import Stats
@@ -85,6 +86,7 @@ Returns matching addresses, transactions and labels
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import general_api
 from graphsense.model.search_result import SearchResult

docs/RatesApi.md

@@ -17,6 +17,7 @@ Returns exchange rate for a given height
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import rates_api
 from graphsense.model.rates import Rates

docs/Tag.md

@@ -9,6 +9,7 @@ Name | Type | Description | Notes
 **tagpack_is_public** | **bool** | whether the address is public | 
 **tagpack_creator** | **str** | Tagpack creator | 
 **is_cluster_definer** | **bool** | whether the address tag applies to the entity level | 
+**tag_type** | **str** | kind of tag e.g. Mention; representing a mention of an address, or Actor; representing an actor saying something about the actor behind the address. | 
 **currency** | **str** | crypto currency code | 
 **category** | **str** | Category | [optional] 
 **concepts** | **[str]** | A list additional concepts/categories | [optional] 

docs/TagsApi.md

@@ -21,6 +21,7 @@ Returns an actor given its unique id or (unique) label
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import tags_api
 from graphsense.model.actor import Actor
@@ -103,6 +104,7 @@ Returns the address tags for a given actor
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import tags_api
 from graphsense.model.address_tags import AddressTags
@@ -198,6 +200,7 @@ Returns address tags associated with a given label
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import tags_api
 from graphsense.model.address_tags import AddressTags
@@ -293,6 +296,7 @@ Returns the supported concepts of a taxonomy
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import tags_api
 from graphsense.model.concept import Concept
@@ -318,7 +322,7 @@ configuration.api_key['api_key'] = 'YOUR_API_KEY'
 with graphsense.ApiClient(configuration) as api_client:
     # Create an instance of the API class
     api_instance = tags_api.TagsApi(api_client)
-    taxonomy = "foo" # str | The taxonomy
+    taxonomy = "concept" # str | The taxonomy
 
     # example passing only required values which don't have defaults set
     try:
@@ -375,6 +379,7 @@ Returns the supported taxonomies
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import tags_api
 from graphsense.model.taxonomy import Taxonomy

docs/TokensApi.md

@@ -17,6 +17,7 @@ Returns a list of supported token (sub)currencies
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import tokens_api
 from graphsense.model.token_configs import TokenConfigs

docs/TxsApi.md

@@ -21,6 +21,7 @@ Returns in which other transaction's outputs the asked transaction spent. Think
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import txs_api
 from graphsense.model.tx_ref import TxRef
@@ -116,6 +117,7 @@ Returns in which other transactions, outputs from the asked transaction are spen
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import txs_api
 from graphsense.model.tx_ref import TxRef
@@ -211,6 +213,7 @@ Returns details of a specific transaction identified by its hash
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import txs_api
 from graphsense.model.tx import Tx
@@ -312,6 +315,7 @@ Returns input/output values of a specific transaction identified by its hash
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import txs_api
 from graphsense.model.tx_values import TxValues
@@ -411,6 +415,7 @@ Returns all token transactions in a given transaction
 * Api Key Authentication (api_key):
 ```python
 import time
+from dateutil.parser import parse as dateutil_parser
 import graphsense
 from graphsense.api import txs_api
 from graphsense.model.txs_account import TxsAccount