drip-web3-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { ethers } from "ethers";
+export interface Plan {
+    planId: bigint;
+    token: string;
+    amount: bigint;
+    interval: bigint;
+    merchant: string;
+    active: boolean;
+}
+export interface Subscription {
+    subscriptionId: bigint;
+    planId: bigint;
+    subscriber: string;
+    nextPayment: bigint;
+    active: boolean;
+}
+export interface DripConfig {
+    contractAddress: string;
+    signer: ethers.Signer;
+}
+export interface SubscribeOptions {
+    autoApprove?: boolean;
+    approvalAmount?: bigint;
+}
+export declare class Drip {
+    private contract;
+    private signer;
+    contractAddress: string;
+    constructor(config: DripConfig);
+    createPlan(tokenAddress: string, amount: bigint, intervalSeconds: bigint): Promise<{
+        planId: bigint;
+        tx: ethers.TransactionResponse;
+    }>;
+    getPlan(planId: bigint): Promise<Plan>;
+    cancelPlan(planId: bigint): Promise<ethers.TransactionResponse>;
+    subscribe(planId: bigint, options?: SubscribeOptions): Promise<{
+        subscriptionId: bigint;
+        tx: ethers.TransactionResponse;
+    }>;
+    getSubscription(subscriptionId: bigint): Promise<Subscription>;
+    cancelSubscription(subscriptionId: bigint): Promise<ethers.TransactionResponse>;
+    cancelSubscriptionAsMerchant(subscriptionId: bigint): Promise<ethers.TransactionResponse>;
+    executePayment(subscriptionId: bigint): Promise<ethers.TransactionResponse>;
+    approveToken(tokenAddress: string, amount: bigint): Promise<ethers.TransactionResponse | null>;
+    getTokenInfo(tokenAddress: string): Promise<{
+        symbol: string;
+        decimals: number;
+        balance: bigint;
+    }>;
+    getStats(): Promise<{
+        planCount: bigint;
+        subscriptionCount: bigint;
+        feeBps: bigint;
+        feeRecipient: string;
+    }>;
+}
+export declare const INTERVALS: {
+    readonly DAILY: bigint;
+    readonly WEEKLY: bigint;
+    readonly MONTHLY: bigint;
+    readonly YEARLY: bigint;
+};
+export declare const DEPLOYMENTS: Record<string, string>;
+export default Drip;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAgChC,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAgB;IACvB,eAAe,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,UAAU;IAYxB,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC,mBAAmB,CAAA;KAAE,CAAC;IA0BxD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAM/D,SAAS,CACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC,mBAAmB,CAAA;KAAE,CAAC;IAiChE,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAW9D,kBAAkB,CACtB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAIhC,4BAA4B,CAChC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAIhC,cAAc,CAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAMhC,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAavC,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAaI,QAAQ,IAAI,OAAO,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CAUH;AAID,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AAEX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG9C,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/index.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEPLOYMENTS = exports.INTERVALS = exports.Drip = void 0;
+const ethers_1 = require("ethers");
+const DRIP_ABI = [
+    "function createPlan(address token, uint256 amount, uint256 interval) external returns (uint256)",
+    "function subscribe(uint256 planId) external returns (uint256)",
+    "function cancelSubscription(uint256 subscriptionId) external",
+    "function cancelPlan(uint256 planId) external",
+    "function cancelSubscriptionAsMerchant(uint256 subscriptionId) external",
+    "function executePayment(uint256 subscriptionId) external",
+    "function plans(uint256) external view returns (address token, uint256 amount, uint256 interval, address merchant, bool active)",
+    "function subscriptions(uint256) external view returns (uint256 planId, address subscriber, uint256 nextPayment, bool active)",
+    "function subscriptionCount() external view returns (uint256)",
+    "function planCount() external view returns (uint256)",
+    "function feeBps() external view returns (uint256)",
+    "function feeRecipient() external view returns (address)",
+    "event PlanCreated(uint256 indexed planId, address indexed merchant, address token, uint256 amount, uint256 interval)",
+    "event Subscribed(uint256 indexed subscriptionId, uint256 indexed planId, address indexed subscriber)",
+    "event PaymentExecuted(uint256 indexed subscriptionId, uint256 amount, uint256 fee)",
+    "event SubscriptionCancelled(uint256 indexed subscriptionId)",
+    "event PlanCancelled(uint256 indexed planId)"
+];
+const ERC20_ABI = [
+    "function approve(address spender, uint256 amount) external returns (bool)",
+    "function allowance(address owner, address spender) external view returns (uint256)",
+    "function balanceOf(address account) external view returns (uint256)",
+    "function decimals() external view returns (uint8)",
+    "function symbol() external view returns (string)"
+];
+const MAX_UINT256 = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+class Drip {
+    constructor(config) {
+        this.contractAddress = config.contractAddress;
+        this.signer = config.signer;
+        this.contract = new ethers_1.ethers.Contract(config.contractAddress, DRIP_ABI, config.signer);
+    }
+    // ─── Plans ───────────────────────────────────────────────
+    async createPlan(tokenAddress, amount, intervalSeconds) {
+        const tx = await this.contract.createPlan(tokenAddress, amount, intervalSeconds);
+        const receipt = await tx.wait();
+        const event = receipt.logs
+            .map((log) => {
+            try {
+                return this.contract.interface.parseLog(log);
+            }
+            catch {
+                return null;
+            }
+        })
+            .find((e) => e?.name === "PlanCreated");
+        if (!event || !event.args) {
+            throw new Error("PlanCreated event not found in transaction receipt — refetch planCount to get your planId");
+        }
+        return { planId: event.args.planId, tx };
+    }
+    async getPlan(planId) {
+        const result = await this.contract.plans(planId);
+        return {
+            planId,
+            token: result.token,
+            amount: result.amount,
+            interval: result.interval,
+            merchant: result.merchant,
+            active: result.active,
+        };
+    }
+    async cancelPlan(planId) {
+        return await this.contract.cancelPlan(planId);
+    }
+    // ─── Subscriptions ───────────────────────────────────────
+    async subscribe(planId, options = {}) {
+        const { autoApprove = true, approvalAmount } = options;
+        if (autoApprove) {
+            const plan = await this.getPlan(planId);
+            const amount = approvalAmount ?? MAX_UINT256;
+            const approveTx = await this.approveToken(plan.token, amount);
+            if (approveTx) {
+                await approveTx.wait();
+            }
+        }
+        const tx = await this.contract.subscribe(planId);
+        const receipt = await tx.wait();
+        const event = receipt.logs
+            .map((log) => {
+            try {
+                return this.contract.interface.parseLog(log);
+            }
+            catch {
+                return null;
+            }
+        })
+            .find((e) => e?.name === "Subscribed");
+        if (!event || !event.args) {
+            throw new Error("Subscribed event not found in transaction receipt — refetch subscriptionCount to get your subscriptionId");
+        }
+        return { subscriptionId: event.args.subscriptionId, tx };
+    }
+    async getSubscription(subscriptionId) {
+        const result = await this.contract.subscriptions(subscriptionId);
+        return {
+            subscriptionId,
+            planId: result.planId,
+            subscriber: result.subscriber,
+            nextPayment: result.nextPayment,
+            active: result.active,
+        };
+    }
+    async cancelSubscription(subscriptionId) {
+        return await this.contract.cancelSubscription(subscriptionId);
+    }
+    async cancelSubscriptionAsMerchant(subscriptionId) {
+        return await this.contract.cancelSubscriptionAsMerchant(subscriptionId);
+    }
+    async executePayment(subscriptionId) {
+        return await this.contract.executePayment(subscriptionId);
+    }
+    // ─── Token helpers ───────────────────────────────────────
+    async approveToken(tokenAddress, amount) {
+        const token = new ethers_1.ethers.Contract(tokenAddress, ERC20_ABI, this.signer);
+        const signerAddress = await this.signer.getAddress();
+        const allowance = await token.allowance(signerAddress, this.contractAddress);
+        if (allowance >= amount) {
+            return null;
+        }
+        return await token.approve(this.contractAddress, amount);
+    }
+    async getTokenInfo(tokenAddress) {
+        const token = new ethers_1.ethers.Contract(tokenAddress, ERC20_ABI, this.signer);
+        const signerAddress = await this.signer.getAddress();
+        const [symbol, decimals, balance] = await Promise.all([
+            token.symbol(),
+            token.decimals(),
+            token.balanceOf(signerAddress),
+        ]);
+        return { symbol, decimals, balance };
+    }
+    // ─── Protocol stats ──────────────────────────────────────
+    async getStats() {
+        const [planCount, subscriptionCount, feeBps, feeRecipient] = await Promise.all([
+            this.contract.planCount(),
+            this.contract.subscriptionCount(),
+            this.contract.feeBps(),
+            this.contract.feeRecipient(),
+        ]);
+        return { planCount, subscriptionCount, feeBps, feeRecipient };
+    }
+}
+exports.Drip = Drip;
+// ─── Convenience constants ───────────────────────────────
+exports.INTERVALS = {
+    DAILY: BigInt(86400),
+    WEEKLY: BigInt(604800),
+    MONTHLY: BigInt(2592000),
+    YEARLY: BigInt(31536000),
+};
+exports.DEPLOYMENTS = {
+    "base-sepolia": "0x1ad2FC3469dB1625730B4401E5717B741526B6af",
+    "base": "0x1ad2FC3469dB1625730B4401E5717B741526B6af",
+};
+exports.default = Drip;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "drip-web3-sdk",
+  "version": "0.1.0",
+  "description": "Recurring payment protocol for Web3",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": ["web3", "payments", "subscriptions", "defi", "base"],
+  "license": "MIT",
+  "dependencies": {
+    "ethers": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,256 @@
+import { ethers } from "ethers";
+
+const DRIP_ABI = [
+  "function createPlan(address token, uint256 amount, uint256 interval) external returns (uint256)",
+  "function subscribe(uint256 planId) external returns (uint256)",
+  "function cancelSubscription(uint256 subscriptionId) external",
+  "function cancelPlan(uint256 planId) external",
+  "function cancelSubscriptionAsMerchant(uint256 subscriptionId) external",
+  "function executePayment(uint256 subscriptionId) external",
+  "function plans(uint256) external view returns (address token, uint256 amount, uint256 interval, address merchant, bool active)",
+  "function subscriptions(uint256) external view returns (uint256 planId, address subscriber, uint256 nextPayment, bool active)",
+  "function subscriptionCount() external view returns (uint256)",
+  "function planCount() external view returns (uint256)",
+  "function feeBps() external view returns (uint256)",
+  "function feeRecipient() external view returns (address)",
+  "event PlanCreated(uint256 indexed planId, address indexed merchant, address token, uint256 amount, uint256 interval)",
+  "event Subscribed(uint256 indexed subscriptionId, uint256 indexed planId, address indexed subscriber)",
+  "event PaymentExecuted(uint256 indexed subscriptionId, uint256 amount, uint256 fee)",
+  "event SubscriptionCancelled(uint256 indexed subscriptionId)",
+  "event PlanCancelled(uint256 indexed planId)"
+];
+
+const ERC20_ABI = [
+  "function approve(address spender, uint256 amount) external returns (bool)",
+  "function allowance(address owner, address spender) external view returns (uint256)",
+  "function balanceOf(address account) external view returns (uint256)",
+  "function decimals() external view returns (uint8)",
+  "function symbol() external view returns (string)"
+];
+
+const MAX_UINT256 = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+
+export interface Plan {
+  planId: bigint;
+  token: string;
+  amount: bigint;
+  interval: bigint;
+  merchant: string;
+  active: boolean;
+}
+
+export interface Subscription {
+  subscriptionId: bigint;
+  planId: bigint;
+  subscriber: string;
+  nextPayment: bigint;
+  active: boolean;
+}
+
+export interface DripConfig {
+  contractAddress: string;
+  signer: ethers.Signer;
+}
+
+export interface SubscribeOptions {
+  autoApprove?: boolean;
+  approvalAmount?: bigint;
+}
+
+export class Drip {
+  private contract: ethers.Contract;
+  private signer: ethers.Signer;
+  public contractAddress: string;
+
+  constructor(config: DripConfig) {
+    this.contractAddress = config.contractAddress;
+    this.signer = config.signer;
+    this.contract = new ethers.Contract(
+      config.contractAddress,
+      DRIP_ABI,
+      config.signer
+    );
+  }
+
+  // ─── Plans ───────────────────────────────────────────────
+
+  async createPlan(
+    tokenAddress: string,
+    amount: bigint,
+    intervalSeconds: bigint
+  ): Promise<{ planId: bigint; tx: ethers.TransactionResponse }> {
+    const tx = await this.contract.createPlan(
+      tokenAddress,
+      amount,
+      intervalSeconds
+    );
+    const receipt = await tx.wait();
+    const event = receipt.logs
+      .map((log: ethers.Log) => {
+        try {
+          return this.contract.interface.parseLog(log);
+        } catch {
+          return null;
+        }
+      })
+      .find((e: ethers.LogDescription | null) => e?.name === "PlanCreated");
+
+    if (!event || !event.args) {
+      throw new Error(
+        "PlanCreated event not found in transaction receipt — refetch planCount to get your planId"
+      );
+    }
+
+    return { planId: event.args.planId, tx };
+  }
+
+  async getPlan(planId: bigint): Promise<Plan> {
+    const result = await this.contract.plans(planId);
+    return {
+      planId,
+      token: result.token,
+      amount: result.amount,
+      interval: result.interval,
+      merchant: result.merchant,
+      active: result.active,
+    };
+  }
+
+  async cancelPlan(planId: bigint): Promise<ethers.TransactionResponse> {
+    return await this.contract.cancelPlan(planId);
+  }
+
+  // ─── Subscriptions ───────────────────────────────────────
+
+  async subscribe(
+    planId: bigint,
+    options: SubscribeOptions = {}
+  ): Promise<{ subscriptionId: bigint; tx: ethers.TransactionResponse }> {
+    const { autoApprove = true, approvalAmount } = options;
+
+    if (autoApprove) {
+      const plan = await this.getPlan(planId);
+      const amount = approvalAmount ?? MAX_UINT256;
+      const approveTx = await this.approveToken(plan.token, amount);
+      if (approveTx) {
+        await approveTx.wait();
+      }
+    }
+
+    const tx = await this.contract.subscribe(planId);
+    const receipt = await tx.wait();
+    const event = receipt.logs
+      .map((log: ethers.Log) => {
+        try {
+          return this.contract.interface.parseLog(log);
+        } catch {
+          return null;
+        }
+      })
+      .find((e: ethers.LogDescription | null) => e?.name === "Subscribed");
+
+    if (!event || !event.args) {
+      throw new Error(
+        "Subscribed event not found in transaction receipt — refetch subscriptionCount to get your subscriptionId"
+      );
+    }
+
+    return { subscriptionId: event.args.subscriptionId, tx };
+  }
+
+  async getSubscription(subscriptionId: bigint): Promise<Subscription> {
+    const result = await this.contract.subscriptions(subscriptionId);
+    return {
+      subscriptionId,
+      planId: result.planId,
+      subscriber: result.subscriber,
+      nextPayment: result.nextPayment,
+      active: result.active,
+    };
+  }
+
+  async cancelSubscription(
+    subscriptionId: bigint
+  ): Promise<ethers.TransactionResponse> {
+    return await this.contract.cancelSubscription(subscriptionId);
+  }
+
+  async cancelSubscriptionAsMerchant(
+    subscriptionId: bigint
+  ): Promise<ethers.TransactionResponse> {
+    return await this.contract.cancelSubscriptionAsMerchant(subscriptionId);
+  }
+
+  async executePayment(
+    subscriptionId: bigint
+  ): Promise<ethers.TransactionResponse> {
+    return await this.contract.executePayment(subscriptionId);
+  }
+
+  // ─── Token helpers ───────────────────────────────────────
+
+  async approveToken(
+    tokenAddress: string,
+    amount: bigint
+  ): Promise<ethers.TransactionResponse | null> {
+    const token = new ethers.Contract(tokenAddress, ERC20_ABI, this.signer);
+    const signerAddress = await this.signer.getAddress();
+    const allowance = await token.allowance(
+      signerAddress,
+      this.contractAddress
+    );
+    if (allowance >= amount) {
+      return null;
+    }
+    return await token.approve(this.contractAddress, amount);
+  }
+
+  async getTokenInfo(tokenAddress: string): Promise<{
+    symbol: string;
+    decimals: number;
+    balance: bigint;
+  }> {
+    const token = new ethers.Contract(tokenAddress, ERC20_ABI, this.signer);
+    const signerAddress = await this.signer.getAddress();
+    const [symbol, decimals, balance] = await Promise.all([
+      token.symbol(),
+      token.decimals(),
+      token.balanceOf(signerAddress),
+    ]);
+    return { symbol, decimals, balance };
+  }
+
+  // ─── Protocol stats ──────────────────────────────────────
+
+  async getStats(): Promise<{
+    planCount: bigint;
+    subscriptionCount: bigint;
+    feeBps: bigint;
+    feeRecipient: string;
+  }> {
+    const [planCount, subscriptionCount, feeBps, feeRecipient] =
+      await Promise.all([
+        this.contract.planCount(),
+        this.contract.subscriptionCount(),
+        this.contract.feeBps(),
+        this.contract.feeRecipient(),
+      ]);
+    return { planCount, subscriptionCount, feeBps, feeRecipient };
+  }
+}
+
+// ─── Convenience constants ───────────────────────────────
+
+export const INTERVALS = {
+  DAILY: BigInt(86400),
+  WEEKLY: BigInt(604800),
+  MONTHLY: BigInt(2592000),
+  YEARLY: BigInt(31536000),
+} as const;
+
+export const DEPLOYMENTS: Record<string, string> = {
+  "base-sepolia": "0x1ad2FC3469dB1625730B4401E5717B741526B6af",
+  "base": "0x1ad2FC3469dB1625730B4401E5717B741526B6af",
+};
+
+export default Drip;

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}