Status Python SDK

Status 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

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]
        GROUP_CHAT[class GroupChat]
        COMMUNITY[class Community]
        CHANNEL[class Channel]
        SDK[class Account]
        SIGNAL[class Signal]
    end

    subgraph external[External Services]
        COINGECKO[CoinGecko]
        ALCHEMY[Alchemy]
        INFURA[Infura]
    end

    COMMUNITY --> CHANNEL
    COMMUNITY <--> |logged in Account| SDK
    GROUP_CHAT <--> |logged in Account| SDK
    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. Easiest and fastest way to get it running would be with Docker.

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

PyPI

pip install status-sdk

Locally

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 runs from the provided 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. 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, 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:

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 three variables from the environment. All of them have a default, so the command above works as-is, but they can be overridden:

STATUS_GO_COMMIT=2bee8b6a38cdc8f92d74e2dbb8c4e77fbbeea149 PLATFORM=linux/amd64 docker compose -f status_sdk/docker-compose.yaml up -d