This is an AI-powered cross-border remittance platform that combines the speed and efficiency of blockchain with the simplicity of natural language AI. Built on the Hedera network, it enables users to send international payments as easily as sending a text message.
- AI-Powered Interface: Send payments using natural language commands
- Instant Settlements: Near-instant transactions on Hedera network
- Low Cost: Minimal transaction fees compared to traditional remittance services
- Transparent: Real-time transaction tracking with HashScan integration
| Integration | Description |
|---|---|
| PayPal USD (PYUSD) | Stablecoin representation |
| Hedera Testnet | Blockchain infrastructure |
| HashScan | Transaction explorer |
| Google Gemini AI | Natural language processing |
Before running this project, ensure you have:
- Node.js 18+ installed
- npm or yarn package manager
- Hedera Testnet account
- Google Gemini API key
git clone <repository_url>
cd Evangelion_AgentPaycd backend
npm installcp .env.example .env
Edit your .env file with your credentials:
.env
# Hedera Testnet Accounts
SENDER_ACCOUNT_ID=0.0.YOUR_ACCOUNT_ID
SENDER_PRIVATE_KEY=0xYOUR_PRIVATE_KEY
RECIPIENT_ACCOUNT_ID=0.0.RECIPIENT_ACCOUNT_ID
RECIPIENT_PRIVATE_KEY=0xRECIPIENT_PRIVATE_KEY
# Gemini API Key
GEMINI_API_KEY=your_gemini_api_key_here
# Server Port
PORT=3001
# Token ID (generated during setup)
TOKEN_ID=
# Create test token (TPYUSD)
npm run setup-token
# Associate token with recipient account
npm run associate-token
# Verify setup
npm run check-association
cd ../frontend
npm installcp .env.local.example .env.local
Edit .env.local:
.env
NEXT_PUBLIC_API_URL=http://localhost:3001
NEXT_PUBLIC_SENDER_ACCOUNT_ID=0.0.YOUR_ACCOUNT_IDTerminal 1 - Start Backend
cd backend
npm run devTerminal 2 - Start Frontend
cd frontend
npm run devOpen http://localhost:3000 in your browser.
Create a new account or login with existing credentials Provide your Hedera account ID during registration
Method 1: AI Assistant (Recommended)
Use the chat interface in the dashboard:
Examples:
"Send 10 TPYUSD to 0.0.1234567"
"Transfer 5 tokens to 0.0.1234567"
"Please send 15 TPYUSD to account 0.0.1234567"
Method 2: Manual Transfer
Go to “Send Money” page
Enter amount and recipient details
Confirm transaction
Navigate to the “Transactions” page View real-time status and HashScan links Monitor successful and failed transactions
npm run dev # Start development server
npm run setup-token # Create test token on Hedera
npm run associate-token # Associate token with accounts
npm run test-transfer # Test token transfer functionality
npm run test-agent # Test AI agent with sample messagesnpm run dev # Start development server
npm run build # Build for production
npm run start # Start production serverNode.js with Express.js
Hedera Hashgraph (Distributed Ledger Technology)
Hedera Token Service (HTS) for stablecoin operations
ECDSA wallet support
TypeScript
Google Gemini API for NLP
Testnet environment
Next.js 14 with React
Tailwind CSS for styling
TypeScript
Support for multiple languages
Better error handling and guidance
Mobile-responsive design improvements
Real-time balance updates
Transaction templates for frequent recipients
Two-factor authentication (2FA)
Enhanced KYC/AML integration
Transaction limits and monitoring
Additional stablecoins (USDC, USDT)
Currency conversion features
Cross-chain compatibility
Bulk payments
Regulatory compliance across jurisdictions
This project is licensed under the MIT License — see the LICENSE file for details.