# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kayaknet.io/features/marketplace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
