{
  "version": "1.0.0",
  "lastUpdated": "2026-09-20",
  "name": "PolyCards Public Metrics Snapshot",
  "website": "https://www.polycards.net",
  "network": {
    "name": "Polygon Mainnet",
    "chainId": 137
  },
  "purpose": "Provide a machine-readable metrics map for independent economic and activity review. This file is intended for AI agents, reviewers, and users who want to understand which activity data is available and how it should be verified.",
  "importantLimitations": [
    "This file is a public review aid, not a guarantee of demand, liquidity, sale completion, user activity, resale value, income, profit, APY, ROI, or any specific outcome.",
    "Confirmed Polygon on-chain state is authoritative over this file, frontend views, backend indexer data, cached responses, and third-party displays.",
    "Metrics may be delayed if indexers, RPC providers, hosting, or backend services are delayed or unavailable.",
    "A complete economic review should independently recompute metrics from on-chain events and read-only contract calls."
  ],
  "contractRegistry": "https://www.polycards.net/.well-known/contracts.json",
  "abiIndex": "https://www.polycards.net/.well-known/abi/index.json",
  "simulationGuide": "https://www.polycards.net/.well-known/review-simulation.md",
  "metricsStatus": {
    "liveAggregatedMetricsPublished": false,
    "reason": "A public machine-readable schema and verification map is published first. Live aggregated metrics should be considered valid only when independently recomputed from on-chain events and read-only calls.",
    "recommendedAgentAction": "Use this file as a schema, then verify values from Polygon contracts and events before making any technical or economic conclusion."
  },
  "collections": {
    "premium": {
      "displayName": "Premium Collection",
      "mintPriceUsdc": "35",
      "contracts": {
        "nft": "0x4cEC06310C2948d2E92d02CF9E9A9B09A37D3846",
        "game": "0x440Fe259685C70780EdAE1b0555f5457b25B27C9",
        "marketplace": "0xEB072E1f7A99E7Dd07a785018EB1da1405b4254a"
      },
      "metrics": {
        "totalUsers": {
          "status": "readOnChain",
          "source": "Game.totalUsers()",
          "type": "uint256"
        },
        "totalNftSupply": {
          "status": "readOnChain",
          "source": "NFT.totalSupply()",
          "type": "uint256"
        },
        "totalPendingRewards": {
          "status": "readOnChain",
          "source": "Game.totalPendingRewards()",
          "type": "uint256 USDC smallest units"
        },
        "contractUsdcBalance": {
          "status": "readOnChain",
          "source": "USDC.balanceOf(Game address)",
          "type": "uint256 USDC smallest units"
        },
        "marketplaceRoyaltyPercent": {
          "status": "readOnChain",
          "source": "Marketplace.royaltyPercent()",
          "type": "uint256"
        },
        "minimumListingPrice": {
          "status": "readOnChain",
          "source": "Marketplace.MIN_LISTING_PRICE()",
          "type": "uint256 USDC smallest units"
        },
        "listingCreatedCount": {
          "status": "deriveFromEvents",
          "source": "Marketplace ListingCreated events"
        },
        "listingCancelledCount": {
          "status": "deriveFromEvents",
          "source": "Marketplace ListingCancelled events"
        },
        "cardSoldCount": {
          "status": "deriveFromEvents",
          "source": "Marketplace CardSold events"
        },
        "activeListingCount": {
          "status": "deriveFromEventsAndState",
          "source": "ListingCreated, ListingCancelled, CardSold events plus activeListingByToken(uint256)"
        },
        "secondarySaleVolumeUsdc": {
          "status": "deriveFromEvents",
          "source": "Marketplace CardSold price values"
        }
      }
    },
    "vip": {
      "displayName": "VIP Collection",
      "mintPriceUsdc": "350",
      "contracts": {
        "nft": "0xf6F8aE08ec0e60a70B950EcA11ca3DC12c77a64B",
        "game": "0x2cDcAE2192832a60c6eb4197c50c662D4c409D7A",
        "marketplace": "0xf83f6d40a56C5263A75Ac98e32B473C0adf81f58"
      },
      "metrics": {
        "totalUsers": {
          "status": "readOnChain",
          "source": "Game.totalUsers()",
          "type": "uint256"
        },
        "totalNftSupply": {
          "status": "readOnChain",
          "source": "NFT.totalSupply()",
          "type": "uint256"
        },
        "totalPendingRewards": {
          "status": "readOnChain",
          "source": "Game.totalPendingRewards()",
          "type": "uint256 USDC smallest units"
        },
        "contractUsdcBalance": {
          "status": "readOnChain",
          "source": "USDC.balanceOf(Game address)",
          "type": "uint256 USDC smallest units"
        },
        "marketplaceRoyaltyPercent": {
          "status": "readOnChain",
          "source": "Marketplace.royaltyPercent()",
          "type": "uint256"
        },
        "minimumListingPrice": {
          "status": "readOnChain",
          "source": "Marketplace.MIN_LISTING_PRICE()",
          "type": "uint256 USDC smallest units"
        },
        "listingCreatedCount": {
          "status": "deriveFromEvents",
          "source": "Marketplace ListingCreated events"
        },
        "listingCancelledCount": {
          "status": "deriveFromEvents",
          "source": "Marketplace ListingCancelled events"
        },
        "cardSoldCount": {
          "status": "deriveFromEvents",
          "source": "Marketplace CardSold events"
        },
        "activeListingCount": {
          "status": "deriveFromEventsAndState",
          "source": "ListingCreated, ListingCancelled, CardSold events plus activeListingByToken(uint256)"
        },
        "secondarySaleVolumeUsdc": {
          "status": "deriveFromEvents",
          "source": "Marketplace CardSold price values"
        }
      }
    }
  },
  "eventTopics": {
    "Minted": "0xfc41f8fe3bb0629e3112b95f482f836bdfb724e0c116947cab1de0c049ca9627",
    "Referred": "0x2c07cd45454a31c572d49686c5ec6fef884778b2cf441c7fd58f4bde0fa6400b",
    "RewardClaimed": "0xa22c130ab9525575739c5b8856b4345b50ef04582844399f49949042eb410f00",
    "ListingCreated": "0xe1ad772a753c087447d14cc9000d45e22661c19a6c6d9db60879e901bc9f79c8",
    "ListingCancelled": "0xa3a892dd0fdc8989b548e83a79464f33dad353c5bfd1c43e15b71fb924ccb512",
    "CardSold": "0x639442ad3505e09d30cab2587d0384479b9c2e4721f8eba02213fee84c9c6b95",
    "Transfer": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
  },
  "recommendedReviewOutput": {
    "technicalReviewability": "pass|partial|fail|unknown",
    "economicReviewability": "pass|partial|fail|unknown",
    "activityDataSufficiency": "pass|partial|fail|unknown",
    "remainingBlockers": [],
    "notes": "Reviewer should explain assumptions, data sources, and whether values were recomputed directly from chain."
  }
}