# Puzzlr ToDos
- [ ] Hover von Puzzleteilen die man besitzt verbessern
- [x] Rarity Switch zur Puzzleansicht hinzufügen
- [ ] leeres Puzzleteil anklicken auf dem großen Puzzle > get Piece on market
- [ ] Schließen Button zu den Claim / Unpack etc. Dialogen hinzufügen
- [ ] "Craften" von Puzzle teilen z.B. Burn 10 EPIC Puzzle-Pieces to get 1 Random Legendary PuzzlePiece
- [ ] GIF Puzzleteile laden manchmal unterschiedlich -> Animation stimmt nicht zusammen
- [x] PackDesigns (überarbeiten klein und groß) - RivalzZz
- [ ] SWAP.HIVE automatisch zu BEER umtauschen?
- [ ] Leaderboard (Puzzle-Pieces im Besitz, Claimed, Lose gesetzt...)
- [ ] Dark mode wieder hinzufügen (und fixen)
- [ ] Sortierungsfunktion unter "My Puzzlr NFT's" für die Mintnumber
- [ ] Nach 7 (14?) Tagen Auslosung 1. 35% 2. 15% 3. 7,5% 4. -10. 2% 11. - 25. den rest aufgeteilt
- [ ] Marktplatz hinzufügen
- [ ] Dashboard
- [x] Profil (links)
- [x] Puzzle Fortschritt
- [ ] geöffnete Packs / geclaimte Puzzle / most invested
- [x] Token balance (rechts)
- [x] mit swap Funktion
- [ ] Highscore (mitte)
- [ ] geöffnete Packs / geclaimte Puzzle / most invested
- [ ] Lotterietickets an die Benutzer ausstellen und einsetzen lassen
- [ ] ssc_tokens_history node aufsetzen
- [ ] Mehrere packs auf einmal öffnen

## Done

:::spoiler Klicken um erledigte Todos anzuzeigen
- [x] PuzzlePieces (Outerglow) der Rarity anpassen
- [x] Token Balances zum Dashboard hinzufügen
- [x] Dashboard zu Puzzles umbenennen
- [x] Dashboard als neuer Unterpunkt im Benutzermenü
- [x] Filter unter "My Pieces" nach Rarity
- [x] Puzzleteil Wahrscheinlichkeiten anpassen (2%, 7%, 13%, 26%, 52%?)
- [x] Eigener Pool für Lose (1%) -> puzzlr.lottery
- [x] Beim Claimen Lotterie Tickets ausschicken (1 common, 4 uncommon)
- [x] Puzzle Pool auszahlen beim claimen; rare 1%, epic 2.5%, legendary 20%
- [x] My Pieces umbenennen zu My Puzzlr NFT's
- [x] Puzzleteile, Puzzles, Packs, Tickets, ... anzeigen
- [x] Switch / Dropdown für die einzelnen Typen
- [x] Beim claimen aktualisiert sich der Counter nicht
- [x] Claimen mit Pool Reward klappt nicht richtig
- [x] Beim Unpacken Puzzleteile nach der Reihe direkt im Puzzle anzeigen mit Animation
- [x] HGC Puzzle hinzufügen
- [x] Beim Wechseln des Puzzles werden kurz noch die falschen Teile gezeigt
- [x] Die "zoomenden" Teile beim Unpacken werden beim Wechsel des Puzzles auch auf dem falschen Puzzle angezeigt
- [x] Unter My Puzzlr NFT's gleiche NFT's kombinieren und bei Klick Dialog mit tabelle anzeigen
- [x] "Unpack" Dropdown geht nicht auf wenn bereits in der Puzzleansicht
- [x] Nach dem Senden / Burnen von NFT's diese aus der List entfernen
- [x] Ladedialog beim Claimen und Unpacken anzeigen, bis Keychain TX bestätigt
- [x] Token Umrechnung beim Kauf von Packs im Frontend oder Backend falsch (!=)
:::

## Schemas Atomichub.io

| tickets | pieces | packs | puzzles | promo |
| -------- | -------- | -------- | ----- | ----|
| Rarityfilter | Rarityfilter | Variantfilter | Rarityfilter | TBD |
| Variantfilter | Variantfilter | | Variantfilter | TBD |

Rarityfilter: Common, Uncommon, Rare, Epic, Legendary
Variantfilter: **tickets**: promoRplanet **pieces**: promoRplanet **packs**: `` **puzzles**: ```
Varant filters are intended for projects to subdivide different projects.
## Packs
- Kleine packs mit 10 Teilen
- Große packs mit 25 Teilen

Drop rates:
- Common: 52% -> 655.2 -> 16380
- Uncommon: 26% -> 327.6 -> 2730
- Rare: 13% -> 163.8 -> 819
- Epic: 7% -> 88.2 -> 315
- Legendary: 2% -> 25.2 -> 70

## Claimen
Folgende Rewards erhält man beim Claimen von Puzzlen, wobei jeweils fürs Claimen die entsprechenden Puzzleteile plus das Puzzle der vorigen Stufe nötig sind:
- Common: 1 Los
- Uncommon: 4 Lose
- Rare: 1%
- Epic: 2.5%
- Legendary: 20%

## Lotterie
Einmal die Woche am Sonntag um 23:59:59 UTC. Die Verteilung der Gewinne schaut folgendermaße aus:
- 1. 35%
- 2. 15%
- 3. 7.5%
- 4-10. 2.6%
- 11-25. 1.62%

## Funktionen

## Marktplatz
- [ ]
- [ ]

## Unterseiten/Infos

- [ ] Eine kleine Unterseite im Footer für **FAQ**
- [ ]
- [ ]
- [ ]
- [ ]

### FAQ
_{Auf und zuklappbare Infos:}

- Was ist puzzlr.app?
puzzlr.app ist ein Projekt auf der Hive-Blockchain auf dem du für verschiedene Projekte Puzzleteile erwerben kannst. Mit diesen Puzzleteilen baust du dein Puzzle zusammen und bekommst beim Claimen eines Bereichs einen Anteil aus dem jeweiligen Pool.

- Was sind die Rarity der Puzzleteile?

Durch das erwerben von Puzzleteilen (kleines und großes Pack) sammelt man verschiedene Puzzleteile die in den Raritäten: Common, Uncommon, Rare, Epic und Legendary verfügbar sind.
Je nach Rarität setzt sich dein Puzzle zusammen. Common z.B ist in der Mitte mit 4 Puzzleteilen versehen.

- Wie entsteht der Pool?

Pools entstehen durch das erwerben von den jeweiligen Packs eines Puzzles. Ein Anteil von x% wandert in den Pool der für fertige Puzzles ab der Raritystufe **Epic** verfügbar sind. Unter /puzzle/beer findest du deine fertigen Claims in den verschiedenen Raritys.

- Wie entpacke ich ein Pack?

### Puzzlr - What is puzzlr

Puzzlr ist ein Collect&Earn Projekt auf der Hive und WAX-Blockchain.
Spiele und Projekte wie z.B r-Planet oder Splinterlands bieten inGame Tokens an mit denen du wiederum Packs auf Puzzlr.app erwerben kannst und somit die Preisökonomie des jeweiligen Tokens mit beeinflussen kannst.

Mit jedem Pack das gekauft wird wandert ein großer Teil der Tokens in den jeweiligen Pool der für die Ausschüttung beim Claimen direkt gutgeschrieben wird.

Hast du ein Common-Puzzle vollständig, kannst du es claimen und du bekommst ein NFT dieses Common-Puzzles welches dir den Step zum Uncommon ermöglicht. Mit jedem Claim eines Common und Uncommon Puzzles erhälst du zusätzlich ein Ticket welches für die wöchentliche Auslosung wichtig ist. Je mehr Tickets du hast, desto größer ist die Wahrscheinlichkeit das du eine Top-Platzierung hast und einen satten Preis abstaubst.

Claimst du ein Rare, Epic oder Legendary Puzzle, erhälst du nicht nur das gegenwärtige NFT, du erhälst ebenfalls einen Teil aus dem Pool der entsprechend der Rarity gilt die zu dem Zeitpunkt des Claimens im Pool ist.

## Warum WAX?

Auf der WAX-Blockchain sind NFTs Zuhause. Nicht nur der monetäre Faktor, auch der Sammlerwert ist auf der WAX-Blockchain extrem hoch. Dein Lieblingsspiel auf der WAX-Blockchain bietet einen Token an? Vielleicht kannst du demnächst ja ein einzigartiges Puzzle erhalten welches unter Sammlern wertvoll ist!

### Das erste Collect&Earn Puzzle auf WAX - rPlanet Community

Das Team von puzzlr.app ist stolz drauf zu verkünden, das die rPlanet Community das erste große Projekt auf puzzlr.app sein wird. Mit über 23,500 Discordmembern ist die Community enorm groß und aktiv.

Aether( AetherbottleIMAGE) ist der Token mit dem Elemente gecrafted werden, Länder geupgraded werden und Roboter produziert werden. Neben WAXP ist Aether die Hauptwährung für das erwerben der Community Box und des Community Pack's.

Eine automatische Anpassung des Marktpreises des Aether/WAXP setzt vorraus, das ein Pack immer denselben Grundwert hält.

**Worauf wartest du noch? Claime dich zum Legendären Puzzlr hoch und schnapp dir den Pool!**

# ////////////////////////////////////////////////////

### Puzzlr - What is puzzlr

Puzzlr is a Collect&Earn project on the Hive and WAX Blockchain.
Games and projects like r-Planet or Splinterlands offer inGame tokens with which you can buy Packs on Puzzlr.app and thus influence the price economy of the respective token.

With every pack that is bought, a large part of the tokens goes into the respective pool that is directly credited for the payout when claiming.

If you have completed a Common Puzzle, you can claim it and you will get a NFT of this Common Puzzle which allows you to step to the Uncommon. With every claim of a Common and Uncommon Puzzle you get an additional ticket which is important for the weekly draw. The more tickets you have, the more likely you are to have a top ranking and win a big prize.

When you claim a Rare, Epic, or Legendary Puzzle, you not only receive the current NFT, you also receive a piece from the pool that applies according to the Rarity that is in the pool at the time of the claim.

## Why WAX?

The WAX blockchain is home to NFTs. Not only the monetary factor, but also the collectible value is extremely high on the WAX blockchain. Your favorite game on the WAX blockchain offers a token? Maybe you can get a unique puzzle that is valuable among collectors soon!

### The first Collect&Earn puzzle on WAX - rPlanet Community

The puzzlr.app team is proud to announce that the rPlanet Community will be the first big project on puzzlr.app. With over 23,500 Discord members the community is huge and active.

Aether( AetherbottleIMAGE) is the token used to craft items, upgrade lands and produce robots. Besides WAXP, Aether is the main currency for purchasing the Community Box and the Community Pack.

An automatic adjustment of the market price of Aether/WAXP requires that a pack always holds the same base value.

**What are you waiting for? Claime yourself to the Legendary Puzzlr and grab the pool!

/////////////////////////

Lottery Shortwords

With the Raffle Tickets you can find on Atomichub(link) you can increase your chances to win the weekly lotteries. Redeem your Raffle Tickets in your Dashboard(link) to increase your chances.
**Each puzzle has its own prize pool with different tokens.**

- RaffleTickets nach dem claimen eines Puzzles (NFT auf Atomichub)
- RaffleTickets einlösen(redeem) burnt das NFT auf Atomichub
- Highscore einer monatlichen Auswertung von 4 WeeklyLotterys
- - Topplatzierungen 1-5 bekommen NFTs die nicht geburnt oder versendet werden können um Vergünstigungen beim pack-Kauf zu erhalten.
- Im Dashboard werden Werte wie ```total_claimed``` , ```redeemed_tickets``` ```total_unpacked``` ausgegeben die sich auch im Highscore wiederspiegeln.
- Ob man hier eine interne Punktevergabe pro Wert ermittelt wie z.B
- Common Puzzle Claimed > 1 Punkt
- Uncommon Puzzle Claimed > 2 Punkte
- Rare puzzle Claimed > 10 Punkte
- Epic Puzzle Claimed > 50 Punkte
- Legendary Puzzle Claimed > 250 Punkte
- WeeklyLottery Platzierung > 50 - 1 von 1 bis zum 50. Platz gesehen.
-

Diese interne Punktevergabe vermischt das Ergebnis einer 4 Wöchigen Laufzeit und bietet Usern auch mit wenigen Punkten jede Woche eine gute Chance sich für das große Finale nach 4 Wochen gut zu platzieren.

## Roadmap and Project Goals

Die WAX Blockchain hat sich in den letzten Monaten stark entwickelt. Viele Projekte haben sich etabliert, Communitys haben sich formiert und projektbasierende Tokens wurden erstellt.
Puzzlr.app - eine auf WAX basierende und zukünftig crosschain interagierende Puzzle Anwendung bietet Usern einen Usecase für Tokens projektrelevanter Puzzles. Ziel von Puzzlr.app ist es, Tokens einen neuen Wert zu vermitteln und auf Dauer spielerisch die Puzzlr Community mit wöchentlichen Lotterys zu belohnen.

Viele Projekte auf der WAX Blockchain bieten ihre Tokens auf dem freien Markt an - je nachdem wie groß das Angebot und die Nachfrage ist varriert der Preis des jeweiligen Tokens, puzzlr berechnet den aktuellen Tokenwert minutengenau um sicherzustellen, dass jeder User und jedes Puzzle Pack immer einen gleichbleibenen Wert hält.

### Purchase Packs with Tokens

Neben WAX als Hauptwährung können User also demnach ihre Packs der jeweiligen Projekte mit den jeweiligen Tokens erwerben. Um den Markt des Tokens attrativer zu gestalten werden in der Berechnung des Preises eines Packs **5%** Discount im Tokenwert gegenüber des regulären Preises reduziert.

**Dies soll die Attraktivität der jweiligen Tokens steigern und Usern die Möglichkeit geben sich nicht nur auf eine Währung zu fokussieren.**

### NFTs

#### Welche Arten von NFTs wird es auf puzzlr.app geben?

1. Zum einen werden die verschiedenen Puzzle Packs zu den jeweiligen Projekten als NFTs zur Verfügung gestellt.
2. Die Puzzleteile sind als NFTs verfügbar und sind tradeable/burnable.
3. die geclaimten Puzzles (C,UC,R,E,L) sind als NFTs verfügbar und tradeable/burnable.
4. Die RaffleTickets die nach dem burnen von geclaimten Puzzles in die Wallet geminted werden (je nach Rarity) sind tradeable/burnable.


| Common | Uncommon | Rare | Epic | Legendary |
| -------- | -------- | -------- | ------- | -------- |
| |  |  |  | 
| 1 Point | 2 Points | 20 Points | 100 Points | 500 Points |
| Common | Uncommon | + 20 Points Bonus | +100 Points Bonus | +500 Points Bonus |

### Puzzlr.app - the place for your Puzzlr NFTs
Puzzlr is a Collect&Earn project on the Hive and WAX Blockchain.
Games and projects like r-Planet or Splinterlands offer inGame tokens with which you can buy Packs on Puzzlr.app and thus influence the price economy of the respective token.
With every pack that is bought, a large part of the tokens goes into the respective pool that is directly credited for the payout when claiming.
If you have completed a Common Puzzle, you can claim it and you will get a NFT of this Common Puzzle which allows you to step to the Uncommon. With every claim of a Common and Uncommon Puzzle you get an additional ticket which is important for the weekly draw. The more tickets you have, the more likely you are to have a top ranking and win a big prize.
When you claim a Rare, Epic, or Legendary Puzzle, you not only receive the current NFT, you also receive a piece from the pool that applies according to the Rarity that is in the pool at the time of the claim.

## Roadmap/Vision
The WAX Blockchain has seen a lot of development in the last few months. Many projects have been established, communities have formed and project-based tokens have been created. Puzzlr.app - a WAX based and future crosschain interacting puzzle application offers users a usecase for tokens of project relevant puzzles. The goal of Puzzlr.app is to give tokens a new value and in the long run playfully reward the Puzzlr community with weekly lotteries based on their claimed and redeemed RaffleTickets.

​

Many projects on the WAX blockchain offer their tokens on the open market - depending on how big the supply and demand is, the price of the respective token varies, puzzlr calculates the current token value to the minute to ensure that each user and each puzzle pack always holds a constant value.

Purchase Packs with Tokens
In addition to WAX as the main currency, users can therefore purchase their packs of the respective projects with the respective tokens. In order to make the market of the token more attractive, 5% discount in the token value compared to the regular price is reduced in the calculation of the price of a pack.

This should increase the attractiveness of the tokens and give users the opportunity to focus not only on one currency.

## Raritys
different Raritys of your Puzzle
The different raritys of a puzzle are based on the size of a puzzle. Raritys define the range of a puzzle area to be claimed.

100 Pieces Puzzle
Rarity

Puzzle pieces*

Reward*

Common

4

1 Ticket

Uncommon

16

4 Tickets

Rare

36

current Rare prizepool**

Epic

64

current Epic prizepool**

Legendary

100

current Legendary prizepool**

* ist Abhängig von der jeweiligen Puzzlegröße des jeweiligen Projekts
** Tokens die beim Zeitpunkt des claimens im Preispool liegen

Common
Uncommon
Rare
Epic
Legendary

claimed common puzzle on a 10x10 Puzzle
​

your claimed puzzles can be found in your user menu under the point My NFTs

### Claim Puzzles
Claime Puzzles und erhalte das entsprechende NFT

Wenn du Puzzleteile claimest werden diese Puzzleteile geburnt und ein NFT entsprechend der Rarity wird deinem Account gutgeschrieben. Jedes Puzzle hat seine eigenen Raritys und Tickets.

geclaimte Puzzles sind NFTs und sind verwendbar.
Wenn du z.B ein Uncommon Puzzle NFT besitzt und dieses für ein Rare Puzzle verwenden möchtest, brauchst du die Rare Puzzleteile um es zu claimen. Volle Puzzles können als NFT getradet werden**

### Redeem Tickets
Redeem Tickets for Weekly Lotterys
Wenn du Puzzles geclaimed hast, besitzt du bereits ein NFT welches du in deinem Dashboard in ein Raffle Ticket umtauschen kannst. Mit jedem Raffle Ticket erhöhst du deine Chance in der Weekly Lottery.
Weekly Lotteries sind projektbasierend und schütten die jeweiligen Token im Preispool aus.

### Tokenomics Goal
working together to win - Purchase Packs with Tokens
Der Tokenomics Goal bezieht sich auf die Grundlage der verschiedenen Tokens auf der WAX Blockchain.

Das Ziel von Puzzlr.app ist es, die Ökonomie eines Tokens zu stärken und fortlaufend stabiler zu gestalten. Mit dem Erwerb eines projektbasierendes PuzzlePack mit Tokens bietet Puzzlr einen weiteren Usecase für eine stabilisierende Token-Ökonomie.

Beispiel:
AETHER ist der Grund Token für das Projekt rplanet.io. Für dieses Projekt können User ihre Puzzle Packs mit diesem Token erwerben - Da rPlanet.io nicht nur AETHER als Token verwendet sondern auch weitere Tokens für den Bau von Robots verwendet (Enefterium,Wecanite,Caponium und Waxon) können diese Tokens ebenfalls für den Erwerb von Puzzle Packs verwendet werden.

In den Weekly Lotterys können nun User die bereits Packs mit verschiedenen Währungen gekauft haben diese Token als Preise gewinnen. Jeder Token hat seinen eigenen Pool und wird anteilig an den Platzierungen ausgeschüttet.

Herzlich Willkommen auf dem puzzlr.app Discord !

Hier bist du genau richtig wenn du etwas puzzlr.app erfahren möchtest.
Diese Community und puzzlr.app selbst strebt das Ziel an Tokens verschiedener Projekte auf der WAX Blockchain sammlerisch zu steigern. puzzlr.app bietet dir eine Menge an Tokens, NFTs und eine Community rund um die WAX Blockchain.

Schön das du da bist!

<br>

⌞─── **Buying Packs with Tokens** :jigsaw: ───⌝

on puzzlr.app you have the option to purchase packs of a puzzle with the project's own tokens. Each time you buy a pack, a respective amount of these tokens goes into the pool for the puzzle.

⌞─── **How do I claim my puzzles and the pool?** :jigsaw: ───⌝

When you open a pack you will see your puzzle pieces directly on your puzzle. If you have completed an area, you can claim it under **CLAIM**. If you have all pieces for the next higher puzzle you can claim the next rarity.
From Rare, Epic and Legendary you get a share of the filled pool that was already filled by the purchase of the packs.

⌞─── **What are Raffle Tickets?** :jigsaw: ───⌝

Raffle tickets* can be obtained by claiming any puzzle. You can use these tickets in your dashboard for the weekly lottery. You can find more information in the PuzzlPaper: https://docs.puzzlr.app/puzzlr/features/raffletickets
* **Each ticket is increasing in value based on their rarity**

⌞─── **WILDCARD Piece - it will finish your puzzle to claim it!** :jigsaw: ───⌝

With each pack, whether PromoBox, Community Pack or the Collector Box - each of these packs has a 0.1% chance of containing a WILDCARD Piece that you can use to complete your puzzle.

So if you are missing a piece for the Epic or Legendary Puzzle and you have a WILDCARD Piece you can claim it! You wouldn't want to waste it on an Uncommon Puzzle, would you? :wink:

⌞─── **CASHBACK** :dollar: You earn PUZZLR Tokens by buying Packs! :jigsaw: ───⌝

When you buy a pack on puzzlr.app you automatically get 10% cashback in the form of PUZZLR tokens.
This token will be used for Puzzlr internal projects in the future and could be quite useful.
Imagine you buy packs with the PUZZLR token and get **ALL TOKENS** that are involved as projects at puzzlr.app? Awesome!

## DROP ATOMICHUB


Herzlich Willkommen zum ersten Drop von puzzlr.app

puzzlr.app is a WAX based and future crosschain interacting puzzle application, which gives tokens of other projects another utility. The goal of puzzlr.app is to give tokens a new value and in the long run playfully reward the puzzlr community with weekly lotteries based on the claimed and redeemed Raffle Tickets.


mit diesem initialen Drop wird beim Kauf eines Packs der Pool für das PromoRPlanet Puzzle bereits mit 0.50$/Pack gefüllt. Diese WAX sind also durch den Erwerb der PromotionBox für das Claimen von Rare,Epic und Legendary Puzzles beim Release von puzzlr.app bereits im Pool.

Mit dem Release von puzzlr.app können User dann Packs für Tokens erwerben und somit den Pool des Puzzles dadurch steigern und erweitern.


In dieser PromotionBox und den Packs die mit Tokens erworben werden können, kann ein **WILD PIECE** enthalten sein.
Dieses sehr seltene Puzzleteil kann dein unfertiges Puzzle vervollständigen sofern dir ein Puzzleteil für das fertige Puzzle fehlt.


Die PromotionBox und die Packs die bei Eröffnung von puzzlr.app verfügbar sind haben folgende Wahrscheinlichkeiten:

**Probability of Puzzle Pieces:**

Common: 51,9%
Uncommon: 26%
Rare: 13%
Epic: 7%
Legendary: 2%

***Wildcard:** 0.1%

*Wildcard puzzle piece can be used in any place. So if you are stuck on a puzzle and you have a Wildcard piece, you have the opportunity to claim the next rarity of your puzzle.