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

package/dist/cjs/utils/config.js

@@ -1,6 +1,7 @@
 "use strict";
 /**
- * Network configuration for the SRSLY SDK
+ * @purpose Network configuration and program address management for multi-network support
+ * @reviewed 2025-07-29
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -36,168 +37,209 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setConfig = setConfig;
-exports.getConfig = getConfig;
-exports.clearConfig = clearConfig;
-exports.setNetwork = setNetwork;
-exports.getNetwork = getNetwork;
-exports.importNetworkModule = importNetworkModule;
+exports.resolveProgramAddresses = resolveProgramAddresses;
+exports.setSdkConfig = setSdkConfig;
+exports.getSdkConfig = getSdkConfig;
+exports.clearSdkConfig = clearSdkConfig;
+exports.getEffectiveSdkConfig = getEffectiveSdkConfig;
+exports.getModule = getModule;
 exports.getCachedNetworkModule = getCachedNetworkModule;
-exports.createConfigSelector = createConfigSelector;
-// Default network when none is specified
-const DEFAULT_NETWORK = 'devnet';
-// Global configuration state
-let globalConfig = {};
+exports.createSdkConfigSelector = createSdkConfigSelector;
+/**
+ * Network configuration for the SRSLY SDK
+ */
+// Single codama output - network agnostic
+const instructions = __importStar(require("../generated/codama/instructions"));
+const programs = __importStar(require("../generated/codama/programs"));
+const accounts = __importStar(require("../generated/codama/accounts"));
+const kit_1 = require("@solana/kit");
+const constants_1 = require("./constants");
+const PROGRAM_SETS = {
+    mainnet: {
+        SAGE_PROGRAM_ADDRESS: 'SAGE2HAwep459SNq61LHvjxPk4pLPEJLoMETef7f7EE',
+        PROFILE_FACTION_PROGRAM_ADDRESS: 'pFACSRuobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq',
+        ATLAS_MINT: 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx',
+    },
+    atlasnet: {
+        SAGE_PROGRAM_ADDRESS: 'SAgeTraQfBMdvGVDJYoEvjnbq5szW7RJPi6obDTDQUF',
+        PROFILE_FACTION_PROGRAM_ADDRESS: 'pFACzkX2eSpAjDyEohD6i3VRJvREtH9ynbtM1DwVFsj',
+        ATLAS_MINT: 'ATLA5nAaVRfH6BNwD4SAyWp96EdQaAh6bBmGeTx956sx',
+    },
+    holosim: {
+        SAGE_PROGRAM_ADDRESS: 'SAgeTraQfBMdvGVDJYoEvjnbq5szW7RJPi6obDTDQUF',
+        PROFILE_FACTION_PROGRAM_ADDRESS: 'pFACzkX2eSpAjDyEohD6i3VRJvREtH9ynbtM1DwVFsj',
+        ATLAS_MINT: 'ATLA5nAaVRfH6BNwD4SAyWp96EdQaAh6bBmGeTx956sx',
+    },
+};
+// Default program set when none is specified
+const DEFAULT_PROGRAM_SET = 'atlasnet';
+// Global SDK configuration state
+let globalSdkConfig = {};
+/**
+ * Resolve program addresses based on configuration
+ * @param config Effective SDK configuration options
+ * @returns Resolved program addresses
+ */
+function resolveProgramAddresses(config) {
+    // Determine which program set to use
+    const programSet = config.programs || DEFAULT_PROGRAM_SET;
+    // Get program addresses from program sets
+    const programConfig = PROGRAM_SETS[programSet];
+    if (!programConfig) {
+        throw new Error(`Unknown program set: ${programSet}. Available: ${Object.keys(PROGRAM_SETS).join(', ')}`);
+    }
+    const rpcUrl = config.rpcUrl;
+    const srslyAddress = config.srslyProgramAddress || 'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT';
+    const sageAddress = programConfig.SAGE_PROGRAM_ADDRESS;
+    const profileFactionAddress = config.profileFactionProgramAddress || programConfig.PROFILE_FACTION_PROGRAM_ADDRESS;
+    const antegenAddress = config.antegenProgramAddress || 'AgThdyi1P5RkVeZD2rQahTvs8HePJoGFFxKtvok5s2J1';
+    const atlasMintAddress = config.atlasMint || programConfig.ATLAS_MINT;
+    const gameId = 'GAMEC7U7cqmFFaRow33j1LwuV8u4YhAS1mJ5Dqjnar2k';
+    return {
+        srslyProgramAddress: (0, constants_1.toAddress)(srslyAddress),
+        sageProgramAddress: (0, constants_1.toAddress)(sageAddress),
+        profileFactionProgramAddress: (0, constants_1.toAddress)(profileFactionAddress),
+        antegenProgramAddress: (0, constants_1.toAddress)(antegenAddress),
+        atlasMint: (0, constants_1.toAddress)(atlasMintAddress),
+        gameId: (0, constants_1.toAddress)(gameId),
+        rpcUrl: rpcUrl,
+    };
+}
 /**
  * Set global configuration options that will be used as defaults for all SDK operations
- * @param config Configuration options to set globally
+ * @param config SDK configuration options to set globally
  *
  * @example
  * ```typescript
- * // Set mainnet as default for all operations
- * setConfig({ network: 'mainnet' });
+ * // Use default atlasnet program addresses
+ * setSdkConfig({ programs: 'atlasnet' });
  *
- * // Now all operations use mainnet by default
- * await createContract(params); // Uses mainnet
- * await acceptRental(params);   // Uses mainnet
+ * // Use holosim program addresses
+ * setSdkConfig({ programs: 'holosim' });
+ *
+ * // Use holosim program addresses
+ * setSdkConfig({
+ *   programs: 'holosim'
+ * });
+ *
+ * // Configure for web3js
+ * import { PublicKey } from '@solana/web3.js';
+ * setSdkConfig({
+ *   library: 'web3js',
+ *   PublicKey,
+ *   rpcUrl: 'https://api.mainnet-beta.solana.com'
+ * });
  *
  * // Can still override per instruction
- * await createContract(params).set({ network: 'devnet' }); // Uses devnet
+ * await createContract(params).set({ srslyProgramAddress: 'custom...' });
  * ```
  */
-function setConfig(config) {
-    globalConfig = { ...config };
+function setSdkConfig(config) {
+    globalSdkConfig = { ...config };
 }
 /**
- * Get the current global configuration
- * @returns Current global configuration options
+ * Get the current global SDK configuration
+ * @returns Current global SDK configuration options
  */
-function getConfig() {
-    return { ...globalConfig };
+function getSdkConfig() {
+    return { ...globalSdkConfig };
 }
 /**
- * Clear global configuration (resets to devnet defaults)
+ * Clear global SDK configuration (resets to atlasnet program set defaults)
  */
-function clearConfig() {
-    globalConfig = {};
+function clearSdkConfig() {
+    globalSdkConfig = {};
 }
 /**
- * Set global network (convenience function for backward compatibility)
- * @param network Network to set as global default
- *
- * @example
- * ```typescript
- * // Set mainnet as default for all operations
- * setNetwork('mainnet');
- *
- * // Equivalent to:
- * setConfig({ network: 'mainnet' });
- * ```
- */
-function setNetwork(network) {
-    setConfig({ network });
-}
-/**
- * Get current global network (convenience function for backward compatibility)
- * @returns Current global network or 'devnet' if not set
- */
-function getNetwork() {
-    return globalConfig.network || 'devnet';
-}
-/**
- * Get the effective configuration by merging global config with provided overrides
- * @param overrides Optional configuration overrides
+ * 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
  */
-function getEffectiveConfig(overrides) {
-    return { ...globalConfig, ...overrides };
+function getEffectiveSdkConfig(overrides) {
+    return { ...globalSdkConfig, ...overrides };
 }
 /**
- * Dynamically import network-specific codama modules
- * @param modulePath The module path relative to the network directory
- * @param network Network to use (defaults to devnet if not specified)
- * @returns Promise resolving to the imported module
+ * Get the single codama module (network agnostic)
+ * @param modulePath The module type ('instructions', 'programs', 'accounts', or 'kit')
+ * @returns The codama module or kit utilities
  */
-async function importNetworkModule(modulePath, network) {
-    const targetNetwork = network || DEFAULT_NETWORK;
-    const fullPath = `./codama/${targetNetwork}/${modulePath}`;
-    try {
-        // Use dynamic import which works in both ESM and CJS with ES2020+
-        const module = await Promise.resolve(`${fullPath}`).then(s => __importStar(require(s)));
-        return module;
-    }
-    catch (error) {
-        throw new Error(`Failed to import ${fullPath} for network ${targetNetwork}: ${error}`);
+function getModule(modulePath) {
+    switch (modulePath) {
+        case 'instructions':
+            return instructions;
+        case 'programs':
+            return programs;
+        case 'accounts':
+            return accounts;
+        case 'kit':
+            return { createSolanaRpc: kit_1.createSolanaRpc };
+        default:
+            throw new Error(`Unsupported module path: ${modulePath}`);
     }
 }
-const moduleCache = {};
 /**
- * Cached import for better performance
- * Uses global config network as default if no network specified
+ * @deprecated Use getModule instead. This function is kept for backward compatibility.
+ * Get codama modules (network agnostic)
  */
-async function getCachedNetworkModule(modulePath, network) {
-    const targetNetwork = network || globalConfig.network || DEFAULT_NETWORK;
-    const cacheKey = `${targetNetwork}:${modulePath}`;
-    if (moduleCache[cacheKey]) {
-        return moduleCache[cacheKey];
+async function getCachedNetworkModule(modulePath) {
+    if (modulePath !== 'instructions' && modulePath !== 'programs') {
+        throw new Error(`Unsupported module path: ${modulePath}. Use 'instructions' or 'programs'.`);
     }
-    const module = await importNetworkModule(modulePath, targetNetwork);
-    moduleCache[cacheKey] = module;
-    return module;
+    return getModule(modulePath);
 }
 /**
- * Create a chainable config selector with existing configuration state.
+ * Create a chainable SDK config selector with existing configuration state.
  * This enables config chaining by merging new options with existing ones.
  *
- * Used internally when .set() is called on an existing ConfigSelector.
+ * Used internally when .set() is called on an existing SdkConfigSelector.
  *
  * @param executeFn - The function to execute with merged configuration
  * @param existingConfig - The current configuration state to merge with
- * @returns A ConfigSelector that can chain additional .set() calls
+ * @returns A SdkConfigSelector that can chain additional .set() calls
  *
  * @example
- * // This creates a chainable selector that merges { network: 'devnet' }
+ * // This creates a chainable selector that merges { programs: 'atlasnet' }
  * // with any additional config options passed to subsequent .set() calls
- * createChainableConfigSelector(executeFn, { network: 'devnet' })
+ * createChainableSdkConfigSelector(executeFn, { programs: 'atlasnet' })
  */
-function createChainableConfigSelector(executeFn, existingConfig) {
+function createChainableSdkConfigSelector(executeFn, existingConfig) {
     const selector = {
-        set: (additionalOptions) => createChainableConfigSelector(executeFn, { ...existingConfig, ...additionalOptions }),
+        set: (additionalOptions) => createChainableSdkConfigSelector(executeFn, { ...existingConfig, ...additionalOptions }),
         build: () => executeFn(existingConfig),
         // Implement PromiseLike to allow direct awaiting
         then(onfulfilled, onrejected) {
             return executeFn(existingConfig).then(onfulfilled, onrejected);
-        }
+        },
     };
     return selector;
 }
 /**
- * Create the initial fluent config selector for a function.
+ * Create the initial fluent SDK 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 + devnet fallback)
+ * - 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
+ * @returns A SdkConfigSelector that supports fluent configuration
  *
  * @example
  * // Usage patterns:
- * setConfig({ network: 'mainnet' });
- * await createConfigSelector(executeFn)                    // Direct await (uses global mainnet)
- * await createConfigSelector(executeFn).set({...})        // Override global config
- * await createConfigSelector(executeFn).set({...}).set({...}) // Chained configs
+ * 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
  */
-function createConfigSelector(executeFn) {
+function createSdkConfigSelector(executeFn) {
     const selector = {
-        set: (options) => createChainableConfigSelector(executeFn, getEffectiveConfig(options)),
-        build: () => executeFn(getEffectiveConfig()),
+        set: (options) => createChainableSdkConfigSelector(executeFn, getEffectiveSdkConfig(options)),
+        build: () => executeFn(getEffectiveSdkConfig()),
         // Implement PromiseLike to allow direct awaiting
         then(onfulfilled, onrejected) {
-            return executeFn(getEffectiveConfig()).then(onfulfilled, onrejected);
-        }
+            return executeFn(getEffectiveSdkConfig()).then(onfulfilled, onrejected);
+        },
     };
     return selector;
 }

package/dist/cjs/utils/config.js.map

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

package/dist/cjs/utils/constants.js

@@ -1,97 +1,68 @@
 "use strict";
+/**
+ * @purpose SDK constants including address conversion, seeds, and network-aware helpers
+ * @reviewed 2025-07-29
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FACTION_MAPPING = exports.FACTION_SPECIFIC_CSS = exports.PaymentFrequency = exports.ATLAS_TO_STARDUST = exports.PROFILE_FACTION_SEED = exports.SAGE_PLAYER_PROFILE_SEED = exports.STARBASE_PLAYER_SEED = exports.STARBASE_SEED = void 0;
-exports.getPaymentFrequency = getPaymentFrequency;
+exports.FACTION_MAPPING = exports.FACTION_SPECIFIC_CSS = exports.ATLAS_TO_STARDUST = exports.PROFILE_FACTION_SEED = exports.SAGE_PLAYER_PROFILE_SEED = exports.STARBASE_PLAYER_SEED = exports.STARBASE_SEED = void 0;
+exports.toAddress = toAddress;
 exports.getSrslyProgramAddress = getSrslyProgramAddress;
-exports.getProgramId = getProgramId;
 exports.getSageProgramAddress = getSageProgramAddress;
 exports.getProfileFactionProgramAddress = getProfileFactionProgramAddress;
-exports.getSageGameId = getSageGameId;
-exports.paymentFrequencyToString = paymentFrequencyToString;
+exports.getAtlasMint = getAtlasMint;
 const config_1 = require("./config");
+const kit_1 = require("@solana/kit");
+/**
+ * Converts a string or Address to an Address type
+ * This utility ensures consistent address handling across the SDK
+ */
+function toAddress(value) {
+    // Safety check for undefined/null values with detailed error info
+    if (value === undefined || value === null || value === '') {
+        const stack = new Error().stack;
+        throw new Error(`toAddress received invalid value: ${value} (type: ${typeof value}). Expected a non-empty string address. Call stack: ${stack}`);
+    }
+    // If it's already an Address type, return as-is
+    if ((0, kit_1.isAddress)(value)) {
+        return value;
+    }
+    // Convert string to Address using @solana/kit
+    return (0, kit_1.address)(value);
+}
 // Seed constants
 exports.STARBASE_SEED = 'Starbase';
 exports.STARBASE_PLAYER_SEED = 'starbase_player';
 exports.SAGE_PLAYER_PROFILE_SEED = 'sage_player_profile';
-exports.PROFILE_FACTION_SEED = 'profile_faction';
+exports.PROFILE_FACTION_SEED = 'player_faction';
 // Token conversion constants
 exports.ATLAS_TO_STARDUST = 100_000_000; // 1 ATLAS = 100,000,000 stardust
-// PaymentFrequency enum to match the Rust program
-var PaymentFrequency;
-(function (PaymentFrequency) {
-    PaymentFrequency[PaymentFrequency["Hourly"] = 0] = "Hourly";
-    PaymentFrequency[PaymentFrequency["Daily"] = 1] = "Daily";
-    PaymentFrequency[PaymentFrequency["DailyOld"] = 2] = "DailyOld";
-    PaymentFrequency[PaymentFrequency["Weekly"] = 3] = "Weekly";
-    PaymentFrequency[PaymentFrequency["Monthly"] = 4] = "Monthly";
-    // Development-only frequencies (not available on mainnet)
-    PaymentFrequency[PaymentFrequency["Decasecond"] = 5] = "Decasecond";
-    PaymentFrequency[PaymentFrequency["Minute"] = 6] = "Minute";
-})(PaymentFrequency || (exports.PaymentFrequency = PaymentFrequency = {}));
-// Export async functions to get network-specific constants
-async function getPaymentFrequency() {
-    const module = await (0, config_1.getCachedNetworkModule)('types');
-    return module.PaymentFrequency;
-}
-async function getSrslyProgramAddress() {
-    const module = await (0, config_1.getCachedNetworkModule)('programs');
-    return module.SRSLY_PROGRAM_ADDRESS;
-}
-// Export async function to get program ID
-async function getProgramId() {
-    return await getSrslyProgramAddress();
+// PaymentFrequency enum is now exported from codama-generated types
+// Network constants are now managed in config.ts
+async function getSrslyProgramAddress(config) {
+    const globalConfig = (0, config_1.getSdkConfig)();
+    const effectiveConfig = { ...globalConfig, ...config };
+    const resolved = (0, config_1.resolveProgramAddresses)(effectiveConfig);
+    return toAddress(resolved.srslyProgramAddress);
 }
 // Network-specific constants with configuration support
 async function getSageProgramAddress(config) {
-    // Merge global config with provided config
-    const globalConfig = (0, config_1.getConfig)();
+    const globalConfig = (0, config_1.getSdkConfig)();
     const effectiveConfig = { ...globalConfig, ...config };
-    if (effectiveConfig?.sageProgramAddress)
-        return effectiveConfig.sageProgramAddress;
-    const targetNetwork = effectiveConfig?.network; // Uses global config or devnet default
-    try {
-        const constantsModule = await (0, config_1.getCachedNetworkModule)('constants', targetNetwork);
-        return constantsModule.SAGE_PROGRAM_ADDRESS;
-    }
-    catch {
-        // Fallback to programs module or hardcoded default
-        const programsModule = await (0, config_1.getCachedNetworkModule)('programs', targetNetwork);
-        return programsModule.SAGE_PROGRAM_ADDRESS || 'sAgezwJpDb1aHvzNr3o24cKjsETmFEKghBEyJ1askDi';
-    }
+    const resolved = (0, config_1.resolveProgramAddresses)(effectiveConfig);
+    // Note: SAGE program address is fixed based on network and cannot be overridden
+    return resolved.sageProgramAddress; // Already converted to Address in resolveProgramAddresses
 }
 async function getProfileFactionProgramAddress(config) {
-    // Merge global config with provided config
-    const globalConfig = (0, config_1.getConfig)();
+    const globalConfig = (0, config_1.getSdkConfig)();
     const effectiveConfig = { ...globalConfig, ...config };
-    if (effectiveConfig?.profileFactionProgramAddress)
-        return effectiveConfig.profileFactionProgramAddress;
-    const targetNetwork = effectiveConfig?.network; // Uses global config or devnet default
-    try {
-        const constantsModule = await (0, config_1.getCachedNetworkModule)('constants', targetNetwork);
-        return constantsModule.PROFILE_FACTION_PROGRAM_ADDRESS;
-    }
-    catch {
-        // Fallback to programs module or hardcoded default
-        const programsModule = await (0, config_1.getCachedNetworkModule)('programs', targetNetwork);
-        return programsModule.PROFILE_FACTION_PROGRAM_ADDRESS || 'pFACSRuobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq';
-    }
+    const resolved = (0, config_1.resolveProgramAddresses)(effectiveConfig);
+    return resolved.profileFactionProgramAddress;
 }
-async function getSageGameId(config) {
-    // Merge global config with provided config
-    const globalConfig = (0, config_1.getConfig)();
+async function getAtlasMint(config) {
+    const globalConfig = (0, config_1.getSdkConfig)();
     const effectiveConfig = { ...globalConfig, ...config };
-    if (effectiveConfig?.gameId)
-        return effectiveConfig.gameId;
-    const targetNetwork = effectiveConfig?.network; // Uses global config or devnet default
-    try {
-        const constantsModule = await (0, config_1.getCachedNetworkModule)('constants', targetNetwork);
-        return constantsModule.SAGE_GAME_ID;
-    }
-    catch {
-        // Fallback to programs module or hardcoded default
-        const programsModule = await (0, config_1.getCachedNetworkModule)('programs', targetNetwork);
-        return programsModule.SAGE_GAME_ID || 'GAMEzqJehF8yAnKiTARUuhZMvLvkZVAsCVri5vSfemLr';
-    }
+    const resolved = (0, config_1.resolveProgramAddresses)(effectiveConfig);
+    return resolved.atlasMint; // Already converted to Address in resolveProgramAddresses
 }
 // Faction-specific CSS coordinates for starbase derivation
 exports.FACTION_SPECIFIC_CSS = {
@@ -102,13 +73,6 @@ exports.FACTION_SPECIFIC_CSS = {
 exports.FACTION_MAPPING = {
     1: 'mud',
     2: 'oni',
-    3: 'ustur'
+    3: 'ustur',
 };
-/**
- * Convert PaymentFrequency enum to string (async version)
- */
-async function paymentFrequencyToString(freq) {
-    const PaymentFrequency = await getPaymentFrequency();
-    return PaymentFrequency[freq].toLowerCase();
-}
 //# sourceMappingURL=constants.js.map

package/dist/cjs/utils/constants.js.map

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