@atv-eth/x402-sdk 1.1.0 → 1.1.1

package/index.d.ts

@@ -1,275 +1,267 @@
 /**
- * @atv-eth/x402-sdk - TypeScript Definitions
- * @version 1.1.0
+ * @atv-eth/x402-sdk Types
+ * Auto-generated from OpenAPI spec
+ * Total endpoints: 1383
  */
 
-export interface ATVClientOptions {
-  /** API base URL (default: https://api.web3domains.com) */
-  baseUrl?: string;
-  /** Wallet private key for payments and SIWE authentication */
-  privateKey?: string;
-  /** API key for prepaid credits (alternative to x402) */
+export interface ATVClient {
+  baseUrl: string;
   apiKey?: string;
+  
+  // Core methods
+  get<T>(path: string, params?: Record<string, string>): Promise<T>;
+  post<T>(path: string, body?: any): Promise<T>;
+  
+  // Health
+  health(): Promise<HealthResponse>;
+  sourcesHealth(): Promise<SourcesHealthResponse>;
 }
 
-export interface SIWESession {
-  token: string;
-  address: string;
-  expiresAt: string;
-  rateLimits: {
-    requestsPerMinute: number;
-    dailyLimit: number;
-  };
+export interface HealthResponse {
+  status: 'healthy' | 'unhealthy';
+  version: string;
+  uptime: number;
+  timestamp: string;
 }
 
-export interface SessionStatus {
-  authenticated: boolean;
-  address?: string;
-  expiresAt?: string;
-  expiresIn?: number;
-  createdAt?: string;
-  usage?: {
-    requests: number;
-    lastReset: number;
-  };
-  rateLimits?: {
-    requestsPerMinute: number;
-    dailyLimit: number;
-  };
-  message?: string;
+export interface SourcesHealthResponse {
+  healthy: number;
+  total: number;
+  percentage: string;
+  sources: Record<string, SourceHealth>;
 }
 
-export interface UserProfile {
-  address: string;
-  ens: string | null;
-  avatar: string | null;
-  tier: string;
-  rateLimits: {
-    requestsPerMinute: number;
-    dailyLimit: number;
-  };
-  session: {
-    createdAt: string;
-    expiresAt: string;
-  };
-  usage: {
-    requests: number;
-    lastReset: number;
-  };
+export interface SourceHealth {
+  name: string;
+  healthy: boolean;
+  demoted: boolean;
+  requestCount: number;
+  errorCount: number;
+  avgLatencyMs: number;
 }
 
-export interface UsageStats {
-  address: string;
-  usage: {
-    requests: number;
-    lastReset: number;
-  };
-  rateLimits: {
-    requestsPerMinute: number;
-    dailyLimit: number;
-  };
-  tier: string;
+export interface PriceResponse {
+  token: string;
+  symbol: string;
+  price: number;
+  change24h?: number;
+  source: string;
+  latencyMs: number;
+  cached: boolean;
+  timestamp: string;
 }
 
-export interface ENSProfile {
+export interface ENSResponse {
   name: string;
-  address: string;
-  avatar?: string;
+  address?: string;
   records?: Record<string, string>;
-  resolver?: string;
-  owner?: string;
-}
-
-export interface SocialStats {
-  followers: number;
-  following: number;
-  mutualCount?: number;
-}
-
-export interface BalanceResponse {
-  address: string;
-  balance: string;
-  balanceFormatted: string;
-  chain: string;
-}
-
-export interface DiscoveryResponse {
-  version: string;
-  endpoints: Record<string, any>;
-  freeEndpoints?: string[];
+  avatar?: string;
+  timestamp: string;
 }
 
-/**
- * ATV x402 API Client with SIWE Authentication
- */
-export class ATVClient {
-  /** Wallet address (if configured) */
-  readonly address?: string;
-  /** Whether currently authenticated with SIWE */
-  readonly isAuthenticated: boolean;
-  /** Current JWT token (if authenticated) */
-  readonly token?: string;
-  
-  constructor(options?: ATVClientOptions);
-  
-  // ═══════════════════════════════════════════════════════════════
-  // SIWE AUTHENTICATION
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Sign in with Ethereum (SIWE) */
-  signIn(): Promise<SIWESession>;
-  
-  /** Sign out and invalidate session */
-  signOut(): Promise<{ success: boolean; message?: string }>;
-  
-  /** Check current session status */
-  sessionStatus(): Promise<SessionStatus>;
-  
-  /** Get authenticated user profile */
-  me(): Promise<UserProfile>;
-  
-  /** Get authenticated user's usage stats */
-  myUsage(): Promise<UsageStats>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // CORE
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Check USDC balance on Base */
-  getUSDCBalance(): Promise<string | null>;
-  
-  /** Make raw API request */
-  request<T = any>(endpoint: string, options?: RequestInit): Promise<T>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // FREE ENDPOINTS
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Health check */
-  health(): Promise<{ status: string }>;
-  
-  /** Check free tier usage */
-  usage(): Promise<any>;
-  
-  /** API discovery */
-  discovery(): Promise<DiscoveryResponse>;
-  
-  /** Demo endpoint */
-  demo(): Promise<{ message: string }>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // IDENTITY & ENS
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Resolve ENS name to address */
-  resolveENS(name: string): Promise<{ address: string }>;
-  
-  /** Reverse resolve address to ENS */
-  reverseResolve(address: string): Promise<{ name: string | null }>;
-  
-  /** Get full identity profile */
-  getProfile(name: string): Promise<ENSProfile>;
-  
-  /** Get avatar URL */
-  getAvatar(name: string): Promise<{ avatar: string | null }>;
-  
-  /** Estimate ENS name value */
-  getENSValue(name: string): Promise<{ value: number; currency: string }>;
-  
-  /** Get ENS expiration info */
-  getExpiration(name: string): Promise<{ expires: string; daysRemaining: number }>;
-  
-  /** Batch resolve multiple ENS names */
-  batchENS(names: string[]): Promise<Record<string, string>>;
-  
-  /** Get ENS portfolio for address */
-  getPortfolio(address: string): Promise<{ names: string[] }>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // SOCIAL GRAPH
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Get follower/following counts */
-  getSocialStats(name: string): Promise<SocialStats>;
-  
-  /** Get followers list */
-  getFollowers(name: string, limit?: number): Promise<{ followers: string[] }>;
-  
-  /** Get following list */
-  getFollowing(name: string, limit?: number): Promise<{ following: string[] }>;
-  
-  /** Get mutual followers */
-  getMutuals(name: string): Promise<{ mutuals: string[] }>;
-  
-  /** Get reputation score */
-  getReputation(name: string): Promise<{ score: number }>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // WALLET ANALYTICS
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Get ETH balance */
-  getBalance(address: string): Promise<BalanceResponse>;
-  
-  /** Get ERC20 token balances */
-  getTokens(address: string): Promise<any>;
-  
-  /** Get transaction history */
-  getTransactions(address: string): Promise<any>;
-  
-  /** Get token transfers */
-  getTransfers(address: string): Promise<any>;
-  
-  /** Get NFT holdings */
-  getNFTs(address: string): Promise<any>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // FARCASTER
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Get Farcaster profile */
-  getFarcasterProfile(name: string): Promise<any>;
-  
-  /** Get Farcaster casts */
-  getFarcasterCasts(name: string, limit?: number): Promise<any>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // SECURITY
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Check token security (GoPlus) */
-  checkTokenSecurity(address: string): Promise<any>;
-  
-  /** Check address security (GoPlus) */
-  checkAddressSecurity(address: string): Promise<any>;
-  
-  // ═══════════════════════════════════════════════════════════════
-  // UTILITIES
-  // ═══════════════════════════════════════════════════════════════
-  
-  /** Get current gas prices */
-  getGas(): Promise<any>;
-  
-  /** Get contract ABI */
-  getABI(address: string): Promise<any>;
-  
-  /** Get trending ENS activity */
-  getTrending(): Promise<any>;
-  
-  /** Get top accounts leaderboard */
-  getLeaderboard(): Promise<any>;
-  
-  /** Get ATV agent info */
-  getATVInfo(): Promise<any>;
-  
-  /** Get random security wisdom */
-  getFortune(): Promise<{ fortune: string }>;
-  
-  /** Get supported chains */
-  getChains(): Promise<any>;
-  
-  /** Get token prices */
-  getPrices(symbols?: string[]): Promise<any>;
-}
+// Endpoint paths (for autocomplete)
+export type EndpointPath = 
+  | '/.well-known/x402'
+  | '/api/'
+  | '/api/1inch'
+  | '/api/aave'
+  | '/api/abi/{address}'
+  | '/api/active-users'
+  | '/api/address/age/{address}'
+  | '/api/address/batch/type'
+  | '/api/address/batch/validate'
+  | '/api/address/checksum/{address}'
+  | '/api/address/code/{address}'
+  | '/api/address/iscontract/{address}'
+  | '/api/address/type/{address}'
+  | '/api/address/validate/{address}'
+  | '/api/age/{address}'
+  | '/api/aggregator/'
+  | '/api/aggregator/1inch'
+  | '/api/aggregator/bebop'
+  | '/api/aggregator/chain/{chain}'
+  | '/api/aggregator/cowswap'
+  | '/api/aggregator/jupiter'
+  | '/api/aggregator/kyberswap'
+  | '/api/aggregator/matcha'
+  | '/api/aggregator/odos'
+  | '/api/aggregator/openocean'
+  | '/api/aggregator/paraswap'
+  | '/api/aggregator/socket'
+  | '/api/aggregators'
+  | '/api/ai'
+  | '/api/airdrops'
+  | '/api/alchemy/balances/{address}'
+  | '/api/alchemy/collection/{contract}'
+  | '/api/alchemy/contracts/{address}'
+  | '/api/alchemy/floor/{contract}'
+  | '/api/alchemy/holders/{contract}'
+  | '/api/alchemy/nft/{contract}/{tokenId}'
+  | '/api/alchemy/nfts/{address}'
+  | '/api/alchemy/owners/{contract}'
+  | '/api/alchemy/sales/{contract}'
+  | '/api/alchemy/spam/{contract}'
+  | '/api/alchemy/token/{contract}'
+  | '/api/alchemy/transfers/{address}'
+  | '/api/analytics'
+  | '/api/analytics/endpoints'
+  | '/api/analytics/slow'
+  | '/api/analytics/unused'
+  | '/api/arbitrum'
+  | '/api/arbitrum/status'
+  | '/api/atv'
+  | '/api/auth/logout'
+  | '/api/auth/me'
+  | '/api/auth/nonce'
+  | '/api/auth/session'
+  | '/api/auth/verify'
+  | '/api/avalanche'
+  | '/api/avalanche/status'
+  | '/api/avatar/{name}'
+  | '/api/badges/{name}'
+  | '/api/balance/{address}'
+  | '/api/balancer'
+  | '/api/base'
+  | '/api/base/status'
+  | '/api/batch/arbitrum'
+  | '/api/batch/base'
+  | '/api/batch/defi'
+  | '/api/batch/ens'
+  | '/api/batch/ethereum'
+  | '/api/batch/market'
+  | '/api/batch/optimism'
+  | '/api/batch/polygon'
+  | '/api/bitcoin/24hrprice'
+  | '/api/bitcoin/24hrtransactioncount'
+  | '/api/bitcoin/all'
+  | '/api/bitcoin/avgtxsize'
+  | '/api/bitcoin/avgtxvalue'
+  | '/api/bitcoin/bcperblock'
+  | '/api/bitcoin/blockcount'
+  | '/api/bitcoin/difficulty'
+  | '/api/bitcoin/eta'
+  | '/api/bitcoin/hashrate'
+  | '/api/bitcoin/interval'
+  | '/api/bitcoin/latesthash'
+  | '/api/bitcoin/marketcap'
+  | '/api/bitcoin/stats'
+  | '/api/bitcoin/ticker'
+  | '/api/bitcoin/totalbc'
+  | '/api/block'
+  | '/api/block/latest'
+  | '/api/block/multichain'
+  | '/api/block/{number}'
+  | '/api/blur'
+  | '/api/blur/stats'
+  | '/api/bridge/'
+  | '/api/bridge/across'
+  | '/api/bridge/activity/{address}'
+  | '/api/bridge/arbitrum-base'
+  | '/api/bridge/cbridge'
+  | '/api/bridge/chain/{chain}'
+  | '/api/bridge/ethereum-arbitrum'
+  | '/api/bridge/ethereum-base'
+  | '/api/bridge/ethereum-optimism'
+  | '/api/bridge/ethereum-polygon'
+  | '/api/bridge/hop'
+  | '/api/bridge/large-txs'
+  | '/api/bridge/layerzero'
+  | '/api/bridge/multichain'
+  | '/api/bridge/stargate'
+  | '/api/bridge/stats/{timestamp}'
+  | '/api/bridge/synapse'
+  | '/api/bridge/top'
+  | '/api/bridge/wormhole'
+  | '/api/bridge/{id}'
+  | '/api/bridges'
+  | '/api/bridges/across'
+  | '/api/bridges/activity/{address}'
+  | '/api/bridges/chain/{chain}'
+  | '/api/bridges/ethereum-arbitrum'
+  | '/api/bridges/ethereum-base'
+  | '/api/bridges/ethereum-optimism'
+  | '/api/bridges/ethereum-polygon'
+  | '/api/bridges/hop'
+  | '/api/bridges/large-txs'
+  | '/api/bridges/stargate'
+  | '/api/bridges/stats/{timestamp}'
+  | '/api/bridges/synapse'
+  | '/api/bridges/top'
+  | '/api/bridges/wormhole'
+  | '/api/bridges/{id}'
+  | '/api/bsc'
+  | '/api/bsc/status'
+  | '/api/btc'
+  | '/api/btc-dominance'
+  | '/api/busd'
+  | '/api/cache/clear'
+  | '/api/cache/reset-stats'
+  | '/api/cache/stats'
+  | '/api/casts/{identifier}'
+  | '/api/categories'
+  | '/api/category/bridges'
+  | '/api/category/derivatives'
+  | '/api/category/dex'
+  | '/api/category/lending'
+  | '/api/category/staking'
+  | '/api/category/{name}'
+  | '/api/celo'
+  | '/api/cex-vs-dex'
+  | '/api/cex/volumes'
+  | '/api/cex/{exchange}'
+  | '/api/chain/algorand/stats'
+  | '/api/chain/aptos/stats'
+  | '/api/chain/arbitrum'
+  | '/api/chain/arbitrum/stats'
+  | '/api/chain/aurora/stats'
+  | '/api/chain/avalanche'
+  | '/api/chain/avalanche/stats'
+  | '/api/chain/base'
+  | '/api/chain/base/stats'
+  | '/api/chain/blast/stats'
+  | '/api/chain/boba/stats'
+  | '/api/chain/bsc'
+  | '/api/chain/bsc/stats'
+  | '/api/chain/cardano/stats'
+  | '/api/chain/celo/stats'
+  | '/api/chain/cosmos/stats'
+  | '/api/chain/cronos/stats'
+  | '/api/chain/ethereum'
+  | '/api/chain/ethereum/stats'
+  | '/api/chain/fantom'
+  | '/api/chain/fantom/stats'
+  | '/api/chain/fees'
+  | '/api/chain/gas'
+  | '/api/chain/gas/{chain}'
+  | '/api/chain/gnosis/stats'
+  | '/api/chain/harmony/stats'
+  | '/api/chain/injective/stats'
+  | '/api/chain/kava/stats'
+  | '/api/chain/klaytn/stats'
+  | '/api/chain/l2/fees'
+  | '/api/chain/l2/overview'
+  | '/api/chain/linea/stats'
+  | '/api/chain/mantle/stats'
+  | '/api/chain/mode/stats'
+  | '/api/chain/near/stats'
+  | '/api/chain/optimism'
+  | '/api/chain/optimism/stats'
+  | '/api/chain/overview'
+  | '/api/chain/polygon'
+  | '/api/chain/polygon/stats'
+  | '/api/chain/rank/{rank}'
+  | '/api/chain/revenue'
+  | '/api/chain/scroll/stats'
+  | '/api/chain/solana'
+  | '/api/chain/solana/stats'
+  | '/api/chain/sui/stats'
+  | '/api/chain/ton/stats'
+  | '/api/chain/tron/stats'
+  | '/api/chain/zksync/stats'
+  | '/api/chain/{chain}/balance/{address}'
+  | '/api/chain/{chain}/block/latest'
+  | '/api/chain/{chain}/block/{number}'
+  | string; // ... and 1183 more
 
-export default ATVClient;
+export function createClient(options: { baseUrl?: string; apiKey?: string }): ATVClient;
+export default createClient;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atv-eth/x402-sdk",
-  "version": "1.1.0",
-  "description": "Official SDK for the ATV x402 Premium API - ENS, identity, social graphs with SIWE authentication and automatic USDC payments on Base",
+  "version": "1.1.1",
+  "description": "TypeScript SDK for ATV x402 Web3 Identity API - 1383 endpoints",
   "type": "module",
   "main": "index.mjs",
   "types": "index.d.ts",