@wuwei-labs/srsly 2.3.3-canary.36.16828894446.0 → 3.0.0-beta.2

package/dist/types/instructions/updateConfig.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @purpose Simplified updateConfig instruction wrapper
+ *
+ * Thin convenience wrapper around Codama-generated updateConfig instruction.
+ * Updates the global program configuration settings.
+ */
+import { type Address } from '@solana/kit';
+import { type SdkConfig } from '../utils/config';
+import { type UniversalSigner } from '../utils/signer';
+import type { PaymentFrequencyArgs } from '../generated/codama/types';
+import { prepareInstructions } from '../utils/instructions';
+/**
+ * Parameters for updating the global program configuration
+ * All fields are optional - only provide the ones you want to update
+ */
+export interface UpdateConfigParams {
+    /**
+     * Admin who has permission to update config
+     * Accepts string address, web3.js Keypair, or @solana/kit signer
+     */
+    admin: UniversalSigner;
+    /**
+     * New admin address (updates the admin)
+     */
+    newAdmin?: Address | string | null;
+    /**
+     * Stardust to ATLAS conversion rate
+     */
+    stardustToAtlas?: number | bigint | null;
+    /**
+     * Service fee in basis points (1000 = 10%)
+     */
+    serviceFeeBps?: number | bigint | null;
+    /**
+     * Basis points denominator
+     */
+    baseBps?: number | null;
+    /**
+     * Minimum rental duration in seconds
+     */
+    rentalDurationMinSeconds?: number | bigint | null;
+    /**
+     * Maximum rental duration in seconds
+     */
+    rentalDurationMaxSeconds?: number | bigint | null;
+    /**
+     * ATLAS token mint address
+     */
+    atlasMint?: Address | string | null;
+    /**
+     * Default payment frequency
+     */
+    defaultPaymentFrequency?: PaymentFrequencyArgs | null;
+    /**
+     * Allowed payment frequencies
+     */
+    allowedFrequencies?: Array<PaymentFrequencyArgs> | null;
+    /**
+     * Whether reservation system is enabled
+     */
+    reservationsEnabled?: boolean | null;
+    /**
+     * Capture points awarded per day of rental
+     */
+    pointsPerDay?: number | null;
+    /**
+     * Points penalty for cancelling a rental
+     */
+    cancellationPenalty?: number | null;
+    /**
+     * Hours a reserver has exclusive access after reserving
+     */
+    reservationWindowHours?: number | bigint | null;
+    /**
+     * Minimum points needed to capture a flag
+     */
+    minCaptureThreshold?: number | null;
+    /**
+     * Base for logarithmic weight calculation
+     */
+    weightBase?: number | null;
+    /**
+     * Multiplier for weight calculation
+     */
+    weightMultiplier?: number | null;
+    /**
+     * Maximum weight value
+     */
+    maxWeight?: number | null;
+    /**
+     * Rate increase in basis points after capture (10000 = 100%, 11000 = 110%)
+     */
+    captureRateBps?: number | bigint | null;
+    /**
+     * Maximum discount rate for borrowers (global setting)
+     */
+    maxDiscountBps?: number | null;
+    /**
+     * ATLAS lamports per point equivalent for reservation bidding
+     */
+    atlasPerPoint?: number | bigint | null;
+    /**
+     * Optional compute units to allocate for the transaction
+     * @example 400000
+     */
+    computeUnits?: number;
+}
+/**
+ * Update program configuration
+ *
+ * Updates one or more global program configuration settings.
+ * Only provide the fields you want to update - all are optional.
+ *
+ * @param params - Configuration update parameters
+ * @param config - Optional SDK configuration overrides
+ * @returns Kit instruction (or web3.js if PublicKey in config)
+ *
+ * @example
+ * ```typescript
+ * // Update service fee
+ * const ix = await updateConfig({
+ *   admin: adminWallet,
+ *   serviceFeeBps: 1000  // 10%
+ * });
+ *
+ * // Update multiple settings
+ * const ix2 = await updateConfig({
+ *   admin: adminWallet,
+ *   serviceFeeBps: 1500,
+ *   reservationsEnabled: true,
+ *   pointsPerDay: 100
+ * });
+ *
+ * // Change admin
+ * const ix3 = await updateConfig({
+ *   admin: currentAdmin,
+ *   newAdmin: newAdminAddress
+ * });
+ * ```
+ */
+export declare function updateConfig(params: UpdateConfigParams, config?: Partial<SdkConfig>): Promise<ReturnType<typeof prepareInstructions>>;
+//# sourceMappingURL=updateConfig.d.ts.map

package/dist/types/instructions/updateConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateConfig.d.ts","sourceRoot":"","sources":["../../../src/instructions/updateConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,OAAO,EAEb,MAAM,aAAa,CAAC;AAErB,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,EAAE,eAAe,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAElD;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,uBAAuB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEtD;;OAEG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAExD;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEvC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAC1B,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CA0DjD"}

package/dist/types/instructions/updateContract.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @purpose Simplified updateContract instruction wrapper
+ *
+ * Thin convenience wrapper around Codama-generated updateContract instruction.
+ * Allows updating any subset of contract fields while a contract has no active rental.
+ */
+import { type Address } from '@solana/kit';
+import { type SdkConfig } from '../utils/config';
+import { type UniversalSigner } from '../utils/signer';
+import { type AmountParam } from '../params/amount';
+import { type DurationParam } from '../params/duration';
+import { type ScheduleParam } from '../params/schedule';
+import { prepareInstructions } from '../utils/instructions';
+/**
+ * Parameters for updating a rental contract
+ * All update fields are optional - only pass what you want to change
+ */
+export interface UpdateContractParams {
+    /**
+     * Contract owner (must be the original owner)
+     * Accepts string address, web3.js Keypair, or @solana/kit signer
+     */
+    owner: UniversalSigner;
+    /**
+     * Contract address to update
+     */
+    contract: Address | string;
+    /**
+     * New rental rate per payment period (optional)
+     * @example 100 // 100 ATLAS
+     * @example { atlas: 1.5 } // 1.5 ATLAS
+     * @example { stardust: 150_000_000 } // Explicit stardust
+     */
+    rate?: AmountParam;
+    /**
+     * New minimum rental duration (optional)
+     * @example { hours: 1 } // 1 hour minimum
+     * @example { days: 1 } // 1 day minimum
+     * @example 3600 // 1 hour in seconds
+     */
+    durationMin?: DurationParam;
+    /**
+     * New maximum rental duration (optional)
+     * @example { days: 30 } // 30 day maximum
+     * @example { months: 3 } // 3 month maximum
+     * @example 2592000 // 30 days in seconds
+     */
+    durationMax?: DurationParam;
+    /**
+     * New payment schedule (optional)
+     * @example '@daily'
+     * @example 'hourly'
+     * @example '0 * * * *' // Cron expression
+     */
+    paymentsFreq?: ScheduleParam;
+    /**
+     * Whether borrowers can cancel with delay=0 (instant cancellation)
+     * When enabled, borrowers can immediately end rentals and trigger cleanup.
+     * When disabled, borrowers must use deferred cancellation (delay > 0).
+     */
+    allowInstantCancel?: boolean;
+    /**
+     * Whether reservations are disabled for this contract
+     * When enabled, other borrowers cannot reserve this contract.
+     * Owners can use this to opt out of the reservation system.
+     */
+    reservationsDisabled?: boolean;
+    /**
+     * Optional compute units to allocate for the transaction
+     * @example 400000
+     */
+    computeUnits?: number;
+}
+/**
+ * Update an existing rental contract
+ *
+ * Allows the contract owner to update any subset of contract settings.
+ * Contract must not have an active rental.
+ *
+ * @param params - Contract update parameters
+ * @param config - Optional SDK configuration overrides
+ * @returns Kit instruction (or web3.js if PublicKey in config)
+ *
+ * @example
+ * ```typescript
+ * // Update only the rate
+ * const ix = await updateContract({
+ *   owner: wallet,
+ *   contract: contractAddress,
+ *   rate: 150 // Increase rate to 150 ATLAS
+ * });
+ *
+ * // Update multiple fields
+ * const ix2 = await updateContract({
+ *   owner: wallet,
+ *   contract: contractAddress,
+ *   rate: 100,
+ *   durationMax: { days: 60 },
+ *   paymentsFreq: '@weekly'
+ * });
+ *
+ * // With web3.js
+ * import { PublicKey } from '@solana/web3.js';
+ * setSdkConfig({ network: 'mainnet-beta', PublicKey });
+ * const web3Ix = await updateContract({
+ *   owner: keypair,
+ *   contract: contractPubkey,
+ *   rate: { atlas: 2.5 }
+ * });
+ * ```
+ */
+export declare function updateContract(params: UpdateContractParams, config?: Partial<SdkConfig>): Promise<ReturnType<typeof prepareInstructions>>;
+//# sourceMappingURL=updateContract.d.ts.map

package/dist/types/instructions/updateContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateContract.d.ts","sourceRoot":"","sources":["../../../src/instructions/updateContract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,EAAE,eAAe,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAE3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC;IAE7B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAC1B,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAoEjD"}

package/dist/types/params/amount.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @purpose Amount parameter conversion utilities
+ *
+ * Converts user-friendly ATLAS amounts to stardust (smallest unit) for use with Solana programs.
+ * 1 ATLAS = 100,000,000 stardust (8 decimal places)
+ */
+/**
+ * Amount parameter type
+ *
+ * Accepts either:
+ * - Plain number (interpreted as ATLAS)
+ * - Object with explicit units (atlas or stardust)
+ */
+export type AmountParam = number | {
+    atlas: number;
+} | {
+    stardust: number;
+};
+/**
+ * Convert amount parameter to stardust (smallest unit)
+ *
+ * @param amount - Amount in any supported format
+ * @returns Amount in stardust (u64 for Solana program)
+ * @throws Error if amount is invalid or negative
+ *
+ * @example
+ * ```typescript
+ * convertAmount(100)                    // 10_000_000_000 stardust (100 ATLAS)
+ * convertAmount({ atlas: 10 })          // 1_000_000_000 stardust (10 ATLAS)
+ * convertAmount({ stardust: 1000000 })  // 1_000_000 stardust (0.01 ATLAS)
+ * ```
+ */
+export declare function convertAmount(amount: AmountParam): bigint;
+/**
+ * Convert stardust to ATLAS for display
+ *
+ * @param stardust - Amount in stardust
+ * @returns Amount in ATLAS (decimal)
+ *
+ * @example
+ * ```typescript
+ * stardustToAtlas(100_000_000n)  // 1.0 ATLAS
+ * stardustToAtlas(150_000_000n)  // 1.5 ATLAS
+ * ```
+ */
+export declare function stardustToAtlas(stardust: bigint | number): number;
+/**
+ * Format amount for display
+ *
+ * @param stardust - Amount in stardust
+ * @param decimals - Number of decimal places (default: 2)
+ * @returns Formatted ATLAS amount string
+ *
+ * @example
+ * ```typescript
+ * formatAmount(100_000_000n)      // "1.00 ATLAS"
+ * formatAmount(150_000_000n, 4)   // "1.5000 ATLAS"
+ * ```
+ */
+export declare function formatAmount(stardust: bigint | number, decimals?: number): string;
+/**
+ * Validate amount is within reasonable bounds
+ *
+ * @param stardust - Amount in stardust
+ * @param min - Minimum allowed amount in stardust (default: 0)
+ * @param max - Maximum allowed amount in stardust (default: MAX_U64)
+ * @throws Error if amount is out of bounds
+ */
+export declare function validateAmount(stardust: bigint, min?: bigint, max?: bigint): void;
+//# sourceMappingURL=amount.d.ts.map

package/dist/types/params/amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../../src/params/amount.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAOzB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAkDzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAGpF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAW,EAChB,GAAG,GAAE,MAAoC,GACxC,IAAI,CAaN"}

package/dist/types/params/duration.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @purpose Duration parameter conversion utilities
+ *
+ * Converts user-friendly duration formats to seconds for use with Solana programs.
+ */
+/**
+ * Duration parameter type
+ *
+ * Accepts either a plain number (seconds) or an object with time units.
+ */
+export type DurationParam = number | {
+    seconds?: number;
+} | {
+    minutes?: number;
+} | {
+    hours?: number;
+} | {
+    days?: number;
+} | {
+    weeks?: number;
+} | {
+    months?: number;
+};
+/**
+ * Convert duration parameter to seconds
+ *
+ * @param duration - Duration in any supported format
+ * @returns Duration in seconds
+ * @throws Error if duration is invalid or negative
+ *
+ * @example
+ * ```typescript
+ * convertDuration(3600)              // 3600 seconds
+ * convertDuration({ hours: 1 })      // 3600 seconds
+ * convertDuration({ days: 7 })       // 604800 seconds
+ * convertDuration({ weeks: 2 })      // 1209600 seconds
+ * ```
+ */
+export declare function convertDuration(duration: DurationParam): number;
+/**
+ * Validate duration limits
+ *
+ * Ensures duration is within reasonable bounds for rental contracts.
+ *
+ * @param durationSeconds - Duration in seconds
+ * @param min - Minimum allowed duration (default: 1 hour)
+ * @param max - Maximum allowed duration (default: 1 year)
+ * @throws Error if duration is out of bounds
+ */
+export declare function validateDuration(durationSeconds: number, min?: number, max?: number): void;
+/**
+ * Format duration in seconds to human-readable string
+ *
+ * @param seconds - Duration in seconds
+ * @returns Human-readable duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(3600)   // "1 hour"
+ * formatDuration(86400)  // "1 day"
+ * formatDuration(7200)   // "2 hours"
+ * ```
+ */
+export declare function formatDuration(seconds: number): string;
+//# sourceMappingURL=duration.d.ts.map

package/dist/types/params/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../../src/params/duration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAWxB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAmC/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,GAAG,GAAE,MAAyB,EAC9B,GAAG,GAAE,MAA8B,GAClC,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBtD"}

package/dist/types/params/schedule.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @purpose Payment schedule parameter conversion utilities
+ *
+ * Converts user-friendly schedule formats to strings for use with Solana programs.
+ * Supports common shortcuts and cron expressions.
+ */
+/**
+ * Schedule parameter type
+ *
+ * Accepts either:
+ * - Schedule shortcuts (e.g., '@daily', 'daily', '@hourly', 'hourly')
+ * - Cron expressions for custom schedules
+ */
+export type ScheduleParam = string;
+/**
+ * Common schedule shortcuts
+ */
+export declare const SCHEDULE_SHORTCUTS: readonly ["@hourly", "@daily", "@weekly", "@monthly", "@yearly", "@annually", "@decasecond", "@minute", "hourly", "daily", "weekly", "monthly", "yearly", "annually", "decasecond", "minute"];
+/**
+ * Normalize payment schedule input to program-compatible format
+ *
+ * @param schedule - Payment schedule string
+ * @returns Normalized schedule string for Solana program
+ * @throws Error if schedule format is invalid
+ *
+ * @example
+ * ```typescript
+ * normalizeSchedule('daily')           // '@daily'
+ * normalizeSchedule('@hourly')         // '@hourly'
+ * normalizeSchedule('0 * * * *')       // '0 * * * *'
+ * normalizeSchedule('0 0 * * * *')     // '0 0 * * * *' (with seconds)
+ * ```
+ */
+export declare function normalizeSchedule(schedule: ScheduleParam): string;
+/**
+ * Validate schedule format
+ *
+ * Checks if a schedule string is either:
+ * - A valid @shortcut
+ * - A valid cron expression (5 or 6 fields)
+ *
+ * @param schedule - Schedule string to validate
+ * @returns True if valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * validateScheduleFormat('@daily')     // true
+ * validateScheduleFormat('0 * * * *')  // true
+ * validateScheduleFormat('invalid')    // false
+ * ```
+ */
+export declare function validateScheduleFormat(schedule: string): boolean;
+/**
+ * Convert schedule string to human-readable description
+ *
+ * @param schedule - Normalized schedule string
+ * @returns Human-readable description
+ *
+ * @example
+ * ```typescript
+ * formatSchedule('@daily')     // "Daily"
+ * formatSchedule('@hourly')    // "Hourly"
+ * formatSchedule('0 * * * *')  // "Custom: 0 * * * *"
+ * ```
+ */
+export declare function formatSchedule(schedule: string): string;
+/**
+ * Check if a schedule is a known shortcut
+ *
+ * @param schedule - Schedule string to check
+ * @returns True if it's a shortcut (with or without @)
+ */
+export declare function isScheduleShortcut(schedule: string): boolean;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/types/params/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/params/schedule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,kBAAkB,+LAiBrB,CAAC;AA0BX;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAsCjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAehE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWvD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG5D"}

package/dist/types/pda/constants.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Constants used for PDA derivation across SRSLY, SAGE, and Thread programs
+ * @module pda/constants
+ */
+/**
+ * Faction-specific coordinates for starbase derivation in SAGE
+ * These coordinates are used to derive starbase PDAs
+ */
+export declare const FACTION_COORDINATES: Record<string, {
+    x: number;
+    y: number;
+}>;
+/**
+ * Mapping of numeric faction IDs to faction names
+ */
+export declare const FACTION_MAPPING: Record<number, string>;
+/**
+ * Seed constants for SAGE program PDA derivation
+ */
+export declare const STARBASE_SEED = "Starbase";
+export declare const STARBASE_PLAYER_SEED = "starbase_player";
+export declare const SAGE_PLAYER_PROFILE_SEED = "sage_player_profile";
+export declare const PROFILE_FACTION_SEED = "player_faction";
+/**
+ * Seed constants for SRSLY program PDA derivation
+ */
+export declare const CONTRACT_SEED = "rental_contract";
+export declare const RENTAL_SEED = "rental_state";
+export declare const RENTAL_AUTHORITY_SEED = "rental_authority";
+export declare const BORROWER_STATE_SEED = "borrower_state";
+export declare const CONFIG_SEED = "config";
+/**
+ * Seed constants for Thread program (Antegen) PDA derivation
+ */
+export declare const THREAD_SEED = "thread";
+/**
+ * Type guard to check if a value is a valid faction name
+ */
+export declare function isValidFactionName(faction: string): faction is 'mud' | 'oni' | 'ustur';
+/**
+ * Get faction name from numeric faction ID
+ */
+export declare function getFactionName(factionId: number): string;
+/**
+ * Get faction coordinates by name
+ */
+export declare function getFactionCoordinates(faction: string): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/pda/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/pda/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAIxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAC/C,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,KAAK,GAAG,KAAK,GAAG,OAAO,CAEtF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAQ/E"}

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

@@ -0,0 +1,36 @@
+/**
+ * PDA (Program Derived Address) derivation utilities
+ *
+ * This module provides helper functions for deriving PDAs across multiple Solana programs:
+ * - SRSLY: Contract, rental, borrower state, and config PDAs
+ * - SAGE: Player profiles, starbase, and faction PDAs
+ * - Antegen: Thread PDAs for automated payments
+ * - Token: Associated Token Account (ATA) derivation
+ *
+ * @module pda
+ *
+ * @example
+ * ```typescript
+ * import { deriveContract, deriveGameAccounts, deriveRentalThread } from '@srsly/sdk/pda';
+ *
+ * // Derive SRSLY contract
+ * const contract = await deriveContract(fleetAddress);
+ *
+ * // Derive all SAGE accounts at once
+ * const { profileFaction, starbase, starbasePlayer } = await deriveGameAccounts(
+ *   playerProfile,
+ *   'mud',
+ *   gameId
+ * );
+ *
+ * // Derive thread for automated payments
+ * const thread = await deriveRentalThread(rentalState, rentalAuthority);
+ * ```
+ */
+export { FACTION_COORDINATES, FACTION_MAPPING, STARBASE_SEED, STARBASE_PLAYER_SEED, SAGE_PLAYER_PROFILE_SEED, PROFILE_FACTION_SEED, CONTRACT_SEED, RENTAL_SEED, RENTAL_AUTHORITY_SEED, BORROWER_STATE_SEED, CONFIG_SEED, THREAD_SEED, isValidFactionName, getFactionName, getFactionCoordinates, } from './constants';
+export { deriveContract, deriveRental, deriveRentalAuthority, deriveBorrowerState, deriveConfig, } from './srsly';
+export { deriveProfileFaction, deriveSagePlayerProfile, deriveStarbase, deriveStarbasePlayer, deriveGameAccounts, } from './sage';
+export { deriveRentalThread } from './thread';
+export { deriveAssociatedTokenAccount } from './token';
+export { deriveSlyvaultVault } from './slyvault';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pda/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/pda/sage.d.ts

@@ -0,0 +1,69 @@
+/**
+ * PDA derivation functions for SAGE and Profile Faction programs
+ * @module pda/sage
+ */
+import { Address } from '@solana/kit';
+/**
+ * Derive the profile faction PDA from a profile address
+ * @param profile - The player profile public key
+ * @param programAddress - Optional Profile Faction program address (defaults to network-specific address)
+ * @returns The derived profile faction PDA
+ */
+export declare function deriveProfileFaction(profile: Address | string, programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive the SAGE player profile PDA
+ * @param profile - The player profile public key
+ * @param gameId - The game ID public key
+ * @param programAddress - Optional SAGE program address (defaults to network-specific address)
+ * @returns The derived SAGE player profile PDA
+ */
+export declare function deriveSagePlayerProfile(profile: Address | string, gameId: Address | string, programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive the starbase PDA from faction and game ID
+ * @param faction - Faction name ('mud', 'oni', 'ustur') or faction ID (1, 2, 3)
+ * @param gameId - The game ID public key
+ * @param programAddress - Optional SAGE program address (defaults to network-specific address)
+ * @returns The derived starbase PDA
+ */
+export declare function deriveStarbase(faction: string | number, gameId: Address | string, programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive the starbase player PDA
+ * @param sagePlayerProfile - The SAGE player profile public key
+ * @param starbase - The starbase public key
+ * @param starbaseSeqId - Optional starbase sequence ID (defaults to 0)
+ * @param programAddress - Optional SAGE program address (defaults to network-specific address)
+ * @returns The derived starbase player PDA
+ */
+export declare function deriveStarbasePlayer(sagePlayerProfile: Address | string, starbase: Address | string, starbaseSeqId?: number, programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive all SAGE game accounts at once (convenience function)
+ *
+ * This is a helper that derives all three SAGE-related accounts needed for most operations:
+ * - Profile faction (from Profile Faction program)
+ * - SAGE player profile (from SAGE program)
+ * - Starbase (from SAGE program using faction coordinates)
+ * - Starbase player (from SAGE program)
+ *
+ * @param profile - The player profile public key
+ * @param faction - Faction name ('mud', 'oni', 'ustur') or faction ID (1, 2, 3)
+ * @param gameId - The game ID public key
+ * @param starbaseSeqId - Optional starbase sequence ID (defaults to 0)
+ * @returns Object containing all derived SAGE accounts
+ *
+ * @example
+ * ```typescript
+ * const accounts = await deriveGameAccounts(
+ *   playerProfile,
+ *   'mud',
+ *   gameId
+ * );
+ * // Returns: { profileFaction, sagePlayerProfile, starbase, starbasePlayer }
+ * ```
+ */
+export declare function deriveGameAccounts(profile: Address | string, faction: string | number, gameId: Address | string, starbaseSeqId?: number): Promise<{
+    profileFaction: Address;
+    sagePlayerProfile: Address;
+    starbase: Address;
+    starbasePlayer: Address;
+}>;
+//# sourceMappingURL=sage.d.ts.map

package/dist/types/pda/sage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sage.d.ts","sourceRoot":"","sources":["../../../src/pda/sage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,OAAO,EAA+C,MAAM,aAAa,CAAC;AAqB5F;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,OAAO,GAAG,MAAM,EACnC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAC1B,aAAa,GAAE,MAAU,EACzB,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC;IACT,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC,CAqBD"}