Definition

We define a voting multiplier as the multiplication of existing voting power by increasing factor ( a number bigger than 1).
For example, some user holds 10 $BREAD , and has completed some tasks on guild.xyz , awarding him some NFTs. These could award him a voting multiplier of 10% (1.1), such that his voting power is now effectively equal to holding 11 $BREAD.

Motivation

Reward users for contributing or participating in Breadchain. Create incentives for further activity. Improve the governance process by weighing active and invested user's votes as more meaningful.

Multiplier Sources

Gnosis Chain

• A multiplier that has a source of truth on Gnosis chain

Cross Chain

• A multiplier which has a source of truth on some other blockchain (for practical reasons , an EVM blockchain which is bridgeable to Gnosis chain)

Off Chain

• A multiplier who's source of truth is some web2 application

Requirements

• It should be possible to define a temporary multiplier
• It should be possible to define a permanent multiplier
• It should be possible to define a dynamic multiplier which changes over time according to some variable
• Multipliers should support the ERC20Votes delegation design pattern
• It should be possible to define variable sources of truth for multipliers
• It should be possible to add / remove multipliers for the following voting cycle
• There should be a shared interface for all multipliers
• It should be possible to edit the source of truth for a multiplier
• Multipliers should be detected and attributed to a user at the time of voting

Concessions

• For a given multiplier , some action may be required in order to update / attribute a multiplier (such as minting an NFT , submitting proof of some activity or ownership of some asset)

High Level Overview

This overview suggests an implementation approach that relies on NFTs, allowing the usage of existing NFTs sanctioned by the Breadchain community. This approach also asserts that multipliers which require a custom implementation or some offchain integration can conform to an NFT design, providing a homogenous interface to all multipliers. This approach also provides forward compatibility to existing services which already implement NFT which breadchain may choose to adopt or increase usage of (such as CharacterSheets, [Guild])https://guild.xyz/breadchain) , Hats etc )

classDiagram 

class IMultiplier{
	getMultiplyingFactor(address) external view returns (uint256)
	validUntil(address) external view returns (uint256)
}


class INFTMultiplier{
	IERC721 NFTAddress 
	hasNFT(address) returns (bool)
}

class PermanentNFTMultiplier{
	uint256 multiplyingFactor 
	uint256 validity = type(uint256).max
}

class DynamicNFTMultiplier{
	address => uint256 userToFactor
	address => uint256 userToValidity
}

INFTMultiplier --|> IMultiplier 
PermanentNFTMultiplier --|> INFTMultiplier
DynamicNFTMultiplier --|> INFTMultiplier

class ERC721{

name() public view virtual returns (string memory)
symbol() public view virtual returns (string memory)
tokenURI(uint256 tokenId) public view virtual returns (string memory)
} 
class IERC721{
balanceOf(address owner) external view returns (uint256 balance)
ownerOf(uint256 tokenId) external view returns (address owner);

}
class IProveableMultiplier{
	submitActivities(bytes data) external 
	mint(address to, uint256 tokenId) internal
}

IProveableMultiplier --|> ERC721
IProveableMultiplier --|> DynamicNFTMultiplier 
ERC721 --|> IERC721
INFTMultiplier --o IERC721

class IOffChainProveableMultiplier{
	address pullOracle 
	
}
class IOnChainProveableMultiplier{
	address activityContract

}
class ICrossChainProveableMultiplier{
	address bridge 
}
IOffChainProveableMultiplier --|> IProveableMultiplier
IOnChainProveableMultiplier --|> IProveableMultiplier
ICrossChainProveableMultiplier --|> IProveableMultiplier

In order to integrate these multipliers into the existing voting infrastructure , the following contract will be deployed and referenced in the YieldDistributor

classDiagram
class VotingMultipliers{
	Bread BREAD 
	IMultplier[] whitelistedMultipliers 
	getTotalMultipliers(address) external view returns (uint256)
	queueMultiplierAddition(IMultiplier) external 
	queueMultiplierRemoval(IMultiplier) external
}

sequenceDiagram 
autonumber
BreadHolder ->> YieldDistributor : Cast vote 
YieldDistributor ->> YieldDistributor : Get voting power derived from holder's $BREAD and delegated $BREAD
YieldDistributor ->> VotingMultipliers : Loop and apply all existing multipliers of the holder
YieldDistributor ->> YieldDistributor : Apply Voting power 

Overview of Currently Desired Multipliers

Delegation

If a user has delegated their voting power on the $BREAD contract to another user, that should also delegate multipliers.