https://github.com/theointech/onlypens-xyz
Hire the voice behind the fame. Where influence is crafted — and protected — trustlessly.
https://github.com/theointech/onlypens-xyz
blockchain creators ghostwriter solidity web3
Last synced: about 2 months ago
JSON representation
Hire the voice behind the fame. Where influence is crafted — and protected — trustlessly.
- Host: GitHub
- URL: https://github.com/theointech/onlypens-xyz
- Owner: TheoInTech
- Created: 2025-04-27T01:23:55.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-07T05:36:21.000Z (about 1 year ago)
- Last Synced: 2025-05-07T06:49:50.515Z (about 1 year ago)
- Topics: blockchain, creators, ghostwriter, solidity, web3
- Language: TypeScript
- Homepage: https://onlypens.xyz/
- Size: 12.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ✍️ OnlyPens.xyz
**OnlyPens.xyz** is a decentralized ghostwriting matchmaking app tailored for creators. It connects creators with skilled ghostwriters, ensuring trustless transactions through smart contracts and enhancing user experience with AI-driven matchmaking.
---
## 🚀 MVP Scope
### 🎯 Core Features
- **User Authentication**: Wallet connect using Coinbase Smart Wallet.
- **Role Selection**: Users choose to be either a Creator or a Ghostwriter.
- **Gig Creation**: Create gig packages with an AI-assisted pricing and start inviting the best-matched ghostwriters
- **Dashboard**:
- _creators_:
- Post new gigs in packages (e.g. 2 Thread, 4 short-post, 4 image caption).
- View and manage submitted drafts.
- Approve submissions and release payments.
- _ghostwriters_:
- Accept gig invitations from creators
- Submit drafts for accepted gigs.
- Track earnings.
- **AI-Powered Tone Matching**:
- creators provide sample content to capture their unique tone.
- AI analyzes these samples to match them with ghostwriters whose writing style aligns closely.
- This ensures content authenticity and maintains the influencer's brand voice.
- **Escrow System**: Funds are held in a smart contract and released upon approval of work.
- **Yield-Bearing Escrow**: Integrate with Base's Earn component to allow escrowed funds to generate yield until released.
### 🛠️ Tech Stack
- **Frontend**: Next.js, Zod, Mantine UI
- **Backend**: Firebase's Firestore (for storing gigs metadata and AI matchmaking data)
- **Blockchain**: Base network
- **Smart Contracts**: Solidity (using Hardhat for development and deployment)
- **Indexing**: TheGraph Protocol's Subgraph
---
## 🌱 Future Enhancements
- **Long-Term Collaborations**: Enable creators to establish ongoing relationships with preferred ghostwriters aside from just a per-gig engagement.
- **Content Revision System**: Implement a structured revision process allowing creators to request changes and ghostwriters to submit updated versions.
- **Version History**: Maintain a comprehensive version history of all content, enabling easy comparison between drafts and tracking of changes.
- **Notification System**: Implement a comprehensive notification system to alert ghostwriters about new opportunities:
- Real-time notifications for gig invitations and brief matches.
- Email notifications for important updates and new opportunities.
- In-app notification center to track all communications.
- Customizable notification preferences allowing users to filter by opportunity type, budget range, and urgency.
- Push notifications for mobile users to ensure timely responses to time-sensitive opportunities.
- **Reputation System**: Implement on-chain reputation scores for both creators and ghostwriters.
- **Commission-based Payments**: Implement a flexible royalty system allowing creators to offer ghostwriters a percentage of revenue generated from content, enabling profit-sharing arrangements alongside or instead of fixed payments.
- **Improved AI Matchmaking with Vector**: Improve matchmaking algorithms using advanced AI models and vector databases.
---
## 🔗 Base Integration
### 🧠 Smart Wallet
Utilize Base's Smart Wallet for seamless and secure user authentication.
- **Features**:
- No need for browser extensions or separate apps.
- Enhanced security with passkeys.
- Simplified user onboarding.
_Reference_: [Base Smart Wallet Documentation](https://docs.base.org/identity/smart-wallet/concepts/what-is-smart-wallet)
### 💰 Smart Contracts
Develop and deploy smart contracts on the Base network using Hardhat and Solidity.
- **Use Cases**:
- Escrow contracts to hold payments.
- Automated release of funds upon approval.
- Integration with yield-generating vaults.
_Reference_: [Deploying Smart Contracts with Hardhat](https://docs.base.org/cookbook/smart-contract-development/hardhat/deploy-with-hardhat)
---
## 📜 Smart Contracts
The OnlyPens platform utilizes the following smart contracts:
#### Sepolia Testnet
| Contract Name | Contract Address | Description |
| ------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| OnlyPensHelpers | 0xbde1F236a030a0257ef83c43F289FE5107Ae9c74 | Library contract containing helper functions for deliverable validation and other utility operations |
| OnlyPens (Implementation) | 0x8d7c222d2F0D8bf9ceFbA02Cd01ab46C47C33062 | Core contract containing the business logic for gig management, deliverables, and payment release |
#### Mainnet
| Contract Name | Contract Address | Description |
| ------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| OnlyPensHelpers | 0x91F5D7107B919f6566694ec649583Eb42d6E40eA | Library contract containing helper functions for deliverable validation and other utility operations |
| OnlyPens (Implementation) | 0x88566d8202EaD5a6D6b96E4a37A1D197f0d94BC4 | Core contract containing the business logic for gig management, deliverables, and payment release |
---
_Note: This project is currently in its MVP stage. Features and integrations are subject to change as development progresses._