PayPerBite Matchmaking Marketing Tool

Project Info

URL: https://payperbite.lovable.app/

Lovable Project: https://lovable.dev/projects/14c7262a-adc3-479f-a2cc-913709c4e571

About the Project

TasteBud Match is a platform that connects restaurants and influencers for advertising campaigns, leveraging smart contracts on the Polkadot Asset Hub blockchain (Paseo Testnet).

Tech Stack

This project is built with:

• Frontend: Vite, TypeScript, React, shadcn-ui, Tailwind CSS
• Blockchain: Solidity, Hardhat, Ethers.js
• Network: Polkadot Asset Hub Testnet (Paseo)

---

🧪 Testing the Contract on /test Page

Quick access to test on the development server

1. Start the development server:

   npm run dev

2. Navigate to the test page:

   http://localhost:8080/test
   

Quick access to test online

https://payperbite.lovable.app/test

What You Can Test

The /test page allows you to interact directly with the SimpleProposal contract deployed on Polkadot testnet.

🔑 Test Wallet (Automatic)

• Auto-Connect: When you open the page, a test wallet is automatically connected
• No MetaMask Required: No need to install extensions or configure anything
• Pre-funded: The wallet already has testnet balance to execute transactions
• Address: 0xc48Bd4636bC57b3F06D9d45307b6f0CF42Fb1649

📊 Contract Information

Deployed Contract:

• Address: 0x1932bF2047265051B480136100DB4D524F48BDA5
• Network: Polkadot Asset Hub Testnet (Paseo)
• Chain ID: 420420422
• RPC URL: https://testnet-passet-hub-eth-rpc.polkadot.io

Test Campaign Parameters:

• Restaurant: 0xc48Bd4636bC57b3F06D9d45307b6f0CF42Fb1649
• Influencer: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e
• Click Target: 100
• Description: Test Campaign - TasteBud Match Restaurant Promotion

🎮 How to Use the Page

1. View Campaign Data

   • On load, the page automatically displays:
     • Restaurant and influencer addresses
     • Current progress (visual bar)
     • Current clicks vs target
     • Completion percentage

2. Register a View

   • Click the "Registrar View" button
   • A transaction will be sent to the blockchain
   • Wait for confirmation (a few seconds)
   • Progress will update automatically

3. Manually Refresh Data

   • Click the "Atualizar Dados" button
   • Data will be reloaded from the contract
   • Useful to see changes made by other accounts

4. Track Progress

   • The progress bar visually shows advancement
   • When reaching 100%, a completion message appears
   • The "Registrar View" button is disabled upon completion

📱 Option: Use MetaMask

If you prefer to use your own wallet:

1. Click "Conectar MetaMask" (alternative option)
2. Configure Paseo Testnet network in MetaMask:
   • Network Name: Paseo Testnet
   • RPC URL: https://testnet-passet-hub-eth-rpc.polkadot.io
   • Chain ID: 420420422
   • Currency Symbol: PAS
3. Approve the connection
4. Important: You'll need testnet funds to send transactions

---

🛠️ Testing via Scripts

In addition to the web interface, you can test the contract using scripts:

1. Basic Function Tests

cd contracts
npx hardhat run scripts/test-proposal.ts --network passetHubTestnet

This script tests:

• ✅ Contract connection
• ✅ Reading information (getInfo(), getProgress())
• ✅ Registering views (registerView())
• ✅ Individual properties

2. UI Interaction Simulation

cd contracts
npx hardhat run scripts/simulate-ui-interactions.ts --network passetHubTestnet

This script simulates:

• ✅ Complete wallet connection flow
• ✅ Initial data loading
• ✅ "Registrar View" button clicks
• ✅ Data refresh
• ✅ Multiple consecutive registrations

---

📦 Project Structure

tastebud-match/
├── src/
│   ├── pages/
│   │   ├── Test.tsx                    # Contract test page
│   │   └── ...
│   └── ...
├── contracts/
│   ├── contracts/
│   │   ├── SimpleProposal.sol          # Test contract
│   │   ├── SBRLToken.sol               # SBRL token
│   │   └── AdvertisingProposal.sol     # Full contract
│   ├── scripts/
│   │   ├── deploy-simple-proposal.ts   # SimpleProposal deployment
│   │   ├── test-proposal.ts            # Basic tests
│   │   └── simulate-ui-interactions.ts # UI simulation
│   └── hardhat.config.ts               # Hardhat configuration
└── README.md

---

🚀 Local Development

Installation

# Clone the repository
git clone <YOUR_GIT_URL>

# Navigate to the directory
cd tastebud-match

# Install dependencies
npm i

# Start the development server
npm run dev

Contract Deployment

# Navigate to contracts directory
cd contracts

# Compile contracts
npm run compile

# Deploy to testnet
npm run deploy:testnet

---

🔗 Useful Links

• Test Page: http://localhost:8080/test
• Production URL: https://payperbite.lovable.app/
• Lovable Project: https://lovable.dev/projects/14c7262a-adc3-479f-a2cc-913709c4e571
• Testnet Explorer: https://polkadot.js.org/apps/?rpc=wss://paseo.rpc.amforc.com

---

📝 SimpleProposal Contract Features

Public Functions

• registerView() - Registers a view/click
• getProgress() - Returns progress percentage (0-100)
• getInfo() - Returns all proposal information
• restaurant() - Restaurant address
• influencer() - Influencer address
• clicksRequired() - Click target
• currentClicks() - Current clicks
• description() - Campaign description

Events

• ViewRegistered(uint256 currentClicks, uint256 clicksRequired) - Emitted when registering a view
• ProposalCompleted(uint256 totalClicks) - Emitted when target is reached

---

🤝 How to Contribute

1. Fork the project
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License.

---

🎯 Roadmap

• Integrate SBRL token into proposals
• Add complete escrow system
• Implement restaurant dashboard
• Add campaign analytics
• Mainnet deployment

---

❓ Support

For questions or issues:

1. Open an issue
2. Check the Lovable documentation
3. Contact the TasteBud Match team