Skip to Content
SupraNova (Bridge)Roles and Permissions

Roles and Permissions

Every SupraNova contract and module has a single admin address. The admin can pause, configure and upgrade the contract or module, and transfer the admin role. On Mainnet, each admin address is a multisig account, so no single signer can take an admin action. Every admin action is an on-chain transaction that anyone can verify.

Admin accounts

MultisigChainAddressThresholdAdministers
Supra Foundation multisigEthereum0xdE92b2432d23815F06D0f32D056B154060241A0a9 of 19TokenVault
Operating multisigEthereum0x37C708285FF340AC1bCfaf0D0FB449e488Bb041b4 of 6TokenBridge, Hypernova, FeeOperator, WrappedTokenFactory
Supra Foundation multisigSupraMVM0xda20f7d0ec813c751926f06004a10bc6ee1eefc96798f6a1aa31447ee146f9329 of 19All SupraNova modules

Core members of the Supra ecosystem make up the Supra Foundation multisigs. Members of Supra’s cross-chain team make up the Operating multisig. On SupraMVM, the SupraNova modules are published under the multisig account itself, so the same multisig controls their upgrades.

Supra Foundation multisig on Ethereum

The Foundation multisig administers the TokenVault, which holds every asset locked on Ethereum. The Foundation multisig can:

  • Pause the vault. Stops all locking and releasing on Ethereum, which halts transfers in both directions for vault-held assets.
  • Enable or disable releases. Stops assets from being released while still allowing them to be locked.
  • Set limits. Configures the per-request lock and release limits and the global cap of each asset.
  • Upgrade the vault. Replaces the TokenVault implementation behind its proxy.
  • Transfer the admin role. Assigns the role to another account, so that governance can evolve without redeploying the vault.

Operating multisig on Ethereum

The Operating multisig administers the TokenBridge, the Hypernova verifier, the FeeOperator and the WrappedTokenFactory. The Operating multisig can:

  • Pause or resume the Hypernova message-passing contract and the TokenBridge independently.
  • Configure the bridge. Registers connected chains and tokens, and sets fee parameters.
  • Maintain the Supra committee. Sets the latest Supra committee directly if updates have been missed, and sets the epoch tolerance.
  • Withdraw collected fees.
  • Upgrade contracts. Replaces the implementation of any contract it administers.
  • Transfer the admin role of any contract it administers.

Supra Foundation multisig on SupraMVM

The Foundation multisig on SupraMVM administers every SupraNova module. The Foundation multisig can:

  • Upgrade modules. Publishes new versions of the message-passing and Token Bridge modules.
  • Pause each module independently.
  • Configure the bridge. Registers connected chains and tokens, and sets fee parameters, vault limits, the per-send limits of wrapped tokens, the verification strategy and the Sync Committee signature threshold.
  • Manage wrapped tokens. Deploys the wrapped token of each newly supported asset, and grants the Token Bridge the capability to mint it.
  • Transfer the admin role of any module.

Shared responsibilities

Some changes require more than one multisig:

  • Adding an asset held in the Ethereum vault. The Operating multisig registers the asset with the TokenBridge, and the Supra Foundation multisig on Ethereum sets its limits in the TokenVault.
  • Changing fees. The fees for each direction are configured on the chain that charges them. A change that affects both directions therefore needs approval from the multisigs on both chains.
Last updated on