Token & Community Agents¶

Q: What is the difference between `chainaware-token-launch-auditor` and `chainaware-token-audit-analyst`?

chainaware-token-launch-auditor combines rug pull risk on the contract, fraud risk on the deployer wallet, and deployer behavioural history - it produces a Launch Safety Score and a binary verdict (APPROVED/CONDITIONAL/REJECTED) for listing decisions. chainaware-token-audit-analyst runs a deep code-level audit across 8 smart contract modules (ownership, liquidity, supply, transfer, pausability, approve, permit, reentrancy) plus honeypot analysis, returning a 0-100 risk score. For a complete picture, run both.

Key Takeaways
- Five agents: token-ranker (holder quality discovery across 2,500+ tokens), token-analyzer (deep single-token with fraud screening on top holders), token-launch-auditor (APPROVED/CONDITIONAL/REJECTED + conditions), airdrop-screener (batch Sybil filter + merit-weighted allocation), token-audit-analyst (smart contract code audit, 8 modules, 0-100 risk score)
- chainaware-token-launch-auditor runs three parallel checks in one call: rug pull risk on contract, fraud on deployer, and deployer behavioural history - outputs a Launch Safety Score and verdict with specific listing conditions
- chainaware-token-audit-analyst audits 8 modules (ownership, liquidity, supply, transfer, pausability, approve, permit, reentrancy) plus honeypot analysis; network values use lowercase (eth, bsc, base)
- chainaware-airdrop-screener returns eligible/flagged/disqualified lists plus merit-based token allocations broken into tiers by reputation score

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)

Frequently Asked Questions¶

What is the difference between chainaware-token-launch-auditor and chainaware-token-audit-analyst?
chainaware-token-launch-auditor combines rug pull risk on the contract, fraud risk on the deployer wallet, and deployer behavioural history - it produces a Launch Safety Score and a binary verdict (APPROVED/CONDITIONAL/REJECTED) for listing decisions. chainaware-token-audit-analyst runs a deep code-level audit across 8 smart contract modules (ownership, liquidity, supply, transfer, pausability, approve, permit, reentrancy) plus honeypot analysis, returning a 0-100 risk score. For a complete picture, run both.

How does chainaware-airdrop-screener allocate tokens across eligibility tiers?
When a token budget is provided, allocations are merit-based: top-tier wallets (reputation score above 2,500) receive the highest individual allocation, mid-tier (1,000-2,499) receive a standard allocation, and base-tier receive the minimum. Flagged wallets are held in reserve pending manual review. The screener disqualifies bots, fraud accounts, wallets with fewer than 10 transactions, and known Sybil clusters before calculating any allocations.

Does the token audit analyst work on all networks?
It supports 7 networks - ETH, BSC, Base, Arbitrum, Avalanche, Optimism, and Polygon - but uses lowercase identifiers (eth, bsc, base, etc.), which is different from predictive_fraud and predictive_rug_pull that use uppercase (ETH, BNB). Pass the wrong case and the call will fail.

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¶

Frequently Asked Questions¶

Further Reading¶