Gnosis Developer Portal Safe

Gnosis Developer Portal Safe

  • Introduction
  • Contracts
  • Services
  • SDKs
  • Support

›Using the Gnosis Safe

Using the Gnosis Safe

  • Overview
  • Contract Proxy Kit
  • Safe Apps
  • Tutorials

Safe Apps

Introduction

With over $1B worth of digital assets held in Gnosis Multisigs alone, it’s essential for the dapp ecosystem to access the untapped market of multi-signature wallets. Safe Apps introduce a completely new way for developers to build their dapps right into a Multisig interface. Turn your Dapp into an HTML iframe component that can be accessed through the Safe Multisig. We are providing extensive developer tooling to make it easy to develop, test and integrate Safe Apps into the Safe Multisig. This includes a unique design system, reusable components and a Safe App SDK that facilitates the Safe App <> Safe Multisig communication.

Please refer to this EthCC3 talk to learn more about Safe Apps.

There are already Safe Apps available for a number of popular protocols such as Aave, Synthetix, 1inch or Balancer. These have been build by 3rd party developers or the projects themselves.

If you are missing a Safe App, get in touch with the respective project or get building with the Safe Apps SDK below. There is even a grants program available:

Safe Apps Grants

We have an ongoing program to finance the development of Safe Apps through grants with up to $3000. These grants are meant as an incentive for the community to extend the functionality of the Safe Multisig and enable small projects or independent developers to build their first Safe App.

Find more information about our grants program here.

On-chain stats

There are Dune Analytics dashboards about Safe Apps available:

  • Number of transactions
  • Transaction volume

Development

Safe Apps SDK

The Safe App SDK is a software development kit to integrate third-party applications (Safe Apps) with the Safe Multisig interface.

Find documentation on the Safe App SDK here

Create your Safe App starting from this React template

Watch a video introduction to Building with Safe Apps SDK & Contract Proxy Kit

UI Kit

We provide Safe App developers with reusable react components to make it easy to build Safe Apps with a near-native look and feel while still allowing to enable developers to use their branding in the Safe Apps.

Access Storybook

UI Guidelines

Existing Safe Apps

This is a list of several known public repositories containing Safe Apps for reference:

  • Transaction builder
  • WalletConnect
  • Open Zeppelin
  • Balancer - Pooling
  • Balancer - Exchange
  • 1inch Exchange
  • Synthetix
  • Sablier
  • Idle
  • Compound

Release Process

How to get your Safe Apps into the hands of users

As soon as you are done developing and testing your Safe App, you can already let some actual users test it by just simply sending them the link to the hosted Safe App and asking them to add it as a Custom App. This guide explains how to add custom apps.

Get your Safe App listed in the Safe Multisig

To organically reach Safe Multisig users, you want to have your Safe App directly listed, of course. For Gnosis to list your app, the Safe App needs to fulfill the following criteria: The Safe App manifest includes all the required information

1) Your Safe App must include a manifest.json file that contains the following data: (Example for this app)

  • "name": 'Name of your Safe App'

This is the official name of your Safe App, with a maximum of 20 characters.

  • "iconPath": 'sapp_logo.svg'

A file path to the logo that will be used alongside your Safe App. The icon must be a square SVG image of at least 256 by 256 pixels.

  • "description": 'A Safe App to compose custom multisend transactions'

Describe the functionality of your Safe App in 50-500 characters.

  • "providedBy": {"name": 'Gnosis', "url": 'https://gnosis.io'}

Your company or personal name and link to your company or personal domain.

2) Gnosis has reviewed the Safe App

While we won’t be able to do a proper audit for your Safe App, we still would like to take a look at the source code to raise issues or suggest improvements. Depending on whether your Safe App is open or closed source, please send us either a link to the public repo or an invitation to the private code repository.

We also would like to make a rough functional review of the app, so please provide us with a high-level test plan / feature list that allows our QA team to make sure everything works as intended in production.

3) The Safe App is hosted on IPFS

While we allow interacting with Safe Apps hosted on a regular web server through the Add custom app feature, we require listed apps to be hosted on IPFS. This ensures users can trust in the app being available at any time in the future without relying on the Safe App being hosted by the developer. Gnosis will take care of uploading your app to IPFS, but will require a compiled version of the app to do so.

Gnosis runs its own IPFS node and will make sure to pin your Safe App to guarantee availability.

4) Help us decode your Safe App transactions

We want to display interactions with Safe Apps as humand-readable as possible. To do this, we need the contract ABI of the contracts that your Safe App interacts with. The ideal way to do this would be to verify your contracts via Sourcify, which we can leverage to decode transactions interacting with those contract.

Alternatively, you can provide us with the ABIs as JSON files or the links to the verified contracts on Etherscan, so we can implement transaction decoding for your Safe App interactions.

Official launch and beyond

After we have reviewed and integrated your Safe App, the app will first be available in the staging versions (Rinkeby / Mainnet) of the Safe Multisig for you to do a final review. We would then approach you to coordinate the launch and a joint announcement.

At any point after the launch, if you or your users encounter issues with the Safe App, or you want to release an update to an existing Safe App, please get in touch with us.

safe@gnosis.io or via our Discord

Disclaimer

It is at the sole discretion of Gnosis to list or delist apps from the Safe Multisig. Safe Apps are not owned, controlled, maintained, or audited by Gnosis.

← Contract Proxy KitTutorials →
  • Introduction
    • Safe Apps Grants
    • On-chain stats
  • Development
    • Safe Apps SDK
    • UI Kit
    • Existing Safe Apps
  • Release Process
    • How to get your Safe Apps into the hands of users
    • Get your Safe App listed in the Safe Multisig
    • Official launch and beyond
    • Disclaimer
Gnosis Ltd.
ImprintCopyright
© 2020 Gnosis LTD
Copyright © 2021 Gnosis LTD