• Search by Module
• Search by Words
• Search Projects

• Java
• Python
• JavaScript
• TypeScript
• C++
• Scala
• Blog

Project: safe-relay-service (GitHub Link)

• safe-relay-service-master
  • docker-compose.dev.yml
  • .github
    • feature_request.md
    • bug_report.md
  • run_tests.sh
  • .env
  • requirements-test.txt
  • .env_ganache
  • safe_relay_service
    • taskapp
      • __init__.py
      • celery.py
    • utils
      • __init__.py
      • tests
        • test_utils.py
        • __init__.py
      • singleton.py
    • tokens
      • price_oracles.py
      • apps.py
      • serializers.py
      • models.py
      • views.py
      • urls.py
      • filters.py
      • __init__.py
      • migrations
        • 0010_auto_20190124_1709.py
        • 0007_auto_20181205_1024.py
        • 0004_auto_20181114_1535.py
        • 0013_auto_20200217_0942.py
        • 0001_initial.py
        • 0005_auto_20181120_0940.py
        • 0012_priceoracle_configuration.py
        • 0006_auto_20181205_1226.py
        • 0002_auto_20181109_1522.py
        • 0009_auto_20181221_1510.py
        • __init__.py
        • 0011_auto_20190225_1646.py
        • 0008_priceoracleticker_inverse.py
        • 0003_token_relevance.py
      • tests
        • factories.py
        • test_exchanges.py
        • test_commands.py
        • test_models.py
        • __init__.py
        • test_views.py
      • token_repository.py
      • admin.py
      • management
        • commands
          • add_token.py
          • update_tokens.py
          • __init__.py
        • __init__.py
    • version.py
    • gas_station
      • apps.py
      • serializers.py
      • models.py
      • views.py
      • tasks.py
      • urls.py
      • __init__.py
      • migrations
        • 0001_initial.py
        • 0002_auto_20180604_1627.py
        • __init__.py
      • tests
        • test_gas_station.py
        • factories.py
        • test_models.py
        • __init__.py
      • admin.py
      • gas_station.py
      • management
        • commands
          • setup_gas_station.py
          • __init__.py
        • __init__.py
    • templates
      • drf-yasg
        • swagger-ui.html
    • __init__.py
    • relay
      • urls_v2.py
      • apps.py
      • services
        • erc20_events_service.py
        • transaction_service.py
        • funding_service.py
        • notification_service.py
        • stats_service.py
        • transaction_scan_service.py
        • __init__.py
        • safe_creation_service.py
      • urls_v3.py
      • repositories
        • redis_repository.py
        • __init__.py
      • serializers.py
      • models.py
      • views.py
      • tasks.py
      • views_v2.py
      • urls.py
      • filters.py
      • __init__.py
      • utils.py
      • migrations
        • 0005_safecreation_funder.py
        • 0006_remove_safecreation_payment_ether.py
        • 0017_auto_20190424_1149.py
        • 0009_safecreation2.py
        • 0026_auto_20200626_1531.py
        • 0013_auto_20190401_1445.py
        • 0003_safecreation_payment_token.py
        • 0008_safemultisigtx_safe_tx_hash.py
        • 0018_auto_20190425_0928.py
        • 0015_ethereumtx_gas_used.py
        • 0010_ethereumtx.py
        • 0007_safecreation_master_copy.py
        • 0016_internaltx_error.py
        • 0022_auto_20190606_1224.py
        • 0001_initial.py
        • 0021_auto_20190527_0914.py
        • 0024_delete_internaltx.py
        • 0025_auto_20200429_1101.py
        • 0002_safemultisigtx_refund_receiver.py
        • 0020_auto_20190514_1211.py
        • 0014_internaltx_safetxstatus.py
        • __init__.py
        • 0019_ethereumevent.py
        • 0011_populate_ethereumtx.py
        • 0012_safemultisigtx_ethereum_tx.py
        • 0004_safecreation_payment_ether.py
        • 0023_auto_20190612_1539.py
      • tests
        • test_transaction_service.py
        • test_safe_creation_service.py
        • factories.py
        • test_serializers.py
        • test_commands.py
        • test_validators.py
        • test_tasks.py
        • test_safe_creation_tx.py
        • test_funding_service.py
        • test_models.py
        • test_stats_service.py
        • test_views_v3.py
        • relay_test_case.py
        • __init__.py
        • inherited
          • __init__.py
          • test_safe.py
          • test_ethereum_client.py
        • test_views_v2.py
        • test_resend_txs.py
        • test_views.py
        • test_erc20_events_service.py
      • admin.py
      • validators.py
      • views_v3.py
      • models_raw.py
      • management
        • commands
          • send_slack_notification.py
          • deploy_safe_contracts.py
          • setup_service.py
          • deploy_pending_safes.py
          • check_safes.py
          • __init__.py
          • test_relay_server.py
          • check_internal_tx_balances.py
          • resend_txs.py
        • __init__.py
    • static
      • safe
        • logo.svg
      • .gitignore
  • LICENSE
  • manage.py
  • .gitattributes
  • config
    • wsgi.py
    • urls.py
    • __init__.py
    • settings
      • local.py
      • production.py
      • __init__.py
      • test.py
      • test_rinkeby.py
      • base.py
  • .env_local
  • docker
    • nginx
      • safe_service.conf
    • web
      • celery
        • scheduler
          • run.sh
        • worker
          • run.sh
      • Dockerfile_alpine
      • run_web.sh
      • Dockerfile
  • requirements-dev.txt
  • setup.cfg
  • .travis.yml
  • README.md
  • pytest.ini
  • scripts
    • create_multiple_safes.py
    • deploy_docker.sh
  • CONTRIBUTORS.txt
  • requirements.txt
  • .gitignore
  • docs
    • install.rst
    • Makefile
    • docker_ec2.rst
    • __init__.py
    • index.rst
    • conf.py
    • deploy.rst
    • Docs.mdj
  • .dockerignore
  • docker-compose.yml

Gnosis Safe Relay Service

This service allows us to have owners of the Safe contract that don’t need to hold any ETH on those owner addresses. How is this possible? The transaction relay service acts as a proxy, paying for the transaction fees and getting it back due to the transaction architecture we use. It also enables the user to pay for ethereum transactions using ERC20 tokens.

Docs

Docs are available on Gnosis Docs You can open the diagrams explaining Pre CREATE2 deployment under docs/ with Staruml

Setup for development (using ganache)

This is the recommended configuration for developing and testing the Relay service. docker-compose is required for running the project.

Configure the parameters needed on .env_ganache. By default the private keys of the accounts are the ones from Ganache, and the contract addresses are calculated to be the ones deployed by the Relay when the application starts, so there's no need to configure anything.

More parameters can be added to that file like:

• SAFE_FIXED_CREATION_COST: For fixed price in wei for deploying a Safe. If you set 0 you allow Safes to be deployed for free.
• SAFE_CONTRACT_ADDRESS to change the Safe's master copy address.
• For more parameters check base.py file.

Then:

docker-compose -f docker-compose.yml -f docker-compose.dev.yml build --force-rm
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up

The service should be running in localhost:8000

Setup for production

This is the recommended configuration for running a production Relay. docker-compose is required for running the project.

Configure the parameters needed on .env. These parameters need to be changed:

• ETHEREUM_NODE_URL: Http/s address of a ethereum node.
• SAFE_FUNDER_PRIVATE_KEY: Use a private key for an account with ether on that network. It's used to deploy new Safes.
• SAFE_TX_SENDER_PRIVATE_KEY: Same as the SAFE_FUNDER_PRIVATE_KEY, but it's used to relay all transactions.

Another parameters can be configured like:

• SAFE_CONTRACT_ADDRESS: If you are not using default Gnosis Safe Master Copy.
• SAFE_FIXED_CREATION_COST: For fixed price in wei for deploying a Safe. If you set 0 you allow Safes to be deployed for free.
• For more parameters check base.py file.

Then:

docker-compose build --force-rm
docker-compose up

The service should be running in localhost:8000

For example, to set up a Göerli node:

• Set ETHEREUM_NODE_URL to https://goerli.infura.io/v3/YOUR-PROJECT-ID (if using INFURA)
• Set SAFE_FUNDER_PRIVATE_KEY and SAFE_TX_SENDER_PRIVATE_KEY to accounts that have Göerli ether. Don't use the same account for both

Run:

docker-compose build --force-rm
docker-compose up

You can test everything is set up:

curl 'http://localhost:8000/api/v1/about/'

Use admin interface

Services come with a basic administration web ui (provided by Django). A user must be created first to get access:

docker exec -it safe-transaction-service_web_1 bash
python manage.py createsuperuser

Then go to the web browser and navigate to http://localhost:8000/admin/

Contributors

• Stefan George (stefan@gnosis.pm)
• Denís Graña (denis@gnosis.pm)
• Giacomo Licari (giacomo.licari@gnosis.pm)
• Uxío Fuentefría (uxio@gnosis.pm)