Growth & Marketing Agents¶

Seven 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-haiku-4-5-20251001 | Tools: predictive_behaviour

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

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-haiku-4-5-20251001 | Tools: predictive_behaviour, predictive_fraud, predictive_behaviour_batch, predictive_fraud_batch, check_job_status, get_job_results

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-haiku-4-5-20251001 | 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

chainaware-ltv-estimator¶

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

Estimates a wallet's 12-month revenue potential (in USD range) based on on-chain behavioural signals - experience level, transaction frequency, capital deployment patterns, and risk willingness. Helps prioritise acquisition spend and set account tier thresholds.

Example prompts¶

What is the LTV of this wallet? 0xUser... on Ethereum

Revenue potential for these 100 wallets - rank by 12-month LTV: [list]

Is this wallet worth our enterprise sales effort? 0xWhale... on BNB Chain

LTV estimate for our top 50 users - we're planning acquisition budget: [list]

Example output¶

LTV ESTIMATE
Wallet: 0xUser... | Network: Ethereum

12-Month Revenue Potential: $8,400 - $14,200

Profile signals:
  Experience:        Veteran (3.1 years)
  Activity level:    High (frequent transactions)
  Risk willingness:  Moderate-High
  Capital signals:   Significant DeFi TVL
  Fraud risk:        Very Low (0.03)

Tier recommendation: Enterprise / VIP
Acquisition spend ceiling: Up to $1,400 CAC justified

LTV ESTIMATE
Wallet: 0xCasual... | Network: Ethereum

12-Month Revenue Potential: $120 - $380

Profile signals:
  Experience:       Beginner (4 months)
  Activity level:   Low (occasional swaps)
  Capital signals:  Small positions

Tier recommendation: Self-serve / Standard

Growth & Marketing Agents¶

chainaware-wallet-marketer¶

Example prompts¶

Example output¶

chainaware-platform-greeter¶

Example prompts¶

Example output¶

chainaware-upsell-advisor¶

Example prompts¶

Example output¶

chainaware-lead-scorer¶

Example prompts¶

Example output¶

chainaware-cohort-analyzer¶

Example prompts¶

Example output¶

chainaware-marketing-director¶

Example prompts¶

Example output¶

chainaware-ltv-estimator¶

Example prompts¶

Example output¶

Further Reading¶