How hackbalam/goyoelevenlabs works
Project type and purpose
• This is a single-page full-stack-style frontend application built with React, TypeScript & Vite. It acts as a voice-driven crypto wallet assistant (“Goyo”) leveraging the ElevenLabs voice/LLM API and a client-side wallet connector (e.g., WalletConnect).
• Its two main use cases are TRANSFER (sending crypto) and EXCHANGE (swapping tokens) via voice commands.
File structure
• Top level:
• package.json / vite.config.ts / tsconfig*.json → build & compile config
• index.html / public → static host page
• src/:
• main.tsx → app entry point
• App.tsx, pages/ (HomePage, ContactsPage, DebugPage) → routing & high-level pages
• components/ → UI building blocks (ActionButtonList, ContactsManager, MicrophoneAnimation, etc.)
• hooks/ (useContacts) → custom React hooks for stateful logic
• utils/ (contactsStorage) → localStorage wrapper for contacts
• config/ → environment & ElevenLabs agent configuration
• conversation.tsx → orchestration of voice interaction & ElevenLabs agent
• types/ → TypeScript type definitions
README for insights
• Calls out ElevenLabs React SDK, environment variables (VITE_PROJECT_ID, agentID)
• Describes the voice-assistant flow: initial greeting, system prompts, dynamic variables
• Defines the two tool actions (transfer, exchange) and binding to ‘actionHandler’
Main components & their relationships
a. UI Layer (React SPA)
• Pages & Components
• MicrophoneAnimation & input capture
• ActionButtonList to trigger actions manually
b. Voice/LLM Layer
• ElevenLabs React SDK (STT/TTS)
• conversation.tsx orchestrates sendAudio → ElevenLabs → receiveResponse
• actionHandler callback that interprets LLM tool instructions
c. Wallet Layer
• Wallet connector (e.g., WalletConnect or Web3 provider invoked via actionHandler)
• External blockchain network
d. Local Storage
• contactsStorage via utils and useContacts hook
e. Configuration & Environment
• VITE_PROJECT_ID, agentID held in config/index.tsx
Architectural patterns & technologies
• Component-based UI (React)
• Single-page routing (React Router or custom)
• Hook-based state management (useContacts, local state in pages/components)
• External service orchestration (ElevenLabs LLM agent as a “tool” pattern)
• Client-side only—no backend microservices