Subscriptions

Client (browser)                    Server (Node.js)
─────────────────                   ────────────────
subscribe() ──────────────────────> Store subscription ID
                                    ↓
                                    getStatus() → check if chargeable
                                    ↓
                                    charge() → execute periodic charge
                                    ↓
                                    revoke() → cancel when needed

CDP_API_KEY_ID=your-api-key-id
CDP_API_KEY_SECRET=your-api-key-secret
CDP_WALLET_SECRET=your-wallet-secret
PAYMASTER_URL=https://your-paymaster.xyz  # optional, for gasless transactions

import { base } from '@base-org/account/node';

const wallet = await base.subscription.getOrCreateSubscriptionOwnerWallet({
  walletName: 'my-app-subscriptions',
});
// wallet.address → share this with the frontend as subscriptionOwner
// wallet.walletName → must match across charge() and revoke() calls

import { base } from '@base-org/account';

const subscription = await base.subscription.subscribe({
  recurringCharge: '9.99',
  subscriptionOwner: '0xYourCDPWalletAddress',
  periodInDays: 30,
  testnet: false,
});
// subscription.id → store this as the subscription identifier

import { base } from '@base-org/account';

const status = await base.subscription.getStatus({
  id: subscriptionId,
  testnet: false,
});

const status = await base.subscription.getStatus({ id: subscriptionId });
if (status.isSubscribed && parseFloat(status.remainingChargeInPeriod!) > 0) {
  // safe to charge
}

import { base } from '@base-org/account/node';

const result = await base.subscription.charge({
  id: subscriptionId,
  amount: 'max-remaining-charge',
  paymasterUrl: process.env.PAYMASTER_URL,
  testnet: false,
});

import { base } from '@base-org/account/node';

const result = await base.subscription.revoke({
  id: subscriptionId,
  paymasterUrl: process.env.PAYMASTER_URL,
  testnet: false,
});

import { base } from '@base-org/account';

const calls = await base.subscription.prepareCharge({
  id: subscriptionId,
  amount: 'max-remaining-charge',
  testnet: false,
});
// calls → Array<{ to, data, value: '0x0' }>
// Execute via wallet_sendCalls or eth_sendTransaction

const call = await base.subscription.prepareRevoke({
  id: subscriptionId,
  testnet: false,
});
// call → { to, data, value: '0x0' }