chipi-stack 2.0.0__tar.gz → 2.1.0__tar.gz

{chipi_stack-2.0.0/chipi_stack.egg-info → chipi_stack-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chipi-stack
-Version: 2.0.0
+Version: 2.1.0
 Summary: Python SDK for Starknet Gasless Transactions via Chipi
 Author-email: Carlos Castillo <carlos@chipipay.com>, Roberto Yamanaka <roberto@chipipay.com>
 License-Expression: MIT
@@ -34,17 +34,18 @@ Requires-Dist: black>=24.0.0; extra == "dev"
 Requires-Dist: ruff>=0.3.0; extra == "dev"
 Requires-Dist: mypy>=1.8.0; extra == "dev"
 Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=5.0.0; extra == "dev"
 Dynamic: license-file
 
 # Chipi Python SDK
 
-[![PyPI version](https://badge.fury.io/py/chipi-python.svg)](https://badge.fury.io/py/chipi-python)
+[![PyPI version](https://badge.fury.io/py/chipi-stack.svg)](https://badge.fury.io/py/chipi-stack)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Python SDK for executing gasless transactions on Starknet via Chipi's paymaster infrastructure.
 
+> Published to PyPI as **`chipi-stack`** — matches the `@chipi-stack/*` npm scope. The legacy `chipi-python` package on PyPI is deprecated.
+
 ## Features
 
 - 🚀 **Gasless Transactions** - Execute transactions without paying gas fees
@@ -57,13 +58,13 @@ Python SDK for executing gasless transactions on Starknet via Chipi's paymaster
 ## Installation
 
 ```bash
-pip install chipi-python
+pip install chipi-stack
 ```
 
 Or with uv:
 
 ```bash
-uv add chipi-python
+uv add chipi-stack
 ```
 
 ### Requirements

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/README.md

@@ -1,11 +1,13 @@
 # Chipi Python SDK
 
-[![PyPI version](https://badge.fury.io/py/chipi-python.svg)](https://badge.fury.io/py/chipi-python)
+[![PyPI version](https://badge.fury.io/py/chipi-stack.svg)](https://badge.fury.io/py/chipi-stack)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Python SDK for executing gasless transactions on Starknet via Chipi's paymaster infrastructure.
 
+> Published to PyPI as **`chipi-stack`** — matches the `@chipi-stack/*` npm scope. The legacy `chipi-python` package on PyPI is deprecated.
+
 ## Features
 
 - 🚀 **Gasless Transactions** - Execute transactions without paying gas fees
@@ -18,13 +20,13 @@ Python SDK for executing gasless transactions on Starknet via Chipi's paymaster
 ## Installation
 
 ```bash
-pip install chipi-python
+pip install chipi-stack
 ```
 
 Or with uv:
 
 ```bash
-uv add chipi-python
+uv add chipi-stack
 ```
 
 ### Requirements

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/chipi_sdk/__init__.py

@@ -5,7 +5,7 @@ A Python SDK for interacting with Chipi's gasless transaction infrastructure on
 Supports wallet creation, transaction execution, session keys, and more.
 """
 
-__version__ = "2.0.0"
+__version__ = "2.1.0"
 
 # Main SDK class
 from .sdk import ChipiSDK
@@ -19,6 +19,7 @@ from .transactions import ChipiTransactions
 from .sessions import ChipiSessions
 from .skus import ChipiSkus
 from .sku_transactions import ChipiSkuTransactions
+from .sku_purchases import ChipiSkuPurchases
 from .users import ChipiUsers
 
 # Models - Core
@@ -26,6 +27,7 @@ from .models.core import (
     Chain,
     ChainToken,
     ChipiSDKConfig,
+    Currency,
     PaginatedResponse,
     PaginationQuery,
     StarknetContract,
@@ -103,6 +105,11 @@ from .models.sku_transaction import (
     SkuTransaction,
 )
 
+# Models - SKU Purchase (bill payments)
+from .models.sku_purchase import (
+    CreateSkuPurchaseParams,
+)
+
 # Models - User
 from .models.user import (
     CreateUserParams,
@@ -205,11 +212,13 @@ __all__ = [
     "ChipiSessions",
     "ChipiSkus",
     "ChipiSkuTransactions",
+    "ChipiSkuPurchases",
     "ChipiUsers",
     # Core models
     "Chain",
     "ChainToken",
     "ChipiSDKConfig",
+    "Currency",
     "PaginatedResponse",
     "PaginationQuery",
     "StarknetContract",
@@ -270,6 +279,8 @@ __all__ = [
     # SKU Transaction models
     "CreateSkuTransactionParams",
     "SkuTransaction",
+    # SKU Purchase models (bill payments)
+    "CreateSkuPurchaseParams",
     # User models
     "CreateUserParams",
     "GetUserParams",

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/chipi_sdk/constants.py

@@ -35,7 +35,8 @@ API_ENDPOINTS = {
     "CHIPI_WALLETS": "/chipi-wallets",
     "TRANSACTIONS": "/transactions",
     "SKUS": "/skus",
-    "SKU_TRANSACTIONS": "/sku-transactions",
+    "SKU_PURCHASES": "/sku-purchases",
+    "SKU_TRANSACTIONS": "/sku-transactions",  # legacy / deprecated — see purchase_sku
     "EXCHANGES": "/exchanges",
     "USERS": "/users",
 }

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/chipi_sdk/models/core.py

@@ -22,6 +22,12 @@ class ChainToken(str, Enum):
     OTHER = "OTHER"
 
 
+class Currency(str, Enum):
+    """Local currencies supported by Chipi services (e.g. SKU purchases)."""
+    MXN = "MXN"
+    USD = "USD"
+
+
 class ChipiSDKConfig(BaseModel):
     """Configuration for initializing the Chipi SDK."""
     

chipi_stack-2.1.0/chipi_sdk/models/sku_purchase.py

@@ -0,0 +1,40 @@
+"""Bill payment / SKU purchase types — mirrors @chipi-stack/types CreateSkuPurchaseParams."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .core import Chain, ChainToken, Currency
+from .wallet import WalletData, to_camel
+
+
+class CreateSkuPurchaseParams(BaseModel):
+    """
+    Parameters for charging a user's gasless wallet for a SKU (bill payment,
+    gift card, etc.). Mirrors @chipi-stack/types CreateSkuPurchaseParams; the
+    backend endpoint is POST /sku-purchases.
+    """
+
+    model_config = ConfigDict(populate_by_name=True, alias_generator=to_camel)
+
+    sku_id: str = Field(..., description="SKU identifier from getSkuList / getSku")
+    sku_reference: str = Field(
+        ...,
+        description=(
+            "User-facing reference required by the SKU (e.g. phone number for a "
+            "phone recharge, account number for a utility bill). Validated "
+            "server-side against the SKU's referenceRegexValidation."
+        ),
+    )
+    currency_amount: float = Field(
+        ...,
+        gt=0,
+        description="Amount in the SKU's local currency (e.g. 200 for $200 MXN). Must be > 0.",
+    )
+    currency: Currency = Field(..., description="Local currency of currency_amount.")
+    chain: Chain = Field(..., description="Settlement chain (currently STARKNET).")
+    token: ChainToken = Field(
+        ..., description="Token used to pay (typically USDC)."
+    )
+    encrypt_key: str = Field(..., description="User PIN that decrypts the wallet.")
+    wallet: WalletData = Field(
+        ..., description="The user's gasless wallet (publicKey + encryptedPrivateKey)."
+    )

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/chipi_sdk/sdk.py

@@ -32,6 +32,7 @@ from .models.wallet import (
 from .models.session import ExecuteWithSessionParams
 from .models.sku import Sku, GetSkuListQuery
 from .models.sku_transaction import CreateSkuTransactionParams, SkuTransaction
+from .models.sku_purchase import CreateSkuPurchaseParams
 from .models.user import User, CreateUserParams, GetUserParams
 from .client import ChipiClient
 from .wallets import ChipiWallets
@@ -39,6 +40,7 @@ from .transactions import ChipiTransactions
 from .sessions import ChipiSessions
 from .skus import ChipiSkus
 from .sku_transactions import ChipiSkuTransactions
+from .sku_purchases import ChipiSkuPurchases
 from .users import ChipiUsers
 from .formatters import format_amount
 from .constants import STARKNET_NETWORKS, CONTRACT_ADDRESSES
@@ -64,6 +66,7 @@ class ChipiSDK:
         self.sessions = ChipiSessions(self.client)
         self.skus = ChipiSkus(self.client)
         self.sku_transactions = ChipiSkuTransactions(self.client)
+        self.sku_purchases = ChipiSkuPurchases(self.client)
         self.users = ChipiUsers(self.client)
 
     def _resolve_bearer_token(self, bearer_token: Optional[str] = None) -> str:
@@ -938,6 +941,62 @@ class ChipiSDK:
             bearer_token=self._resolve_bearer_token(bearer_token),
         )
 
+    # ===== SKU Purchase (Bill payments) =====
+
+    async def apurchase_sku(
+        self,
+        params: CreateSkuPurchaseParams,
+        bearer_token: Optional[str] = None,
+    ) -> Transaction:
+        """
+        Charge a gasless wallet for a SKU (bill payment, gift card, ...) — async.
+
+        Posts to the public POST /sku-purchases endpoint. Mirrors
+        ChipiServerSDK.purchaseSku in the Node SDK.
+        """
+        return await self.sku_purchases.apurchase_sku(
+            params=params,
+            bearer_token=self._resolve_bearer_token(bearer_token),
+        )
+
+    def purchase_sku(
+        self,
+        params: CreateSkuPurchaseParams,
+        bearer_token: Optional[str] = None,
+    ) -> Transaction:
+        """
+        Charge a gasless wallet for a SKU (bill payment, gift card, ...) — sync.
+
+        Posts to the public POST /sku-purchases endpoint. Mirrors
+        ChipiServerSDK.purchaseSku in the Node SDK.
+        """
+        return self.sku_purchases.purchase_sku(
+            params=params,
+            bearer_token=self._resolve_bearer_token(bearer_token),
+        )
+
+    async def aget_sku_purchase(
+        self,
+        purchase_id: str,
+        bearer_token: Optional[str] = None,
+    ) -> Transaction:
+        """Get a SKU purchase by id (async). Use to poll for SUCCESS / FAILED."""
+        return await self.sku_purchases.aget_sku_purchase(
+            purchase_id=purchase_id,
+            bearer_token=self._resolve_bearer_token(bearer_token),
+        )
+
+    def get_sku_purchase(
+        self,
+        purchase_id: str,
+        bearer_token: Optional[str] = None,
+    ) -> Transaction:
+        """Get a SKU purchase by id (sync). Use to poll for SUCCESS / FAILED."""
+        return self.sku_purchases.get_sku_purchase(
+            purchase_id=purchase_id,
+            bearer_token=self._resolve_bearer_token(bearer_token),
+        )
+
     # ===== User Methods =====
 
     async def aget_user(

chipi_stack-2.1.0/chipi_sdk/sku_purchases.py

@@ -0,0 +1,98 @@
+"""SKU purchase service — bill payments, gift cards, etc."""
+
+from .client import ChipiClient
+from .constants import API_ENDPOINTS
+from .models.sku_purchase import CreateSkuPurchaseParams
+from .models.transaction import Transaction
+
+
+class ChipiSkuPurchases:
+    """SKU purchase / bill payment service."""
+
+    def __init__(self, client: ChipiClient):
+        """
+        Initialize SKU purchase manager.
+
+        Args:
+            client: Chipi HTTP client
+        """
+        self.client = client
+
+    async def apurchase_sku(
+        self, params: CreateSkuPurchaseParams, bearer_token: str
+    ) -> Transaction:
+        """
+        Charge a gasless wallet for a SKU (bill payment, gift card, etc.) — async.
+
+        Args:
+            params: Purchase parameters (skuId, skuReference, amount, wallet, ...)
+            bearer_token: Authentication token
+
+        Returns:
+            Transaction record (poll via aget_sku_purchase / get_sku_purchase
+            for SUCCESS / FAILED status).
+        """
+        response = await self.client.apost(
+            endpoint=API_ENDPOINTS["SKU_PURCHASES"],
+            bearer_token=bearer_token,
+            body=params.model_dump(by_alias=True),
+        )
+        return Transaction(**response)
+
+    def purchase_sku(
+        self, params: CreateSkuPurchaseParams, bearer_token: str
+    ) -> Transaction:
+        """
+        Charge a gasless wallet for a SKU (bill payment, gift card, etc.) — sync.
+
+        Args:
+            params: Purchase parameters (skuId, skuReference, amount, wallet, ...)
+            bearer_token: Authentication token
+
+        Returns:
+            Transaction record (poll via get_sku_purchase for SUCCESS / FAILED status).
+        """
+        response = self.client.post(
+            endpoint=API_ENDPOINTS["SKU_PURCHASES"],
+            bearer_token=bearer_token,
+            body=params.model_dump(by_alias=True),
+        )
+        return Transaction(**response)
+
+    async def aget_sku_purchase(
+        self, purchase_id: str, bearer_token: str
+    ) -> Transaction:
+        """
+        Get a SKU purchase by id (async). Use for polling settlement status.
+
+        Args:
+            purchase_id: Purchase id from purchase_sku response
+            bearer_token: Authentication token
+
+        Returns:
+            Transaction record with current status.
+        """
+        response = await self.client.aget(
+            endpoint=f"{API_ENDPOINTS['SKU_PURCHASES']}/{purchase_id}",
+            bearer_token=bearer_token,
+        )
+        return Transaction(**response)
+
+    def get_sku_purchase(
+        self, purchase_id: str, bearer_token: str
+    ) -> Transaction:
+        """
+        Get a SKU purchase by id (sync). Use for polling settlement status.
+
+        Args:
+            purchase_id: Purchase id from purchase_sku response
+            bearer_token: Authentication token
+
+        Returns:
+            Transaction record with current status.
+        """
+        response = self.client.get(
+            endpoint=f"{API_ENDPOINTS['SKU_PURCHASES']}/{purchase_id}",
+            bearer_token=bearer_token,
+        )
+        return Transaction(**response)

{chipi_stack-2.0.0 → chipi_stack-2.1.0/chipi_stack.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chipi-stack
-Version: 2.0.0
+Version: 2.1.0
 Summary: Python SDK for Starknet Gasless Transactions via Chipi
 Author-email: Carlos Castillo <carlos@chipipay.com>, Roberto Yamanaka <roberto@chipipay.com>
 License-Expression: MIT
@@ -34,17 +34,18 @@ Requires-Dist: black>=24.0.0; extra == "dev"
 Requires-Dist: ruff>=0.3.0; extra == "dev"
 Requires-Dist: mypy>=1.8.0; extra == "dev"
 Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=5.0.0; extra == "dev"
 Dynamic: license-file
 
 # Chipi Python SDK
 
-[![PyPI version](https://badge.fury.io/py/chipi-python.svg)](https://badge.fury.io/py/chipi-python)
+[![PyPI version](https://badge.fury.io/py/chipi-stack.svg)](https://badge.fury.io/py/chipi-stack)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Python SDK for executing gasless transactions on Starknet via Chipi's paymaster infrastructure.
 
+> Published to PyPI as **`chipi-stack`** — matches the `@chipi-stack/*` npm scope. The legacy `chipi-python` package on PyPI is deprecated.
+
 ## Features
 
 - 🚀 **Gasless Transactions** - Execute transactions without paying gas fees
@@ -57,13 +58,13 @@ Python SDK for executing gasless transactions on Starknet via Chipi's paymaster
 ## Installation
 
 ```bash
-pip install chipi-python
+pip install chipi-stack
 ```
 
 Or with uv:
 
 ```bash
-uv add chipi-python
+uv add chipi-stack
 ```
 
 ### Requirements

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/chipi_stack.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ chipi_sdk/formatters.py
 chipi_sdk/py.typed
 chipi_sdk/sdk.py
 chipi_sdk/sessions.py
+chipi_sdk/sku_purchases.py
 chipi_sdk/sku_transactions.py
 chipi_sdk/skus.py
 chipi_sdk/transactions.py
@@ -26,6 +27,7 @@ chipi_sdk/models/__init__.py
 chipi_sdk/models/core.py
 chipi_sdk/models/session.py
 chipi_sdk/models/sku.py
+chipi_sdk/models/sku_purchase.py
 chipi_sdk/models/sku_transaction.py
 chipi_sdk/models/transaction.py
 chipi_sdk/models/user.py

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/chipi_stack.egg-info/requires.txt

@@ -13,4 +13,3 @@ black>=24.0.0
 ruff>=0.3.0
 mypy>=1.8.0
 build>=1.0.0
-twine>=5.0.0

{chipi_stack-2.0.0 → chipi_stack-2.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "chipi-stack"
-version = "2.0.0"
+version = "2.1.0"
 description = "Python SDK for Starknet Gasless Transactions via Chipi"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -43,7 +43,6 @@ dev = [
     "ruff>=0.3.0",
     "mypy>=1.8.0",
     "build>=1.0.0",
-    "twine>=5.0.0",
 ]
 
 [project.urls]