Growth & Marketing Agents¶

Six agents that turn wallet behaviour into personalised growth actions — from a single ≤20-word message to a full campaign brief covering cohort segmentation, lead tiers, whale rosters, and per-cohort playbooks.

chainaware-wallet-marketer¶

Model: claude-sonnet-4-6 | Tools: predictive_behaviour, predictive_fraud

Generates one hyper-personalised marketing message (≤20 words) calibrated to a wallet's exact behaviour profile — experience level, risk willingness, primary DeFi categories, and protocol preferences.

A veteran yield farmer gets a different message than a casual NFT buyer. The same wallet addressed on Aave should hear something different than on OpenSea.

Example prompts¶

Write a message for this wallet: 0xVeteran... on Ethereum

Personalise outreach for 0xUser... on BNB Chain — we're launching a yield product

Convert this user — they've been browsing but haven't deposited: 0x...

Marketing message for this address, we want them to try our lending feature: 0x...

Write personalised re-engagement messages for these 10 dormant users: [list]

Example output¶

Wallet: 0xVeteran... (Ethereum)
Profile: Veteran DeFi user | High experience | Yield-focused | Aave, Compound power user

Message: "Your Aave strategies earn 4%. Ours earn 11% — same assets, better routing."

Rationale: Veteran knows current rates. Concrete yield comparison works better
           than generic claims. Invoke familiar protocol for credibility.

Wallet: 0xNFTBuyer... (Ethereum)
Profile: Intermediate | NFT-heavy | Low DeFi exposure | OpenSea regular

Message: "Your NFTs can earn yield while you hold. Zero gas to start."

Rationale: NFT collector unfamiliar with DeFi yield. Lead with existing asset
           (NFTs they already own) + zero-friction entry point.

chainaware-platform-greeter¶

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

Generates a personalised welcome message when a specific wallet connects to a specific platform. The same wallet gets a different message on Aave than on 1inch than on OpenSea — platform context + wallet behaviour = hyper-relevant in-app copy.

Supports 10 platform types: DEX/Swap, Lending/Borrowing, Yield/Staking, Bridge, NFT, Derivatives/Perps, Portfolio/Analytics, Launchpad, Governance/DAO, Unknown/Custom.

Example prompts¶

What should we show 0xUser... when they connect to our lending platform on Ethereum?

Welcome message for 0xPowerUser... on 1inch — they just connected

Personalised greeting for 0xNew... landing on our DEX for the first time

In-app message when this user connects to our yield vault: 0x...

Contextual welcome for 0x... on our NFT marketplace — what do we say?

Batch greeting messages for 50 wallets connecting at our launch event: [list]
Platform: Launchpad | Network: Ethereum

Example output¶

Platform: Aave (Lending) | Wallet: 0xPowerUser... | Network: Ethereum

Message: "Welcome back. Your Aave V3 positions look healthy —
          have you explored our recursive lending strategies?"

Rationale: User has Aave history. Acknowledge existing expertise.
           Surface advanced feature they haven't tried yet.

Alternate (shorter): "Your on-chain history qualifies you for our Pro tier. Claim it."

Platform: DEX | Wallet: 0xFirstTimer... | Network: Ethereum

Message: "First swap? Pick any pair — we'll route you to the best rate automatically."

Rationale: New wallet, no DEX history. Remove friction. Don't overwhelm.
           Single clear action, single clear benefit.

chainaware-upsell-advisor¶

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

Identifies the best upsell opportunity for an existing user. Scores upgrade readiness (0–100), recommends the specific next product, estimates conversion probability, identifies the optimal trigger event, and generates a ready-to-use upsell message.

Example prompts¶

What should I upsell to 0xActiveUser... on Ethereum?
They're currently on our Basic yield tier.

Next product for this user — they've been using our swap feature for 3 months: 0x...

Is this wallet ready to upgrade to Pro? 0x... on BNB Chain
Current product: free tier

Best upsell for this wallet — they just hit $50k TVL in our protocol: 0x...

Rank these 100 users by upsell readiness — we're running an upgrade campaign: [list]

Example output¶

UPSELL RECOMMENDATION
Wallet: 0xActiveUser... | Network: Ethereum | Current: Basic Yield

Upgrade Readiness: 84 / 100
Conversion Probability: 71%

Recommended Next Product: Leveraged Yield Vault (Pro Tier)
Trigger Event: Next time they check their yield dashboard

Message: "You've earned $1,240 in yield. Your profile qualifies for 3× amplified
          returns — upgrade takes 90 seconds."

What NOT to do: Don't pitch governance features — this wallet has never touched
                governance. Don't mention NFTs. Purely yield-focused user.

chainaware-lead-scorer¶

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

Sales lead qualification engine. Scores a wallet 0–100 as a conversion prospect, assigns a lead tier, estimates conversion probability, and recommends a specific outreach angle.

Tiers: 🔥 Hot (75–100) / 🟡 Warm (50–74) / 🔵 Cold (25–49) / ⚫ Dead (0–24 or disqualified)

Example prompts¶

Is this a good lead for our DeFi lending product? 0x... on Ethereum

Score this wallet as a prospect — should our sales team contact them? 0x...

Lead quality for this address: 0xWhale... on BNB Chain

Which wallets in this list are worth pursuing? [100 addresses] on Ethereum
Product: institutional yield vaults

Hot leads in this list — rank the top 20: [addresses]

Conversion potential for 0x... — they visited our site but didn't connect

Example output¶

LEAD SCORE
Wallet: 0xWhale... | Network: Ethereum | Product: Institutional Yield

Score: 91 / 100 🔥 HOT

Conversion Probability: 78%
Lead Tier: Hot — Prioritise for immediate outreach

Profile:
  Experience: Veteran | Active since 2019
  Behaviour: Heavy DeFi yield (Aave, Convex, Yearn)
  Capital: High (significant protocol TVL)

Outreach Angle: Directly pitch APY advantage over Convex.
                They know DeFi — skip the basics.
Channel Fit: Telegram DM > Email
Timing Signal: Active yesterday. Contact within 24 hours.

LEAD SCORE
Wallet: 0xCasual... | Network: Ethereum | Product: Institutional Yield

Score: 12 / 100 ⚫ DEAD

Disqualified: Fraud probability 0.73 — do not contact.

BATCH LEAD RANKING (top 5 of 100)
1. 0xWhale...    Score: 91  🔥 Hot   Conversion: 78%
2. 0xActive...   Score: 84  🔥 Hot   Conversion: 69%
3. 0xMid...      Score: 67  🟡 Warm  Conversion: 44%
4. 0xLow...      Score: 48  🔵 Cold  Conversion: 21%
5. 0xSleeping... Score: 31  🔵 Cold  Conversion: 12%

chainaware-cohort-analyzer¶

Model: claude-sonnet-4-6 | Tools: predictive_behaviour, predictive_fraud

Segments a batch of wallets into behavioural cohorts with per-cohort engagement strategies. The most powerful tool for understanding a user base at scale.

Cohorts: Power DeFi User, NFT Collector, Yield Farmer, Multi-Chain Explorer, Active Trader, Casual User, Dormant/Inactive, New/Fresh, Unclassified, Excluded (fraud/bot)

Example prompts¶

Segment these wallets — who are our power users?
[list of 200 wallet addresses] on Ethereum

Cohort analysis for our DAO members: [addresses] on BNB Chain

What types of users do we have? Behaviour mix of our community: [list]

Segment our airdrop recipients into behavioural groups: [addresses]
Goal: design re-engagement campaigns for each group

Who are the dormant users in this list and what would re-engage them? [list]

Example output¶

COHORT ANALYSIS
Input: 200 wallets | Network: Ethereum | Goal: Engagement campaign

COHORT DISTRIBUTION
  🔥 Power DeFi User      18 wallets (9%)   — Heavy protocol interaction
  🌾 Yield Farmer         31 wallets (16%)  — Staking, vaults, LP positions
  🎨 NFT Collector        24 wallets (12%)  — OpenSea, Blur, high NFT volume
  🌐 Multi-Chain Explorer 15 wallets (8%)   — Bridge activity, 4+ chains
  📈 Active Trader        42 wallets (21%)  — Frequent DEX swaps
  👤 Casual User          29 wallets (15%)  — Low frequency, small amounts
  💤 Dormant/Inactive     22 wallets (11%)  — No activity 90+ days
  🆕 New/Fresh             9 wallets (5%)   — <30 days on-chain
  🚫 Excluded (Fraud/Bot)  7 wallets (4%)   — Removed from targeting

Audience Quality Score: 74 / 100

PER-COHORT ENGAGEMENT PLAYBOOK

Power DeFi Users (18):
  Message: Advanced yield strategies, protocol integrations, governance
  Channel: Telegram, Twitter
  Timing: When new protocol feature launches

Yield Farmers (31):
  Message: APY comparisons, auto-compounding, risk-adjusted returns
  Channel: Telegram, email
  Timing: End of epoch / reward distribution period

Dormant Users (22):
  Message: "Here's what changed while you were away" — concrete wins
  Channel: Email win-back campaign
  Timing: Tuesdays 9am UTC (highest re-engagement rates)

chainaware-marketing-director¶

Model: claude-sonnet-4-6 | Tools: Agent (orchestrator), predictive_fraud

The orchestrator agent. Takes a wallet list, platform description, and campaign goal, then delegates to specialist subagents (cohort-analyzer, lead-scorer, whale-detector, wallet-marketer, onboarding-router) to produce a complete Marketing Campaign Brief.

Use this when you want the full picture in one shot.

Example prompts¶

Plan a campaign for these 500 wallets on our DeFi lending platform.
Goal: increase TVL from existing users.
[list of addresses] on Ethereum

Marketing brief for our protocol launch — here are the wallets from our waitlist:
[addresses] | Network: BNB Chain | Goal: acquisition

How do we engage these users? Build me a full strategy:
[addresses] | Platform: yield aggregator | Goal: retention

Full marketing strategy for this address list — we're doing a token airdrop
and want to maximise conversion to active users post-drop.

Example output¶

MARKETING CAMPAIGN BRIEF
Platform: DeFi Lending Protocol | Goal: TVL Growth | Input: 500 wallets

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
AUDIENCE OVERVIEW
  Total analysed:    500 wallets
  Excluded (fraud):   23 wallets
  Targetable:        477 wallets
  Quality score:     71 / 100

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COHORT BREAKDOWN
  Power DeFi Users:  62 (13%) — Priority 1
  Yield Farmers:     89 (19%) — Priority 2
  Active Traders:   104 (22%) — Priority 3
  [+ 5 more cohorts]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TOP LEADS (Hot tier — immediate outreach)
  1. 0xWhale001... Score: 94  TVL potential: $1.2M
  2. 0xPower002... Score: 88  TVL potential: $340k
  3. 0xVault003... Score: 85  TVL potential: $280k
  [+ 34 more hot leads]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHALE ROSTER (immediate VIP treatment)
  Tier 1 (Mega Whale):  4 wallets — personal outreach required
  Tier 2 (Whale):      11 wallets — dedicated account manager
  Tier 3 (Emerging):   29 wallets — VIP onboarding flow

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PER-COHORT MESSAGE PLAYBOOK
  Power DeFi:  "Recursive lending — 3× your existing yield without new capital"
  Yield Farms: "Auto-compound your Aave positions. Set once, earn forever."
  Traders:     "Your trading activity qualifies you for 0.01% fee tier."
  [+ messages for all cohorts]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPSELL TARGETS (highest upgrade readiness)
  Ready now:     41 wallets (upgrade readiness > 75)
  Ready in 30d:  67 wallets (upgrade readiness 50–74)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ONBOARDING ROUTES
  Skip onboarding:  134 veterans
  Power User flow:   89 intermediates
  Guided flow:      187 beginners/casual
  Watch-and-wait:    44 dormant