PartyBid is a protocol that allows a group of internet homies to pool their funds together in order to win an NFT auction.
PartyBid is the first product developed by PartyDAO, a decentralized autonomous organization that builds and ships products. PartyDAO was created initially for the purpose of shipping PartyBid. To keep up with PartyDAO, follow @prtyDAO on Twitter and Mirror. Acquire 10 $PARTY tokens to join the DAO and party with us.
- A PartyBid contract is deployed targeting a single NFT auction
- Anyone can contribute ETH to the PartyBid while the auction is still live
- Anyone who has contributed to the PartyBid can trigger a bid on the targeted NFT auction
- After the auction closes, if the PartyBid won the NFT, the token is fractionalized; all contributors whose funds were used to win the auction are rewarded with ERC-20 tokens representing a fractionalized share of the NFT. Tokens are fractionalized using fractional.art contracts
- If a PartyBid wins the NFT, a 5% fee is paid to the PartyDAO multisig
startParty- deploy a PartyBid contract, specifying the NFT auction to target
contribute- contribute ETH to the PartyBidbid- trigger a bid on the NFT auction. Always submits the minimum possible bid to beat the current high bidder. Reverts if the PartyBid is already the high bidder.finalize- call once after the auction closes to record and finalize the results of the auction. Deploys the fractionalized NFT vault if the PartyBid won.claim- call once per contributor after the auction closes to claim fractionalized ERC-20 tokens (for any funds that were used to win the auction) and/or excess ETH (if the auction was lost, or if the funds were not used to win the auction)recover- callable by the PartyDAO multisig to withdraw the NFT if (and only if) the auction was incorrectly marked as Lost
contracts/PartyBid.sol- core logic contract for PartyBidcontracts/PartyBidFactory.sol- factory contract used to deploy new PartyBid instances in a gas-efficient mannercontracts/market-wrapper- MarketWrapper contracts enable PartyBid to integrate with different NFT auction implementations using a common interfacedeploy- Deployment script for contractstest- Hardhat tests for the core protocolcontracts/external- External protocols' contracts (Fractional Art, Zora Auction House, Foundation Market), copied to this repo for use in integration testing.contracts/test- Contracts written for use in testing
- Install dependencies
npm i- Setup your
.envfile in order to deploy the contracts
touch .env && cat .env.example > .envThen, populate the values in .env.
To run the Hardhat tests, simply run
npm run testYou can find the address of deployed PartyBid Factories on each chain at deploy/deployed-contracts
To deploy a new PartyBid Factory, first ensure you've populated your .env file. The RPC endpoint should point chain you want to deploy the contracts, and the private key of the Deployer account should be funded with ETH on that chain .
Next, add a config file to deploy/configs/[CHAIN_NAME].json specifying the addresses of the necessary external protocols on that chain. You can use other files in that folder to see which contract addresses must be populated.
Finally, run
npm run deployThe findings from the security review for PartyBid contracts can be found here. The security review was completed by Alex Towle.
- Anna Carroll authored the code in this repo
- Steve Klebanoff, Arpit Agarwal and Graeme Boy advised on the design of the contracts and reviewed the implementation code
- Anish Agnihotri authored the original PartyBid proof-of-concept, and built the PartyBid frontend
- Alex Towle completed the security review of the contracts
- John Palmer coordinated and product managed the project
- Danny Aranda managed operations, partnerships & marketing
- fractional.art team created the fractionalized NFT code for the post-auction experience
- Denis Nazarov had the original idea for PartyBid and organized the crowdfund that created PartyDAO
PartyBid contracts are reproduceable under the terms of MIT license.
MIT © PartyDAO