Social media is overrun with bots, fake accounts, and AI-generated content, making real human interaction harder to find. Hawkeye solves this problem by verifying that a tweet comes from an actual person using the Humanity protocol, allowing genuine interaction and social engagement online.
Hawkeye allows users to curate a human-only feed that’s verified with proof on a Chainlink blockchain. By requiring Humanity verification, the platform cuts down on spam, scams, and fake profiles, creating a space where users can trust that they’re engaging with real people. This is especially important in the crypto space, where fake accounts regularly impersonate others to spread misinformation or steal funds. Humanity verification provides an extra layer of scam prevention by allowing vulnerable people to easily detect bot accounts with fake links or other phishing scams.
Another key issue is AI-generated content flooding the internet. Large language models (LLMs) rely on human-created data for training, but if bots keep producing content, these models will start learning from AI instead of real people, degrading their quality. By ensuring only human-generated posts, this project helps maintain the integrity of training data.
At its core, this platform is about bringing social media back to real social interaction. It gives users a way to post with proof of authenticity, making online conversations more personal, meaningful, and secure.

Hawkeye is a Web3 social platform integrating Humanity Protocol verification, blockchain identity, and on-chain transactions to create a trustless and transparent social experience.
Users first register with Humanity Protocol, where they provide biometric data and receive a Verifiable Credential. In the future, palm scanning will enable automatic credential retrieval. To log in, users authenticate via Twitter OAuth, allowing the backend to retrieve their Twitter handle and store it in Supabase. They are then redirected to the frontend with their Twitter handle attached as a URL parameter.
Once logged in, users connect their Web3 wallet using MetaMask, sign a verification message, and store their wallet address and signature locally. To post content, they write a message and paste their Humanity Protocol credential. The smart contract interacts with Chainlink Functions, which verifies the credential against the Humanity Protocol API. If the credential is valid, the transaction is executed on-chain, and the transaction link is appended to the post before being saved in the database and optionally posted to Twitter.
Posts are displayed on the main feed, fetched from Supabase, and include blockchain-verified transaction links. Users can also like posts, and the like count updates instantly in both the database and UI.
Hawkeye enables users to verify their identity through decentralized credentials, ensuring transparency in content posting. By integrating Twitter authentication, Web3 wallet connectivity, and blockchain verification, it creates a decentralized and secure social experience.

Users begin by authenticating with Humanity Protocol, which issues a Verifiable Credential (VC) confirming their identity. They then log in through Twitter OAuth, allowing the backend to retrieve and store their Twitter handle in Supabase. To complete authentication, users connect their Web3 wallet via MetaMask and sign a message to verify ownership.
When submitting a post, users provide their Humanity Protocol credential, which is validated using Chainlink Functions. If the credential is confirmed, the smart contract executes an on-chain transaction, linking blockchain verification to the post. The verified post is then stored in Supabase along with the transaction link, ensuring transparency and verifiability. Users can also like posts, with updates reflected in real time.
Hawkeye consists of three core components: the frontend, backend, and smart contract. The frontend, built with React and ethers.js, handles authentication, wallet connection, and UI interactions, displaying posts with verified blockchain links. The backend, developed using Flask, Tweepy, and Supabase, manages Twitter authentication, user data storage, and interactions between the frontend and smart contract. The smart contract, written in Solidity and integrated with Chainlink Functions, validates Humanity Protocol credentials, executes transactions, and links them to posts.
The development process started with implementing Twitter OAuth and wallet connection for authentication. This was followed by integrating Humanity Protocol verification using Chainlink Functions and deploying the smart contract for on-chain validation. Finally, the system was refined to ensure all posts include blockchain verification links, and the frontend was optimized for real-time updates. Hawkeye creates a trustless social media platform by combining Web3 authentication, credential validation, and blockchain transparency.

Chainlink Protocol
Humanity Protocol API
X API

This project prioritizes human identity verification for social media, ensuring transparency and ease of use. Unlike traditional blockchain platforms with complex verification processes, it allows anyone to verify a user’s authenticity in seconds. Instead of issuing a generic “verified” badge, it provides verifiable proof on the blockchain, enhancing trust and accountability.
A key distinction is its direct integration with an established social media. Creating a new social media platform is incredibly difficult because of how hard it is to gain users. This is especially true for decentralized or web3 social networks. By integrating with one of the largest social network platforms, Hawkeye instantly becomes useful. Not just to users registered with the Humanity protocol, but to anyone that views a verified post.
This project directly combats bots, fake accounts, and AI-generated content, making social media safer and more authentic. By requiring human verification, it reduces spam, scams, and misinformation, particularly in the crypto space, where fraudulent accounts are widespread.
Designed for long-term security, the system currently uses wallet-based authentication but will soon introduce biometric verification, such as palm-based authentication. This ensures that even if a wallet is compromised, unauthorized users cannot assume another person’s verified identity. By evolving with emerging security needs, this platform provides a scalable solution for digital identity verification.

Several trade-offs and shortcuts were made to prioritize core functionality.
For starters, the Humanity Protocol credential validation integration is abstracted. In the current implementation of Hawkeye, we assume there exists a separate method of sharing credentials such as a physical palm scanner.
The website runs on a local host as opposed to being a fully deployed application. This was done for speed and convenience of displaying the project and its fundamentals.
Authentication relies on URL parameters for user identification, which is insecure and lacks proper hashing. A robust authentication system with session management is needed for security.
Commenting and threads are missing on the Hawkeye main page, restricting user interaction to simply liking tweets.