VYBZ Trading Bot Manual

The complete technical documentation for the Dogecoin L1 NFT Marketplace.

Introduction

Welcome to the VYBZ Market Bot. Unlike traditional Web3 marketplaces that require you to connect a browser extension and sign multiple transactions, the VYBZ bot brings the entire Dogecoin L1 (Doginals) trading experience directly into Telegram.

Our goal is to provide a seamless, lightning-fast trading experience for NFTs. By utilizing our proprietary custom Dogecoin Indexer and an internal ledger, the bot executes trades instantly, securely, and with incredibly low friction and fees.

System Architecture

How it works under the hood:

  • The Indexer: A high-performance Rust-based indexer (doge-indexer) scans the Dogecoin blockchain 24/7. It tracks UTXOs, inscriptions, and transfers in real-time, feeding data directly to the bot's PostgreSQL database.
  • The Ledger: Rather than forcing users to wait 1-2 minutes for Dogecoin block confirmations on every bid, the bot maintains a strict internal state ledger. Offer funds are reserved locally in your bot balance, preventing double-spending while allowing instant UI feedback.
  • Execution: When a trade is accepted, the bot constructs the raw Dogecoin transaction (managing the Doginal UTXOs and the payment UTXOs simultaneously) and broadcasts it to the network via Doge RPC.

Wallet Management

Comprehensive guide to security, custody, and keys.

Generation & Security

Upon initializing the bot via the /start command, a brand new Dogecoin address is natively generated for you. This acts as your dedicated Trading Wallet.

⚠️ Crucial Security Notice

The bot encrypts your private keys in the database. However, this is considered a "hot wallet." You are strictly advised to only keep trading capital in this wallet. Do not use this as a long-term savings vault.

Importing Existing Wallets

If you already have Doginals in a Web3 wallet (like DogeLabs, MyDoge, or DPal), you can link them directly to the bot.

Command: /importkey <YOUR_WIF_PRIVATE_KEY>

Once imported, the indexer will immediately recognize your holdings, and they will populate in your Vault, ready to be flexed or listed.

Exporting & Cold Storage

Because the bot is strictly non-custodial, you can take full control of your keys at any moment.

Command: /exportkey

Triggering this command securely decrypts your WIF (Wallet Import Format) key and displays it in a self-destructing message. You can paste this key into any external Dogecoin wallet to access your funds outside of Telegram.

If you wish to transfer a specific NFT to cold storage without exporting your key, use the Secure Transfer menu in the DMs. The bot will prompt you for a destination address and handle the UTXO transfer on-chain.

The Marketplace (0% Fee)

Deep dive into listing, bidding, and execution mechanics.

Listing NFTs

The VYBZ marketplace charges 0% platform fees. When you sell an asset, you receive 100% of the DOGE.

  1. Click List My VYBZ in the main menu.
  2. The bot queries the indexer for your owned assets and presents them as inline buttons.
  3. Select the asset (e.g., [🏷️ List VYBZ #333]).
  4. The bot prompts you to enter a price. Type the whole number in DOGE (e.g., 50000).

Once listed, your asset is instantly broadcast to the /floor tracker and becomes visible to anyone browsing the market.

Bidding & Order Execution

When you make an offer on an NFT, the bot reserves the DOGE in your local ledger balance to guarantee safety for both the buyer and the seller.

  • Locking Funds: When you confirm a bid, the DOGE is immediately deducted from your available balance. This prevents you from accidentally double-spending the DOGE on another NFT.
  • Seller Notification: The owner of the NFT receives an instant DM alerting them to the bid.
  • Revoking Offers: You can cancel your bid at any time via the Manage Orders tab. The reserved DOGE is instantly unlocked to your available balance.
  • External Spends: If you export your key and manually spend your DOGE elsewhere while an offer is pending, any attempt to accept that offer will be instantly rejected by the Dogecoin network (UTXO already spent). Blockchain consensus mathematically prevents the trade, ensuring the seller's NFT is perfectly safe and never leaves their wallet.

Social & Public Commands

The /flex Mechanic

Trading is social. By typing /flex in the main Telegram group, the bot queries your wallet and generates a customized public broadcast.

It displays a high-quality video banner, your username, how many VYBZ you own, and your liquid DOGE balance. This acts as a social flex while simultaneously providing a "🛒 Get a VYBZ to Flex" button that funnels new users directly into the bot.

Live Market Stats (/vybz)

The /vybz command (or /menu) acts as the public dashboard for the ecosystem.

When executed, it pulls real-time analytics from the indexer database, including:

  • Floor Price: The absolute lowest active listing.
  • Total Volume: The aggregate sum of all historical sales.
  • Holders: The exact number of unique wallets holding a VYBZ token.

This command also serves as the primary gateway, offering users inline buttons to instantly transition to the DMs to buy, sell, or view the leaderboard.