feat: add new endpoints for Blockfrost API v0.1.86

Add pool_votes, governance proposal endpoints by gov_action_id
(CIP-0129), and update API version reference in setup.py.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: slowbackspace

blockfrost/api/__init__.py

@@ -121,7 +121,8 @@ def root(self, **kwargs):
         pool_relays, \
         pool_delegators, \
         pool_blocks, \
-        pool_updates
+        pool_updates, \
+        pool_votes
     from .cardano.transactions import \
         transaction, \
         transaction_utxos, \
@@ -161,6 +162,11 @@ def root(self, **kwargs):
         governance_proposal_parameters, \
         governance_proposal_withdrawals, \
         governance_proposal_votes, \
-        governance_proposal_metadata
+        governance_proposal_metadata, \
+        governance_proposal_by_gov_action_id, \
+        governance_proposal_parameters_by_gov_action_id, \
+        governance_proposal_withdrawals_by_gov_action_id, \
+        governance_proposal_votes_by_gov_action_id, \
+        governance_proposal_metadata_by_gov_action_id
     from .cardano.utils import \
         utils_addresses_xpub

blockfrost/api/cardano/governance.py

@@ -333,3 +333,131 @@ def governance_proposal_metadata(self, tx_hash: str, cert_index: int, **kwargs):
         url=f"{self.url}/governance/proposals/{tx_hash}/{cert_index}/metadata",
         headers=self.default_headers
     )
+
+
+@request_wrapper
+def governance_proposal_by_gov_action_id(self, gov_action_id: str, **kwargs):
+    """
+    Return information about a specific governance proposal by GovActionID.
+
+    https://docs.blockfrost.io/#tag/cardano--governance/GET/governance/proposals/{gov_action_id}
+
+    :param gov_action_id: Governance Action Identifier (CIP-0129).
+    :type gov_action_id: str
+    :param return_type: Optional. "object", "json" or "pandas". Default: "object".
+    :type return_type: str
+    :returns object.
+    :rtype: Namespace
+    :raises ApiError: If API fails
+    :raises Exception: If the API response is somehow malformed.
+    """
+    return requests.get(
+        url=f"{self.url}/governance/proposals/{gov_action_id}",
+        headers=self.default_headers
+    )
+
+
+@request_wrapper
+def governance_proposal_parameters_by_gov_action_id(self, gov_action_id: str, **kwargs):
+    """
+    Return the parameters of a specific governance proposal by GovActionID.
+
+    https://docs.blockfrost.io/#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/parameters
+
+    :param gov_action_id: Governance Action Identifier (CIP-0129).
+    :type gov_action_id: str
+    :param return_type: Optional. "object", "json" or "pandas". Default: "object".
+    :type return_type: str
+    :returns object.
+    :rtype: Namespace
+    :raises ApiError: If API fails
+    :raises Exception: If the API response is somehow malformed.
+    """
+    return requests.get(
+        url=f"{self.url}/governance/proposals/{gov_action_id}/parameters",
+        headers=self.default_headers
+    )
+
+
+@list_request_wrapper
+def governance_proposal_withdrawals_by_gov_action_id(self, gov_action_id: str, **kwargs):
+    """
+    Return the withdrawals of a specific governance proposal by GovActionID.
+
+    https://docs.blockfrost.io/#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/withdrawals
+
+    :param gov_action_id: Governance Action Identifier (CIP-0129).
+    :type gov_action_id: str
+    :param return_type: Optional. "object", "json" or "pandas". Default: "object".
+    :type return_type: str
+    :param gather_pages: Optional. Default: false. Will collect all pages into one return
+    :type gather_pages: bool
+    :param count: Optional. Default: 100. The number of results displayed on one page.
+    :type count: int
+    :param page: Optional. The page number for listing the results.
+    :type page: int
+    :param order: Optional. "asc" or "desc". Default: "asc".
+    :type order: str
+    :returns A list of objects.
+    :rtype [Namespace]
+    :raises ApiError: If API fails
+    :raises Exception: If the API response is somehow malformed.
+    """
+    return requests.get(
+        url=f"{self.url}/governance/proposals/{gov_action_id}/withdrawals",
+        params=self.query_parameters(kwargs),
+        headers=self.default_headers
+    )
+
+
+@list_request_wrapper
+def governance_proposal_votes_by_gov_action_id(self, gov_action_id: str, **kwargs):
+    """
+    Return the votes of a specific governance proposal by GovActionID.
+
+    https://docs.blockfrost.io/#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/votes
+
+    :param gov_action_id: Governance Action Identifier (CIP-0129).
+    :type gov_action_id: str
+    :param return_type: Optional. "object", "json" or "pandas". Default: "object".
+    :type return_type: str
+    :param gather_pages: Optional. Default: false. Will collect all pages into one return
+    :type gather_pages: bool
+    :param count: Optional. Default: 100. The number of results displayed on one page.
+    :type count: int
+    :param page: Optional. The page number for listing the results.
+    :type page: int
+    :param order: Optional. "asc" or "desc". Default: "asc".
+    :type order: str
+    :returns A list of objects.
+    :rtype [Namespace]
+    :raises ApiError: If API fails
+    :raises Exception: If the API response is somehow malformed.
+    """
+    return requests.get(
+        url=f"{self.url}/governance/proposals/{gov_action_id}/votes",
+        params=self.query_parameters(kwargs),
+        headers=self.default_headers
+    )
+
+
+@request_wrapper
+def governance_proposal_metadata_by_gov_action_id(self, gov_action_id: str, **kwargs):
+    """
+    Return the metadata of a specific governance proposal by GovActionID.
+
+    https://docs.blockfrost.io/#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata
+
+    :param gov_action_id: Governance Action Identifier (CIP-0129).
+    :type gov_action_id: str
+    :param return_type: Optional. "object", "json" or "pandas". Default: "object".
+    :type return_type: str
+    :returns object.
+    :rtype: Namespace
+    :raises ApiError: If API fails
+    :raises Exception: If the API response is somehow malformed.
+    """
+    return requests.get(
+        url=f"{self.url}/governance/proposals/{gov_action_id}/metadata",
+        headers=self.default_headers
+    )

blockfrost/api/cardano/pools.py

@@ -284,3 +284,32 @@ def pool_updates(self, pool_id: str, **kwargs):
         params=self.query_parameters(kwargs),
         headers=self.default_headers
     )
+
+
+@list_request_wrapper
+def pool_votes(self, pool_id: str, **kwargs):
+    """
+    History of stake pool votes.
+
+    https://docs.blockfrost.io/#tag/cardano--pools/GET/pools/{pool_id}/votes
+
+    :param pool_id: Bech32 or hexadecimal pool ID.
+    :type pool_id: str
+    :param gather_pages: Optional. Default: false. Will collect all pages into one return
+    :type gather_pages: bool
+    :param count: Optional. Default: 100. The number of results displayed on one page.
+    :type count: int
+    :param page: Optional. The page number for listing the results.
+    :type page: int
+    :param order: Optional. "asc" or "desc". Default: "asc".
+    :type order: str
+    :returns A list of objects.
+    :rtype [Namespace]
+    :raises ApiError: If API fails
+    :raises Exception: If the API response is somehow malformed.
+    """
+    return requests.get(
+        url=f"{self.url}/pools/{pool_id}/votes",
+        params=self.query_parameters(kwargs),
+        headers=self.default_headers
+    )

setup.py

@@ -9,7 +9,7 @@
 setup(
     name='blockfrost-python',
     version='0.7.0',
-    description='The official Python SDK for Blockfrost API v0.1.85',
+    description='The official Python SDK for Blockfrost API v0.1.86',
     long_description=long_description,
     long_description_content_type='text/markdown',
     url='https://github.com/blockfrost/blockfrost-python',

tests/test_cardano_governance.py

@@ -7,6 +7,7 @@
 cert_index = 0
 # proposal with metadata (treasury_withdrawals type)
 metadata_tx_hash = '60ed6ab43c840ff888a8af30a1ed27b41e9f4a91a89822b2b63d1bfc52aeec45'
+gov_action_id = 'gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn'
 
 
 def test_governance_dreps(requests_mock):
@@ -268,3 +269,109 @@ def test_integration_governance_proposal_metadata():
     if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
         api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
         api.governance_proposal_metadata(tx_hash=metadata_tx_hash, cert_index=cert_index)
+
+
+def test_governance_proposal_by_gov_action_id(requests_mock):
+    api = BlockFrostApi()
+    mock_data = {
+        "tx_hash": tx_hash,
+        "cert_index": cert_index,
+        "governance_type": "treasury_withdrawals",
+        "deposit": "100000000000",
+        "return_address": "stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7",
+        "governance_description": None,
+        "ratified_epoch": None,
+        "enacted_epoch": None,
+        "dropped_epoch": None,
+        "expired_epoch": None,
+        "expiration": 550
+    }
+    requests_mock.get(f"{api.url}/governance/proposals/{gov_action_id}", json=mock_data)
+    assert api.governance_proposal_by_gov_action_id(gov_action_id=gov_action_id) == convert_json_to_object(mock_data)
+
+
+def test_integration_governance_proposal_by_gov_action_id():
+    if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
+        api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
+        api.governance_proposal_by_gov_action_id(gov_action_id=gov_action_id)
+
+
+def test_governance_proposal_parameters_by_gov_action_id(requests_mock):
+    api = BlockFrostApi()
+    mock_data = {
+        "tx_hash": tx_hash,
+        "cert_index": cert_index,
+        "parameters": {
+            "min_fee_a": 44,
+            "min_fee_b": 155381,
+            "key_deposit": "2000000",
+            "pool_deposit": "500000000"
+        }
+    }
+    requests_mock.get(f"{api.url}/governance/proposals/{gov_action_id}/parameters", json=mock_data)
+    assert api.governance_proposal_parameters_by_gov_action_id(gov_action_id=gov_action_id) == convert_json_to_object(mock_data)
+
+
+def test_integration_governance_proposal_parameters_by_gov_action_id():
+    if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
+        api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
+        api.governance_proposal_parameters_by_gov_action_id(gov_action_id=gov_action_id)
+
+
+def test_governance_proposal_withdrawals_by_gov_action_id(requests_mock):
+    api = BlockFrostApi()
+    mock_data = [
+        {
+            "stake_address": "stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7",
+            "amount": "454541212442"
+        }
+    ]
+    requests_mock.get(f"{api.url}/governance/proposals/{gov_action_id}/withdrawals", json=mock_data)
+    assert api.governance_proposal_withdrawals_by_gov_action_id(gov_action_id=gov_action_id) == convert_json_to_object(mock_data)
+
+
+def test_integration_governance_proposal_withdrawals_by_gov_action_id():
+    if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
+        api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
+        api.governance_proposal_withdrawals_by_gov_action_id(gov_action_id=gov_action_id)
+
+
+def test_governance_proposal_votes_by_gov_action_id(requests_mock):
+    api = BlockFrostApi()
+    mock_data = [
+        {
+            "tx_hash": "f5ca33220afcc0340d1fa3cba9b0e1f3c3c6e1eab57d688ed700ae56bbce9170",
+            "cert_index": 0,
+            "voter": "drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn",
+            "voter_role": "drep",
+            "vote": "yes"
+        }
+    ]
+    requests_mock.get(f"{api.url}/governance/proposals/{gov_action_id}/votes", json=mock_data)
+    assert api.governance_proposal_votes_by_gov_action_id(gov_action_id=gov_action_id) == convert_json_to_object(mock_data)
+
+
+def test_integration_governance_proposal_votes_by_gov_action_id():
+    if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
+        api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
+        api.governance_proposal_votes_by_gov_action_id(gov_action_id=gov_action_id)
+
+
+def test_governance_proposal_metadata_by_gov_action_id(requests_mock):
+    api = BlockFrostApi()
+    mock_data = {
+        "tx_hash": tx_hash,
+        "cert_index": cert_index,
+        "url": "https://example.com/proposal-metadata.json",
+        "hash": "a14a5ad4a83b1c8b04c5175f0a16b4a2d8b1e5a08c7b6d1e2f3c4d5e6f7a8b9",
+        "json_metadata": None,
+        "bytes": "\\xa100"
+    }
+    requests_mock.get(f"{api.url}/governance/proposals/{gov_action_id}/metadata", json=mock_data)
+    assert api.governance_proposal_metadata_by_gov_action_id(gov_action_id=gov_action_id) == convert_json_to_object(mock_data)
+
+
+def test_integration_governance_proposal_metadata_by_gov_action_id():
+    if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
+        api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
+        api.governance_proposal_metadata_by_gov_action_id(gov_action_id=gov_action_id)

tests/test_cardano_pools.py

@@ -281,3 +281,24 @@ def test_integration_pool_updates():
     if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
         api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
         assert api.pool_updates(pool_id=pool_id)
+
+
+def test_pool_votes(requests_mock):
+    api = BlockFrostApi()
+    mock_data = [
+        {
+            "tx_hash": "f5ca33220afcc0340d1fa3cba9b0e1f3c3c6e1eab57d688ed700ae56bbce9170",
+            "cert_index": 0,
+            "vote": "yes",
+            "proposal_tx_hash": "b302de9b2ed2bca4d65e40cae4ae6d0b8e7c0f1a2b3c4d5e6f7a8b9c0d1e2f3a",
+            "proposal_cert_index": 0
+        }
+    ]
+    requests_mock.get(f"{api.url}/pools/{pool_id}/votes", json=mock_data)
+    assert api.pool_votes(pool_id=pool_id) == convert_json_to_object(mock_data)
+
+
+def test_integration_pool_votes():
+    if os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'):
+        api = BlockFrostApi(project_id=os.getenv('BLOCKFROST_PROJECT_ID_MAINNET'))
+        api.pool_votes(pool_id=pool_id)