@wuwei-labs/srsly 2.0.0-beta.3 → 2.0.0-beta.32

package/dist/types/rental/close.d.ts

@@ -1,24 +1,52 @@
-import { Address } from '@solana/kit';
-import { type NetworkSelector } from '../network';
+import { type ConfigSelector } from '../utils/config';
+type UniversalAddress = string;
 type CloseRentalInstruction = any;
 /**
- * Simplified parameters for closing a rental
+ * Simplified parameters for closing a rental - strings only!
  */
 export interface CloseRentalParams {
     /**
      * The borrower address (not a signer in this transaction)
      */
-    borrower: Address<string>;
+    borrower: UniversalAddress;
     /**
      * The owner's token account address for receiving ATLAS
      */
-    ownerTokenAccount: Address<string>;
+    ownerTokenAccount: UniversalAddress;
     /**
      * The rental contract account address
      */
-    contract: Address<string>;
+    contract: UniversalAddress;
 }
-export declare function closeRental(params: CloseRentalParams): NetworkSelector<CloseRentalInstruction>;
-export declare function getCloseRentalInstructionAsync(input: any, options?: any): NetworkSelector<any>;
+/**
+ * Creates an instruction to close a rental with fluent configuration.
+ *
+ * @example
+ * ```typescript
+ * // Works with any library - just use strings for addresses!
+ * const instruction = await closeRental({
+ *   borrower: "BorrowerAddr...",           // String address
+ *   ownerTokenAccount: "TokenAcct...",     // String address
+ *   contract: "ContractAddr..."            // String address
+ * });
+ *
+ * // Use mainnet configuration
+ * const instruction = await closeRental(params).set({ programs: 'mainnet' });
+ *
+ * // Override specific constants
+ * const instruction = await closeRental(params).set({
+ *   programs: 'mainnet',
+ *   sageProgramAddress: 'custom...'
+ * });
+ *
+ * // Use the instruction with your preferred Solana library
+ * // instruction is compatible with both @solana/kit and @solana/web3.js
+ * ```
+ *
+ * @param params The simplified parameters for closing a rental
+ * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ */
+export declare function closeRental(params: CloseRentalParams): ConfigSelector<CloseRentalInstruction>;
+export declare function getCloseRentalInstructionAsync(input: any, options?: any): ConfigSelector<any>;
 export {};
 //# sourceMappingURL=close.d.ts.map

package/dist/types/rental/close.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../../src/rental/close.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAiD,KAAK,eAAe,EAAgB,MAAM,YAAY,CAAC;AAG/G,KAAK,sBAAsB,GAAG,GAAG,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1B;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3B;AAmDD,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,GACxB,eAAe,CAAC,sBAAsB,CAAC,CAEzC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAK9F"}
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../../src/rental/close.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAI3G,KAAK,gBAAgB,GAAG,MAAM,CAAC;AAC/B,KAAK,sBAAsB,GAAG,GAAG,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAE3B;;OAEG;IACH,iBAAiB,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,GACxB,cAAc,CAAC,sBAAsB,CAAC,CAExC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAK7F"}

package/dist/types/rental/reset.d.ts

@@ -1,27 +1,27 @@
-import { Address } from '@solana/kit';
-import { type NetworkSelector } from '../network';
+import { type ConfigSelector } from '../utils/config';
+type UniversalAddress = string;
 type ResetRentalInstruction = any;
 /**
- * Simplified parameters for resetting a rental
+ * Simplified parameters for resetting a rental - strings only!
  */
 export interface ResetRentalParams {
     /**
      * The fleet account address
      */
-    fleet: Address<string>;
+    fleet: UniversalAddress;
     /**
      * The rental contract account address
      */
-    contract: Address<string>;
+    contract: UniversalAddress;
     /**
      * The rental state account address
      */
-    rentalState: Address<string>;
+    rentalState: UniversalAddress;
     /**
      * The game ID account address
-     * Defaults to the standard game ID if not provided
+     * If not provided, will use network-specific default
      */
-    gameId?: Address<string>;
+    gameId?: UniversalAddress;
     /**
      * Optional faction (1 = mud, 2 = oni, 3 = ustur)
      * Or as string: 'mud', 'oni', 'ustur'
@@ -32,9 +32,40 @@ export interface ResetRentalParams {
      * The owner's profile address
      * Needed only if faction is provided to derive starbasePlayer
      */
-    ownerProfile: Address<string>;
+    ownerProfile: UniversalAddress;
 }
-export declare function resetRental(params: ResetRentalParams): NetworkSelector<ResetRentalInstruction>;
-export declare function getResetRentalInstructionAsync(input: any, options?: any): NetworkSelector<any>;
+/**
+ * Creates an instruction to reset a rental with fluent configuration.
+ *
+ * @example
+ * ```typescript
+ * // Works with any library - just use strings for addresses!
+ * const instruction = await resetRental({
+ *   fleet: "FleetAddress123...",        // String address
+ *   contract: "ContractAddr...",        // String address
+ *   rentalState: "RentalStateAddr...",  // String address
+ *   faction: 'mud',
+ *   ownerProfile: "OwnerProfileAddr..." // String address
+ * });
+ *
+ * // Use mainnet configuration
+ * const instruction = await resetRental(params).set({ programs: 'mainnet' });
+ *
+ * // Override specific constants
+ * const instruction = await resetRental(params).set({
+ *   programs: 'mainnet',
+ *   gameId: 'custom-game-id...',
+ *   sageProgramAddress: 'custom...'
+ * });
+ *
+ * // Use the instruction with your preferred Solana library
+ * // instruction is compatible with both @solana/kit and @solana/web3.js
+ * ```
+ *
+ * @param params The simplified parameters for resetting a rental
+ * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ */
+export declare function resetRental(params: ResetRentalParams): ConfigSelector<ResetRentalInstruction>;
+export declare function getResetRentalInstructionAsync(input: any, options?: any): ConfigSelector<any>;
 export {};
 //# sourceMappingURL=reset.d.ts.map

package/dist/types/rental/reset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/rental/reset.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAiD,KAAK,eAAe,EAAgB,MAAM,YAAY,CAAC;AAG/G,KAAK,sBAAsB,GAAG,GAAG,CAAC;AAOlC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B;AA8ED,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,GACxB,eAAe,CAAC,sBAAsB,CAAC,CAEzC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAK9F"}
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/rental/reset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAK3G,KAAK,gBAAgB,GAAG,MAAM,CAAC;AAC/B,KAAK,sBAAsB,GAAG,GAAG,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAE3B;;OAEG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAE9B;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;;OAGG;IACH,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAuDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,GACxB,cAAc,CAAC,sBAAsB,CAAC,CAExC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAK7F"}

package/dist/types/types/paymentFrequency.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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
+ */
+import { PaymentFrequency } from '../codama/types/paymentFrequency';
+/**
+ * User-facing payment frequency string type
+ * Auto-generated from Rust PaymentFrequency enum
+ */
+export type PaymentFrequencyString = 'hourly' | 'daily' | 'weekly' | 'monthly';
+/**
+ * Array of all valid payment frequency strings
+ * Auto-generated from Rust PaymentFrequency enum
+ */
+export declare const VALID_PAYMENT_FREQUENCIES: readonly PaymentFrequencyString[];
+/**
+ * Mapping from user-friendly strings to PaymentFrequency enum values
+ * Auto-generated from Rust PaymentFrequency enum
+ */
+export declare const PAYMENT_FREQUENCY_MAP: Record<PaymentFrequencyString, PaymentFrequency>;
+/**
+ * Constants extracted from Rust constants.rs
+ * Auto-synced with Rust implementation
+ */
+export declare const PAYMENT_FREQUENCY_CONSTANTS: {
+    readonly SECONDS_PER_DECASECOND: 10;
+    readonly SECONDS_PER_MINUTE: 60;
+    readonly SECONDS_PER_HOUR: 3600;
+    readonly SECONDS_PER_DAY: 86400;
+    readonly SECONDS_PER_WEEK: 604800;
+    readonly SECONDS_PER_MONTH: 2678400;
+};
+/**
+ * Get PaymentFrequency enum value from user-friendly string
+ */
+export declare function getPaymentFrequencyFromString(frequencyString: PaymentFrequencyString): PaymentFrequency;
+/**
+ * Check if a string is a valid payment frequency
+ */
+export declare function isValidPaymentFrequency(value: string): value is PaymentFrequencyString;
+//# sourceMappingURL=paymentFrequency.d.ts.map

package/dist/types/types/paymentFrequency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentFrequency.d.ts","sourceRoot":"","sources":["../../../src/types/paymentFrequency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAK7D,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,sBAAsB,EAAE,gBAAgB,CAKzE,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;CAO9B,CAAC;AAEX;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,sBAAsB,GAAG,gBAAgB,CAEvG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,sBAAsB,CAEtF"}

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

@@ -0,0 +1,110 @@
+/**
+ * Network configuration for the SRSLY SDK
+ */
+export type ProgramSet = 'mainnet' | 'atlasnet' | 'holosim';
+/**
+ * Configuration options that can be set globally or overridden per call
+ */
+export interface ConfigOptions {
+    programs?: ProgramSet;
+    srslyProgramAddress?: string;
+    profileFactionProgramAddress?: string;
+    gameId?: string;
+    atlasMint?: string;
+}
+/**
+ * Resolve program addresses based on configuration
+ * @param config Effective configuration options
+ * @returns Resolved program addresses
+ */
+export declare function resolveProgramAddresses(config: ConfigOptions): {
+    srslyProgramAddress: string;
+    sageProgramAddress: "SAGE2HAwep459SNq61LHvjxPk4pLPEJLoMETef7f7EE" | "SAgeTraQfBMdvGVDJYoEvjnbq5szW7RJPi6obDTDQUF";
+    profileFactionProgramAddress: string;
+    gameId: string;
+    atlasMint: string;
+};
+/**
+ * Set global configuration options that will be used as defaults for all SDK operations
+ * @param config Configuration options to set globally
+ *
+ * @example
+ * ```typescript
+ * // Use default atlasnet program addresses
+ * setConfig({ programs: 'atlasnet' });
+ *
+ * // Use holosim program addresses
+ * setConfig({ programs: 'holosim' });
+ *
+ * // Use holosim program addresses with custom game ID
+ * setConfig({
+ *   programs: 'holosim',
+ *   gameId: 'custom-game-id...'
+ * });
+ *
+ * // Can still override per instruction
+ * await createContract(params).set({ srslyProgramAddress: 'custom...' });
+ * ```
+ */
+export declare function setConfig(config: ConfigOptions): void;
+/**
+ * Get the current global configuration
+ * @returns Current global configuration options
+ */
+export declare function getConfig(): ConfigOptions;
+/**
+ * Clear global configuration (resets to atlasnet program set defaults)
+ */
+export declare function clearConfig(): void;
+/**
+ * Get the effective configuration by merging global config with provided overrides
+ * @param overrides Optional configuration overrides
+ * @returns Merged configuration with global defaults and any overrides
+ */
+export declare function getEffectiveConfig(overrides?: ConfigOptions): ConfigOptions;
+/**
+ * Get the single codama module (network agnostic)
+ * @param modulePath The module type ('instructions' or 'programs')
+ * @returns The codama module
+ */
+export declare function getModule(modulePath: 'instructions' | 'programs'): any;
+/**
+ * @deprecated Use getModule instead. This function is kept for backward compatibility.
+ * Get codama modules (network agnostic)
+ */
+export declare function getCachedNetworkModule<T = any>(modulePath: string): Promise<T>;
+/**
+ * Configuration selector for overriding network and constants
+ * Also implements PromiseLike to allow direct awaiting
+ */
+export interface ConfigSelector<T> extends PromiseLike<T> {
+    /**
+     * Set configuration options for this call
+     */
+    set(options: ConfigOptions): ConfigSelector<T>;
+    /**
+     * Build with current configuration (explicit call)
+     */
+    build(): Promise<T>;
+}
+/**
+ * Create the initial fluent config selector for a function.
+ * This is the main entry point for the fluent configuration API.
+ *
+ * The returned selector can be:
+ * - Awaited directly (uses global config + atlasnet fallback)
+ * - Configured with .set() to override network/constants
+ * - Chained with multiple .set() calls
+ *
+ * @param executeFn - The function to execute with optional configuration
+ * @returns A ConfigSelector that supports fluent configuration
+ *
+ * @example
+ * // Usage patterns:
+ * setConfig({ programs: 'mainnet' });
+ * await createConfigSelector(executeFn)                    // Direct await (uses global config)
+ * await createConfigSelector(executeFn).set({...})        // Override global config
+ * await createConfigSelector(executeFn).set({...}).set({...}) // Chained configs
+ */
+export declare function createConfigSelector<T>(executeFn: (config?: ConfigOptions) => Promise<T>): ConfigSelector<T>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAwB5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa;;;;;;EAiB5D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAGD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,aAAa,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,cAAc,GAAG,UAAU,GAAG,GAAG,CAEtE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAKpF;AAID;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACvD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAE/C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;CACrB;AAsCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAChD,cAAc,CAAC,CAAC,CAAC,CAcnB"}

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

@@ -1,21 +1,24 @@
-export declare function getPaymentFrequency(): Promise<any>;
-export declare function getSrslyProgramAddress(): Promise<any>;
-import { type Address } from "@solana/kit";
-export declare function getProgramId(): Promise<Address>;
-export declare const SAGE_PROGRAM_ADDRESS = "sAgezwJpDb1aHvzNr3o24cKjsETmFEKghBEyJ1askDi";
-export declare const PROFILE_FACTION_PROGRAM_ADDRESS = "pFACSRuobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq";
-export declare const DEFAULT_GAME_ID = "GAMEzqJehF8yAnKiTARUuhZMvLvkZVAsCVri5vSfemLr";
+import { type ConfigOptions } from './config';
+/**
+ * Converts a string or Address to an Address type
+ * This utility ensures consistent address handling across the SDK
+ * Note: This is a simple passthrough now since pack functions handle library-specific conversions
+ */
+export declare function toAddress(value: string | any): any;
 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 = "profile_faction";
+export declare const ATLAS_TO_STARDUST = 100000000;
+export declare function getSrslyProgramAddress(config?: ConfigOptions): Promise<any>;
+export declare function getProgramId(): Promise<any>;
+export declare function getSageProgramAddress(config?: ConfigOptions): Promise<any>;
+export declare function getProfileFactionProgramAddress(config?: ConfigOptions): Promise<any>;
+export declare function getSageGameId(config?: ConfigOptions): Promise<any>;
+export declare function getAtlasMint(config?: ConfigOptions): Promise<any>;
 export declare const FACTION_SPECIFIC_CSS: Record<string, {
     x: number;
     y: number;
 }>;
 export declare const FACTION_MAPPING: Record<number, string>;
-/**
- * Convert PaymentFrequency enum to string (async version)
- */
-export declare function paymentFrequencyToString(freq: any): Promise<string>;
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAGA,wBAAsB,mBAAmB,iBAGxC;AAED,wBAAsB,sBAAsB,iBAG3C;AACD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAErD;AAGD,eAAO,MAAM,oBAAoB,gDAAgD,CAAC;AAClF,eAAO,MAAM,+BAA+B,gDAAgD,CAAC;AAC7F,eAAO,MAAM,eAAe,iDAAiD,CAAC;AAG9E,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAGtD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAIzE,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIlD,CAAC;AAEF;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzE"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAClF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAElD;AAGD,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAGtD,eAAO,MAAM,iBAAiB,YAAc,CAAC;AAM7C,wBAAsB,sBAAsB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAMjF;AAGD,wBAAsB,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,CAEjD;AAGD,wBAAsB,qBAAqB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAOhF;AAED,wBAAsB,+BAA+B,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAM1F;AAED,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAMxE;AAED,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAMvE;AAGD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAIzE,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIlD,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Convert decaseconds (10 seconds) to seconds
+ * @param amount Number of decaseconds
+ * @returns Number of seconds
+ */
+export declare function decaseconds(amount: number): number;
+/**
+ * Convert minutes to seconds
+ * @param amount Number of minutes
+ * @returns Number of seconds
+ */
+export declare function minutes(amount: number): number;
+/**
+ * Convert hours to seconds
+ * @param amount Number of hours
+ * @returns Number of seconds
+ */
+export declare function hours(amount: number): number;
+/**
+ * Convert days to seconds
+ * @param amount Number of days
+ * @returns Number of seconds
+ */
+export declare function days(amount: number): number;
+/**
+ * Convert weeks to seconds
+ * @param amount Number of weeks
+ * @returns Number of seconds
+ */
+export declare function weeks(amount: number): number;
+/**
+ * Convert months to seconds
+ * @param amount Number of months (31 days each)
+ * @returns Number of seconds
+ */
+export declare function months(amount: number): number;
+/**
+ * All duration helper functions
+ */
+export declare const duration: {
+    readonly decaseconds: typeof decaseconds;
+    readonly minutes: typeof minutes;
+    readonly hours: typeof hours;
+    readonly days: typeof days;
+    readonly weeks: typeof weeks;
+    readonly months: typeof months;
+    readonly constants: {
+        readonly SECONDS_PER_DECASECOND: 10;
+        readonly SECONDS_PER_MINUTE: 60;
+        readonly SECONDS_PER_HOUR: 3600;
+        readonly SECONDS_PER_DAY: 86400;
+        readonly SECONDS_PER_WEEK: 604800;
+        readonly SECONDS_PER_MONTH: 2678400;
+    };
+};
+//# sourceMappingURL=duration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../../src/utils/duration.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAUX,CAAC"}

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

@@ -1,3 +1,7 @@
 export * from "./constants";
 export * from "./profiles";
+export * from "./config";
+export * from "./paymentFrequency";
+export * from "./duration";
+export * from "./instruction-converter";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}

package/dist/types/utils/instruction-converter.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Fluent instruction interface for format conversion between @solana/kit and @solana/web3.js
+ */
+import { ConfigSelector } from './config';
+/**
+ * @solana/kit instruction format
+ */
+export interface KitInstruction {
+    accounts: Array<{
+        address: string;
+        role: number;
+    }>;
+    programAddress: string;
+    data: Uint8Array | {
+        [key: string]: number;
+    };
+}
+/**
+ * @solana/web3.js instruction format with string addresses
+ */
+export interface Web3jsInstructionWithStrings {
+    keys: Array<{
+        pubkey: string;
+        isWritable: boolean;
+        isSigner: boolean;
+    }>;
+    programId: string;
+    data: Uint8Array | {
+        [key: string]: number;
+    };
+}
+/**
+ * @solana/web3.js instruction format with PublicKey instances
+ */
+export interface Web3jsInstructionWithPublicKeys<TPublicKey = any> {
+    keys: Array<{
+        pubkey: TPublicKey;
+        isWritable: boolean;
+        isSigner: boolean;
+    }>;
+    programId: TPublicKey;
+    data: Uint8Array | {
+        [key: string]: number;
+    };
+}
+/**
+ * Generic web3.js instruction format
+ */
+export type Web3jsInstruction<TPublicKey = string> = TPublicKey extends string ? Web3jsInstructionWithStrings : Web3jsInstructionWithPublicKeys<TPublicKey>;
+/**
+ * PublicKey constructor interface
+ */
+export interface PublicKeyConstructor<TPublicKey = any> {
+    new (address: string): TPublicKey;
+}
+/**
+ * Fluent instruction wrapper that provides format conversion methods
+ * @example
+ * ```typescript
+ * import { PublicKey } from '@solana/web3.js';
+ *
+ * // Default returns kit format
+ * const kitInstruction = await createContract(params);
+ *
+ * // Convert to web3.js format with string addresses
+ * const web3jsInstruction = await createContract(params).web3js();
+ *
+ * // Convert to web3.js format with PublicKey instances
+ * const web3jsInstructionWithPK = await createContract(params).web3js(PublicKey);
+ *
+ * // Use with libraries
+ * const transaction = new Transaction().add(web3jsInstructionWithPK);
+ * ```
+ */
+export interface FluentInstruction extends KitInstruction {
+    /**
+     * Convert instruction to @solana/web3.js format with string addresses
+     * @returns Instruction in @solana/web3.js format with string pubkeys
+     */
+    web3js(): Web3jsInstructionWithStrings;
+    /**
+     * Convert instruction to @solana/web3.js format with PublicKey instances
+     * @param PublicKeyConstructor Constructor for creating PublicKey instances
+     * @returns Instruction in @solana/web3.js format with PublicKey instances
+     */
+    web3js<TPublicKey>(PublicKeyConstructor: PublicKeyConstructor<TPublicKey>): Web3jsInstructionWithPublicKeys<TPublicKey>;
+}
+/**
+ * Fluent config selector that adds format conversion methods
+ * This allows chaining both configuration and format conversion
+ */
+export interface FluentConfigSelector<T extends FluentInstruction> extends ConfigSelector<T> {
+    /**
+     * Convert instruction to @solana/web3.js format with string addresses
+     * @returns Promise that resolves to Web3jsInstructionWithStrings
+     */
+    web3js(): Promise<Web3jsInstructionWithStrings>;
+    /**
+     * Convert instruction to @solana/web3.js format with PublicKey instances
+     * @param PublicKeyConstructor Constructor for creating PublicKey instances
+     * @returns Promise that resolves to Web3jsInstructionWithPublicKeys
+     */
+    web3js<TPublicKey>(PublicKeyConstructor: PublicKeyConstructor<TPublicKey>): Promise<Web3jsInstructionWithPublicKeys<TPublicKey>>;
+}
+/**
+ * Create a fluent instruction wrapper around a kit instruction
+ * @param kitInstruction The base instruction in kit format
+ * @returns Fluent instruction with conversion methods
+ */
+export declare function createFluentInstruction(kitInstruction: KitInstruction): FluentInstruction;
+/**
+ * Create a fluent config selector that adds format conversion methods
+ * @param baseSelector The base ConfigSelector
+ * @returns FluentConfigSelector with additional format conversion methods
+ */
+export declare function createFluentConfigSelector<T extends FluentInstruction>(baseSelector: ConfigSelector<T>): FluentConfigSelector<T>;
+//# sourceMappingURL=instruction-converter.d.ts.map

package/dist/types/utils/instruction-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-converter.d.ts","sourceRoot":"","sources":["../../../src/utils/instruction-converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,UAAU,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,KAAK,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B,CAAC,UAAU,GAAG,GAAG;IAC/D,IAAI,EAAE,KAAK,CAAC;QACV,MAAM,EAAE,UAAU,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,SAAS,EAAE,UAAU,CAAC;IACtB,IAAI,EAAE,UAAU,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,UAAU,GAAG,MAAM,IAAI,UAAU,SAAS,MAAM,GAC1E,4BAA4B,GAC5B,+BAA+B,CAAC,UAAU,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,UAAU,GAAG,GAAG;IACpD,KAAK,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;OAGG;IACH,MAAM,IAAI,4BAA4B,CAAC;IAEvC;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,oBAAoB,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,+BAA+B,CAAC,UAAU,CAAC,CAAC;CACzH;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC1F;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAEhD;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,oBAAoB,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC,CAAC;CAClI;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,cAAc,GAAG,iBAAiB,CA+BzF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,iBAAiB,EACpE,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAgBzB"}

package/dist/types/utils/paymentFrequency.d.ts

@@ -0,0 +1,18 @@
+import { PaymentFrequency } from '../codama/types/paymentFrequency';
+import { PaymentFrequencyString } from '../types/paymentFrequency';
+/**
+ * Converts a PaymentFrequency enum value to seconds
+ * Mirrors the to_seconds() method from the Rust implementation
+ */
+export declare function paymentFrequencyToSeconds(frequency: PaymentFrequency): number;
+/**
+ * Converts a payment frequency string to seconds
+ * Uses auto-generated mapping from Rust PaymentFrequency enum
+ */
+export declare function paymentFrequencyStringToSeconds(frequencyString: PaymentFrequencyString): number;
+/**
+ * Validates that a duration is a multiple of the payment frequency
+ * Uses auto-generated types from Rust PaymentFrequency enum
+ */
+export declare function validateDurationAlignment(duration: number | bigint, frequencyString: PaymentFrequencyString): void;
+//# sourceMappingURL=paymentFrequency.d.ts.map

package/dist/types/utils/paymentFrequency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentFrequency.d.ts","sourceRoot":"","sources":["../../../src/utils/paymentFrequency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EACL,sBAAsB,EAGvB,MAAM,2BAA2B,CAAC;AAkBnC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAkB7E;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,sBAAsB,GAAG,MAAM,CAO/F;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,eAAe,EAAE,sBAAsB,GACtC,IAAI,CASN"}

package/dist/types/utils/profiles.d.ts

@@ -1,46 +1,52 @@
 import { Address } from '@solana/kit';
+import type { ConfigOptions } from './config';
 /**
  * Helper function to derive the borrower's profile faction account
  *
  * @param profile The borrower's profile address
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived profile faction address
  */
-export declare function deriveProfileFaction(profile: Address<string>): Promise<Address<string>>;
+export declare function deriveProfileFaction(profile: Address<string>, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Helper function to derive the sage player profile
  *
  * @param borrowerProfile The borrower's profile address
- * @param gameId The game ID (defaults to the standard game ID)
+ * @param gameId The game ID (if not provided, uses network-specific default)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived sage player profile address
  */
-export declare function deriveSagePlayerProfile(borrowerProfile: Address<string>, gameId?: Address<string>): Promise<Address<string>>;
+export declare function deriveSagePlayerProfile(borrowerProfile: Address<string>, gameId?: Address<string>, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Helper function to derive the starbase address based on faction
  *
  * @param faction The faction (1/2/3 or 'mud'/'oni'/'ustur')
- * @param gameId The game ID (defaults to the standard game ID)
+ * @param gameId The game ID (if not provided, uses network-specific default)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived starbase address
  */
-export declare function deriveStarbase(faction: number | string, gameId?: Address<string>): Promise<Address<string>>;
+export declare function deriveStarbase(faction: number | string, gameId?: Address<string>, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Helper function to derive the starbase player address
  *
  * @param sagePlayerProfile The sage player profile address
  * @param starbase The starbase address
  * @param starbaseSeqId The starbase sequence ID (defaults to 0)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived starbase player address
  */
-export declare function deriveStarbasePlayer(sagePlayerProfile: Address<string>, starbase: Address<string>, starbaseSeqId?: number): Promise<Address<string>>;
+export declare function deriveStarbasePlayer(sagePlayerProfile: Address<string>, starbase: Address<string>, starbaseSeqId?: number, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Derives all three accounts needed: profileFaction, starbase, and starbasePlayer
  *
  * @param profile The borrower's profile address
  * @param faction The faction (1/2/3 or 'mud'/'oni'/'ustur')
- * @param gameId The game ID (defaults to the standard game ID)
+ * @param gameId The game ID (if not provided, uses network-specific default)
  * @param starbaseSeqId The starbase sequence ID (defaults to 0)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the three derived addresses
  */
-export declare function deriveGameAccounts(profile: Address<string>, faction: number | string, gameId?: Address<string>, starbaseSeqId?: number): Promise<{
+export declare function deriveGameAccounts(profile: Address<string>, faction: number | string, gameId?: Address<string>, starbaseSeqId?: number, config?: ConfigOptions): Promise<{
     profileFaction: Address<string>;
     starbase: Address<string>;
     starbasePlayer: Address<string>;