Events & Off-Chain Integrations

The Subscrypts Smart Contract Suite connects on-chain actions with off-chain systems through an event and view-function model. Each state change within the ecosystem emits structured events while the FacetView module allows direct querying of live contract data.

This dual approach ensures that the Subscrypts dApp, Subscrypts Discord Bot, and third-party integrations can synchronize data in real time without depending exclusively on events.

Event and View Function Model

Subscrypts uses both events and read-only view functions to maintain data consistency across connected systems.

This design ensures resilience — even if an event listener misses a blockchain log, any off-chain system can re-sync data directly from on-chain state.

Event Overview

The following table summarizes all events implemented in the Subscrypts Smart Contract Suite.

Logic Contract

FacetAdmin

FacetSubscription

FacetPaymentUSDC

How Integrations Use Events and Views Together

Off-chain systems interact with the Subscrypts contracts using a hybrid sync model:

1. Listen for events to detect changes as they happen (e.g., _subscriptionPay triggers access renewal in Subscrypts Discord Bot).
2. Query FacetView functions such as getSubscription(subscriptionId) to confirm details or recover missed updates.
3. Aggregate or store relevant plan and subscription data in local databases or dashboards.

This ensures both real-time responsiveness and data consistency across decentralized and off-chain components.

Developer Example — Listening and Querying

Developers can integrate Subscrypts events and view functions seamlessly using Web3.js or ethers.js:

import { ethers } from "ethers";

const rpcUrl = "https://your-rpc-endpoint";
const provider = new ethers.JsonRpcProvider(rpcUrl);

// Addresses
const subscryptsAddress = "0xSubscryptsProxyAddress";

// ABIs (simplified – replace with your full ABIs)
const subscryptsAbi = [
  "event _subscriptionPay(uint256 subscriptionId, uint256 planId, address subscriber, uint256 amount)",
];

const subscryptsViewAbi = [
  "function getPlans(uint256 indexStart, uint256 indexEnd) view returns (tuple(uint256 id, address merchantAddress, uint256 currencyCode, uint256 subscriptionAmount, uint256 paymentFrequency, uint256 referralBonus, uint256 commission, bytes32 description, bytes32 defaultAttributes, uint256 verificationExpiryDate, uint256 subscriberCount, bool isActive)[] plans)",
  "function getSubscriptionsByAddress(address subscriber, uint256 indexStart, uint256 indexEnd) view returns (tuple(uint256 id, address merchantAddress, uint256 planId, address subscriberAddress, uint256 currencyCode, uint256 subscriptionAmount, uint256 paymentFrequency, bool isRecurring, uint256 remainingCycles, bytes32 customAttributes, uint256 lastPaymentDate, uint256 nextPaymentDate)[] subs)",
];

async function main() {
  const subscrypts = new ethers.Contract(subscryptsAddress, subscryptsAbi, provider);
  const subscryptsView = new ethers.Contract(subscryptsAddress, subscryptsViewAbi, provider);

  // 1) Listen to payment events
  subscrypts.on("_subscriptionPay", (subscriptionId, planId, subscriber, amount, event) => {
    console.log(
      `Payment received — subscriptionId: ${subscriptionId.toString()}, planId: ${planId.toString()}, ` +
      `subscriber: ${subscriber}, amount: ${amount.toString()} SUBS`
    );
  });

  // 2) Use view functions to fetch on-chain data
  const indexStart = 0n;
  const indexEnd = 10n;

  const plans = await subscryptsView.getPlans(indexStart, indexEnd);

  const subscriberAddress = "0xSubscriberAddress";
  const subs = await subscryptsView.getSubscriptionsByAddress(
    subscriberAddress,
    0n,
    10n
  );

  console.log("Plans:", plans);
  console.log("Subscriptions for subscriber:", subs);
}

main().catch(console.error);

Key Benefits

• Real-Time Updates: Events broadcast all key on-chain actions instantly.
• State Validation: View functions guarantee data integrity even if events are missed.
• Transparency: All emitted logs are permanently recorded on-chain.
• Resilience: Any system can re-sync using FacetView data.
• Extensibility: Third-party developers can use events, view calls, or both depending on use case.

Summary

Subscrypts’ hybrid integration model combines event-based reactivity with state-based validation via FacetView. This ensures the Subscrypts dApp, Subscrypts Discord Bot, and external integrations remain synchronized, reliable, and independently verifiable — providing transparency and operational stability across the entire ecosystem.