DeFi Intelligence Agents¶

Seven agents that help DeFi protocols understand their users — who they are, how experienced they are, what products suit them, and how much risk to extend them.

chainaware-defi-advisor¶

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

Returns personalised DeFi product recommendations calibrated to a wallet's experience level and risk appetite. A beginner gets different suggestions than a veteran yield farmer.

Use this to power in-app product recommendations, onboarding product suggestions, or personalised email campaigns.

Example prompts¶

What DeFi products suit this wallet? 0xUser... on Ethereum

Which yield strategy should I recommend to this address? 0x... on BNB Chain

Best DeFi products for this wallet — they just connected for the first time: 0x...

Personalise DeFi recommendations for 0x... — we have lending, staking, and perps

What should we feature in the dashboard for this wallet? 0x... on Base

Example output¶

DEFI PRODUCT RECOMMENDATIONS
Wallet: 0xUser... | Network: Ethereum

Profile:
  Experience: Intermediate (18 months on-chain)
  Risk Willingness: Moderate
  Primary behaviour: DEX trading, some lending

Recommended Tier: Intermediate Products

Top recommendations:
  1. Lending/Borrowing (Aave-style)
     Rationale: Already trades actively. Next natural step is
                using positions as collateral. High conversion likelihood.

  2. Yield Aggregation (auto-compound)
     Rationale: Moderate risk profile — set-and-forget yield
                appeals more than active management strategies.

  3. Liquidity Provision (stable pairs only)
     Rationale: Not yet ready for volatile LP positions.
                Start with stablecoin pairs to build familiarity.

Avoid for now: Leveraged perps, cross-chain yield, governance participation
               (insufficient experience for these products)

DEFI PRODUCT RECOMMENDATIONS
Wallet: 0xVet... | Network: Ethereum

Profile:
  Experience: Veteran (4+ years, 1,400+ transactions)
  Risk Willingness: High
  Primary behaviour: Yield farming, lending, bridging, governance

Recommended Tier: Power User Products

Top recommendations:
  1. Leveraged yield strategies (Gearbox-style)
  2. Cross-chain yield aggregation
  3. Governance participation + veToken incentives
  4. Real yield via protocol fee sharing

chainaware-lending-risk-assessor¶

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

Assesses borrower risk for DeFi lending protocols. Returns a risk grade (A–F), recommended collateral ratio, and interest rate tier based on the wallet's on-chain history.

Used by protocols like SmartCredit.io to offer differentiated terms — better wallets get lower collateral requirements and better rates.

Example prompts¶

What collateral should I require from 0xBorrower... on Ethereum?
Loan amount: $50,000 in USDC

Lending risk for this address: 0x... on BNB Chain

What LTV should I offer this wallet? 0x... on Base

Assess this borrower before I approve their loan: 0x... on Ethereum
Loan: 10 ETH, 30-day term

Should I lend to this wallet? They're requesting $200k: 0x...

Batch assess these 20 loan applicants and rank by risk grade: [list]

Example output¶

LENDING RISK ASSESSMENT
Borrower: 0xBorrower... | Network: Ethereum
Loan Request: $50,000 USDC

Risk Grade: B+
Interest Rate Tier: Standard (8.5% APR)
Recommended Collateral: 140% LTV

Risk breakdown:
  Fraud risk:   Very Low (0.04) ✅
  Experience:   High (veteran, 3 years) ✅
  AML status:   Clean ✅
  Risk profile: Moderate — consistent behaviour, no extreme positions ✅
  Loan history: 4 prior on-chain loans, all repaid ✅

Recommendation: Approve at 140% collateral, standard rate.
                Eligible for rate reduction after 3 on-time repayments.

LENDING RISK ASSESSMENT
Borrower: 0xRisky... | Network: BNB Chain

Risk Grade: D
Interest Rate Tier: High Risk (24% APR)
Recommended Collateral: 250% LTV — or reject

Risk breakdown:
  Fraud risk:   Elevated (0.48) ⚠️
  Experience:   Low (beginner, 4 months) ⚠️
  AML status:   Minor flag (indirect mixer exposure) ⚠️

Recommendation: If approving, require 250% collateral minimum.
                Consider rejection — risk profile exceeds standard thresholds.

Grade reference¶

Grade	Collateral	Rate Tier	Profile
A	110–120%	Best	Veteran, clean, high experience
B	130–150%	Standard	Intermediate, clean
C	160–180%	Elevated	Some flags or low experience
D	200–250%	High Risk	Significant risk factors
F	—	Reject	Fraud flags or AML hits

chainaware-portfolio-risk-advisor¶

Model: claude-sonnet-4-6 | Tools: predictive_rug_pull, token_rank_single

Portfolio-level rug pull and community health scan. Checks every token in a portfolio, enriches with Token Rank data where available, produces a weighted Portfolio Risk Score, grade (A–F), concentration flags, and a prioritised rebalancing plan.

Example prompts¶

How risky is my portfolio?
Tokens: [0xToken1..., 0xToken2..., 0xToken3...] on Ethereum

Check these tokens for rug pulls before I commit more capital:
[list of contract addresses] on BNB Chain

Which of my positions are most dangerous? [list with position sizes in USD]

Portfolio rug pull scan — I hold these 8 tokens: [addresses]
Networks: Ethereum + Base

Which tokens should I exit? Rank by risk. [list]

Rebalancing recommendations based on rug pull risk for this portfolio:
[list of contracts + USD values]
Risk tolerance: Conservative

Example output¶

PORTFOLIO RISK REPORT
Tokens assessed: 8 | Networks: Ethereum, Base
Positions provided: Yes (weighted scoring)

Portfolio Risk Score: 34 / 100 — Grade: B ✅ Acceptable

PER-TOKEN RISK TABLE
Token              Chain  Rug Risk  Community  Position  Weighted Risk
0xEstablished...   ETH    0.05 ✅    Rank: 142   $45,000   LOW
0xSolid...         ETH    0.11 ✅    Rank: 391   $30,000   LOW
0xNew...           Base   0.67 ⚠️    Rank: N/A   $8,000    HIGH
0xFlagged...       BNB    0.84 🛑    Rank: N/A   $2,500    CRITICAL
[+ 4 more]

⚠️ CONCENTRATION FLAG
  0xNew... + 0xFlagged... = 18% of portfolio but 71% of total risk weight

REBALANCING PLAN (by priority)
  1. EXIT  0xFlagged... (BSC) — Deployer has prior rug history. Exit immediately.
  2. REDUCE 0xNew... (Base) — High risk, no community rank data. Cut to <2%.
  3. HOLD  all remaining positions — Risk acceptable at current weights.

Est. risk score after rebalancing: 14 / 100 — Grade: A

chainaware-whale-detector¶

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

Classifies wallets into whale tiers for VIP treatment, fee discounts, and governance weighting. Also identifies domain (DeFi / NFT / Trading / Yield) and activity status (Active / Dormant).

Example prompts¶

Is this a whale? 0xLargeHolder... on Ethereum

VIP wallet check — should we fast-track this address? 0x... on BNB Chain

Whale tier classification for these 50 wallets: [list] on Ethereum

Find all whales in this address list — we're building a VIP programme: [list]

Classify this wallet — are they worth a dedicated account manager? 0x...

Example output¶

WHALE DETECTION
Wallet: 0xLargeHolder... | Network: Ethereum

Tier: 🐋 WHALE (Tier 2)
Domain: DeFi (primary), Yield (secondary)
Status: Active (last transaction: 2 days ago)

Capital indicators: High (significant DeFi TVL)
Experience: Veteran
Fraud risk: Very Low (0.02)

Recommended treatment:
  ✅ Assign dedicated account manager
  ✅ Offer fee discount tier
  ✅ Invite to governance participation
  ✅ Priority support channel
  ✅ Early access to new products

Whale tiers:
| Tier | Label | Treatment |
|------|-------|-----------|
| 🐳 | Mega Whale | Personal outreach, custom terms, C-suite contact |
| 🐋 | Whale | Account manager, fee discounts, early access |
| 🐬 | Emerging Whale | VIP onboarding, loyalty programme |
| — | Not a Whale | Standard flow |

chainaware-onboarding-router¶

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

Routes wallets to the correct onboarding flow based on on-chain experience. Beginner wallets get guided tutorials; veterans skip straight to the product.

Example prompts¶

Which onboarding flow for 0xUser... on Ethereum?

Is this user a beginner? Should we show them the tutorial? 0x...

Skip onboarding for this wallet? They seem experienced: 0x... on BNB Chain

Route these 200 new users to the right onboarding flow: [list]

First-time user check — they just connected their wallet: 0x...

Example output¶

ONBOARDING ROUTE
Wallet: 0xNew... | Network: Ethereum

Route: 🟢 BEGINNER — Full guided onboarding

Profile: First on-chain activity (14 days). 8 total transactions.

Recommended first steps:
  1. Show "How crypto wallets work" explainer
  2. Start with a small test transaction flow
  3. Introduce one product category at a time (suggest: swap)
  4. Enable email notifications (beginners benefit from guidance)

ONBOARDING ROUTE
Wallet: 0xVet... | Network: Ethereum

Route: ⚡ SKIP — Send directly to dashboard

Profile: Veteran (3.8 years, 940 transactions). Aave, Uniswap, Compound power user.

Rationale: Showing onboarding tutorials to this wallet would create friction.
           They know DeFi. Get them to value immediately.

chainaware-reputation-scorer¶

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

Calculates a numeric reputation score using the ChainAware formula. Useful for ranking wallets, comparing candidates, and setting access thresholds.

Formula: 1000 × (experience + 1) × (willingness_to_take_risk + 1) × (1 - fraud_probability)

Max score: ~4,000. A wallet scoring 3,800+ is in the top tier.

Example prompts¶

Reputation score for 0xUser... on Ethereum

Score this wallet — I need to rank them: 0x... on BNB Chain

Rank these 5 wallets by reputation: [list] on Ethereum

Which wallet is better — 0xA... or 0xB... on Base?

Minimum reputation threshold check: does 0x... score above 2,000?

Example output¶

REPUTATION SCORE
Wallet: 0xUser... | Network: Ethereum

Score: 3,412 / 4,000 — Tier: Elite ⭐

Components:
  Experience:       0.88 (Veteran)
  Risk Willingness: 0.71 (Moderate-High)
  Fraud Probability: 0.03 (Very Low)

Formula: 1000 × 1.88 × 1.71 × 0.97 = 3,121

chainaware-wallet-ranker¶

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

Returns a wallet's global experience rank and leaderboard position within the 14M+ wallet database. Useful for displaying rank to users, gating access, or comparing participants.

Example prompts¶

What is the rank of 0x742d35... on Ethereum?

Global rank for this wallet: 0x... on BNB Chain

How good is this wallet compared to others? 0x... on Ethereum

Wallet leaderboard position for 0x...

Rank these 10 wallets and show their leaderboard positions: [list]

Example output¶

WALLET RANK
Wallet: 0x742d35... | Network: Ethereum

Experience Score: 0.91 / 1.00
Global Rank: #12,847 of 14,000,000+ wallets (top 0.09%)
Experience Tier: Veteran

Wallet age: 4.1 years
Transaction count: 1,284
Protocol breadth: 24 distinct protocols