A treasure-hunting mobile application where users can search and collect Bitcoin Cash (BCH) token and voucher rewards scattered around the world. The release of CashTokens enhanced the handling and storing of data on Bitcoin Cash (BCH) transactions. The improved architecture allowed fungible and non-fungible tokens (NFTs) to be included in the transaction itself, which provided additional security on token spending, and intrigued the community on its application using smart contracts. One such application, or might be the first one, is the implementation of a voucher system.

LEGEND

• PAY_COV = payment covenant — the covenant being funded by a user during quest creation
• DIST_COV = distribution covenant — intermediary covenants that distribute the funds from the PAY_COV to CD_COVs used to accomodate more cashdrops per quest
• CD_COV = cashdrop covenant — covenants that hold the BCH rewards. This covenant handles reward collection

COMPONENTS

Quests

Basically characterized as a circular geographic area that produces the BCH treasures called cashdrops. Each quest is comprised of three (3) main components:

• center = a geographic location coordinate that represents the quest. This is usually the location of the linked merchant, but it can be set by users manually during creation.
• radius = the radius from the center that determines the quest area. This area is where cashdrops will be generated for a quest. There are currently four (4) radii sizes that are available:
  • 1.5 km
  • 15 km
  • 150 km
  • 1,500 km
• amount = Bitcoin Cash (BCH) quantity that a quest will distribute to its children cashdrops. The minimum amount varies on the number of cashdrops that you set during quest creation, while the maximum amount is 1000 **worth of a user’s current selected currency.

Types

• Payment Type

Quests are created by users and before it becomes visible on the map, it needs to be funded with BCH. From this, there are two (2) types of quest based on their funding scheme:

1. Pay Now = quests that are paid immediately before creation.

<aside> ℹ️ Pay now quests should be paid within 10 minutes after quest form completion.

</aside>

1. Fund Later = quests that can be funded by other PurelyPeer users or other 3rd party wallet. After a fund later quest is created, it gets added to a waiting list which is a list where users can fund quests like this.

<aside> ℹ️ Fund later quests will expire after 30 days (1 month) getting added to the waiting list, if left unfunded.

</aside>

• Contract Type

A quest can either be linked to a merchant or not. They only differ on the cashdrop rewards given to collectors. A merchant-linked quest’s cashdrops contain a variable BCH reward and 1 merchant voucher, while non-linked quests does not come with a voucher.

States

• Active = quests that has been funded and all funds distributed to its children cashdrops. Even after funding payment, the quest will not be flagged active until all funds are properly distributed to its cashdrops.
• Inactive = becomes inactive if all cashdrops of the quest has been collected.
• Expired = quest gets discarded after being left unpaid for a certain amount of time (differs depending on type of quest)
  • Pay Now = should be paid 10 minutes after quest form completion.
  • Fund Later = should be funded within 30 days

Cashdrops

These are the hidden treasure locations that users hunt and collect. Cashdrops are produced by quests during quest creation and are generated inside the radius of their parent quest.

Just like quests, cashdrops have a center location and a radius, however cashdrop radii are static (50 m) and is used as the basis during collection.

<aside> ℹ️ There can be 5 to 72 cashdrops per quest.

</aside>

States

Once funded and the parent quest is active, cashdrops can be at three (3) states in its lifetime.

• Active = cashdrops that are funded and has not yet been collected. An active cashdrop gets shown in the list of collect-ready cashdrops in the collect page.
• Inactive / Collected = cashdrops that has been collected. These cashdrops does not appear on the collect page anymore.
• Locked = once a user is in the process of hunting or collecting a cashdrop, it gets locked to that user to ensure that a cashdrop is collected by a single user at a time.

An visualization of what a quest looks like. The cashdrops are randomly scattered within the quest radius.

Merchants

Paytaca-linked stores or establishments that can be used as the default center location during quest creation.

Users

These are the main functionalities or features that a user can do:

• Quest creator = users who create quests, whether its a fund later quest or not
• Quest funder = users who paid for their self-created quests or other users’ fund later quests

<aside> ℹ️ Quest funder by default is the payer of the quest, but since fund later quests can be funded using third-party wallets, the funder in this case will be the quest creator.

</aside>

<aside> ℹ️ Quest funders receive a one (1) quest NFT for each cashdrop collected from the quest they funded.

</aside>

• Collector = a user can collect cashdrops to receive BCH rewards and vouchers

FLOW

The general flow of how PurelyPeer’s treasure-hunting game works. Users need to create quests that generate cashdrops to be collected (which contain BCH and voucher rewards). If the quest is linked to a merchant, a user can claim the voucher to purchase a product.

Create

Cashdrops are produced from quests, so before anything can be collected, someone has to create, and fund at least one (1) quest first, to produce cashdrops. Creating a quest is simple and follow these steps:

1. Set quest parameters:
2. (Optional) Select a merchant to be linked to your quest
3. (Optional) Set it to a fund later quest
4. Cashdrop generation. Cashdrop locations gets randomly generated within the quest radius. Cashdrop generation follows these rules and regulations:
5. Pay quest
6. Quest funds distribution — more details here
7. Quest is created and is now visible on the map.

Basic flow of quest creation for Pay Now (top) and Fund Later quests (bottom).

Quest Funding

Before a quest can be flagged active and its cashdrops be collect-ready, it must first be funded by a user with the given amount set during creation. Funding differs depending on the payment type — Pay Now quests are simple where users directly pay to the PAY_COV , however Fund Later quests require extra steps prior. A funder does not get to choose which quest he or she will fund, rather, it is randomized by the app depending on which area the user has set.

<aside> ℹ️ WAITING LIST — ****after a user creates a Fund Later quest, it gets added to this list that is only visible on the server.

</aside>

1. User sets the area where a quest will be randomized. It is a 50 km radius area and adjusting it is similar on how to adjust the quest center during creation.
2. After setting the area, the server will randomize a Fund Later quest amongst the quests in that area.
3. Once a quest has been selected, the cashdrops will be generated.
4. Payment page will show and the user has three (3) options for payment: