Developer Scoring

// agents/onchainIntelligence.ts

function categorize(profile: WalletProfile): DeveloperCategory {
  const { totalLaunches, tokensAbove100k, tokensWithClaims, walletAgeDays, totalTxCount } = profile;
  if (totalLaunches === 0) return 'first_timer';

  const successRate = tokensAbove100k  / totalLaunches;
  const claimRate   = tokensWithClaims / totalLaunches;

  if (totalLaunches >= 5 && successRate >= 0.40 && claimRate >= 0.50) return 'serial_builder';
  if (totalLaunches >= 3 && successRate >= 0.30)                       return 'active_builder';
  if (totalLaunches >= 2)                                               return 'experimenter';
  if (claimRate === 0 && totalLaunches >= 3)                           return 'serial_rugger';
  if (walletAgeDays > 90 && totalTxCount < 5)                         return 'dormant';
  return 'first_timer';
}

// providers/frontrunpro.ts

// Preferred: lookup by Twitter handle (captures social reputation, not just on-chain activity)
// Fallback:  lookup by wallet address
const fp = twitterHandle
  ? await frontrunpro.getHandleIntelligence(twitterHandle)
  : await frontrunpro.getWalletIntelligence(walletAddress);

// Tier-weighted KOL quality score — 0 to 100
static kolQualityScore(kols: EnrichedKolAssociation[], smartCount: number): number {
  const tieredScore = kols.reduce((sum, k) => sum + k.influence_score, 0);

  // Categorical bonus for having tier-1 followers
  let bonus = 0;
  if (kols.some(k => k.tier === 'protocol_ceo'))       bonus += 25;
  if (kols.some(k => k.tier === 'vc_partner'))         bonus += 20;
  if (kols.some(k => k.tier === 'agentic_researcher')) bonus += 15;
  if (kols.some(k => k.tier === 'base_ecosystem'))     bonus += 10;

  // Raw smart count base — diminishing returns
  const smartBase = Math.min(30, Math.log10(Math.max(1, smartCount)) * 15);

  return Math.round(Math.min(100, tieredScore * 0.5 + bonus + smartBase));
}

// agents/developerBackground.ts

// Crypto depth from wallet age:
//   5+ years  → og_2017_earlier   (score: 100) — OG participant
//   4+ years  → early_2018_2020   (score: 80)
//   2-4 years → bull_2021         (score: 55)
//   6m–2y     → recent_2022_plus  (score: 30)
//   <6m       → very_new          (score: 15)

// Professional tier detection from display name keywords:
//   faang_research  → ex-Google, ex-Meta, OpenAI, Anthropic, DeepMind, Microsoft
//   notable_company → Coinbase, Ethereum Foundation, Paradigm, a16z, Uniswap Labs
//   academic        → Ph.D, Professor, Researcher, Harvard, MIT, Stanford
//   startup         → Founder, Co-Founder, CTO, Building, Shipping
//   independent     → everything else

// Green thumb flag — crypto newcomer (needs careful evaluation):
//   crypto_depth in (very_new, unknown)
//   AND no academic/professional signals
//   AND composite_background_score < 35

// agents/developerIntel.ts

private activityRecencyScore(dev: Developer): number {
  const now = Date.now();

  // On-chain recency — 40% of this layer
  let chainScore = 0;
  if (dev.last_on_chain_tx) {
    const days = (now - new Date(dev.last_on_chain_tx).getTime()) / 86_400_000;
    chainScore = days <= 7  ? 100
               : days <= 30 ? 70
               : days <= 90 ? 40
               : 10;
  }

  // Twitter recency — 60% of this layer (when available)
  let twitterScore = 0;
  if (dev.last_tweet_at) {
    const days = (now - new Date(dev.last_tweet_at).getTime()) / 86_400_000;
    twitterScore = days <= 7   ? 100
                 : days <= 30  ? 75
                 : days <= 90  ? 45
                 : days <= 180 ? 20
                 : 0;
  }

  if (twitterScore > 0 && chainScore > 0)
    return Math.round(twitterScore * 0.60 + chainScore * 0.40);

  return twitterScore || chainScore;
}

// agents/developerIntel.ts

const WEIGHTS = {
  onchain_history:  0.50,  // on-chain track record (OnchainIntelligence)
  social_quality:   0.25,  // KOL tier-weighting + background pedigree (FrontrunPro API)
  activity_recency: 0.25,  // last on-chain tx + last tweet
};

// Within social_quality (25% of composite):
//   kolScore     × 0.50   — tier-weighted FrontrunPro followers
//   bgScore      × 0.40   — education + crypto depth + professional history
//   followerBonus× 0.10   — raw Twitter follower count (minor bonus at scale)

composite = Math.round(
  onchainHistory  * 0.50 +
  socialQuality   * 0.25 +
  activityRecency * 0.25
)

-- developers table (migrations 0001 + 0003 + 0004)

-- Identity
wallet_address         TEXT UNIQUE   -- primary key identity
twitter_handle         TEXT          -- feeRecipient Twitter (company) or developer handle
display_name           TEXT

-- On-chain (populated by OnchainIntelligence — 2h cron)
total_tokens_launched  INTEGER
tokens_above_100k      INTEGER       -- ever exceeded $100K mcap
tokens_with_fee_claims INTEGER
total_fees_claimed_usd REAL
launch_success_rate    REAL          -- 0-100
claim_engagement_rate  REAL          -- 0-100
developer_category     TEXT          -- serial_builder | active_builder | ...
wallet_age_days        INTEGER
total_tx_count         INTEGER
onchain_score          INTEGER       -- 0-100 composite on-chain score
onchain_analyzed_at    TEXT

-- Social (populated by FrontrunPro API — 2h cron)
smart_follower_count   INTEGER
kol_associations       TEXT          -- JSON: EnrichedKolAssociation[]
vc_associations        TEXT          -- JSON: KolAssociation[]
frontrunpro_rank       INTEGER
frontrunpro_scraped_at TEXT

-- Background (populated by DeveloperBackground — 2h cron)
background_score       INTEGER       -- 0-100 pedigree composite
is_green_thumb         INTEGER       -- 1 = crypto newcomer detected
developer_bio          TEXT          -- bio text if available