[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92305":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":13,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":17,"hasPages":17,"topics":19,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":13,"starSnapshotCount":13,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},92305,"Inktoll","mrnetwork0001\u002FInktoll","mrnetwork0001","A decentralized micro-settlement protocol enabling autonomous AI agents to pay publishers for premium content via Circle Programmable Wallets and x402 nanopayments.","https:\u002F\u002Finktoll.xyz",null,"TypeScript",62,0,11,4,37.4,false,"main",[20,21,22,23],"ai-agents","circle-wallets","monetization","web3","2026-07-22 04:02:05","# Inktoll Protocol\n> **Gasless Micropayment & Citation Settlement Highway for the Agentic Web3 Knowledge Economy**\n\nBuilt with **Circle Programmable Wallets**, **Circle Gateway Nanopayments**, and settled on the **Arc Testnet** (USDC-native gas chain) for sub-second, frictionless machine-to-human payments.\n\n\u003Cimg width=\"1661\" height=\"923\" alt=\"05 07 2026_09 00 52_REC\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fee2e6132-b02f-4b7c-9cd4-cf49bc9f7403\" \u002F>\n\n\n---\n\n## The Vision & Problem\nLarge Language Models (LLMs) and autonomous AI agents are crawling the web and consuming creators' valuable content for free. In response, publishers are implementing paywalls, putting up aggressive robots.txt blocks, and fracturing the open web. \n\n**Inktoll solves this crisis by introducing a two-layer machine-to-creator payment protocol:**\n*   **Layer 1: Pay-Per-Read:** Autonomous AI agents discover monetize-ready articles via standard RSS feeds, evaluate content relevance using LLMs, and pay creators instantly in USDC for per-article read access.\n*   **Layer 2: Citation Tolls:** When agents retrieve knowledge from previously purchased articles to answer human user questions, the protocol detects the semantic citation and routes an automatic **Citation Toll ($0.0001 USDC)** to the creator's wallet.\n\nInktoll turns content consumption into a functioning Web3 micro-economy where creators get paid directly, agents read legally, and developers operate gaslessly.\n\n---\n\n## Key Innovations (Hackathon Highlights)\n\n### \"Proof of Authorship\" Verification Badge\nTo combat plagiarism and ensure secure compensation, Inktoll guarantees 100% of the USDC goes directly to the original creator. Every article in the Reader Feed and Creator Dashboard displays a verified status badge. Unlike competitors that let anyone paste any random URL to hijack revenue, Inktoll relies on secure API handshakes with the creator's platform (such as Ghost) to verify ownership.\n\n### State-of-the-Art Onboarding Tour (Joyride)\nTo bridge the Web2-to-Web3 divide for creators, the Inktoll Dashboard includes a fully interactive, native **Onboarding Guide** built with React Joyride. The tour highlights and explains complex Web3 elements like the difference between *All-Time Earnings* and *Claimable Balance*, how the *Sync Gateway* operates, and how to withdraw funds on the Arc L1 network, ensuring any traditional blogger feels immediately at home.\n\n### Agent Personas & \"Top Spender\" Leaderboards\nWe brought the AI economy to life! Rather than treating AI agents as invisible scripts, Inktoll features a **Top Agent Fans** leaderboard in the Creator Dashboard. Real autonomous reader agents (e.g., `Agent_B2A9`) are ranked dynamically based on how much USDC they have spent unlocking content and citing works. This makes the abstract concept of a \"Machine-to-Machine Economy\" tangible, social, and extremely engaging.\n\n### Emergent Agentic Swarm Protocol\nTo max out Agentic Sophistication, our agents don't just execute linear scripts - they exhibit **Decentralized Machine Consensus**. If one agent reads an article and scores it highly (> 85\u002F100 relevance), it autonomously broadcasts a signal to a decentralized Gossip Network. Other listening agents will immediately detect this alpha signal, swarm the target URL, and trigger a cascading spike of gasless USDC payments to the creator without any human intervention.\n\n### Zero-Gas Nanopayments via Circle Gateway\nWe integrated the **Circle Gateway** to batch gasless off-chain payment authorizations (EIP-3009 \u002F ERC-20 transfers). This achieves sub-cent transactions ($0.001) with **zero gas fees** for the user, net-settling batches efficiently on the Arc L1 Testnet.\n\n### State-of-the-Art Glassmorphism UX\nThe Inktoll Dashboard isn't just functional; it's a visual experience. Built with Next.js and Framer Motion, it features a dark futuristic aesthetic, staggered micro-animations, animated 3D tracking cards, and customized Lucide React icons replacing standard emojis for a premium Web3 infrastructure feel.\n\n---\n\n## Content Platform Integrations\n\nInktoll fits into a creator's existing workflow by pulling content directly from where they already publish:\n\n*   🟢 **Ghost (LIVE & Fully Integrated)**: Creators can onboard instantly by pasting their blog URL and Content API Key. Inktoll securely syncs and indexes their feed gaslessly.\n*   🔵 **X (Twitter) (30% Developed - In Progress)**: A strategic roadmap milestone. Utilizing X OAuth 2.0 and X API v2, creators will be able to stitch together their high-value Twitter threads and monetize social media insights for AI agents.\n*   🟡 **WordPress (Coming Soon)**: Integration with the WP REST API v2.\n*   🟡 **Substack (Coming Soon)**: Integration with Substack RSS syndication.\n\n---\n\n## Circle Tool Usage & Tech Stack\n*   **Circle App Kit & Programmable Wallets**: Frictionless Web2 onboarding for Creators with zero seed-phrases. Creators can log in via **Email OTP (Magic Links)** or **Biometric Passkeys (Smart Accounts)** - making Web3 completely invisible.\n*   **Circle Gateway & Unified Balances**: We integrated the Circle Gateway to pool liquidity and hold unified USDC balances. Agents automatically use `depositFor` to deposit base USDC into the Gateway smart contract, enabling instant, cross-chain gasless nanopayments.\n*   **Circle Developer-Controlled Wallets**: Secure, programmatic Web3 identity and custodial capabilities for our backend, handling real-time splits on Arc Testnet (routing 99% to creators and a 1% protocol fee to the Inktoll Treasury) upon withdrawal.\n*   **Smart Contracts on Arc L1**: We deploy payment logic directly on the Arc Testnet, utilizing USDC as the native gas token for sub-second finality.\n*   **x402 Protocol**: We implement HTTP 402 \"Payment Required\" flows tailored for AI agent execution, creating an autonomous M2M content handshake.\n*   **USDC**: The native settlement layer of the protocol, ensuring creators are paid in a universally pegged, stable asset.\n*   **AI & Logic Layer**: LangChain and OpenAI `gpt-4o-mini` drive the agent's autonomous relevance scoring and emergent swarm discovery.\n*   **Frontend & Database**: Built using Next.js 16, Vanilla CSS, `framer-motion`, and a SQLite ledger.\n\n---\n\n## Protocol Architecture\n\n### 1. Layer 1: Pay-Per-Read Flow\n```mermaid\nsequenceDiagram\n    participant RSS as Creator RSS Feed\n    participant Agent as AI Reader Agent\n    participant LLM as OpenAI (Evaluation)\n    participant Gateway as Circle Paymaster Gateway\n    participant Chain as Arc L1 Blockchain\n    participant Creator as Creator Wallet\n\n    Agent->>RSS: 1. Poll feed for new articles\n    RSS-->>Agent: Returns article slugs, prices, & wallets\n    Agent->>LLM: 2. Submit preview text & interests\n    LLM-->>Agent: Score relevance (0-100) & decision\n    Note over Agent: Relevance score exceeds threshold?\n    Agent->>Gateway: 3. Sign EIP-3009 gasless authorization\n    Gateway->>Chain: 4. Batch & settle transfer onchain\n    Chain-->>Creator: 5. Transmit per-article USDC payment\n    Chain-->>Agent: 6. Settle tx & unlock full content\n```\n\n### 2. Layer 2: Citation Tolls Flow\n```mermaid\nsequenceDiagram\n    participant User as Human User\n    participant Agent as Ask Agent QA\n    participant DB as Vector Embeddings (SQLite)\n    participant Gateway as Circle Gateway\n    participant Creator as Creator Wallet\n\n    User->>Agent: 1. Ask a question\n    Agent->>DB: 2. Scan purchased articles for semantic match\n    DB-->>Agent: Returns similarity scores & citation metadata\n    Agent->>Gateway: 3. Trigger gasless Citation Toll ($0.0001 USDC)\n    Gateway-->>Creator: 4. Credit creator wallet instantly\n    Agent-->>User: 5. Return answer with active citation credit\n```\n\n---\n\n## Project Structure\n```bash\n├── dashboard\u002F      # Next.js web dashboard (Creator Hub, Reader Setup, Leaderboard, Ask Agent)\n├── server\u002F         # Node\u002FExpress backend SQLite ledger & RSS feed generator\n├── agent\u002F          # Autonomous AI Reader Agent runtime & microservices\n└── .env            # Shared environment variables\n```\n\n---\n\n## Getting Started (Local Setup)\n\n### 1. Prerequisites\nCreate a `.env` file in the root directory by copying the template:\n```bash\n# Server Port Configuration\nPORT=3001\nAGENT_PORT=3002\n\n# API Access\nOPENAI_API_KEY=your_openai_api_key\nCIRCLE_API_KEY=your_circle_api_key\n\n# Settlement Configuration (Arc Testnet)\nARC_RPC_URL=https:\u002F\u002Frpc.testnet.arc.network\nARC_USDC_ADDRESS=0x3600000000000000000000000000000000000000\nFAUCET_PRIVATE_KEY=your_faucet_private_key_with_usdc\n```\n\n### 2. Install & Start Server\n```bash\n# Navigate to backend server\ncd server\nnpm install\nnpm run build\nnpm start\n```\n*   *Server runs at `http:\u002F\u002Flocalhost:3001`*\n\n### 3. Install & Start AI Reader Agent\n```bash\n# Navigate to Agent client\ncd ..\u002Fagent\nnpm install\nnpm run build\nnpm start\n```\n*   *Agent microservice runs at `http:\u002F\u002Flocalhost:3002`*\n\n### 4. Install & Start Web Dashboard\n```bash\n# Navigate to Dashboard web app\ncd ..\u002Fdashboard\nnpm install\nnpm run build\nnpm start -- -p 3005\n```\n*   *Dashboard is live at `http:\u002F\u002Flocalhost:3005`*\n\n### 5. Production Deployment (VPS)\nWe include an `ecosystem.config.js` file for seamless production deployments on a VPS.\n```bash\nnpm install -g pm2\npm2 start ecosystem.config.js\n```\n*This spins up both the Backend Server and Autonomous Agent Loop as robust background daemons keeping them online 24\u002F7.*\n\n---\n\n## License\nMIT License. Created by [MrNetwork](https:\u002F\u002Fx.com\u002Fencrypt_wizard). Built for the Lepton Agents Hackathon by TheCanteen.\n","Inktoll 是一个去中心化的微结算协议，旨在让自主AI代理通过Circle可编程钱包和x402纳米支付，向内容发布者自动支付优质内容费用。其核心功能包括“按阅读付费”（Pay-Per-Read）和“引用过路费”（Citation Toll），支持亚秒级、零Gas的USDC结算，并基于Arc测试网运行；采用Proof of Authorship机制验证内容所有权，确保收益直达原创作者。适用于Web3内容经济、AI代理合规内容获取、创作者变现及机器对人类的知识服务结算等场景。",2,"2026-07-08 04:30:02","CREATED_QUERY"]