Skip to main content

Deploy a Wrapped Super Token

This guide offers detailed instructions for deploying Wrapped Super Tokens using the Super Token Factory contract.

info

Learn more about Wrapper Super Tokens in the Types of Super Tokens section.

Prerequisites

Before you start, ensure you have:

  • Basic understanding of blockchain and smart contracts.
  • Access to a compatible cryptocurrency wallet (like MetaMask).
  • ETH or relevant cryptocurrency for transaction fees.

Super Tokens Factory Contract

The Super Token Factory contract is used to create Super Tokens:

  • It is permissionless and can be used by anyone to create Super Tokens.
  • It is deployed on all the networks where you can find the Superfluid Protocol.

We will describe the steps for deploying each type of Super Token in the following chapters.

Contract addresses

For addresses of the Super Token Factory contract on different networks, refer to The Superfluid Explorer, the Protocol section.

SuperFluidConsole

SuperFluid Explorer: Protocol Section


Deploying a Wrapper Super Token

Are you looking for a Super Token?

Are you looking for a specific token? It may already exist.

Check the Explorer to see if someone else has already created and listed a wrapper for the token you are looking for.

You can deploy your own Wrapper Super Token using the Super Token Factory contract through the interface below. Please ensure you have the required parameters ready before proceeding:

  • Underlying Token: The address of the ERC20 token to wrap.
  • Name: The name of the Super Token. We always recommend using the same name as the underlying token prefexed with 'Super' (eg. 'Super DAI').
  • Symbol: The symbol of the Super Token. We recommend using the same symbol as the underlying token suffixed with 'x' (eg. 'DAIx').
What is Upgradability?

If you look at the CreateERC20Wrapper method at the Super Token Factory contract, you'll see a parameter called Upgradability.

This allows Superfluid Protocol Governance to upgrade the Super Token contract in the future and stay compatible with the latest features.

  • '0': Not Upgradable: The contract cannot be upgraded.
  • '1': Semi-Upgradability: The contract can be upgraded by Superfluid Protocol Governance but only under certain conditions.
  • '2': Fully Upgradable: The contract can be upgraded by Superfluid Protocol Governance without any restrictions.

For the purpose of simplicity, we always recommend using '1'. This is why this parameter is not included in the interface below and is set to 1 by default.

You can choose to deploy your Wrapper Super Token using the interface on your favourite scanner (eg. Etherscan). You can also use the interface below to deploy your Wrapper Super Token:

Create your Wrapped Super Token


Manual name and symbol

Manual name and symbol input is not recommended unless the deployer above gives you an error and is unable to detect the underlying token name and symbol. The recommended format is always 'Super' + 'Underlying Token Name' and 'Underlying Token Symbol' + 'x'.

Check Parameters

Double-check the parameters to avoid deployment errors.

Verifying and Adding Token to Superfluid Dashboard

After you token has been deployed, you can follow these steps in order to add your token to the Superfluid Dashboard:

  • Locate the new Super Token's address in the "SuperTokenCreated" event log. This will allow you to retrieve the Super Token address.

Super Token Address

Super Token Address on Etherscan

  • Follow these steps to submit your request. You will need to provide the Super Token address and some other information.

Deploying a Self-Governed Super Token

Self-Governed Super Tokens give you the ability to control and update Super Token logic.

Deployment Process

  1. Using SuperTokenFactory: Interact with the createERC20Wrapper function with the admin parameter on the SuperTokenFactory contract.
  2. Updating Logic: Use updateCode to apply custom logic or update to the latest Superfluid token contract.
tip

For more information, see the Self-Governed Super Token Wiki or seek assistance on Superfluid Discord.

Be careful!

Unless you know what you are doing, deploying a self-governed Super Token is not recommended.