tessium 0.0.1__tar.gz

tessium-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: publish
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    # OIDC instead of a stored token: the workflow proves its own identity to
+    # PyPI, so there is no secret to leak or rotate.
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

tessium-0.0.1/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+dist/
+*.egg-info/
+.venv/

tessium-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tessium
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tessium-0.0.1/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.5
+Name: tessium
+Version: 0.0.1
+Summary: Minimal WebSocket client for Tessium, the realtime Solana data API
+Project-URL: Homepage, https://tessium.dev
+Project-URL: Documentation, https://tessium.dev/docs/
+Project-URL: Repository, https://github.com/tessiumdev/tessium-py
+Project-URL: Examples, https://github.com/tessiumdev/tessium-example
+Author-email: Tessium <contact@tessium.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,blockchain,realtime,solana,streaming,trading,websocket
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: websockets>=12
+Description-Content-Type: text/markdown
+
+# tessium
+
+Minimal Python client for [Tessium](https://tessium.dev) — a realtime Solana
+data API. Open one WebSocket, subscribe to the streams you need, and receive
+on-chain activity as structured events instead of raw RPC payloads you have to
+decode yourself.
+
+Eight streams over a single connection: `launches`, `migrations`,
+`pool_creations`, `token_trades`, `token_transfers`, `candles`, `wallet_trades`,
+`wallet_transfers`.
+
+> **Preview.** `0.0.x` tracks the published protocol and has not been exercised
+> against a production endpoint yet. Pin an exact version.
+
+## Install
+
+```bash
+pip install tessium
+```
+
+## Watch new token launches
+
+Every new token on pump.fun, printed as it happens:
+
+```python
+import asyncio
+from tessium import events
+
+async def main():
+    async for frame in events(
+        "YOUR_API_KEY",
+        "launches",
+        {"platforms": ["pumpfun"]},
+    ):
+        launch = frame["data"]
+        print(launch["symbol"], launch["mint"])
+
+asyncio.run(main())
+```
+
+Frames arrive whole rather than unwrapped, because `frame["cursor"]` is what you
+persist after processing an event — it is how you
+[replay a short disconnect](https://tessium.dev/docs/protocol/cursor) instead of
+losing the gap.
+
+An [API key](https://tessium.dev/dashboard) on the
+[free plan](https://tessium.dev/pricing) needs no payment details.
+
+## Also here
+
+```python
+from tessium import ENDPOINT, STREAMS, endpoint, subscribe_frame
+```
+
+`endpoint()` builds the URL, `subscribe_frame()` builds the subscribe frame —
+useful when you drive the socket yourself.
+
+## More
+
+- [Documentation](https://tessium.dev/docs/) — protocol frames, cursors and
+  replay, per-stream payloads, limits
+- [Runnable examples](https://github.com/tessiumdev/tessium-example) — launch to
+  trades, early volume filter, Telegram alerts, in Node and Python
+- [Coverage](https://tessium.dev/coverage) — every launchpad, AMM and router
+  Tessium reads
+
+## License
+
+MIT

tessium-0.0.1/README.md

@@ -0,0 +1,69 @@
+# tessium
+
+Minimal Python client for [Tessium](https://tessium.dev) — a realtime Solana
+data API. Open one WebSocket, subscribe to the streams you need, and receive
+on-chain activity as structured events instead of raw RPC payloads you have to
+decode yourself.
+
+Eight streams over a single connection: `launches`, `migrations`,
+`pool_creations`, `token_trades`, `token_transfers`, `candles`, `wallet_trades`,
+`wallet_transfers`.
+
+> **Preview.** `0.0.x` tracks the published protocol and has not been exercised
+> against a production endpoint yet. Pin an exact version.
+
+## Install
+
+```bash
+pip install tessium
+```
+
+## Watch new token launches
+
+Every new token on pump.fun, printed as it happens:
+
+```python
+import asyncio
+from tessium import events
+
+async def main():
+    async for frame in events(
+        "YOUR_API_KEY",
+        "launches",
+        {"platforms": ["pumpfun"]},
+    ):
+        launch = frame["data"]
+        print(launch["symbol"], launch["mint"])
+
+asyncio.run(main())
+```
+
+Frames arrive whole rather than unwrapped, because `frame["cursor"]` is what you
+persist after processing an event — it is how you
+[replay a short disconnect](https://tessium.dev/docs/protocol/cursor) instead of
+losing the gap.
+
+An [API key](https://tessium.dev/dashboard) on the
+[free plan](https://tessium.dev/pricing) needs no payment details.
+
+## Also here
+
+```python
+from tessium import ENDPOINT, STREAMS, endpoint, subscribe_frame
+```
+
+`endpoint()` builds the URL, `subscribe_frame()` builds the subscribe frame —
+useful when you drive the socket yourself.
+
+## More
+
+- [Documentation](https://tessium.dev/docs/) — protocol frames, cursors and
+  replay, per-stream payloads, limits
+- [Runnable examples](https://github.com/tessiumdev/tessium-example) — launch to
+  trades, early volume filter, Telegram alerts, in Node and Python
+- [Coverage](https://tessium.dev/coverage) — every launchpad, AMM and router
+  Tessium reads
+
+## License
+
+MIT

tessium-0.0.1/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "tessium"
+version = "0.0.1"
+description = "Minimal WebSocket client for Tessium, the realtime Solana data API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Tessium", email = "contact@tessium.dev" }]
+keywords = [
+    "solana",
+    "websocket",
+    "realtime",
+    "blockchain",
+    "trading",
+    "streaming",
+    "api",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Framework :: AsyncIO",
+]
+dependencies = ["websockets>=12"]
+
+[project.urls]
+Homepage = "https://tessium.dev"
+Documentation = "https://tessium.dev/docs/"
+Repository = "https://github.com/tessiumdev/tessium-py"
+Examples = "https://github.com/tessiumdev/tessium-example"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["tessium"]

tessium-0.0.1/tessium/__init__.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+import json
+from collections.abc import AsyncIterator, Mapping
+from typing import Any
+
+import websockets
+
+__version__ = "0.0.1"
+
+ENDPOINT = "wss://api.tessium.dev/stream"
+
+STREAMS = (
+    "launches",
+    "migrations",
+    "pool_creations",
+    "token_trades",
+    "token_transfers",
+    "candles",
+    "wallet_trades",
+    "wallet_transfers",
+)
+
+
+def endpoint(api_key: str, base: str = ENDPOINT) -> str:
+    return f"{base}?key={api_key}"
+
+
+def subscribe_frame(
+    stream: str,
+    params: Mapping[str, Any] | None = None,
+    sub_id: int = 1,
+) -> dict[str, Any]:
+    frame: dict[str, Any] = {"op": "subscribe", "stream": stream, "id": sub_id}
+    if params:
+        frame["params"] = dict(params)
+    return frame
+
+
+async def events(
+    api_key: str,
+    stream: str,
+    params: Mapping[str, Any] | None = None,
+    *,
+    base: str = ENDPOINT,
+) -> AsyncIterator[dict[str, Any]]:
+    """Yield `event` frames for one subscription.
+
+    Frames are yielded whole, not just `data`: `cursor` is what you persist to
+    replay a short disconnect, and it lives on the frame.
+    """
+    async with websockets.connect(endpoint(api_key, base)) as ws:
+        await ws.send(json.dumps(subscribe_frame(stream, params)))
+        async for message in ws:
+            frame = json.loads(message)
+            if frame.get("op") == "event":
+                yield frame