Documentation Index
Fetch the complete documentation index at: https://vowena.xyz/docs/llms.txt
Use this file to discover all available pages before exploring further.
fn get_subscriber_subscriptions(env: Env, subscriber: Address) -> Vec<u64>
Returns a vector of all subscription IDs associated with the given subscriber address. This includes subscriptions in any status - Active, Paused, Cancelled, and Expired. This is a read-only function - no transaction signature is required.
Parameters
| Name | Type | Description |
|---|
subscriber | Address | The subscriber’s Stellar address. |
Authorization
None. This is a read-only query.
Return value
Vec<u64> - a list of subscription IDs for the subscriber. Returns an empty vector if the subscriber has no subscriptions.
Error cases
None. Returns an empty vector if the subscriber has no subscriptions.
Examples
import { VowenaClient, NETWORKS } from "@vowena/sdk";
const client = new VowenaClient({
contractId: NETWORKS.mainnet.contractId,
rpcUrl: NETWORKS.mainnet.rpcUrl,
networkPassphrase: NETWORKS.mainnet.networkPassphrase,
});
const subIds = await client.getSubscriberSubscriptions("GSUBSCRIBER...ADDR");
console.log("Subscription IDs:", subIds); // e.g., [1, 3, 7]
// Fetch full details and filter active ones
for (const subId of subIds) {
const sub = await client.getSubscription(subId);
if (sub.status === "Active") {
console.log(`Sub ${subId}: plan ${sub.planId}, next billing ${new Date(sub.nextBillingTime * 1000)}`);
}
}
soroban contract invoke \
--id CONTRACT_ID \
--network mainnet \
-- \
get_subscriber_subscriptions \
--subscriber GSUBSCRIBER...ADDR
This returns all subscriptions regardless of status. To display only active subscriptions in your UI, filter the results by checking each subscription’s status field via get_subscription.