> For the complete documentation index, see [llms.txt](https://harvest-vale.gitbook.io/harvest-vale-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://harvest-vale.gitbook.io/harvest-vale-docs/economy-and-blockchain/marketplace-and-premium-shop.md).
# Marketplace & Premium Shop
**Official VALE Token CA (Robinhood Chain Mainnet):** `0x22ad3b2a5d3924c9e813fcc1a537f24fed6a17d7` · [View on Explorer](https://robinhoodchain.blockscout.com/token/0x22ad3b2a5d3924c9e813fcc1a537f24fed6a17d7).
**Trade eligible items with other players—and explore the future VALE Premium Shop catalog.** Harvest Vale has two distinct interfaces: the **Online Marketplace**, where players can list their existing inventory items with VALE-denominated asking prices, and the **VALE Premium Shop**, which displays premium consumables, tools, access items, and account utilities.
{% hint style="warning" %}
**PAYMENT STATUS:** The Premium Shop's **15 item prices are preview amounts only**. VALE's official contract address is announced, but premium checkout is still disabled. Marketplace seller listings/escrow are defined in the game, but **live buyer settlement in VALE is disabled by default**. Never send VALE or ETH to a player or unofficial address expecting a game delivery.
{% endhint %}
## 1. How the Two Shops Differ
| Feature | Online Marketplace | VALE Premium Shop |
| ---------------------- | -------------------------------------------------------------- | ---------------------------------------- |
| **Seller** | Another eligible player | Proposed game premium catalog |
| **Items** | Eligible tradeable player-owned crops, fish, and minerals | 15 planned premium items described below |
| **Displayed Currency** | VALE-denominated player asking price | VALE preview catalog price |
| **Gold Cost** | A listing fee may apply to the seller | Not a Gold Shop purchase |
| **Availability** | Listing/escrow features defined; **buyer settlement disabled** | **Coming Soon; purchases disabled** |
| **Price Source** | Set by individual seller | game interface preview catalog |
A Marketplace listing amount is **not a fixed value** that Harvest Vale assigns to a mineral or crop, and a Premium Shop preview price is **not a live token offer**.
## 2. VALE Premium Shop — Complete 15-Item Encyclopedia
{% hint style="warning" %}
**COMING SOON — PREVIEW PRICES ONLY.** All 15 entries are taken from the Premium Shop catalog in the official game interface. The official VALE contract address is `0x22ad3b2a5d3924c9e813fcc1a537f24fed6a17d7` on Robinhood Chain Mainnet, and premium purchases and deliveries are **not enabled**. All advertised item effects, access permissions, bonuses, breeding and marriage utilities below are **planned descriptions**, not active game mechanics.
{% endhint %}
Every entry below features its **original Harvest Vale pixel-art item image** already uploaded from the game's `public/assets/harvest_vale/item_assets/premium_item/` assets. Prices represent catalog previews in **VALE**, not Gold, ETH, USDG, or a currently payable token amount. The listed delivery and duration are *catalog specifications*, not a claim that an item can presently be obtained or activated.
### Catalog Price Index
| Item | Category | Preview Price | Preview Delivery |
| -------------------------------- | ----------------- | ---------------: | ---------------- |
| Energy Restoration | Recovery | **50,000 VALE** | 100 Energy |
| Stamina Boost | Recovery | **30,000 VALE** | 100 Stamina |
| Miner & Digger Helm | Mining Access | **50,000 VALE** | 7 Days |
| Authorized Miner's Certification | Mining Access | **100,000 VALE** | 2 Days |
| Premium Lure | Fishing | **25,000 VALE** | 100 Pieces |
| Goldleaf Growth Pouch | Farming | **10,000 VALE** | 10 Pieces |
| Silver Rod Cast | Fishing | **60,000 VALE** | 3 Days |
| Golden Rod Cast | Fishing | **100,000 VALE** | 7 Days |
| Change Username Pass | Account Utility | **100,000 VALE** | 1 Pass |
| Change Field Name Pass | Farm Utility | **100,000 VALE** | 1 Pass |
| Dairy Cow (Female) | Premium Livestock | **200,000 VALE** | 1 Cow / Account |
| Dairy Goat (Female) | Premium Livestock | **200,000 VALE** | 1 Goat / Account |
| Golden Hoe | Premium Tool | **200,000 VALE** | Permanent |
| Golden Hammer | Premium Tool | **200,000 VALE** | Permanent |
| Lovely Feather | Relationship | **500,000 VALE** | 1 Feather |
### Browse Items by RPG Category
{% tabs %}
{% tab title="Recovery & Mining · 4" %}
### Energy Restoration
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Recovery |
| **Preview price** | **50,000 VALE** |
| **Delivery / quantity** | 100 Energy |
| **Item type / availability** | Consumable |
| **Stated duration** | Not specified |
Instantly restores Energy to full capacity. This item can only be used when the player's current Energy is below 50%.
**Advertised catalog effects — not yet active:**
* Restores Energy to 100%
* Usage requires current Energy below 50%
* Single-use recovery item
***
### Stamina Boost
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Recovery |
| **Preview price** | **30,000 VALE** |
| **Delivery / quantity** | 100 Stamina |
| **Item type / availability** | Consumable |
| **Stated duration** | Not specified |
Instantly restores Stamina to full capacity. This item can only be activated when current Stamina is below 50%.
**Advertised catalog effects — not yet active:**
* Restores Stamina to 100%
* Usage requires current Stamina below 50%
* Single-use recovery item
***
### Miner & Digger Helm
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Mining Access |
| **Preview price** | **50,000 VALE** |
| **Delivery / quantity** | 7 Days |
| **Item type / availability** | Timed Access |
| **Stated duration** | 7 Days |
A temporary mining helmet required as part of the equipment requirement for entering designated mining areas.
**Advertised catalog effects — not yet active:**
* Mining-area equipment requirement
* Valid for 7 days after activation
* Account-bound access utility
***
### Authorized Miner's Certification
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Mining Access |
| **Preview price** | **100,000 VALE** |
| **Delivery / quantity** | 2 Days |
| **Item type / availability** | Timed Access |
| **Stated duration** | 2 Days |
Official player certification required for authorized mine access during its active validity period.
**Advertised catalog effects — not yet active:**
* Authorizes mine entry
* Valid for 2 days after activation
* Designed to work with mining access requirements
***
{% endtab %}
{% tab title="Fishing & Farming · 6" %}
### Premium Lure
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Fishing |
| **Preview price** | **25,000 VALE** |
| **Delivery / quantity** | 100 Pieces |
| **Item type / availability** | Consumable |
| **Stated duration** | Not specified |
A premium fishing lure designed to improve high-value catch opportunities while each piece is active.
**Advertised catalog effects — not yet active:**
* +30% Large Fish chance
* +10% Legendary Fish chance
***
### Goldleaf Growth Pouch
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Farming |
| **Preview price** | **10,000 VALE** |
| **Delivery / quantity** | 10 Pieces |
| **Item type / availability** | Consumable |
| **Stated duration** | Not specified |
Premium fertilizer formulated to accelerate crop growth and improve the amount harvested from treated crops.
**Advertised catalog effects — not yet active:**
* 20% faster crop growth
* +50% crop yield
* 10 applications per purchase
***
### Silver Rod Cast
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Fishing |
| **Preview price** | **60,000 VALE** |
| **Delivery / quantity** | 3 Days |
| **Item type / availability** | Timed Equipment |
| **Stated duration** | 3 Days |
A temporary upgraded fishing rod that improves the overall probability of receiving fish and fishing-related items.
**Advertised catalog effects — not yet active:**
* +10% fish and item acquisition chance
* Valid for 3 days after activation
* Fishing equipment upgrade
***
### Golden Rod Cast
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Fishing |
| **Preview price** | **100,000 VALE** |
| **Delivery / quantity** | 7 Days |
| **Item type / availability** | Timed Equipment |
| **Stated duration** | 7 Days |
The premium fishing rod tier, providing a stronger improvement to fish and item acquisition while active.
**Advertised catalog effects — not yet active:**
* +20% fish and item acquisition chance
* Valid for 7 days after activation
* Premium fishing equipment upgrade
***
### Golden Hoe
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Premium Tool |
| **Preview price** | **200,000 VALE** |
| **Delivery / quantity** | Permanent |
| **Item type / availability** | Permanent |
| **Stated duration** | Permanent (preview) |
A permanent premium hoe designed to improve rewards obtained from digging-related activities.
**Advertised catalog effects — not yet active:**
* +30% digging-related yield
* Permanent account unlock
* Premium farming tool
***
### Golden Hammer
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Premium Tool |
| **Preview price** | **200,000 VALE** |
| **Delivery / quantity** | Permanent |
| **Item type / availability** | Permanent |
| **Stated duration** | Permanent (preview) |
A permanent premium hammer that increases the amount obtained from mining-related harvests.
**Advertised catalog effects — not yet active:**
* +30% mining yield
* Permanent account unlock
* Premium mining tool
***
{% endtab %}
{% tab title="Account & Social · 5" %}
### Change Username Pass
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Account Utility |
| **Preview price** | **100,000 VALE** |
| **Delivery / quantity** | 1 Pass |
| **Item type / availability** | Single Use |
| **Stated duration** | Not specified |
A one-use account utility that allows the player to submit a new in-game username, subject to username validation and availability.
**Advertised catalog effects — not yet active:**
* Enables one username change
* New username must pass game validation
* Consumed after a successful change
***
### Change Field Name Pass
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Farm Utility |
| **Preview price** | **100,000 VALE** |
| **Delivery / quantity** | 1 Pass |
| **Item type / availability** | Single Use |
| **Stated duration** | Not specified |
A one-use farm utility that allows the player to rename their farm while preserving all existing farm progress.
**Advertised catalog effects — not yet active:**
* Enables one farm-name change
* Does not reset farm progression
* Consumed after a successful rename
***
### Dairy Cow (Female)
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Premium Livestock |
| **Preview price** | **200,000 VALE** |
| **Delivery / quantity** | 1 Cow / Account |
| **Item type / availability** | One-Time Purchase |
| **Stated duration** | Not specified |
A premium female dairy cow intended for the breeding system. It is account-bound and cannot be sold on the livestock market.
**Advertised catalog effects — not yet active:**
* Eligible for breeding
* Maximum of 5 successful births
* Cannot be sold
* Limited to one purchase per account
***
### Dairy Goat (Female)
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Premium Livestock |
| **Preview price** | **200,000 VALE** |
| **Delivery / quantity** | 1 Goat / Account |
| **Item type / availability** | One-Time Purchase |
| **Stated duration** | Not specified |
A premium female dairy goat intended for the breeding system. It remains account-bound and cannot be sold.
**Advertised catalog effects — not yet active:**
* Eligible for breeding
* Maximum of 5 successful births
* Cannot be sold
* Limited to one purchase per account
***
### Lovely Feather
| Item Attribute | Preview Specification |
| ---------------------------- | --------------------- |
| **Category** | Relationship |
| **Preview price** | **500,000 VALE** |
| **Delivery / quantity** | 1 Feather |
| **Item type / availability** | Single Use |
| **Stated duration** | Not specified |
A special proposal item used to express commitment and formally propose marriage to another player. It can be used by players of any gender.
**Advertised catalog effects — not yet active:**
* Required to initiate a marriage proposal
* Usable regardless of player gender
* Consumed when the proposal action is completed
***
{% endtab %}
{% endtabs %}
{% hint style="info" %}
**About these items:** Prices, bonuses and effects shown here are previews. The premium items, including fishing bonuses, mining access, Golden tools and premium livestock, are not available for purchase yet. Final details will be announced before launch.
{% endhint %}
## 3. Online Marketplace: What Players Can List
The Marketplace's eligible item list is controlled by the game. An item must be present in an **active, tradeable inventory lot**; not every owned item automatically qualifies.
| Listing Category | Eligible Item Types |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Crops** | Turnip, Tomato, Potato, Corn, Cabbage, Watermelon |
| **Common Fish** | Small Fish, Medium Fish, Large Fish |
| **Legendary Fish** | Astral Silverfin, Celestial Moonfish, Crimson Dragon Koi, Golden Storm Marlin, Imperial Phoenix Koi |
| **Minerals** | 
Iron Bar · 
Chopper Bar · 
Gold Bar |
| **Animals** | **Not available for Marketplace listings** under the current game policy |
**Listing a mineral for VALE and converting a mineral into an RWA stock token are different features.** Marketplace listings represent seller-set game asset prices; the Bank Converter currently has no approved mineral-to-stock exchange rate.
## 4. Marketplace Listing Rules
| Rule | Current Default |
| ------------------------------------ | --------------------------------------------------- |
| **Listing currency** | VALE (seller-defined asking price) |
| **Listing fee** | **100 Gold** per new listing |
| **Listing duration** | **7 days** |
| **Maximum open listings** | **10** |
| **Platform tax in displayed policy** | **10%** of final VALE asking price |
| **Early cancellation / item return** | **60-second** cancel cooldown in the game |
| **Item custody** | game-controlled Inventory escrow during the listing |
| **Livestock trading** | Disabled |
| **Purchase / settlement** | **Disabled in current default settings** |
**Platform fee notice:** A displayed **10%** platform fee does not mean that the fee is automatically collected on-chain. Live VALE buyer payments are not available yet.
{% hint style="warning" %}
**Listing is not selling.** If you create a listing while purchases remain disabled, you may still pay the **Gold listing fee** and have your item held in the game's escrow/listing workflow. Check the current in-game listing status and return rules before creating listings.
{% endhint %}
### What Actually Happens to a Listing?
Marketplace listings temporarily hold eligible items in the game; creating a listing does not transfer any tokens. A successful listing is created in an economy transaction that charges the set Gold listing fee and deducts the specified **tradeable inventory quantity** from available inventory. The seller sets the VALE-denominated asking price; creating a listing does **not** collect VALE from a buyer.
| Listing Stage | What the game Does | Player Action / Important Limitation |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| **ACTIVE** | Holds the listed item quantity in the marketplace workflow until a buyer completes a permitted purchase, the seller requests cancellation, or 7 days elapse. | Review the item, quantity, seller, asking price, and expiry in Marketplace. |
| **CANCEL\_PENDING** | Records a cancellation request and imposes a **60-second cooldown** before the item can be reclaimed. | Open **Your List** and use **Take Item** after the return time becomes eligible. |
| **EXPIRED** | Marks an unsold listing expired after 7 days and prepares the item for return; an in-game system mail notification is created. | **Take Item** to reclaim inventory. Expiration is not an automatic delivery into the bag. |
| **CANCELLED / returned** | The game grants the escrowed quantity back to the seller's inventory after an eligible manual return. | Check Inventory and transaction history after the return succeeds. |
| **SOLD** | Intended for completed purchases after marketplace checkout becomes available. | Buying with VALE is not available yet. |
**Listing limit:** Active, cancellation-pending and expired listings continue to count toward the **10-listing limit** until resolved. Reclaim eligible items to free slots. The listings screen shows five entries per page.
### Listing Eligibility and Account Protection
* Only **active, tradeable inventory lots with a positive remaining quantity** are eligible; a visible but non-tradeable or already committed item cannot be used as freely available marketplace stock.
* Supported assets are the **six crops**, **three common fish**, **five legendary fish**, and **three mineral bars** listed above. Animals are explicitly rejected.
* New listing, cancellation, item return, and purchase requests require authenticated and **PIN-verified** sessions, CSRF validation, and economy/security eligibility checks. Creating a listing also uses a client order identifier to prevent accidental duplicate submission.
* The seller must cover the set **Gold listing fee** even though VALE buyer settlement is currently disabled by default. Do not list items unless you understand custody, expiration, and return conditions.
### Payment Modes, VALE Settlement, and Platform Fee
VALE payments are not currently available in the Marketplace. Buyer checkout remains **Coming Soon**, even though the official VALE contract address has been published.
| Concept | Current Documentation Status |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Seller listing price** | Whole-number VALE asking amount set by the player; a quote, not an executed payment. |
| **Default platform fee policy** | **10% (1,000 basis points)** represented in the game's transaction breakdown. |
| **Estimated seller proceeds** | Formula: listed VALE price minus the displayed 10% fee, **if** a compatible future settlement design enforces that policy. |
| **On-chain fee collection** | **Not active.** The displayed 10% fee should not be treated as automatically collected. |
| **Live buyer purchase and premium checkout** | **Unavailable / Coming Soon** under the documented default settings. The official VALE contract is announced, but buyer checkout is still disabled. |
**Never send tokens directly to a seller, smart contract, or unofficial address to bypass a disabled in-game checkout.** The game cannot promise recognition, delivery, platform-fee handling, or recovery for an unsupported external transaction.
## 5. Player Marketplace Flow
{% stepper %}
{% step %}
### Inspect Your Tradeable Inventory
Open Online Marketplace and review eligible crops, fish, and minerals. The game filters for items that exist as tradeable, available inventory lots.
{% endstep %}
{% step %}
### Choose Your Quantity and Price
Enter the number of items to list and a positive whole-number **VALE** asking price. This is your requested listing amount, not a published item valuation.
{% endstep %}
{% step %}
### Review Listing Conditions
The default listing fee is **100 Gold**, duration **7 days**, and the item is transferred into a game-controlled escrow state once the listing transaction succeeds.
{% endstep %}
{% step %}
### Track and Manage Your Listing
Open **Your List** for current status. Cancellation, return waiting periods, expiration, and item recovery are separate steps. The game includes expiration notices and the ability to **Take Item** when the return action becomes eligible.
{% endstep %}
{% step %}
### Do Not Bypass Disabled Settlement
Buyer purchase buttons may display **Coming Soon**. Do not pay a player outside the supported game flow and expect the game to recognize the payment or release the listed item.
{% endstep %}
{% endstepper %}
## 6. VALE Prices vs. Gold Prices
| Currency | Used For | Example |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------------------------------------------- |
| **Gold** | Existing NPC Gold Shop purchases; in-game item sales; Marketplace listing fee | 250 Gold for one seed (base Farm Shop price) |
| 
**VALE** | Upcoming Premium Shop catalog; player-set Marketplace asking prices | 25,000 VALE preview price for Premium Lure |
| **ETH** | Robinhood Chain native gas | Not the Premium Shop's displayed item currency |
| **USDG** | Separately set Bank/reward preview token | Not the VALE Premium Shop purchasing currency |
These currencies do **not** have a guaranteed exchange rate between them. **A VALE-denominated catalog price has no current executable purchasing meaning while the token is unlaunched.**
## 7. Common Questions
Can I buy any of the 15 premium items today?
**No.** The Premium Shop is a **Coming Soon catalog** and its purchase button is disabled. Prices and preview benefits are subject to future features and confirmation.
Can I sell a Gold Bar directly to another player?
The Marketplace supports **eligible Gold Bar item listings** with seller-defined prices in VALE, subject to tradeability and the listing workflow. **Live VALE buyer settlement is disabled by default**. Ordinary Gold Shop selling is a separate Gold-based action.
Are the Golden Hammer bonus and premium lure effects active?
The stated bonuses are **game interface catalog descriptions**, not proven active in-game benefits. They are displayed here as future product concepts only.
Are the Premium Cow and Goat available through regular livestock trade?
The premium catalog describes them as account-bound and non-sellable. The current player Marketplace rejects **animal listings** in general.
Can I use Gold to pay a Premium Shop price?
Not under the described design. The Premium Shop uses **VALE preview prices**; ordinary Gold shops are separate and already have their own item catalog.
**Related guides:** [VALE Utility & Game Economy](https://harvest-vale.gitbook.io/harvest-vale-docs/economy-and-blockchain/vale-utility-and-game-economy) · [Gold & Trading](https://harvest-vale.gitbook.io/harvest-vale-docs/economy-and-blockchain/gold-and-trading) · [RWA Exchange & Mineral Conversion](https://harvest-vale.gitbook.io/harvest-vale-docs/economy-and-blockchain/rwa-exchange-and-mineral-conversion).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://harvest-vale.gitbook.io/harvest-vale-docs/economy-and-blockchain/marketplace-and-premium-shop.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.