ArrowTower

📖 Project Overview

ArrowTower is a geo-location check-in dApp built in the Polkadot ecosystem. One-click deployment and multi-scenario applicability are supported. Gasless minting is achieved via backend-sponsored transactions, enabling barrier-free Web3 onboarding. The first application scenario is Arrow Tower Village (rural tourism). After a user completes route check-ins and interactive tasks, an NFT digital souvenir is minted and delivered automatically, without requiring the user to manage gas, fees, wallets, or signatures.

The platform is designed for rapid extension to Web3 conferences & events, urban cultural tourism, education & field trips, commercial marketing, community & public welfare, and additional business scenarios. On-chain identity and verifiable credentials are leveraged to provide robust user interaction and digital asset solutions across these sectors.

🌐 Live Demo: https://arrowtower.netlify.app/
🎬 Demo Video: ArrowTower_DEMO
📖 Business Feasibility Study (Entertainment Edition): Business_Feasibility_Study(Entertainment_Edition).md

✨ Core Features

🎁 Gasless User Experience: Backend-sponsored minting on PolkaVM; users do not pay gas.
🚀 Instant Deployment: Fork or clone, start Docker, and access the system immediately.
🔧 Multiple Deployment Options: Docker, Kubernetes, and GitHub Actions for one-click CI/CD.
🔄 Queue Minting: Transaction queues and batch NFT minting to handle high concurrency.
🖥️ Frontend-Driven Contract Ops: Configure and switch NFT contracts via the admin UI without backend changes.
📍 Geo + QR Validation: GPS verification and QR scanning ensure check-in validity.
🎨 Interactive Tasks: Photo upload, quizzes, route check-ins, and achievement unlocks.
📊 Analytics Dashboard: Real-time metrics for user behavior, task progress, mint volume, and participation.
🧩 Modular Components: Check-ins, tasks, NFT, and analytics modules are reusable.
⚡ PolkaVM Testnet: Runs on Polkadot Hub testnet, offering high performance at low cost.

🔑 Core Functional Modules

Authentication
- Wallet connection
- Signature-based authentication and session management (NextAuth)
Check-ins
- GPS verification
- QR code scanning
- Check-in records synchronized on-chain
Tasks
- Create or edit task routes (photo upload, quizzes, check-ins)
- Reward triggers for automatic NFT minting upon completion
Minting
- Backend-sponsored minting; supports batch queue minting
- Contract address/ABI configured from the frontend admin panel
- On-chain mint records; NFTs delivered to user wallets
Analytics
- Real-time metrics for check-ins, completion, mint volume, activity, and participation
- Combined views of on-chain data and local database data
- Chart dashboards for operational analysis
Ops & Deployment
- Dockerfile and docker-compose for one-click startup
- GitHub Actions/GitLab CI build and deployment pipelines
- Network switching (local, testnet, mainnet) and DB options (PostgreSQL/SQLite)

🎯 Application Scenarios

First Application Scenario: Arrow Tower Village (Rural Tourism)

Tourists browse Arrow Tower Village's featured tourism routes through the dApp. Upon reaching designated locations, they complete check-ins through geo-location verification or QR code scanning, and complete interactive tasks (photo uploads, knowledge quizzes, cultural experiences) to accumulate achievements. After completing the full route, the system automatically mints and sends unique Arrow Tower Village NFT digital souvenirs to the user's wallet (without user operation required).

Value: Tourist engagement is increased, a digital tourism brand is established, and long-term user connection and secondary dissemination are enabled via NFTs.

Expansion Scenarios

🎪 Web3 Conference & Events

Conference sign-in check-ins, booth interactions, lecture hall check-ins, social network check-ins
Automatically distribute different levels of conference attendance certificate NFTs based on check-in completion
On-chain identity verification ensures attendee authenticity and prevents proxy sign-ins
Real-time data statistics provide quantifiable effectiveness data for organizers and exhibitors
Applicable to blockchain summits, Web3 hackathons, industry exhibitions, developer conferences, etc.

🏙️ Urban Cultural Tourism

Historical and cultural routes, food exploration routes, art and culture routes, city challenges
Promotes cultural tourism consumption and city brand communication, establishes digital cultural assets for cities

📚 Education & Field Trips

Campus orienteering, field trip records, practical course check-ins, graduation memoirs
Enhances learning interest, establishes on-chain educational archives, provides verifiable extracurricular activity certificates

🛍️ Commercial Marketing Activities

Brand collaboration check-ins, new product launches, membership system upgrades, offline pop-up events
Increases user store visit rates and interaction rates, creates brand digital assets and Web3 community foundation

🤝 Community & Public Welfare Activities

Volunteer service records, environmental action check-ins, community activity participation, charity donation records
Establishes a trustworthy public welfare record system, enhances transparency and credibility of public welfare activities

🛠️ Technical Architecture

Tech Stack

Frontend

Framework: Next.js 15+ (App Router)
Styling: Tailwind CSS + shadcn/ui
Blockchain Interaction: wagmi + viem
Authentication: NextAuth.js
State Management: React Hooks

Backend

API Layer: Next.js API Routes
Database ORM: Prisma
NFT Minting: Backend proxy minting (Zero Gas Fee)

Blockchain

Virtual Machine: PolkaVM
Test Network: Polkadot Hub Testnet
Smart Contracts:
- Minter Contract: 0x079098fb8e901DE45AB510fA669bdE793DfEBD50 (View on blockchain explorer: Blockscout)
- NFT Contract: 0x9373197B94f4633FBc121532F3cF3948FD4a5a15 (View on blockchain explorer: Blockscout)

System Architecture

┌─────────────────────────────────────────┐
│      User Interface Layer (Next.js)     │
│    React + Tailwind CSS + shadcn/ui     │
└──────────────────┬──────────────────────┘
                   │
┌──────────────────▼──────────────────────┐
│   Blockchain Interaction (wagmi + viem) │
│    User Wallet Connection & TX Signing  │
└──────────────────┬──────────────────────┘
                   │
┌──────────────────▼──────────────────────┐
│  Business Logic (API Routes + NextAuth) │
│ Geo Verification | Task Mgmt | Analytics│
└──────────────────┬──────────────────────┘
                   │
┌──────────────────▼──────────────────────┐
│   Data Persistence (Prisma + Database)  │
│   User Data | Check-in Records | Tasks  │
└──────────────────┬──────────────────────┘
                   │
┌──────────────────▼──────────────────────┐
│    Blockchain Layer (PolkaVM + Testnet) │
│  Polkadot Hub Testnet | Smart Contracts │
└─────────────────────────────────────────┘

🚀 Quick Start

Requirements

Node.js 20.x or higher
Database (PostgreSQL / MySQL / SQLite)

Installation Steps

1. Clone the Project

git clone https://github.com/easyshellworld/arrowtower-dapp.git
cd arrowtower-dapp

2. Smart Contract Deployment & Testing

2.1 Enter Contract Directory and Install Dependencies

cd contracts/hardhat-arrowtower
npm install

2.2 Configure Contract Environment Variables

Create .env file and configure the following:

# Local network private key example
PRIVATE_KEY_LOCAL="0x...."

# passethub (testnet) private key
PRIVATE_KEY_PA="0x...."

2.3 Deploy & Test Contracts

# Local network deployment & testing
npx hardhat run scripts/deploy.ts --network localNode
npx hardhat run scripts/deployandtest.ts --network localNode

# Deploy & test using passet-hub testnet
npx hardhat run scripts/deploy.ts --network passethub
npx hardhat run scripts/deployandtest.ts --network passethub

2.4 Return to Project Root Directory

cd ../..

3. dApp Installation & Configuration

3.1 Install Dependencies

npm install

3.2 Configure Application Environment Variables

Create .env file and configure the following:

# Database configuration
DATABASE_URL="your_database_url"

# NextAuth configuration
NEXTAUTH_SECRET="your_nextauth_secret"
NEXTAUTH_URL="http://localhost:3000"

# Configure website base URL
NEXT_PUBLIC_ARROW_TOWER_BASE_URL="https://arrowtower.netlify.app/"

# Smart contract addresses
NEXT_PUBLIC_MINTER_CONTRACT="0x079098fb8e901DE45AB510fA669bdE793DfEBD50"
NEXT_PUBLIC_NFT_CONTRACT="0x9373197B94f4633FBc121532F3cF3948FD4a5a15"

# Backend minting private key (server-side only)
PRIVATE_KEY="your_private_key"

# Initialization
ADMIN_ADDRESS="admin wallet address"

3.3 Initialize Database

npx prisma generate
npx prisma db push
npm run init:db

3.4 Start Development Server

npm run dev

3.5 Access Application

Open your browser and visit http://localhost:3000

🐳 Docker One-Click Deployment

Using Docker Compose, you can quickly start a complete production-grade ArrowTower application stack, including PostgreSQL database and Next.js application.

1. Clone Project

git clone https://github.com/easyshellworld/arrowtower-dapp.git
cd arrowtower-dapp

2. Configure Environment Variables

Create .env file and configure the following key parameters:

# Database configuration
POSTGRES_USER=postgres
POSTGRES_PASSWORD=your_secure_password
POSTGRES_DB=arrowtower
DATABASE_URL="postgresql://postgres:your_secure_password@postgres:5432/arrowtower?schema=public"

# NextAuth configuration
NEXTAUTH_SECRET="your_nextauth_secret_here"
NEXTAUTH_URL="http://localhost:30000"

# Website base configuration
NEXT_PUBLIC_ARROW_TOWER_BASE_URL="http://localhost:30000"

# Smart contract addresses
NEXT_PUBLIC_MINTER_CONTRACT="0x079098fb8e901DE45AB510fA669bdE793DfEBD50"
NEXT_PUBLIC_NFT_ADDRESS="0x9373197B94f4633FBc121532F3cF3948FD4a5a15"

# Blockchain configuration
PRIVATE_KEY="your_private_key_for_backend_minting"
CHAIN_ID="420420421"
RPC_URL="https://rpc.polkadot-hub-paseo-testnet.polkadot.io"
NETWORK="polkadot-hub-paseo-testnet"

# Initialization
ADMIN_ADDRESS="admin wallet address"

3. Start Services

Use Docker Compose to start all services with one command:

docker-compose up -d

This will automatically:

Pull and start PostgreSQL 16 database
Build and start Next.js application
Configure network and data volumes
Execute health checks

4. Verify Deployment

Check service status:

docker-compose ps

View application logs:

docker-compose logs -f app

Access application: Open your browser and visit http://localhost:30000

📦 Project Structure

arrowtower-dapp/
├── contracts/                 # Smart contracts (Hardhat project)
│   └── hardhat-arrowtower/
│       ├── contracts/         # Solidity source code (arrow_tower_minter.sol, arrow_tower_nft.sol, ...)
│       ├── scripts/           # Deployment / testing scripts
│       ├── test/              # Smart contract tests
│       ├── artifacts-pvm/     # Compilation artifacts
│       └── typechain-types/   # TypeChain types
├── prisma/                    # Prisma ORM (schema / migrations / client)
│   └── (schema.prisma / migrations / client)
├── src/                       # Application source code
│   ├── app/                   # Next.js App Router source (pages & API routes)
│   │   ├── admin/             # Admin dashboard pages
│   │   ├── api/               # API routes (server-only)
│   │   │   ├── admin/
│   │   │   │   └─checkins/    # Admin-related APIs
│   │   │   ├── auth/
│   │   │   │   ├─signin/
│   │   │   │   └─[...nextauth]/
│   │   │   ├── checkins/
│   │   │   ├── checkmint/
│   │   │   ├── health/
│   │   │   ├── metadata/
│   │   │   │   └─[id]/
│   │   │   ├── pois/
│   │   │   ├── route_list/
│   │   │   └── upload/
│   │   │       └─photo/
│   │   ├── maps/              # Map-related pages
│   │   ├── routes/            # Dynamic route pages
│   │   │   └─[id]/
│   │   ├── testcheckin/
│   │   └── user/
│   │       ├─checkmint/
│   │       └─[poi]/
│   ├── components/            # Reusable components
│   │   ├─maps/                # Map components
│   │   └─ui/
│   ├── jobs/                  # Batch processing / background tasks (cron / jobs)
│   └── lib/                   # Internal utility libraries
│       ├─chains/              # Chain configuration
│       └─db/                  # Database wrapper (Prisma client)
├── public/                    # Static assets (web-accessible)
│   └── pic/
│       └── svg_small/         # Small-sized svg assets
├── pic/                       # Design/example images
│   ├─svg/
│   └─svg_small/
├── scripts/                   # Project scripts (deployment, utility scripts)
├── data/                      # Sample data / seed data / exports
├── doc/                       # Project documentation (release notes / design docs)
├── tests/                     # End-to-end or integration test directory
├── .env.example               # Environment variable example (ensure sensitive info not in repo)
├── README.md                  # Project documentation
└── (Configuration files)
    ├─tsconfig.json
    ├─next.config.js / next.config.ts
    ├─tailwind.config.js
    ├─postcss.config.js
    └─components.json          # shadcn/ui configuration

🌐 Deployment

Netlify Deployment (Recommended)

Fork this project to your GitHub account
Import project in Netlify
Configure environment variables
Click deploy

Project demo deployment: https://arrowtower.netlify.app/

🤝 Contributing

We welcome all forms of contributions, including but not limited to:

🐛 Submit bug reports
💡 Propose new feature suggestions
📝 Improve documentation
🔧 Submit code fixes
🌐 Translate documentation

📄 License

This project is open source under the MIT License.

📞 Contact

Project Homepage: https://github.com/easyshellworld/arrowtower-dapp
Live Demo: https://arrowtower.netlify.app/
Issue Reporting: https://github.com/easyshellworld/arrowtower-dapp/issues
Documentation:
- Early Project Plan (1.3beta)
- Business Feasibility Study (Entertainment Edition)

🌟 Acknowledgments

Thanks to all developers and community members who have contributed to this project!

Special thanks to the Polkadot ecosystem for supporting Web3 infrastructure.

ArrowTower - Make Every Exploration an Eternal Digital Memory 🗼✨

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

ArrowTower

📖 Project Overview

✨ Core Features

🔑 Core Functional Modules

🎯 Application Scenarios

First Application Scenario: Arrow Tower Village (Rural Tourism)

Expansion Scenarios

🛠️ Technical Architecture

Tech Stack

System Architecture

🚀 Quick Start

Requirements

Installation Steps

1. Clone the Project

2. Smart Contract Deployment & Testing

3. dApp Installation & Configuration

🐳 Docker One-Click Deployment

1. Clone Project

2. Configure Environment Variables

3. Start Services

4. Verify Deployment

📦 Project Structure

🌐 Deployment

Netlify Deployment (Recommended)

🤝 Contributing

📄 License

📞 Contact

🌟 Acknowledgments

About

Uh oh!

Releases

Packages

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 180 Commits
.github/workflows		.github/workflows
contracts		contracts
data		data
docs		docs
pic		pic
prisma		prisma
public		public
scripts		scripts
src		src
tests		tests
.dockerignore		.dockerignore
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README-zh.md		README-zh.md
README.md		README.md
components.json		components.json
docker-compose.yml		docker-compose.yml
jest.config.ts		jest.config.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

License

fuyueagain/arrowtower-dapp

Folders and files

Latest commit

History

Repository files navigation

ArrowTower

📖 Project Overview

✨ Core Features

🔑 Core Functional Modules

🎯 Application Scenarios

First Application Scenario: Arrow Tower Village (Rural Tourism)

Expansion Scenarios

🛠️ Technical Architecture

Tech Stack

System Architecture

🚀 Quick Start

Requirements

Installation Steps

1. Clone the Project

2. Smart Contract Deployment & Testing

3. dApp Installation & Configuration

🐳 Docker One-Click Deployment

1. Clone Project

2. Configure Environment Variables

3. Start Services

4. Verify Deployment

📦 Project Structure

🌐 Deployment

Netlify Deployment (Recommended)

🤝 Contributing

📄 License

📞 Contact

🌟 Acknowledgments

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages