socialfi-api 0.5.0__tar.gz

socialfi_api-0.5.0/.gitignore

@@ -0,0 +1,16 @@
+node_modules/
+*.tgz
+.DS_Store
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/
+build/
+*.egg-info/
+.venv/
+venv/
+.env
+.env.*
+_core/

socialfi_api-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CabalSpy
+
+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.

socialfi_api-0.5.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.5
+Name: socialfi-api
+Version: 0.5.0
+Summary: SocialFi API — add a social layer to any app: login with X + verified wallets, live trades and PnL of your users, leaderboards and copy trading on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. By CabalSpy ID.
+Project-URL: Homepage, https://www.cabalspy.xyz/cabalspy-id/
+Project-URL: Documentation, https://docs.cabalspy.xyz/cabalspy-id
+Project-URL: Repository, https://github.com/CabalSpy/socialfi-api
+Project-URL: Issues, https://github.com/CabalSpy/socialfi-api/issues
+Project-URL: SDK, https://pypi.org/project/cabalspy-id/
+Author-email: CabalSpy <contact@cabalspy.xyz>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: base,bnb,cabalspy,cabalspy-id,copy-trading,crypto-login,crypto-social,ethereum,kol,kol-tracker,oidc,openid-connect,pnl,python,sdk,social-trading,socialfi,socialfi-api,socialfi-sdk,solana,trading-leaderboard,wallet-tracker,web3-social
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: cabalspy-id<0.6,>=0.5.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: websockets>=14.0; extra == 'dev'
+Provides-Extra: stream
+Requires-Dist: cabalspy-id[stream]<0.6,>=0.5.0; extra == 'stream'
+Description-Content-Type: text/markdown
+
+# socialfi-api — the SocialFi API for any app (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/socialfi-api.svg)](https://pypi.org/project/socialfi-api/) [![ci](https://github.com/CabalSpy/socialfi-api/actions/workflows/ci.yml/badge.svg)](https://github.com/CabalSpy/socialfi-api/actions/workflows/ci.yml) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**socialfi-api** adds a social layer to any crypto app: login with X, wallets verified by a tiny on-chain payment, reviewed KOL badges, live trades and PnL of your users, leaderboards and copy trading — on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Sync and async.
+
+Part of **[CabalSpy ID](https://id.cabalspy.xyz)** — the SocialFi layer for crypto apps. [Website](https://www.cabalspy.xyz/cabalspy-id/) · [Docs](https://docs.cabalspy.xyz/cabalspy-id) · [API dashboard](https://apidashboard.cabalspy.xyz) · [Full SDK: cabalspy-id](https://github.com/CabalSpy/cabalspy-id-js)
+
+```bash
+pip install socialfi-api            # live trade stream: pip install "socialfi-api[stream]"
+```
+
+```python
+from socialfi_api import CabalSpyID, CabalSpyIDAuth, verify_webhook
+
+auth = CabalSpyIDAuth("csid_...", client_secret=os.environ["CSID_CLIENT_SECRET"], redirect_uri="https://your.app/callback")
+req = auth.create_authorization_url(scope=["openid", "profile", "wallets"])
+
+csid = CabalSpyID()  # reads CABALSPY_ID_API_KEY / CABALSPY_API_KEY
+board = csid.leaderboard(blockchain="solana", period="7d", sort="pnl_usd")
+```
+
+Contents: `CabalSpyID` / `AsyncCabalSpyID` (Data API), `CabalSpyIDStream`, `CabalSpyIDAuth` (OIDC), `verify_webhook`, errors and response types — the `cabalspy_id.api` module. Full reference: [cabalspy-id README](https://github.com/CabalSpy/cabalspy-id-python#readme).
+
+Versions follow `cabalspy-id`: 0.5.0 depends on `cabalspy-id` 0.5.0. This package contains no code of its own — it re-exports part of `cabalspy-id`, so behaviour, fixes and types are always the same.
+
+## License
+
+MIT

socialfi_api-0.5.0/README.md

@@ -0,0 +1,29 @@
+# socialfi-api — the SocialFi API for any app (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/socialfi-api.svg)](https://pypi.org/project/socialfi-api/) [![ci](https://github.com/CabalSpy/socialfi-api/actions/workflows/ci.yml/badge.svg)](https://github.com/CabalSpy/socialfi-api/actions/workflows/ci.yml) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**socialfi-api** adds a social layer to any crypto app: login with X, wallets verified by a tiny on-chain payment, reviewed KOL badges, live trades and PnL of your users, leaderboards and copy trading — on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Sync and async.
+
+Part of **[CabalSpy ID](https://id.cabalspy.xyz)** — the SocialFi layer for crypto apps. [Website](https://www.cabalspy.xyz/cabalspy-id/) · [Docs](https://docs.cabalspy.xyz/cabalspy-id) · [API dashboard](https://apidashboard.cabalspy.xyz) · [Full SDK: cabalspy-id](https://github.com/CabalSpy/cabalspy-id-js)
+
+```bash
+pip install socialfi-api            # live trade stream: pip install "socialfi-api[stream]"
+```
+
+```python
+from socialfi_api import CabalSpyID, CabalSpyIDAuth, verify_webhook
+
+auth = CabalSpyIDAuth("csid_...", client_secret=os.environ["CSID_CLIENT_SECRET"], redirect_uri="https://your.app/callback")
+req = auth.create_authorization_url(scope=["openid", "profile", "wallets"])
+
+csid = CabalSpyID()  # reads CABALSPY_ID_API_KEY / CABALSPY_API_KEY
+board = csid.leaderboard(blockchain="solana", period="7d", sort="pnl_usd")
+```
+
+Contents: `CabalSpyID` / `AsyncCabalSpyID` (Data API), `CabalSpyIDStream`, `CabalSpyIDAuth` (OIDC), `verify_webhook`, errors and response types — the `cabalspy_id.api` module. Full reference: [cabalspy-id README](https://github.com/CabalSpy/cabalspy-id-python#readme).
+
+Versions follow `cabalspy-id`: 0.5.0 depends on `cabalspy-id` 0.5.0. This package contains no code of its own — it re-exports part of `cabalspy-id`, so behaviour, fixes and types are always the same.
+
+## License
+
+MIT

socialfi_api-0.5.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "socialfi-api"
+version = "0.5.0"
+description = "SocialFi API — add a social layer to any app: login with X + verified wallets, live trades and PnL of your users, leaderboards and copy trading on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. By CabalSpy ID."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "CabalSpy", email = "contact@cabalspy.xyz" }]
+keywords = [
+  "socialfi-api",
+  "socialfi-sdk",
+  "socialfi",
+  "social-trading",
+  "copy-trading",
+  "crypto-social",
+  "web3-social",
+  "kol",
+  "kol-tracker",
+  "wallet-tracker",
+  "trading-leaderboard",
+  "pnl",
+  "crypto-login",
+  "solana",
+  "bnb",
+  "base",
+  "ethereum",
+  "cabalspy",
+  "cabalspy-id",
+  "oidc",
+  "openid-connect",
+  "sdk",
+  "python",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Internet :: WWW/HTTP",
+  "Topic :: Office/Business :: Financial",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+dependencies = ["cabalspy-id>=0.5.0,<0.6"]
+
+[project.optional-dependencies]
+stream = ["cabalspy-id[stream]>=0.5.0,<0.6"]
+dev = ["pytest>=8.0", "websockets>=14.0"]
+
+[project.urls]
+Homepage = "https://www.cabalspy.xyz/cabalspy-id/"
+Documentation = "https://docs.cabalspy.xyz/cabalspy-id"
+Repository = "https://github.com/CabalSpy/socialfi-api"
+Issues = "https://github.com/CabalSpy/socialfi-api/issues"
+SDK = "https://pypi.org/project/cabalspy-id/"
+
+[tool.hatch.build.targets.wheel]
+packages = ["socialfi_api"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+extend-exclude = ["*.md"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP"]

socialfi_api-0.5.0/socialfi_api/__init__.py

@@ -0,0 +1,24 @@
+"""socialfi-api — the SocialFi API by CabalSpy ID.
+
+Re-exports ``cabalspy_id.api``: Data API clients, the trade stream, Login with
+CabalSpy ID (OpenID Connect) and webhook verification.
+
+    from socialfi_api import CabalSpyID, CabalSpyIDAuth, verify_webhook
+"""
+
+from typing import Any
+
+import cabalspy_id.api as _source
+from cabalspy_id.api import *  # noqa: F403
+from cabalspy_id.api import __all__ as _source_all
+
+__version__ = "0.5.0"
+#: The version of the cabalspy-id package doing the work.
+cabalspy_id_version: str = _source.__version__
+
+__all__ = [*(n for n in _source_all if n != "__version__"), "__version__", "cabalspy_id_version"]  # noqa: PLE0604
+
+
+def __getattr__(name: str) -> Any:
+    # Names cabalspy_id.api loads lazily (the stream clients) are forwarded too.
+    return getattr(_source, name)

socialfi_api-0.5.0/tests/test_exports.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import cabalspy_id.api as source
+
+import socialfi_api
+
+
+def test_reexports_the_same_objects() -> None:
+    for name in source.__all__:
+        if name == "__version__":
+            continue
+        assert getattr(socialfi_api, name) is getattr(source, name), name
+
+
+def test_entry_points() -> None:
+    for name in [
+        "CabalSpyID",
+        "AsyncCabalSpyID",
+        "CabalSpyIDAuth",
+        "CabalSpyIDStream",
+        "verify_webhook",
+        "NotFoundError",
+    ]:
+        assert getattr(socialfi_api, name) is getattr(source, name), name
+    assert socialfi_api.__version__ == "0.5.0"
+    assert socialfi_api.cabalspy_id_version == source.__version__
+
+
+def test_star_import() -> None:
+    ns: dict[str, object] = {}
+    exec("from socialfi_api import *", ns)
+    for name in [
+        "CabalSpyID",
+        "AsyncCabalSpyID",
+        "CabalSpyIDAuth",
+        "CabalSpyIDStream",
+        "verify_webhook",
+        "NotFoundError",
+    ]:
+        assert ns[name] is getattr(source, name), name