Billing & Credits

Overview

sovseal features a transparent, metered billing system. Because our architecture is zero-knowledge, the server cannot read or decrypt your memories. Metering is strictly calculated at Layer A (using resource counts, operation logs, and ciphertext storage sizes).

Pricing Plans

The pricing tiers are defined in our canonical pricing package:

Layer-A Usage Metering

Our billing engine tracks and charges based on three metadata parameters:

1. Sync Operations: Count of background replicate calls (replicate.ts).
2. Encrypted Storage Space: Sum of bytes stored in the public.agent_state_snapshots table and sovseal-rom Arweave/Supabase buckets.
3. API Keys: Number of active credentials issued for the project.

[!TIP] Cryptographic Privacy Guarantee The Edge database tracks usage without ever needing or accessing your decryption key. We measure billing solely on ciphertext size and operation metadata, preserving absolute client confidentiality.

Polar Billing Integration

sovseal integrates with Polar to manage checkouts, subscriptions, seat additions, and billing statements.

sequenceDiagram
    participant User as User / Browser
    participant Dashboard as Dashboard UI
    participant Edge as Edge Function (Frankfurt)
    participant Polar as Polar checkout API

    User->>Dashboard: Click "Upgrade to Pro"
    Dashboard->>Edge: POST /billing/create-checkout
    Edge->>Polar: Create checkout (User External ID)
    Polar-->>Edge: Checkout URL
    Edge-->>Dashboard: Return URL
    Dashboard->>User: Redirect to Polar Checkout
    User->>Polar: Provide Payment Info
    Polar-->>Edge: Webhook subscription.created
    Note over Edge: Upgrade database record plan limits

Managing Subscriptions

To upgrade, downgrade, or manage invoices, visit Billing in the dashboard and click Manage Subscription to securely open the Polar customer portal.