# File Sharing

KayakNet supports sharing files through the chat system and marketplace.

## Current Capabilities

### Images in Chat

Share images directly in chat:

1. Click the image icon in chat
2. Select file from device
3. Image is encrypted and sent
4. Recipient sees inline preview

**Supported formats:**

* JPEG/JPG
* PNG
* GIF
* WebP

**Size limit:** 5MB per image

### Marketplace Images

Listings can include product images:

* Main image (required)
* Up to 5 additional images
* Compressed for network efficiency

## How It Works

### Image Encoding

```
1. User selects image
   │
2. Image resized (max 1920x1080)
   │
3. Compressed to JPEG (quality 85%)
   │
4. Base64 encoded
   │
5. Encrypted with room/recipient key
   │
6. Sent via standard message
```

### Delivery

* Small images (<100KB): Inline in message
* Large images: Chunked delivery
* DHT: Store-and-forward for offline

## Planned Features

### Full File Sharing (Coming Soon)

Share any file type:

* Documents (PDF, TXT, etc.)
* Archives (ZIP, TAR)
* Media (video, audio)
* Any binary file

### Distributed Storage

Large files will be:

1. Split into chunks
2. Encrypted per-chunk
3. Distributed across DHT
4. Retrieved on demand

### BitTorrent Integration

For large files:

* Create KayakNet torrents
* Share magnet links in chat
* Download via P2P within network

## Security

### Encryption

All files are encrypted:

* Room files: Room symmetric key
* DM files: Recipient's public key
* Marketplace: Public (for listings)

### Metadata

File metadata is also protected:

* Filename (optional to share)
* Size (padded)
* Type (not leaked)

## Best Practices

1. **Don't share sensitive files** - Unless absolutely necessary
2. **Verify recipients** - Ensure intended audience
3. **Delete after use** - Clear from local storage
4. **Check file sizes** - Large files may be slow

## Limitations

### Current Limitations

| Limitation             | Value       |
| ---------------------- | ----------- |
| Max image size         | 5MB         |
| Max images per listing | 6           |
| File types             | Images only |

### Network Constraints

* Large files strain onion routing
* Slow on mobile connections
* DHT storage is temporary

## API

### Upload Image (Chat)

```
POST /api/chat/upload
Content-Type: multipart/form-data

file: <image data>
room: #general
```

### Get Image

```
GET /api/chat/file?id=file_abc123
```

### Marketplace Image

```
POST /api/market/create
{
  "images": ["data:image/jpeg;base64,..."]
}
```


---

# 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/file-sharing.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.