Step 1: Connect wallet & sign in ─── REQUIRED
Step 2: Create a merchant account ─── REQUIRED (automatic on first sign-in)
Step 3: Create an App ──────────────── REQUIRED
Step 4: Create a Plan ─────────────── REQUIRED
Step 5: Generate an API Key ────────── REQUIRED (for server-side operations)
Step 6: Set up webhook endpoint ────── RECOMMENDED (for payment notifications)
Step 7: Integrate subscribe flow ───── REQUIRED (frontend or API)
Step 8: Handle webhook events ─────── RECOMMENDED

Step 1: Connect wallet ────────────── REQUIRED
Step 2: Approve USDC delegation ───── REQUIRED (one-time per subscription)
Step 3: Subscribe to a plan ────────── REQUIRED
Step 4: (Payments are automatic) ──── No action needed — Keeper handles billing
Step 5: Cancel (when desired) ─────── OPTIONAL

const app = await client.createApp({ name: "My SaaS" });
// Returns: { id, name, isActive, createdAt }

const plan = await client.createPlan(app.id, {
  name: "Pro Monthly",
  amount: 49_000_000,        // $49.00 in USDC base units (6 decimals)
  intervalSeconds: 2_592_000, // 30 days
});

const webhook = await client.createWebhook(app.id, {
  url: "https://your-server.com/webhooks/recur",
});
// Save webhook.secret securely — needed for signature verification

import { RecurClient } from "@recur/sdk";
 
const client = new RecurClient({ rpcUrl: "https://api.devnet.solana.com" });
 
const { instructions } = client.buildSubscribeTransaction(subscriberWallet, {
  merchantWallet: "YOUR_MERCHANT_WALLET",
  planSeed: plan.planSeed,
  amount: plan.amount,
  intervalSeconds: plan.intervalSeconds,
  delegateAmount: plan.amount * 12, // 12 months of delegation
});
 
// Add instructions to a Transaction and have the user sign it

const webpack = require("webpack");
 
module.exports = {
  transpilePackages: ["@recur/sdk", "@recur/solana-client"],
  webpack: (config, { isServer }) => {
    if (!isServer) {
      config.resolve.fallback = {
        crypto: require.resolve("crypto-browserify"),
        stream: require.resolve("stream-browserify"),
        buffer: require.resolve("buffer"),
        process: require.resolve("process/browser"),
        vm: false,
        fs: false,
        path: false,
      };
      config.plugins.push(
        new webpack.ProvidePlugin({
          Buffer: ["buffer", "Buffer"],
          process: ["process/browser"],
        }),
      );
    }
    return config;
  },
};

npm install buffer process crypto-browserify stream-browserify

import { defineConfig } from "vite";
import { nodePolyfills } from "vite-plugin-node-polyfills";
 
export default defineConfig({
  plugins: [nodePolyfills({ include: ["buffer", "process", "crypto", "stream"] })],
});