Gnosis Safe – The most trusted platform to store digital assets on Ethereum https://gnosis-safe.io
Go to file
katspaugh fd0d7686f2
Bump to 3.6.0 (#2273)
2021-05-10 09:20:23 +02:00
.github Fix the media stream not being stopped; mirror the QR camera (#2165) 2021-04-15 20:21:27 -03:00
.storybook Fix the storybook: add a redux provider (#2191) 2021-04-22 10:08:58 +02:00
config/jest Upgrade dependencies (#2009) 2021-03-09 16:11:09 +01:00
contracts Add test case for sending token with 6 decimals, wrap moveFunds helper fireEvent in act() 2019-10-14 17:13:15 +04:00
docs (Chore) Update `nativeCoin` address to ZERO_ADDRESS (#2059) 2021-03-18 14:02:48 -03:00
migrations Merge branch 'development' into 536-notifications-status-labels-sync 2020-05-22 00:36:43 -03:00
patches (Feature) - EWC/Volta ENS support on web3 patch (#1596) 2020-11-18 14:42:00 -03:00
public Wording enhancements (#2120) 2021-04-15 16:22:38 +02:00
scripts Migrate to GitHub actions (#1924) 2021-02-24 17:24:25 +01:00
src Revert "Bugfix - Submit button out of screen in Contract Interaction modal (#2185)" (#2256) 2021-05-05 17:30:44 +02:00
.env.example Update the readme (#2125) 2021-04-06 15:55:55 +02:00
.eslintignore Bug: fix build directory for deployment, remove unused code (#937) 2020-05-21 08:42:11 -03:00
.eslintrc.js Upgrade dependencies (#2009) 2021-03-09 16:11:09 +01:00
.gitignore Feature #1593: Support promise-based api of Safe Apps SDK (#1594) 2020-12-11 12:31:55 +04:00
.nvmrc (Fix) Refactor Safe information retrieval (#2122) 2021-04-30 12:06:38 +02:00
.prettierignore Support Circles Safes in frontend on xDai (#1636) 2020-11-26 18:00:19 +01:00
.prettierrc (Fix) Enforce linting and formatting (#564) 2020-02-17 19:20:43 -03:00
.rescriptsrc Upgrade dependencies (#1691) 2020-12-04 18:38:49 +01:00
GNOSISCLA.md Add Gnosis CLA (#1188) 2020-07-31 13:20:57 +04:00
LICENSE.md Adding README and LICENSE (#7) 2018-03-12 11:26:53 +01:00
dev-app-update.yml Add dialog and skip version 2020-06-03 14:37:50 -03:00
package.json Bump to 3.6.0 (#2273) 2021-05-10 09:20:23 +02:00
readme.md Update the readme (#2192) 2021-04-22 17:50:34 +02:00
truffle.js Merge branch 'development' into 536-notifications-status-labels-sync 2020-05-22 00:36:43 -03:00
tsconfig.json (Fix) - #1798 broken safe creation deeplink (#1840) 2021-02-05 09:17:25 +01:00
yarn.lock (Fix) Refactor Safe information retrieval (#2122) 2021-04-30 12:06:38 +02:00

readme.md

Gnosis Safe

The most trusted platform to store digital assets on Ethereum. More info at gnosis-safe.io

This repository contains the code for the frontend code hosted at [https://gnosis-safe.io/app/]

Besides Ethereum Mainnet, the following networks are supported:

For technical information please refer to the Gnosis Developer Portal.

For support requests, please open up a bug issue or reach out via Discord.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See Deployment for notes on how to deploy the project on a live system.

Prerequisites

What things you need to install globally:

yarn global add truffle ganache-cli

We use yarn in our infrastacture, so we decided to go with yarn in the README

Installing and running

A step by step series of examples that tell you have to get a development env running

Install dependencies for the project:

yarn install

For using the Rinkeby services:

yarn start

If you prefer using Mainnet ones:

yarn start-mainnet

Environment variables

The app grabs environment variables from the .env file. Copy our template to your own local file:

cp .env.example .env

To execute transactions, you'll need to create an Infura project and set the project ID in the .env you've just created:

REACT_APP_INFURA_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Once done, you'll need to restart the app.

Building

For Rinkeby:

yarn build

For Mainnet:

yarn build-mainnet

Running the tests

  1. Run transaction-history-service
git clone https://github.com/gnosis/safe-transaction-service.git
cd safe-transaction-service
git checkout develop
docker-compose build
# it comes enabled by default in docker-compose
sudo service postgresql stop
docker-compose up -d

Check that the service is running at https://localhost:8000

  1. Migrate Safe Contracts:
git clone https://github.com/gnosis/safe-contracts.git
cd safe-contracts
yarn
npx truffle migrate
  1. Migrate Token Contracts for the tests: Inside safe-react directory
npx truffle migrate
  1. Run the tests:
yarn test

Lint

ESLint will be run automatically before you commit. To run it manually:

yarn lint:fix

Deployment

The code is deployed to a testing website automatically on each push via a GitHub Action. The GitHub Action will create a new subdomain and post the link as a comment in the PR.

When pushing to the master branch, the code will be uploaded to the production bucket but not deployed automatically. This is done manually by the devops team for extra safety.

Releasing to production

We prepare a new release every sprint. Sprints are two weeks long.

  • A separate code-freeze branch named release/X.Y.Z is created
  • The QA team do regression testing on this branch
  • If issues are found, bugfixes are merged into this branch
  • Once the QA is done, we push the branch to master (which is deployed to production)
  • Master is afterwards backmerged into the main development branch.

Configuring the app for running on different networks

Please check the network configuration documentation

Built With

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE.md file for details