GroupBuy

Esse repositório contém um projeto de smart contract nomeado GroupBuy para compra compartilhada em massa na blockchain, ideia pensada pelo Daniel Haro como caso de uso para o workshop do BC "A tokenização das finanças: dos criptoativos às moedas digitais de bancos centrais". Usa o framework Hardhat.

Vendedores podem registrar lotes de itens tokenizados em forma de NFT e usuários fazem compras até que todo o lote seja vendido. Quando isso acontece, os usuários obtêm o token que representa o item físico e podem trocá-lo pessoalmente.

O ponto principal desse sistema é que um vendedor pode oferecer preço mais baixo em seus produtos caso seja garantido que vai vender um lote grande de uma vez só, como num atacado. Além disso existe toda a garantia de transparência e segurança da blockchain por trás, que registra a prova de pagamento, verifica que o vendedor possui propriedade sobre o que está anunciando, entre outros.

Contratos

GroupBuy

É a implementação do sistema de compra compartilhada e permite que o dono de uma coleção NFT anuncie tokens para venda. Permite que usuários comprem itens e também permite o cancelamento até que o lote seja completamente vendido.

BasicNft

É uma implementação básica de uma NFT seguindo o padrão ERC721, porém com uma função extra:

function mintMultiple(address receiver, uint256 amount) external

que é chamada pelo contrato GroupBuy para emitir NFTs para os compradores dos itens, após a venda completa de um lote.

BasicNftFactory

É um criador de NFTs compatíveis com a GroupBuy. Usado para criar NFTs pelo usuário, sendo útil principalmente para exemplificar o funcionamento do sistema no frontend.

Instalação

Precisa ter o npm ou yarn instalado.

git clone https://gitlab-vnt.venturus.org.br/venturus/chapters/blockchain/sharedeconomy.git
cd sharedeconomy
yarn install

Se visualizando pelo Github público:

git clone https://github.com/venturusbr/eth-group-buy.git
cd eth-group-buy
yarn install

Testes

Foram criados testes unitários para verificar o funcionamento esperado dos contratos. Para executá-los:

yarn run hardhat test

Os testes executados são listados abaixo:

  Testes unitários do contrato GroupBuy.sol
    Criação de lote para venda.
      ✓ Verifica se um lote é criado corretamente.
      ✓ Verifica que somente o dono da coleção pode criar um lote.
    Compras.
      ✓ Verifica o funcionamento da compra de itens.
      ✓ Verifica que é impossível comprar mais itens do que estão disponíveis.
      ✓ Verifica que é impossível comprar após a expiração do lote.
      ✓ Verifica que é impossível comprar pagando menos que o preço definido.
    Cancelamento.
      ✓ Verifica o cancelamento dentro do prazo.
      ✓ Verifica que é impossível cancelar mais do que comprou.
    Resgate.
      ✓ Verifica o resgate de itens após compra e finalização do lote.
      ✓ Verifica que é impossível resgatar depois de cancelar a compra.
      ✓ Verifica que é impossível resgatar mais de uma vez.


  11 passing (3s)