unsubly

Hackathon Track

Built for AlgoBharat Hack Series 3.0, targeting the Agentic Commerce track, specifically the A2A Autonomous Payments and A2A Agentic Commerce Framework categories.

About The Project

Most subscription trackers are just spreadsheets with a nicer font. They show you what you spend, but they cannot do anything about it. Unsubscribely puts your subscriptions on-chain. You lock funds in an escrow vault you own, an autonomous agent releases payments on billing day, and every transaction is verifiable on Algorand.

Here is why this is different:

• Lock funds in a smart contract vault - your keys, your control, kill switch on everything

• Agent releases vaults on billing day every 30 min on Railway, no LLM needed

• MCP Server with 12 tools - connect Claude, ChatGPT, or any AI to manage your subscriptions

• Telegram bot (@unsublyybot) - cancel by voice/text, get alerts 3 days before renewal

• Gmail auto-import - sign in with Google, we detect your subscriptions from receipts

• Tinyman DEX swap integration + Gora Oracle ALGO/USD price feeds

• Proofs on-chain cancellation proofs - immutable evidence you cancelled

Deployed contracts Algorand TestNet

Autonomous agent wallet: RVHOYLPY4L47JYCYEMCP7EMEC2AZ3HV53YHSL2ZISX6PSO5EQ6H5YVAE5U

Per-user vaults (Standard, AgentV2, Time-Lock, Multi-Sig, Dispute, ASA, Cancellation Insurance) are deployed on demand from the dashboard. MainNet singletons are not yet deployed. The app shows clear guards on mainnet for ServiceRegistry-dependent UIs.

Architecture

flowchart TD
    subgraph USER_LAYER["User Layer"]
        USER([?? User])
        WALLET[?? Pera / Defly / Lute]
        TG[?? Telegram Bot]
        CHROME[?? Chrome Extension]
    end

    subgraph APP_LAYER["Application Layer � Vercel"]
        FRONTEND[React Dashboard<br/>14 pages � Vite � Tailwind]
        API[Serverless APIs<br/>gmail-scan � mcp-token � x402]
    end

    subgraph AGENT_LAYER["Agent Layer � Railway"]
        AGENT[? Autonomous Agent<br/>14 skills � 30-min cron]
        MCP[MCP Server<br/>12 tools � Bearer auth � JSON-RPC]
    end

    subgraph BLOCKCHAIN["? Algorand TestNet"]
        VAULTS[Escrow Vaults<br/>8 contract types � TEAL v11]
        REGISTRY[ServiceRegistry<br/>A2A discovery � BoxMap]
        PROOFS[Cancellation Proofs<br/>immutable on-chain notes]
        ORACLE[Gora Oracle � ALGO/USD]
        DEX[Tinyman DEX � ASA swap]
    end

    subgraph AI_AGENTS["AI Agents"]
        CLAUDE([Claude Desktop])
        GPT([ChatGPT])
    end

    subgraph DATA["Data Layer"]
        DB[(Supabase<br/>Postgres + RLS)]
    end

    USER --> WALLET
    USER --> TG
    USER --> CHROME
    WALLET -->|sign + deploy| VAULTS
    WALLET --> FRONTEND

    FRONTEND --> API
    FRONTEND --> DB
    API --> DB

    TG -->|commands| API
    CHROME -->|detect subs| API

    AGENT -->|release � kill| VAULTS
    AGENT -->|write| PROOFS
    AGENT -->|lookup| REGISTRY
    AGENT -->|notify| TG
    AGENT --> DB

    CLAUDE -->|JSON-RPC 2.0| MCP
    GPT -->|JSON-RPC 2.0| MCP
    MCP --> AGENT

    ORACLE -.->|price feed| FRONTEND
    DEX -.->|fund vaults| VAULTS

Built With

Ecosystem Integrations

Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

• Node.js 20 or later

• A Supabase project. Create a free one at supabase.com

• Pera Wallet on Algorand Testnet. Download Pera, switch to Testnet in settings, then get free test ALGO from the Algorand Testnet Faucet

• Python 3.12 + AlgoKit - only needed if you want to recompile contracts (pre-compiled artifacts are already included)

  pip install algokit

Installation

1. Clone the repo

   git clone https://github.com/devndesigner6/unsubly.git
   cd unsubly

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env

   Open .env.example first - every variable is documented with comments and a generation command. At minimum fill in:

   • VITE_SUPABASE_URL and VITE_SUPABASE_PUBLISHABLE_KEY from Supabase, Settings, API

   • SUPABASE_SERVICE_ROLE_KEY from Supabase, Settings, API (service_role key)

   • CEREBRAS_API_KEY from cloud.cerebras.ai - powers AI Chat page and Telegram bot

   • AGENT_WALLET_MNEMONIC and VITE_AGENT_WALLET_ADDRESS - generate with the one-liner in .env.example

4. Run the database schema (first time only)

   • Go to your Supabase project, SQL Editor

   • Paste the contents of supabase/migrations/FULL_SCHEMA_SETUP.sql and run it

   • This file exists at the root of the migrations folder and creates all tables, RLS policies, and indexes in one shot

5. Start the dev server

   npm run dev

   App runs at http://localhost:5000

   Mac users: port 5000 conflicts with AirPlay Receiver. Either disable AirPlay (System Settings, AirDrop & Handoff) or change the port in vite.config.ts and package.json scripts to 5001.

6. Run the test suite

   npx vitest run                          # frontend unit tests
   cd smart_contracts && pytest tests/      # smart contract tests

7. Production build and serve

   npm run build
   npm run start

The production agent is a real OpenClaw Gateway workspace, separate from the web app. OpenClaw owns the runtime and cron schedule; the existing Unsubscribely vault code is exposed through the unsubscribely_vault_monitor workspace skill.

cd agents/openclaw
npm install
npm run start

Create agents/openclaw/.env or export these values before starting:

AGENT_WALLET_MNEMONIC=your_25_word_mnemonic
SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_CHAT_ID=your_telegram_chat_id
ALGO_NETWORK=testnet
SERVICE_REGISTRY_APP_ID_TESTNET=759205676
OPENCLAW_MODEL=google/gemini-2.0-flash
OPENAI_API_KEY=your_model_provider_key

npm run start writes an OpenClaw config, seeds a recurring OpenClaw cron job named Unsubscribely vault monitor, and starts openclaw gateway run. The cron job runs every 30 minutes and tells OpenClaw to execute npm run monitor:vaults from this workspace.

For a direct deterministic check without the Gateway, run:

npm run monitor:vaults

Recompile contracts (pre-compiled artifacts are already included):

algokit compile py smart_contracts/escrow/contract.py
algokit compile py smart_contracts/agent_escrow/contract.py
algokit compile py smart_contracts/agent_escrow_v2/contract.py
algokit compile py smart_contracts/service_registry/contract.py
algokit compile py smart_contracts/time_locked/contract.py
algokit compile py smart_contracts/multi_sig/contract.py
algokit compile py smart_contracts/dispute/contract.py
algokit compile py smart_contracts/asa_escrow/contract.py

Deploy singleton contracts (requires a funded testnet account):

TESTNET_MNEMONIC="..." node scripts/deploy.js

How It Works

1. Lock - Add a subscription and deploy an escrow vault from the dashboard. Choose from 7 vault types: Standard, AgentV2, Time-Lock, Multi-Sig, Dispute, ASA, or Cancellation Insurance. Your ALGO sits in a contract you own.

2. Release - OpenClaw checks every 30 minutes. When a billing date hits, it verifies the recipient against the on-chain ServiceRegistry, checks your spending guardrails, and calls release() on the contract. Funds go directly on-chain. You get a Telegram notification with the transaction ID.

3. Prove - Mint an ARC-3 NFT receipt after each release. AgentEscrowVaultV2 also writes an immutable BillingRecord into Box Storage per cycle, giving you a full on-chain billing history.

Usage

1. Sign up at unsubly.xyz - free, no credit card.

2. Add subscriptions manually, import CSV, or sign in with Google for auto-detection.

3. Connect Pera/Defly wallet ? create an escrow vault ? fund it with ALGO.

4. Connect Telegram (@unsublyybot) in Settings for renewal alerts and voice commands.

5. The agent runs every 30 min - releases vaults on billing day, notifies you via Telegram.

6. To cancel: say "cancel spotify" in Telegram, follow instructions, reply "done" - vault killed, ALGO returned.

7. Connect your AI agent (Claude/ChatGPT) from the Connect Agent page to manage subscriptions via MCP.

Business Model

Phase 1 current - Free for users. Revenue from x402 micro-payments: external AI agents pay 0.001 ALGO per API call to access subscription data. No API keys, no subscriptions needed. Payment IS the credential.

Phase 2 post-audit - Mainnet launch. Premium MCP access ($5/mo for write+admin scope). ServiceRegistry listing fee (one-time ALGO payment for service providers to publish).

Phase 3 - B2B vault infrastructure. Companies use escrow contracts for employee subscription procurement. Agent handles vendor payments autonomously.

Target users: Indian developers and freelancers (25-35) managing 8-12 SaaS tools (Notion, GitHub, Cursor, Figma) totaling $50-150/month in USD, losing 5-7% to forex fees per transaction.

Why Algorand: 3.3s finality � sub-penny fees � ARC-4 ABI for clean contract interfaces � Box Storage for on-chain history � instant settlement without L2 complexity.

Roadmap

• Seven escrow vault types: Standard, AgentV2, Time-Lock, Multi-Sig, Dispute, ASA, Cancellation Insurance

• Autonomous agent on Railway (runs every 30 min, no LLM needed for core ops)

• Telegram bot (@unsublyybot) - voice messages, AI intent classification, cancel/keep/done commands

• Gmail auto-import - detects subscriptions from 6 months of email receipts

• MCP Server - 12 tools, Bearer auth, rate limiting, connects Claude/ChatGPT/any MCP client

• Trial-to-paid human-in-the-loop Telegram confirmation before agent releases

• Spending guardrails: monthly budget cap, blackout dates, per-subscription limits

• Algorand-flavoured x402 payment middleware (HTTP 402 + on-chain settlement)

• On-chain ServiceRegistry for A2A service discovery (5 services seeded on TestNet)

• AgentEscrowVaultV2 with Box Storage for immutable on-chain billing history

• AI Chat powered by Cerebras (gpt-oss-120b) with full subscription context

• Telegram AI chatbot with natural language subscription management

• On-chain cancellation proofs (zero-ALGO self-transfer with structured JSON note)

• Tinyman DEX integration for ASA ? ALGO swaps

• Gora Oracle price feeds (ALGO/USD) on vault cards

• NFD (.algo) name resolution on dashboard

• DB-backed idempotency locks (prevents double-release across multiple agent instances)

• Connect Agent page - one-click token generation for Claude Desktop / ChatGPT

• MainNet deployment of ServiceRegistry and AgentEscrowVaultV2 singletons

• Smart contract security audit by reputable third party before MainNet launch

• Contract upgradeability strategy (proxy pattern or governance-based upgrades)

• Mobile app using Expo with Pera Wallet deep-link support

• Multi-currency ASA support (USDC, USDt on Algorand)

Contributing

Contributions welcome. Fork ? branch ? commit ? PR. Run npm test before submitting.

Code style: TypeScript strict, Tailwind CSS, ESLint defaults.

License

Apache 2.0 - see LICENSE.

Contact

Hemanth Peddada - @hemanttbuilds � peddadahemanth6@gmail.com � hemanthme.in

Acknowledgments

• Algorand Foundation � AlgoKit � Pera Wallet

• x402 Protocol � OpenClaw � Model Context Protocol

• Tinyman DEX � Gora Oracle � NFDomains

• Supabase � Railway � Vercel

• Cerebras � Telegram Bot API

• shadcn/ui � Remix Icons � Vitest