Rate Conversion

Rate conversion functions of Azoth SDK for working with time periods

AzothPay stores subscription rates as per-second values (raw), but in applications, you'll typically want to display these as more human-readable periods like per month or per year.

Rate Periods

The SDK exports a RatePeriod enum to represent different time periods:

export enum RatePeriod {
  SECOND = 'second',
  HOUR = 'hour',
  DAY = 'day',
  WEEK = 'week',
  MONTH = 'month',
  YEAR = 'year'
}

These period values correspond to the following conversion factors (in seconds):

Period	Seconds
SECOND	1
HOUR	3600
DAY	86400
WEEK	604800
MONTH	2628000
YEAR	31536000

convertRatePerSecond()

Converts an amount for a specific period (e.g., 10 USDT per month) to a per-second rate.

function convertRatePerSecond(amount: string, period: RatePeriod): number

Parameters:

• amount: The rate amount as a string

• period: The time period for the rate (e.g., RatePeriod.MONTH)

Returns: The equivalent per-second rate as a number.

Example:

// Convert 10 USDT per month to a per-second rate
const perSecondRate = convertRatePerSecond('10', RatePeriod.MONTH);
console.log(perSecondRate); // Very small number representing tokens per second

convertRateToPeriod()

Converts a per-second rate to a rate for a specified period.

function convertRateToPeriod(ratePerSecond: number, period: RatePeriod): number

Parameters:

• ratePerSecond: The per-second rate as a number

• period: The target time period (e.g., RatePeriod.MONTH)

Returns: The rate for the target period as a number.

Example:

// Convert a per-second rate to a monthly rate
const monthlyRate = convertRateToPeriod(perSecondRate, RatePeriod.MONTH);
console.log(monthlyRate); // Approximately 10 (if perSecondRate was from previous example)

Practical Example

import { convertRatePerSecond, convertRateToPeriod, RatePeriod } from '@azothpay/sdk';

// User wants to subscribe to 25 USDT per month
const monthlyAmount = '25';
const perSecondRate = convertRatePerSecond(monthlyAmount, RatePeriod.MONTH);

// Use the per-second rate for subscription
await azoth.subscribe(creatorAddress, perSecondRate, RatePeriod.SECOND, projectId);

// Later, when getting subscription info
const userInfo = await azoth.getUserInfo();
const rawIncomeRate = userInfo.incomeRate;

// Convert back to human-readable format
const monthlyIncome = convertRateToPeriod(Number(rawIncomeRate), RatePeriod.MONTH);
console.log(`Monthly income: ${monthlyIncome} USDT`);