Agentic User Onboarding & Personalisation¶

The 90% Problem¶

The average DeFi protocol converts fewer than 10% of connecting wallets into active users. Nine out of ten wallets connect, look around, and leave without transacting.

The cause is not the product — it's the experience. Every user gets the same onboarding tutorial regardless of their history. A veteran who has used Aave since 2020 is shown the same "what is a wallet?" explainer as someone who created their first address last week. The veteran leaves immediately. The beginner is overwhelmed and leaves shortly after.

Traditional personalisation solutions don't work in Web3 because they rely on cookies, email addresses, or CRM data — none of which exist in a pseudonymous, wallet-native context.

The wallet is the identity. On-chain behaviour is the profile. AI agents are the personalisation layer.

What Agentic Onboarding Looks Like¶

When a wallet connects to a ChainAware-powered protocol, an AI agent reads its on-chain history in under 100ms and makes a set of instant decisions:

1. Route to the right onboarding flow
A veteran with 4 years of DeFi history skips tutorials entirely and lands directly on the product dashboard. A beginner with 12 transactions sees a guided setup. An intermediate user with DEX experience but no lending history is introduced to lending specifically.

2. Personalise the welcome experience
The first thing a user sees is written for them — not generic copy. A yield farmer sees a message about yield optimisation. An NFT collector hears about putting their assets to work. A trader sees fee tier information.

3. Recommend the right product
The agent identifies which product in your catalogue best fits the wallet's experience level, risk appetite, and behavioural history — and surfaces it first.

4. Identify high-value users immediately
Whales, power users, and high-reputation wallets are flagged the moment they connect, triggering VIP treatment, dedicated account management, or access to premium tiers without requiring them to ask.

All of this happens before the user has clicked a single button — driven entirely by on-chain data, with no signup, no form, no survey.

The Personalisation Stack¶

`chainaware-onboarding-router`¶

Classifies every connecting wallet into an onboarding route based on on-chain experience:

Route	Profile	Experience
⚡ Skip	Veteran power user	2+ years, 500+ txs, multi-protocol
🟢 Power User flow	Experienced	6–24 months, familiar with core DeFi
🔵 Guided flow	Beginner/Intermediate	<6 months or narrow activity
👁 Watch-and-wait	Dormant	Extended inactivity, re-engagement needed

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

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

`chainaware-platform-greeter`¶

Generates a personalised welcome message (max 2 sentences, 35 words) calibrated to the wallet's behaviour and the specific platform they've connected to. The same wallet gets a different message on a lending protocol than on a DEX — context matters.

Welcome message for 0xUser... connecting to our yield vault on Ethereum

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

Example — veteran connecting to a lending protocol:

"Your Aave V3 positions are running well — have you tried recursive lending to amplify your existing yield?"

Example — NFT collector connecting to the same protocol:

"Your NFTs can earn yield while you hold them. No gas to get started."

Example — first-time user connecting to a DEX:

"First swap? Pick any pair — we'll find the best rate automatically."

`chainaware-defi-advisor`¶

Returns personalised DeFi product recommendations matched to the wallet's experience and risk appetite. Used to populate "recommended for you" sections, email campaigns, or in-app tooltips.

What DeFi products suit this wallet? 0x... on BNB Chain

Which product should we feature first for this user on our dashboard? 0x...

Example — moderate-risk intermediate wallet:

Recommended:
  1. Lending/Borrowing — next natural step after trading
  2. Stable LP — set-and-forget yield, appropriate risk level
  3. Auto-compounding vault — suits their passive style

Avoid for now: Leveraged perps, cross-chain strategies

`chainaware-wallet-marketer`¶

Generates a single hyper-personalised outreach or in-app message (≤20 words) for any wallet. Calibrated to the specific behaviour profile — not a segment, not a persona, a specific wallet.

Write a re-engagement message for this dormant user: 0x... on Ethereum

Personalise a deposit nudge for 0x... — they browsed our yield section but didn't commit

Example outputs:
- To a veteran yield farmer: "Your Aave strategies earn 4%. Ours earn 11% — same assets, better routing."
- To a casual holder: "Your ETH has been idle 90 days. It could be earning 8% APY with one click."
- To an NFT-heavy wallet: "Your NFTs can earn yield while you hold. Zero gas to start."

Conversion Impact¶

The core problem with DeFi user acquisition is not traffic — it's activation. Protocols spend heavily on KOL campaigns and airdrop programmes to attract wallets, then convert fewer than 1 in 10 to active users.

Agentic personalisation changes this by eliminating the three biggest activation blockers:

Friction for veterans — Showing experienced users a beginner tutorial is the fastest way to lose them. Routing removes this instantly.

Overwhelm for beginners — Presenting the full product catalogue to a new user triggers paralysis. A single personalised recommendation outperforms a feature wall.

Generic messaging — Generic "connect your wallet to start earning" copy is ignored. A message referencing the user's actual behaviour and existing positions converts.

SmartCredit.io implemented ChainAware's wallet-based personalisation and achieved 8× improvement in user engagement — documented in the case study.

Full Campaign Orchestration¶

For protocols running product launches, token airdrops, or re-engagement campaigns across a large user base, the chainaware-marketing-director orchestrates the full personalisation workflow across all wallets simultaneously:

Plan a re-engagement campaign for our 2,000 dormant users.
Goal: bring them back to our yield product.
[list of addresses] on Ethereum

Output includes: cohort segmentation, top leads by conversion potential, whale roster for VIP treatment, per-cohort message playbook, and recommended onboarding routes — a complete campaign brief generated from on-chain data alone.

Integration¶

Via Prediction MCP — For AI-Native Protocols¶

Add ChainAware's MCP server to your agent pipeline. Your onboarding agent autonomously calls the right tools at wallet connect — no fixed rules, no if/else logic for every edge case.

claude mcp add --transport sse chainaware-behavioral-prediction \
  https://prediction.mcp.chainaware.ai/sse --header "X-API-Key: YOUR_KEY"

Via Google Tag Manager — For dApp Front-Ends¶

No backend required. The ChainAware GTM pixel fires on wallet connection, returns a behavioural segment to the dataLayer, and your front-end renders the appropriate experience — tutorial vs. dashboard, generic copy vs. personalised greeting.

Deployment in under an hour, no engineering resources needed.

Via REST API — For Custom Stacks¶

Programmatic access to wallet profiles and onboarding routes for any tech stack:

GET /v1/behaviour/{wallet_address}?chain=ethereum

Returns experience score, risk profile, onboarding route recommendation, and product affinity signals.