Superfluid Host Overview

Superfluid host contract (Superfluid.sol) is the central contract that provides the following functionalities in the Superfluid framework:

Agreement System

First of all agreements are whitelisted, since a super token trusts them to provide real-time balance to their accounts.

The agreement framework consists of functions in the host contract that can only be called by a whitelisted agreement to:

• call the agreement callbacks of a super app,

• perform app credit accounting,

• jail a super app if it poses danger to the system or users.

To interact with the agreement, the call proxies of the host contract are used.

Super Token Factory

Super tokens can be created through the super token factory registered in the host contract. By doing so, the super token created delegates its logic contract update process to the governance process.

Note that, super tokens created not through the factory can still use the host contract.

App Registry

Super apps compose agreements and business logic together.

A contracts may opt-in being a super app through the app registry provided by the host contract.

Call Proxies

Call proxies is a technical to provide a transactional, secure and efficient heap-like shared memory data in EVM called "stamped Ctx" for both agreements and super app actions.

Batch Call

The host contract provides its bespoke solution for batch calls to super token operations, agreements operations and app actions.