jito-py 0.1.1__tar.gz

jito_py-0.1.1/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.1
+Name: jito-py
+Version: 0.1.1
+Summary: A Python library for interacting with the Jito JSON-RPC
+Author-email: "Matrix.Ye" <initsysctrl@outlook.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MatrixYe/jito-py
+Keywords: jito,solana,json-rpc
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# jito-py
+
+`jito-py` is a Python library for interacting with the Solana blockchain via JSON-RPC.
+
+## Installation
+
+```bash
+pip install jito_py
+
+## Usage
+```python
+from jito_py.searcher import Searcher
+from jito_py.block_engine import BlockEngine
+
+
+# Get Block Engine Url
+engines=BlockEngine.get_block_engines(network='mainnet')
+print(engines)
+block_engine_url=engine[0]['block_engine_url']
+
+# Create a searcher instance
+searcher = Searcher(block_engine_url)
+
+# Get tip accounts
+tip_accounts = searcher.get_tip_accounts()
+print("Tip Accounts:", tip_accounts)
+
+# Get bundle statuses
+bundle_ids = ["your_bundle_id_here"]
+bundle_statuses = searcher.get_bundle_statuses(bundle_ids)
+print("Bundle Statuses:", bundle_statuses)
+
+# Send a bundle
+transactions = ["your_base58_encoded_transaction_here"]
+bundle_id = searcher.send_bundle(transactions)
+print("Sent Bundle ID:", bundle_id)
+
+# Send a transaction
+transaction = "your_base58_encoded_transaction_here"
+transaction_id = searcher.send_transaction(transaction)
+print("Sent Transaction ID:", transaction_id)
+
+
+```

jito_py-0.1.1/README.md

@@ -0,0 +1,44 @@
+# jito-py
+
+`jito-py` is a Python library for interacting with the Solana blockchain via JSON-RPC.
+
+## Installation
+
+```bash
+pip install jito_py
+
+## Usage
+```python
+from jito_py.searcher import Searcher
+from jito_py.block_engine import BlockEngine
+
+
+# Get Block Engine Url
+engines=BlockEngine.get_block_engines(network='mainnet')
+print(engines)
+block_engine_url=engine[0]['block_engine_url']
+
+# Create a searcher instance
+searcher = Searcher(block_engine_url)
+
+# Get tip accounts
+tip_accounts = searcher.get_tip_accounts()
+print("Tip Accounts:", tip_accounts)
+
+# Get bundle statuses
+bundle_ids = ["your_bundle_id_here"]
+bundle_statuses = searcher.get_bundle_statuses(bundle_ids)
+print("Bundle Statuses:", bundle_statuses)
+
+# Send a bundle
+transactions = ["your_base58_encoded_transaction_here"]
+bundle_id = searcher.send_bundle(transactions)
+print("Sent Bundle ID:", bundle_id)
+
+# Send a transaction
+transaction = "your_base58_encoded_transaction_here"
+transaction_id = searcher.send_transaction(transaction)
+print("Sent Transaction ID:", transaction_id)
+
+
+```

jito_py-0.1.1/jito_py/__init__.py

@@ -0,0 +1,7 @@
+# -*- coding: utf-8 -*-#
+# -------------------------------------------------------------------------------
+# Name:         a 
+# Author:       yepeng
+# Date:         2021/10/22 2:44 下午
+# Description: 
+# -------------------------------------------------------------------------------

jito_py-0.1.1/jito_py/block_engine.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*-#
+# -------------------------------------------------------------------------------
+# Name:         a 
+# Author:       yepeng
+# Date:         2021/10/22 2:44 下午
+# Description: 
+# -------------------------------------------------------------------------------
+# noinspection HttpUrlsUsage
+class BlockEngine:
+    MAINNET_ADDRESS = {
+        "Amsterdam": {
+            "block_engine_url": "https://amsterdam.mainnet.block-engine.jito.wtf",
+            "shred_receiver_addr": "74.118.140.240:1002",
+            "relayer_url": "http://amsterdam.mainnet.relayer.jito.wtf:8100",
+        },
+        "Frankfurt": {
+            "block_engine_url": "https://frankfurt.mainnet.block-engine.jito.wtf",
+            "shred_receiver_addr": "145.40.93.84:1002",
+            "relayer_url": "http://frankfurt.mainnet.relayer.jito.wtf:8100",
+        },
+        "York": {
+            "block_engine_url": "https://ny.mainnet.block-engine.jito.wtf",
+            "shred_receiver_addr": "141.98.216.96:1002",
+            "relayer_url": "http://ny.mainnet.relayer.jito.wtf:8100",
+        },
+        "Tokyo": {
+            "block_engine_url": "https://tokyo.mainnet.block-engine.jito.wtf",
+            "shred_receiver_addr": "202.8.9.160:1002",
+            "relayer_url": "http://tokyo.mainnet.relayer.jito.wtf:8100",
+        }
+
+    }
+    TESTNET_ADDRESS = {
+        "Dallas": {
+            "block_engine_url": "https://dallas.testnet.block-engine.jito.wtf",
+            "shred_receiver_addr": "147.28.154.132:1002",
+            "relayer_url": "http://dallas.testnet.relayer.jito.wtf:8100",
+        },
+
+        "York": {
+            "block_engine_url": "https://ny.testnet.block-engine.jito.wtf",
+            "shred_receiver_addr": "141.98.216.97:1002",
+            "relayer_url": "http://nyc.testnet.relayer.jito.wtf:8100",
+        },
+
+    }
+
+    # noinspection HttpUrlsUsage
+    @staticmethod
+    def get_block_engines(network="mainnet") -> dict | None:
+        if network == "mainnet":
+            return BlockEngine.MAINNET_ADDRESS
+        if network == "testnet":
+            return BlockEngine.TESTNET_ADDRESS
+        return None

jito_py-0.1.1/jito_py/searcher.py

@@ -0,0 +1,106 @@
+from dataclasses import dataclass, field
+from typing import List, Optional, Dict, Any
+
+import requests
+
+
+@dataclass
+class BundleStatus:
+    bundle_id: str
+    transactions: List[str]
+    slot: int
+    confirmation_status: str
+    err: Dict[str, Any]
+
+
+@dataclass
+class BundleStatusesResponse:
+    context_slot: int
+    statuses: List[BundleStatus] = field(default_factory=list)
+
+
+class Searcher:
+    def __init__(self, block_engine_url: str):
+        self.block_engine_url = block_engine_url
+
+    @staticmethod
+    def _extract_result(response: Dict[str, Any], method: str) -> Any:
+        if 'result' in response:
+            return response['result']
+        else:
+            raise Exception(f"Error in {method} response: {response}")
+
+    def _send_rpc_request(self, endpoint: str, method: str, params: Optional[List] = None) -> Dict[str, Any]:
+        headers = {"Content-Type": "application/json"}
+        payload = {
+            "jsonrpc": "2.0",
+            "id": 1,
+            "method": method,
+            "params": params or []
+        }
+        try:
+            url = f"{self.block_engine_url}/{endpoint}"
+            response = requests.post(url=url, json=payload, headers=headers)
+            response.raise_for_status()
+            return response.json()
+        except requests.RequestException as e:
+            raise Exception(f"HTTP request failed: {e}")
+        except ValueError as e:
+            raise Exception(f"Invalid JSON response: {e}")
+
+    def get_bundle_statuses(self, bundle_ids: List[str]) -> BundleStatusesResponse:
+        """
+        Returns the status of submitted bundle(s).
+
+        :param bundle_ids: An array of bundle ids to confirm, as base-58 encoded strings (up to a maximum of 5).
+        :return: A BundleStatusesResponse object containing the context slot and a list of BundleStatus objects.
+        """
+        response = self._send_rpc_request("/api/v1/bundles", "getBundleStatuses", [bundle_ids])
+        result = self._extract_result(response, "getBundleStatuses")
+        context_slot = result['context']['slot']
+        statuses = [
+            BundleStatus(
+                bundle_id=status['bundle_id'],
+                transactions=status['transactions'],
+                slot=status['slot'],
+                confirmation_status=status['confirmation_status'],
+                err=status['err']
+            )
+            for status in result['value']
+        ]
+        return BundleStatusesResponse(context_slot=context_slot, statuses=statuses)
+
+    def get_tip_accounts(self) -> List[str]:
+        """
+        Retrieves the tip accounts designated for tip payments for bundles.
+
+        :return: Tip accounts as a list of strings.
+        """
+        response = self._send_rpc_request("/api/v1/bundles", "getTipAccounts")
+        return self._extract_result(response, "getTipAccounts")
+
+    def send_bundle(self, transactions: List[str]) -> str:
+        """
+        Submits a bundled list of signed transactions (base-58 encoded strings) to the cluster for processing.
+
+        :param transactions: Fully-signed transactions, as base-58 encoded strings (up to a maximum of 5).
+                             Base-64 encoded transactions are not supported at this time.
+        :return: A bundle ID, used to identify the bundle. This is the SHA-256 hash of the bundle's transaction signatures.
+        """
+        response = self._send_rpc_request("/api/v1/bundles", "sendBundle", [transactions])
+        return self._extract_result(response, "sendBundle")
+
+    def send_transaction(self, transaction: str) -> str:
+        """
+        This method serves as a proxy to the Solana sendTransaction RPC method. It forwards the received transaction as a
+        regular Solana transaction via the Solana RPC method and submits it as a bundle. Jito sponsors the bundling and
+        provides a minimum tip for the bundle. However, please note that this minimum tip might not be sufficient to get
+        the bundle through the auction, especially during high-demand periods. If you set the query parameter bundleOnly=true,
+        the transaction will only be sent out as a bundle and not as a regular transaction via RPC.
+
+        :param transaction: First Transaction Signature embedded in the transaction, as base-58 encoded string.
+        :return: The result will be the same as described in the Solana RPC documentation. If sending as a bundle was
+                 successful, you can get the bundle_id for further querying from the custom header in the response x-bundle-id.
+        """
+        response = self._send_rpc_request("/api/v1/transactions", "sendTransaction", [transaction])
+        return self._extract_result(response, "sendTransaction")

jito_py-0.1.1/jito_py.egg-info/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.1
+Name: jito-py
+Version: 0.1.1
+Summary: A Python library for interacting with the Jito JSON-RPC
+Author-email: "Matrix.Ye" <initsysctrl@outlook.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MatrixYe/jito-py
+Keywords: jito,solana,json-rpc
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# jito-py
+
+`jito-py` is a Python library for interacting with the Solana blockchain via JSON-RPC.
+
+## Installation
+
+```bash
+pip install jito_py
+
+## Usage
+```python
+from jito_py.searcher import Searcher
+from jito_py.block_engine import BlockEngine
+
+
+# Get Block Engine Url
+engines=BlockEngine.get_block_engines(network='mainnet')
+print(engines)
+block_engine_url=engine[0]['block_engine_url']
+
+# Create a searcher instance
+searcher = Searcher(block_engine_url)
+
+# Get tip accounts
+tip_accounts = searcher.get_tip_accounts()
+print("Tip Accounts:", tip_accounts)
+
+# Get bundle statuses
+bundle_ids = ["your_bundle_id_here"]
+bundle_statuses = searcher.get_bundle_statuses(bundle_ids)
+print("Bundle Statuses:", bundle_statuses)
+
+# Send a bundle
+transactions = ["your_base58_encoded_transaction_here"]
+bundle_id = searcher.send_bundle(transactions)
+print("Sent Bundle ID:", bundle_id)
+
+# Send a transaction
+transaction = "your_base58_encoded_transaction_here"
+transaction_id = searcher.send_transaction(transaction)
+print("Sent Transaction ID:", transaction_id)
+
+
+```

jito_py-0.1.1/jito_py.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+setup.py
+jito_py/__init__.py
+jito_py/block_engine.py
+jito_py/searcher.py
+jito_py.egg-info/PKG-INFO
+jito_py.egg-info/SOURCES.txt
+jito_py.egg-info/dependency_links.txt
+jito_py.egg-info/requires.txt
+jito_py.egg-info/top_level.txt
+tests/test_searcher.py

jito_py-0.1.1/jito_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

jito_py-0.1.1/jito_py.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

jito_py-0.1.1/jito_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+jito_py

jito_py-0.1.1/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jito-py"
+version = "0.1.1"
+description = "A Python library for interacting with the Jito JSON-RPC"
+readme = "README.md"
+authors = [
+    { name = "Matrix.Ye", email = "initsysctrl@outlook.com" }
+]
+license = { text = "MIT" }
+requires-python = ">=3.6"
+dependencies = [
+    "requests"
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent"
+]
+keywords = ["jito", "solana", "json-rpc"]
+
+[project.urls]
+Homepage = "https://github.com/MatrixYe/jito-py"

jito_py-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

jito_py-0.1.1/setup.py

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-#
+# -------------------------------------------------------------------------------
+# Name:         a 
+# Author:       yepeng
+# Date:         2021/10/22 2:44 下午
+# Description: 
+# -------------------------------------------------------------------------------
+from setuptools import setup
+
+setup()

jito_py-0.1.1/tests/test_searcher.py

@@ -0,0 +1,89 @@
+import unittest
+from unittest.mock import patch
+
+from jito_py.searcher import Searcher, BundleStatusesResponse, BundleStatus
+
+
+class TestSearcher(unittest.TestCase):
+    def setUp(self):
+        self.searcher = Searcher("https://mainnet.block-engine.jito.wtf")
+
+    @patch('jito_py.searcher.requests.post')
+    def test_get_tip_accounts(self, mock_post):
+        mock_post.return_value.json.return_value = {
+            "jsonrpc": "2.0",
+            "result": [
+                "96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5",
+                "HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe",
+                "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY",
+                "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49",
+                "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh",
+                "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt",
+                "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL",
+                "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT"
+            ],
+            "id": 1
+        }
+        expected_response = [
+            "96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5",
+            "HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe",
+            "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY",
+            "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49",
+            "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh",
+            "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt",
+            "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL",
+            "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT"
+        ]
+
+        result = self.searcher.get_tip_accounts()
+        print(result)
+
+        self.assertEqual(result, expected_response)
+
+    @patch('jito_py.searcher.requests.post')
+    def test_get_bundle_statuses(self, mock_post):
+        mock_post.return_value.json.return_value = {
+            "jsonrpc": "2.0",
+            "result": {
+                "context": {
+                    "slot": 242806119
+                },
+                "value": [
+                    {
+                        "bundle_id": "892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
+                        "transactions": [
+                            "3bC2M9fiACSjkTXZDgeNAuQ4ScTsdKGwR42ytFdhUvikqTmBheUxfsR1fDVsM5ADCMMspuwGkdm1uKbU246x5aE3",
+                            "8t9hKYEYNbLvNqiSzP96S13XF1C2f1ro271Kdf7bkZ6EpjPLuDff1ywRy4gfaGSTubsM2FeYGDoT64ZwPm1cQUt"
+                        ],
+                        "slot": 242804011,
+                        "confirmation_status": "finalized",
+                        "err": {
+                            "Ok": None
+                        }
+                    }
+                ]
+            },
+            "id": 1
+        }
+        expected_response = BundleStatusesResponse(
+            context_slot=242806119,
+            statuses=[
+                BundleStatus(
+                    bundle_id="892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d",
+                    transactions=[
+                        "3bC2M9fiACSjkTXZDgeNAuQ4ScTsdKGwR42ytFdhUvikqTmBheUxfsR1fDVsM5ADCMMspuwGkdm1uKbU246x5aE3",
+                        "8t9hKYEYNbLvNqiSzP96S13XF1C2f1ro271Kdf7bkZ6EpjPLuDff1ywRy4gfaGSTubsM2FeYGDoT64ZwPm1cQUt"
+                    ],
+                    slot=242804011,
+                    confirmation_status="finalized",
+                    err={"Ok": None}
+                )
+            ]
+        )
+        result = self.searcher.get_bundle_statuses(["892b79ed49138bfb3aa5441f0df6e06ef34f9ee8f3976c15b323605bae0cf51d"])
+        print(result)
+        self.assertEqual(result, expected_response)
+
+
+if __name__ == "__main__":
+    unittest.main()