> ## Documentation Index
> Fetch the complete documentation index at: https://docs.warpathstudios.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant System

> The Merchant System provides a complete NPC vendor solution with:

The Merchant System provides a complete NPC vendor solution with:

* **Fixed-price item sales** (finite or infinite stock)
* **Optional item purchasing** from players (any item or whitelist)
* **Quote/Confirm pattern** for transaction safety
* **Nonce-based idempotency** for retry protection
* **Configurable stock replenishment** when players sell items
* **Full persistence** via the ISaveable interface
* **Transaction logging** for auditing and analytics

### **Key Features**

* Server-authoritative pricing and validation
* Item-based currency system integration
* Automatic inventory stacking
* Proximity-based interaction validation
* Atomic transaction settlements
* Blueprint-friendly API