@wuwei-labs/srsly 2.0.0-beta.7 → 2.3.3-canary.36.16828734028.0

package/dist/esm/utils/schedule-validation.js

@@ -0,0 +1,132 @@
+/**
+ * @purpose Payment schedule validation utilities for rental contracts
+ * @reviewed 2025-08-05
+ */
+import { validateCronExpression, calculatePaymentSchedule, parseScheduleString } from './cron';
+import { paymentFrequencyStringToSeconds, normalizePaymentSchedule } from './payment-frequency';
+import { CRON_TO_PAYMENT_FREQUENCY } from '../types/payment-frequency';
+/**
+ * Validate rental payment schedule.
+ *
+ * @param schedule - Payment schedule (frequency string or cron)
+ * @param duration - Rental duration in seconds
+ * @param minDuration - Minimum duration
+ * @param maxDuration - Maximum duration
+ * @returns Validation result
+ */
+export function validateRentalSchedule(schedule, duration, minDuration, maxDuration) {
+    const errors = [];
+    const warnings = [];
+    // Normalize schedule
+    let normalizedSchedule;
+    try {
+        normalizedSchedule = normalizePaymentSchedule(schedule);
+    }
+    catch (error) {
+        errors.push('Invalid payment schedule');
+        return { valid: false, errors, warnings };
+    }
+    // Validate cron
+    if (!validateCronExpression(normalizedSchedule)) {
+        errors.push('Invalid cron expression');
+        return { valid: false, errors, warnings };
+    }
+    // Validate duration bounds
+    if (duration < minDuration) {
+        errors.push('Duration is less than minimum');
+    }
+    if (duration > maxDuration) {
+        errors.push('Duration exceeds maximum');
+    }
+    // Check duration alignment for standard frequencies
+    try {
+        const parsed = parseScheduleString(normalizedSchedule);
+        if (parsed.type === 'enum' && CRON_TO_PAYMENT_FREQUENCY[normalizedSchedule]) {
+            try {
+                const frequencySeconds = paymentFrequencyStringToSeconds(normalizedSchedule);
+                if (duration % frequencySeconds !== 0) {
+                    warnings.push('Duration is not aligned with payment frequency');
+                }
+            }
+            catch {
+                // Custom expression
+            }
+        }
+    }
+    catch {
+        // Continue
+    }
+    // Calculate payments
+    const now = Math.floor(Date.now() / 1000);
+    let paymentInfo;
+    try {
+        paymentInfo = calculatePaymentSchedule(normalizedSchedule, now, duration);
+        if (paymentInfo.totalPayments === 0) {
+            errors.push('No payments would occur');
+        }
+        else if (paymentInfo.totalPayments === 1) {
+            warnings.push('Only one payment will occur');
+        }
+    }
+    catch (error) {
+        errors.push('Failed to calculate payment schedule');
+        return { valid: false, errors, warnings, normalizedSchedule };
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        normalizedSchedule,
+        paymentCount: paymentInfo.totalPayments,
+        firstPayment: paymentInfo.times[0] ? new Date(paymentInfo.times[0] * 1000) : undefined,
+        lastPayment: paymentInfo.times[paymentInfo.times.length - 1]
+            ? new Date(paymentInfo.times[paymentInfo.times.length - 1] * 1000)
+            : undefined,
+    };
+}
+/**
+ * Check if frequency is appropriate for duration.
+ *
+ * @param frequency - Payment frequency
+ * @param duration - Duration in seconds
+ * @returns Validation result with suggestions
+ */
+export function validateFrequencyForDuration(frequency, duration) {
+    const hour = 3600;
+    const day = 86400;
+    const week = 604800;
+    // Calculate payments
+    const normalizedSchedule = normalizePaymentSchedule(frequency);
+    const now = Math.floor(Date.now() / 1000);
+    const { totalPayments } = calculatePaymentSchedule(normalizedSchedule, now, duration);
+    const suggestions = [];
+    let appropriate = true;
+    let reason;
+    // Too many payments
+    if (totalPayments > 100) {
+        appropriate = false;
+        reason = 'Too many payments';
+        if (duration >= week) {
+            suggestions.push('@daily', '@weekly');
+        }
+        else if (duration >= day) {
+            suggestions.push('@hourly', '@daily');
+        }
+    }
+    // Too few payments
+    if (totalPayments < 2) {
+        appropriate = false;
+        reason = 'Too few payments';
+        if (duration >= week * 4) {
+            suggestions.push('@weekly', '@daily');
+        }
+        else if (duration >= week) {
+            suggestions.push('@daily');
+        }
+        else if (duration >= day) {
+            suggestions.push('@hourly');
+        }
+    }
+    return { appropriate, reason, suggestions };
+}
+//# sourceMappingURL=schedule-validation.js.map

package/dist/esm/utils/schedule-validation.js.map

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

package/dist/esm/utils/signer.js

@@ -0,0 +1,119 @@
+/**
+ * @purpose Universal signer handling utilities for @solana/kit compatibility
+ * @reviewed 2025-07-29
+ *
+ * This module provides utilities to handle different signer types in a unified way
+ * while ensuring compatibility with @solana/kit. Supports string addresses for
+ * browser usage and TransactionSigner objects for Node.js usage.
+ *
+ * Note: web3.js signers (Keypair, etc.) are explicitly not supported.
+ * Use address strings or @solana/kit TransactionSigner objects instead.
+ */
+import { createNoopSigner, address, isAddress } from '@solana/kit';
+/**
+ * Error thrown when an invalid signer type is provided.
+ *
+ * @class InvalidSignerError
+ */
+export class InvalidSignerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidSignerError';
+    }
+}
+/**
+ * Validates signer compatibility with @solana/kit.
+ *
+ * @param signer - The signer to validate
+ * @throws {InvalidSignerError} If the signer is not compatible
+ */
+export function validateSigner(signer) {
+    if (typeof signer === 'string') {
+        // Validate that the string is a valid Solana address
+        try {
+            // Use @solana/kit's address() function to validate - it will throw if invalid
+            address(signer);
+            return;
+        }
+        catch (error) {
+            throw new InvalidSignerError(`Invalid address string: "${signer}". ${error instanceof Error ? error.message : 'Unknown validation error'}\n\n` +
+                'Expected a valid base58-encoded Solana address (32-44 characters).\n' +
+                'Examples:\n' +
+                '  - "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"\n' +
+                '  - "So11111111111111111111111111111111111111112"');
+        }
+    }
+    if (signer && typeof signer === 'object') {
+        const signerObj = signer;
+        // Check for web3.js Keypair or similar patterns
+        if ('publicKey' in signerObj) {
+            throw new InvalidSignerError('web3.js signers (Keypair, etc.) are not supported. ' +
+                'Use a base58 address string or TransactionSigner from @solana/kit instead.\n\n' +
+                'Examples:\n' +
+                '  - Browser: "base58AddressString"\n' +
+                '  - Node.js: createNoopSigner(address("base58AddressString"))');
+        }
+        // Check for valid @solana/kit signer patterns
+        if ('address' in signerObj || typeof signerObj.signTransactions === 'function') {
+            // If it has an address property, validate that the address is valid
+            if ('address' in signerObj) {
+                try {
+                    // Ensure the address property is a valid Address type
+                    if (!isAddress(signerObj.address)) {
+                        throw new InvalidSignerError(`Signer object has invalid address property. Expected Address type from @solana/kit.`);
+                    }
+                }
+                catch (error) {
+                    throw new InvalidSignerError(`Signer object has invalid address property: ${error instanceof Error ? error.message : 'Unknown validation error'}`);
+                }
+            }
+            return;
+        }
+        // Unknown signer object format
+        throw new InvalidSignerError('Invalid signer format. Expected:\n' +
+            '  - base58 address string (browser usage)\n' +
+            '  - TransactionSigner from @solana/kit (Node.js usage)\n' +
+            '  - Object with address property');
+    }
+    throw new InvalidSignerError('Signer must be a string address or compatible signer object');
+}
+/**
+ * Creates TransactionSigner from UniversalSigner input with validation.
+ *
+ * Converts string addresses to TransactionSigner objects and validates compatibility.
+ * Supports both browser (string addresses) and Node.js (TransactionSigner) usage.
+ *
+ * @param signer - String address or kit-compatible signer
+ * @returns TransactionSigner with .address property for PDA derivation and signing
+ * @throws {InvalidSignerError} If the signer is not compatible
+ *
+ * @example
+ * ```typescript
+ * const signer = createTransactionSigner("9Wz...WWM");
+ * const nodeSigner = createTransactionSigner(wallet);
+ * ```
+ */
+export function createTransactionSigner(signer) {
+    // Validate the signer first
+    validateSigner(signer);
+    // Handle string address case (browser usage)
+    if (typeof signer === 'string') {
+        const addr = address(signer);
+        return createNoopSigner(addr);
+    }
+    // Handle signer object cases (already validated TransactionSigner objects)
+    return signer;
+}
+/**
+ * Type guard to check if a value is a signer object (not a string).
+ */
+export function isSignerObject(signer) {
+    return typeof signer !== 'string';
+}
+/**
+ * Type guard to check if a value is an address string.
+ */
+export function isAddressString(signer) {
+    return typeof signer === 'string';
+}
+//# sourceMappingURL=signer.js.map

package/dist/esm/utils/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAE3F;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAYD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,qDAAqD;QACrD,IAAI,CAAC;YACH,8EAA8E;YAC9E,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,MAAM;gBAC/G,sEAAsE;gBACtE,aAAa;gBACb,sDAAsD;gBACtD,mDAAmD,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,MAA6B,CAAC;QAEhD,gDAAgD;QAChD,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAC1B,qDAAqD;gBACnD,gFAAgF;gBAChF,aAAa;gBACb,sCAAsC;gBACtC,+DAA+D,CAClE,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,IAAI,SAAS,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC/E,oEAAoE;YACpE,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,sDAAsD;oBACtD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;wBAClC,MAAM,IAAI,kBAAkB,CAC1B,qFAAqF,CACtF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,kBAAkB,CAC1B,+CAA+C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,EAAE,CACrH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,MAAM,IAAI,kBAAkB,CAC1B,oCAAoC;YAClC,6CAA6C;YAC7C,0DAA0D;YAC1D,kCAAkC,CACrC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,kBAAkB,CAAC,6DAA6D,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC7D,4BAA4B;IAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,6CAA6C;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,2EAA2E;IAC3E,OAAO,MAA2B,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAuB;IAEvB,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC"}

package/dist/esm/utils/smart-params.js

@@ -0,0 +1,49 @@
+/**
+ * @purpose Smart parameter types for intuitive SDK usage with ATLAS-first design
+ * @reviewed 2025-08-05
+ */
+/**
+ * Duration builder functions for cleaner syntax.
+ *
+ * @example
+ * import { duration } from '@wuwei-labs/srsly';
+ *
+ * const oneWeek = duration.days(7);
+ * const twoHours = duration.hours(2);
+ * const customTime = duration.weeks(2).add(duration.days(3));
+ */
+export const duration = {
+    seconds: (n) => ({ seconds: n }),
+    minutes: (n) => ({ minutes: n }),
+    hours: (n) => ({ hours: n }),
+    days: (n) => ({ days: n }),
+    weeks: (n) => ({ weeks: n }),
+    months: (n) => ({ months: n }),
+};
+/**
+ * Amount builder functions for explicit units.
+ *
+ * @example
+ * import { amount } from '@wuwei-labs/srsly';
+ *
+ * const payment = amount.atlas(1.5);
+ * const precise = amount.stardust(150_000_001);
+ */
+export const amount = {
+    atlas: (n) => ({ atlas: n }),
+    stardust: (n) => ({ stardust: n }),
+};
+/**
+ * Percentage builder functions.
+ *
+ * @example
+ * import { percentage } from '@wuwei-labs/srsly';
+ *
+ * const tenPercent = percentage.percent(10);
+ * const precise = percentage.basisPoints(1050); // 10.5%
+ */
+export const percentage = {
+    percent: (n) => ({ percent: n }),
+    basisPoints: (n) => ({ basisPoints: n }),
+};
+//# sourceMappingURL=smart-params.js.map

package/dist/esm/utils/smart-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-params.js","sourceRoot":"","sources":["../../../src/utils/smart-params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvD,KAAK,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACnD,IAAI,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACjD,KAAK,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACnD,MAAM,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,CAAS,EAAe,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAS,EAAe,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;CAC/C,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC,CAAS,EAAmB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACzD,WAAW,EAAE,CAAC,CAAS,EAAmB,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;CACzD,CAAC"}

package/dist/types/config/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @purpose Export all config-related operations for SRSLY SDK
+ * @reviewed 2025-07-31
+ */
+export { initializeConfig, type InitializeConfigParams } from './initialize';
+export { updateConfig, type UpdateConfigParams } from './update';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/config/initialize.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @purpose Initialize SRSLY program configuration
+ * @reviewed 2025-07-31
+ */
+import { type FluentInstruction, type SmartFluentConfigSelector } from '../utils/instruction-converter';
+import { type UniversalSigner } from '../utils/signer';
+type UniversalAddress = string;
+/**
+ * Parameters for initializing the SRSLY program configuration.
+ *
+ * @interface InitializeConfigParams
+ */
+export interface InitializeConfigParams {
+    /**
+     * Authority signer who will become the config authority.
+     * Can be a Keypair, PublicKey string, or wallet adapter.
+     * @example wallet.publicKey
+     */
+    authority: UniversalSigner;
+    /**
+     * Fee collection account address.
+     * @example 'FeesAccount11111111111111111111111111111111'
+     */
+    feesAccount: UniversalAddress;
+    /**
+     * ATLAS token mint address (optional, defaults to known ATLAS mint).
+     * @example 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx'
+     */
+    atlasMint?: UniversalAddress;
+}
+/**
+ * Initialize the SRSLY program configuration.
+ *
+ * This is a one-time operation that creates the global config account with default values.
+ * After initialization, the config can be updated using the updateConfig function.
+ *
+ * The initialization sets:
+ * - Config authority (who can update the config)
+ * - Fee collection account
+ * - ATLAS token mint
+ * - Default values for all other settings
+ *
+ * @param params - Configuration initialization parameters
+ * @returns SmartFluentConfigSelector for chainable configuration
+ *
+ * @example
+ * ```typescript
+ * // Initialize config with basic settings
+ * const instruction = await initializeConfig({
+ *   authority: wallet,
+ *   feesAccount: 'FeesAccount11111111111111111111111111111111',
+ * }).build();
+ *
+ * // Initialize with custom ATLAS mint
+ * const instruction = await initializeConfig({
+ *   authority: wallet,
+ *   feesAccount: 'FeesAccount11111111111111111111111111111111',
+ *   atlasMint: 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx',
+ * })
+ * .set({ rpcUrl: 'https://custom.rpc.url' })
+ * .build();
+ * ```
+ */
+export declare function initializeConfig(params: InitializeConfigParams): SmartFluentConfigSelector<FluentInstruction>;
+export {};
+//# sourceMappingURL=initialize.d.ts.map

package/dist/types/config/initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../src/config/initialize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGhF,KAAK,gBAAgB,GAAG,MAAM,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;;OAGG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAE9B;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAiDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,GAC7B,yBAAyB,CAAC,iBAAiB,CAAC,CAI9C"}

package/dist/types/config/update.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @purpose Update SRSLY program configuration with SDK wrapper
+ * @reviewed 2025-07-31
+ */
+import { type FluentInstruction, type SmartFluentConfigSelector } from '../utils/instruction-converter';
+import { type UniversalSigner } from '../utils/signer';
+import type { PaymentFrequencyString } from '../types/payment-frequency';
+import type { DurationParam } from '../utils/smart-params';
+type UniversalAddress = string;
+/**
+ * Parameters for updating the SRSLY program configuration.
+ *
+ * All fields are optional - only provide the ones you want to update.
+ * The current config authority must sign this transaction.
+ *
+ * @interface UpdateConfigParams
+ */
+export interface UpdateConfigParams {
+    /**
+     * Authority signer (required - must be current config authority).
+     * Can be a Keypair, PublicKey string, or wallet adapter.
+     * @example wallet.publicKey
+     */
+    authority: UniversalSigner;
+    /**
+     * New config authority address (transfers ownership).
+     * WARNING: This is irreversible!
+     * @example 'NewAuthority1111111111111111111111111111111'
+     */
+    newAuthority?: UniversalAddress;
+    /**
+     * Stardust to ATLAS conversion rate.
+     * @example 100000000 // 100M stardust = 1 ATLAS
+     */
+    stardustToAtlas?: number | bigint;
+    /**
+     * Service fee in basis points (max 1000 = 10%).
+     * @example 500 // 5%
+     */
+    serviceFeeBps?: number | bigint;
+    /**
+     * Basis points denominator.
+     * @example 10000 // 100%
+     */
+    baseBps?: number | bigint;
+    /**
+     * Minimum rental duration.
+     * Can be specified as seconds (number) or time units (object).
+     * @example { hours: 1 } // 1 hour minimum
+     * @example 3600 // 1 hour in seconds (backwards compatible)
+     */
+    rentalDurationMin?: DurationParam;
+    /**
+     * Maximum rental duration.
+     * Can be specified as seconds (number) or time units (object).
+     * @example { months: 3 } // 3 months maximum
+     * @example 8035200 // ~3 months in seconds (backwards compatible)
+     */
+    rentalDurationMax?: DurationParam;
+    /**
+     * Fee collection account address.
+     * @example 'FeesAccount11111111111111111111111111111111'
+     */
+    feesAccount?: UniversalAddress;
+    /**
+     * ATLAS token mint address.
+     * @example 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx'
+     */
+    atlasMint?: UniversalAddress;
+    /**
+     * Default payment frequency for new contracts.
+     * @example 'daily'
+     */
+    defaultPaymentFrequency?: PaymentFrequencyString;
+    /**
+     * Allowed payment frequencies for contracts.
+     * @example ['hourly', 'daily', 'weekly', 'monthly']
+     */
+    allowedFrequencies?: PaymentFrequencyString[];
+}
+/**
+ * Update the SRSLY program configuration with fluent configuration support.
+ *
+ * This is the main function for updating the program configuration on the SRSLY program.
+ * It provides a unified API that works with both @solana/kit and @solana/web3.js
+ * libraries, using strings for all addresses to eliminate compatibility issues.
+ *
+ * @param params - Configuration update parameters
+ * @returns SmartFluentConfigSelector for chainable configuration
+ *
+ * @example
+ * ```typescript
+ * // Update service fee
+ * const instruction = await updateConfig({
+ *   authority: wallet,
+ *   serviceFeeBps: 750, // 7.5%
+ * }).build();
+ *
+ * // Update duration limits with smart parameters
+ * const durationInstruction = await updateConfig({
+ *   authority: wallet,
+ *   rentalDurationMin: { hours: 1 },     // 1 hour minimum
+ *   rentalDurationMax: { months: 3 },    // 3 months maximum
+ * }).build();
+ *
+ * // Transfer authority with custom RPC
+ * const transferInstruction = await updateConfig({
+ *   authority: currentAuthority,
+ *   newAuthority: 'NewAuthority1111111111111111111111111111111',
+ * })
+ * .set({ rpcUrl: 'https://custom.rpc.url' })
+ * .build();
+ *
+ * // Update multiple settings with mainnet config
+ * const multiUpdateInstruction = await updateConfig({
+ *   authority: wallet,
+ *   serviceFeeBps: 500,
+ *   feesAccount: 'NewFeesAccount11111111111111111111111111111',
+ *   rentalDurationMin: { days: 1 },      // 1 day minimum
+ *   rentalDurationMax: { weeks: 12 },    // 12 weeks maximum
+ *   defaultPaymentFrequency: 'weekly',
+ *   allowedFrequencies: ['daily', 'weekly', 'monthly'],
+ * })
+ * .set({ programs: 'mainnet' })
+ * .build();
+ *
+ * // Backwards compatible - using seconds directly
+ * const legacyInstruction = await updateConfig({
+ *   authority: wallet,
+ *   rentalDurationMin: 3600,    // 1 hour in seconds
+ *   rentalDurationMax: 7776000, // 90 days in seconds
+ * }).build();
+ * ```
+ */
+export declare function updateConfig(params: UpdateConfigParams): SmartFluentConfigSelector<FluentInstruction>;
+export declare const updateConfigDemo: {
+    tabName: string;
+    description: string;
+    imports: string;
+    instruction: string;
+};
+export {};
+//# sourceMappingURL=update.d.ts.map

package/dist/types/config/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/config/update.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,KAAK,gBAAgB,GAAG,MAAM,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAElC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAElC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAElC;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAE/B;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,sBAAsB,CAAC;IAEjD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC/C;AA6FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,GACzB,yBAAyB,CAAC,iBAAiB,CAAC,CAI9C;AAGD,eAAO,MAAM,gBAAgB;;;;;CAW5B,CAAC"}