TypeScript icon, indicating that this package has built-in type declarations

2.0.24 • Public • Published


Actions Status Coverage Status npm version

Versions 2+ of GoodDollar smart contracts

Submit bug bounties via Hats.Finance


SuperGoodDollar is an implementation of the GoodDollar token which adds functionality implemented by the Superfluid protocol, making it a Super Token.

SuperGoodDollar is implemented as a Pure Super Token - it has no underlying ERC20.
This is possible because Super Tokens are themselves ERC20 tokens.

The SuperGoodDollar contract is composed like this: GoodDollarProxy is a minimal base contract. It's responsible for state storage and for dispatching calls to the appropriate logic contract via delegatecall. Its initialize method connects the proxy to 2 logic contracts:

  1. the canonical SuperToken logic of the Superfluid framework
  2. the logic specific for the GoodDollar token (GoodDollarCustom) The proxy's initialize then invokes the initializer methods of both connected logic contracts. The contract GoodDollarCustom overrides some of the method already implemented by the SuperToken contract. Such overriding across different logic contracts can be done by making external calls to the base implementation. For convenience, this is handled by the base contract SuperTokenBase which wraps SuperToken methods to be overrided.

Dual upgradeability of the 2 connected logic contracts is achieved this way:

  1. upgrades of the SuperToken logic are handled by Superfluid governance, as is the case for other SuperTokens
  2. upgrades of the GoodDollar logic is handled by the configured owner(s). The interface is the same (UUPSProxy), but with changed method names in order to avoid naming clashes. See example test case.

The tests in SuperGoodDollar.ts aren't comprehensive (not ready for production), but sufficient to prove that the mechanism with 2 logic contracts works.

Package Sidebar


npm i @gooddollar/goodprotocol

Weekly Downloads






Unpacked Size

17.1 MB

Total Files


Last publish


  • lbwgd
  • sirpush
  • alexey-goddollar