Skip to content

Instantly share code, notes, and snippets.

@luckysitara
Last active November 24, 2025 12:15
Show Gist options
  • Select an option

  • Save luckysitara/90b3c5587a6137831658a92ad9826166 to your computer and use it in GitHub Desktop.

Select an option

Save luckysitara/90b3c5587a6137831658a92ad9826166 to your computer and use it in GitHub Desktop.
location wasn't included in the ip analysis output( and also if the analysis return the latitude and longitude of the location is there a way we can add a map feature using google map to view the location? ) and the result instead of being displayed in the same page can have a different page for it just like pii intelligence result page
https://v0.app/chat/sentinel-6pqhUTAgEUc
AIzaSyCoNJkO0GhoeY2uy6NPzxeVF0GxZvy33qI
@luckysitara
Copy link
Author

This is an excellent next step. A well-defined Product Requirements Document (PRD) is the blueprint for a winning hackathon submission, ensuring your team is aligned on scope, features, and success metrics.
Here is a detailed PRD for your project, 'Solana Copilot'.
πŸ“ Product Requirements Document (PRD)
Project: Solana Copilot (AI-Powered DeFi Agent)

Document Version Date Target Audience Status
v1.0 (Hackathon MVP) Nov 24, 2025 Developers, Designers, Judges Active
  1. Goal and Problem Statement
    🎯 Goal
    To build a secure, demonstrably working Minimum Viable Product (MVP) of an AI Agent on Solana that simplifies complex, multi-step DeFi transactions using natural language, drastically reducing friction for users.
    ❓ Problem Statement
    Executing multi-step financial actions on Solana DeFi (e.g., swapping tokens, providing liquidity, staking LSTs) requires users to navigate multiple dApps, understand complex Web3 jargon (slippage, impermanent loss, epochs), and manually calculate required token inputs. This complexity creates a steep barrier to entry, leading to confusion, errors, and lost capital.
    βœ… Success Metrics (KPIs for Judging)
    | Metric | Target | Notes |
    |---|---|---|
    | P0: Transaction Chain Success Rate | 100% | The Agent must successfully execute a minimum of one 3-step transaction chain (e.g., Swap, LP Deposit, Stake). |
    | P1: Interpretive Accuracy | 90% | The Agent's pre-execution summary must accurately describe the on-chain action in plain English for 9/10 unique prompts. |
    | P2: Core Tool Integration | Min. 3 | Successfully integrate and leverage three key Solana DeFi protocols (Jupiter, Orca, Kamino/Marinade). |
    | P3: Wallet Insight Utilization | 100% | Agent must always reference the user's current token balances in its reasoning before proposing an action. |
  2. Target User & Use Cases
    πŸ‘€ Target User: The DeFi Novice/Efficiency Seeker
  • Persona: A user new to Solana DeFi or an experienced user looking for maximum efficiency.
  • Need: Simplicity, security, and a single-interface solution to manage complex crypto actions.
  • Core Fear: Losing funds due to a mistake in a manual, multi-step transaction.
    πŸš€ User Stories (The Core MVP Scope)
    | Priority | User Story | Agent Capability Focus |
    |---|---|---|
    | P0 (Critical) | As a connected user, I want to type "Deposit all my USDC into the highest-yielding Orca pool," so that the Agent autonomously finds the pool and generates the transaction. | Multi-Step Tool Use |
    | P0 (Critical) | As a user, I want the Agent to clearly display a human-readable summary before I sign, so I know exactly what I'm approving. | LLM-Powered Transaction Interpretation |
    | P1 (High) | As a connected user, I want to type "Stake my SOL," so that the Agent automatically uses Marinade to generate the stake transaction and calculate the correct amount of SOL. | Balance-Aware Action |
    | P1 (High) | As a user, I want the Agent to ask clarifying questions if my prompt is too vague (e.g., "Which token do you want to use?"), so I can correct the instruction. | Refinement/Ambiguity Handling |
  1. Functional Requirements (Features)
    The MVP will be delivered with the following feature set:
    3.1. R/W (Read/Write) Engine
    | Requirement | Description |
    |---|---|
    | FR1. Wallet Connection | Must use the Solana Wallet Adapter to connect major wallets (Phantom, Backpack). Must retrieve the user's Public Key (publicKey). |
    | FR2. Balance Read | Upon connection, the Agent must fetch and maintain a list of all SPL Token and native SOL balances for the connected wallet. |
    | FR3. Transaction Generation | Must construct a Serialized Transaction using the required on-chain instruction set (via Jupiter, Orca SDKs). |
    | FR4. Transaction Broadcast | Must push the signed transaction to the Solana network (using a fast RPC, e.g., Helius/QuickNode). |
    3.2. AI Agent Core
    | Requirement | Description |
    |---|---|
    | FR5. Intent & Tool Selection | The LLM must accurately parse the user's natural language into a sequence of defined "Tools" (e.g., SwapTool, LPTool, StakeTool). |
    | FR6. Token/Amount Parsing | The LLM must extract token symbols (e.g., USDC) and amounts from the input and validate them against FR2 (wallet balances). |
    | FR7. Transaction Interpretation | Before signing, the LLM must generate a concise, step-by-step summary of the action and its consequences (e.g., "You are about to send $500 USDC to Orca..."). |
    3.3. UX/UI Requirements
    | Requirement | Description |
    |---|---|
    | FR8. Chat Interface | A simple, streaming chat window for user input and Agent output. |
    | FR9. Pre-Execution Review | A dedicated panel must appear showing the FR7 summary and the estimated gas fee before the wallet signing prompt is triggered. |
    | FR10. Status Updates | The UI must provide real-time updates: Processing Request, Generating Transaction, Waiting for Wallet Signature, Transaction Confirmed (with a link to Solscan). |
  2. Technical Requirements & Dependencies
    | Category | Requirement | Tools/Tech Stack |
    |---|---|---|
    | Frontend | Responsive chat interface | React/Next.js, Tailwind CSS |
    | AI/LLM Core | Reasoning, Tool selection, Interpretation | LangChain or Solana Agent Kit (for tool definition), OpenAI API (or similar LLM) |
    | Wallet | Wallet connection, signing | @solana/wallet-adapter-react-ui, useWallet() |
    | On-Chain Data/Execution | Balances, Transaction construction/sending | @solana/web3.js, Jupiter SDK, Orca SDK |
    | Infrastructure | Fast network access | High-speed RPC (e.g., Helius) for reliable transaction broadcasting. |
    | Code | Open-Source submission | GitHub Repository, detailed README.md |
  3. Non-Goals (Out of Scope for Hackathon MVP)
    To maintain focus and deliver a complete, high-quality MVP, the following are out of scope:
  • Proactive Agents: The Agent will only execute actions in response to a direct user prompt (no continuous, autonomous trading/rebalancing).
  • Portfolio Tracking Charts: Simple balance read-out (FR2) is sufficient. No complex charting or historical performance data.
  • Detailed Risk Analysis: The Agent will not provide in-depth analysis of "impermanent loss risk" or other deep DeFi concepts. It will prioritize execution.
  • Multi-chain Support: Solana only.
    This structured approach will guide your team, keep the scope manageable, and provide the judges with a clear measure of your project's success. Good luck!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment