Skip to content

Instantly share code, notes, and snippets.

View vikramlayerv's full-sized avatar

vlayerv vikramlayerv

  • Joined Mar 6, 2026
View GitHub Profile
@vikramlayerv
vikramlayerv / discord_bot_spec.v34_updated_vikram.md
Created April 4, 2026 02:43
Qurl Discord Bot — Updated Design Document (v34 with review feedback)

Qurl Discord Bot — Design Document (Updated with Review Feedback)

1. Overview

Qurl Bot is a Discord bot developed by LayerV that protects files shared between users by wrapping them in secure, time-limited, single-use QURL links. There are two primary flows:

  1. DM Upload Flow — A file owner DMs a file directly to Qurl Bot. The bot validates the file size (max 25MB) and file type, validates the Discord CDN URL, uploads the file to getqurllink.layerv.ai, which stores the file in S3, registers it as a LayerV resource with fileviewer.layerv.ai as the access-controlled target, and returns a resource_id and a one-time-use qurl_link. The bot forwards both to the owner via DM. The owner's link is also single-use — if the owner wants to share with multiple recipients, they must use the dispatch flow.

  2. Slash Command Dispatch Flow — In a guild channel, the file owner uses /qurl send where `` is a comma-separated list of user mentions or IDs. The bot verifies