chainstream-sdk 0.1.0__tar.gz

chainstream_sdk-0.1.0/.gitignore

@@ -0,0 +1,91 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.pytest_cache/
+.coverage
+htmlcov/
+.env
+.venv
+venv/
+ENV/
+**/.openapi-generator-ignore
+**/.openapi-generator/
+
+# Sphinx
+_build
+_static
+_templates
+
+
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.env
+.env.test
+.env.production
+coverage/
+dist/
+build/
+.next
+out/
+.DS_Store
+*.pem
+.vercel
+.turbo
+_cjs
+_esm
+_types
+
+# TypeScript
+*.tsbuildinfo
+typescript/docs
+typescript/docs-md
+
+# Go
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+go.work
+vendor/
+go/docs
+
+# OpenAPI
+openapi-preprocessed.yaml
+openapi_preprocessed.yaml
+
+# IDE / OS
+.idea/
+.vscode/
+.*.sw?
+.DS_Store
+
+# Build Output
+target/
+
+# Env files
+**/.env

chainstream_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: chainstream-sdk
+Version: 0.1.0
+Summary: ChainStream SDK - API client for ChainStream
+Author: ChainStream
+License: MIT
+Keywords: api,blockchain,chainstream,defi,dex,sdk
+Requires-Python: >=3.10
+Requires-Dist: aiohttp-retry>=2.9.1
+Requires-Dist: aiohttp>=3.11.16
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: pydantic>=2.10.3
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: python-dateutil>=2.9.0
+Requires-Dist: urllib3>=2.2.3
+Provides-Extra: dev
+Requires-Dist: myst-parser>=4.0.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.26.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: python-dotenv>=1.0.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
+Requires-Dist: ruff<0.8,>=0.7.1; extra == 'dev'
+Requires-Dist: sphinx-autobuild>=2024.10.3; extra == 'dev'
+Requires-Dist: sphinx-autodoc-typehints>=3.0.1; extra == 'dev'
+Requires-Dist: sphinx>=8.1.3; extra == 'dev'
+Requires-Dist: sphinxcontrib-napoleon>=0.7; extra == 'dev'
+Requires-Dist: towncrier<25,>=24.8.0; extra == 'dev'
+Provides-Extra: wallet
+Requires-Dist: base58>=2.1.1; extra == 'wallet'
+Requires-Dist: nest-asyncio<2,>=1.6.0; extra == 'wallet'
+Requires-Dist: solana>=0.36.6; extra == 'wallet'
+Requires-Dist: solders>=0.26.0; extra == 'wallet'
+Requires-Dist: web3<=7.10.0,>=7.6.0; extra == 'wallet'
+Description-Content-Type: text/markdown
+
+# ChainStream Python SDK
+
+Official Python client library for ChainStream API.
+
+## Installation
+
+```bash
+pip install chainstream-sdk
+```
+
+## Quick Start
+
+```python
+from chainstream import ChainStreamClient
+
+# Create client
+client = ChainStreamClient(access_token="your-access-token")
+
+# Use the client for API calls...
+```
+
+## Documentation
+
+For detailed documentation, visit [https://docs.chainstream.io](https://docs.chainstream.io)
+
+## Development
+
+```bash
+# Install dependencies
+make install
+
+# Run tests
+make test
+
+# Lint
+make lint
+
+# Generate OpenAPI client
+make python-client
+```
+
+## License
+
+MIT

chainstream_sdk-0.1.0/README.md

@@ -0,0 +1,44 @@
+# ChainStream Python SDK
+
+Official Python client library for ChainStream API.
+
+## Installation
+
+```bash
+pip install chainstream-sdk
+```
+
+## Quick Start
+
+```python
+from chainstream import ChainStreamClient
+
+# Create client
+client = ChainStreamClient(access_token="your-access-token")
+
+# Use the client for API calls...
+```
+
+## Documentation
+
+For detailed documentation, visit [https://docs.chainstream.io](https://docs.chainstream.io)
+
+## Development
+
+```bash
+# Install dependencies
+make install
+
+# Run tests
+make test
+
+# Lint
+make lint
+
+# Generate OpenAPI client
+make python-client
+```
+
+## License
+
+MIT

chainstream_sdk-0.1.0/chainstream/__init__.py

@@ -0,0 +1,46 @@
+"""ChainStream SDK - API client for ChainStream.
+
+Example:
+    ```python
+    import asyncio
+    from chainstream import ChainStreamClient
+    from chainstream.stream import Resolution, TokenCandle
+
+    async def main():
+        client = ChainStreamClient("your-access-token")
+
+        # Subscribe to token candles
+        unsub = await client.stream.subscribe_token_candles(
+            chain="sol",
+            token_address="So11111111111111111111111111111111111111112",
+            resolution=Resolution.S1,
+            callback=lambda candle: print(f"Candle: {candle}"),
+        )
+
+        await asyncio.sleep(30)
+        await client.close()
+
+    asyncio.run(main())
+    ```
+"""
+
+from chainstream.client import (
+    CHAINSTREAM_BASE_URL,
+    CHAINSTREAM_STREAM_URL,
+    ChainStreamClient,
+    ChainStreamClientOptions,
+    StaticTokenProvider,
+    TokenProvider,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "ChainStreamClient",
+    "ChainStreamClientOptions",
+    "TokenProvider",
+    "StaticTokenProvider",
+    "CHAINSTREAM_BASE_URL",
+    "CHAINSTREAM_STREAM_URL",
+]
+

chainstream_sdk-0.1.0/chainstream/client.py

@@ -0,0 +1,104 @@
+"""ChainStream SDK Client."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Callable, Optional, Protocol
+
+from chainstream.stream.client import StreamApi
+
+# Default URLs
+CHAINSTREAM_BASE_URL = "https://api-dex.chainstream.io"
+CHAINSTREAM_STREAM_URL = "wss://realtime-dex.chainstream.io/connection/websocket"
+
+
+class TokenProvider(Protocol):
+    """Protocol for providing access tokens."""
+
+    def get_token(self) -> str:
+        """Get the current access token."""
+        ...
+
+
+@dataclass
+class StaticTokenProvider:
+    """A simple token provider that returns a static token."""
+
+    token: str
+
+    def get_token(self) -> str:
+        """Get the static token."""
+        return self.token
+
+
+@dataclass
+class ChainStreamClientOptions:
+    """Options for ChainStreamClient configuration."""
+
+    base_url: str = CHAINSTREAM_BASE_URL
+    stream_url: str = CHAINSTREAM_STREAM_URL
+
+
+class ChainStreamClient:
+    """ChainStream SDK Client for accessing both REST API and WebSocket streams.
+
+    Example:
+        ```python
+        import asyncio
+        from chainstream import ChainStreamClient
+        from chainstream.stream import Resolution, TokenCandle
+
+        async def main():
+            client = ChainStreamClient("your-access-token")
+
+            # Subscribe to token candles
+            unsub = await client.stream.subscribe_token_candles(
+                chain="sol",
+                token_address="So11111111111111111111111111111111111111112",
+                resolution=Resolution.S1,
+                callback=lambda candle: print(f"Candle: {candle}"),
+            )
+
+            # Wait for some data
+            await asyncio.sleep(30)
+
+            # Unsubscribe and close
+            unsub.unsubscribe()
+            await client.close()
+
+        asyncio.run(main())
+        ```
+    """
+
+    def __init__(
+        self,
+        access_token: str,
+        options: Optional[ChainStreamClientOptions] = None,
+        token_provider: Optional[TokenProvider] = None,
+    ) -> None:
+        """Initialize the ChainStreamClient.
+
+        Args:
+            access_token: The access token for authentication.
+            options: Optional configuration options.
+            token_provider: Optional custom token provider.
+        """
+        self._options = options or ChainStreamClientOptions()
+        self._token_provider = token_provider or StaticTokenProvider(access_token)
+        self._access_token = access_token
+
+        # Initialize stream API
+        self._stream = StreamApi(self._options.stream_url, access_token)
+
+    @property
+    def stream(self) -> StreamApi:
+        """Get the stream API client."""
+        return self._stream
+
+    def get_access_token(self) -> str:
+        """Get the current access token."""
+        return self._token_provider.get_token()
+
+    async def close(self) -> None:
+        """Close all connections."""
+        await self._stream.disconnect()

chainstream_sdk-0.1.0/chainstream/openapi_client/__init__.py

@@ -0,0 +1,156 @@
+# coding: utf-8
+
+# flake8: noqa
+
+"""
+    Dex Aggregator API
+
+    Dex Aggregator API ⚡️
+
+    The version of the OpenAPI document: 1.0
+    Contact: ai@sx.ai
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+__version__ = "1.0.0"
+
+# import apis into sdk package
+from chainstream.openapi_client.api.blockchain_api import BlockchainApi
+from chainstream.openapi_client.api.defi_sol_moonshot_api import DefiSolMoonshotApi
+from chainstream.openapi_client.api.defi_sol_pumpfun_api import DefiSolPumpfunApi
+from chainstream.openapi_client.api.dex_api import DexApi
+from chainstream.openapi_client.api.dex_pool_api import DexPoolApi
+from chainstream.openapi_client.api.endpoint_api import EndpointApi
+from chainstream.openapi_client.api.ipfs_api import IpfsApi
+from chainstream.openapi_client.api.jobs_api import JobsApi
+from chainstream.openapi_client.api.kyt_api import KYTApi
+from chainstream.openapi_client.api.ranking_api import RankingApi
+from chainstream.openapi_client.api.red_packet_api import RedPacketApi
+from chainstream.openapi_client.api.token_api import TokenApi
+from chainstream.openapi_client.api.trade_api import TradeApi
+from chainstream.openapi_client.api.transaction_api import TransactionApi
+from chainstream.openapi_client.api.wallet_api import WalletApi
+from chainstream.openapi_client.api.watchlist_api import WatchlistApi
+
+# import ApiClient
+from chainstream.openapi_client.api_response import ApiResponse
+from chainstream.openapi_client.api_client import ApiClient
+from chainstream.openapi_client.configuration import Configuration
+from chainstream.openapi_client.exceptions import OpenApiException
+from chainstream.openapi_client.exceptions import ApiTypeError
+from chainstream.openapi_client.exceptions import ApiValueError
+from chainstream.openapi_client.exceptions import ApiKeyError
+from chainstream.openapi_client.exceptions import ApiAttributeError
+from chainstream.openapi_client.exceptions import ApiException
+
+# import models into sdk package
+from chainstream.openapi_client.models.address_exposure import AddressExposure
+from chainstream.openapi_client.models.address_risk_response_dto import AddressRiskResponseDTO
+from chainstream.openapi_client.models.alert_detail import AlertDetail
+from chainstream.openapi_client.models.alterya_identification import AlteryaIdentification
+from chainstream.openapi_client.models.balance_change_type import BalanceChangeType
+from chainstream.openapi_client.models.balance_token_type import BalanceTokenType
+from chainstream.openapi_client.models.balance_update_dto import BalanceUpdateDTO
+from chainstream.openapi_client.models.balance_update_page import BalanceUpdatePage
+from chainstream.openapi_client.models.blockchain_dto import BlockchainDTO
+from chainstream.openapi_client.models.blockchain_latest_block_dto import BlockchainLatestBlockDTO
+from chainstream.openapi_client.models.boolean_result_dto import BooleanResultDTO
+from chainstream.openapi_client.models.calculate_pnl_input import CalculatePnlInput
+from chainstream.openapi_client.models.candle import Candle
+from chainstream.openapi_client.models.chain import Chain
+from chainstream.openapi_client.models.chain_symbol import ChainSymbol
+from chainstream.openapi_client.models.chainalysis_address_identification import ChainalysisAddressIdentification
+from chainstream.openapi_client.models.claim_red_packet_input import ClaimRedPacketInput
+from chainstream.openapi_client.models.create_endpoint_input import CreateEndpointInput
+from chainstream.openapi_client.models.create_red_packet_input import CreateRedPacketInput
+from chainstream.openapi_client.models.create_red_packet_reply import CreateRedPacketReply
+from chainstream.openapi_client.models.create_token_input import CreateTokenInput
+from chainstream.openapi_client.models.create_token_reply import CreateTokenReply
+from chainstream.openapi_client.models.dev_token_dto import DevTokenDTO
+from chainstream.openapi_client.models.dex_dto import DexDTO
+from chainstream.openapi_client.models.dex_page import DexPage
+from chainstream.openapi_client.models.dex_pool_dto import DexPoolDTO
+from chainstream.openapi_client.models.dex_pool_snapshot_dto import DexPoolSnapshotDTO
+from chainstream.openapi_client.models.dex_pool_snapshot_page import DexPoolSnapshotPage
+from chainstream.openapi_client.models.dex_pool_token_liquidity import DexPoolTokenLiquidity
+from chainstream.openapi_client.models.dex_pool_token_snapshot_dto import DexPoolTokenSnapshotDTO
+from chainstream.openapi_client.models.dex_quote_response import DexQuoteResponse
+from chainstream.openapi_client.models.direct_exposure_detail import DirectExposureDetail
+from chainstream.openapi_client.models.endpoint_list_response import EndpointListResponse
+from chainstream.openapi_client.models.endpoint_operation_response import EndpointOperationResponse
+from chainstream.openapi_client.models.endpoint_response import EndpointResponse
+from chainstream.openapi_client.models.endpoint_secret_response import EndpointSecretResponse
+from chainstream.openapi_client.models.estimate_gas_limit_input import EstimateGasLimitInput
+from chainstream.openapi_client.models.estimate_gas_limit_response import EstimateGasLimitResponse
+from chainstream.openapi_client.models.filter_condition import FilterCondition
+from chainstream.openapi_client.models.gas_price_response import GasPriceResponse
+from chainstream.openapi_client.models.job_dto import JobDTO
+from chainstream.openapi_client.models.job_streaming_dto import JobStreamingDTO
+from chainstream.openapi_client.models.kyt_register_transfer_request import KYTRegisterTransferRequest
+from chainstream.openapi_client.models.kyt_register_withdrawal_request import KYTRegisterWithdrawalRequest
+from chainstream.openapi_client.models.link import Link
+from chainstream.openapi_client.models.moonshot_create_token_input import MoonshotCreateTokenInput
+from chainstream.openapi_client.models.moonshot_create_token_reply import MoonshotCreateTokenReply
+from chainstream.openapi_client.models.moonshot_submit_create_token200_response import MoonshotSubmitCreateToken200Response
+from chainstream.openapi_client.models.moonshot_submit_create_token_input import MoonshotSubmitCreateTokenInput
+from chainstream.openapi_client.models.network_identification_org import NetworkIdentificationOrg
+from chainstream.openapi_client.models.on_chain_activity import OnChainActivity
+from chainstream.openapi_client.models.pump_create_token_input import PumpCreateTokenInput
+from chainstream.openapi_client.models.pump_create_token_reply import PumpCreateTokenReply
+from chainstream.openapi_client.models.red_packet_claim_dto import RedPacketClaimDTO
+from chainstream.openapi_client.models.red_packet_claims_page import RedPacketClaimsPage
+from chainstream.openapi_client.models.red_packet_dto import RedPacketDTO
+from chainstream.openapi_client.models.red_packet_reply import RedPacketReply
+from chainstream.openapi_client.models.red_packet_send_tx_input import RedPacketSendTxInput
+from chainstream.openapi_client.models.red_packet_send_tx_response import RedPacketSendTxResponse
+from chainstream.openapi_client.models.red_packets_page import RedPacketsPage
+from chainstream.openapi_client.models.register_address_request import RegisterAddressRequest
+from chainstream.openapi_client.models.register_address_response_dto import RegisterAddressResponseDTO
+from chainstream.openapi_client.models.resolution import Resolution
+from chainstream.openapi_client.models.send_tx_input import SendTxInput
+from chainstream.openapi_client.models.send_tx_response import SendTxResponse
+from chainstream.openapi_client.models.swap_input import SwapInput
+from chainstream.openapi_client.models.swap_reply import SwapReply
+from chainstream.openapi_client.models.swap_route_input import SwapRouteInput
+from chainstream.openapi_client.models.swap_route_response import SwapRouteResponse
+from chainstream.openapi_client.models.token import Token
+from chainstream.openapi_client.models.token_creation_dto import TokenCreationDTO
+from chainstream.openapi_client.models.token_creation_page import TokenCreationPage
+from chainstream.openapi_client.models.token_creators_dto import TokenCreatorsDTO
+from chainstream.openapi_client.models.token_extra_dto import TokenExtraDTO
+from chainstream.openapi_client.models.token_holder import TokenHolder
+from chainstream.openapi_client.models.token_holder_page import TokenHolderPage
+from chainstream.openapi_client.models.token_liquidity_snapshot_dto import TokenLiquiditySnapshotDTO
+from chainstream.openapi_client.models.token_liquidity_snapshot_page import TokenLiquiditySnapshotPage
+from chainstream.openapi_client.models.token_list_page import TokenListPage
+from chainstream.openapi_client.models.token_market_data import TokenMarketData
+from chainstream.openapi_client.models.token_metadata import TokenMetadata
+from chainstream.openapi_client.models.token_page import TokenPage
+from chainstream.openapi_client.models.token_price_dto import TokenPriceDTO
+from chainstream.openapi_client.models.token_price_page import TokenPricePage
+from chainstream.openapi_client.models.token_social_medias_dto import TokenSocialMediasDTO
+from chainstream.openapi_client.models.token_stat import TokenStat
+from chainstream.openapi_client.models.token_trader import TokenTrader
+from chainstream.openapi_client.models.token_trader_tag import TokenTraderTag
+from chainstream.openapi_client.models.top_traders_dto import TopTradersDTO
+from chainstream.openapi_client.models.top_traders_page import TopTradersPage
+from chainstream.openapi_client.models.trade_detail_dto import TradeDetailDTO
+from chainstream.openapi_client.models.trade_event import TradeEvent
+from chainstream.openapi_client.models.trade_page import TradePage
+from chainstream.openapi_client.models.trade_type import TradeType
+from chainstream.openapi_client.models.transfer_alerts_response_dto import TransferAlertsResponseDTO
+from chainstream.openapi_client.models.transfer_base_response_dto import TransferBaseResponseDTO
+from chainstream.openapi_client.models.transfer_direct_exposure_response_dto import TransferDirectExposureResponseDTO
+from chainstream.openapi_client.models.transfer_network_identifications_response_dto import TransferNetworkIdentificationsResponseDTO
+from chainstream.openapi_client.models.update_endpoint_input import UpdateEndpointInput
+from chainstream.openapi_client.models.wallet_balance_detail_dto import WalletBalanceDetailDTO
+from chainstream.openapi_client.models.wallet_balances_dto import WalletBalancesDTO
+from chainstream.openapi_client.models.wallet_pnl_dto import WalletPnlDTO
+from chainstream.openapi_client.models.withdrawal_address_identifications_response_dto import WithdrawalAddressIdentificationsResponseDTO
+from chainstream.openapi_client.models.withdrawal_base_response_dto import WithdrawalBaseResponseDTO
+from chainstream.openapi_client.models.withdrawal_fraud_assessment_response_dto import WithdrawalFraudAssessmentResponseDTO
+
+

chainstream_sdk-0.1.0/chainstream/openapi_client/api/__init__.py

@@ -0,0 +1,20 @@
+# flake8: noqa
+
+# import apis into api package
+from chainstream.openapi_client.api.blockchain_api import BlockchainApi
+from chainstream.openapi_client.api.defi_sol_moonshot_api import DefiSolMoonshotApi
+from chainstream.openapi_client.api.defi_sol_pumpfun_api import DefiSolPumpfunApi
+from chainstream.openapi_client.api.dex_api import DexApi
+from chainstream.openapi_client.api.dex_pool_api import DexPoolApi
+from chainstream.openapi_client.api.endpoint_api import EndpointApi
+from chainstream.openapi_client.api.ipfs_api import IpfsApi
+from chainstream.openapi_client.api.jobs_api import JobsApi
+from chainstream.openapi_client.api.kyt_api import KYTApi
+from chainstream.openapi_client.api.ranking_api import RankingApi
+from chainstream.openapi_client.api.red_packet_api import RedPacketApi
+from chainstream.openapi_client.api.token_api import TokenApi
+from chainstream.openapi_client.api.trade_api import TradeApi
+from chainstream.openapi_client.api.transaction_api import TransactionApi
+from chainstream.openapi_client.api.wallet_api import WalletApi
+from chainstream.openapi_client.api.watchlist_api import WatchlistApi
+