@wuwei-labs/srsly 2.0.0-beta.24 → 2.0.0-beta.25

package/README.md

@@ -34,7 +34,7 @@ yarn add @wuwei-labs/srsly
 ### Option 1: Pack and Send (Server/CLI)
 
 ```typescript
-import { createContract, setConfig } from '@wuwei-labs/srsly';
+import { createContract, setConfig, days, weeks } from '@wuwei-labs/srsly';
 import { createKeyPairSignerFromBytes } from '@solana/kit';
 
 // 1. Configure SDK with RPC endpoint
@@ -51,10 +51,9 @@ const signature = await createContract({
   owner: signer,
   fleet: fleetAddress,
   ownerProfile: profileAddress,
-  rate: 1000000, // ATLAS tokens
-  durationMin: 86400, // 1 day
-  durationMax: 604800, // 1 week
-  paymentsFreq: 'daily'
+  rate: 1000000, // ATLAS tokens per payment period
+  durationMax: days(7), // 7 days using helper function
+  paymentsFreq: 'daily' // Minimum duration automatically set to 1 day
 }).pack(signer.address).send(signer); // Now chainable!
 
 console.log('Transaction signature:', signature);
@@ -91,10 +90,9 @@ const packedTx = await createContract({
   owner: walletPublicKey,
   fleet: fleetAddress,
   ownerProfile: profileAddress,
-  rate: 1000000, // ATLAS tokens
-  durationMin: 86400, // 1 day
-  durationMax: 604800, // 1 week
-  paymentsFreq: 'daily'
+  rate: 1000000, // ATLAS tokens per payment period
+  durationMax: days(7), // 7 days using helper function
+  paymentsFreq: 'daily' // Minimum duration automatically set to 1 day
 }).pack(walletPublicKey); // Pack with fee payer address
 
 // 3. Sign and send with wallet adapter
@@ -159,8 +157,52 @@ const createIx = await createContract({
   fleet: "123abc...",              // string
   ownerProfile: address("456def..."), // Address<string>
   rate: 5000000,
-  durationMin: 86400,
   durationMax: 2592000,
+  paymentsFreq: 'daily' // Minimum duration automatically set to 1 day
+});
+```
+
+### Duration Helper Functions
+
+The SDK provides convenient helper functions for converting time units to seconds:
+
+```typescript
+import { days, weeks, months, hours, minutes, duration } from '@wuwei-labs/srsly';
+
+// Individual helper functions
+const sevenDays = days(7);        // 604800 seconds
+const twoWeeks = weeks(2);        // 1209600 seconds  
+const oneMonth = months(1);       // 2678400 seconds (31 days)
+const sixHours = hours(6);        // 21600 seconds
+const thirtyMinutes = minutes(30); // 1800 seconds
+
+// Using in contract creation
+const contract = await createContract({
+  owner: wallet,
+  fleet: fleetAddress,
+  ownerProfile: profileAddress,
+  rate: 1000000,
+  durationMax: weeks(2),        // 2 weeks maximum
+  paymentsFreq: 'daily'         // Min automatically set to 1 day
+});
+
+// Alternative: use the duration object
+const anotherContract = await createContract({
+  owner: wallet,
+  fleet: fleetAddress,
+  ownerProfile: profileAddress,
+  rate: 500000,
+  durationMax: duration.months(3), // 3 months maximum
+  paymentsFreq: 'weekly'           // Min automatically set to 1 week
+});
+
+// You can still use raw seconds if preferred
+const rawContract = await createContract({
+  owner: wallet,
+  fleet: fleetAddress,
+  ownerProfile: profileAddress,
+  rate: 750000,
+  durationMax: 86400,         // Raw 86400 seconds (1 day)
   paymentsFreq: 'daily'
 });
 ```
@@ -168,7 +210,7 @@ const createIx = await createContract({
 ### Contract Management
 
 ```typescript
-import { createContract, closeContract } from '@wuwei-labs/srsly';
+import { createContract, closeContract, days, months } from '@wuwei-labs/srsly';
 
 // Create rental contract instruction
 const createIx = await createContract({
@@ -176,9 +218,8 @@ const createIx = await createContract({
   fleet: fleetAddress,
   ownerProfile: profileAddress,
   rate: 5000000,
-  durationMin: 86400,
-  durationMax: 2592000,
-  paymentsFreq: 'daily'
+  durationMax: months(1),  // 30 days using helper function
+  paymentsFreq: 'daily' // Minimum duration automatically set to 1 day
 });
 
 // Close contract instruction
@@ -201,8 +242,8 @@ const acceptIx = await acceptRental({
   borrowerFaction: 'mud', // or 1, 2, 3
   fleet: fleetAddress,
   contract: contractAddress,
-  rate: 100, // ATLAS per day
-  duration: 86400 // 1 day in seconds
+  rate: 100, // ATLAS per payment period (based on contract's payment frequency)
+  duration: 86400 // Duration in seconds (must be between contract's min/max)
 });
 
 // Cancel active rental instruction
@@ -291,6 +332,55 @@ const ix2 = await acceptRental(params)
   .set({ gameId: 'custom-game-id...', atlasMint: 'custom-mint...' });
 ```
 
+## Duration and Payment Frequency
+
+**Important**: All durations must be aligned with the payment frequency to ensure proper payment calculations.
+
+### Duration Rules
+
+1. **Duration Units**: All durations are specified in seconds
+2. **Alignment Requirement**: Durations must be multiples of the payment frequency interval
+3. **Validation**: The SDK automatically validates duration alignment and throws an error if invalid
+
+### Payment Frequency Intervals
+
+| Frequency | Interval | Example Valid Durations |
+|-----------|----------|------------------------|
+| `hourly`  | 3,600 seconds (1 hour) | 3,600 (1h), 7,200 (2h), 86,400 (24h) |
+| `daily`   | 86,400 seconds (1 day) | 86,400 (1d), 172,800 (2d), 604,800 (7d) |
+| `weekly`  | 604,800 seconds (1 week) | 604,800 (1w), 1,209,600 (2w), 2,419,200 (4w) |
+| `monthly` | 2,678,400 seconds (31 days) | 2,678,400 (1m), 5,356,800 (2m) |
+
+### Examples
+
+```typescript
+// ✅ Valid: 7 day max duration with daily payments
+await createContract({
+  durationMax: 604800,   // 7 days (604800 % 86400 = 0) ✓
+  paymentsFreq: 'daily'  // Min duration automatically set to 1 day
+});
+
+// ❌ Invalid: 3.5 day max duration with daily payments
+await createContract({
+  durationMax: 302400,   // 3.5 days (302400 % 86400 = 43200) ✗
+  paymentsFreq: 'daily'
+});
+// Error: Duration (302400 seconds) must be a multiple of daily frequency (86400 seconds)
+
+// ✅ Valid: Hourly payments with hour-aligned max duration
+await createContract({
+  durationMax: 172800,   // 48 hours (172800 % 3600 = 0) ✓
+  paymentsFreq: 'hourly' // Min duration automatically set to 1 hour
+});
+```
+
+### Rate Calculation
+
+The `rate` parameter in contracts represents ATLAS tokens per payment period:
+- For `daily` frequency: rate is ATLAS per day
+- For `weekly` frequency: rate is ATLAS per week
+- For `hourly` frequency: rate is ATLAS per hour
+
 ## Payment System
 
 SRSLY implements an escrow-based payment system:
@@ -301,10 +391,12 @@ SRSLY implements an escrow-based payment system:
 4. **Refunds**: Pro-rata refunds for early cancellation (24-hour minimum)
 
 ```typescript
-// Payment calculation
-const rate = 1000; // ATLAS per day
-const duration = 86400; // 1 day in seconds
-const totalAmount = rate * duration * ATLAS_TO_STARDUST; // in stardust
+// Payment calculation example
+const rate = 1000; // ATLAS per payment period
+const paymentFrequency = 'daily'; // Payment every 86400 seconds
+const duration = days(7); // 7 days using helper function
+const paymentPeriods = duration / days(1); // 7 periods
+const totalAmount = rate * paymentPeriods * ATLAS_TO_STARDUST; // Total in stardust
 ```
 
 ## Program Sets Reference
@@ -338,7 +430,11 @@ import type {
 import { 
   ATLAS_TO_STARDUST,
   FACTION_MAPPING,
-  toAddress 
+  toAddress,
+  days,
+  weeks,
+  months,
+  duration
 } from '@wuwei-labs/srsly';
 
 // Conversion rate: 1 ATLAS = 100,000,000 stardust
@@ -352,6 +448,12 @@ console.log(FACTION_MAPPING[3]); // 'ustur'
 // Address conversion utility
 const addressObj = toAddress("123abc..."); // converts string to Address<string>
 console.log(addressObj); // Address<string>
+
+// Duration helper functions
+console.log(days(7));        // 604800 (7 days in seconds)
+console.log(weeks(2));       // 1209600 (2 weeks in seconds)
+console.log(months(1));      // 2678400 (1 month in seconds)
+console.log(duration.hours(12)); // 43200 (12 hours in seconds)
 ```
 
 ## IDL and Program Information

package/dist/cjs/codama/errors/srsly.js

@@ -7,7 +7,7 @@
  * @see https://github.com/codama-idl/codama
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SRSLY_ERROR__INVALID_OWNER_PROFILE = exports.SRSLY_ERROR__ACCOUNT_OWNED_BY_WRONG_PROGRAM = exports.SRSLY_ERROR__INVALID_ATLAS_CONVERSION_RATE = exports.SRSLY_ERROR__UNAUTHORIZED_CONFIG_UPDATE = exports.SRSLY_ERROR__INVALID_RENTAL_DURATION = exports.SRSLY_ERROR__INVALID_FEE_RATE = exports.SRSLY_ERROR__UNSUPPORTED_MIGRATION_VERSION = exports.SRSLY_ERROR__RENTAL_STATE_EXISTS = exports.SRSLY_ERROR__RENTAL_IS_ACTIVE = exports.SRSLY_ERROR__INVALID_THREAD_CONTEXT = exports.SRSLY_ERROR__EXPECTED_DAILY_FREQUENCY = exports.SRSLY_ERROR__DEV_ONLY_FREQUENCY = exports.SRSLY_ERROR__CONTRACT_CLOSED = exports.SRSLY_ERROR__INSUFFICIENT_CANCELLATION_NOTICE = exports.SRSLY_ERROR__INVALID_SUB_PROFILE_INVALIDATOR = exports.SRSLY_ERROR__INVALID_PAYMENT_FREQUENCY = exports.SRSLY_ERROR__INVALID_RATE = exports.SRSLY_ERROR__FLEET_ALREADY_RENTED = exports.SRSLY_ERROR__INVALID_RATE_CALCULATION = exports.SRSLY_ERROR__INVALID_DURATION_MAXIMUM = exports.SRSLY_ERROR__INVALID_DURATION_MINIMUM = void 0;
+exports.SRSLY_ERROR__INVALID_DURATION_MAXIMUM_ALIGNMENT = exports.SRSLY_ERROR__INVALID_DURATION_MINIMUM_ALIGNMENT = exports.SRSLY_ERROR__INVALID_OWNER_PROFILE = exports.SRSLY_ERROR__ACCOUNT_OWNED_BY_WRONG_PROGRAM = exports.SRSLY_ERROR__INVALID_ATLAS_CONVERSION_RATE = exports.SRSLY_ERROR__UNAUTHORIZED_CONFIG_UPDATE = exports.SRSLY_ERROR__INVALID_RENTAL_DURATION = exports.SRSLY_ERROR__INVALID_FEE_RATE = exports.SRSLY_ERROR__UNSUPPORTED_MIGRATION_VERSION = exports.SRSLY_ERROR__RENTAL_STATE_EXISTS = exports.SRSLY_ERROR__RENTAL_IS_ACTIVE = exports.SRSLY_ERROR__INVALID_THREAD_CONTEXT = exports.SRSLY_ERROR__EXPECTED_DAILY_FREQUENCY = exports.SRSLY_ERROR__DEV_ONLY_FREQUENCY = exports.SRSLY_ERROR__CONTRACT_CLOSED = exports.SRSLY_ERROR__INSUFFICIENT_CANCELLATION_NOTICE = exports.SRSLY_ERROR__INVALID_SUB_PROFILE_INVALIDATOR = exports.SRSLY_ERROR__INVALID_PAYMENT_FREQUENCY = exports.SRSLY_ERROR__INVALID_RATE = exports.SRSLY_ERROR__FLEET_ALREADY_RENTED = exports.SRSLY_ERROR__INVALID_RATE_CALCULATION = exports.SRSLY_ERROR__INVALID_DURATION_MAXIMUM = exports.SRSLY_ERROR__INVALID_DURATION_MINIMUM = void 0;
 exports.getSrslyErrorMessage = getSrslyErrorMessage;
 exports.isSrslyError = isSrslyError;
 const kit_1 = require("@solana/kit");
@@ -54,6 +54,10 @@ exports.SRSLY_ERROR__INVALID_ATLAS_CONVERSION_RATE = 0x1782; // 6018
 exports.SRSLY_ERROR__ACCOUNT_OWNED_BY_WRONG_PROGRAM = 0x1783; // 6019
 /** InvalidOwnerProfile: Fleet owner profile does not match the provided owner profile. */
 exports.SRSLY_ERROR__INVALID_OWNER_PROFILE = 0x1784; // 6020
+/** InvalidDurationMinimumAlignment: Duration minimum must be a multiple of the payment frequency interval. */
+exports.SRSLY_ERROR__INVALID_DURATION_MINIMUM_ALIGNMENT = 0x1785; // 6021
+/** InvalidDurationMaximumAlignment: Duration maximum must be a multiple of the payment frequency interval. */
+exports.SRSLY_ERROR__INVALID_DURATION_MAXIMUM_ALIGNMENT = 0x1786; // 6022
 let srslyErrorMessages;
 if (process.env.NODE_ENV !== 'production') {
     srslyErrorMessages = {
@@ -65,7 +69,9 @@ if (process.env.NODE_ENV !== 'production') {
         [exports.SRSLY_ERROR__INSUFFICIENT_CANCELLATION_NOTICE]: `Rental time remaining is less than minimum cancellation notice required.`,
         [exports.SRSLY_ERROR__INVALID_ATLAS_CONVERSION_RATE]: `Invalid ATLAS conversion rate. Must be greater than 0.`,
         [exports.SRSLY_ERROR__INVALID_DURATION_MAXIMUM]: `Invalid duration maximum. Must be greater than or equal to the duration minimum.`,
+        [exports.SRSLY_ERROR__INVALID_DURATION_MAXIMUM_ALIGNMENT]: `Duration maximum must be a multiple of the payment frequency interval.`,
         [exports.SRSLY_ERROR__INVALID_DURATION_MINIMUM]: `Invalid duration minimum. Must be between 1 and the duration maximum.`,
+        [exports.SRSLY_ERROR__INVALID_DURATION_MINIMUM_ALIGNMENT]: `Duration minimum must be a multiple of the payment frequency interval.`,
         [exports.SRSLY_ERROR__INVALID_FEE_RATE]: `Invalid fee rate. Service fee must be <= 50%, referral fee <= 100%, base_bps > 0.`,
         [exports.SRSLY_ERROR__INVALID_OWNER_PROFILE]: `Fleet owner profile does not match the provided owner profile.`,
         [exports.SRSLY_ERROR__INVALID_PAYMENT_FREQUENCY]: `Invalid payment frequency. Must be one of: @hourly, @daily, @weekly, @monthly.`,

package/dist/cjs/codama/errors/srsly.js.map

@@ -1 +1 @@
-{"version":3,"file":"srsly.js","sourceRoot":"","sources":["../../../../src/codama/errors/srsly.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"srsly.js","sourceRoot":"","sources":["../../../../src/codama/errors/srsly.ts"],"names":[],"mappings":"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"}

package/dist/cjs/contract/create.js

@@ -4,11 +4,22 @@ exports.createContract = createContract;
 exports.getCreateContractInstructionAsync = getCreateContractInstructionAsync;
 const config_1 = require("../utils/config");
 const constants_1 = require("../utils/constants");
+const paymentFrequency_1 = require("../utils/paymentFrequency");
+const paymentFrequency_2 = require("../types/paymentFrequency");
 /**
  * Internal function to create a contract instruction with configuration options
  */
 async function _createContract(params, config) {
-    const { owner, fleet, ownerProfile, rate, durationMin, durationMax, paymentsFreq, ownerKeyIndex = 0, gameId, mint, } = params;
+    const { owner, fleet, ownerProfile, rate, durationMax, paymentsFreq, ownerKeyIndex = 0, gameId, mint, } = params;
+    // Validate payment frequency using auto-generated validation
+    if (!(0, paymentFrequency_2.isValidPaymentFrequency)(paymentsFreq)) {
+        throw new Error(`Invalid payment frequency: ${paymentsFreq}. Valid values are auto-generated from Rust PaymentFrequency enum.`);
+    }
+    // Calculate durationMin from payment frequency
+    const durationMin = (0, paymentFrequency_1.paymentFrequencyStringToSeconds)(paymentsFreq);
+    // Validate that durationMax is a multiple of the payment frequency
+    // Uses the codama-generated PaymentFrequency enum and mirrors Rust implementation
+    (0, paymentFrequency_1.validateDurationAlignment)(durationMax, paymentsFreq);
     // Get the actual game ID to use (param override, config override, or network default)
     const actualGameId = gameId ? (0, constants_1.toAddress)(gameId) : await (0, constants_1.getSageGameId)(config);
     // Get codama functions
@@ -28,7 +39,7 @@ async function _createContract(params, config) {
         rate: BigInt(rate),
         durationMin: BigInt(durationMin),
         durationMax: BigInt(durationMax),
-        paymentsFeq: paymentsFreq,
+        paymentsFeq: `@${paymentsFreq}`,
         ownerKeyIndex,
         sageProgram: (0, constants_1.toAddress)(await (0, constants_1.getSageProgramAddress)(config)),
     };

package/dist/cjs/contract/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/contract/create.ts"],"names":[],"mappings":";;AAqJA,wCAIC;AAKD,8EAKC;AA9JD,4CAA2G;AAC3G,kDAAmG;AA+DnG;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,MAA4B,EAC5B,MAAsB;IAEtB,MAAM,EACJ,KAAK,EACL,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GAAG,CAAC,EACjB,MAAM,EACN,IAAI,GACL,GAAG,MAAM,CAAC;IAEX,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,qBAAS,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,yBAAa,EAAC,MAAM,CAAC,CAAC;IAE9E,uBAAuB;IACvB,MAAM,kBAAkB,GAAG,IAAA,kBAAS,EAAC,cAAc,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,IAAA,kBAAS,EAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,EAAE,iCAAiC,EAAE,GAAG,kBAAkB,CAAC;IACjE,MAAM,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAAC;IAEjD,2DAA2D;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,qBAAS,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,wBAAY,EAAC,MAAM,CAAC,CAAC;IAEtE,kFAAkF;IAClF,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,4BAA4B;QACnC,KAAK,EAAE,IAAA,qBAAS,EAAC,KAAK,CAAC;QACvB,YAAY,EAAE,IAAA,qBAAS,EAAC,YAAY,CAAC;QACrC,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;QAChC,WAAW,EAAE,YAAY;QACzB,aAAa;QACb,WAAW,EAAE,IAAA,qBAAS,EAAC,MAAM,IAAA,iCAAqB,EAAC,MAAM,CAAC,CAAC;KAC5D,CAAC;IAEF,OAAO,iCAAiC,CACtC,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,cAAc,CAC5B,MAA4B;IAE5B,OAAO,IAAA,6BAAoB,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,SAAgB,iCAAiC,CAAC,KAAU,EAAE,OAAa;IACzE,OAAO,IAAA,6BAAoB,EAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,kBAAkB,GAAG,IAAA,kBAAS,EAAC,cAAc,CAAC,CAAC;QACrD,OAAO,kBAAkB,CAAC,iCAAiC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/contract/create.ts"],"names":[],"mappings":";;AAkKA,wCAIC;AAKD,8EAKC;AA3KD,4CAA2G;AAC3G,kDAAmG;AACnG,gEAAuG;AACvG,gEAA4F;AA+D5F;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,MAA4B,EAC5B,MAAsB;IAEtB,MAAM,EACJ,KAAK,EACL,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,aAAa,GAAG,CAAC,EACjB,MAAM,EACN,IAAI,GACL,GAAG,MAAM,CAAC;IAEX,6DAA6D;IAC7D,IAAI,CAAC,IAAA,0CAAuB,EAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,8BAA8B,YAAY,oEAAoE,CAAC,CAAC;IAClI,CAAC;IAED,+CAA+C;IAC/C,MAAM,WAAW,GAAG,IAAA,kDAA+B,EAAC,YAAY,CAAC,CAAC;IAElE,mEAAmE;IACnE,kFAAkF;IAClF,IAAA,4CAAyB,EAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAErD,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,qBAAS,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,yBAAa,EAAC,MAAM,CAAC,CAAC;IAE9E,uBAAuB;IACvB,MAAM,kBAAkB,GAAG,IAAA,kBAAS,EAAC,cAAc,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,IAAA,kBAAS,EAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,EAAE,iCAAiC,EAAE,GAAG,kBAAkB,CAAC;IACjE,MAAM,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAAC;IAEjD,2DAA2D;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,qBAAS,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,wBAAY,EAAC,MAAM,CAAC,CAAC;IAEtE,kFAAkF;IAClF,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,4BAA4B;QACnC,KAAK,EAAE,IAAA,qBAAS,EAAC,KAAK,CAAC;QACvB,YAAY,EAAE,IAAA,qBAAS,EAAC,YAAY,CAAC;QACrC,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;QAChC,WAAW,EAAE,IAAI,YAAY,EAAE;QAC/B,aAAa;QACb,WAAW,EAAE,IAAA,qBAAS,EAAC,MAAM,IAAA,iCAAqB,EAAC,MAAM,CAAC,CAAC;KAC5D,CAAC;IAEF,OAAO,iCAAiC,CACtC,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,cAAc,CAC5B,MAA4B;IAE5B,OAAO,IAAA,6BAAoB,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,SAAgB,iCAAiC,CAAC,KAAU,EAAE,OAAa;IACzE,OAAO,IAAA,6BAAoB,EAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,kBAAkB,GAAG,IAAA,kBAAS,EAAC,cAAc,CAAC,CAAC;QACrD,OAAO,kBAAkB,CAAC,iCAAiC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/index.js

@@ -14,12 +14,33 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaymentFrequency = void 0;
+exports.duration = exports.months = exports.weeks = exports.days = exports.hours = exports.minutes = exports.decaseconds = exports.validateDurationAlignment = exports.paymentFrequencyStringToSeconds = exports.paymentFrequencyToSeconds = exports.isValidPaymentFrequency = exports.getPaymentFrequencyFromString = exports.PAYMENT_FREQUENCY_CONSTANTS = exports.PAYMENT_FREQUENCY_MAP = exports.VALID_PAYMENT_FREQUENCIES = exports.PaymentFrequency = void 0;
 // Export main SDK functions
 __exportStar(require("./contract"), exports);
 __exportStar(require("./rental"), exports);
 __exportStar(require("./utils"), exports);
-// Export PaymentFrequency from utils since it's not in codama
-var constants_1 = require("./utils/constants");
-Object.defineProperty(exports, "PaymentFrequency", { enumerable: true, get: function () { return constants_1.PaymentFrequency; } });
+// Export PaymentFrequency from codama (generated from Rust)
+var paymentFrequency_1 = require("./codama/types/paymentFrequency");
+Object.defineProperty(exports, "PaymentFrequency", { enumerable: true, get: function () { return paymentFrequency_1.PaymentFrequency; } });
+// Export auto-generated payment frequency types and utilities
+var paymentFrequency_2 = require("./types/paymentFrequency");
+Object.defineProperty(exports, "VALID_PAYMENT_FREQUENCIES", { enumerable: true, get: function () { return paymentFrequency_2.VALID_PAYMENT_FREQUENCIES; } });
+Object.defineProperty(exports, "PAYMENT_FREQUENCY_MAP", { enumerable: true, get: function () { return paymentFrequency_2.PAYMENT_FREQUENCY_MAP; } });
+Object.defineProperty(exports, "PAYMENT_FREQUENCY_CONSTANTS", { enumerable: true, get: function () { return paymentFrequency_2.PAYMENT_FREQUENCY_CONSTANTS; } });
+Object.defineProperty(exports, "getPaymentFrequencyFromString", { enumerable: true, get: function () { return paymentFrequency_2.getPaymentFrequencyFromString; } });
+Object.defineProperty(exports, "isValidPaymentFrequency", { enumerable: true, get: function () { return paymentFrequency_2.isValidPaymentFrequency; } });
+// Export payment frequency utilities that mirror Rust implementation
+var paymentFrequency_3 = require("./utils/paymentFrequency");
+Object.defineProperty(exports, "paymentFrequencyToSeconds", { enumerable: true, get: function () { return paymentFrequency_3.paymentFrequencyToSeconds; } });
+Object.defineProperty(exports, "paymentFrequencyStringToSeconds", { enumerable: true, get: function () { return paymentFrequency_3.paymentFrequencyStringToSeconds; } });
+Object.defineProperty(exports, "validateDurationAlignment", { enumerable: true, get: function () { return paymentFrequency_3.validateDurationAlignment; } });
+// Export duration helper functions for convenient time unit conversion
+var duration_1 = require("./utils/duration");
+Object.defineProperty(exports, "decaseconds", { enumerable: true, get: function () { return duration_1.decaseconds; } });
+Object.defineProperty(exports, "minutes", { enumerable: true, get: function () { return duration_1.minutes; } });
+Object.defineProperty(exports, "hours", { enumerable: true, get: function () { return duration_1.hours; } });
+Object.defineProperty(exports, "days", { enumerable: true, get: function () { return duration_1.days; } });
+Object.defineProperty(exports, "weeks", { enumerable: true, get: function () { return duration_1.weeks; } });
+Object.defineProperty(exports, "months", { enumerable: true, get: function () { return duration_1.months; } });
+Object.defineProperty(exports, "duration", { enumerable: true, get: function () { return duration_1.duration; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4BAA4B;AAC5B,6CAA2B;AAC3B,2CAAyB;AACzB,0CAAwB;AAsBxB,8DAA8D;AAC9D,+CAAqD;AAA5C,6GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4BAA4B;AAC5B,6CAA2B;AAC3B,2CAAyB;AACzB,0CAAwB;AAsBxB,4DAA4D;AAC5D,oEAAmE;AAA1D,oHAAA,gBAAgB,OAAA;AAEzB,8DAA8D;AAC9D,6DAOkC;AALhC,6HAAA,yBAAyB,OAAA;AACzB,yHAAA,qBAAqB,OAAA;AACrB,+HAAA,2BAA2B,OAAA;AAC3B,iIAAA,6BAA6B,OAAA;AAC7B,2HAAA,uBAAuB,OAAA;AAGzB,qEAAqE;AACrE,6DAIkC;AAHhC,6HAAA,yBAAyB,OAAA;AACzB,mIAAA,+BAA+B,OAAA;AAC/B,6HAAA,yBAAyB,OAAA;AAG3B,uEAAuE;AACvE,6CAQ0B;AAPxB,uGAAA,WAAW,OAAA;AACX,mGAAA,OAAO,OAAA;AACP,iGAAA,KAAK,OAAA;AACL,gGAAA,IAAI,OAAA;AACJ,iGAAA,KAAK,OAAA;AACL,kGAAA,MAAM,OAAA;AACN,oGAAA,QAAQ,OAAA"}

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wuwei-labs/srsly",
-  "version": "2.0.0-beta.24",
+  "version": "2.0.0-beta.25",
   "description": "",
   "source": "./src/index.ts",
   "sideEffects": false,

package/dist/cjs/types/paymentFrequency.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * This code was AUTO-GENERATED from the Rust PaymentFrequency implementation.
+ * Please DO NOT EDIT THIS FILE manually - it will be overwritten.
+ *
+ * Source: programs/srsly/src/utils.rs
+ * Generated by: generate.mjs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_FREQUENCY_CONSTANTS = exports.PAYMENT_FREQUENCY_MAP = exports.VALID_PAYMENT_FREQUENCIES = void 0;
+exports.getPaymentFrequencyFromString = getPaymentFrequencyFromString;
+exports.isValidPaymentFrequency = isValidPaymentFrequency;
+const paymentFrequency_1 = require("../codama/types/paymentFrequency");
+/**
+ * Array of all valid payment frequency strings
+ * Auto-generated from Rust PaymentFrequency enum
+ */
+exports.VALID_PAYMENT_FREQUENCIES = [
+    'hourly',
+    'daily',
+    'weekly',
+    'monthly'
+];
+/**
+ * Mapping from user-friendly strings to PaymentFrequency enum values
+ * Auto-generated from Rust PaymentFrequency enum
+ */
+exports.PAYMENT_FREQUENCY_MAP = {
+    'hourly': paymentFrequency_1.PaymentFrequency.Hourly,
+    'daily': paymentFrequency_1.PaymentFrequency.Daily,
+    'weekly': paymentFrequency_1.PaymentFrequency.Weekly,
+    'monthly': paymentFrequency_1.PaymentFrequency.Monthly
+};
+/**
+ * Constants extracted from Rust constants.rs
+ * Auto-synced with Rust implementation
+ */
+exports.PAYMENT_FREQUENCY_CONSTANTS = {
+    SECONDS_PER_DECASECOND: 10,
+    SECONDS_PER_MINUTE: 60,
+    SECONDS_PER_HOUR: 3600,
+    SECONDS_PER_DAY: 86400,
+    SECONDS_PER_WEEK: 604800,
+    SECONDS_PER_MONTH: 2678400
+};
+/**
+ * Get PaymentFrequency enum value from user-friendly string
+ */
+function getPaymentFrequencyFromString(frequencyString) {
+    return exports.PAYMENT_FREQUENCY_MAP[frequencyString];
+}
+/**
+ * Check if a string is a valid payment frequency
+ */
+function isValidPaymentFrequency(value) {
+    return exports.VALID_PAYMENT_FREQUENCIES.includes(value);
+}
+//# sourceMappingURL=paymentFrequency.js.map

package/dist/cjs/types/paymentFrequency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentFrequency.js","sourceRoot":"","sources":["../../../src/types/paymentFrequency.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAgDH,sEAEC;AAKD,0DAEC;AAvDD,uEAAoE;AAQpE;;;GAGG;AACU,QAAA,yBAAyB,GAAsC;IAC1E,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;CACD,CAAC;AAEX;;;GAGG;AACU,QAAA,qBAAqB,GAAqD;IACrF,QAAQ,EAAE,mCAAgB,CAAC,MAAM;IACjC,OAAO,EAAE,mCAAgB,CAAC,KAAK;IAC/B,QAAQ,EAAE,mCAAgB,CAAC,MAAM;IACjC,SAAS,EAAE,mCAAgB,CAAC,OAAO;CAC3B,CAAC;AAEX;;;GAGG;AACU,QAAA,2BAA2B,GAAG;IACzC,sBAAsB,EAAE,EAAE;IAC1B,kBAAkB,EAAE,EAAE;IACtB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,MAAM;IACxB,iBAAiB,EAAE,OAAO;CAClB,CAAC;AAEX;;GAEG;AACH,SAAgB,6BAA6B,CAAC,eAAuC;IACnF,OAAO,6BAAqB,CAAC,eAAe,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,KAAa;IACnD,OAAO,iCAAyB,CAAC,QAAQ,CAAC,KAA+B,CAAC,CAAC;AAC7E,CAAC"}

package/dist/cjs/utils/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FACTION_MAPPING = exports.FACTION_SPECIFIC_CSS = exports.PaymentFrequency = exports.ATLAS_TO_STARDUST = exports.PROFILE_FACTION_SEED = exports.SAGE_PLAYER_PROFILE_SEED = exports.STARBASE_PLAYER_SEED = exports.STARBASE_SEED = void 0;
+exports.FACTION_MAPPING = exports.FACTION_SPECIFIC_CSS = exports.ATLAS_TO_STARDUST = exports.PROFILE_FACTION_SEED = exports.SAGE_PLAYER_PROFILE_SEED = exports.STARBASE_PLAYER_SEED = exports.STARBASE_SEED = void 0;
 exports.toAddress = toAddress;
 exports.getSrslyProgramAddress = getSrslyProgramAddress;
 exports.getProgramId = getProgramId;
@@ -8,7 +8,6 @@ exports.getSageProgramAddress = getSageProgramAddress;
 exports.getProfileFactionProgramAddress = getProfileFactionProgramAddress;
 exports.getSageGameId = getSageGameId;
 exports.getAtlasMint = getAtlasMint;
-exports.paymentFrequencyToString = paymentFrequencyToString;
 const config_1 = require("./config");
 const kit_1 = require("@solana/kit");
 /**
@@ -25,18 +24,7 @@ exports.SAGE_PLAYER_PROFILE_SEED = 'sage_player_profile';
 exports.PROFILE_FACTION_SEED = 'profile_faction';
 // Token conversion constants
 exports.ATLAS_TO_STARDUST = 100_000_000; // 1 ATLAS = 100,000,000 stardust
-// PaymentFrequency enum to match the Rust program
-var PaymentFrequency;
-(function (PaymentFrequency) {
-    PaymentFrequency[PaymentFrequency["Hourly"] = 0] = "Hourly";
-    PaymentFrequency[PaymentFrequency["Daily"] = 1] = "Daily";
-    PaymentFrequency[PaymentFrequency["DailyOld"] = 2] = "DailyOld";
-    PaymentFrequency[PaymentFrequency["Weekly"] = 3] = "Weekly";
-    PaymentFrequency[PaymentFrequency["Monthly"] = 4] = "Monthly";
-    // Development-only frequencies (not available on mainnet)
-    PaymentFrequency[PaymentFrequency["Decasecond"] = 5] = "Decasecond";
-    PaymentFrequency[PaymentFrequency["Minute"] = 6] = "Minute";
-})(PaymentFrequency || (exports.PaymentFrequency = PaymentFrequency = {}));
+// PaymentFrequency enum is now exported from codama-generated types
 // Network constants are now managed in config.ts
 async function getSrslyProgramAddress(config) {
     const globalConfig = (0, config_1.getConfig)();
@@ -85,10 +73,5 @@ exports.FACTION_MAPPING = {
     2: 'oni',
     3: 'ustur'
 };
-/**
- * Convert PaymentFrequency enum to string
- */
-function paymentFrequencyToString(freq) {
-    return PaymentFrequency[freq].toLowerCase();
-}
+// PaymentFrequency utilities are now in utils/paymentFrequency.ts
 //# sourceMappingURL=constants.js.map

package/dist/cjs/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/duration.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.duration = void 0;
+exports.decaseconds = decaseconds;
+exports.minutes = minutes;
+exports.hours = hours;
+exports.days = days;
+exports.weeks = weeks;
+exports.months = months;
+const paymentFrequency_1 = require("../types/paymentFrequency");
+/**
+ * Duration helper functions for converting time units to seconds
+ * Uses the same constants as the payment frequency system for consistency
+ */
+const { SECONDS_PER_DECASECOND, SECONDS_PER_MINUTE, SECONDS_PER_HOUR, SECONDS_PER_DAY, SECONDS_PER_WEEK, SECONDS_PER_MONTH } = paymentFrequency_1.PAYMENT_FREQUENCY_CONSTANTS;
+/**
+ * Convert decaseconds (10 seconds) to seconds
+ * @param amount Number of decaseconds
+ * @returns Number of seconds
+ */
+function decaseconds(amount) {
+    return amount * SECONDS_PER_DECASECOND;
+}
+/**
+ * Convert minutes to seconds
+ * @param amount Number of minutes
+ * @returns Number of seconds
+ */
+function minutes(amount) {
+    return amount * SECONDS_PER_MINUTE;
+}
+/**
+ * Convert hours to seconds
+ * @param amount Number of hours
+ * @returns Number of seconds
+ */
+function hours(amount) {
+    return amount * SECONDS_PER_HOUR;
+}
+/**
+ * Convert days to seconds
+ * @param amount Number of days
+ * @returns Number of seconds
+ */
+function days(amount) {
+    return amount * SECONDS_PER_DAY;
+}
+/**
+ * Convert weeks to seconds
+ * @param amount Number of weeks
+ * @returns Number of seconds
+ */
+function weeks(amount) {
+    return amount * SECONDS_PER_WEEK;
+}
+/**
+ * Convert months to seconds
+ * @param amount Number of months (31 days each)
+ * @returns Number of seconds
+ */
+function months(amount) {
+    return amount * SECONDS_PER_MONTH;
+}
+/**
+ * All duration helper functions
+ */
+exports.duration = {
+    decaseconds,
+    minutes,
+    hours,
+    days,
+    weeks,
+    months,
+    // Also expose the raw constants for advanced users
+    constants: paymentFrequency_1.PAYMENT_FREQUENCY_CONSTANTS,
+};
+//# sourceMappingURL=duration.js.map

package/dist/cjs/utils/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../../src/utils/duration.ts"],"names":[],"mappings":";;;AAqBA,kCAEC;AAOD,0BAEC;AAOD,sBAEC;AAOD,oBAEC;AAOD,sBAEC;AAOD,wBAEC;AApED,gEAAwE;AAExE;;;GAGG;AAEH,MAAM,EACJ,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAClB,GAAG,8CAA2B,CAAC;AAEhC;;;;GAIG;AACH,SAAgB,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,GAAG,sBAAsB,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,OAAO,CAAC,MAAc;IACpC,OAAO,MAAM,GAAG,kBAAkB,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAC,MAAc;IAClC,OAAO,MAAM,GAAG,gBAAgB,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,SAAgB,IAAI,CAAC,MAAc;IACjC,OAAO,MAAM,GAAG,eAAe,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAC,MAAc;IAClC,OAAO,MAAM,GAAG,gBAAgB,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,SAAgB,MAAM,CAAC,MAAc;IACnC,OAAO,MAAM,GAAG,iBAAiB,CAAC;AACpC,CAAC;AAED;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,WAAW;IACX,OAAO;IACP,KAAK;IACL,IAAI;IACJ,KAAK;IACL,MAAM;IAEN,mDAAmD;IACnD,SAAS,EAAE,8CAA2B;CAC9B,CAAC"}

package/dist/cjs/utils/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./constants"), exports);
 __exportStar(require("./profiles"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./paymentFrequency"), exports);
+__exportStar(require("./duration"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6CAA2B;AAC3B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6CAA2B;AAC3B,2CAAyB;AACzB,qDAAmC;AACnC,6CAA2B"}

package/dist/cjs/utils/paymentFrequency.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paymentFrequencyToSeconds = paymentFrequencyToSeconds;
+exports.paymentFrequencyStringToSeconds = paymentFrequencyStringToSeconds;
+exports.validateDurationAlignment = validateDurationAlignment;
+const paymentFrequency_1 = require("../codama/types/paymentFrequency");
+const paymentFrequency_2 = require("../types/paymentFrequency");
+/**
+ * Payment frequency conversion utilities
+ * Mirrors the Rust implementation in programs/srsly/src/utils.rs
+ * Uses auto-generated constants and mappings from Rust source
+ */
+// Auto-synced constants from Rust constants.rs
+const { SECONDS_PER_DECASECOND, SECONDS_PER_MINUTE, SECONDS_PER_HOUR, SECONDS_PER_DAY, SECONDS_PER_WEEK, SECONDS_PER_MONTH } = paymentFrequency_2.PAYMENT_FREQUENCY_CONSTANTS;
+/**
+ * Converts a PaymentFrequency enum value to seconds
+ * Mirrors the to_seconds() method from the Rust implementation
+ */
+function paymentFrequencyToSeconds(frequency) {
+    switch (frequency) {
+        case paymentFrequency_1.PaymentFrequency.Decasecond:
+            return SECONDS_PER_DECASECOND;
+        case paymentFrequency_1.PaymentFrequency.Minute:
+            return SECONDS_PER_MINUTE;
+        case paymentFrequency_1.PaymentFrequency.Hourly:
+            return SECONDS_PER_HOUR;
+        case paymentFrequency_1.PaymentFrequency.Daily:
+        case paymentFrequency_1.PaymentFrequency.DailyOld:
+            return SECONDS_PER_DAY;
+        case paymentFrequency_1.PaymentFrequency.Weekly:
+            return SECONDS_PER_WEEK;
+        case paymentFrequency_1.PaymentFrequency.Monthly:
+            return SECONDS_PER_MONTH;
+        default:
+            throw new Error(`Unknown payment frequency: ${frequency}`);
+    }
+}
+/**
+ * Converts a payment frequency string to seconds
+ * Uses auto-generated mapping from Rust PaymentFrequency enum
+ */
+function paymentFrequencyStringToSeconds(frequencyString) {
+    const frequency = paymentFrequency_2.PAYMENT_FREQUENCY_MAP[frequencyString];
+    if (frequency === undefined) {
+        throw new Error(`Invalid payment frequency string: ${frequencyString}`);
+    }
+    return paymentFrequencyToSeconds(frequency);
+}
+/**
+ * Validates that a duration is a multiple of the payment frequency
+ * Uses auto-generated types from Rust PaymentFrequency enum
+ */
+function validateDurationAlignment(duration, frequencyString) {
+    const durationNumber = Number(duration);
+    const frequencySeconds = paymentFrequencyStringToSeconds(frequencyString);
+    if (durationNumber % frequencySeconds !== 0) {
+        throw new Error(`Duration (${duration} seconds) must be a multiple of ${frequencyString} frequency (${frequencySeconds} seconds)`);
+    }
+}
+//# sourceMappingURL=paymentFrequency.js.map