{"id":27935620,"url":"https://github.com/theointech/onlypens-xyz","last_synced_at":"2026-04-25T23:37:40.221Z","repository":{"id":290291347,"uuid":"973433155","full_name":"TheoInTech/onlypens-xyz","owner":"TheoInTech","description":"Hire the voice behind the fame. Where influence is crafted — and protected — trustlessly.","archived":false,"fork":false,"pushed_at":"2025-05-07T05:36:21.000Z","size":13219,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T06:49:50.515Z","etag":null,"topics":["blockchain","creators","ghostwriter","solidity","web3"],"latest_commit_sha":null,"homepage":"https://onlypens.xyz/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheoInTech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-27T01:23:55.000Z","updated_at":"2025-04-29T04:07:40.000Z","dependencies_parsed_at":"2025-05-05T04:23:20.746Z","dependency_job_id":null,"html_url":"https://github.com/TheoInTech/onlypens-xyz","commit_stats":null,"previous_names":["theointech/onlypens-xyz"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoInTech%2Fonlypens-xyz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoInTech%2Fonlypens-xyz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoInTech%2Fonlypens-xyz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheoInTech%2Fonlypens-xyz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheoInTech","download_url":"https://codeload.github.com/TheoInTech/onlypens-xyz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252831189,"owners_count":21810780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","creators","ghostwriter","solidity","web3"],"created_at":"2025-05-07T06:49:53.263Z","updated_at":"2026-04-25T23:37:40.208Z","avatar_url":"https://github.com/TheoInTech.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✍️ OnlyPens.xyz\n\n**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.\n\n---\n\n## 🚀 MVP Scope\n\n### 🎯 Core Features\n\n- **User Authentication**: Wallet connect using Coinbase Smart Wallet.\n- **Role Selection**: Users choose to be either a Creator or a Ghostwriter.\n- **Gig Creation**: Create gig packages with an AI-assisted pricing and start inviting the best-matched ghostwriters\n- **Dashboard**:\n  - _creators_:\n    - Post new gigs in packages (e.g. 2 Thread, 4 short-post, 4 image caption).\n    - View and manage submitted drafts.\n    - Approve submissions and release payments.\n  - _ghostwriters_:\n    - Accept gig invitations from creators\n    - Submit drafts for accepted gigs.\n    - Track earnings.\n- **AI-Powered Tone Matching**:\n  - creators provide sample content to capture their unique tone.\n  - AI analyzes these samples to match them with ghostwriters whose writing style aligns closely.\n  - This ensures content authenticity and maintains the influencer's brand voice.\n- **Escrow System**: Funds are held in a smart contract and released upon approval of work.\n- **Yield-Bearing Escrow**: Integrate with Base's Earn component to allow escrowed funds to generate yield until released.\n\n### 🛠️ Tech Stack\n\n![OnlyPens Tech Stack](https://github.com/TheoInTech/onlypens-xyz/blob/hackathon-mvp/web/public/assets/techstack.png?raw=true)\n\n- **Frontend**: Next.js, Zod, Mantine UI\n- **Backend**: Firebase's Firestore (for storing gigs metadata and AI matchmaking data)\n- **Blockchain**: Base network\n- **Smart Contracts**: Solidity (using Hardhat for development and deployment)\n- **Indexing**: TheGraph Protocol's Subgraph\n\n---\n\n## 🌱 Future Enhancements\n\n- **Long-Term Collaborations**: Enable creators to establish ongoing relationships with preferred ghostwriters aside from just a per-gig engagement.\n- **Content Revision System**: Implement a structured revision process allowing creators to request changes and ghostwriters to submit updated versions.\n- **Version History**: Maintain a comprehensive version history of all content, enabling easy comparison between drafts and tracking of changes.\n- **Notification System**: Implement a comprehensive notification system to alert ghostwriters about new opportunities:\n  - Real-time notifications for gig invitations and brief matches.\n  - Email notifications for important updates and new opportunities.\n  - In-app notification center to track all communications.\n  - Customizable notification preferences allowing users to filter by opportunity type, budget range, and urgency.\n  - Push notifications for mobile users to ensure timely responses to time-sensitive opportunities.\n- **Reputation System**: Implement on-chain reputation scores for both creators and ghostwriters.\n- **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.\n- **Improved AI Matchmaking with Vector**: Improve matchmaking algorithms using advanced AI models and vector databases.\n\n---\n\n## 🔗 Base Integration\n\n### 🧠 Smart Wallet\n\nUtilize Base's Smart Wallet for seamless and secure user authentication.\n\n- **Features**:\n  - No need for browser extensions or separate apps.\n  - Enhanced security with passkeys.\n  - Simplified user onboarding.\n\n_Reference_: [Base Smart Wallet Documentation](https://docs.base.org/identity/smart-wallet/concepts/what-is-smart-wallet)\n\n### 💰 Smart Contracts\n\nDevelop and deploy smart contracts on the Base network using Hardhat and Solidity.\n\n- **Use Cases**:\n  - Escrow contracts to hold payments.\n  - Automated release of funds upon approval.\n  - Integration with yield-generating vaults.\n\n_Reference_: [Deploying Smart Contracts with Hardhat](https://docs.base.org/cookbook/smart-contract-development/hardhat/deploy-with-hardhat)\n\n---\n\n## 📜 Smart Contracts\n\nThe OnlyPens platform utilizes the following smart contracts:\n\n#### Sepolia Testnet\n\n| Contract Name             | Contract Address                           | Description                                                                                          |\n| ------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------- |\n| OnlyPensHelpers           | 0xbde1F236a030a0257ef83c43F289FE5107Ae9c74 | Library contract containing helper functions for deliverable validation and other utility operations |\n| OnlyPens (Implementation) | 0x8d7c222d2F0D8bf9ceFbA02Cd01ab46C47C33062 | Core contract containing the business logic for gig management, deliverables, and payment release    |\n\n#### Mainnet\n\n| Contract Name             | Contract Address                           | Description                                                                                          |\n| ------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------- |\n| OnlyPensHelpers           | 0x91F5D7107B919f6566694ec649583Eb42d6E40eA | Library contract containing helper functions for deliverable validation and other utility operations |\n| OnlyPens (Implementation) | 0x88566d8202EaD5a6D6b96E4a37A1D197f0d94BC4 | Core contract containing the business logic for gig management, deliverables, and payment release    |\n\n---\n\n_Note: This project is currently in its MVP stage. Features and integrations are subject to change as development progresses._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheointech%2Fonlypens-xyz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheointech%2Fonlypens-xyz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheointech%2Fonlypens-xyz/lists"}