Welcome to GoodDocs!

Here you will find all the documentation for the GoodDollar protocol Smart Contracts and Dapp interfaces.

Notice of Potential Information Variability

As of December 21, 2023, the information in GoodDocs may not reflect the most current updates. The team is diligently working to review and revise the documentation to ensure accuracy. Please check back at a later date for the most up-to-date information.

Welcome! GoodDollar is a decentralized universal basic income initiative. Here you can find all the open-source documentation for the smart contracts and interfaces!

Read project's whitepaper for deep dive into the philosophy and decision's rationals

Let's get started:

What is Gooddollar?

GoodDollar is a people-powered framework to generate, finance, and distribute global basic income in an open model via the GoodDollar token (“G$ coin”). Its goal is to provide a baseline standard of living and reduce wealth inequality through the creation of a universal basic income (UBI).

GoodDollar leverages new protocols and smart contracts to deliver a “trickle-up” value structure, which places money in the hands of those who need it most. This is the reverse of the conventional trickle-down approach to capital, credit, and interest-bearing money.

A digital asset that operates within the emerging ecosystem of decentralized and open finance, G$ coin is backed by a monetary reserve of cryptocurrencies and thus has tangible value. G$ coins are liquid and convertible to other cryptocurrencies, and will be available to buy and sell directly via the GoodDollar GoodReserve smart contract.

The value in the GoodDollar reserve comes from the interest that is generated from Supporters who stake cryptocurrencies in decentralized third-party protocols. Through the amassed reserve interest, G$ coins are minted. They are used to pay Supporters market-rate interest payments, while a daily amount of G$ coins is set aside to be distributed as basic income.

Four main components to the Gooddollar project:

  1. Easy to use Wallet with built-in community features

  2. Eco-system Dashboard

GoodDollar Protocol

GoodDollar operates on Ethereum using smart contracts that are written in Solidity with G$ designated as an ERC20 token. As a means to an end, transactions using G$ are run on an Ethereum sidechain, Fuse, which enables low-cost, high-volume transactions. As we anticipate that the scalability and efficiency of blockchain infrastructure will continuously improve.

  • GoodDollar offers a new standard for creating and distributing basic income via G$ token.

  • GoodDollar V3 is a smart contract upgrade that enables core functions for the GoodDollar protocol to scale.

  • GoodDollar V2 is a smart contract upgrade to expand functionality and open-source launch of a protocol user interface, deployed by community members.

  • GoodDollar V1 was initially deployed in August 2020.

  • Some Guides have been documented by the community. Feel free to contribute.

  • Everything is open-sourced and free to use on Github.

GoodDollar Dapp

Accessibility and ease of use are critical to market adoption. By widely distributing G$ through an accessible process and interface, we increase the odds that the basic income economy is widely adopted and strengthen the case for G$ to become a preferred complementary currency among holders.

  • Serves as a visual interface to the protocol core smart contracts on Ethereum mainnet.

  • The Dapp enables to stake, buy/sell G$ directly to reserve, and governance functionality.

  • The Dapp is 100% open-source, deployed and managed by community stakeholders. You can even deploy your own UI. Here's the repo

  • Below are community deployed UI, use at your own risk!

GoodDollar Wallet

To increase adoption and trust in the system, a simple digital wallet that can be accessed anywhere in the world with an internet connection has been built. The user experience focuses on the key action of “claiming” G$ coins as basic income and conducting peer-to-peer transactions.

The wallet is a mobile-friendly web application built on React with React Native and is open-source, as is all GoodDollar code. The wallet interacts with three main components: The GoodDollar Protocol, Identity solutions for verifying unique identity, Distributed login solutions (initially through the Tor.us platform).


  1. Frontend Wallet repo

  2. Backend Wallet repo

If you wish to contribute please read this.

Thanks for your interest!

The GoodDollar Team <3

Last updated