# Pigletz

The first NFT that materializes!

![](/files/TFQSZJt1FW8AEdQ6Ca6m)

## Overview

Pigletz is a collectible game with DeFi elements. It is built around the main character - the Piglet, an NFT having a utility as a piggy bank where users can deposit crypto tokens and earn PiFi. Pigletz are items. A contemporary version of a piggy bank. An item that can exist in the Metaverse. And also can exist in the real world. But not in both. Each Piglet starts its life randomly minted and at level 1. Being at level 1 means that only some of its traits are revealed. In order to progress with levels and reveal more traits the owner of the Piglet needs to wait and collect PiFi (similar as eXperience Points). There are options to speed up the collection - for example by completing tasks and activating boosters. Each Piglet has its own wallet - a smart contract that is owned by the Piglet itself. Breaking is the final step in the life of a Piglet. By breaking it the owner is actually killing it, losing its NFT/collectable value, but gaining all the assets within it. One of its unique features is the option to materialize the Piglet. In order to do that the owner stakes the piglet in a specific contract and obtains a real 3D printed Pigletz figure. While being materialized the NFT is locked and cannot be transferred. The only way to unlock it is to break the Pigletz figure (in the real world) and to use the codes inside of it to unlock it. At the end the game is all about the dilemma - which is more valuable - the Piglet as an NFT or the tokens inside of it.

## How it Works

{% embed url="<https://youtu.be/kzdDbAKmmow>" %}

## Key Features

Pigletz is a combination between a NFT, Game, DeFi, MetaVerse and RealWorld elements. Below we will explain how it fits into each segment.&#x20;

### NFT

Pigletz is a collection of ERC721 tokens aka NFTs with the following characteristics:

* 12,345 unique Limited Edition Pigletz with provable random characteristics of various rarity
* 100% hand-crafted 3d models
* A total of over 2 billion combinations possible
* Randomly minted on purchase
* Characteristics get revealed as your Piglet grows
* Additional 5 celebrity NTF's going to charity

![](/files/DhHvOcQnZKgHbWeUsc7k)

{% content-ref url="/pages/9261mn8WT1sksNjKwBGS" %}
[NFT](/pigletz/nft)
{% endcontent-ref %}

### Game

Unlike many other NFT projects Pigletz is not only offering beautiful pictures to the users but an entire game experience where the Piglet is the main character.&#x20;

* Level up to reveal Piglet traits and improve base mining rate.
* Collect and apply boosters to increase token production speed even further.
* Monitor and manage your Pigletz through our convenient Dapp

![](/files/qRgYzoBbgGNP3bQbge8A)

{% content-ref url="/pages/ps3sQLAEmMkLCxH5NrGZ" %}
[Game](/pigletz/game)
{% endcontent-ref %}

### Tokenomics

Our Pigletz produce their own token called PiFi. PiFi tokens are used for leveling up the piglet, in the DeFi services as well as to order the physicall piglet. In the future PiFi will be part also in our MetaVerse.

![](/files/TahmhKhxL8MXINvJQSVN)

{% content-ref url="/pages/w31CCnFOEnTwLb6xyiLm" %}
[Tokenomics](/pigletz/tokenomics)
{% endcontent-ref %}

### DeFi

Pigletz has a utility as a Piggy Bank. It also mints its own token. We have designed additional DeFi services which can be used within the Pigletz ecosystem.

![](/files/xdrCqcKmzIRYQutOCK00)

{% content-ref url="/pages/5B0rS7LadPlw2lel12Mh" %}
[DeFi](/pigletz/defi)
{% endcontent-ref %}

### Real World

Pigletz is the first project introducing a protocol where an NFT can jump between the MetaVerse and the Real World. We call this Materialization. Reverse process is also possible and we call it Digitalization.&#x20;

![Materialization / Digitalization](/files/bvy8kSgOIJr8TGZYLjXB)

{% content-ref url="/pages/gtCr74XvRaecPTX13FUe" %}
[Materialization](/pigletz/materialization)
{% endcontent-ref %}

## Roadmap

See what is coming.

{% content-ref url="/pages/OUmr9BC1TmBBJnN4fYXH" %}
[Roadmap](/pigletz/roadmap)
{% endcontent-ref %}

## Contacts

{% embed url="<https://pigletz.com>" %}
Web
{% endembed %}

{% embed url="<https://discord.gg/ffCBEy7H5B>" %}
Discord
{% endembed %}

{% embed url="<https://t.me/+A-ruHvQV4mQyMzE8>" %}
Telegram
{% endembed %}

{% embed url="<https://twitter.com/PigletzNFT>" %}
Twitter
{% endembed %}

© 2021-2022 Pigletz


# NFT

In the beginning it was NFT. At the end it became so much more.

## The Piglet

The Piglet is as an NFT is a high quality render of a 3D model. Each model has different traits. The traits are combined with different probability in order to produce 12,345 unique 3D Pigletz.&#x20;

## The Traits

All traits are divided into the following categories:

* <mark style="color:blue;">**Gender**</mark> - we have Male and Female Pigletz and all the traits below are different for each gender. However we also have Other gender which can mix between Male and Female traits.&#x20;
* <mark style="color:blue;">**Body**</mark> - there are 12 different body types such as Pink, Gold, Stone, ....
* <mark style="color:blue;">**Mouth**</mark> - we have 16 mouths such as Smiling, Smoking Cigar, ...
* <mark style="color:blue;">**Eyes**</mark> - 16 types such as Blue, Crying, Bitcoin etc.
* <mark style="color:red;">**Hairstyle**</mark> - 25 different hairstyles exists. Female Pigletz have more.&#x20;
* <mark style="color:red;">**Beard style**</mark> - Only Male Pigletz has beard styles, totally 6 variants.
* <mark style="color:green;">**Earrings**</mark> - totally 10
* <mark style="color:green;">**Nose Piercing**</mark> - 6 styles
* <mark style="color:green;">**Glasses**</mark> - we have 11 (sun)glasses options
* <mark style="color:green;">**Tattoo**</mark> - 7 options

Not all traits are visible from the beginning (birth of the Piglet).&#x20;

<mark style="color:blue;">**Blue**</mark> traits are visible on level 1

<mark style="color:red;">**Red**</mark> are revealed on level 2

Finally on level 3 the <mark style="color:green;">**Green**</mark> are shown and this completes the look of the Piglet.

<div align="center"><img src="/files/zHBOvT6fTSgGzAQlK4jZ" alt="Level 3 Pigletz"></div>

### Additional Traits

There are also some additional traits such as:

* **Background** - There are 6 different backgrounds - Blue, Green, Orange, Purple, Red, Yellow
* **Zodiac Signs** - following the Western Zodiac they are: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces

## Production

We followed a long path until we finally achieved the Pigletz we all love.&#x20;

We started with concept art from different artists

![](/files/3kffrHEguqDLu5JEx86A) ![](/files/oF23i5lnIvHhgTrpu6d8) ![](/files/ATWr9mwPXrCr6kCQMwti) ![](/files/1yKaxtevtlYSXHxtEaNq)

And more ...

![](/files/enSreBza8epEZAbFk3RJ) ![](/files/eWO9HtiDloTegAgHXS1b) ![](/files/4j2byAdDmjseQGhtrz8I) ![](/files/Gfnzf9mFTUz8i2Vj9NLf)

...

Next we created 3D models, objects, meshes for all the categories and traits

{% embed url="<https://youtu.be/1ZluekmuPCw>" %}
Cinema 4D Modelling
{% endembed %}

{% embed url="<https://youtu.be/40I3BFiN960>" %}
Cinema 4D Rendering
{% endembed %}

We developed a generator which we used to produce 12,345 different trait combinations based on a rarity table and randomness. For the random function we used the magic seed: 1638504306 which is the Unix Epoch representation of the data December 3, 2021 4:05:06 AM or 12/3/4:5:6.

```python
"""
Main
"""
from pathlib import Path
import time
import click
from pigletz.discounts_generator import PigletzDiscountsGenerator
from pigletz.generator import PigletGenerator
from pigletz.image_optimizer import ImageOptimizer
from pigletz.post_processing import PigletPostProcessing


@click.group()
def cli() -> None:
    """
    Pigletz traits generator. (c) 2021 by Pigletz.com 
    """


@click.command()
@click.argument("inputfile", required=True)
@click.option("--limit", default=12345, type=int, help="How many piglets to generate")
@click.option("--seed", default=1638504306, type=int, help="Seed for the RNG")
@click.option("--out", help="Output json file")
def generate(inputfile: str, out: str, limit: int, seed: int):
    """ Generates json file with traits """

    generator = PigletGenerator.from_json(inputfile, limit, seed)
    data = generator.generate()
    generator.save_to_file(out, data)

```

Next we wrote a plugin for Cinema 4D that helped us to render all 12,345 different Pigletz.

```python
if __name__ == "__main__":

    filename = c4d.storage.LoadDialog(
        title="Load piglets JSON file", type=c4d.FILESELECTTYPE_ANYTHING, flags=c4d.FILESELECT_LOAD)
    with open(filename, "rb") as file:
        data = json.load(file)

    piglets = list(data["population"].keys())
    piglets.sort()

    start = int(gui.InputDialog(
        "Start from (0-{limit})?".format(limit=len(piglets)-2), "0"))
    end = int(gui.InputDialog(
        "Ending to (1-{limit})?".format(limit=len(piglets)-1), str(len(piglets)-1)))

    processPiglets(piglets[start:end], start, end)

```

Finally we used a rendering farm that rendered 12,345 Pigletz in each 4 variations (for each level). This took about 10 days.&#x20;

After that we post processed all renders to achieve the final result:

![](/files/KxH8WU6W4iYogeV589yD)

## The Blockchain

NFT or Non Fungible Token is a token living in the blockchain, described by s Smart Contract following the [ERC721 standard](https://eips.ethereum.org/EIPS/eip-721).&#x20;

Each NFT has usually two parts:

* Blockchain part - smart contract, describing the NFT as ERC721 token with a limited supply, allowing minting and transfers of the tokens etc.
* Meta Data - text information combined with media data that is the actual representation of the NFT, the one the user sees/hears/... .

Pigletz resides at the moment in the [Binance Smart Chain blokchain](https://openzeppelin.com/contracts/). Its contract can be found at the following address: [0xbF84076b06a100d38ce562733098eDc0eDa4D7f7](https://bscscan.com/address/0xbf84076b06a100d38ce562733098edc0eda4d7f7#code)

The contract utilizes the [OpenZeppelin ](https://openzeppelin.com/contracts/)framework which is a de facto standard for EVM compatible blockchains.

The meta data if the Pigletz is uploaded to the [IPFS](https://ipfs.io/) which gives higher level of decentralization and security to our users. For example the first minted piglet #4041 can be found here: <https://ipfs.io/ipfs/QmZ88agv3zymNctxFtraparboWZ8o2jSxV6T6XnFThYVBJ>

### Minting

The Minting process for the Pigletz is part of their smart contract. Minting selects a random token ID from all available tokens in the entire set of 12,345 and assigns it to the user. Minting rights are delegated to a specified contract called SalesManager which requires BNB to be sent in exchange of piglet(s). Minting allows 1, 5, 10 or 20 Pigletz to be minted within a single transaction.&#x20;

Discount codes can be passed as well allowing the user to reduce the price from 10% up to 50%. The discount codes can be obtained by engaging with our communities in [Discord](https://discord.gg/ffCBEy7H5B), [Twitter](https://twitter.com/PigletzNFT), [Telegram](https://t.me/+A-ruHvQV4mQyMzE8), [Reddit ](https://www.reddit.com/r/pigletz/)or [Facebook](https://www.facebook.com/PigletzNFT/).


# Game

Pigletz features gamification elements.

## Levels

![](/files/qRgYzoBbgGNP3bQbge8A)

Each piglet starts his life in Level 1. There only some traits are visible - gender, body, eyes, mouth, zodiac, background ([see NFT](/pigletz/nft)). In order to reveal more of his traits the piglet needs to level up.&#x20;

There are totally 4 levels. Up to level 3 the requirement to level up is to have some amount of PiFi tokens minted. On level 3 all traits are revealed. Level 4 can be achieved only in the Real World ([See Materialization](/pigletz/materialization)).

To level up the piglet needs to collect (mint) enough PiFi tokens. PiFi tokens are generated every 24 hours. The amount of the generated PiFi tokens depends on the level of the piglet and the activated boosters.&#x20;

The following table shows the PiFi required for each level:

<table><thead><tr><th width="150" data-type="number">Level</th><th width="197.02715669667054" data-type="number">Base Minting (24h)</th><th width="188.22889556222887" data-type="number">PiFi To Next Level</th><th>Months </th></tr></thead><tbody><tr><td>1</td><td>167</td><td>0</td><td></td></tr><tr><td>2</td><td>250</td><td>10000</td><td>2</td></tr><tr><td>3</td><td>417</td><td>55000</td><td>6</td></tr><tr><td>4</td><td>500</td><td>null</td><td></td></tr></tbody></table>

## Boosters

![](/files/aFbWG6994k0tRJ0DvFxU)

Boosters increase the amount of PiFi tokens minted by a Piglet daily. In order to be activated the booster requires some task to be completed.&#x20;

<table><thead><tr><th>Booster</th><th width="150" data-type="number">Level</th><th width="150">Boost</th><th>Requirement</th></tr></thead><tbody><tr><td><strong>Value $100</strong></td><td>1</td><td>10%</td><td>Invest tokens and make your piglet with at least $100 valuation</td></tr><tr><td><strong>Invest 3 Tokens</strong></td><td>1</td><td>10%</td><td>Invest 3 different tokens</td></tr><tr><td><strong>Collect 3</strong></td><td>1</td><td>20%</td><td>Collect 3 Pigletz</td></tr><tr><td><strong>3 Similar</strong></td><td>1</td><td>30%</td><td>Collect 3 with the same zodiac sign</td></tr><tr><td><strong>Staked</strong></td><td>1</td><td>50%</td><td>Stake it in the Staking Contract</td></tr><tr><td><strong>Special</strong></td><td>1</td><td>50%</td><td>It is born like this</td></tr><tr><td><strong>Invest $500</strong></td><td>2</td><td>30%</td><td>Invest tokens and make your piglet with at least $500 valuation</td></tr><tr><td><strong>Collect 7</strong></td><td>2</td><td>30%</td><td>Collect 7 piglets</td></tr><tr><td><strong>Invest $2000</strong></td><td>3</td><td>100%</td><td>Invest tokens and make your piglet with at least $2000 valuation</td></tr><tr><td><strong>Invest 7 tokens</strong></td><td>3</td><td>20%</td><td>Invest 7 different tokens</td></tr><tr><td><strong>12 Different</strong></td><td>3</td><td>80%</td><td>Collect 12 piglets with different zodiac signs</td></tr></tbody></table>

The maximum boost possible is **430%**


# Tokenomics

## PiFi

<div align="left"><img src="/files/E828yNOXCQpyozxgsPvU" alt=""></div>

PiFi is a ERC20 / BEP20 token. Its contract is [0xf7405eff16ff7e96898b6b40497a54894fc86c44](https://bscscan.com/token/0xf7405eff16ff7e96898b6b40497a54894fc86c44)

Each piglet mints internal PiFi token every 24 hours.

![PiFi Miner](/files/c1d3glTXOR6URqRCcUSH)

The amount minted is calculated by the formula

$$
mint\_{24h} = mint\_{base} \times \sum{boosters}
$$

<table><thead><tr><th data-type="number">Level</th><th data-type="number">Base Mint</th></tr></thead><tbody><tr><td>1</td><td>167</td></tr><tr><td>2</td><td>250</td></tr><tr><td>3</td><td>417</td></tr><tr><td>4</td><td>500</td></tr></tbody></table>

## Cap

Each Piglet has a cap of the total possible PiFi tokens to be minted which is 2,000,000 PiFi.

Getting into an account that the total supply of all Pigletz is 12,345 the max supply of the PiFi token will be:

$$
12,345 \times 2,000,000 = 24,690,000,000
$$

## Liquidity

The SalesManager allows us to mint PiFi that will be used to create the initial Liquidity Pool. The amount of PiFi we can mint is limited to the total minted Pigletz with the following formula:

We will create the Liquidity Pool at [PancakeSwap](https://pancakeswap.finance/) investing BNB and PiFi once we mint at least 10% from the total supply of the Pigletz.

$$
PiFi\_{max} = Pigletz\_{minted} \times 10,000
$$

After creating the pool we will revoke the minting rights to the PiFi token and Pigletz will be the only generator of new PiFi tokens.&#x20;

![](/files/TahmhKhxL8MXINvJQSVN)


# DeFi

Piglets feature DeFi elements. On a first place the Piglet itself mints its own token called PiFi. We  offer all Pigletz owners the following additional services:

## Piggy Bank

As we mentioned earlier our Pigletz are more than just a picture or NFT. They have utilities. The most important one is that they are actually a digital piggy banks. That means they can hold crypto tokens inside of their smart contract.&#x20;

![Depositing Tokens](/files/xOVsk6MdKD6y1bfzeXni)

#### Hoe does this work?

Each piglet has its own wallet. The wallet can receive and send tokens. The control over this wallet is delegated to the smart contract of the piglet. That means no human can have direct access to this wallet. In order to deposit crypto tokens into the piglet its owner has two choices:

* **Deposit** - this is a method in the smart contract allowing a crypto token, specified by its address to be deposited into the piglet. The token needs to be listed in [PancakeSwap](https://pancakeswap.finance/). The contract will automatically evaluate its USD value and will add it to the piglet.
* **Direct Transfer** - user can send tokens directly to the wallet address of piglet. However this doesn't automatically register the token in the piglet. In order to register it its owner needs to call the register method providing the token address.&#x20;

The valuation of the Piglet is based on the sum of the total evaluation of all deposited tokens.

![](/files/FzzFvBARTh0hBR1zfJ2f)

{% hint style="warning" %}
There is a limitation of the different tokens types that can be deposited into a single piglet. The limit is 9 tokens, including PiFi.&#x20;
{% endhint %}

Once deposited the tokens stay inside the piglet and cannot be withdrawn or used. The only way to withdraw the tokens is to break (burn) the piglet. Doing that you will lose its NFT value but will acquire all the tokens inside it, including PiFi.&#x20;

#### Breaking

In order to break the piglet its owner needs to call its burn method. The caller address will automatically receive all tokens belonging to the piglet's wallet.

![Breaking a Piglet](/files/yto7mehBhTXd5oi6gBjo)

## Staking

<div align="left"><img src="/files/55XA3NkIIUpPqXNqIHIn" alt="Staking"></div>

It allows Pigletz to be staked into the staking contract for a specified period. During that period a special booster with 50% boost will be activated. After unstaking the booster will be deactivated.&#x20;

While staked the Pigletz will be out of the market, locked into the contract so no one can transfer them or break them. However they will continue to produce PiFi tokens.

## Lending

<div align="left"><img src="/files/xdrCqcKmzIRYQutOCK00" alt="Lending"></div>

Lending allows Pigletz owners to use their piglet as a collateral and to lend PiFi tokens.&#x20;

This works in the following way:

1. First we evaluate all tokens inside the piglets using their BUSD value in PancakeSwap.
2. The total value of the loan cannot exceed <mark style="color:yellow;">80%</mark> of the total piglet evaluation. The percentage is not fixed yet.&#x20;
3. The user chooses amount and a period.
4. The PiFi for the loan comes from Liquidity Providers.&#x20;
5. The user is obliged to return the PiFi loan with interest within the specified period.&#x20;
6. In a case the user returns the correct PiFi amount the piglet locked into the Lending Contract is transferred back to the user.
7. Otherwise if the PiFis are not returned within the predefined period the Piglet is broken automatically by the contract and all the tokens within it are swapped in PancakeSwap for PiFi tokens which are later distributed as rewards to the Liquidity Providers.


# Materialization

Pigletz introduces a novel protocol allowing NFTs to jump from the digital world (Metaverse) to the real world and vice versa.&#x20;

![](/files/bvy8kSgOIJr8TGZYLjXB)

This is possible only on level 3. In order to materialize a Piglet its owner needs to lock it into a Bridge contract and set a password #1. Then he needs to send us his shipping info (address, etc.). Then we will produce a high quality 3D print which is later processed, polished and colored. Then we will ship the Physical piglet to its owner. Inside of the Piglet we put a password #2 that will be used to unlock the NFT from the Bridge contract.&#x20;

The NFT part will remain locked until someone provides password #1 and #2 to the Bridge contract.&#x20;

This protocol allows only a single copy of the NFT to exist either in the digital world as a NFT or as a real physical object.&#x20;

In order to take out the passwords the owner of the physical object needs to destroy it, for example with a hammer. Then the owner can pullout the codes and use them to unlock the NFT.

This model will open new market opportunities for NFTs, for example selling them on eBay.


# Team

Pigletz.com is a collaboration between two companies (Blockchain Technology Bulgaria and Aff Media) with decades of combined experience in the fields of mobile game development, web authoring and marketing and blockchain technology. Our team consists exclusively of professionals, some of whom have worked in the IT industry for over 20 years.

![Galin aka MasterPig](/files/UAaYT5lo4p5xKs56pRCI) ![Miro](/files/2j2xMAbqjPxHm3JwMCVi) ![Miró](/files/ppH6caydxqVtd92VPAm7) ![Vicho](/files/2s4LHSLbPEkfGLNmHX1w)

![Eve](/files/x1grGsNmzXhK4GCHfwYn) ![Niko](/files/DTvJRKlpgRhA8vjSjdcI) ![Veronica](/files/qhxfq3zOcjjmGWyoGd4n) ![Yan](/files/TzKjQRiNyhp1634yP4hM)

... and 20 more coming soon


# Roadmap

What we have achieved and what is in progress:

* [x] Project started (beginning of 2021)
* [x] All the art is created (mid 2021)
* [x] Smart contracts, dApp (end of 2021)
* [x] Project is released on Binance Smart Chain (Dec 18, 2021)
* [x] First presale (Dec 19, 2021)
* [x] Second presale (Dec 31, 2021)
* [x] [BeFaster.fit deposits $5m into a piglet](https://pigletz.com/news/over-6-million-worth-of-cryptocurrency-deposited-into-an-nft-piggy-bank) (Jan 4, 2022)
* [x] [Listed on Binance NFT](https://pigletz.com/news/pigletz-com-nft-piggy-bank-now-live-on-binance-nft) (Jan 28, 2022)
* [x] Deliver first 3D Prints (Q2, 2022)
* [x] Release DeFi Services (Q3, 2022)
* [x] Wheel of Fortune (Q3, 2022)
* [x] Release Mobile Apps (Q1, 2023)
* [ ] Cross-chain support (Q4, 2023)
* [ ] Enter the Metaverse (Q4, 2023)


