WorldBNB is a revolutionary property rental platform that combines the power of World Chain's native wallet, World ID verification, and decentralized storage to create a secure, transparent, and trustless rental experience. Built entirely on World Chain infrastructure, WorldBNB eliminates intermediaries and creates a truly decentralized marketplace for property rentals.
- Native Wallet: Seamless integration with World's native wallet system
- Sponsored Gas Fees: All transactions are gas-free for users
- World ID Verification: Sybil-resistant authentication using World ID
- MiniKit Integration: Native World App functionality
- On-Chain Storage: All property data stored permanently on blockchain
- Decentralized Images: Property images stored using decentralized storage
- Transparent Listings: Fully verifiable and censorship-resistant
- Smart Contracts: Automated property management
- Smart Contract Escrow: Payments held securely until check-in
- Automated Release: Hosts receive payment after successful check-in
- Platform Fees: Automatic fee distribution
- Dispute Resolution: Built-in conflict resolution mechanisms
- User Staking: Users stake WLD tokens to participate
- Dispute Mechanisms: On-chain dispute resolution system
- Stake Slashing: Bad actors lose their stake
- Compensation: Affected parties receive reimbursements
- World ID Verified Reviews: Sybil-resistant review system
- On-Chain Storage: All reviews stored permanently
- Trust Scores: Reputation system based on verified interactions
- Next.js 14 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- Framer Motion - Smooth animations
- World MiniKit - World App integration
- World Chain - Native blockchain infrastructure
- Solidity - Smart contract development
- Hardhat - Development and deployment
- Ethers.js - Blockchain interaction
- PropertyHosting.sol - Property listing management
- PropertyBooking.sol - Booking and payment handling
- DisputeResolution.sol - Dispute resolution system
- SimpleStaking.sol - User staking mechanism
- Node.js 18.0 or later
- npm or yarn package manager
- World App for testing
- World ID Developer Account
-
Clone the repository
git clone https://github.com/chrsnikhil/WorldBNB.git cd WorldBNB -
Install dependencies
npm install # or yarn install -
Set up environment variables
cp .env.example .env.local
Fill in the required environment variables:
# World ID Configuration NEXT_PUBLIC_WLD_APP_ID=your_app_id APP_ID=your_app_id # Blockchain Configuration NEXT_PUBLIC_PROPERTY_HOSTING_ADDRESS=contract_address NEXT_PUBLIC_PROPERTY_BOOKING_ADDRESS=contract_address NEXT_PUBLIC_SIMPLE_STAKING_ADDRESS=contract_address NEXT_PUBLIC_DISPUTE_RESOLUTION_ADDRESS=contract_address # RPC URLs NEXT_PUBLIC_RPC_URL=your_rpc_url
-
Deploy smart contracts
npx hardhat compile npx hardhat run scripts/deploy.js --network your_network
-
Start the development server
npm run dev # or yarn dev -
Open World App
- Navigate to
http://localhost:3000 - Open in World App for full functionality
- Navigate to
WorldBNB/
├── app/ # Next.js App Router
│ ├── api/ # API routes
│ │ ├── verify/ # World ID verification
│ │ ├── nonce/ # Authentication nonce
│ │ └── complete-siwe/ # SIWE completion
│ └── page.tsx # Main application
├── components/ # React components
│ ├── PropertyListingForm.tsx
│ ├── PropertyBookingForm.tsx
│ ├── SimpleImageUpload.tsx
│ ├── SimpleStakingButton.tsx
│ └── ...
├── contracts/ # Smart contracts
│ ├── PropertyHosting.sol
│ ├── PropertyBooking.sol
│ ├── DisputeResolution.sol
│ └── SimpleStaking.sol
├── hooks/ # Custom React hooks
├── abi/ # Contract ABIs
├── scripts/ # Deployment scripts
└── public/ # Static assets
Manages property listings with features:
- Property creation and management
- Host verification
- Property status tracking
Handles booking and payment logic:
- Booking creation and confirmation
- Escrow payment management
- Host fund claiming
Dispute resolution system:
- Dispute creation and management
- Stake slashing mechanisms
- Compensation distribution
User staking mechanism:
- WLD token staking
- Stake management
- Unstaking functionality
- Connect Wallet: Use World App to connect your wallet
- Browse Properties: Explore available properties
- Book Property: Create booking with automated escrow
- Check-in: Confirm arrival to release payment
- Leave Review: Submit World ID verified reviews
- Verify Identity: Complete World ID verification
- List Property: Create property listing with images
- Manage Bookings: View and manage incoming bookings
- Claim Funds: Receive payments after successful check-ins
- Handle Disputes: Participate in dispute resolution
- World ID Verification: Sybil-resistant authentication
- Smart Contract Escrow: Secure payment handling
- Stake-based Incentives: Economic security through staking
- Decentralized Storage: Censorship-resistant data storage
- Transparent Transactions: All operations verifiable on-chain
WorldBNB leverages World Chain's unique features:
- Native Wallet: Seamless user experience through World's wallet
- Sponsored Gas: Zero-cost transactions for users
- World ID: Built-in identity verification
- MiniKit: Native World App functionality
Optimized for mobile-first experience:
- Responsive Design: Works perfectly on all screen sizes
- Touch-Friendly: Optimized for mobile interactions
- World App Integration: Native World App experience
- Offline Capability: Core functionality works offline
# Run smart contract tests
npx hardhat test
# Run frontend tests
npm run test
# Run linting
npm run lint# Deploy to World Chain Mainnet
npx hardhat run scripts/deploy.js --network worldchain-mainnet
# Deploy to World Chain Sepolia
npx hardhat run scripts/deploy.js --network worldchain-sepolia# Build for production
npm run build
# Deploy to Vercel
vercel deploy- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- World Chain for providing the blockchain infrastructure
- World ID for identity verification
- World App for the native wallet experience
- Next.js for the React framework
- Tailwind CSS for styling
- Documentation: World Chain Docs
- World ID: World ID Developer Portal
- Issues: GitHub Issues
- Multi-chain Support: Expand to other EVM chains
- Advanced Dispute Resolution: AI-powered dispute analysis
- Property Insurance: Decentralized insurance integration
- DAO Governance: Community-driven platform governance
- Mobile App: Native mobile applications
Built with ❤️ for the World Ecosystem
WorldBNB - Where trust meets technology