@wuwei-labs/srsly 2.0.0-beta.4 → 2.0.0-beta.42

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,122 @@
+/**
+ * Network configuration for the SRSLY SDK
+ */
+export type ProgramSet = 'mainnet' | 'atlasnet' | 'holosim';
+/**
+ * PublicKey constructor interface for web3.js library integration
+ */
+export interface PublicKeyConstructor<TPublicKey = any> {
+    new (address: string): TPublicKey;
+}
+/**
+ * Configuration options that can be set globally or overridden per call
+ */
+export interface ConfigOptions {
+    programs?: ProgramSet;
+    srslyProgramAddress?: string;
+    profileFactionProgramAddress?: string;
+    antegenProgramAddress?: string;
+    gameId?: string;
+    atlasMint?: string;
+    rpcUrl?: string;
+    library?: 'kit' | 'web3js';
+    PublicKeyConstructor?: PublicKeyConstructor;
+}
+/**
+ * Resolve program addresses based on configuration
+ * @param config Effective configuration options
+ * @returns Resolved program addresses
+ */
+export declare function resolveProgramAddresses(config: ConfigOptions): Promise<{
+    srslyProgramAddress: any;
+    sageProgramAddress: any;
+    profileFactionProgramAddress: any;
+    antegenProgramAddress: any;
+    gameId: any;
+    atlasMint: any;
+    rpcUrl: 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', 'programs', 'accounts', or 'kit')
+ * @returns The codama module or kit utilities
+ */
+export declare function getModule(modulePath: 'instructions' | 'programs' | 'accounts' | 'kit'): 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;AASH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAuB5D;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,UAAU,GAAG,GAAG;IACpD,KAAK,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAQD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,aAAa;;;;;;;;GAsClE;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,UAAU,GAAG,KAAK,GAAG,GAAG,CAa3F;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,23 @@
-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
+ */
+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 PROFILE_FACTION_SEED = "player_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;AAGlF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAoBlD;AAGD,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAGrD,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/fetch-accounts.d.ts

@@ -0,0 +1,88 @@
+import { type Address } from '@solana/kit';
+/**
+ * Convenience wrapper functions for fetching account states with RPC URL strings.
+ * These functions handle creating the RPC connection for you.
+ */
+/**
+ * Fetches contract state data from the blockchain using a simple RPC URL
+ *
+ * @param rpcUrl - The RPC endpoint URL as a string
+ * @param contractAddress - The contract account address to fetch
+ * @returns The deserialized contract state data
+ *
+ * @example
+ * ```typescript
+ * const contractState = await fetchContractState(
+ *   'https://api.devnet.solana.com',
+ *   'ContractAddress123...'
+ * );
+ *
+ * console.log('Contract owner:', contractState.data.owner);
+ * console.log('Contract rate:', contractState.data.rate);
+ * ```
+ */
+export declare function fetchContractState<TAddress extends string = string>(rpcUrl: string, contractAddress: Address<TAddress>): Promise<import("@solana/kit").Account<import("../codama/accounts").ContractState, TAddress>>;
+/**
+ * Fetches rental state data from the blockchain using a simple RPC URL
+ *
+ * @param rpcUrl - The RPC endpoint URL as a string
+ * @param rentalAddress - The rental account address to fetch
+ * @returns The deserialized rental state data
+ *
+ * @example
+ * ```typescript
+ * const rentalState = await fetchRentalState(
+ *   'https://api.devnet.solana.com',
+ *   'RentalAddress123...'
+ * );
+ *
+ * console.log('Rental borrower:', rentalState.data.borrower);
+ * console.log('Rental start:', rentalState.data.start);
+ * ```
+ */
+export declare function fetchRentalState<TAddress extends string = string>(rpcUrl: string, rentalAddress: Address<TAddress>): Promise<import("@solana/kit").Account<import("../codama/accounts").RentalState, TAddress>>;
+/**
+ * Fetches multiple contract states in a single RPC call
+ *
+ * @param rpcUrl - The RPC endpoint URL as a string
+ * @param contractAddresses - Array of contract addresses to fetch
+ * @returns Array of contract states (some may be null if not found)
+ *
+ * @example
+ * ```typescript
+ * const contracts = await fetchMultipleContractStates(
+ *   'https://api.devnet.solana.com',
+ *   ['Contract1...', 'Contract2...', 'Contract3...']
+ * );
+ *
+ * contracts.forEach((contract, i) => {
+ *   if (contract.exists) {
+ *     console.log(`Contract ${i}: ${contract.data.owner}`);
+ *   }
+ * });
+ * ```
+ */
+export declare function fetchMultipleContractStates<TAddress extends string = string>(rpcUrl: string, contractAddresses: Address<TAddress>[]): Promise<import("@solana/kit").Account<import("../codama/accounts").ContractState>[]>;
+/**
+ * Fetches multiple rental states in a single RPC call
+ *
+ * @param rpcUrl - The RPC endpoint URL as a string
+ * @param rentalAddresses - Array of rental addresses to fetch
+ * @returns Array of rental states (some may be null if not found)
+ *
+ * @example
+ * ```typescript
+ * const rentals = await fetchMultipleRentalStates(
+ *   'https://api.devnet.solana.com',
+ *   ['Rental1...', 'Rental2...', 'Rental3...']
+ * );
+ *
+ * rentals.forEach((rental, i) => {
+ *   if (rental.exists) {
+ *     console.log(`Rental ${i}: ${rental.data.borrower}`);
+ *   }
+ * });
+ * ```
+ */
+export declare function fetchMultipleRentalStates<TAddress extends string = string>(rpcUrl: string, rentalAddresses: Address<TAddress>[]): Promise<import("@solana/kit").Account<import("../codama/accounts").RentalState>[]>;
+//# sourceMappingURL=fetch-accounts.d.ts.map

package/dist/types/utils/fetch-accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-accounts.d.ts","sourceRoot":"","sources":["../../../src/utils/fetch-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAQ5D;;;GAGG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EACvE,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,gGAOnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EACrE,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,8FAOjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,2BAA2B,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChF,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,wFAOvC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,yBAAyB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAC9E,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,sFAOrC"}

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

@@ -1,3 +1,9 @@
 export * from "./constants";
 export * from "./profiles";
+export * from "./config";
+export * from "./paymentFrequency";
+export * from "./duration";
+export * from "./instruction-converter";
+export * from "./fetch-accounts";
+export * from "./pda";
 //# 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;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC"}

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

@@ -0,0 +1,167 @@
+/**
+ * Fluent instruction interface for format conversion between @solana/kit and @solana/web3.js
+ */
+import { ConfigSelector, ConfigOptions, PublicKeyConstructor } from './config';
+/**
+ * @solana/kit 2.x compatible instruction format
+ * This matches the structure expected by appendTransactionMessageInstruction
+ */
+export interface KitInstruction {
+    programAddress: string;
+    accounts?: Array<{
+        address: string;
+        role: number;
+    }>;
+    data?: Uint8Array;
+}
+/**
+ * @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>;
+/**
+ * Fluent instruction wrapper that provides format conversion methods
+ * @example
+ * ```typescript
+ * import { PublicKey } from '@solana/web3.js';
+ *
+ * // Get FluentInstruction
+ * const fluentInstruction = await createContract(params);
+ *
+ * // Access pure instruction data for @solana/kit
+ * const kitInstruction = fluentInstruction.instruction;
+ * // or
+ * const kitInstruction = fluentInstruction.kit();
+ *
+ * // Convert to web3.js format with string addresses
+ * const web3jsInstruction = fluentInstruction.web3js();
+ *
+ * // Convert to web3.js format with PublicKey instances
+ * const web3jsInstructionWithPK = fluentInstruction.web3js(PublicKey);
+ *
+ * // Use with libraries
+ * const transaction = new Transaction().add(web3jsInstructionWithPK);
+ * ```
+ */
+export interface FluentInstruction {
+    /**
+     * Pure instruction data (can be passed directly to @solana/kit)
+     * This property contains the clean KitInstruction without any method pollution
+     */
+    instruction: KitInstruction;
+    /**
+     * Get pure KitInstruction format (alias for .instruction property)
+     * @returns Instruction in @solana/kit format
+     */
+    kit(): 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
+ * @deprecated Use SmartFluentConfigSelector instead
+ */
+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>>;
+}
+/**
+ * Smart fluent config selector that returns different types based on library configuration
+ *
+ * Return behavior based on config:
+ * - No library config: Returns FluentInstruction (must use .kit() or .web3js())
+ * - library='kit': Returns KitInstruction directly
+ * - library='web3js': Returns web3js instruction format directly
+ */
+export interface SmartFluentConfigSelector<T extends FluentInstruction> extends ConfigSelector<any> {
+    /**
+     * Set configuration options for this call
+     */
+    set(options: ConfigOptions): SmartFluentConfigSelector<T>;
+    /**
+     * Build with current configuration (explicit call)
+     */
+    build(): Promise<T>;
+    /**
+     * Get pure KitInstruction format
+     * @returns Promise that resolves to KitInstruction
+     */
+    kit(): Promise<KitInstruction>;
+    /**
+     * 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 from a kit instruction using non-polluting design
+ * @param kitInstruction The base instruction in kit format
+ * @returns Fluent instruction with separate instruction property and conversion methods
+ */
+export declare function createFluentInstruction(kitInstruction: KitInstruction): FluentInstruction;
+/**
+ * Create a fluent config selector that adds format conversion methods
+ * @deprecated Use createSmartFluentConfigSelector instead
+ * @param baseSelector The base ConfigSelector
+ * @returns FluentConfigSelector with additional format conversion methods
+ */
+export declare function createFluentConfigSelector<T extends FluentInstruction>(baseSelector: ConfigSelector<T>): FluentConfigSelector<T>;
+/**
+ * Create a smart fluent config selector with library-aware return types
+ * @param baseSelector The base ConfigSelector
+ * @returns SmartFluentConfigSelector with smart return behavior
+ */
+export declare function createSmartFluentConfigSelector<T extends FluentInstruction>(baseSelector: ConfigSelector<T>): SmartFluentConfigSelector<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":"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"}

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

@@ -0,0 +1,18 @@
+import { PaymentFrequency } from '../codama/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
+ * Handles both "@daily" format (from contracts) and "daily" format (from mapping)
+ */
+export declare function paymentFrequencyStringToSeconds(frequencyString: string): 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: string): 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;AAuBpE;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAkB7E;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAY/E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,eAAe,EAAE,MAAM,GACtB,IAAI,CASN"}