Test at https://www.publishednft.io/

Published NFT announced today the launch of its groundbreaking digital book marketplace, enabling users to buy, collect, and read NFT books

in virtual reality and augmented reality environments. Built on the Flow blockchain, the platform bridges Web3 and mainstream audiences by

accepting both cryptocurrency and traditional payment methods including credit cards, Apple Pay, and Google Pay.

"We're making NFT book ownership as easy as shopping on Amazon, while delivering an immersive reading experience that's never been possible

before," said [Founder Name]. "You can literally hold a book in virtual space and turn pages with your hands."

Key features include:

- VR/AR reading support for Meta Quest, Apple Vision Pro, and mobile AR

- Fiat and crypto payment options via Crossmint integration

- Near-zero transaction fees (~$0.01) on Flow blockchain

- Free sacred text NFTs (Bible, Quran, Gita, Torah, Guru Granth Sahib, Dhammapada)

- PAGE token rewards for reading and engagement

- NFT marketplace with listings, offers, auctions, and rentals

- Author royalty system for ongoing creator compensation

🏆 Published NFT – Flow Blockchain Bookstore Platform

Flow Forte Hacks 2025 Submission

📊 Executive Summary

Published NFT is an advanced onchain bookstore platform powered by Flow blockchain. It blends autonomous smart agents, AI-assisted publishing, 3D visualization, and a hybrid analytics engine to redefine how digital literature is created, shared, and experienced.

🚀 Innovation Highlights

1. ⚡ Flow Forte v0.43.2 – Autonomous Onchain Agents

Published NFT operates with 14 autonomous agents that manage key operations without any offchain schedulers. Each agent handles actions like publishing, time-locking, staking, or distribution directly on Flow.

Flow Actions: The AIGenerationActions contract enables onchain workflows for AI-assisted publishing, including cover generation, summaries, and metadata curation.
Precision: Built with UFix128 for exact reward and royalty calculations.

2. 📚 Advanced Literary Collections

The platform features a wide range of onchain literary NFTs, from original works and classic literature to community-published content. Each NFT includes complete readable text, metadata-driven enhancements, and AI-based tools for summaries, annotations, and study support.

Collection Categories:

• Literary Classics – Timeless works preserved onchain

• Interactive Storybooks – Enhanced with audio and dynamic scenes

• Educational Titles – Built for study and learning environments

• Fantasy & Sci-Fi Works – Animated covers and 3D showcases

• Community Creations – User-submitted books powered by AI publishing tools

All collections are MetadataViews compliant, onchain readable, and mintable with open access while maintaining full ownership security.

3. 📊 Hybrid Analytics System

A multi-provider architecture ensures deep data insights and reliability across the NFT ecosystem.

Advantages:

• Smart caching every 5 minutes

• Provider failover for reliability

• Unified FlowAnalytics class in /lib/analytics/

• Ready for hybrid Flow + EVM analytics

4. 💳 Dual Payment Infrastructure

Published NFT seamlessly connects Web3 wallets and Web2 payment gateways, enabling inclusive participation.

Web3 (Dapper Wallet):

• Dual authorization workflow

• NFT auto-setup post-purchase

• Real-time transaction tracking

Web2 (Crossmint):

• Credit/debit cards, Apple Pay, Google Pay

• Email-based wallet onboarding

• Instant Flow NFT minting

Architecture Flow:

User Purchase├─ Web3: Dapper Wallet → Flow blockchain└─ Web2: Crossmint → Card → Flow blockchain

5. 🤖 AI Integration (4 Providers)

AI is integrated directly into the publishing and reading layers, enabling intelligent interaction with books.

Providers:

• Anthropic Claude – Summaries and comprehension

• xAI Grok – Creative content generation

• Google Gemini – Visual + text storytelling

• OpenAI GPT – Multi-purpose generation and reasoning

Endpoints:

• /api/ai/summarize – Automated chapter summaries

• /api/ai/answer – Reader Q&A

• /api/ai/study-materials – Flashcards, quizzes

• /api/generate-cover – AI cover art

• /api/generate-storybook – Complete stories

Infrastructure: 14+ MCP servers (flow-mcp, ebook-mcp, three-js-mcp, etc.) manage task routing and model communication.

6. 📖 3D Visualization & EPUB Reading

Published NFT includes nine EPUB reader implementations and interactive 3D environments for a cinematic book experience.

Readers:

• epub-reader-working.tsx – Core reader

• epub-reader-with-ai.tsx – AI assistant integration

• epub-reader-with-rewards.tsx – Earn-as-you-read system

• advanced-epub-reader.tsx – Interactive 3D page flipping

3D Modules:

• 3d-book-cover.tsx – Animated covers

• 3d-bookshelf.tsx – Interactive library shelves

• 3d-showroom.tsx – Immersive viewing environments

Tech Stack: Three.js v0.180.0, @react-three/fiber v8.18.0, EPUB.js v0.3.93

7. 🥽 AR/VR Development – The Next Frontier

The team is currently building immersive AR and VR extensions for the Published NFT platform — the next evolution of digital reading.

In Development:

• WebXR Reading Mode – Bring NFT books into spatial environments

• Hand Tracking & Gestures – Flip, point, and interact naturally

• Immersive Scenes – Virtual libraries, futuristic reading lounges

• Cross-Device Support: Meta Quest, Apple Vision Pro, HTC Vive, ARCore devices

Goal: To transform reading into an interactive, spatial storytelling experience, blending literature, AI, and extended reality into one seamless ecosystem.

📈 Metrics & Architecture Summary

🧩 Deployment Status

Network: Flow Testnet
Address: 0x4c55dc21a9da7476
Frontend: Next.js 14.2.16 on Vercel
Database: PostgreSQL + Drizzle ORM

✅ Live Features:

• NFT Publishing & Minting

• AI Summaries & Q&A

• Crossmint + Dapper Payments

• 3D Reading Interface

• Real-Time Analytics

🧩 Collaborative Quests & Avatar Decoration Marketplace

Published NFT introduces Collaborative Brand Quests, a system that blends storytelling, collectibles, and gamified engagement — giving users a reason to read, explore, and decorate their onchain identity.

🎯 What It Is

Players can participate in seasonal quests and challenges built in collaboration with major brands and creative studios. Completing reading milestones or story-based missions unlocks limited-edition avatar decorations, collectibles, and special NFT cosmetics.

Each quest connects brand storytelling to the reading journey — turning fan engagement into an interactive, onchain experience.

🏅 Brand Collaboration Potential

The system is designed for easy co-branding with global partners such as:

• 🏈 NFL – Team-themed reading badges, jersey decorations, collectible locker rooms

• 🏀 NBA – Player or franchise quests with animated rewards

• 🎬 Disney / Pixar – Themed environments, enchanted library scenes, cinematic avatar frames

• 🕹️ Gaming Brands – Quest-based storylines tied to character NFTs or in-game lore

These partnerships bring story and fandom together, blending entertainment IP with blockchain interactivity.

💠 Avatar Decoration System

Avatars are fully customizable using onchain decoration NFTs, which can include:

• Wearables (jerseys, hats, accessories)

• 3D badges or floating collectibles

• Animated backgrounds or effects

• Brand-based frames or banners

All decorations are stored and owned onchain, tradable on Flow marketplaces, and viewable across Published NFT profiles, leaderboards, and AR/VR reading rooms.

🛍️ Shop for Avatar Customization

The Avatar Shop operates as a dynamic storefront where readers can:

• Browse and purchase brand-themed items

• Unlock new collections via quests or achievements

• Earn discounts and exclusive drops through engagement

• Showcase their style in their public reader profile or VR reading lounge

Payment Options:

• 💳 Web2: Crossmint (Apple Pay, Google Pay, cards)

• 💎 Web3: Dapper Wallet, Flow tokens

🔗 Ecosystem Connection

This system ties directly into the Published NFT reward and analytics layer — tracking reading habits, brand quest completion, and avatar item usage to personalize experiences and future quest drops.

🧠 In Progress:

• AR/VR immersive reading system (WebXR)

• Spatial AI storytelling

📚 Documentation

• CLAUDE.md – System configuration (2,000+ lines)

• flow-forte-integration.md – Forte agent documentation

• dapper-integration.md – Wallet integration

• api-key-security.md – Security standards

• ONCHAIN_COVER_WORKFLOW.md – Onchain media storage

• VR_AR_IMMERSIVE_READING_PLAN.md – Future XR expansion plan

🔗 Important Links

• Contracts: Flowscan Testnet – 0x4c55dc21a9da7476

• GitHub: PublishedNFT

• Frameworks: Flow CLI v2.7.1 | FCL v1.20.1 | Cadence 1.0

👥 Team – Published NFT

Core Expertise:

• Smart Contract Engineering (Cadence)

• Fullstack Development (Next.js, TypeScript)

• 3D & Web Visualization (Three.js)

• AI Integration & MCP Coordination

• Onchain Automation (Forte Agents)

• Blockchain Analytics

📧 Contact: team@publishednft.io

🙏 Acknowledgments

• Flow Foundation – Developer infrastructure

• Dapper Labs – Wallet framework

• Crossmint – Web2 onboarding

• Anthropic, xAI, Gemini, OpenAI – AI support

• FindLabs, Dune, Alchemy, SimpleHash – Analytics integration

• Vercel – Hosting & deployment

• Flow Community – Inspiration and testing support

1. RentalExpirationAgent (Daily)

- Operation: Scans all active NFT rentals every 24 hours

- Action: Automatically returns expired NFTs to original owners

- Example: User rents "Pride and Prejudice" for 7 days → On day 8, agent automatically transfers NFT back to owner's collection

- Benefit: No manual return required, trustless rental system

2. TimeLockNFTAgent (Daily)

- Operation: Checks all time-locked NFTs at midnight UTC

- Action: Unlocks NFTs when lock period expires

- Example: Author locks Genesis Pass for 30 days → Agent unlocks on day 31 automatically

- Benefit: Trustless vesting schedules

3. ReaderRewardsAgent (Every 10 Minutes)

- Operation: Tracks reading sessions from last 10 minutes

- Action: Distributes $PAGE tokens based on reading time

- Calculation: reward = readingMinutes * rewardPerMinute (UFix128)

- Example: User reads for 8 minutes → Earns 0.008 $PAGE tokens automatically

- Benefit: Passive income while reading

4. PublishedDailyAgent (Daily at 6 AM UTC)

- Operation: Mints new daily edition NFT newspaper

- Action: Creates NFT with latest news/articles

- Example: Every morning at 6 AM, new "Published Daily #305" is minted with today's date

- Benefit: Automated publishing workflow

5. NFTStakingAgent (Real-time on stake/unstake)

- Operation: Calculates accumulated rewards when users stake/unstake

- Action: Mints reward tokens based on staking duration

- Formula: rewards = stakedDays dailyAPY nftValue (UFix128 precision)

- Example: User stakes Genesis Pass (3% APY) for 30 days → Earns 0.246 $PAGE tokens

- Benefit: Accurate reward calculation with 24-decimal precision

6. PriceOracleAgent (Hourly)

- Operation: Fetches floor prices from NFT marketplaces

- Action: Updates onchain price feeds for all collections

- Example: Every hour, updates GenesisPassV2 floor price: 25.0 FLOW → 24.5 FLOW

- Benefit: Real-time pricing for accurate valuations

7. TradingSessionAgent (Every 5-30 Minutes)

- Operation: Scans for expired trading sessions

- Action: Auto-cancels inactive trades, returns escrowed NFTs

- Example: User proposes NFT swap but doesn't complete in 30 min → Agent returns NFT to user

- Benefit: No stuck NFTs in escrow

8. PageTokenAgent (Daily)

- Operation: Distributes $PAGE token rewards to stakeholders

- Action: Mints tokens based on protocol revenue

- Recipients: Stakers (40%), Treasury (30%), Team (20%), Community (10%)

- Example: Protocol earns 100 $PAGE → Agent distributes 40 to stakers, 30 to treasury, etc.

- Benefit: Automated tokenomics

9. ListingMonitorAgent (Real-time)

- Operation: Monitors marketplace listings for suspicious activity

- Action: Flags wash trading, unusual price spikes

- Example: Detects same wallet buying/selling NFT 10x in 1 hour → Flags for review

- Benefit: Market integrity

10. PersonalStakingAgent (User-level)

- Operation: Each user gets personal agent for their staking

- Action: Tracks individual staking positions, auto-compounds rewards

- Example: User stakes 3 NFTs → Personal agent tracks each, compounds daily

- Benefit: Set-and-forget staking

11. NFTSwapAgentV2 (On-demand)

- Operation: Executes atomic NFT swaps when both parties accept

- Action: Transfers NFT A → User B, NFT B → User A simultaneously

- Example: User A (Genesis Pass) swaps with User B (BOAST6) → Agent executes atomically

- Benefit: Trustless P2P trades

12. PublishedDailyAgentV2 (Enhanced Daily)

- Operation: Advanced daily edition with AI-generated content

- Action: Mints NFT + generates AI summary + distributes to subscribers

- Example: 6 AM: Agent mints NFT → Generates AI news summary → Airdrops to 100 subscribers

- Benefit: Fully automated newsletter

13. TradingAgent (Real-time)

- Operation: Automated trading strategies for liquidity pools

- Action: Executes buy/sell based on market conditions

- Example: $PAGE price drops 10% → Agent buys from treasury funds

- Benefit: Automated market making

14. NFTListingAgent (Real-time)

- Operation: Auto-lists NFTs when certain conditions met

- Action: Creates marketplace listings based on user-defined rules

- Example: User sets rule: "List if floor price > 30 FLOW" → Agent lists automatically

- Benefit: Automated trading strategies

Added real-world scenario showing 4 agents coordinating for complete NFT rental lifecycle:

- TradingSessionAgent (escrow)

- ReaderRewardsAgent (earn while reading)

- RentalExpirationAgent (auto-return)

- PageTokenAgent (revenue distribution)

🎯 USE CASE MATRIX

| Feature | Genesis Pass | Religious Texts | Decorations | Published Daily |

|--------------|--------------|-----------------|-------------|-----------------|

| Reading | ✅ All Books | ✅ Sacred Text | ❌ | ✅ Daily News |

| Staking | ✅ 5% APY | ❌ | ✅ 1-10/day | ❌ |

| Rentals | ✅ | ❌ | ❌ | ❌ |

| VR/AR | ✅ | ✅ | ❌ | ❌ |

| AI Assistant | ✅ | ✅ | ❌ | ✅ |

| Trading | ✅ | ✅ | ✅ | ✅ |

| Donations | ✅ | ✅ | ❌ | ❌ |

| Autonomous | ✅ Rewards | ✅ Donations | ✅ Rotation | ✅ Auto-mint |

| Free Mint | ❌ 25 FLOW | ✅ FREE | ❌ 5 $PAGE | ❌ Varies

Combining reading access, financial utilities (staking, rentals), social features (donations, gifts), autonomous operations (14 agents), and multiple payment rails (Web3 + Web2) into a single platform! 🚀

What Data FindLabs Provides

1. NFT Events (Main Use Case)

- Mint events: Track when new NFTs are created

- Deposit events: Track NFT transfers into wallets

- Withdraw events: Track NFT transfers out of wallets

- Used for: Calculating total supply, holder counts, transaction history

2. Collection Statistics

- Total supply (from mint event counts)

- Unique holders (from deposit/withdraw addresses)

- Sales count (event aggregation)

- Transaction history timeline

3. Blockchain Data

- Current block height

- Block timestamps

- Transaction details by ID

- Staking rewards history

---

🛠️ Where It's Used

API Routes (8 endpoints):

1. /api/analytics - Main aggregator endpoint

2. /api/marketplace-stats - Real sales data

3. /api/analytics/profile-stats - User blockchain stats

4. /api/analytics/author-sales - Author sales tracking

5. Other analytics endpoints

UI Components (4 locations):

1. flow-analytics-dashboard.tsx - Admin analytics dashboard

2. nft-collection-stats.tsx - Collection stats displays

3. app/profile/page.tsx - User profile stats

4. app/admin/subagents/page.tsx - Subagents admin panel

Collections Tracked (7 collections):

- Genesis Pass V2

- BOAST6 Magazine

- Jeweled Hoard

- 49 Syllables on Life

- Pride and Prejudice

- RYDZ The Element

- Groundwork 29

---

⚙️ Technical Implementation

Architecture:

User Request → API Route → FlowAnalytics Aggregator → FindLabs Client

↓

Also queries: Alchemy, SimpleHash, Dune (if configured)

↓

Merges data from all sources

↓

Returns unified response

Key Features:

- Rate limiting: Auto-waits if 60 requests/minute exceeded

- Caching: 5-minute TTL to reduce API calls

- Failover: Falls back to other providers if FindLabs fails

- Multi-network: Works on both testnet and mainnet

---

💡 Why FindLabs?

Advantages:

- ✅ FREE - No API key or payment required

- ✅ Flow-native - Built specifically for Flow blockchain

- ✅ Real-time - Event-driven updates

- ✅ Reliable - 60 requests/minute is sufficient for most use cases

- ✅ Complete - Excellent for NFT event tracking

Limitations:

- ⚠️ No rich metadata (NFT names, descriptions, images)

- ⚠️ No marketplace-specific sales data

- ⚠️ Flow Cadence only (no EVM support yet)

---

📈 Usage Example

When you view a collection's stats:

1. FindLabs queries the Flow blockchain for all mint/transfer events

2. Counts total mints → Total Supply

3. Identifies unique wallet addresses → Holders Count

4. Aggregates event timestamps → Transaction History

5. Combines with Alchemy/SimpleHash data if available → Enhanced Stats

---

🔧 Current Status

Fully Operational:

- ✅ 301-line FindLabs client implementation

- ✅ Integrated into hybrid analytics system

- ✅ Used across 8+ API routes and 4+ components

- ✅ Tracking 7 NFT collections on Flow testnet

- ✅ Real blockchain data