Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gakonst/lootloose
Open your Loot bags and see what's inside
https://github.com/gakonst/lootloose
Last synced: 18 days ago
JSON representation
Open your Loot bags and see what's inside
- Host: GitHub
- URL: https://github.com/gakonst/lootloose
- Owner: gakonst
- License: gpl-3.0
- Created: 2021-08-31T21:33:56.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2021-10-15T12:20:42.000Z (about 3 years ago)
- Last Synced: 2024-10-04T11:34:01.037Z (about 1 month ago)
- Language: Solidity
- Homepage:
- Size: 470 KB
- Stars: 78
- Watchers: 7
- Forks: 25
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-dapptools - Lootloose
README
#
LootLoose
**Open your Loot bags and see what's inside**
LootLoose is an ERC-1155 contract which allows you to:
1. Open your [Loot bags](https://www.lootrng.com/) and mint 8 ERC-1155 tokens, corresponding to each item
in the bag
2. Re-assemble your ERC721 bag by giving back the ERC-1155 tokens to the contract
Each ERC1155's token URI is a b64 encoded SVG image, with the item's name (just that item's, not
any other item from the bag that contained it).
You can mint the 8 ERC-1155 tokens via 2 ways:
1. `approve` the `LootLoose.sol` contract to spend your NFT (or via `setApprovalForAll`) and calling `open`.
2. Transferring your NFT directly to the contract, triggerring the `onERC721Received` callback
You can reassemble the bag by first `approve` or `setApprovalForAll` for the tokens
contained in the bag and then calling `reassemble`.
Average gas cost to `open` is 322k gas, to `reassemble` 165k.
A UI is available for these contracts at [lootloose.com](https://lootloose.com) ([repo](https://github.com/Anish-Agnihotri/lootloose.com))
## Building and testing
```sh
git clone https://github.com/gakonst/lootloose
cd lootloose
make
make test
```
## Installing the toolkit
If you do not have DappTools already installed, you'll need to run the below
commands
### Install Nix
```sh
# User must be in sudoers
curl -L https://nixos.org/nix/install | sh
# Run this or login again to use Nix
. "$HOME/.nix-profile/etc/profile.d/nix.sh"
```
### Install DappTools
```sh
curl https://dapp.tools/install | sh
```
### Security Notes
* In order to improve gas efficiency, OZ's ERC1155.sol was patched to expose the `_balances`
mapping. We use that to do a batch mint inside `open`.
* Dom's original [LootComponents](https://twitter.com/dhof/status/1432403895008088064) was modified
to be cheaper to use, since it did a lot of redundant `SLOAD`s in hot code paths.
### Disclaimer
_These smart contracts are being provided as is. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of the user interface or the smart contracts. They have not been audited and as such there can be no assurance they will work as intended, and users may experience delays, failures, errors, omissions, loss of transmitted information or loss of funds. Paradigm is not liable for any of the foregoing. Users should proceed with caution and use at their own risk._