Status App Community Monitoring

Monitoring tool for Status App communities. No personal data is collected from users.

Field	Hashed	Description
id	Yes	The message's ID
whisper_timestamp	No	The whisper timestamp of the message
from	Yes	The public key of the user
message_type	No	The message type
seen	No	True if the message has been seen otherwise False
chat_id	No	The chat ID is a combination of community ID and channel ID
community_id	No	The ID of the community
response_to	Yes	Ithe public key of the user who the response is for
timestamp	No	The timestamp of the message
deleted	No	True if the message was deleted otherwise False

Status Bot account information can be found in config.yaml.

How it works

graph LR
    subgraph Communities[Status App]
        subgraph Status[Status Community]
            StatusMessages[Messages]
            StatusInfo[Information]
        end
        subgraph Logos[Logos Community]
            LogosMessages[Messages]
            LogosInfo[Information]
        end

    end

    subgraph Bot[Docker Container]
        RawDataLocal[(Raw Data)]
        Script[monitor.py]
    end

    subgraph IFT[IFT Infrastructure]
        RawDataIFT[(Raw Data)]
        ProcessedDataIFT[(Processed Data)]

    end

    Communities <--> |class Account| Script
    Script --> |SHA256| RawDataLocal
    RawDataLocal --> |Airbyte| RawDataIFT
    RawDataIFT --> |dbt| ProcessedDataIFT

Setup

Environment Variables

• POSTGRES_USERNAME - Postgres username.
• POSTGRES_PASSWORD - Postgres password.
• POSTGRES_DATABASE - The database name in the Postgres connection.
• POSTGRES_HOST - The Postgres host name that will be remotely connected to.
• POSTGRES_PORT - The Postgres port that will be remotely connected to.
• STATUS_DISPLAY_NAME - The Status display name that will be used to create an account.
• STATUS_PASSWORD - The Status password that will be used to create an account.
• STATUS_MNEMONIC - The mnemonic used to recover the account. If passed a .bkp file will be loaded as well. Use this when you want to login to a bot account via Status App, join a community / leave community and export the .bkp file.
• STATUS_INFURA_TOKEN - Infura token is required for token gated communities
• STATUS_COINGECKO_API_KEY - Coingecko API Key is required for token gated communities

Docker deployement

You can use the docker-compose.yaml to run the project.

Example of .env file to use

# Status Backend connection
STATUS_DISPLAY_NAME = "bot-status"
STATUS_PASSWORD = "ChangeThisPassword"
STATUS_MNEMONIC= "test test test test test test test test test test test test"

# Necessary for communities that have tokens
STATUS_INFURA_TOKEN = "Token from https://www.infura.io/"
STATUS_COINGECKO_API_KEY = "Token from https://www.coingecko.com/"

# Database config
POSTGRES_HOST=database
POSTGRES_PORT=5432
POSTGRES_DATABASE=status-bot
POSTGRES_USERNAME=status
POSTGRES_PASSWORD=ChangeThisOneAlso

Python

1. Setup environment. Conda example:

conda create -n status-monitoring python=3.12

Note: Code has been tested with Python 3.12.

2. Install requirements

pip install -r requirements.txt

Note: If you are on Windows, you will have to install psycopg2 instead of psycopg2-binary.

Backups

If you have already created a Status account and want to use it with it's current data, please make sure you export the .bkp file and put it in folder backups and have the following .env variables:

• STATUS_DISPLAY_NAME
• STATUS_PASSWORD
• STATUS_MNEMONIC

Files

• monitor.py - Status community message monitoring. It will download and upload messages in parallel.