Super Tokens - Solidity
Interacting with Super Tokens in Solidity
Super Tokens have basic ERC20 functionality, some ERC777 functionality, and several functions to accommodate Superfluid Protocol functionality.
Super Token Contract
Super Token Interface
Remix Example Contract
Notice that the Super Token interface doesn't appear to show any Super Agreement functionality (i.e. there's no function in them that starts a stream or does a distribution). Why? Basically, Super Agreements are separate contracts! Computing your Super Token balance is a matter of netting the effects of each Super Agreement into your actual balance. This all happens when you view your balance with balanceOf
. See this explained in our Super Token In-Depth Explainer,
Getting Set To Interact With Super Tokens
Import the Super Token interface in your .sol file.
import { ISuperToken } from "@superfluid-finance/ethereum-contracts/contracts/interfaces/superfluid/ISuperToken.sol";
ERC20 Functions
Super Tokens offer you all the basic ERC20 features. Learn more about these functions here on OpenZeppelin.
Interface
function totalSupply() external view override(IERC777, IERC20) returns (uint256);
function balanceOf(address account) external view override(IERC777, IERC20) returns(uint256 balance);
function transfer(address recipient, uint256 amount) external override(IERC20) returns (bool);
function allowance(address owner, address spender) external override(IERC20) view returns (uint256);
function approve(address spender, uint256 amount) external override(IERC20) returns (bool);
function transferFrom(address sender, address recipient, uint256 amount) external override(IERC20) returns (bool);
function increaseAllowance(address spender, uint256 addedValue) external returns (bool);
function decreaseAllowance(address spender, uint256 subtractedValue) external returns (bool);
Example: Calling transfer
transfer
ISuperToken(superTokenAddress).transfer(receiverAddress, amountToTransfer)
ERC20 Wrapping Functions
These are functions for Wrapper Super Tokens to implement such that you can wrap an underlying ERC20 token into and out of the Wrapper Super Token contract. See this quick explainer on Wrapper Super Tokens.
Interface
function getUnderlyingToken() external view returns(address tokenAddr);
function upgrade(uint256 amount) external;
function upgradeTo(address to, uint256 amount, bytes calldata data) external;
function downgrade(uint256 amount) external;
Example: Using upgrade
to wrap tokens into Super Tokens
upgrade
to wrap tokens into Super TokensThe upgrade
function does the wrapping using transferFrom
to pull the underlying ERC20 token from your wallet. As a result, before you can wrap your tokens into Super Tokens, you need to approve
the Super Token contract to be able to spend your underlying ERC20.
// approving
IERC20(underlyingTokenAddress).approve(superTokenAddress, amountToWrap)
// wrapping
ISuperToken(superTokenAddress).upgrade(amountToWrap);
Example: Calling upgradeTo
upgradeTo
Usage of upgradeTo
is rare but useful. It allows you to designate another address that will receive the upgraded tokens and call the tokensReceived
implementation on it. Essentially, it combines the ERC777 send
with plain upgrade
.
// approving
IERC20(underlyingTokenAddress).approve(superTokenAddress, amountToWrap)
// using upgradeTo (use "0x" for calldata if you don't want to pass in anything)
ISuperToken(superTokenAddress).upgradeTo(receiverAddress, amountToWrap, "0x");
Example: Using downgrade
to unwrap Super Tokens
downgrade
to unwrap Super TokensUnwrap your Super Tokens into the underlying ERC20 tokens.
// unwrapping
ISuperToken(superTokenAddress).downgrade(amountToUnwrap)
ERC777 Functions
Super Tokens also have some ERC777 features. Learn more about these functions here on OpenZeppelin. Note that not all ERC777 functionality is available - read more below ๐
ERC777 in Super TokensInterface
function granularity() external view override(IERC777) returns (uint256);
function send(address recipient, uint256 amount, bytes calldata data) external override(IERC777);
function burn(uint256 amount, bytes calldata data) external override(IERC777);
function isOperatorFor(address operator, address tokenHolder) external override(IERC777) view returns (bool);
function authorizeOperator(address operator) external override(IERC777);
function revokeOperator(address operator) external override(IERC777);
function defaultOperators() external override(IERC777) view returns (address[] memory);
function operatorSend(
address sender,
address recipient,
uint256 amount,
bytes calldata data,
bytes calldata operatorData
) external override(IERC777);
function operatorBurn(
address account,
uint256 amount,
bytes calldata data,
bytes calldata operatorData
) external override(IERC777);
Native Asset Functions
These are functions that only Native Asset Super Tokens possess to allow wrapping and unwrapping of native assets (like MATIC or AVAX). While the interface is named ISETH.sol, it is used for all Native Assets Super Tokens (MATICx, AVAXx, etc.).
Import the ISETH Interface in Your .sol File.
import "@superfluid-finance/ethereum-contracts/contracts/interfaces/tokens/ISETH.sol";
Interface
function upgradeByETH() external payable;
function upgradeByETHTo(address to) external payable;
function downgradeToETH(uint wad) external;
Example - Wrapping a Native Asset
ISETH(superTokenAddress).{ value : amountToUpgrade }.upgradeByETH()
Full Super Token Interface
See our GitHub for full comments
interface ISuperToken is ISuperfluidToken, TokenInfo, IERC20, IERC777 {
function initialize(
IERC20 underlyingToken,
uint8 underlyingDecimals,
string calldata n,
string calldata s
) external;
/**************************************************************************
* TokenInfo & ERC777
*************************************************************************/
function name() external view override(IERC777, TokenInfo) returns (string memory);
function symbol() external view override(IERC777, TokenInfo) returns (string memory);
function decimals() external view override(TokenInfo) returns (uint8);
/**************************************************************************
* ERC20 & ERC777
*************************************************************************/
function totalSupply() external view override(IERC777, IERC20) returns (uint256);
function balanceOf(address account) external view override(IERC777, IERC20) returns(uint256 balance);
/**************************************************************************
* ERC20
*************************************************************************/
function transfer(address recipient, uint256 amount) external override(IERC20) returns (bool);
function allowance(address owner, address spender) external override(IERC20) view returns (uint256);
function approve(address spender, uint256 amount) external override(IERC20) returns (bool);
function transferFrom(address sender, address recipient, uint256 amount) external override(IERC20) returns (bool);
function increaseAllowance(address spender, uint256 addedValue) external returns (bool);
function decreaseAllowance(address spender, uint256 subtractedValue) external returns (bool);
/**************************************************************************
* ERC777
*************************************************************************/
function granularity() external view override(IERC777) returns (uint256);
function send(address recipient, uint256 amount, bytes calldata data) external override(IERC777);
function burn(uint256 amount, bytes calldata data) external override(IERC777);
function isOperatorFor(address operator, address tokenHolder) external override(IERC777) view returns (bool);
function authorizeOperator(address operator) external override(IERC777);
function revokeOperator(address operator) external override(IERC777);
function defaultOperators() external override(IERC777) view returns (address[] memory);
function operatorSend(
address sender,
address recipient,
uint256 amount,
bytes calldata data,
bytes calldata operatorData
) external override(IERC777);
function operatorBurn(
address account,
uint256 amount,
bytes calldata data,
bytes calldata operatorData
) external override(IERC777);
/**************************************************************************
* SuperToken custom token functions
*************************************************************************/
function selfMint(
address account,
uint256 amount,
bytes memory userData
) external;
function selfBurn(
address account,
uint256 amount,
bytes memory userData
) external;
function selfTransferFrom(
address sender,
address spender,
address recipient,
uint256 amount
) external;
function selfApproveFor(
address account,
address spender,
uint256 amount
) external;
/**************************************************************************
* SuperToken extra functions
*************************************************************************/
function transferAll(address recipient) external;
/**************************************************************************
* ERC20 wrapping
*************************************************************************/
function getUnderlyingToken() external view returns(address tokenAddr);
function upgrade(uint256 amount) external;
function upgradeTo(address to, uint256 amount, bytes calldata data) external;
function downgrade(uint256 amount) external;
/**************************************************************************
* Batch Operations
*************************************************************************/
function operationApprove(
address account,
address spender,
uint256 amount
) external;
function operationTransferFrom(
address account,
address spender,
address recipient,
uint256 amount
) external;
function operationUpgrade(address account, uint256 amount) external;
function operationDowngrade(address account, uint256 amount) external;
}
Last updated
Was this helpful?