Skip to content

Implemented token renewal system #455

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
truthixify merged 3 commits into from
Jan 30, 2026
Merged

Implemented token renewal system #455

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
35d3c66
implemented token renewal system
Lansa-18 Jan 30, 2026
7d95732
clippy lint and format error fixes
Lansa-18 Jan 30, 2026
c8906f0
second fix for the clippy lint and format error actions
Lansa-18 Jan 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions contracts/common_types/src/types.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -167,6 +167,8 @@ pub enum UserRole {
///
/// # Variants
/// * `Active` - Membership is currently active
/// * `Paused` - Membership is temporarily paused
/// * `GracePeriod` - Membership expired but within grace period (usable with restrictions)
/// * `Expired` - Membership has expired
/// * `Revoked` - Membership has been revoked
/// * `Inactive` - Membership is inactive
Expand All @@ -175,7 +177,10 @@ pub enum UserRole {
pub enum MembershipStatus {
/// Active membership
Active,
/// Temporarily paused membership
Paused,
/// Expired but within grace period (restricted access)
GracePeriod,
/// Expired membership
Expired,
/// Revoked membership
Expand Down
5 changes: 5 additions & 0 deletions contracts/manage_hub/src/errors.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,4 +53,9 @@ pub enum Error {
TierAlreadyExists = 43,
TierNotActive = 44,
TierChangeNotFound = 45,
// Token renewal errors (reusing codes where applicable)
RenewalNotAllowed = 46,
TransferNotAllowedInGracePeriod = 47,
GracePeriodExpired = 48,
AutoRenewalFailed = 49,
}
148 changes: 148 additions & 0 deletions contracts/manage_hub/src/lib.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -425,6 +425,154 @@ impl Contract {
MembershipTokenContract::query_tokens_by_attribute(env, attribute_key, attribute_value)
}

// ============================================================================
// Token Renewal System Endpoints
// ============================================================================

/// Sets the renewal configuration. Admin only.
///
/// # Arguments
/// * `env` - The contract environment
/// * `grace_period_duration` - Grace period duration in seconds
/// * `auto_renewal_notice_days` - Days before expiry to trigger auto-renewal
/// * `renewals_enabled` - Whether renewals are enabled
///
/// # Errors
/// * `AdminNotSet` - No admin configured
/// * `Unauthorized` - Caller is not admin
pub fn set_renewal_config(
env: Env,
grace_period_duration: u64,
auto_renewal_notice_days: u64,
renewals_enabled: bool,
) -> Result<(), Error> {
MembershipTokenContract::set_renewal_config(
env,
grace_period_duration,
auto_renewal_notice_days,
renewals_enabled,
)
}

/// Gets the renewal configuration.
///
/// # Arguments
/// * `env` - The contract environment
///
/// # Returns
/// * The renewal configuration with defaults if not set
pub fn get_renewal_config(env: Env) -> types::RenewalConfig {
MembershipTokenContract::get_renewal_config(env)
}

/// Renews a membership token with payment validation and tier pricing.
///
/// # Arguments
/// * `env` - The contract environment
/// * `id` - Token ID to renew
/// * `payment_token` - Payment token address (must be USDC)
/// * `tier_id` - Tier ID for pricing lookup
/// * `billing_cycle` - Billing cycle (Monthly or Annual)
///
/// # Errors
/// * `TokenNotFound` - Token doesn't exist
/// * `RenewalNotAllowed` - Renewals are disabled
/// * `TierNotFound` - Tier doesn't exist
/// * `InvalidPaymentAmount` - Invalid payment amount
/// * `InvalidPaymentToken` - Invalid payment token
/// * `Unauthorized` - Caller is not token owner
pub fn renew_token(
env: Env,
id: BytesN<32>,
payment_token: Address,
tier_id: String,
billing_cycle: BillingCycle,
) -> Result<(), Error> {
MembershipTokenContract::renew_token(env, id, payment_token, tier_id, billing_cycle)
}

/// Gets the renewal history for a token.
///
/// # Arguments
/// * `env` - The contract environment
/// * `token_id` - Token ID
///
/// # Returns
/// * Vector of renewal history entries
pub fn get_renewal_history(env: Env, token_id: BytesN<32>) -> Vec<types::RenewalHistory> {
MembershipTokenContract::get_renewal_history(env, token_id)
}

/// Checks and applies grace period to an expired token.
///
/// # Arguments
/// * `env` - The contract environment
/// * `id` - Token ID
///
/// # Returns
/// * Updated token if grace period was applied
pub fn check_and_apply_grace_period(
env: Env,
id: BytesN<32>,
) -> Result<MembershipToken, Error> {
MembershipTokenContract::check_and_apply_grace_period(env, id)
}

/// Sets auto-renewal settings for a user's token.
///
/// # Arguments
/// * `env` - The contract environment
/// * `token_id` - Token ID to enable auto-renewal for
/// * `enabled` - Whether to enable auto-renewal
/// * `payment_token` - Payment token to use for auto-renewal
pub fn set_auto_renewal(
env: Env,
token_id: BytesN<32>,
enabled: bool,
payment_token: Address,
) -> Result<(), Error> {
MembershipTokenContract::set_auto_renewal(env, token_id, enabled, payment_token)
}

/// Gets auto-renewal settings for a user.
///
/// # Arguments
/// * `env` - The contract environment
/// * `user` - User address
///
/// # Returns
/// * Auto-renewal settings or None if not set
pub fn get_auto_renewal_settings(
env: Env,
user: Address,
) -> Option<types::AutoRenewalSettings> {
MembershipTokenContract::get_auto_renewal_settings(env, user)
}

/// Checks if a token is eligible for auto-renewal.
///
/// # Arguments
/// * `env` - The contract environment
/// * `id` - Token ID
///
/// # Returns
/// * True if token is within auto-renewal window
pub fn check_auto_renewal_eligibility(env: Env, id: BytesN<32>) -> Result<bool, Error> {
MembershipTokenContract::check_auto_renewal_eligibility(env, id)
}

/// Processes auto-renewal for a token. Enters grace period on failure.
///
/// # Arguments
/// * `env` - The contract environment
/// * `id` - Token ID
///
/// # Returns
/// * Success or error
pub fn process_auto_renewal(env: Env, id: BytesN<32>) -> Result<(), Error> {
MembershipTokenContract::process_auto_renewal(env, id)
}

// ============================================================================
// Attendance Analytics Endpoints
// ============================================================================
Expand Down
Loading