status-sdk 1.0.0__tar.gz

status_sdk-1.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Status Research & Development GmbH
+
+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.

status_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: status-sdk
+Version: 1.0.0
+Summary: Private chat. Communities. Multi-chain wallet. Browser. dApps all in one app, powered by SNT.
+Author: Status Research & Development GmbH
+License-Expression: MIT
+Project-URL: Source, https://github.com/status-im/status-python-sdk
+Project-URL: Issues, https://github.com/status-im/status-python-sdk/issues
+Project-URL: Status App, https://status.app/
+Project-URL: Status Backend, https://github.com/status-im/status-go
+Keywords: privacy,decentralized,messenger,ethereum,blockchain,cryptocurrency
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: requests
+Requires-Dist: websocket-client
+Requires-Dist: websockets
+Requires-Dist: pandas
+Requires-Dist: pillow
+Requires-Dist: eth-abi
+Provides-Extra: agents
+Requires-Dist: tabulate; extra == "agents"
+Requires-Dist: langchain; extra == "agents"
+Requires-Dist: langchain-core; extra == "agents"
+Requires-Dist: langchain-groq; extra == "agents"
+Requires-Dist: python-dotenv; extra == "agents"
+Dynamic: license-file
+
+# Status Python SDK
+
+![Status Python SDK header image](./docs/images/overview-header.png)
+
+[Status](http://status.app/) is a decentralized, open-source super app combining a crypto wallet, messenger, and community spaces. It uses peer-to-peer technology so no central server can censor your messages or access your data.
+
+The initial Python Status Backend was built with testing in mind, instead of easy developer access. The objective of this repository is to make a SDK that is:
+
+- **light** - as less external packages when it comes to working with Status App
+- **fast** - quick to get started with Status Python
+- **documented** - clear explanations of what was done and **why it was done in a specific way**.
+
+## How it works
+
+```mermaid
+graph TB
+    subgraph backend[status-im/status-go]
+        subgraph Endpoints[Network: status-bridge]
+           RPC[RPC]
+           HTTP[REST]
+           SOCKET[Web Socket]
+       end
+       Vol1[(Backup)]
+       Vol2[(Assets)]
+   end
+
+
+   subgraph bot[status-im/status-python-sdk]
+        REQUIREMENTS[requirements.txt]
+        SDK[class Account]
+        SIGNAL[class Signal]
+    end
+
+    subgraph external[External Services]
+        COINGECKO[CoinGecko]
+        ALCHEMY[Alchemy]
+        INFURA[Infura]
+    end
+
+    SDK --> SIGNAL
+    SDK --> |Port 8080| RPC
+    SDK --> |Port 8080| HTTP
+    SIGNAL --> |Port 8080| SOCKET
+    SDK --> Vol1
+    SDK --> Vol2
+    RPC --> |coingecko_api_key| COINGECKO
+    RPC --> |infura_token| INFURA
+    HTTP --> |alchemy_token| ALCHEMY
+```
+
+## Setup
+
+To access Python funcitonality you will have to set up [Status Backend](https://github.com/status-im/status-go/). Easiest and fastest way to get it running would be with [Docker](https://www.docker.com/products/docker-desktop/).
+
+```mermaid
+sequenceDiagram
+    actor User
+    participant Docker
+    participant Python@{"alias": "status-im/status-python-sdk"}
+    participant Github@{"alias": "status-im/status-go" }
+    
+    User ->> Docker: docker-compose up
+    Docker ->> Github: Fetch Image
+    Docker ->> Docker: Build
+    User ->> Docker: Run container
+    User ->> Python: initialize module
+    Note over User,Python: from status_sdk import Account<br>account = Account()
+```
+
+### Python
+
+#### Install
+
+Clone the repository and move into it:
+
+```
+git clone https://github.com/status-im/status-python-sdk.git
+cd status-python-sdk
+```
+
+Install the base library:
+
+```
+pip install .
+```
+
+If you want to modify the library itself without having to reinstall:
+
+```
+pip install -e .
+```
+
+#### Uninstall
+
+```
+pip uninstall status-sdk
+```
+
+
+### Docker
+
+[`status-im/status-go`](https://github.com/status-im/status-go/) runs from the provided [`docker-compose.yaml`](./status_sdk/docker-compose.yaml) file. It does not use a pre-built image - it builds the backend from source, pulling directly from GitHub.
+
+
+To run on Windows, please make sure you have set up [WSL](https://learn.microsoft.com/en-us/windows/wsl/install). It is **required** for the `build: context` above. The SDK invokes Docker through WSL so it can build the Linux image and clone the repository during the build. If the `build` is changed to point to a local repository, then WSL is not required.
+
+You can set it up in **two** ways.
+
+#### With Python
+
+Use [`launch_docker_container`](./docs/utils.md#launch_docker_containercommitnone-wait_seconds5-platformlinuxamd64), which builds and starts the container for you. This is the recommended option, as it handles platform selection and (on Windows) recovers from stale Docker mounts:
+
+```python
+from status_sdk import launch_docker_container
+launch_docker_container()
+```
+
+#### Manually
+
+Run the compose file yourself. It lives inside the installed package, so point Docker at it:
+
+```
+docker compose -f status_sdk/docker-compose.yaml up -d
+```
+
+The compose file reads two variables from the environment. Both have a default, so the command above works as-is, but they can be overridden:
+
+| Variable | Default | Description |
+|-----|-----|-------------|
+| `STATUS_GO_REF` | `develop` | The [`status-im/status-go`](https://github.com/status-im/status-go/) git ref (commit SHA, branch or tag) to build from. |
+| `STATUS_GO_PLATFORM` | `linux/amd64` | The platform the image is built for. |
+
+```
+STATUS_GO_REF=2bee8b6a38cdc8f92d74e2dbb8c4e77fbbeea149 STATUS_GO_PLATFORM=linux/amd64 docker compose -f status_sdk/docker-compose.yaml up -d
+```

status_sdk-1.0.0/README.md

@@ -0,0 +1,135 @@
+# Status Python SDK
+
+![Status Python SDK header image](./docs/images/overview-header.png)
+
+[Status](http://status.app/) is a decentralized, open-source super app combining a crypto wallet, messenger, and community spaces. It uses peer-to-peer technology so no central server can censor your messages or access your data.
+
+The initial Python Status Backend was built with testing in mind, instead of easy developer access. The objective of this repository is to make a SDK that is:
+
+- **light** - as less external packages when it comes to working with Status App
+- **fast** - quick to get started with Status Python
+- **documented** - clear explanations of what was done and **why it was done in a specific way**.
+
+## How it works
+
+```mermaid
+graph TB
+    subgraph backend[status-im/status-go]
+        subgraph Endpoints[Network: status-bridge]
+           RPC[RPC]
+           HTTP[REST]
+           SOCKET[Web Socket]
+       end
+       Vol1[(Backup)]
+       Vol2[(Assets)]
+   end
+
+
+   subgraph bot[status-im/status-python-sdk]
+        REQUIREMENTS[requirements.txt]
+        SDK[class Account]
+        SIGNAL[class Signal]
+    end
+
+    subgraph external[External Services]
+        COINGECKO[CoinGecko]
+        ALCHEMY[Alchemy]
+        INFURA[Infura]
+    end
+
+    SDK --> SIGNAL
+    SDK --> |Port 8080| RPC
+    SDK --> |Port 8080| HTTP
+    SIGNAL --> |Port 8080| SOCKET
+    SDK --> Vol1
+    SDK --> Vol2
+    RPC --> |coingecko_api_key| COINGECKO
+    RPC --> |infura_token| INFURA
+    HTTP --> |alchemy_token| ALCHEMY
+```
+
+## Setup
+
+To access Python funcitonality you will have to set up [Status Backend](https://github.com/status-im/status-go/). Easiest and fastest way to get it running would be with [Docker](https://www.docker.com/products/docker-desktop/).
+
+```mermaid
+sequenceDiagram
+    actor User
+    participant Docker
+    participant Python@{"alias": "status-im/status-python-sdk"}
+    participant Github@{"alias": "status-im/status-go" }
+    
+    User ->> Docker: docker-compose up
+    Docker ->> Github: Fetch Image
+    Docker ->> Docker: Build
+    User ->> Docker: Run container
+    User ->> Python: initialize module
+    Note over User,Python: from status_sdk import Account<br>account = Account()
+```
+
+### Python
+
+#### Install
+
+Clone the repository and move into it:
+
+```
+git clone https://github.com/status-im/status-python-sdk.git
+cd status-python-sdk
+```
+
+Install the base library:
+
+```
+pip install .
+```
+
+If you want to modify the library itself without having to reinstall:
+
+```
+pip install -e .
+```
+
+#### Uninstall
+
+```
+pip uninstall status-sdk
+```
+
+
+### Docker
+
+[`status-im/status-go`](https://github.com/status-im/status-go/) runs from the provided [`docker-compose.yaml`](./status_sdk/docker-compose.yaml) file. It does not use a pre-built image - it builds the backend from source, pulling directly from GitHub.
+
+
+To run on Windows, please make sure you have set up [WSL](https://learn.microsoft.com/en-us/windows/wsl/install). It is **required** for the `build: context` above. The SDK invokes Docker through WSL so it can build the Linux image and clone the repository during the build. If the `build` is changed to point to a local repository, then WSL is not required.
+
+You can set it up in **two** ways.
+
+#### With Python
+
+Use [`launch_docker_container`](./docs/utils.md#launch_docker_containercommitnone-wait_seconds5-platformlinuxamd64), which builds and starts the container for you. This is the recommended option, as it handles platform selection and (on Windows) recovers from stale Docker mounts:
+
+```python
+from status_sdk import launch_docker_container
+launch_docker_container()
+```
+
+#### Manually
+
+Run the compose file yourself. It lives inside the installed package, so point Docker at it:
+
+```
+docker compose -f status_sdk/docker-compose.yaml up -d
+```
+
+The compose file reads two variables from the environment. Both have a default, so the command above works as-is, but they can be overridden:
+
+| Variable | Default | Description |
+|-----|-----|-------------|
+| `STATUS_GO_REF` | `develop` | The [`status-im/status-go`](https://github.com/status-im/status-go/) git ref (commit SHA, branch or tag) to build from. |
+| `STATUS_GO_PLATFORM` | `linux/amd64` | The platform the image is built for. |
+
+```
+STATUS_GO_REF=2bee8b6a38cdc8f92d74e2dbb8c4e77fbbeea149 STATUS_GO_PLATFORM=linux/amd64 docker compose -f status_sdk/docker-compose.yaml up -d
+```

status_sdk-1.0.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "status-sdk"
+version = "1.0.0"
+description = "Private chat. Communities. Multi-chain wallet. Browser. dApps all in one app, powered by SNT."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE.txt"]
+authors = [{ name = "Status Research & Development GmbH" }]
+keywords = ["privacy", "decentralized", "messenger", "ethereum", "blockchain", "cryptocurrency"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests",
+    "websocket-client",
+    "websockets",
+    "pandas",
+    "pillow",
+    "eth-abi",
+]
+
+[project.optional-dependencies]
+agents = [
+    "tabulate",
+    "langchain",
+    "langchain-core",
+    "langchain-groq",
+    "python-dotenv",
+]
+
+[project.urls]
+Source = "https://github.com/status-im/status-python-sdk"
+Issues = "https://github.com/status-im/status-python-sdk/issues"
+"Status App" = "https://status.app/"
+"Status Backend" = "https://github.com/status-im/status-go"
+
+[tool.setuptools]
+packages = ["status_sdk"]
+
+[tool.setuptools.package-data]
+status_sdk = ["docker-compose.yaml"]
+

status_sdk-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

status_sdk-1.0.0/status_sdk/__init__.py

@@ -0,0 +1,5 @@
+from .account import Account
+from .utils import launch_docker_container
+from . import exceptions
+
+__all__ = ["Account", "launch_docker_container", "exceptions"]