DappPay

DappPay is an innovative decentralized application (DApp) designed for seamless payroll management using blockchain technology powered by Solana's Rust programming language.

This DApp enables organizations to automate their entire pay process—from adding workers in real-time with accurate salary details directly linked through unique identifiers, to creating new organizational entities effortlessly while ensuring compliance and security.

Secure

Blockchain-powered transactions

  • Immutable records
  • Transparent ledger
  • No intermediaries

Fast

Lightning-quick payments

  • Sub-second transfers
  • Batch processing
  • Real-time updates

Smart

AI-assisted management

  • Natural language control
  • Auto-processing
  • Smart contracts

Required: You Need an OpenAI API Key

The AI assistant is powered by your own OpenAI API key — this keeps your usage private, secure, and gives you full control over costs.

How to get one (30 seconds):
1. Go to → platform.openai.com/api-keys
2. Click “Create new secret key”
3. Copy the key (starts with sk-...)
4. Paste it in the chat when prompted

Your key is stored only in your browser • Free tier gives thousands of commands

How to Talk to the AI (Just Use Plain English!)

GoalJust type thisResult
List all organizationsShow my organizationsShows treasury balances
View org detailsShow details for TeslaWorkers, salaries, last paid
Create organizationCreate organization AppleInstantly created
Add workerAdd worker 7yQ... to Tesla salary 3.5 SOLWorker added
Fund treasuryFund Tesla with 20 SOLSOL transferred
Pay everyoneProcess payroll for TeslaAll workers paid
WithdrawWithdraw 8 SOL from TeslaSent to your wallet

Pro tip: The AI remembers your organization names — just use the name you gave it!

Connect Your Wallet

Start by connecting your Solana wallet to the dashboard. This enables transactions and fund management.

Basic Workflow

1

Create Organization

Ask the AI: "Create organization TechCorp"

2

Add Workers

Add team members with their wallet addresses and salaries

3

Fund Treasury

Transfer SOL to your organization's treasury wallet

4

Process Payroll

Execute payments automatically or manually trigger cycles

5

Monitor & Withdraw

Track transactions and manage treasury funds

On smaller screens the layout automatically adapts:

  • The organizations panel is hidden by default
  • Tap the glowing menu button (bottom-right or top-right) to open it
  • Chat takes full width for easier typing
  • Swipe the panel away when done

Everything works exactly the same — just optimized for touch!

Quick Fixes

ProblemFix
Nothing happens when I typeDid you set your OpenAI API key?
“Invalid orgPda” errorUse the exact org name from your list
Insufficient fundsFund the treasury first!
AI keeps asking for missing infoInclude org name + amount + wallet address

Best Practices

  • • Always start with “Show my organizations”
  • • Use simple org names (no special characters)
  • • Fund treasury before adding workers
  • • Keep your wallet connected (green dot = good)

Project Structure


                    dappPay/
                        ├── anchor/                    # Solana smart contracts
                        │   ├── programs/payroll_program/
                        │   │   └── src/
                        │   │       ├── instructions/  # Core functions
                        │   │       ├── states/        # Data structures
                        │   │       └── errors/        # Error handling
                        │   └── migrations/
                        ├── app/                       # Next.js frontend
                        │   ├── about/                # Project info
                        │   ├── dashboard/            # Main dashboard
                        │   ├── documentation/        # Project docs
                        │   ├── playground/           # Test suite
                        │   └── features/             # Feature showcase
                        ├── components/               # Reusable React components
                        ├── lib/                      # Utility libraries
                        ├── services/                 # Blockchain services
                        └── utils/                    # Helper functions
50

Total Files

40

Code Files

5

Smart Contracts

14+

Test Cases