Installation & Setup

import { VowenaClient, NETWORKS } from "vowena";

const client = new VowenaClient({
  contractId: NETWORKS.testnet.contractId,
  rpcUrl: NETWORKS.testnet.rpcUrl,
  networkPassphrase: NETWORKS.testnet.networkPassphrase,
});

import {
  VowenaClient,        // Main client for all contract interactions
  toStroops,           // Convert human-readable amount to stroops (bigint)
  fromStroops,         // Convert stroops (bigint) to human-readable string
  getEvents,           // Fetch contract events from Soroban RPC
  VowenaEventPoller,   // Continuous event polling class
  NETWORKS,            // Pre-configured network constants
  USDC_DECIMALS,       // 7
  SECONDS_PER_DAY,     // 86400
  SECONDS_PER_MONTH,   // 2592000
  SECONDS_PER_YEAR,    // 31536000
} from "vowena";

import type {
  Plan,                  // On-chain plan data
  Subscription,          // On-chain subscription data
  SubscriptionStatus,    // "active" | "paused" | "cancelled" | "expired"
  CreatePlanParams,      // Parameters for buildCreatePlan()
  VowenaClientOptions,   // Constructor options for VowenaClient
  TransactionResult,     // Result from submitTransaction()
  VowenaEvent,           // Parsed contract event
  EventPollerOptions,    // Constructor options for VowenaEventPoller
} from "vowena";