Token & Community Agents¶

Five agents covering the full token lifecycle - from discovering quality tokens and vetting a new launch, to screening airdrop recipients, analysing who actually holds a given token, and auditing smart contract safety.

chainaware-token-ranker¶

Model: claude-haiku-4-5-20251001 | Tools: token_rank_list

Discovers and ranks tokens by the strength of their holder community. Uses the median Wallet Rank of all qualifying holders - not price, volume, or social metrics. Covers 2,500+ tokens across Ethereum, BNB Smart Chain, Base, and Solana.

Example prompts¶

Top AI tokens on Ethereum by community quality

Best DeFi tokens on BNB Chain - rank by holder strength

Which RWA tokens have the strongest holder base on Base?

Token leaderboard for Solana - DeFi category

Rank all DeFAI tokens across chains and show me the top 10

Compare community quality across these 3 tokens: [address1], [address2], [address3] on ETH

Example output¶

TOKEN RANKING - AI Tokens | Ethereum
Sorted by: Community Rank (lower = better quality holders)

Rank  Token        Address      Community Rank  Holders  Norm. Rank
1     $AITOKEN     0xAbc...     142             4,821    0.91
2     $MLCOIN      0xDef...     391             2,104    0.84
3     $NEURAL      0xGhi...     847             8,932    0.76
4     $DEEPLEARN   0xJkl...     1,204           1,247    0.68
5     $AGENTCOIN   0xMno...     2,891           19,203   0.51
...

Interpretation:
  #1 $AITOKEN: Top 1% holder quality - sophisticated, experienced wallets.
               Strong signal of organic adoption by genuine DeFi participants.

  #5 $AGENTCOIN: Mid-tier holder quality despite large holder count.
                 Large holder base may include airdrop farmers or bots.

Supported categories:
- AI Token, RWA Token, DeFi Token, DeFAI Token, DePIN Token
- Networks: Ethereum, BNB Smart Chain, Base, Solana

chainaware-token-analyzer¶

Model: claude-haiku-4-5-20251001 | Tools: token_rank_single, predictive_fraud

Deep-dive into a single token: community rank, top holders ranked by global wallet rank, and fraud screening on the top holder set. Tells you not just who holds the token - but whether those holders are legitimate.

Example prompts¶

Who holds this token? 0xTokenContract... on Ethereum

Token rank for 0xContract... on BNB Chain

Best holders of 0xToken... - show me their wallet ranks

Is this token held by whales or bots? 0xContract... on Base

Holder analysis for this token - are the top holders legitimate? 0x...

Screen the top 20 holders of 0xToken... for fraud

Example output¶

TOKEN ANALYSIS
Contract: 0xTokenContract... | Network: Ethereum

Community Rank: 284 (Top 15% of tracked tokens)

TOP HOLDERS
Rank  Holder          Global Rank     Fraud Risk   Position
1     0xHolder1...    #4,291 ✅        0.02 ✅       12.4% supply
2     0xHolder2...    #18,402 ✅       0.04 ✅       8.1% supply
3     0xHolder3...    #2,899 ✅        0.03 ✅       6.7% supply
4     0xHolder4...    #841,234 ⚠️      0.61 ⚠️      4.2% supply
5     0xHolder5...    #1,240,981 ⚠️    0.08 ✅       3.8% supply
[+ 15 more]

⚠️ FRAUD FLAG: Holder #4 (0xHolder4...) has elevated fraud risk (0.61).
   Holds 4.2% of supply. Monitor for potential sell pressure / exit.

SUMMARY
  Top holders with clean history: 17/20 (85%)
  High-risk holders: 2/20 (10%)
  Unknown/insufficient data: 1/20 (5%)

Conclusion: Predominantly held by legitimate wallets. One elevated-risk
            holder worth monitoring. Overall holder quality is strong.

chainaware-token-launch-auditor¶

Model: claude-haiku-4-5-20251001 | Tools: predictive_rug_pull, predictive_fraud, predictive_behaviour

Pre-listing launch safety audit combining contract rug pull risk and deployer wallet screening. Returns a Launch Safety Score, a verdict (APPROVED / CONDITIONAL / REJECTED), and specific conditions if applicable.

Designed for DEXes, CEXes, and launchpads that need an objective first-pass check before committing resources to a listing.

Example prompts¶

Should we list this token? Contract: 0xToken... Deployer: 0xDev... on Ethereum

Audit this launch before we promote it: 0xToken... on BNB Chain

Is this deployer trustworthy? 0xDeployer... - they want a listing on our DEX

Vet this IDO before we feature it: token=0x... deployer=0x... on Base

Launch safety check - new token launching in 2 hours: 0xContract... deployer=0x...

Pre-listing safety check for 3 new token submissions: [token+deployer pairs]

Example output¶

TOKEN LAUNCH AUDIT
Token: 0xToken... | Deployer: 0xDev... | Network: Ethereum

Launch Safety Score: 84 / 100
Verdict: ✅ APPROVED

Rug Pull Risk:  0.09 - Low
Deployer Profile:
  Fraud probability:  0.04 ✅
  Experience:         High (Veteran, 2.8 years) ✅
  Prior launches:     3 (all survived >6 months) ✅
  AML flags:          None ✅

Safety Badge: 🟢 Verified Launch

Listing conditions: None. Standard listing recommended.

TOKEN LAUNCH AUDIT
Token: 0xNewToken... | Deployer: 0xFresh... | Network: BNB Chain

Launch Safety Score: 31 / 100
Verdict: 🔴 REJECTED

Rug Pull Risk:  0.81 - Critical
Deployer Profile:
  Fraud probability:  0.77 ⚠️
  Wallet age:         12 days ⚠️
  Prior launches:     1 (confirmed rug pull 3 months ago) 🛑
  AML flags:          Mixer interaction ⚠️

Recommendation: Reject listing application. Deployer has prior rug history
                and shows all behavioural signatures of a repeat offender.

TOKEN LAUNCH AUDIT
Token: 0xMid... | Deployer: 0xMod... | Network: Base

Launch Safety Score: 62 / 100
Verdict: 🟡 CONDITIONAL

Rug Pull Risk:  0.34 - Moderate
Deployer Profile:
  Fraud probability:  0.18 - Elevated ⚠️
  Experience:         Moderate (intermediate, 11 months)
  Prior launches:     0 (first project)

Listing conditions:
  1. Require minimum 6-month LP lock before listing
  2. Request deployer KYC before promoting
  3. Monitor deployer wallet for 30 days post-launch
  4. Reduce initial liquidity exposure

chainaware-airdrop-screener¶

Model: claude-haiku-4-5-20251001 | Tools: predictive_behaviour, predictive_fraud, predictive_behaviour_batch, predictive_fraud_batch, check_job_status, get_job_results

Batch screens wallets for airdrop eligibility. Filters bots, fraud accounts, and fresh Sybil wallets. Ranks eligible wallets by reputation score to enable merit-based allocations. Returns eligible, flagged, and disqualified lists, plus suggested token allocations if a budget is provided.

Example prompts¶

Screen these wallets for our airdrop - filter out bots and fraud:
[list of 500 addresses] on Ethereum

Fair airdrop allocation for these wallets - $200k token budget:
[list] on BNB Chain

Sybil filter for our airdrop: [addresses] on Ethereum
Minimum fraud threshold: 0.3

Remove fake wallets from this list before we distribute rewards: [addresses]

Score and rank these 1,000 airdrop applicants by reputation:
[list] | Network: Ethereum | Token budget: $500,000

Example output¶

AIRDROP SCREENING REPORT
Input: 500 wallets | Network: Ethereum | Budget: $200,000

RESULTS SUMMARY
  ✅ Eligible:        347 wallets (69.4%)
  ⚠️ Flagged:          48 wallets (9.6%)   - manual review recommended
  🚫 Disqualified:    105 wallets (21.0%)  - bots, fraud, or Sybil

DISQUALIFIED BREAKDOWN
  High fraud risk (>0.5):    41 wallets
  New/fresh wallets (<10 tx): 38 wallets
  Known bot patterns:         18 wallets
  AML flags:                   8 wallets

COHORT BREAKDOWN (eligible wallets)
  Veteran / Power Users:    62 (18%)
  Intermediate:            143 (41%)
  Beginner (legitimate):    89 (26%)
  Casual / Low activity:    53 (15%)

TOKEN ALLOCATION (merit-based)
  Top tier (reputation >2,500):  62 wallets × $1,200 = $74,400
  Mid tier (rep 1,000-2,499):   143 wallets × $450  = $64,350
  Base tier (rep <1,000):       142 wallets × $150  = $21,300
  Reserve for flagged review:              $39,950
  Total allocated: $200,000 ✅

TOP 5 ELIGIBLE WALLETS (highest reputation)
  1. 0xVet001... Score: 3,812 - Allocation: $1,200
  2. 0xVet002... Score: 3,641 - Allocation: $1,200
  3. 0xPow003... Score: 3,204 - Allocation: $1,200
  [+ 59 more top-tier recipients]

chainaware-token-audit-analyst¶

Model: claude-haiku-4-5-20251001 | Tools: run_token_audit, get_token_audit_result

Deep multi-module smart contract auditor. Runs run_token_audit (get-or-create) and polls get_token_audit_result when the audit is queued. Returns a 0-100 risk score, a verdict, and a breakdown across 8 modules: ownership, liquidity, supply, transfer, pausability, approve, permit, and reentrancy.

Complements chainaware-token-launch-auditor (which uses rug pull + deployer behavioral signals) by providing a code-level analysis of the contract itself.

Network note: Token audit tools use lowercase network values (eth, bsc, base, etc.), unlike other ChainAware tools which use uppercase.

Example prompts¶

Audit this token contract: 0xContract... on Ethereum

Is this BSC token safe? 0xContract...

Run a full risk scan on this contract before I buy: 0x... on Base

Does this contract have hidden mint functions? 0x... on Arbitrum

Is there a kill switch in this token? 0x... on Polygon

Check liquidity lock and ownership for this contract: 0x... on eth

Full audit before we list this token - contract: 0x... deployer: 0x... on bsc

Example output¶

TOKEN AUDIT
Contract: 0xContract... | Network: Ethereum

Risk Score: 18 / 100
Verdict: CLEAN ✅

Module Results:
  Ownership:    PASS - Owner renounced, no privileged functions active
  Liquidity:    PASS - Liquidity locked for 12 months, sufficient TVL
  Supply:       PASS - No mint function, no deployer concentration
  Transfer:     PASS - All transfer invariants satisfied
  Pausability:  N/A  - No pause function in contract
  Approve:      PASS - Standard ERC-20 approve implementation
  Permit:       N/A  - EIP-2612 permit not implemented
  Reentrancy:   PASS - CEI pattern followed, no reentrancy paths detected

Honeypot Analysis: No Honeypot (score: 2/100)

Recommendation: ✅ Contract appears safe. No theft or rug mechanics detected.
                LP lock active - verify lock duration before investing.

TOKEN AUDIT
Contract: 0xRiskyToken... | Network: BNB Chain

Risk Score: 79 / 100
Verdict: HIGH RISK 🔴

Module Results:
  Ownership:    FAIL - Owner is EOA with full blast radius (can mint, pause, blacklist)
  Liquidity:    WARN - Pool unlocked, low TVL ($12,400)
  Supply:       FAIL - Unbounded mint function, no cap
  Transfer:     PASS
  Pausability:  FAIL - Any transfer can be paused by owner instantly (monitoring flag set)
  Approve:      PASS
  Permit:       N/A
  Reentrancy:   PASS

Primary Signal: Unbounded mint + EOA owner with full control

Honeypot Analysis: Likely Honeypot (score: 61/100)
  Flags: CONTROLLED_LAUNCH_MODE, EXTERNAL_CALL_IN_TRANSFER

Recommendation: 🔴 HIGH RISK. Owner can mint unlimited supply and freeze transfers.
                Likely honeypot pattern detected. Do not buy.

Module status reference¶

Status	Meaning
`PASS`	Module ran and found no issues
`WARN`	Risky pattern present but not definitively exploitable
`FAIL`	Dangerous finding - see module detail
`N/A`	Feature not present in this contract (not a red flag)

Token & Community Agents¶

chainaware-token-ranker¶

Example prompts¶

Example output¶

chainaware-token-analyzer¶

Example prompts¶

Example output¶

chainaware-token-launch-auditor¶

Example prompts¶

Example output¶

chainaware-airdrop-screener¶

Example prompts¶

Example output¶

chainaware-token-audit-analyst¶

Example prompts¶

Example output¶

Module status reference¶

Further Reading¶