Magic Wallet

This project is a walletless, fiat-compatible cryptocurrency remittance solution that leverages cutting-edge technologies such as Apple Face ID and Privy Server Wallet. It’s designed to make entering and using the cryptocurrency world as simple and accessible as using a chatbot like ChatGPT. The platform ensures a secure, seamless experience for both crypto novices and experts alike, with multiple layers of security and ease of use.

Here's a detailed breakdown of how the project works and what makes it innovative:

---

1. Walletless Experience Using Apple Face ID and Privy Server Wallet

This project revolutionizes how users access and manage their cryptocurrency. Instead of requiring users to go through traditional wallet setup processes, it eliminates the need for them to manage keys, seed phrases, or complex wallet apps.

• Apple Face ID Integration: Users can set up their wallet by simply scanning their face using Apple Face ID. This provides a seamless and secure authentication process. Once the scan is completed, the wallet is automatically created for the user without the need for any further input.
• Privy Server Wallet: The wallet itself is stored and managed securely on the backend via the Privy Server Wallet. Unlike traditional wallets, this server-backed approach does not expose any sensitive data like the seed phrase to the user, reducing the risk of losing it or having it stolen. The wallet’s security is entirely managed by the server.

This walletless design allows the user to easily start using cryptocurrency without worrying about the complexities of wallet management, making it incredibly user-friendly.

2. Effortless User Journey: Starting Your Crypto Experience

The project is built with the idea that users should experience cryptocurrency in the simplest, most familiar way possible. The platform mimics everyday apps like ChatGPT, making the process feel intuitive, even for users who are entirely new to the world of crypto.

• No Technical Jargon: The system operates in a way that makes the complex aspects of cryptocurrency, like swaps, private keys, or transaction fees, invisible to the user. The user interacts with a simple, friendly interface that asks only essential questions like "Do you want to send $X?".
• Getting Started with Ease: Just like chatting with a virtual assistant, users are guided through the process of setting up their wallet, buying their first crypto, and sending payments in a manner that doesn’t overwhelm them with technicalities.

3. Fraud Detection Using On-Chain Data

Security is at the forefront of this project. As users send funds, the system automatically analyzes the on-chain data of the recipient to determine if they have a history of malicious activity.

• On-Chain Behavior Analysis: The system fetches the recipient's on-chain data (i.e., past transaction history) to detect suspicious or malicious behavior. If the recipient has been involved in fraudulent activity or is flagged as a risk, the user is notified.
• AI Fraud Prevention: The AI behind the system evaluates the recipient's address based on historical data, ensuring that the user's funds are being sent to a legitimate recipient. If any issues are detected, a warning or caution message is displayed to the sender, allowing them to confirm the transaction before proceeding.

For example, Frame 45 (seen in the images) shows a potential warning for "potential risk detected" when sending funds. This is a safety feature ensuring users are not inadvertently sending funds to malicious actors.

4. Invisible Crypto Experience

The ultimate goal of the project is to make users feel like they’re just using an everyday app rather than engaging with the complexities of cryptocurrency.

• No Knowledge of Crypto Needed: The system hides all of the crypto-specific mechanics behind the scenes. Users don't need to know how blockchain works, what a gas fee is, or how to interact with decentralized protocols. Instead, the system takes care of these details, just like how a messaging app hides the complexity of SMS or email protocols.
• Seamless Interface: The flow of the app is designed to be as smooth as possible, with users simply interacting with a chatbot-like interface that asks simple questions and provides clear instructions. For instance, the app will automatically suggest an amount to send, verify the recipient's address, and send the payment without requiring the user to manually swap assets or choose which network to use.

5. Seamless On-Ramping with Coinbase Onramp

The project includes built-in support for Coinbase Onramp, which allows users to easily convert their fiat currency (such as USD or EUR) into cryptocurrency.

• Simple Fiat-to-Crypto Conversion: Through Coinbase Onramp, users can buy crypto using their traditional bank account or card in just a few steps, making it easier for those who are new to the crypto world to get started.
• Onboarding Made Easy: From the first screen to adding funds (as seen in Frame 7), users can quickly add funds to their wallet via a QR code scan or by copying their wallet address. This makes it incredibly easy for new users to enter the world of crypto without going through the complicated steps of traditional crypto exchanges.

6. Alerts and Risk Detection (Frames 44-50)

The system is equipped with robust security features to ensure safe transactions:

• Caution and Warning Alerts: The app provides real-time feedback on the status of a transaction. If a user tries to send funds to an unverified address or a suspicious recipient, the system issues warnings, like “CAUTION! This address has no records” or “WARNING! Potential risk detected”. These warnings allow the user to stop and double-check the transaction before proceeding, ensuring added security and preventing potential losses.
• Risk Report: If an address is flagged as suspicious, users are encouraged to report it, further enhancing the security of the platform by crowdsourcing safety information.

Conclusion:

This project is set to radically change the way people interact with cryptocurrency by making it accessible, secure, and easy for everyone. The combination of walletless authentication, on-chain fraud detection, seamless fiat on-ramping, and invisible crypto management makes this platform a highly user-centric solution.

• No crypto experience needed: Anyone can start their crypto journey with a simple face scan, like signing into any modern app.
• AI-powered fraud protection: On-chain data analysis ensures users are protected from fraudulent transactions.
• User-friendly interface: The system operates behind the scenes, allowing users to engage with crypto effortlessly.
• Seamless onboarding: Coinbase Onramp integration makes converting fiat to crypto incredibly easy, enabling even the least tech-savvy users to begin using crypto without hassle.

This is truly a revolutionary approach to cryptocurrency remittance, designed for mass adoption by simplifying every step of the process while maintaining the security and integrity that blockchain technology offers.

1. Core Technology Stack

This project is built using a combination of modern frontend and backend technologies, biometric authentication, and on-chain data analysis tools to provide a seamless and secure crypto remittance experience.

Frontend (User Interface & Experience)

• React 18 with TypeScript: The entire frontend is built using React 18, ensuring a fast, component-driven architecture. TypeScript provides type safety, reducing runtime errors.
• Vite for Development: We chose Vite as our build tool for its ultra-fast performance in development mode, allowing for hot-reloading and a superior developer experience.
• TailwindCSS: We used TailwindCSS for styling, ensuring a clean and responsive UI that adapts seamlessly to different devices.
• React Router: Handles navigation, making the app single-page and smooth in transitions.

Backend (Authentication & Business Logic)

• Express.js with TypeScript: The backend is powered by Express.js, a lightweight and fast framework that enables easy API handling.
• MongoDB with Mongoose: We store user data, session information, and transaction logs in MongoDB, a NoSQL database optimized for handling large-scale applications.
• JWT Authentication: We implement JSON Web Tokens (JWTs) to manage user sessions securely.
• Privy Server SDK: This handles wallet operations, allowing us to offer a walletless experience where the user's private keys and wallet management are done securely on the backend.

Biometric Authentication

• Apple Face ID & WebAuthn API:
  • Users authenticate using Face ID (on iOS) or Touch ID (on Mac and some laptops).
  • WebAuthn API ensures that authentication is secure and tied to the user's device.
  • No passwords are needed, eliminating phishing risks and improving UX.

Blockchain & Smart Contract Interactions

• Coinbase Onramp: We integrated Coinbase Onramp to allow users to convert fiat to crypto with ease.
• The Graph Protocol:
  • The platform fetches on-chain transaction data using subgraph queries.
  • It evaluates recipient wallet risk by checking activity history, transaction volume, and frequency.
• BaseChain for Transactions: Transactions are processed on BaseChain, ensuring fast and low-cost crypto payments.
• Coinbase AgentKit:
  • This module helps detect and analyze potentially malicious wallets.
  • Identifies if the recipient has been flagged in previous transactions.

---

2. How The System Works (Behind the Scenes)

The system functions in a highly automated manner, ensuring that all operations (from authentication to transaction validation) are smooth and user-friendly.

Step 1: User Authentication & Wallet Creation

1. The user signs in using Apple Face ID.
2. The system verifies the biometric data using the WebAuthn API.
3. Once authenticated, the system generates a Privy Wallet for the user in the background.
4. The wallet remains invisible to the user, with no need for private key management.

Step 2: Adding Funds (Fiat Onramp)

1. The user selects an option to add funds.
2. The system connects to Coinbase Onramp, allowing fiat to be converted into crypto.
3. The user can pay via credit/debit card or bank transfer.

Step 3: Sending Crypto (Transaction Flow)

1. The user enters the recipient's address or selects a contact.
2. The system automatically fetches on-chain data of the recipient.
3. The AI-powered risk detection tool analyzes past transactions to identify potential fraud.
4. The user is given a security rating:
   • 🟢 Safe → The address has a good history.
   • 🟡 Caution → The address has limited activity.
   • 🔴 Warning → The address has been involved in flagged transactions.
5. The user confirms the transaction.
6. The system calculates gas fees automatically (hiding complex blockchain mechanics).
7. The transaction is processed on BaseChain.

---

3. Challenges & Hacky Workarounds

Challenge 1: Making Crypto "Invisible"

• Problem: Many users are unfamiliar with gas fees, blockchain transactions, and private keys.
• Solution: We abstracted all complexities by:
  • Automatically estimating optimal gas fees.
  • Managing private keys in the Privy Server Wallet.
  • Implementing a chatbot-like UX, where users simply "send money" rather than "sign a transaction".

Challenge 2: Fraud Detection on-Chain

• Problem: Identifying scam addresses in real-time.
• Solution: We use Coinbase AgentKit + The Graph API to fetch on-chain data dynamically.
  • Transactions are scored based on risk levels.
  • A warning system is built into the UI.

Challenge 3: Fast Transactions with Low Fees

• Problem: High fees and slow transactions.
• Solution: Transactions are routed through BaseChain, ensuring:
  • Lower transaction fees than Ethereum Mainnet.
  • Faster transaction confirmations.

---

4. Partner Technologies & Benefits

We leveraged several cutting-edge third-party tools to optimize security, speed, and user experience:

| Technology | Purpose | Benefit to the Project | | --- | --- | --- | | Privy SDK | Wallet Management | Provides secure wallet handling with zero user friction | | Coinbase Onramp | Fiat-to-Crypto | Enables users to buy crypto instantly with fiat | | WebAuthn API | Biometric Authentication | Provides passwordless login, ensuring phishing-resistant security | | The Graph | On-Chain Data Fetching | Allows real-time risk analysis of recipient wallets | | BaseChain | Blockchain Transactions | Ensures low fees and fast confirmations | | Coinbase AgentKit | Security & Risk Analysis | Detects fraudulent wallets before transactions occur |

---

Final Thoughts

This project represents the next evolution in crypto adoption. By making cryptocurrency transactions walletless, secure, and as simple as a text message, we remove barriers to entry and make digital finance accessible to everyone.

This innovative approach means:

• No setup required → Users can start sending crypto with just a face scan.
• Seamless fiat integration → Users can buy crypto just like they buy apps on the App Store.
• Smart fraud detection → Every transaction is checked for suspicious behavior.
• No technical knowledge needed → Users don’t need to know what gas fees, seed phrases, or private keys are.

This project is not just a crypto wallet—it’s a revolution in digital payments.