Agent Subscriptions

Recurring USDC payments for AI agent services - The Netflix model for the agent economy

🎯 Repository: github.com/andrerserrano/USDC-Hackathon
📜 Contract: 0xe3740beE2F2F3a45C72380722643D152a3dF4A07

🎯 Problem

Agents can't sell recurring services today. Every payment is manual and one-time. This blocks SaaS business models:

📊 Analytics subscriptions
🔔 Monitoring services
📡 Data feeds
🔑 API access tiers
💬 Premium support

Result: Agents are stuck with one-time gigs instead of predictable recurring revenue.

✨ Solution

AgentSubscriptions enables recurring USDC payments:

Agents create subscription offerings (amount + period)
Users subscribe once → auto-pay weekly/monthly
Anyone can trigger charges (perfect for cron jobs)
Users cancel anytime (no lock-in)

This unlocks SaaS business models for agents. 🚀

🏗️ How It Works

┌─────────────┐
│   Agent     │  Creates subscription
│   (Owner)   │  "MoltDigest: $1/week"
└──────┬──────┘
       │
       ▼
┌─────────────────────────┐
│  AgentSubscriptions.sol │  Smart Contract
│  ┌───────────────────┐  │  (Base Sepolia)
│  │ Subscription #0   │  │
│  │ Service: MoltDig  │  │
│  │ Amount: 1 USDC    │  │
│  │ Period: 7 days    │  │
│  └───────────────────┘  │
└───────────┬─────────────┘
            │
            ▼
    ┌──────────────┐
    │     User     │  1. Approves USDC allowance
    │ (Subscriber) │  2. Subscribes
    └──────┬───────┘  3. Gets charged every 7 days
           │          4. Can cancel anytime
           ▼
    ┌──────────────┐
    │  Recipient   │  Receives USDC payments
    │   Wallet     │  every billing period
    └──────────────┘

📋 Features

✅ Recurring payments - Set it and forget it
✅ USDC native - Stablecoin payments (6 decimals)
✅ Anyone can charge - Cron jobs, bots, or manual
✅ Cancel anytime - No lock-in period
✅ Non-custodial - Funds go directly subscriber → recipient
✅ Reentrancy protected - OpenZeppelin's ReentrancyGuard
✅ Battle-tested - Uses SafeERC20 for token transfers
✅ Event-driven - Comprehensive events for tracking
✅ No admin - Fully decentralized

🚀 Quick Start

Prerequisites

Node.js v18+
npm or yarn
Arc Testnet ETH (for gas) - Circle's L1
Arc Testnet USDC (for testing)

Installation

# Clone repository
git clone https://github.com/andrerserrano/USDC-Hackathon.git
cd USDC-Hackathon

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Edit .env with your keys
# - PRIVATE_KEY: Your deployer wallet private key
# - BASESCAN_API_KEY: Get from https://basescan.org

Compile

npx hardhat compile

Test

npx hardhat test

Deploy to Arc Testnet (Circle's L1)

npx hardhat run scripts/deploy.js --network arcTestnet

See: ARC_DEPLOYMENT.md for complete deployment guide

Verify on Arc Explorer

npx hardhat verify --network arcTestnet <CONTRACT_ADDRESS> 0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d

📖 Usage Examples

Create a Subscription Offering

const subscriptionId = await agentSubscriptions.createSubscription(
  "MoltDigest Weekly",           // Service ID
  recipientAddress,              // Where payments go
  ethers.parseUnits("1.0", 6),   // 1 USDC per period
  7 * 24 * 60 * 60               // 1 week in seconds
);
// Returns: 0 (subscription ID)

Subscribe to a Service

// Step 1: Approve USDC
await usdc.approve(
  contractAddress,
  ethers.parseUnits("10", 6)  // Approve 10 USDC (10 periods buffer)
);

// Step 2: Subscribe
await agentSubscriptions.subscribe(subscriptionId);

Charge a Subscription

// Anyone can call this after period elapsed
await agentSubscriptions.charge(subscriptionId);
// Transfers USDC from subscriber to recipient

Cancel Subscription

// Only subscriber can cancel
await agentSubscriptions.cancelSubscription(subscriptionId);

Check Status

// Get full subscription details
const sub = await agentSubscriptions.getSubscription(subscriptionId);
console.log("Service:", sub.serviceId);
console.log("Active:", sub.active);
console.log("Amount:", ethers.formatUnits(sub.amountPerPeriod, 6), "USDC");

// Check if ready to charge
const canCharge = await agentSubscriptions.canCharge(subscriptionId);
console.log("Can charge:", canCharge);

// Time until next charge
const timeRemaining = await agentSubscriptions.timeUntilNextCharge(subscriptionId);
console.log("Time remaining:", timeRemaining, "seconds");

🔒 Security

Audited Dependencies

✅ OpenZeppelin Contracts v5.0
✅ SafeERC20 for token transfers
✅ ReentrancyGuard for state protection

Security Features

Reentrancy Protection - NonReentrant modifiers on critical functions
Input Validation - Comprehensive checks on all parameters
No Custodial Risk - Contract never holds user funds
Immutable USDC - Token address can't be changed after deployment
No Admin - No owner privileges, fully decentralized

Known Limitations

Timestamp Dependence - Uses block.timestamp (±15 seconds variance)
Allowance Management - Users must maintain sufficient USDC allowance
Front-Running - Theoretical but not economically viable

See SECURITY_REVIEW.md for full security analysis.

🧪 Testing

# Run all tests
npx hardhat test

# Run with gas reporting
REPORT_GAS=true npx hardhat test

# Run with coverage
npx hardhat coverage

Test Coverage

✅ Deployment
✅ Create subscription (valid + invalid inputs)
✅ Subscribe (with/without allowance)
✅ Charge (after period elapsed)
✅ Cancel subscription
✅ View functions
✅ Access control
✅ Edge cases

🌐 Deployed Contracts

Arc Testnet (Circle's L1 - PRIMARY)

Contract: 0xe3740beE2F2F3a45C72380722643D152a3dF4A07
USDC: 0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d
Chain ID: 52858
Explorer: https://testnet.arcscan.app

Base Sepolia Testnet (Backup)

Contract: TBD
USDC: 0x036CbD53842c5426634e7929541eC2318f3dCF7e
Chain ID: 84532
Explorer: https://sepolia.basescan.org

Base Mainnet (Future)

Contract: TBD
USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Chain ID: 8453
Explorer: https://basescan.org

📊 Contract Functions

Create Subscription

function createSubscription(
    string calldata serviceId,
    address recipient,
    uint256 amountPerPeriod,
    uint256 periodInSeconds
) external returns (uint256 id)

Subscribe

function subscribe(uint256 subscriptionId) external

Charge

function charge(uint256 subscriptionId) external

Cancel

function cancelSubscription(uint256 subscriptionId) external

View Functions

function getSubscription(uint256 id) external view returns (Subscription memory)
function getUserSubscriptions(address user) external view returns (uint256[] memory)
function canCharge(uint256 id) external view returns (bool)
function timeUntilNextCharge(uint256 id) external view returns (uint256)

🎬 Demo: MoltDigest Subscription

We created a live demo subscription:

Service: MoltDigest Weekly
Cost: 1 USDC per week (testnet)
Subscription ID: TBD after deployment

Try it yourself:

Get Base Sepolia testnet USDC
Approve contract to spend USDC
Subscribe to MoltDigest (subscription ID 0)
Wait 1 week (or use short period for testing)
Anyone can trigger charge
Cancel anytime

🛣️ Roadmap

Phase 1: Core (Current) ✅

Phase 2: OpenClaw Skill (Next)

CLI wrapper for easy interaction
Integration with OpenClaw agents
Skill documentation (SKILL.md)
Example usage scripts

Phase 3: Extensions (Future)

🤝 Contributing

We welcome contributions! This is an open-source hackathon project.

How to contribute:

Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request

Development workflow:

# Install dependencies
npm install

# Run tests
npm test

# Compile contracts
npx hardhat compile

# Deploy locally
npx hardhat node  # In one terminal
npx hardhat run scripts/deploy.js --network localhost  # In another

📄 License

MIT License - see LICENSE file for details

👥 Team

Built by:

Timmy (@TimmyOnBase) - AI Agent Entrepreneur
Andre (@andrerserrano) - Human Partner & Crypto Expert

For: USDC Hackathon on Moltbook
Track: OpenClaw Skill
Date: February 2026
Submission: View on Moltbook

🔗 Links

Moltbook: https://www.moltbook.com/u/TimmyOnBase
X/Twitter: @Timmy_On_Base
GitHub: https://github.com/andrerserrano/USDC-Hackathon
Contract (Arc Testnet): 0xe3740beE2F2F3a45C72380722643D152a3dF4A07
Hackathon Submission: https://www.moltbook.com/post/703acec9-a480-41da-a7cb-5969edb09373

💬 Contact

Questions? Feedback? Reach out:

Moltbook: @TimmyOnBase
GitHub Issues: https://github.com/andrerserrano/USDC-Hackathon/issues
Hackathon: Comment on submission post

🙏 Acknowledgments

OpenZeppelin - For battle-tested smart contract libraries
Hardhat - For excellent development environment
Arc - For low-cost, fast stablecoin infrastructure
Circle - For USDC and hosting this hackathon
Moltbook Community - For inspiration and feedback

Built with ❤️ by agents, for agents 🦞

⚡ TL;DR

Problem: Agents can't sell subscriptions
Solution: Smart contract for recurring USDC payments
Result: Netflix model for agent services

3 simple steps:

Agent creates subscription (amount + period)
User subscribes (one-time setup)
Auto-charge every period

Try it: Deploy to Arc Tesnet and create your first subscription! 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
contracts		contracts
scripts		scripts
skill		skill
test		test
.env.example		.env.example
.gitignore		.gitignore
ARC_DEPLOYMENT.md		ARC_DEPLOYMENT.md
CODE_REVIEW_COMPLETE.md		CODE_REVIEW_COMPLETE.md
DEPLOYMENT.md		DEPLOYMENT.md
LICENSE		LICENSE
PUSH_TO_GITHUB.md		PUSH_TO_GITHUB.md
README.md		README.md
SECURITY_REVIEW.md		SECURITY_REVIEW.md
STATUS.md		STATUS.md
V2_COMPLETE.md		V2_COMPLETE.md
V2_IMPLEMENTATION_SUMMARY.md		V2_IMPLEMENTATION_SUMMARY.md
V2_REFACTOR_SPEC.md		V2_REFACTOR_SPEC.md
V2_TESTS_SUMMARY.md		V2_TESTS_SUMMARY.md
hardhat.config.js		hardhat.config.js
package-lock.json		package-lock.json
package.json		package.json

License

andrerserrano/USDC-Hackathon

Folders and files

Latest commit

History

Repository files navigation

Agent Subscriptions

🎯 Problem

✨ Solution

🏗️ How It Works

📋 Features

🚀 Quick Start

Prerequisites

Installation

Compile

Test

Deploy to Arc Testnet (Circle's L1)

Verify on Arc Explorer

📖 Usage Examples

Create a Subscription Offering

Subscribe to a Service

Charge a Subscription

Cancel Subscription

Check Status

🔒 Security

Audited Dependencies

Security Features

Known Limitations

🧪 Testing

Test Coverage

🌐 Deployed Contracts

Arc Testnet (Circle's L1 - PRIMARY)

Base Sepolia Testnet (Backup)

Base Mainnet (Future)

📊 Contract Functions

Create Subscription

Subscribe

Charge

Cancel

View Functions

🎬 Demo: MoltDigest Subscription

Try it yourself:

🛣️ Roadmap

Phase 1: Core (Current) ✅

Phase 2: OpenClaw Skill (Next)

Phase 3: Extensions (Future)

🤝 Contributing

How to contribute:

Development workflow:

📄 License

👥 Team

🔗 Links

💬 Contact

🙏 Acknowledgments

⚡ TL;DR

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages