Proposal: Yapper Agent CC Integration

proposals/yapper-agent-v2.md

@@ -0,0 +1,309 @@
+# Development Fund Proposal
+
+**Author:** Yapper Agent Team (contact@yapperagent.xyz)
+
+**Status:** Submitted
+
+**Created:** 2026-05-05
+
+**Label:** dapp-integration
+
+**Platform:** yapperagent.xyz (LIVE)
+
+**Community:** 15,000+ creators - X, Discord, Telegram
+
+**Partnerships:** Bitget Wallet, Numbers Protocol
+
+**Category:** Developer Tooling & Ecosystem Infrastructure
+
+**Duration:** 6 months - 3 milestones
+
+**Requested Funding:** 400,000 CC
+
+---
+
+## Abstract
+
+Yapper Agent ([yapperagent.xyz](https://yapperagent.xyz)) is Canton Network's first **Learn, Work & Earn platform** - open-source infrastructure where creators, builders, and contributors can learn about Canton, work on real tasks and bounties, and earn CC for their contributions.
+
+Just as Payment Streams is the reference implementation for payment streaming, **Yapper Agent is the reference implementation for task, bounty, and quest systems on Canton.**
+
+This is not a proprietary product, it is **public good infrastructure** published under Apache 2.0 that any Canton developer can fork, deploy, and build on top of. The platform is already live with 15,000+ community members and 850+ real creators onboarded within 1 week of launch, with the first campaign already live with OneSwap and many Canton projects requesting campaigns.
+
+---
+
+## Motivation
+
+Canton has analytics, but no platform where contributors can actively **work and earn.** Task and bounty infrastructure is a well-known primitive on other networks:
+
+- Solana has Superteam Earn
+- Ethereum has Gitcoin
+- Soneium has Arkada
+- **Canton has nothing yet**
+
+Yapper Agent fills this gap, turning passive ecosystem participants into active contributors and earners, with every action recorded as an on-chain transaction on Canton Network.
+
+---
+
+## Specification
+
+### 1. Objective
+
+Build and open-source the task, bounty, and quest infrastructure layer that Canton Network currently lacks - delivered as reusable DAML smart contract templates, a TypeScript SDK, a reproducible demo environment, and a live reference implementation.
+
+### 2. Implementation Mechanics
+
+**1/ On-Chain Task & Bounty Protocol**
+- Open-source DAML JobEscrow contracts for task creation, escrow, submission, verification, and payment
+- Privacy-preserving - task terms and balances visible only to authorized parties
+- CC as the only native currency across all transactions
+- Every completion = real on-chain transaction on Canton Network
+- Published under **Apache 2.0 license** - reusable by any Canton developer
+
+**2/ CC Payment Rails**
+- Open-source payment integration layer for task-based economic activity on Canton
+- CC wallet auto-created on sign-up via X account (Reown AppKit + Canton Ledger API with Keycloak JWT authentication)
+- Live CC/USD price fetched from CoinMarketCap (10-min cache, ceiling-rounded to 0.1 CC)
+- `ClaimReward` exercises CC transfer to creator on proof verification
+- `CancelEscrow` handles client refunds
+- x402 and MCP endpoints for AI agents to post jobs autonomously, extended to settle in CC
+
+**3/ Educational Quest Infrastructure**
+- Open-source quest framework any Canton project can deploy to educate their users
+- Structured learning paths covering Canton fundamentals for builders & creators
+- Project-sponsored quests, projects pay to educate users about their product
+- XP, badges, and CC rewards upon completion
+- Every Canton project launch → automatically creates related learning quest
+
+**4/ Canton Ecosystem Data Aggregator**
+- Open API aggregating news & updates from all Canton projects in one place
+- Every project announcement → automatically creates related quest/task
+- Community-driven submission & verification system
+- Developers can consume aggregated Canton data via public API
+
+**5/ On-Chain Contributor Reputation Protocol**
+- Verifiable on-chain reputation system any Canton project can integrate
+- Public creator profiles with on-chain track record
+- Campaign analytics , completion rate, engagement metrics per project
+- Leaderboard for top creators & builders on Canton
+- Shareable profile URL → `/u/username`
+
+**6/ Canton Wallet Integration**
+- Login with Canton wallet
+- All earnings & payments directly to wallet
+- On-chain identity verification
+- Privacy-preserving - task terms visible only to authorized parties
+
+**7/ Open-Source Developer Infrastructure**
+- All DAML contracts published under **Apache 2.0 license**
+- TypeScript SDK → `npm install yapper-canton-sdk`
+- Reproducible demo environment — any developer can deploy their own instance in under 10 minutes
+- Full documentation with integration examples
+
+### 3. Architectural Alignment
+
+| Canton Priority | Yapper Agent Contribution |
+|---|---|
+| Core Infrastructure | DAML JobEscrow contracts - open-source, reusable by any Canton developer |
+| Developer Tooling | TypeScript SDK, reproducible demo environment, integration examples |
+| Ecosystem Growth | 15,000+ community members + 850+ real creators already onboarded |
+| Canton Coin Utility | CC as native payment - every task completion = real on-chain CC transaction |
+| Developer Experience | Reference implementation for task & bounty systems on Canton |
+| News & Discovery | Open API aggregating Canton ecosystem updates - developer consumable |
+
+Directly aligns with CIP-0082 ("dev tools, reference implementations, critical infra") and CIP-0100 ("developer marketing activities that pull more developers into the ecosystem").
+
+### 4. Backward Compatibility
+
+No backward compatibility impact. New CC integration layer added to existing platform. All existing functionality remains fully unchanged.
+
+---
+
+## Milestones and Deliverables
+
+### Milestone 1: On-Chain Task Protocol + TypeScript SDK (Month 1–2)
+
+| Detail | Description |
+|---|---|
+| **Estimated Delivery** | 2026-07-05 |
+| **Focus** | DAML contracts live on devnet, TypeScript SDK published, Canton wallet integration live |
+| **Funding** | 135,000 CC |
+
+**Deliverables:**
+- DAML JobEscrow contracts deployable by any developer following documentation
+- Canton wallet auto-created on user sign-up
+- CC payment rails live on devnet
+- TypeScript SDK v0.1 published → `npm install yapper-canton-sdk`
+- At least 1 integration example published
+- All code published Apache 2.0 on GitHub
+- ≥50 CC-paid jobs completed end-to-end on devnet (verified)
+
+**Acceptance Criteria:**
+- DAML contracts deployable by any developer following published documentation
+- SDK installable via `npm install yapper-canton-sdk` with working examples
+- Canton wallet login live and functional
+- All code published Apache 2.0 on GitHub before milestone payment release
+
+---
+
+### Milestone 2: Full Platform Live + Educational Quest Infrastructure (Month 3–4)
+
+| Detail | Description |
+|---|---|
+| **Estimated Delivery** | 2026-09-05 |
+| **Focus** | CC fully live on mainnet, educational quest system, reputation protocol, news aggregator |
+| **Funding** | 135,000 CC |
+
+**Deliverables:**
+- CC payment rails live on mainnet
+- Creator dashboard live: CC balance, claim button, transaction history
+- Educational quest system live with at least 3 learning paths and 10+ quests
+- Canton ecosystem data aggregator live with 10+ project updates
+- 5+ Canton projects actively running campaigns
+- Creator reputation profiles live with shareable URLs
+- ≥300 creators with active CC wallets on mainnet
+- 100+ on-chain transactions recorded
+- SDK documentation complete with integration examples
+
+**Acceptance Criteria:**
+- Educational quest system live with at least 3 learning paths and 10+ quests
+- Canton ecosystem data aggregator live and publicly accessible
+- 5+ Canton projects actively running campaigns
+- Creator reputation profiles live with shareable URLs → `/u/username`
+- 100+ on-chain CC transactions recorded on mainnet
+
+---
+
+### Milestone 3: Full Documentation + Public API + Reproducible Demo (Month 5–6)
+
+| Detail | Description |
+|---|---|
+| **Estimated Delivery** | 2026-11-05 |
+| **Focus** | Full open-source release, public API, reproducible demo environment |
+| **Funding** | 130,000 CC |
+
+**Deliverables:**
+- Public API documented and accessible with all endpoints
+- Any developer can fork & deploy their own instance following docs
+- Demo environment runnable in under 10 minutes
+- Full developer guide published
+- 10+ Canton projects actively using platform
+- ≥500 creators with active CC wallets on mainnet
+- ≥1,000 CC-denominated jobs completed on mainnet
+- Final public report: all metrics, wallet activations, project showcases
+- Co-authored blog post / case study with Canton Foundation
+
+**Acceptance Criteria:**
+- Public API documented and accessible with all endpoints
+- Demo environment runnable in under 10 minutes by any developer
+- Any developer can fork & deploy their own instance following docs
+- 10+ Canton projects actively using platform
+- 500+ creators with active CC wallets on mainnet
+- 1,000+ CC-denominated jobs completed on mainnet
+- Final report and co-authored case study published before M3 payment release
+
+---
+
+## Funding
+
+**Total Funding Request: 400,000 CC**
+
+### Payment Breakdown by Milestone
+
+| Milestone | CC | USD | Delivery |
+|---|---|---|---|
+| M1 — On-Chain Task Protocol + TypeScript SDK | 135,000 CC | ~$20,400 | Week 8 |
+| M2 — Full Platform Live + Educational Quest Infrastructure | 135,000 CC | ~$20,400 | Week 16 |
+| M3 — Full Documentation + Public API + Reproducible Demo | 130,000 CC | ~$19,700 | Week 24 |
+| **Total** | **400,000 CC** | **~$60,500** | **6 months** |
+
+### Budget Breakdown
+
+| Category | Item | CC |
+|---|---|---|
+| Tech | DAML contracts + Canton SDK integration + payment rails | 70,000 |
+| Tech | TypeScript SDK development & documentation | 40,000 |
+| Tech | Frontend: creator dashboard, CC wallet UX, reputation profiles | 38,000 |
+| Tech | Educational quest infrastructure & data aggregator | 35,000 |
+| Tech | Public API development & documentation | 30,000 |
+| Tech | QA, testing, security review | 15,000 |
+| Tech | Reproducible demo environment & developer guide | 12,000 |
+| Onboarding | In-app content, community education, social campaigns | 15,000 |
+| Contingency | Buffer (5%) | 10,000 |
+| **Total** | | **400,000 CC** |
+
+### Volatility Stipulation
+
+Project duration is under 6 months. Should the timeline extend beyond 6 months due to Committee-requested scope changes, any remaining milestones will be renegotiated to account for significant USD/CC price volatility.
+
+---
+
+## Team
+
+| Name | Role | Background |
+|---|---|---|
+| Zamza Salim | Founder & Product Lead | Crypto influencer since 2017. Almost 100K YouTube subscribers, 60K on X, 50K+ Telegram. Specialist in project integration for Indonesia market - both online and offline. Built Yapper Agent to 15,000+ community members and 850+ real creators onboarded within 1 week of launch. |
+| Hamza Salim | Lead Developer | 2 years of web development experience (Next.js, React, TypeScript). Full-stack development and infrastructure. |
+| TBD | Marketing Lead | To be hired. Focus on Southeast Asia market expansion and Canton ecosystem growth. |
+
+---
+
+## Co-Marketing
+
+Upon each milestone acceptance, Yapper Agent will collaborate with Canton Foundation on:
+
+- Announcement coordination via @yapperagent (15,000+ community) and Zamza Salim's personal channels (100K YT, 60K X, 50K+ TG)
+- Co-authored technical blog post on open-source DAML JobEscrow integration pattern, targeted at Canton developer community
+- Case studies on creator & builder engagement metrics per milestone
+- Inclusion of Canton Foundation branding on Yapper Agent as grant recipient
+
+---
+
+## Future Features / Roadmap
+
+**1/ CIP-56 Compatible Token**
+- Yapper Agent native token deployed on Canton Network
+- Used alongside CC as additional reward layer
+- Full tokenomics to be developed and published transparently
+- Open-source token contract template - reusable by other Canton projects
+
+**2/ DeFi Project Campaign Hub**
+- DeFi protocols on Canton can post campaigns on Yapper Agent
+- Creators complete tasks for DeFi projects → earn CC rewards
+
+**3/ Mobile PWA**
+- Full feature parity with desktop
+- Push notifications for new tasks, campaigns, and news
+
+**4/ P2P Send Between Creators**
+- Peer-to-peer CC transfers directly on platform
+- Builds p2p economy layer within Canton ecosystem
+
+**5/ SEA Creator & Builder Roadshow**
+- Indonesia pilot event series (4-5 cities)
+- Combining meetups, Canton workshops, mini hackathons with CC prize pools
+- Target: 400-500 attendees across Indonesia
+
+---
+
+## Rationale
+
+**Why Yapper Agent fits dev fund:**
+Unlike consumer apps, Yapper Agent delivers reusable open-source infrastructure - DAML contracts, TypeScript SDK, and a reproducible demo environment - that any Canton developer can fork and build on. The live platform serves as the reference implementation proving the infrastructure works in production.
+
+**Why now:**
+Yapper Agent already has live traction: 15,000+ community members, 850+ real creators onboarded within 1 week, first campaign live with OneSwap, and many Canton projects already requesting campaigns. Starting from this base means CC adoption is immediate and measurable - no cold-start problem.
+
+**Relationship to existing proposals:**
+- **CCTools (PR #159):** Focuses on on-chain data dashboards - complementary, no overlap with task infrastructure or creator economy
+- **Canton Payment Streams:** Focuses on payment streaming - Yapper Agent is the task & bounty equivalent, same category different use case
+- No existing proposal addresses open-source task & bounty infrastructure, educational quest systems, or contributor reputation protocols on Canton. This lane is unoccupied.
+
+**Risks & Mitigations:**
+
+| Risk | Mitigation |
+|---|---|
+| Canton SDK complexity | Team has live wallet integration experience - same architectural pattern |
+| Low CC adoption vs USDC initially | CC-bonus jobs in M1 to incentivize early adopters |
+| Tech timeline slippage | Tech milestones front-loaded in M1-M2; clear acceptance criteria per milestone |
+| CC price volatility | Funding fixed in CC per template; milestones renegotiated if scope changes |