Struct Subscription 

pub struct Subscription {
    pub plan: Pubkey,
    pub subscriber: Pubkey,
    pub next_renewal_ts: i64,
    pub active: bool,
    pub renewals: u32,
    pub created_ts: i64,
    pub last_amount: u64,
    pub last_renewed_ts: i64,
    pub trial_ends_at: Option<i64>,
    pub in_trial: bool,
    pub bump: u8,
}

Subscription account tracks individual user subscriptions PDA seeds: [“subscription”, plan, subscriber]

Fields

plan: Pubkey

Reference to the plan PDA

subscriber: Pubkey

User’s pubkey (the subscriber)

next_renewal_ts: i64

Unix timestamp for next renewal

active: bool

Whether subscription is active

renewals: u32

Number of renewals processed for this subscription.

This counter increments with each successful renewal payment and is preserved across subscription cancellation and reactivation cycles. When a subscription is canceled and later reactivated, this field retains its historical value rather than resetting to zero.

created_ts: i64

Unix timestamp when subscription was created

last_amount: u64

Last charged amount for audit purposes

last_renewed_ts: i64

Unix timestamp when subscription was last renewed (prevents double-renewal attacks)

trial_ends_at: Option<i64>

Unix timestamp when free trial period ends (None if no trial)

When present, indicates the subscription is in or was in a free trial period. During the trial, no payment is required. After trial_ends_at, the first renewal will process the initial payment.

in_trial: bool

Whether subscription is currently in free trial period

When true, the subscription is active but no payment has been made yet. The first payment will occur at next_renewal_ts (when trial ends).

bump: u8

PDA bump seed

Trait Implementations

impl BorshDeserialize for Subscription

where Pubkey: BorshDeserialize, i64: BorshDeserialize, bool: BorshDeserialize, u32: BorshDeserialize, u64: BorshDeserialize, Option<i64>: BorshDeserialize, u8: BorshDeserialize,

fn deserialize_reader<R: Read>(reader: &mut R) -> Result<Self, Error>

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn try_from_reader<R>(reader: &mut R) -> Result<Self, Error>

where R: Read,

impl BorshSerialize for Subscription

where Pubkey: BorshSerialize, i64: BorshSerialize, bool: BorshSerialize, u32: BorshSerialize, u64: BorshSerialize, Option<i64>: BorshSerialize, u8: BorshSerialize,

fn serialize<W: Write>(&self, writer: &mut W) -> Result<(), Error>

fn try_to_vec(&self) -> Result<Vec<u8>, Error>

Serialize this instance into a vector of bytes.

impl Clone for Subscription

fn clone(&self) -> Subscription

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Subscription

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Subscription

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Subscription

fn eq(&self, other: &Subscription) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Subscription

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Subscription

impl StructuralPartialEq for Subscription