WalletConnect Bridge Python Implementation
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


WalletConnect Bridge Python Implementation


A full introduction is described in our docs: https://docs.walletconnect.org/technical-specification


  1. Python
  2. Docker (for Docker setup)
  3. Make (for Make commands)

Docker setup

Step 0. Point DNS record to your box (required for SSL)


Step 1. Setup the bridge URL to match your DNS record

$ make setup URL=<YOUR_BRIDGE_URL>

# OR

$ sed -i -e 's/bridge.mydomain.com/<YOUR_BRIDGE_URL>/g' nginx/defaultConf && rm -rf nginx/defaultConf-e

Step 2. Run the following command to build the Docker image

$ make build

# OR

$ docker build . -t py-walletconnect-bridge

Step 3. Finally run the following command to run the Docker container

$ make run

# OR

$ docker run -it -v $(pwd)/:/source/ -p 443:443 -p 80:80 py-walletconnect-bridge

You can test it at https://<YOUR_BRIDGE_URL>/hello

Choose Branch

This setup defaults to the active branch in your current directory in order to build a Docker image from another branch, run the following command:

$ make build BRANCH=v0.7.x

# OR

$ docker build . -t py-walletconnect-bridge --build-arg branch=v0.7.x

For this sample configuration file, the bridge will be available at https://<YOUR_BRIDGE_URL>/ . After specifying <YOUR_BRIDGE_URL> to in /etc/hosts,

Update Bridge

To update the bridge, just run the following and it will maintain the existing state of the existing bridge sessions and quickly swap containers to the new version

$ make update

# Optional (choose branch)

$ make update BRANCH=develop

Skip Cerbot

This approach uses Certbot to generate real SSL certificates for your configured nginx hosts. If you would prefer to use the self signed certificates, you can pass the --skip-certbot flag to docker run as follows:

$ make run_no_certbot

# OR

$ docker run -it -v $(pwd)/:/source/ -p 443:443 -p 80:80 py-walletconnect-bridge --skip-certbot

Certbot certificates expire after 90 days. To renew, shut down the docker process and run make renew. You should back up your old certs before doing this, as they will be deleted.

Manual setup

If you'd like to keep a separate Python environment for this project's installs, set up virtualenv

$ pip install virtualenv virtualenvwrapper

Add the following to your ~/.bashrc

export WORKON_HOME=$HOME/.virtualenvs~
export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3
source /usr/local/bin/virtualenvwrapper.sh

From the project directory, run these commands to install the walletconnect-bridge package in a virtualenv called "walletconnect-bridge"

$ mkvirtualenv walletconnect-bridge
$ pip install -r requirements.txt
$ python setup.py develop

In another terminal, start local Redis instance

$ redis-server

Run the project locally

$ walletconnect-bridge --redis-local

Test your Bridge is working

$ curl https://<YOUR_BRIDGE_URL>/hello