👀 🔍 OnchainBuster

A persona builder to support multichain users starting the next journey on Base shaped by their past onchain activities.

Play with it live on https://onchainbuster.vercel.app/

Made with ❤️️ and ☕ from 🇻🇳

💼 Product Overview

We’ve built a Persona Builder that analyzes user preferences from their past onchain activities, then recommending Base applications that fit them best. We envision a future where everyone becomes a multichain citizen. Our approach promotes the idea that “Base is for everyone” and “Base is a bridge, not an island". We aim to make Base welcoming to all, including users from other blockchains.

Key Features

• User Preference Analysis: Onchain data footprints provide valuable insights into a wallet owner's preferences and behaviors. OnchainBuster will index data from multiple chains to create a full picture of each user’s onchain traits.
• Customized Recommendations: Based on this analysis, we’ll offer tailored recommendations, reducing the information overload users might experience when exploring a new ecosystem.
• Free-to-claim Profile In One Click: To ensure smooth onboarding process on Base, we utilize the CDP-SDK to enable the zero-cost interaction for users to collect their profile as an NFT.

The story on user journey is: Input address -> Submit -> Mint. It's a simple but interactive application to engage with end-users and encourage them to explore Base (by visiting the products recommendations and mint the NFT).

Here's how the data was collected, transformed, and fitted in the analysis stage to calculate the user's onchain traits. One user will have 3 traits in total, and a combination of 2 will suggest the suitable product types on Base to explore.

Please find our detailed product description in the docs folder.

Disclaimer: Within the Base Buildathon SEA scope of work, some features are currently in the Proof of Concept (PoC) status that are currently using mock/hard-coded data. We'll push it when there are more available resources.

🛠️ Local Development

This repo can be clone and run locally for any playground analytical purpose.

🔑 API Keys

To ensure all components work seamlessly, set the following environment variables in your .env file using .env.local.example as a reference. Here's the summary

• Explorers APIs: Daily limit is refreshed everyday - hardly reach the limit
  • Etherscan: https://etherscan.io/apis
  • Basescan: https://basescan.org/apis
  • OP Mainnet Etherscan: https://optimistic.etherscan.io/apis
  • Arbiscan: https://arbiscan.io/apis
• Coinbase CDP: Coinbase Developer Portal's API Access. If you don't have an account, you will need to create one.
  • OnchainKit: the generated key ID for NEXT_PUBLIC_CDP_API_KEY
  • CDP SDK: content in the downloaded JSON file for CDP_API_KEY_NAME and CDP_API_KEY_PRIVATE_KEY
• 3rd-party API services (All is free-plan):
  • Alchemy API: https://docs.alchemy.com/reference/api-overview
  • Reservoir API: https://docs.reservoir.tools/reference/dashboard-sign-up
  • CoinmarketCap: https://coinmarketcap.com/api
  • Talent Passport: This require submitting an application form to Talent Protocol team for Talent API. If you don't have this, the score using for TalentPassport is 0 by default.
  • Pinata: https://docs.pinata.cloud/frameworks/next-js
  • Moralis (unused because of the low limit in free plan): https://docs.moralis.com/web3-data-api/evm/get-your-api-key

# ~~~
NEXT_PUBLIC_GOOGLE_ANALYTICS_ID=

# See https://portal.cdp.coinbase.com/access/api
NEXT_PUBLIC_CDP_API_KEY="GET_FROM_COINBASE_DEVELOPER_PLATFORM"
CDP_API_KEY_NAME=""
CDP_API_KEY_PRIVATE_KEY=""

# Generated wallet from CDP-SDK. You might want to capture the JSON seed
WALLET_DATA={}

# ~~~
NEXT_PUBLIC_ENVIRONMENT=localhost

# See https://cloud.walletconnect.com/
NEXT_PUBLIC_WC_PROJECT_ID="GET_FROM_WALLET_CONNECT"

# ~~~ API Keys
# Blockchain-explorer APIs
NEXT_PUBLIC_ETHERSCAN_API_BASE_URL="https://api.etherscan.io/api"
NEXT_PUBLIC_ETHERSCAN_API_KEY=

NEXT_PUBLIC_BASESCAN_API_BASE_URL="https://api.basescan.org/api"
NEXT_PUBLIC_BASESCAN_API_KEY=

NEXT_PUBLIC_OPTIMISMSCAN_API_BASE_URL="https://api-optimistic.etherscan.io/api"
NEXT_PUBLIC_OPTIMISMSCAN_API_KEY=

NEXT_PUBLIC_BSCSCAN_API_BASE_URL="https://api.bscscan.com/api"
NEXT_PUBLIC_BSCSCAN_API_KEY=

NEXT_PUBLIC_ARBSCAN_API_BASE_URL="https://api.arbiscan.io/api"
NEXT_PUBLIC_ARBSCAN_API_KEY=

# ~~~ Viction ecosystem: Explorer and NFT marketplace
NEXT_PUBLIC_VICSCAN_API_BASE_URL="https://www.vicscan.xyz/api"
NEXT_PUBLIC_DAGORA_API_BASE_URL="https://main-server.dagora.xyz/adapters/dagora"

# ~~~  3rd-party APIs
NEXT_PUBLIC_RESERVOIR_API_BASE_URL="https://api.reservoir.tools"
NEXT_PUBLIC_RESERVOIR_API_KEY=

NEXT_PUBLIC_MORALIS_API_BASE_URL="https://deep-index.moralis.io/api"
NEXT_PUBLIC_MORALIS_API_KEY=

NEXT_PUBLIC_ALCHEMY_API_BASE_URL="https://eth-mainnet.g.alchemy.com"
NEXT_PUBLIC_ALCHEMY_API_KEY=

NEXT_PUBLIC_CMC_API_BASE_URL="https://pro-api.coinmarketcap.com"
NEXT_PUBLIC_CMC_API_KEY=

NEXT_PUBLIC_TALENTPASSPORT_API_BASE_URL="https://api.talentprotocol.com/api"
NEXT_PUBLIC_TALENTPASSPORT_API_KEY=

# Pinata (IPFS for NFT metadata storage)
PINATA_JWT=

💻 Getting Started

# Install bun in case you don't have it
curl -fsSL https://bun.sh/install | bash

# Install packages
bun i

# Run Next app
bun run dev

Keep in mind that the starter template use Biome for linter (instead of Prettier). You might encounter some CI/CD failures due to lint & format check.

📚 Resources

Data source: Special thanks to Talent Protocol for providing the exclusive API source to help us complete the weighting for the scoring process.

Technical Resources:

• UI: OnchainKit documentation
• CDP SDK: CDP SDK Sample Applications
• Pinata: NFT Smart Contract deployment and NextJS Viem Integration

🪪 License

This project is licensed under the MIT License - see the LICENSE file for details.

🏗️ Builder Contacts

• 👷‍♀️ Ngan Nguyen @thiewnngan
• 👷 Minh Pham @pcminh0505
• 👷‍♂️ Tin Chung @chungquantin