Instant AI
  • INSTRUCTION
    • What is Instant AI
    • Tokenomics
    • Governance Process Overview
    • Become a Strategist
  • Smart Contracts
    • Protocol (V2) Contract Architecture
      • Smart Contract Architecture Walk-Through
    • Roles & Permissions
    • External Protocol Integration
      • Building Adaptors
        • BaseAdaptor
        • Protocol-Specific Functionality
        • Adaptor Configuration
        • Security Considerations
        • Debt Adaptors
        • Adaptor Uses to Keep in Mind
      • Building Pricing Extensions
    • Smart Contracts & Governance
    • Smart Contract Addresses
    • Advanced Smart Contracts
      • Registry Details
        • Registry.sol API
      • PriceRouter Details
        • Oracle Usage and Asset Pricing
        • PriceRouter.sol API
      • Cellars (aka ERC 4626 Vaults)
      • Adaptors
        • BaseAdaptor.sol API
      • Fees And Reserves
      • Portfolio (V1.5) Contract Architecture
  • Strategists
    • Overview
    • Protobuf
    • Requests
    • Adaptors
  • PROTOCOL
    • How does the protocol work?
    • Validators
    • Gravity Bridge
    • Steward
    • Auction module and participation
Powered by GitBook
On this page
  1. Smart Contracts

Roles & Permissions

PreviousSmart Contract Architecture Walk-ThroughNextExternal Protocol Integration

Last updated 6 months ago

Every Instant AI Cellar is a distributed effort, and multiple parties are needed to develop, deploy, and grow a successful cellar. This has been shown in the schematics so far (shown again below for easier reference).

Users

Users can use Cellars to earn yield on their deposits - the functionality available to all users follows the . Users of Cellars may:

  • Deposit funds into a Cellar to earn yield, via the deposit and mint functions

  • Withdraw deposits from Cellars, via the withdraw and redeem functions

  • Transfer cellar shares to another address, via transfer and transferFrom functions

See the for the differences between deposit/withdraw and mint/redeem.

Strategists

Strategists are the managers of a Cellar, who develop and execute the strategies that earn users yield. Strategists functionality is limited to the supported adaptors for each Cellar (see "Adaptors").

Each strategist can perform actions through their adaptors via the callOnAdaptor function. Strategists must craft their target adaptor calls, with associated calldata, and submit them via the Instant AI chain. The Gravity Bridge then forwards the strategist's provided payload to the callOnAdaptor function.

For a more comprehensive description of all the ways strategists can use adaptors to create and execute on-chain strategies, see the section.

In addition to adaptor calls, strategists can manage the ordering of their cellar's positions. This ordering informs withdrawal priority for a given Cellar - the first positions will be withdrawn from first. Positions can be managed using the following calls:

  • setHoldingPosition

  • addPosition

  • removePosition

  • swapPositions

Governance

Instant AI's governance body, governed by stakers of native $INSTANT on the Instant AI Chain, is responsible for the security and configuration of both individual Cellars, as well as the entire Cellar infrastructure. The INSTANT Governance carries out some direct management of the Instant AI protocol architecture, and votes in a multi-sig to carry out other responsibilities, as seen in the above image.

INSTANT Governance

Within the context of a single cellar, governance has the following abilities:

  • Initiate and lift shutdowns of the Cellar in emergency scenarios, via initiateShutdown and liftShutdown.

  • Set the amount of time cellar deposits are initially locked, via setShareLockingPeriods (see "Share Locking Periods" for more information, also this only affects Cellars that do not have share price oracles).

  • Set up new adaptors, and positions for a given cellar to enable new functionality, via addAdaptorToCatalogue, and addPositionToCatalogue.

INSTANT Governance Voted In Multi-Sig

The Multi-Sig is voted in via INSTANT Governance and can be voted out at any time. Together, the Multi-Sig and the INSTANT Governance carry overlapping responsibilities to manage the Registry, PriceRouter and the Cellars. The Multi-Sig handles aspects associated with the Registry and PriceRouter, of which include:

  • Change automation settings on the Price Router, via setAutomationRegistry, setGasFeed, setGasConstant, and setMinDelta.

  • Setting the address of the fee distribution mechanism on the Instant AI Chain, via setFeesDistributor.

  • Enabling cellars to use a newly deployed adaptor given certain risk parameters, via trustAdaptor.

  • Enabling cellars to use positions that interact with trusted adaptors given certain risk parameters, via trustPosition.

Use of `onlyOwner`

Set the allowed rebalance deviation for a cellar during a batch of adaptor calls, via setRebalanceDeviation (see for more information).

Adding new assets to the Price Router via addAsset (see for more information).

Adding new slots to the Registry via register, or updating existing stored addresses (see for more information).

Those reading the contracts will notice that within Solidity code, both Strategist and Governance functions are protected with onlyOwner and no further modification. All Cellar and Cellar infrastructure deployments are owned by the . Therefore, both strategists and governance cannot interact with the contract directly via the EVM - they must submit their updates to the Instant AI chain itself, which will forward them to the Gravity Bridge for execution on Ethereum mainnet. This forwarding process is where the delineation between "strategist permissions" and "governance permissions" takes place.

ERC4626 interface
ERC4626 standard
"Adaptors"
"Adaptors"
"Price Router"
"Registry"
Gravity Bridge