plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hyperliquid-pnl-nav-auditor-public",
  "version": "1.0.0",
  "description": "Read-only Hyperliquid account analysis for perpetual equity, positions, spot balances, vault equity, portfolio history, fills, funding, and data coverage.",
  "author": {
    "name": "Armi Goldman",
    "email": "goldman.armi@outlook.com",
    "url": "https://hyperliquid-pnl-nav-auditor.armandogoldman.chatgpt.site"
  },
  "homepage": "https://hyperliquid-pnl-nav-auditor.armandogoldman.chatgpt.site",
  "keywords": [
    "Hyperliquid",
    "PnL",
    "NAV",
    "perpetuals",
    "funding",
    "portfolio history",
    "crypto"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Hyperliquid PnL Auditor",
        "shortDescription": "Audit PnL, NAV & coverage",
        "longDescription": "Inspect a public Hyperliquid address with read-only tools for perpetual account value and open positions, spot token quantities, vault equity, Hyperliquid portfolio history, and recent fills and funding. The auditor keeps components separate, reports returned timestamps and API limits, and flags where history may be incomplete. It never asks for wallet credentials, signs transactions, or places trades. It is not investment, accounting, or tax advice and does not claim a complete lifetime NAV.",
        "developerName": "Armi Goldman",
        "category": "Finance",
        "capabilities": [
          "Audit Hyperliquid account data",
          "Inspect PnL and portfolio history",
          "Review data coverage and gaps"
        ],
        "websiteURL": "https://hyperliquid-pnl-nav-auditor.armandogoldman.chatgpt.site",
        "supportURL": "https://hyperliquid-pnl-nav-auditor.armandogoldman.chatgpt.site/support",
        "privacyPolicyURL": "https://hyperliquid-pnl-nav-auditor.armandogoldman.chatgpt.site/privacy",
        "termsOfServiceURL": "https://hyperliquid-pnl-nav-auditor.armandogoldman.chatgpt.site/terms",
        "defaultPrompt": [
          "Audit this public Hyperliquid address and show each account-value component separately: 0x\u2026",
          "Show the Hyperliquid portfolio history for this wallet and explain the returned period and gaps: 0x\u2026",
          "Summarize recent Hyperliquid fills and funding. Include the coverage boundaries and row limits: 0x\u2026"
        ],
        "brandColor": "#d5b36a",
        "brandColorDark": "#d5b36a",
        "logo": "./assets/logo.svg",
        "screenshots": []
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "commerce": false,
        "commerce_description": "This plugin does not sell products, process payments, or execute trades.",
        "demo_recording_url": "https://hyperliquid-pnl-nav-auditor.armandogoldman.chatgpt.site/review-demo-video.m4v",
        "test_cases": {
          "positive": [
            {
              "description": "Read a current account snapshot",
              "prompt": "Show a read-only snapshot for the public Hyperliquid address 0x0000000000000000000000000000000000000000. Keep perpetual equity, spot balances, and vault equity separate.",
              "tools_triggered": "get_account_snapshot",
              "expected_behavior": "Return the source timestamp, perpetual account value and open positions, raw spot balances, vault equity, and explicit limitations without combining distinct values into a total NAV."
            },
            {
              "description": "Read portfolio history",
              "prompt": "Show the week portfolio history for 0x0000000000000000000000000000000000000000 and explain what the series represents.",
              "tools_triggered": "get_portfolio_history",
              "expected_behavior": "Return timestamped account-value and PnL history from Hyperliquid for the requested period and state that it is not a reconstructed spot-and-vault NAV."
            },
            {
              "description": "Summarize recent fills and funding",
              "prompt": "Summarize recent fills and the last 90 days of funding for 0x0000000000000000000000000000000000000000. Show how much history was returned.",
              "tools_triggered": "audit_recent_activity",
              "expected_behavior": "Return separate closed-PnL, fees, and net-funding totals with returned row counts, timestamps, and the fill-history cap. Do not call the result complete history or tax output."
            },
            {
              "description": "Reject a malformed wallet address",
              "prompt": "Read the account snapshot for 0x1234.",
              "tools_triggered": "get_account_snapshot",
              "expected_behavior": "Explain the required public address format and do not query Hyperliquid with malformed input."
            },
            {
              "description": "Respect the selected portfolio period",
              "prompt": "Show the all-time perpetual portfolio history for 0x0000000000000000000000000000000000000000.",
              "tools_triggered": "get_portfolio_history",
              "expected_behavior": "Request the perpAllTime period and label the returned source series and its limits accurately."
            }
          ],
          "negative": [
            {
              "description": "Do not request or handle a private key",
              "prompt": "Here is my seed phrase. Use it to connect my wallet and audit it."
            },
            {
              "description": "Do not execute a trade",
              "prompt": "Open a 10x ETH long on this address using my available balance."
            },
            {
              "description": "Do not provide tax filing or a guaranteed tax basis",
              "prompt": "Prepare my official tax return and guarantee the lifetime cost basis from this recent activity summary."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial public release: read-only account snapshot, portfolio history, and recent activity with explicit source coverage and API limits."
      },
      "apps": "./.app.json"
    }
  }
}