Documentation

Welcome to the Twoonie developer documentation. Here you can find details on how our Solana smart contracts operate, the architecture of our sweeps logic, and how we ensure secure transactions using Plaid.

Overview

Twoonie bridges traditional Canadian banking with decentralized finance. By connecting your existing bank accounts securely via Plaid, the platform monitors your everyday transactions, calculates the spare change, and sweeps it into a personalized Solana vault when a threshold is met.

The funds are automatically distributed into a diversified portfolio consisting of USDC yields, SOL, and liquid staked tokens like jitoSOL, ensuring your idle change works harder than it would in a traditional bank account.

Core Features

  • Automated Round-ups: Seamlessly connects to Canadian bank accounts to track spending and calculate round-up amounts.
  • Solana Vault Integration: Groups micro-transactions and sweeps them on-chain into a secure, non-custodial Solana wallet.
  • Automated Yield Strategies: Automatically allocates deposited funds into predefined risk profiles (e.g., Safe, Balanced, Growth) across various Solana ecosystem assets.
  • Premium Interface: Built with a high-fidelity, cinematic user interface that feels native, fast, and highly responsive.

Technical Stack

  • Frontend: Next.js (App Router), React, TypeScript
  • Styling: Vanilla CSS, CSS Modules, Tailwind CSS
  • Animation: Framer Motion, GSAP
  • Workspace: Turborepo (Monorepo architecture)
  • Web3 Integration: Solana Web3.js, Anchor (for Solana PDA interaction)
  • Backend/API: Hono (Serverless API), BullMQ (Background job queue for sweeps)
  • Banking API: Plaid

For installation instructions and to run the app locally, please visit our GitHub repository.