feat: add feature RPC

CHANGELOG.md

@@ -6,7 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [[Unreleased]]
-- Add support for the DeliverMax field in Payment transactions
+
+### Added
+- Support for the DeliverMax field in Payment transactions
+- Support for the `feature` RPC
 
 ## [2.6.0] - 2024-06-03
 

tests/integration/reqs/test_feature.py

@@ -0,0 +1,29 @@
+from tests.integration.integration_test_case import IntegrationTestCase
+from tests.integration.it_utils import test_async_and_sync
+from xrpl.models.requests import Feature
+
+AMM_AMENDMENT = "8CC0774A3BF66D1D22E76BBDA8E8A232E6B6313834301B3B23E8601196AE6455"
+
+
+class TestFeature(IntegrationTestCase):
+    @test_async_and_sync(globals())
+    async def test_basic_functionality(self, client):
+        response = await client.request(Feature())
+        features = response.result["features"]
+
+        self.assertIn(AMM_AMENDMENT, features)
+        feature_info = features[AMM_AMENDMENT]
+        self.assertEqual(feature_info["name"], "AMM")
+        self.assertTrue(isinstance(feature_info["enabled"], bool))
+        self.assertEqual(feature_info["supported"], True)
+
+    @test_async_and_sync(globals())
+    async def test_single_feature(self, client):
+        response = await client.request(Feature(feature=AMM_AMENDMENT))
+        features = response.result
+
+        self.assertIn(AMM_AMENDMENT, features)
+        feature_info = features[AMM_AMENDMENT]
+        self.assertEqual(feature_info["name"], "AMM")
+        self.assertTrue(isinstance(feature_info["enabled"], bool))
+        self.assertEqual(feature_info["supported"], True)

xrpl/models/requests/__init__.py

@@ -1,4 +1,5 @@
 """Request models."""
+
 from xrpl.models.auth_account import AuthAccount
 from xrpl.models.path import PathStep
 from xrpl.models.requests.account_channels import AccountChannels
@@ -14,6 +15,7 @@
 from xrpl.models.requests.channel_authorize import ChannelAuthorize
 from xrpl.models.requests.channel_verify import ChannelVerify
 from xrpl.models.requests.deposit_authorized import DepositAuthorized
+from xrpl.models.requests.feature import Feature
 from xrpl.models.requests.fee import Fee
 from xrpl.models.requests.gateway_balances import GatewayBalances
 from xrpl.models.requests.generic_request import GenericRequest
@@ -65,6 +67,7 @@
     "ChannelAuthorize",
     "ChannelVerify",
     "DepositAuthorized",
+    "Feature",
     "Fee",
     "GatewayBalances",
     "GenericRequest",

xrpl/models/requests/feature.py

@@ -0,0 +1,22 @@
+"""This request gets information about a network's amendments."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Optional
+
+from xrpl.models.requests.request import Request, RequestMethod
+from xrpl.models.utils import KW_ONLY_DATACLASS, require_kwargs_on_init
+
+
+@require_kwargs_on_init
+@dataclass(frozen=True, **KW_ONLY_DATACLASS)
+class Feature(Request):
+    """The `feature` method gets information about a network's amendments."""
+
+    feature: Optional[str] = None
+    """
+    The hex-encoded feature hash.
+    """
+
+    method: RequestMethod = field(default=RequestMethod.FEATURE, init=False)

xrpl/models/requests/request.py

@@ -64,11 +64,13 @@ class RequestMethod(str, Enum):
     NFT_INFO = "nft_info"  # clio only
     NFT_HISTORY = "nft_history"  # clio only
     NFTS_BY_ISSUER = "nfts_by_issuer"  # clio only
+
     # subscription methods
     SUBSCRIBE = "subscribe"
     UNSUBSCRIBE = "unsubscribe"
 
     # server info methods
+    FEATURE = "feature"
     FEE = "fee"
     MANIFEST = "manifest"
     SERVER_DEFINITIONS = "server_definitions"