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

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

@@ -0,0 +1,29 @@
+/**
+ * Slyvault PDA derivation utilities
+ * @module pda/slyvault
+ */
+import { Address } from '@solana/kit';
+/**
+ * Derive slyvault vault PDA and its associated token account
+ * Vault is created with a specific creator (typically the SRSLY program)
+ *
+ * @param creator - The creator address (typically SRSLY program)
+ * @param mint - The token mint address
+ * @param slyvaultProgramAddress - Optional slyvault program address (defaults to mainnet)
+ * @returns Object containing vault PDA and its token account
+ *
+ * @example
+ * ```typescript
+ * import { deriveSlyvaultVault } from './slyvault';
+ *
+ * const { vault, vaultTokenAccount } = await deriveSlyvaultVault(
+ *   srslyProgramAddress,
+ *   atlasMintAddress
+ * );
+ * ```
+ */
+export declare function deriveSlyvaultVault(creator: Address | string, mint: Address | string, slyvaultProgramAddress?: Address | string): Promise<{
+    vault: Address;
+    vaultTokenAccount: Address;
+}>;
+//# sourceMappingURL=slyvault.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slyvault.d.ts","sourceRoot":"","sources":["../../../src/pda/slyvault.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,OAAO,EAA+C,MAAM,aAAa,CAAC;AAgB5F;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,IAAI,EAAE,OAAO,GAAG,MAAM,EACtB,sBAAsB,CAAC,EAAE,OAAO,GAAG,MAAM,GACxC,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBzD"}

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

@@ -0,0 +1,40 @@
+/**
+ * PDA derivation functions for the SRSLY program
+ * @module pda/srsly
+ */
+import { Address } from '@solana/kit';
+/**
+ * Derive the contract PDA from a fleet address
+ * @param fleet - The fleet public key
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived contract PDA
+ */
+export declare function deriveContract(fleet: Address | string, programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive the rental PDA from contract and borrower addresses
+ * @param contract - The contract public key
+ * @param borrower - The borrower public key
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived rental PDA
+ */
+export declare function deriveRental(contract: Address | string, borrower: Address | string, programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive the rental authority PDA
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived rental authority PDA
+ */
+export declare function deriveRentalAuthority(programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive the borrower state PDA from a borrower address
+ * @param borrower - The borrower public key
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived borrower state PDA
+ */
+export declare function deriveBorrowerState(borrower: Address | string, programAddress?: Address | string): Promise<Address>;
+/**
+ * Derive the config PDA
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived config PDA
+ */
+export declare function deriveConfig(programAddress?: Address | string): Promise<Address>;
+//# sourceMappingURL=srsly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"srsly.d.ts","sourceRoot":"","sources":["../../../src/pda/srsly.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,OAAO,EAA+C,MAAM,aAAa,CAAC;AAoB5F;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,OAAO,GAAG,MAAM,EACvB,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAC1B,QAAQ,EAAE,OAAO,GAAG,MAAM,EAC1B,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAC1B,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAclB"}

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

@@ -0,0 +1,31 @@
+/**
+ * PDA derivation functions for the Antegen (Thread) program
+ * @module pda/thread
+ */
+import { Address } from '@solana/kit';
+/**
+ * Derive the rental thread PDA
+ *
+ * The rental thread is used by the Antegen program for automated payment scheduling.
+ * Thread PDAs ALWAYS use seeds: [SEED_THREAD, authority, id]
+ *
+ * @param rental - The rental state PDA (used as the thread ID)
+ * @param authority - The rental authority PDA (REQUIRED - always part of seeds)
+ * @param programAddress - Optional Antegen program address (defaults to Antegen program)
+ * @returns The derived rental thread PDA
+ *
+ * @example
+ * ```typescript
+ * import { deriveRental, deriveRentalAuthority } from './srsly';
+ * import { deriveRentalThread } from './thread';
+ *
+ * // Derive rental and authority first
+ * const rental = await deriveRental(contract, borrower);
+ * const authority = await deriveRentalAuthority();
+ *
+ * // Then derive the thread (authority is required!)
+ * const thread = await deriveRentalThread(rental, authority);
+ * ```
+ */
+export declare function deriveRentalThread(rental: Address | string, authority: Address | string, programAddress?: Address | string): Promise<Address>;
+//# sourceMappingURL=thread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/pda/thread.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,OAAO,EAA+C,MAAM,aAAa,CAAC;AAkB5F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,SAAS,EAAE,OAAO,GAAG,MAAM,EAC3B,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAChC,OAAO,CAAC,OAAO,CAAC,CAqBlB"}

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

@@ -0,0 +1,29 @@
+/**
+ * Token account derivation utilities
+ * @module pda/token
+ */
+import { Address } from '@solana/kit';
+/**
+ * Derive an Associated Token Account (ATA) address
+ *
+ * ATAs are deterministic token accounts owned by a wallet for a specific token mint.
+ * This is the standard way to derive token account addresses in Solana.
+ *
+ * @param owner - The wallet public key that owns the ATA
+ * @param mint - The token mint public key
+ * @param tokenProgramAddress - Optional token program address (defaults to SPL Token)
+ * @param associatedTokenProgramAddress - Optional ATA program address (defaults to SPL ATA)
+ * @returns The derived ATA address
+ *
+ * @example
+ * ```typescript
+ * import { deriveAssociatedTokenAccount } from './token';
+ *
+ * const ata = await deriveAssociatedTokenAccount(
+ *   walletAddress,
+ *   atlasMintAddress
+ * );
+ * ```
+ */
+export declare function deriveAssociatedTokenAccount(owner: Address | string, mint: Address | string, tokenProgramAddress?: Address | string, associatedTokenProgramAddress?: Address | string): Promise<Address>;
+//# sourceMappingURL=token.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/pda/token.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,OAAO,EAA+C,MAAM,aAAa,CAAC;AAiB5F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,OAAO,GAAG,MAAM,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,EACtB,mBAAmB,CAAC,EAAE,OAAO,GAAG,MAAM,EACtC,6BAA6B,CAAC,EAAE,OAAO,GAAG,MAAM,GAC/C,OAAO,CAAC,OAAO,CAAC,CAqBlB"}

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

@@ -0,0 +1,75 @@
+/**
+ * @purpose Centralized program and token addresses for different networks
+ *
+ * Single source of truth for all Solana program addresses used by SRSLY.
+ * Supports mainnet-beta, devnet, and localnet environments.
+ */
+/**
+ * Program set type matching the SDK configuration
+ * Determines which SAGE, ATLAS, and ProfileFaction addresses to use
+ */
+export type ProgramSet = 'mainnet' | 'atlasnet' | 'holosim' | 'localnet';
+/**
+ * Addresses for a specific program set
+ */
+export interface ProgramAddresses {
+    /** SRSLY rental program address */
+    srsly: string;
+    /** Star Atlas SAGE program address */
+    sage: string;
+    /** ATLAS token mint address */
+    atlasMint: string;
+    /** Profile Faction program address */
+    profileFaction: string;
+    /** Star Atlas game ID */
+    gameId: string;
+}
+/**
+ * @deprecated Use ProgramAddresses instead
+ */
+export type NetworkAddresses = ProgramAddresses;
+/**
+ * Mainnet addresses (production Star Atlas)
+ */
+declare const MAINNET_ADDRESSES: ProgramAddresses;
+/**
+ * Atlasnet addresses (Star Atlas testnet/devnet)
+ */
+declare const ATLASNET_ADDRESSES: ProgramAddresses;
+/**
+ * Get addresses for a specific program set
+ *
+ * @param programSet - Program set identifier ('mainnet', 'atlasnet', or 'localnet')
+ * @returns Program-specific addresses
+ * @throws Error if program set is unknown
+ *
+ * @example
+ * ```typescript
+ * const addresses = getProgramAddresses('mainnet');
+ * console.log(addresses.atlasMint); // 'ATLASXmbP...'
+ *
+ * const testnetAddresses = getProgramAddresses('atlasnet');
+ * console.log(testnetAddresses.sage); // 'SAGEqqFew...'
+ * ```
+ */
+export declare function getProgramAddresses(programSet: ProgramSet): ProgramAddresses;
+/**
+ * @deprecated Use getProgramAddresses instead
+ */
+export declare function getNetworkAddresses(network: ProgramSet): ProgramAddresses;
+/**
+ * Check if a program set is valid
+ *
+ * @param programSet - Program set to validate
+ * @returns True if program set is supported
+ */
+export declare function isValidProgramSet(programSet: string): programSet is ProgramSet;
+/**
+ * @deprecated Use isValidProgramSet instead
+ */
+export declare function isValidNetwork(network: string): network is ProgramSet;
+/**
+ * Re-export individual network addresses for direct access
+ */
+export { MAINNET_ADDRESSES, ATLASNET_ADDRESSES };
+//# sourceMappingURL=addresses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../../src/utils/addresses.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEhD;;GAEG;AACH,QAAA,MAAM,iBAAiB,EAAE,gBAMxB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,kBAAkB,EAAE,gBAMzB,CAAC;AAYF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAU5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,IAAI,UAAU,CAE9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,UAAU,CAErE;AAED;;GAEG;AACH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EACnB,CAAC"}

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

@@ -1,129 +1,149 @@
 /**
- * @purpose Network configuration and program address management for multi-network support
- * @reviewed 2025-07-29
+ * @purpose Simple SDK configuration management
+ *
+ * Provides global configuration with per-call overrides.
+ * Supports both @solana/kit (default) and @solana/web3.js modes.
  */
-export type ProgramSet = 'mainnet' | 'atlasnet' | 'holosim';
+import type { Commitment } from '@solana/kit';
+import { type ProgramSet as AddressesProgramSet, type NetworkAddresses } from './addresses';
 /**
- * PublicKey constructor interface for web3.js library integration
+ * PublicKey constructor type for web3.js compatibility
  */
 export interface PublicKeyConstructor<TPublicKey = any> {
     new (address: string): TPublicKey;
 }
 /**
- * Configuration options that can be set globally or overridden per call
+ * Program address set type
+ * Re-exported from addresses module for convenience
  */
-export interface SdkConfigOptions {
-    programs?: ProgramSet;
-    srslyProgramAddress?: string;
-    profileFactionProgramAddress?: string;
-    antegenProgramAddress?: string;
-    atlasMint?: string;
-    rpcUrl?: string;
-    library?: 'kit' | 'web3js';
-    PublicKey?: any;
-}
+export type ProgramSet = AddressesProgramSet;
 /**
- * Resolve program addresses based on configuration
- * @param config Effective SDK configuration options
- * @returns Resolved program addresses
+ * SDK configuration options
  */
-export declare function resolveProgramAddresses(config: SdkConfigOptions): {
-    srslyProgramAddress: any;
-    sageProgramAddress: any;
-    profileFactionProgramAddress: any;
-    antegenProgramAddress: any;
-    atlasMint: any;
-    gameId: any;
-    rpcUrl: string | undefined;
-};
+export interface SdkConfig {
+    /**
+     * Program address set (determines which SAGE, ATLAS, ProfileFaction addresses to use)
+     */
+    programs: ProgramSet;
+    /**
+     * RPC URL - defaults based on programs if not specified
+     * @default 'https://api.mainnet-beta.solana.com' for mainnet
+     * @default 'https://api.devnet.solana.com' for atlasnet
+     * @default 'http://localhost:8899' for localnet
+     */
+    rpcUrl?: string;
+    /**
+     * Custom SRSLY program ID (overrides default)
+     */
+    programId?: string;
+    /**
+     * Transaction commitment level
+     */
+    commitment?: Commitment;
+    /**
+     * PublicKey constructor for web3.js mode (optional)
+     * If provided, instructions will be returned in web3.js format
+     * @example import { PublicKey } from '@solana/web3.js';
+     */
+    PublicKey?: PublicKeyConstructor;
+}
 /**
- * Set global configuration options that will be used as defaults for all SDK operations
- * @param config SDK configuration options to set globally
+ * Set global SDK configuration
+ *
+ * This configuration will be used as the default for all SDK operations.
+ * Individual function calls can override these settings.
+ *
+ * @param config - Configuration options to set globally
  *
  * @example
  * ```typescript
- * // Use default atlasnet program addresses
+ * // Use atlasnet programs with default devnet RPC
  * setSdkConfig({ programs: 'atlasnet' });
  *
- * // Use holosim program addresses
- * setSdkConfig({ programs: 'holosim' });
- *
- * // Use holosim program addresses
+ * // Use mainnet programs with web3.js
+ * import { PublicKey } from '@solana/web3.js';
  * setSdkConfig({
- *   programs: 'holosim'
+ *   programs: 'mainnet',
+ *   PublicKey
  * });
  *
- * // Configure for web3js
- * import { PublicKey } from '@solana/web3.js';
+ * // Use mainnet programs with custom RPC (e.g., Helius, QuickNode)
  * setSdkConfig({
- *   library: 'web3js',
- *   PublicKey,
- *   rpcUrl: 'https://api.mainnet-beta.solana.com'
+ *   programs: 'mainnet',
+ *   rpcUrl: 'https://my-custom-mainnet-rpc.com'
  * });
  *
- * // Can still override per instruction
- * await createContract(params).set({ srslyProgramAddress: 'custom...' });
+ * // Use atlasnet programs with custom devnet RPC
+ * setSdkConfig({
+ *   programs: 'atlasnet',
+ *   rpcUrl: 'https://my-custom-devnet-rpc.com'
+ * });
  * ```
  */
-export declare function setSdkConfig(config: SdkConfigOptions): void;
+export declare function setSdkConfig(config: Partial<SdkConfig>): void;
 /**
  * Get the current global SDK configuration
- * @returns Current global SDK configuration options
+ *
+ * @returns A copy of the current global configuration
  */
-export declare function getSdkConfig(): SdkConfigOptions;
+export declare function getSdkConfig(): SdkConfig;
 /**
- * Clear global SDK configuration (resets to atlasnet program set defaults)
+ * Clear global SDK configuration (resets to defaults)
  */
 export declare function clearSdkConfig(): void;
 /**
- * Get the effective SDK configuration by merging global config with provided overrides
- * @param overrides Optional SDK configuration overrides
- * @returns Merged configuration with global defaults and any overrides
+ * Merge global config with optional overrides
+ *
+ * @param overrides - Optional configuration overrides
+ * @returns Merged configuration
  */
-export declare function getEffectiveSdkConfig(overrides?: SdkConfigOptions): SdkConfigOptions;
+export declare function mergeConfig(overrides?: Partial<SdkConfig>): SdkConfig;
 /**
- * Get the single codama module (network agnostic)
- * @param modulePath The module type ('instructions', 'programs', 'accounts', or 'kit')
- * @returns The codama module or kit utilities
+ * Get the effective RPC URL for a configuration
+ *
+ * @param config - Optional SDK configuration. If not provided, uses global config
+ * @returns RPC URL to use
  */
-export declare function getModule(modulePath: 'instructions' | 'programs' | 'accounts' | 'kit'): any;
+export declare function getRpcUrl(config?: Partial<SdkConfig>): string;
 /**
- * @deprecated Use getModule instead. This function is kept for backward compatibility.
- * Get codama modules (network agnostic)
+ * Get the effective program ID for a configuration
+ *
+ * @param config - SDK configuration
+ * @returns Program ID to use
  */
-export declare function getCachedNetworkModule<T = any>(modulePath: string): Promise<T>;
+export declare function getProgramId(config: SdkConfig): string;
 /**
- * SDK configuration selector for overriding network and constants
- * Also implements PromiseLike to allow direct awaiting
+ * Get the effective commitment level for a configuration
+ *
+ * @param config - SDK configuration
+ * @returns Commitment level to use
  */
-export interface SdkConfigSelector<T> extends PromiseLike<T> {
-    /**
-     * Set configuration options for this call
-     */
-    set(options: SdkConfigOptions): SdkConfigSelector<T>;
-    /**
-     * Build with current configuration (explicit call)
-     */
-    build(): Promise<T>;
-}
+export declare function getCommitment(config: SdkConfig): Commitment;
 /**
- * Create the initial fluent SDK config selector for a function.
- * This is the main entry point for the fluent configuration API.
+ * Get program-specific addresses with optional overrides
  *
- * The returned selector can be:
- * - Awaited directly (uses global config + atlasnet fallback)
- * - Configured with .set() to override network/constants
- * - Chained with multiple .set() calls
+ * Returns addresses for the configured program set. The SRSLY program ID
+ * can be overridden via config.programId.
  *
- * @param executeFn - The function to execute with optional configuration
- * @returns A SdkConfigSelector that supports fluent configuration
+ * @param config - Optional SDK configuration overrides
+ * @returns Program addresses with any config overrides applied
  *
  * @example
- * // Usage patterns:
- * setSdkConfig({ programs: 'mainnet' });
- * await createSdkConfigSelector(executeFn)                    // Direct await (uses global config)
- * await createSdkConfigSelector(executeFn).set({...})        // Override global config
- * await createSdkConfigSelector(executeFn).set({...}).set({...}) // Chained configs
+ * ```typescript
+ * // Get atlasnet addresses (from global config)
+ * setSdkConfig({ programs: 'atlasnet' });
+ * const addresses = getAddresses();
+ * console.log(addresses.atlasMint); // Atlasnet ATLAS mint
+ *
+ * // Override programs for specific call
+ * const mainnetAddrs = getAddresses({ programs: 'mainnet' });
+ *
+ * // Custom SRSLY program
+ * const customAddrs = getAddresses({ programId: 'MyCustomProgram...' });
+ * console.log(customAddrs.srsly); // 'MyCustomProgram...'
+ * ```
  */
-export declare function createSdkConfigSelector<T>(executeFn: (config?: SdkConfigOptions) => Promise<T>): SdkConfigSelector<T>;
+export declare function getAddresses(config?: Partial<SdkConfig>): NetworkAddresses & {
+    srsly: string;
+};
 //# sourceMappingURL=config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAoB5D;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,UAAU,GAAG,GAAG;IACpD,KAAK,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,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,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB;;;;;;;;EAgC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAEpF;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;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC1D;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAErD;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;CACrB;AAqCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GACnD,iBAAiB,CAAC,CAAC,CAAC,CAetB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAA8C,KAAK,UAAU,IAAI,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAExI;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,UAAU,GAAG,GAAG;IACpD,KAAK,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC;IAErB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;OAIG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,CAG7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAE3D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAS9F"}

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

@@ -1,17 +1,10 @@
 /**
- * @purpose Re-exports all utility functions and types for SDK usage
- * @reviewed 2025-07-29
+ * @purpose Utility functions and helpers
+ * @module utils
  */
-export * from './constants';
-export * from './config';
-export * from './payment-frequency';
-export * from './cron';
-export * from './schedule-validation';
-export * from './schedule-builder';
-export * from './instruction-converter';
-export * from './fetch-accounts';
-export * from './derive-pda';
-export * from './signer';
-export * from './smart-params';
-export * from './param-converters';
+export { setSdkConfig, getSdkConfig, clearSdkConfig, mergeConfig, getAddresses, type SdkConfig, type PublicKeyConstructor } from './config';
+export { getProgramAddresses, getNetworkAddresses, isValidProgramSet, isValidNetwork, MAINNET_ADDRESSES, ATLASNET_ADDRESSES, type ProgramSet, type ProgramAddresses, type NetworkAddresses } from './addresses';
+export { toTransactionSigner, validateAddress, isWeb3jsSigner, isKitSigner, isAddressString, type UniversalSigner } from './signer';
+export { toWeb3Instruction, toAddress, type KitInstruction, type Web3jsInstructionWithStrings, type Web3jsInstructionWithPublicKeys } from './web3js';
+export { prepareInstructions, type PrepareInstructionsOptions } from './instructions';
 //# 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;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,oBAAoB,EAC1B,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACrC,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAChC,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * Shared utilities for preparing instructions with compute budget and web3.js conversion
+ * @module utils/instructions
+ */
+import type { KitInstruction } from './web3js';
+import { type Web3jsInstructionWithPublicKeys, type Web3jsInstructionWithStrings } from './web3js';
+import type { PublicKeyConstructor } from './config';
+/**
+ * Options for preparing instructions
+ */
+export interface PrepareInstructionsOptions<TPublicKey = any> {
+    /**
+     * Optional compute units to allocate for the transaction
+     * If provided, prepends a SetComputeUnitLimit instruction
+     */
+    computeUnits?: number;
+    /**
+     * Optional PublicKey constructor for web3.js compatibility
+     * If provided, converts instructions to web3.js format
+     */
+    PublicKey?: PublicKeyConstructor<TPublicKey>;
+}
+/**
+ * Prepare instructions for transaction submission
+ *
+ * This utility handles the common workflow of:
+ * 1. Normalizing single instruction to array
+ * 2. Optionally prepending compute budget instruction
+ * 3. Optionally converting to web3.js format
+ *
+ * @param instructions - Single instruction or array of instructions
+ * @param options - Optional configuration for compute budget and web3.js conversion
+ * @returns Prepared instruction array (Kit or web3.js format)
+ *
+ * @example
+ * ```typescript
+ * // Just return kit instructions as array
+ * const ixs = prepareInstructions(acceptRentalIx);
+ *
+ * // Add compute budget
+ * const ixs = prepareInstructions(acceptRentalIx, { computeUnits: 400_000 });
+ *
+ * // Convert to web3.js
+ * import { PublicKey } from '@solana/web3.js';
+ * const ixs = prepareInstructions(acceptRentalIx, { PublicKey });
+ *
+ * // Both compute budget and web3.js conversion
+ * const ixs = prepareInstructions(acceptRentalIx, { computeUnits: 400_000, PublicKey });
+ * ```
+ */
+export declare function prepareInstructions<TPublicKey = any>(instructions: KitInstruction | KitInstruction[], options?: PrepareInstructionsOptions<TPublicKey>): KitInstruction[] | (Web3jsInstructionWithPublicKeys<TPublicKey> | Web3jsInstructionWithStrings)[];
+//# sourceMappingURL=instructions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/utils/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAqB,KAAK,+BAA+B,EAAE,KAAK,4BAA4B,EAAE,MAAM,UAAU,CAAC;AACtH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAiCrD;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,UAAU,GAAG,GAAG;IAC1D;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,GAAG,GAAG,EAClD,YAAY,EAAE,cAAc,GAAG,cAAc,EAAE,EAC/C,OAAO,CAAC,EAAE,0BAA0B,CAAC,UAAU,CAAC,GAC/C,cAAc,EAAE,GAAG,CAAC,+BAA+B,CAAC,UAAU,CAAC,GAAG,4BAA4B,CAAC,EAAE,CAiBnG"}