Skip to content

kitwongpixel/astar-identity-scoring

Repository files navigation

Astar Identity Scoring System

An open-source React + TypeScript dApp for Astar Bounty #14.

The app analyzes EVM addresses with Astar Blockscout, computes three score profiles, and ranks addresses on a local leaderboard:

  • Trader: contract calls, approvals, gas usage, and unique counterparties
  • Farmer: token transfer volume, token breadth, and active days
  • Diamond hand: estimated holding duration from token transfer history

Why this exists

The bounty prompt asks for:

  • an EVM activity indexer
  • 2+ scoring systems
  • wallet connection
  • a leaderboard

This project uses the public Astar Blockscout API as the data source and turns the results into a polished scoring dashboard.

Features

  • Connect an EVM wallet with MetaMask, Talisman, or another injected provider
  • Paste any EVM address and score it instantly
  • Load public example addresses from Astar activity
  • Save scored addresses into a local leaderboard
  • Show the metrics behind each score so the ranking is explainable
  • Responsive UI with a dark neon style for desktop and mobile

Scoring model

The model uses live Astar activity to compute:

  • Trader score
    • contract interactions
    • approvals
    • unique counterparties
    • gas spent
  • Farmer score
    • token transfer volume
    • unique token contracts
    • active days
  • Diamond hand score
    • average hold time
    • longest hold time
    • currently held contracts

The final Overall score is a weighted blend of the three.

Data source

The app reads public activity from:

  • https://astar.blockscout.com/api

It uses the following endpoints:

  • module=account&action=txlist
  • module=account&action=tokentx

Local development

npm install
npm run dev

Then open the local Vite URL shown in the terminal.

Validation

npm run lint
npm run test
npm run build

Project structure

  • src/App.tsx - dashboard UI and wallet flow
  • src/lib/blockscout.ts - Astar Blockscout API helpers
  • src/lib/scoring.ts - scoring logic
  • src/lib/leaderboard.ts - local leaderboard persistence

Submission notes

If you are reviewing this for the bounty:

  • the app already includes wallet connect and address analysis
  • the leaderboard is saved locally so users can keep ranked identities between sessions
  • the demo is focused on the Astar EVM use case and is ready for manual review

License

This repository is provided for the bounty submission and can be adapted further as needed.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors