# Marketplace

The KayakNet Marketplace is a decentralized, anonymous platform for buying and selling goods and services using cryptocurrency.

## Overview

* **Fully Decentralized** - No central server, listings stored across DHT
* **Anonymous** - Sellers and buyers use pseudonyms
* **Crypto Payments** - Monero (XMR) and Zcash (ZEC) only
* **Escrow System** - Trustless transactions with dispute resolution

## Accessing the Marketplace

1. Start your KayakNet node with `--proxy`
2. Configure browser proxy
3. Navigate to `http://market.kyk` or `http://marketplace.kyk`

## For Buyers

### Browsing Listings

The marketplace shows all active listings from the network. You can:

* **Search** by keyword
* **Filter** by category
* **Sort** by price, date, or rating

### Making a Purchase

1. **Find a listing** - Browse or search
2. **Click "BUY"** - Opens purchase modal
3. **Choose currency** - XMR or ZEC
4. **Enter delivery info** - Encrypted for seller only
5. **Create order** - Generates escrow address
6. **Send payment** - To the escrow address shown
7. **Wait for confirmation** - Payment verified
8. **Seller ships** - You'll see tracking info
9. **Confirm receipt** - Releases funds to seller

### Order States

| State     | Description                     | Your Action           |
| --------- | ------------------------------- | --------------------- |
| CREATED   | Order created, awaiting payment | Send crypto           |
| FUNDED    | Payment received                | Wait for shipping     |
| SHIPPED   | Item shipped                    | Confirm when received |
| COMPLETED | You confirmed receipt           | None                  |
| DISPUTED  | Dispute opened                  | Provide evidence      |

### Disputes

If something goes wrong:

1. Click **"OPEN DISPUTE"** on your order
2. Explain the issue
3. Provide any evidence (screenshots, tracking info)
4. Moderators will review
5. Funds released to appropriate party

## For Sellers

### Creating a Listing

1. Go to Marketplace
2. Click **"CREATE LISTING"**
3. Fill in details:
   * **Title** - Clear, descriptive name
   * **Description** - Detailed product info
   * **Category** - Select appropriate category
   * **Price** - In USD equivalent
   * **Currency** - Accept XMR, ZEC, or both
   * **Images** - Upload product photos
   * **Stock** - Available quantity
   * **Ships From** - General location
   * **Ships To** - Regions you ship to
   * **Delivery Time** - Estimated days
4. **Enter your wallet addresses:**
   * Monero address (if accepting XMR)
   * Zcash address (if accepting ZEC)
5. Click **"PUBLISH"**

### Managing Sales

1. Go to **"MY LISTINGS"** tab
2. View your active listings
3. Check **"SALES"** tab for orders

### Fulfilling Orders

When you receive an order:

1. Order appears in **"SALES"** with state "FUNDED"
2. Prepare and ship the item
3. Click **"MARK AS SHIPPED"**
4. Enter tracking information (optional)
5. Wait for buyer to confirm receipt
6. Funds released to your wallet

### Seller Tips

* **Respond quickly** - Buyers expect fast communication
* **Accurate descriptions** - Avoid disputes
* **Good photos** - Multiple angles, clear quality
* **Competitive pricing** - Check similar listings
* **Build reputation** - Good reviews attract more buyers

## Escrow System

All transactions go through escrow:

```
┌──────────┐     ┌──────────┐     ┌──────────┐
│  Buyer   │────▶│  Escrow  │────▶│  Seller  │
│          │     │  Wallet  │     │          │
└──────────┘     └──────────┘     └──────────┘
   Sends            Holds           Receives
  Payment        Until Confirm       Payment
```

### Escrow Timeline

1. **Order Created** - Buyer has 24 hours to pay
2. **Payment Received** - Funds held in escrow
3. **Shipped** - Seller marks as shipped
4. **14-Day Window** - Buyer has 14 days to confirm or dispute
5. **Auto-Release** - If buyer doesn't respond, funds release after 14 days

### Fees

| Fee Type     | Amount                    |
| ------------ | ------------------------- |
| Platform Fee | 2.5%                      |
| Network Fee  | Variable (crypto network) |

## Categories

Available categories:

* Digital Goods
* Physical Goods
* Services
* Art & Collectibles
* Electronics
* Books & Media
* Other

## Best Practices

### For Buyers

* Check seller ratings and history
* Read descriptions carefully
* Use messaging to ask questions
* Confirm receipt promptly
* Leave honest reviews

### For Sellers

* Use strong pseudonyms
* Never reveal real identity
* Ship discreetly
* Keep records locally
* Use verified crypto addresses

## Prohibited Items

KayakNet does not allow:

* Weapons
* Illegal drugs
* Stolen goods
* Child exploitation material
* Human trafficking
* Terrorism-related items

Violations result in permanent bans and potential law enforcement reporting.

## Privacy Considerations

* Listings are public to all KayakNet users
* Buyer/seller identities are pseudonymous
* Delivery addresses are E2E encrypted
* Payment addresses are generated fresh per order
* Transaction history is not publicly linked
