Shotty - Your AI Butler for Flow Network

Live: https://shotty-beta.vercel.app/

🌟 Chat Your Way Through Web3 🌟

Transform complex blockchain operations into simple conversations

💫 What is Shotty?

Shotty is an intelligent AI butler that brings conversational simplicity to Flow Network. No more complex forms, confusing interfaces, or wallet addresses to copy-paste. Just chat naturally with Shotty to:

• 💸 Send tokens across chains

• 🎨 Mint NFTs with IPFS storage

• 🌐 Register .flow domains

• 👤 Manage contacts on-chain

• 🔗 Create payment links anyone can redeem

• 📊 Track transactions and view history

• 📱 Generate QR codes for wallet addresses

• 🪙 Create ERC20 tokens with custom parameters

• 🌉 Bridge tokens across multiple blockchain networks

• ⚡ Batch EVM transactions for efficient multi-operation execution

• ⏰ Schedule transactions for future execution with time-locks

• 🔄 Flow Actions for composable transaction workflows

• 💰 Lending & Borrowing with DeFi protocols integration

Powered by: AI + Flow Network EVM + DeFi Protocols

✨ Features & Capabilities

🎯 Complete Feature Matrix

🎪 Command Examples

📝 Natural Language Commands

🏗️ Architecture & Technology

🛠️ Tech Stack

┌─────────────────────────────────────────────────────────┐
│                    Frontend Layer                       │
│  Next.js 15 • React 19 • TypeScript • Tailwind CSS      │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│                      AI Layer                           │
│        OpenAI • Intent Parser • NLP                     │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│                  Blockchain Layer                       │
│      Flow Network EVM • Ethers.js • Viem  • DiFi        │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│                   Storage Layer                         │
│         Pinata (IPFS) • On-Chain Metadata               │
└─────────────────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

• Node.js 18+

• npm or yarn

• MetaMask or any Web3 wallet

• OpenAI API Key (Get one here)

• Pinata Account (Sign up) for IPFS

Installation

1. Clone the repository

   git clone https://github.com/jintukumardas/shotty
   cd shotty

2. Install dependencies

3. Set up environment variables

   cp .env.example .env.local

4. Configure .env.local

   # Flow Network ConfigurationNEXT_PUBLIC_FLOW_CHAIN_RPC=https://testnet.evm.nodes.onflow.org
   NEXT_PUBLIC_FLOW_CHAIN_ID=545NEXT_PUBLIC_FLOW_NETWORK=testnet
   
   # OpenAIOPENAI_API_KEY=sk-proj-your-key-here
   
   # Pinata (IPFS)NEXT_PUBLIC_PINATA_JWT=your-pinata-jwt
   NEXT_PUBLIC_PINATA_GATEWAY=your-gateway.mypinata.cloud
   
   # Deployed Contracts (Flow EVM Testnet)NEXT_PUBLIC_ESCROW_CONTRACT_ADDRESS=0x5d726C51a99a0F78a05b5ab1591340B321778e75
   NEXT_PUBLIC_NFT_CONTRACT_ADDRESS=0x332ee5D730cBFD516Bac7D1e0CFf763d235dFF0A
   NEXT_PUBLIC_DOMAIN_CONTRACT_ADDRESS=0x55422db56C11a62AfB285e70c6a541A9E80B70f3
   NEXT_PUBLIC_ADDRESSBOOK_CONTRACT_ADDRESS=0x4354BE4A734E3DC61182F0e09Bc5B0cc264CC218
   NEXT_PUBLIC_SECURESTORAGE_CONTRACT_ADDRESS=0x42D2e14cb7d931216F0154625db3dA4F3e90525B
   NEXT_PUBLIC_TOKEN_FACTORY_CONTRACT_ADDRESS=0xbb3E64F2D72ac754c7C98eC43b549F0F78bd26a0
   NEXT_PUBLIC_BATCH_CONTRACT_ADDRESS=0xC3d8AfB3462f726Db9d793DefdCFC67D7E12DBa3
   NEXT_PUBLIC_SCHEDULED_CONTRACT_ADDRESS=0xfF0e7F71a0e19E0BF037Bd90Ba30A2Ee409E53a7
   NEXT_PUBLIC_FLOW_ACTIONS_CONTRACT_ADDRESS=0xe4ab654a03826E15039913D0D0E1E4Af2117bA0d
   NEXT_PUBLIC_LENDING_CONTRACT_ADDRESS=0x3b4cAE62020487263Fc079312f9199a1b014BF6b

5. Run development server

   npm run dev

6. Open your browser

   http://localhost:3000

7. Get testnet tokens

   • Visit Flow Testnet Faucet

   • Connect your wallet

   • Request test FLOW tokens

🎮 Usage Guide

First Time Setup

1. Connect Wallet - Click the wallet button in the top right

2. Get Test Tokens - Use the faucet link in the dashboard

3. Start Chatting - Type natural language commands in the chat

Example Workflow

You: "What's my balance?"Shotty: You have 10.5 FLOW on Flow EVM Testnet

You: "Send 1 FLOW to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"Shotty: I'll send 1 FLOW to 0x742d... Please confirm.
     [Confirm] [Cancel]

You: [Confirm]
Shotty: ✅ Transaction sent! Hash: 0xabc...def
     View on explorer →

You: "Mint an NFT"Shotty: Let me help you mint an NFT! Please provide:
     - Name
     - Description
     - Image upload
     [Opens NFT minting modal]

🌐 Deployed Contracts

📚 Resources

Official Links

• 🌐 Flow Network: flow.com

• 📖 Documentation: Flow Developers

• 🔍 Block Explorer: Flow EVM Testnet Explorer

• 💧 Testnet Faucet: Flow Testnet Faucet

• 🚀 Flow Actions & Workflows: Forte Upgrade Overview

📖 Developer Tutorials & Guides

Cross-VM & Advanced Features

• ⚡ Batched EVM Transactions: Tutorial

• ⏰ Scheduled Transactions: Introduction

Flow Actions & Composability

• 🔄 Flow Actions Introduction: Getting Started

• 🔌 Flow Actions Connectors: Documentation

• 🧩 Basic Combinations: Composing Actions

• 📝 Flow Actions Transactions: Transaction Guide

Cadence Smart Contracts

• 🏗️ Building Frontend Apps: Frontend Integration

• 🔗 Smart Contract Interaction: Interaction Guide

• 🎼 Compose with Transactions: Transaction Composition

• 📊 Native Data Availability: Scripts Guide

Advanced Topics

• 🔢 Fixed Point Math (128-bit): Math Library

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• 💜 Flow Foundation - For creating the Flow Network and EVM compatibility

• 🌟 Flow Community - For continuous support and feedback

• 🤖 OpenAI - For GPT powering the AI butler

• 📌 Pinata - For reliable IPFS infrastructure

📞 Support & Contact

• 🐛 Report Issues: GitHub Issues

• 💬 Discussions: GitHub Discussions

• 📧 Email: jintudas098@gmail.com

• 🐦 Twitter: @jintuisbusy

🌟 Built with ❤️ for Flow Network 🌟