MadFi Bounties Smart Contracts

Smart contracts for escrowing funds for bounties and issuing funds/rewards.

Usage

1. install Foundry
2. forge update to download dependencies
3. forge build to compile contracts
4. forge test to run tests

Bounties

Manages Bounties.

Functions:

• deposit: Specify amount and address of token. Transfers tokens into contract. Returns a id for the bounty.

• depositNft: Specify token uri and create a bounty with an nft as reward instead of cash

• rankedSettle: settles the bounty by distributing funds to each recipient that has a verified signature. Then posts to Lens and mirrors and/or follows if specified.

• nftSettle: settle an nft bounty

• topUp: add funds to a bounty

• close: close bounty and return remaining funds

Admin Functions

• setProtocolFee: sets the protocol fee (in basis points). Can only be called by contract owner.

• withdrawFees: withdraws all accumulated fees

• setMadSbt: sets the MadSBT contract, collection ID and profile ID

• setRewardNft: sets the RewardNft contract

RewardNft

An erc1155 contract that can be used for free bounties where winners are just minted an nft in a collection for that bounty.

PermissionedMintNft

An nft contract with unlimited supply that requires a signature from the contract owner to mint a token.

Scripts

source .env

# deploy bounties contract
forge script script/DeployBounties.s.sol:DeployBounties --rpc-url mumbai --broadcast --verify -vvvv

# withdraw fees
forge script script/WithdrawFees.s.sol:WithdrawFees --rpc-url mumbai --broadcast -vvvv

# test create nft bounty
forge script script/CreateNFTBounty.s.sol:CreateNFTBounty --rpc-url mumbai -vvvv

# test test settle bounty
forge script script/TestSettle.s.sol:TestSettle --rpc-url mumbai -vvvv

# create a sticker pack and mint one to sender and one to a recipient
forge script script/CreateSticker.s.sol:CreateSticker --rpc-url mumbai -vvvv

Deployment

1. Be sure to set correct last bounty id for your chain id
2. In ILensProtocol change the Types import to import {Types} from '../../contracts/libraries/constants/Types.sol'; before deploying because otherwise polygonscan verification messes up.
3. Run the deploy script
4. Set contract as verified on MadSBT contract so rewards can be distributed (optional - only needed if you want to use MadSBT rewards)

Bounties in depth

rankedSettle is the default way to pay out from a bounty.

function rankedSettle(uint256 bountyId, RankedSettleInput[] calldata input, uint24 fee) external

struct RankedSettleInput {
    uint256 bid;
    uint256 bidderCollectionId;
    address recipient;
    uint256 revShare;
    bytes signature;
    Types.PostParams postParams;
    Types.MirrorParams mirrorParams;
    FollowParams followParams;
}

input struct

• bid: the amount of the bounty token to be the recipient
• bidderCollectionId: if the bidder has a mad sbt badge they can specify the collection id here for revshare
• recipient: the address of the recipient
• revShare: the percent of the recipient's split to be distributed through their MadSBT badge. If they don't have a badge it will be ignored
• signature: signature of the entire struct (except signature) + bountyid signed by the recipient
• postParams: the params for the post to be made to Lens
• mirrorParams: the params for the mirror to be made to Lens (if any)
• followParams: the params for the follow to be made to Lens (if any)

RankedSettleInputQuote has the same params with QuoteParams instead of PostParams. Must be settled with rankedSettleQuote.

You can also do a rankedSettlePayOnly which will not interact with Lens at all and takes BidFromAction struct for each user.

struct BidFromAction {
    uint256 bid;
    uint256 bidderCollectionId;
    address recipient;
    uint256 revShare;
}

Other Params

• bountyId: the id of the bounty
• fee: if they include a rev share and the bounty token is not the same as the underlying asset for their mad sbt badge reward super token it will need to be swapped. this fee is the fee for the uniswap pool to swap through. It will be 500, 3000 or 10000 (0.05%, .3% or 1%)

NFT Bounties

Same deal but created with depositNft and settled with nftSettle, nftSettleQuote or nftSettlePayOnly. This bounty type creates an ERC1155 collection for the bounty and mints the nft to the recipient.

Deployments

Mumbai

RevShare: 0xa670F00913019cB0fd10F3597790143956Bda5D4

Bounties: 0xa363AB8e2b4e09AF678Ded095011AbB0A801947b

RewardNft: 0x86d25a4C55F27679c7109E6FEc24c6D85ad28AC6

Polygon

RevShare: 0x0B444d82B72F6572c2c10010FceaB010e7CC6FDd

Bounties: 0x606E8572e79852Cb0766fd95907FeE7b974e41Be

RewardNft: 0xC45dC3262A024d8962F74237fc7E990aa3Fbb407