payra-sdk 1.2.6__tar.gz → 1.2.8__tar.gz

{payra_sdk-1.2.6/payra_sdk.egg-info → payra_sdk-1.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: payra_sdk
-Version: 1.2.6
+Version: 1.2.8
 Summary: Python SDK for Payra payment signature generation (backend)
 Author: Your Name
 Author-email: Wraith <support@payra.cash>
@@ -28,8 +28,7 @@ Official **Python SDK** for integrating **Payra's on-chain payment system** into
 
 This SDK provides:
 - Secure generation of **ECDSA signatures** compatible with the Payra smart contract, used for order payment verification.
-- Simple methods for **checking the on-chain status of orders** to confirm completed payments.
-
+- Simple methods for **checking the on-chain details of orders** to confirm completed payments.
 
 ## How It Works
 
@@ -48,20 +47,18 @@ The typical flow for signing and verifying a Payra transaction:
 
 This process ensures full compatibility between your backend and Payra’s on-chain verification logic.
 
-
 ## Features
 
 - Generates **Ethereum ECDSA signatures** using the `secp256k1` curve.
 - Fully compatible with **Payra's Solidity smart contracts** (`ERC-1155` payment verification).
 - Supports `.env` and `config/payra.php` configuration for multiple blockchain networks.
 - Laravel IoC container integration (easy dependency injection)
-- Verifies **order payment status directly on-chain** via RPC or blockchain explorer API.
+- Verifies **order payment details directly on-chain** via RPC or blockchain explorer API.
 - Provides **secure backend integration** for signing and verifying transactions.
 - Includes optional utility helpers for:
 -  **Currency conversion** (via [ExchangeRate API](https://www.exchangerate-api.com/))
 -  **USD ⇄ WEI** conversion for token precision handling.
 
-
 ## Setup
 
 Before installing this package, make sure you have an active **Payra** account:
@@ -87,7 +84,6 @@ To obtain your **RPC URLs** which are required for reading on-chain order status
 Optional (recommended):
 - Create a free API key at [ExchangeRate API](https://www.exchangerate-api.com/) to enable **automatic fiat → USD conversions** using the built-in utility helpers.
 
-
 ## Installation
 
 ### From PyPI
@@ -129,7 +125,6 @@ cp  .env.example  .env
 
 This file stores your **private configuration** and connection settings for all supported networks. Never commit `.env` to version control.
 
-
 ### Required Variables
 
 #### Exchange Rate (optional)
@@ -164,9 +159,9 @@ PAYRA_LINEA_RPC_URL_2=
 
 - The cache automatically refreshes when it expires.
 - You can adjust the cache duration by setting `PAYRA_EXCHANGE_RATE_CACHE_TIME`:
--  `5` → cache for 5 minutes
--  `60` → cache for 1 hour
--  `720` → cache for 12 hours (default)
+	-  `5` → cache for 5 minutes
+	-  `60` → cache for 1 hour
+	-  `720` → cache for 12 hours (default)
 - Each network (Polygon, Ethereum, Linea) has its own **merchant ID**, **signature key**, and **RPC URLs**.
 - The SDK automatically detects which chain configuration to use based on the selected network.
 - You can use multiple RPC URLs for redundancy (the SDK will automatically fall back if one fails).
@@ -175,10 +170,10 @@ PAYRA_LINEA_RPC_URL_2=
 
 ## Usage Example
 
-### Generating and verifying a Payra signature in your backend
+### Generating signature
 
 ```python
-from payra_sdk import PayraUtils, PayraSignatureGenerator, PayraSDKException
+from payra_sdk import PayraUtils, PayraSignature, PayraSDKException
 
 try:
 	# Convert amount to smallest unit (wei or token decimals
@@ -187,17 +182,17 @@ try:
 	PAYMENT_DATA = {
 		"network": "polygon",
 		"tokenAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", # USDT on Polygon
-		"orderId": "ORDER-1753824905006-301-322",
+		"orderId": "ord-258",
 		"amountWei": amount_wei, # e.g. 3.34 USDT in smallest unit
 		"timestamp": 1753826059, # current Unix timestamp
 		"payerAddress": "0xe6c961D6ad9a27Ea8e5d99e40abaC365DE9Cc162"
 	}
 	
 	# Initialize signer
-	payra_signer = PayraSignatureGenerator()
+	payra_signature = PayraSignature()
 	
 	# Generate cryptographic signature
-	signature = payra_signer.generate_signature(
+	signature = payra_signature.generate(
 		network=PAYMENT_DATA["network"],
 		token_address=PAYMENT_DATA["tokenAddress"],
 		order_id=PAYMENT_DATA["orderId"],
@@ -227,13 +222,13 @@ except  Exception  as e:
 #### Behind the Scenes
 
 1. The backend converts the amount to the smallest blockchain unit (e.g. wei).
-2. A `PayraSignatureGenerator` instance is created using your signature key from `.env`
+2. A `PayraSignature` instance is created using your signature key from `.env`
 3. It generates an ECDSA signature that is fully verifiable on-chain by the Payra smart contract.
 4. The resulting signature should be sent to the **frontend**, which must call `payOrder(...)` using the same parameters (`timestamp`, `orderId`, `amount`, `tokenAddress`, etc.) that were used to generate the signature.
 
 ---
 
-### Get Order Status
+### Get Order Details
 
 Retrieve **full payment details** for a specific order from the Payra smart contract. This method returns the complete on-chain payment data associated with the order, including:
 - whether the order has been paid,
@@ -245,19 +240,19 @@ Retrieve **full payment details** for a specific order from the Payra smart cont
 Use this method when you need **detailed information** about the payment or want to display full transaction data.
 
 ```python
-from payra_sdk import PayraOrderVerification, PayraSDKException
+from payra_sdk import PayraOrderService, PayraSDKException
 
 try:
 	ORDER_ID = "ord-258"
 	# Initialize verifier for a specific network
-	verifier = PayraOrderVerification("polygon")
+	order_service = PayraOrderService("polygon")
 	
-	print("\nGet order status...")
-	result = verifier.get_order_status(ORDER_ID)
+	print("\nGet order details...")
+	details = order_service.get_details(ORDER_ID)
 	
 	print("Order ID:", ORDER_ID)
-	print("Result:", result)
-	
+	print("Details:", details)
+	        
 except PayraSDKException as e:
 	print(f"Payra SDK error: {e}")
 except  Exception  as e:
@@ -266,15 +261,15 @@ except  Exception  as e:
 
 #### Behind the Scenes
 
-1. The backend initializes a `PayraOrderVerification` object for the desired blockchain network.
-2. It calls `get_order_status(order_id)` to check if the order transaction exists and is confirmed on-chain.
+1. The backend initializes a `PayraOrderService` object for the desired blockchain network.
+2. It calls `get_details(order_id)` to get transaction details from blockchain.
 3. The function returns a dictionary with:
 
 ```python
 {
 	"success": True,
 	"paid": True,
-	"error": None.
+	"error": None,
 	"toke": '0xc2132d05d31c914a87c6611c10748aeb04b58e8f',
 	"amount": 400000,
 	"fee": 3600,
@@ -291,16 +286,16 @@ Perform a **simple payment check** for a specific order. This method only verifi
 Use this method when you only need a **quick boolean confirmation** of the payment status.
 
 ```python
-from payra_sdk import PayraOrderVerification, PayraSDKException
+from payra_sdk import PayraOrderService, PayraSDKException
 
 try:
 	ORDER_ID = "ord-258"
 
 	# Initialize verifier for a specific network
-	verifier = PayraOrderVerification("polygon")
+	order_service = PayraOrderService("polygon")
 
 	print("\nChecking order status...")
-	result = verifier.is_order_paid(ORDER_ID)
+	result = order_service.is_paid(ORDER_ID)
 
 	print("Order ID:", ORDER_ID)
 	print("Result:", result)
@@ -320,8 +315,8 @@ except  Exception  as e:
 
 #### Behind the Scenes
 
-1. The backend initializes a `PayraOrderVerification` object for the desired blockchain network.
-2. It calls `is_order_paid(order_id)` to check if the order transaction exists and is confirmed on-chain.
+1. The backend initializes a `PayraOrderService` object for the desired blockchain network.
+2. It calls `is_paid(order_id)` to check if the order transaction exists and is confirmed on-chain.
 3. The function returns a dictionary with:
 ```python
 {
@@ -365,25 +360,23 @@ print(f"100 EUR = {usd_value} USD")
 -  `get_decimals(network, token)` – Returns the number of decimals for the given token on that network.
 -  `convert_to_usd(amount, currency)` – Converts fiat amounts (e.g. EUR, GBP) to USD using your ExchangeRate API key.
 
-
 ## Testing
 
 You can run the included `examples` to test signing and verification:
 
 ```python
 python3 example_signature.py
-python3 example_order_verification.py
+python3 example_order_get_details.py
+python3 example_order_is_paid.py
 python3 example_utils.py
 ```
 
 Make sure your `.env` file contains correct values for the `network` being used.
 
-### Tips
-
-- Always verify your `.env` configuration before running any signing or on-chain verification examples.
-- The SDK examples are safe to run, they use **read-only RPC calls** (no real transactions are broadcast).
-- You can modify `example_signature.py` to test custom token addresses or order parameters.
+## Security Notice
 
+Never expose your signature key in frontend or client-side code.  
+This SDK is  **server-side only**  and must be used securely on your backend. Never use it in frontend or browser environments. Also, never commit your `.env`  file to version control.
 
 ## Projects
 
@@ -398,7 +391,6 @@ Make sure your `.env` file contains correct values for the `network` being used.
 - [https://payra.xyz](https://payra.xyz)
 - [https://payra.eth](https://payra.eth.limo) - suporrted by Brave and Opera Browser or .limo
 
-
 ## Social Media
 
 - [Telegram Payra Group](https://t.me/+GhTyJJrd4SMyMDA0)
@@ -407,4 +399,5 @@ Make sure your `.env` file contains correct values for the `network` being used.
 - [Dev.to](https://dev.to/payracash)
 
 ## License
+
 MIT © [Payra](https://payra.cash)

{payra_sdk-1.2.6 → payra_sdk-1.2.8}/README.md

@@ -4,8 +4,7 @@ Official **Python SDK** for integrating **Payra's on-chain payment system** into
 
 This SDK provides:
 - Secure generation of **ECDSA signatures** compatible with the Payra smart contract, used for order payment verification.
-- Simple methods for **checking the on-chain status of orders** to confirm completed payments.
-
+- Simple methods for **checking the on-chain details of orders** to confirm completed payments.
 
 ## How It Works
 
@@ -24,20 +23,18 @@ The typical flow for signing and verifying a Payra transaction:
 
 This process ensures full compatibility between your backend and Payra’s on-chain verification logic.
 
-
 ## Features
 
 - Generates **Ethereum ECDSA signatures** using the `secp256k1` curve.
 - Fully compatible with **Payra's Solidity smart contracts** (`ERC-1155` payment verification).
 - Supports `.env` and `config/payra.php` configuration for multiple blockchain networks.
 - Laravel IoC container integration (easy dependency injection)
-- Verifies **order payment status directly on-chain** via RPC or blockchain explorer API.
+- Verifies **order payment details directly on-chain** via RPC or blockchain explorer API.
 - Provides **secure backend integration** for signing and verifying transactions.
 - Includes optional utility helpers for:
 -  **Currency conversion** (via [ExchangeRate API](https://www.exchangerate-api.com/))
 -  **USD ⇄ WEI** conversion for token precision handling.
 
-
 ## Setup
 
 Before installing this package, make sure you have an active **Payra** account:
@@ -63,7 +60,6 @@ To obtain your **RPC URLs** which are required for reading on-chain order status
 Optional (recommended):
 - Create a free API key at [ExchangeRate API](https://www.exchangerate-api.com/) to enable **automatic fiat → USD conversions** using the built-in utility helpers.
 
-
 ## Installation
 
 ### From PyPI
@@ -105,7 +101,6 @@ cp  .env.example  .env
 
 This file stores your **private configuration** and connection settings for all supported networks. Never commit `.env` to version control.
 
-
 ### Required Variables
 
 #### Exchange Rate (optional)
@@ -140,9 +135,9 @@ PAYRA_LINEA_RPC_URL_2=
 
 - The cache automatically refreshes when it expires.
 - You can adjust the cache duration by setting `PAYRA_EXCHANGE_RATE_CACHE_TIME`:
--  `5` → cache for 5 minutes
--  `60` → cache for 1 hour
--  `720` → cache for 12 hours (default)
+	-  `5` → cache for 5 minutes
+	-  `60` → cache for 1 hour
+	-  `720` → cache for 12 hours (default)
 - Each network (Polygon, Ethereum, Linea) has its own **merchant ID**, **signature key**, and **RPC URLs**.
 - The SDK automatically detects which chain configuration to use based on the selected network.
 - You can use multiple RPC URLs for redundancy (the SDK will automatically fall back if one fails).
@@ -151,10 +146,10 @@ PAYRA_LINEA_RPC_URL_2=
 
 ## Usage Example
 
-### Generating and verifying a Payra signature in your backend
+### Generating signature
 
 ```python
-from payra_sdk import PayraUtils, PayraSignatureGenerator, PayraSDKException
+from payra_sdk import PayraUtils, PayraSignature, PayraSDKException
 
 try:
 	# Convert amount to smallest unit (wei or token decimals
@@ -163,17 +158,17 @@ try:
 	PAYMENT_DATA = {
 		"network": "polygon",
 		"tokenAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", # USDT on Polygon
-		"orderId": "ORDER-1753824905006-301-322",
+		"orderId": "ord-258",
 		"amountWei": amount_wei, # e.g. 3.34 USDT in smallest unit
 		"timestamp": 1753826059, # current Unix timestamp
 		"payerAddress": "0xe6c961D6ad9a27Ea8e5d99e40abaC365DE9Cc162"
 	}
 	
 	# Initialize signer
-	payra_signer = PayraSignatureGenerator()
+	payra_signature = PayraSignature()
 	
 	# Generate cryptographic signature
-	signature = payra_signer.generate_signature(
+	signature = payra_signature.generate(
 		network=PAYMENT_DATA["network"],
 		token_address=PAYMENT_DATA["tokenAddress"],
 		order_id=PAYMENT_DATA["orderId"],
@@ -203,13 +198,13 @@ except  Exception  as e:
 #### Behind the Scenes
 
 1. The backend converts the amount to the smallest blockchain unit (e.g. wei).
-2. A `PayraSignatureGenerator` instance is created using your signature key from `.env`
+2. A `PayraSignature` instance is created using your signature key from `.env`
 3. It generates an ECDSA signature that is fully verifiable on-chain by the Payra smart contract.
 4. The resulting signature should be sent to the **frontend**, which must call `payOrder(...)` using the same parameters (`timestamp`, `orderId`, `amount`, `tokenAddress`, etc.) that were used to generate the signature.
 
 ---
 
-### Get Order Status
+### Get Order Details
 
 Retrieve **full payment details** for a specific order from the Payra smart contract. This method returns the complete on-chain payment data associated with the order, including:
 - whether the order has been paid,
@@ -221,19 +216,19 @@ Retrieve **full payment details** for a specific order from the Payra smart cont
 Use this method when you need **detailed information** about the payment or want to display full transaction data.
 
 ```python
-from payra_sdk import PayraOrderVerification, PayraSDKException
+from payra_sdk import PayraOrderService, PayraSDKException
 
 try:
 	ORDER_ID = "ord-258"
 	# Initialize verifier for a specific network
-	verifier = PayraOrderVerification("polygon")
+	order_service = PayraOrderService("polygon")
 	
-	print("\nGet order status...")
-	result = verifier.get_order_status(ORDER_ID)
+	print("\nGet order details...")
+	details = order_service.get_details(ORDER_ID)
 	
 	print("Order ID:", ORDER_ID)
-	print("Result:", result)
-	
+	print("Details:", details)
+	        
 except PayraSDKException as e:
 	print(f"Payra SDK error: {e}")
 except  Exception  as e:
@@ -242,15 +237,15 @@ except  Exception  as e:
 
 #### Behind the Scenes
 
-1. The backend initializes a `PayraOrderVerification` object for the desired blockchain network.
-2. It calls `get_order_status(order_id)` to check if the order transaction exists and is confirmed on-chain.
+1. The backend initializes a `PayraOrderService` object for the desired blockchain network.
+2. It calls `get_details(order_id)` to get transaction details from blockchain.
 3. The function returns a dictionary with:
 
 ```python
 {
 	"success": True,
 	"paid": True,
-	"error": None.
+	"error": None,
 	"toke": '0xc2132d05d31c914a87c6611c10748aeb04b58e8f',
 	"amount": 400000,
 	"fee": 3600,
@@ -267,16 +262,16 @@ Perform a **simple payment check** for a specific order. This method only verifi
 Use this method when you only need a **quick boolean confirmation** of the payment status.
 
 ```python
-from payra_sdk import PayraOrderVerification, PayraSDKException
+from payra_sdk import PayraOrderService, PayraSDKException
 
 try:
 	ORDER_ID = "ord-258"
 
 	# Initialize verifier for a specific network
-	verifier = PayraOrderVerification("polygon")
+	order_service = PayraOrderService("polygon")
 
 	print("\nChecking order status...")
-	result = verifier.is_order_paid(ORDER_ID)
+	result = order_service.is_paid(ORDER_ID)
 
 	print("Order ID:", ORDER_ID)
 	print("Result:", result)
@@ -296,8 +291,8 @@ except  Exception  as e:
 
 #### Behind the Scenes
 
-1. The backend initializes a `PayraOrderVerification` object for the desired blockchain network.
-2. It calls `is_order_paid(order_id)` to check if the order transaction exists and is confirmed on-chain.
+1. The backend initializes a `PayraOrderService` object for the desired blockchain network.
+2. It calls `is_paid(order_id)` to check if the order transaction exists and is confirmed on-chain.
 3. The function returns a dictionary with:
 ```python
 {
@@ -341,25 +336,23 @@ print(f"100 EUR = {usd_value} USD")
 -  `get_decimals(network, token)` – Returns the number of decimals for the given token on that network.
 -  `convert_to_usd(amount, currency)` – Converts fiat amounts (e.g. EUR, GBP) to USD using your ExchangeRate API key.
 
-
 ## Testing
 
 You can run the included `examples` to test signing and verification:
 
 ```python
 python3 example_signature.py
-python3 example_order_verification.py
+python3 example_order_get_details.py
+python3 example_order_is_paid.py
 python3 example_utils.py
 ```
 
 Make sure your `.env` file contains correct values for the `network` being used.
 
-### Tips
-
-- Always verify your `.env` configuration before running any signing or on-chain verification examples.
-- The SDK examples are safe to run, they use **read-only RPC calls** (no real transactions are broadcast).
-- You can modify `example_signature.py` to test custom token addresses or order parameters.
+## Security Notice
 
+Never expose your signature key in frontend or client-side code.  
+This SDK is  **server-side only**  and must be used securely on your backend. Never use it in frontend or browser environments. Also, never commit your `.env`  file to version control.
 
 ## Projects
 
@@ -374,7 +367,6 @@ Make sure your `.env` file contains correct values for the `network` being used.
 - [https://payra.xyz](https://payra.xyz)
 - [https://payra.eth](https://payra.eth.limo) - suporrted by Brave and Opera Browser or .limo
 
-
 ## Social Media
 
 - [Telegram Payra Group](https://t.me/+GhTyJJrd4SMyMDA0)
@@ -383,4 +375,5 @@ Make sure your `.env` file contains correct values for the `network` being used.
 - [Dev.to](https://dev.to/payracash)
 
 ## License
+
 MIT © [Payra](https://payra.cash)

{payra_sdk-1.2.6 → payra_sdk-1.2.8}/payra_sdk/__init__.py

@@ -1,13 +1,13 @@
 # payra-sdk-python/payra_sdk/__init__.py
 
-from .signature import PayraSignatureGenerator
-from .order_verification import PayraOrderVerification
+from .signature import PayraSignature
+from .order_service import PayraOrderService
 from .exceptions import PayraSDKException, InvalidArgumentError, SignatureError
 from .utils import PayraUtils
 
 __all__ = [
-    "PayraSignatureGenerator",
-    "PayraOrderVerification",
+    "PayraSignature",
+    "PayraOrderService",
     "PayraSDKException",
     "InvalidArgumentError",
     "SignatureError",

payra_sdk-1.2.6/payra_sdk/order_verification.py → payra_sdk-1.2.8/payra_sdk/order_service.py

@@ -11,7 +11,7 @@ from .exceptions import InvalidArgumentError, SignatureError
 # load env
 load_dotenv()
 
-class PayraOrderVerification:
+class PayraOrderService:
     """
     SDK for verifying if an order has been paid using the Payra smart contract.
     """
@@ -22,7 +22,7 @@ class PayraOrderVerification:
 
         self.web3 = Web3(Web3.HTTPProvider(self.rpc_url))
         if not self.web3.is_connected():
-            raise ConnectionError(f"Failed to connect to QuickNode RPC for {self.network}")
+            raise ConnectionError(f"Failed to connect to RPC for {self.network}")
 
         self.merchant_id = os.getenv(f"PAYRA_{self.network}_MERCHANT_ID")
         self.gateway_address = os.getenv(f"PAYRA_{self.network}_OCP_GATEWAY_CONTRACT_ADDRESS")
@@ -53,7 +53,7 @@ class PayraOrderVerification:
         # Return the actual contract responsible for order data
         return self.web3.eth.contract(address=user_data_address, abi=self.abi)
 
-    def is_order_paid(self, order_id: str) -> dict:
+    def is_paid(self, order_id: str) -> dict:
         """
         Verify if an order is paid on Payra contract.
         """
@@ -76,7 +76,7 @@ class PayraOrderVerification:
                 "error": str(e)
             }
 
-    def get_order_status(self, order_id: str) -> dict:
+    def get_details(self, order_id: str) -> dict:
         """
         Detailed status of an order from Payra smart contract.
         Equivalent to getOrderDetails in Node.js version.

{payra_sdk-1.2.6 → payra_sdk-1.2.8}/payra_sdk/signature.py

@@ -12,7 +12,7 @@ from .exceptions import InvalidArgumentError, SignatureError
 # Load environment variables from .env file
 load_dotenv()
 
-class PayraSignatureGenerator:
+class PayraSignature:
     """
     SDK for generating Payra payment signatures on the backend.
     This version assumes `amount_wei` is already in the token's smallest unit (e.g., wei)
@@ -22,10 +22,10 @@ class PayraSignatureGenerator:
     def __init__(self):
 
         """
-        Initializes the PayraSignatureGenerator.
+        Initializes the PayraSignature.
         """
 
-    def generate_signature(
+    def generate(
         self,
         network: str,
         token_address: str,
@@ -117,7 +117,7 @@ class PayraSignatureGenerator:
             raise SignatureError(f"Error generating signature: {e}")
 
     # Optional: Add a verification method if you ever need to verify a signature offline
-    def verify_signature(
+    def verify(
         self,
         network: str,
         token_address: str,
@@ -168,7 +168,7 @@ class PayraSignatureGenerator:
     ) -> bytes:
         """
         Generates the raw Keccak256 hash of the ABI-encoded payment data.
-        This is a helper for internal use, especially for `verify_signature`.
+        This is a helper for internal use, especially for `verify`.
         """
         checksum_token_address = to_checksum_address(token_address)
         checksum_payer_address = to_checksum_address(payer_address)

{payra_sdk-1.2.6 → payra_sdk-1.2.8/payra_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: payra_sdk
-Version: 1.2.6
+Version: 1.2.8
 Summary: Python SDK for Payra payment signature generation (backend)
 Author: Your Name
 Author-email: Wraith <support@payra.cash>
@@ -28,8 +28,7 @@ Official **Python SDK** for integrating **Payra's on-chain payment system** into
 
 This SDK provides:
 - Secure generation of **ECDSA signatures** compatible with the Payra smart contract, used for order payment verification.
-- Simple methods for **checking the on-chain status of orders** to confirm completed payments.
-
+- Simple methods for **checking the on-chain details of orders** to confirm completed payments.
 
 ## How It Works
 
@@ -48,20 +47,18 @@ The typical flow for signing and verifying a Payra transaction:
 
 This process ensures full compatibility between your backend and Payra’s on-chain verification logic.
 
-
 ## Features
 
 - Generates **Ethereum ECDSA signatures** using the `secp256k1` curve.
 - Fully compatible with **Payra's Solidity smart contracts** (`ERC-1155` payment verification).
 - Supports `.env` and `config/payra.php` configuration for multiple blockchain networks.
 - Laravel IoC container integration (easy dependency injection)
-- Verifies **order payment status directly on-chain** via RPC or blockchain explorer API.
+- Verifies **order payment details directly on-chain** via RPC or blockchain explorer API.
 - Provides **secure backend integration** for signing and verifying transactions.
 - Includes optional utility helpers for:
 -  **Currency conversion** (via [ExchangeRate API](https://www.exchangerate-api.com/))
 -  **USD ⇄ WEI** conversion for token precision handling.
 
-
 ## Setup
 
 Before installing this package, make sure you have an active **Payra** account:
@@ -87,7 +84,6 @@ To obtain your **RPC URLs** which are required for reading on-chain order status
 Optional (recommended):
 - Create a free API key at [ExchangeRate API](https://www.exchangerate-api.com/) to enable **automatic fiat → USD conversions** using the built-in utility helpers.
 
-
 ## Installation
 
 ### From PyPI
@@ -129,7 +125,6 @@ cp  .env.example  .env
 
 This file stores your **private configuration** and connection settings for all supported networks. Never commit `.env` to version control.
 
-
 ### Required Variables
 
 #### Exchange Rate (optional)
@@ -164,9 +159,9 @@ PAYRA_LINEA_RPC_URL_2=
 
 - The cache automatically refreshes when it expires.
 - You can adjust the cache duration by setting `PAYRA_EXCHANGE_RATE_CACHE_TIME`:
--  `5` → cache for 5 minutes
--  `60` → cache for 1 hour
--  `720` → cache for 12 hours (default)
+	-  `5` → cache for 5 minutes
+	-  `60` → cache for 1 hour
+	-  `720` → cache for 12 hours (default)
 - Each network (Polygon, Ethereum, Linea) has its own **merchant ID**, **signature key**, and **RPC URLs**.
 - The SDK automatically detects which chain configuration to use based on the selected network.
 - You can use multiple RPC URLs for redundancy (the SDK will automatically fall back if one fails).
@@ -175,10 +170,10 @@ PAYRA_LINEA_RPC_URL_2=
 
 ## Usage Example
 
-### Generating and verifying a Payra signature in your backend
+### Generating signature
 
 ```python
-from payra_sdk import PayraUtils, PayraSignatureGenerator, PayraSDKException
+from payra_sdk import PayraUtils, PayraSignature, PayraSDKException
 
 try:
 	# Convert amount to smallest unit (wei or token decimals
@@ -187,17 +182,17 @@ try:
 	PAYMENT_DATA = {
 		"network": "polygon",
 		"tokenAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", # USDT on Polygon
-		"orderId": "ORDER-1753824905006-301-322",
+		"orderId": "ord-258",
 		"amountWei": amount_wei, # e.g. 3.34 USDT in smallest unit
 		"timestamp": 1753826059, # current Unix timestamp
 		"payerAddress": "0xe6c961D6ad9a27Ea8e5d99e40abaC365DE9Cc162"
 	}
 	
 	# Initialize signer
-	payra_signer = PayraSignatureGenerator()
+	payra_signature = PayraSignature()
 	
 	# Generate cryptographic signature
-	signature = payra_signer.generate_signature(
+	signature = payra_signature.generate(
 		network=PAYMENT_DATA["network"],
 		token_address=PAYMENT_DATA["tokenAddress"],
 		order_id=PAYMENT_DATA["orderId"],
@@ -227,13 +222,13 @@ except  Exception  as e:
 #### Behind the Scenes
 
 1. The backend converts the amount to the smallest blockchain unit (e.g. wei).
-2. A `PayraSignatureGenerator` instance is created using your signature key from `.env`
+2. A `PayraSignature` instance is created using your signature key from `.env`
 3. It generates an ECDSA signature that is fully verifiable on-chain by the Payra smart contract.
 4. The resulting signature should be sent to the **frontend**, which must call `payOrder(...)` using the same parameters (`timestamp`, `orderId`, `amount`, `tokenAddress`, etc.) that were used to generate the signature.
 
 ---
 
-### Get Order Status
+### Get Order Details
 
 Retrieve **full payment details** for a specific order from the Payra smart contract. This method returns the complete on-chain payment data associated with the order, including:
 - whether the order has been paid,
@@ -245,19 +240,19 @@ Retrieve **full payment details** for a specific order from the Payra smart cont
 Use this method when you need **detailed information** about the payment or want to display full transaction data.
 
 ```python
-from payra_sdk import PayraOrderVerification, PayraSDKException
+from payra_sdk import PayraOrderService, PayraSDKException
 
 try:
 	ORDER_ID = "ord-258"
 	# Initialize verifier for a specific network
-	verifier = PayraOrderVerification("polygon")
+	order_service = PayraOrderService("polygon")
 	
-	print("\nGet order status...")
-	result = verifier.get_order_status(ORDER_ID)
+	print("\nGet order details...")
+	details = order_service.get_details(ORDER_ID)
 	
 	print("Order ID:", ORDER_ID)
-	print("Result:", result)
-	
+	print("Details:", details)
+	        
 except PayraSDKException as e:
 	print(f"Payra SDK error: {e}")
 except  Exception  as e:
@@ -266,15 +261,15 @@ except  Exception  as e:
 
 #### Behind the Scenes
 
-1. The backend initializes a `PayraOrderVerification` object for the desired blockchain network.
-2. It calls `get_order_status(order_id)` to check if the order transaction exists and is confirmed on-chain.
+1. The backend initializes a `PayraOrderService` object for the desired blockchain network.
+2. It calls `get_details(order_id)` to get transaction details from blockchain.
 3. The function returns a dictionary with:
 
 ```python
 {
 	"success": True,
 	"paid": True,
-	"error": None.
+	"error": None,
 	"toke": '0xc2132d05d31c914a87c6611c10748aeb04b58e8f',
 	"amount": 400000,
 	"fee": 3600,
@@ -291,16 +286,16 @@ Perform a **simple payment check** for a specific order. This method only verifi
 Use this method when you only need a **quick boolean confirmation** of the payment status.
 
 ```python
-from payra_sdk import PayraOrderVerification, PayraSDKException
+from payra_sdk import PayraOrderService, PayraSDKException
 
 try:
 	ORDER_ID = "ord-258"
 
 	# Initialize verifier for a specific network
-	verifier = PayraOrderVerification("polygon")
+	order_service = PayraOrderService("polygon")
 
 	print("\nChecking order status...")
-	result = verifier.is_order_paid(ORDER_ID)
+	result = order_service.is_paid(ORDER_ID)
 
 	print("Order ID:", ORDER_ID)
 	print("Result:", result)
@@ -320,8 +315,8 @@ except  Exception  as e:
 
 #### Behind the Scenes
 
-1. The backend initializes a `PayraOrderVerification` object for the desired blockchain network.
-2. It calls `is_order_paid(order_id)` to check if the order transaction exists and is confirmed on-chain.
+1. The backend initializes a `PayraOrderService` object for the desired blockchain network.
+2. It calls `is_paid(order_id)` to check if the order transaction exists and is confirmed on-chain.
 3. The function returns a dictionary with:
 ```python
 {
@@ -365,25 +360,23 @@ print(f"100 EUR = {usd_value} USD")
 -  `get_decimals(network, token)` – Returns the number of decimals for the given token on that network.
 -  `convert_to_usd(amount, currency)` – Converts fiat amounts (e.g. EUR, GBP) to USD using your ExchangeRate API key.
 
-
 ## Testing
 
 You can run the included `examples` to test signing and verification:
 
 ```python
 python3 example_signature.py
-python3 example_order_verification.py
+python3 example_order_get_details.py
+python3 example_order_is_paid.py
 python3 example_utils.py
 ```
 
 Make sure your `.env` file contains correct values for the `network` being used.
 
-### Tips
-
-- Always verify your `.env` configuration before running any signing or on-chain verification examples.
-- The SDK examples are safe to run, they use **read-only RPC calls** (no real transactions are broadcast).
-- You can modify `example_signature.py` to test custom token addresses or order parameters.
+## Security Notice
 
+Never expose your signature key in frontend or client-side code.  
+This SDK is  **server-side only**  and must be used securely on your backend. Never use it in frontend or browser environments. Also, never commit your `.env`  file to version control.
 
 ## Projects
 
@@ -398,7 +391,6 @@ Make sure your `.env` file contains correct values for the `network` being used.
 - [https://payra.xyz](https://payra.xyz)
 - [https://payra.eth](https://payra.eth.limo) - suporrted by Brave and Opera Browser or .limo
 
-
 ## Social Media
 
 - [Telegram Payra Group](https://t.me/+GhTyJJrd4SMyMDA0)
@@ -407,4 +399,5 @@ Make sure your `.env` file contains correct values for the `network` being used.
 - [Dev.to](https://dev.to/payracash)
 
 ## License
+
 MIT © [Payra](https://payra.cash)

{payra_sdk-1.2.6 → payra_sdk-1.2.8}/payra_sdk.egg-info/SOURCES.txt

@@ -6,7 +6,7 @@ pyproject.toml
 setup.cfg
 payra_sdk/__init__.py
 payra_sdk/exceptions.py
-payra_sdk/order_verification.py
+payra_sdk/order_service.py
 payra_sdk/signature.py
 payra_sdk/utils.py
 payra_sdk.egg-info/PKG-INFO

{payra_sdk-1.2.6 → payra_sdk-1.2.8}/pyproject.toml

@@ -2,7 +2,7 @@
 
 [project]
 name = "payra_sdk"
-version = "1.2.6"
+version = "1.2.8"
 description = "Python SDK for Payra payment signature generation (backend)"
 readme = "README.md"
 authors = [{ name = "Wraith", email = "support@payra.cash" }]