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

package/README.md

@@ -4,7 +4,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Solana](https://img.shields.io/badge/Solana-000?style=flat&logo=solana&logoColor=9945FF)](https://solana.com/)
 
-A TypeScript SDK for interacting with the SRSLY (Space Rental from SLY) Solana program - a decentralized rental system for Star Atlas.
+A TypeScript SDK for interacting with the SRSLY (Space Rental from SLY) Solana program - a decentralized rental system for Star Atlas fleets with network-specific configuration support.
 
 ## Installation
 
@@ -31,14 +31,17 @@ yarn add @wuwei-labs/srsly
 ```typescript
 import { 
   createContract, 
-  acceptRental, 
-  setNetwork
+  acceptRental,
+  setConfig,
+  setNetwork, 
+  ATLAS_TO_STARDUST
 } from '@wuwei-labs/srsly';
 
-// Set global network (optional - defaults to devnet)
-setNetwork('mainnet');
+// Option 1: Set global configuration (recommended for most apps)
+setConfig({ network: 'mainnet' });
+// or use the convenience function: setNetwork('mainnet');
 
-// Create a rental contract using global network setting (direct await)
+// Now all operations use mainnet by default
 const contractInstruction = await createContract({
   owner: wallet,
   fleet: fleetAddress,
@@ -48,23 +51,34 @@ const contractInstruction = await createContract({
   durationMax: 604800, // 1 week in seconds
   paymentsFreq: 'daily',
   ownerKeyIndex: 0
-});
+}); // Uses mainnet from global config
+
+// Accept a rental with automatic ATLAS to stardust conversion
+const acceptInstruction = await acceptRental({
+  borrower: borrowerWallet,
+  borrowerProfile: borrowerProfileAddress,
+  borrowerFaction: 'mud', // or 1, 2, 3
+  fleet: fleetAddress,
+  contract: contractAddress,
+  rate: 100, // ATLAS tokens per duration
+  duration: 86400 // 1 day in seconds
+  // amount is automatically calculated: rate * duration * ATLAS_TO_STARDUST
+}); // Uses mainnet from global config
 
-// Or override network for specific instruction
-const mainnetInstruction = await createContract(params).mainnet();
-const devnetInstruction = await createContract(params).devnet();
+// Option 2: Override global config for specific instructions
+const devnetInstruction = await createContract(params).set({ network: 'devnet' });
 ```
 
 ## Core Features
 
 ### Contract Management
 
-Create and manage rental contracts for Star Atlas:
+Create and manage rental contracts for Star Atlas fleets:
 
 ```typescript
 import { createContract, closeContract } from '@wuwei-labs/srsly';
 
-// Create a new rental contract with network selection
+// Create a new rental contract with network configuration
 const createIx = await createContract({
   owner: wallet,
   fleet: fleetAddress,
@@ -74,60 +88,69 @@ const createIx = await createContract({
   durationMax: 2592000, // Maximum 30 days
   paymentsFreq: 'daily',
   ownerKeyIndex: 0
-}).mainnet(); // Use mainnet for this instruction
+}).set({ network: 'mainnet' }); // Use mainnet configuration
 
-// Close an existing contract using global network setting (direct await)
+// Close an existing contract using devnet defaults (direct await)
 const closeIx = await closeContract({
   owner: wallet,
   fleet: fleetAddress,
   contract: contractAddress,
-  faction: 'mud',
-  ownerProfile: profileAddress
+  faction: 'mud' // or faction number: 1, 2, 3
 });
 ```
 
 ### Rental Operations
 
-Handle rental lifecycle operations:
+Handle rental lifecycle operations with automatic token conversion:
 
 ```typescript
 import { 
   acceptRental, 
   cancelRental, 
   closeRental, 
-  resetRental 
+  resetRental,
+  ATLAS_TO_STARDUST
 } from '@wuwei-labs/srsly';
 
-// Accept a rental offer on devnet
+// Accept a rental offer on devnet (rate-based with automatic conversion)
 const acceptIx = await acceptRental({
   borrower: borrowerWallet,
   borrowerProfile: borrowerProfileAddress,
+  borrowerFaction: 'oni', // or faction number: 1=mud, 2=oni, 3=ustur
+  fleet: fleetAddress,
   contract: contractAddress,
-  borrowerFaction: 'oni',
-  duration: 86400,
-  amount: 1000000
-}).devnet();
+  rate: 100, // ATLAS tokens (not per second, just ATLAS)
+  duration: 86400 // 1 day in seconds
+  // amount = rate * duration * ATLAS_TO_STARDUST automatically calculated
+}).set({ network: 'devnet' });
 
-// Cancel an active rental using current network setting (direct await)
+// Cancel an active rental using devnet defaults (direct await)
 const cancelIx = await cancelRental({
   borrower: borrowerWallet,
-  rental: rentalAddress
+  contract: contractAddress,
+  rentalState: rentalStateAddress
 });
 
 // Close a completed rental on mainnet
 const closeIx = await closeRental({
   borrower: borrowerWallet,
-  rental: rentalAddress
-}).mainnet();
+  contract: contractAddress,
+  rentalState: rentalStateAddress,
+  ownerTokenAccount: ownerTokenAccountAddress
+}).set({ network: 'mainnet' });
 
-// Reset rental state (admin only) with specific network
+// Reset rental state with custom configuration
 const resetIx = await resetRental({
   fleet: fleetAddress,
   contract: contractAddress,
   rentalState: rentalStateAddress,
   faction: 'mud',
   ownerProfile: ownerProfileAddress
-}).network('mainnet');
+}).set({ 
+  network: 'mainnet',
+  sageProgramAddress: 'custom...',
+  gameId: 'custom...'
+});
 ```
 
 ### Account State Management
@@ -135,15 +158,15 @@ const resetIx = await resetRental({
 Fetch and decode account states using network-specific functions:
 
 ```typescript
-import { getCachedNetworkModule, setNetwork } from '@wuwei-labs/srsly';
-
-// Set the network first
-setNetwork('mainnet');
+import { getCachedNetworkModule } from '@wuwei-labs/srsly';
 
-// Get network-specific account functions
+// Get network-specific account functions (defaults to devnet)
 const accountsModule = await getCachedNetworkModule('accounts');
 const { fetchContractState, fetchRentalState } = accountsModule;
 
+// Or specify network explicitly
+const mainnetAccountsModule = await getCachedNetworkModule('accounts', 'mainnet');
+
 // Fetch contract state
 const contractState = await fetchContractState(rpc, contractPublicKey);
 console.log('Contract rate:', contractState.rate.toString());
@@ -155,6 +178,21 @@ console.log('Rental status:', rentalState.status);
 console.log('Start time:', new Date(rentalState.startTime.toNumber() * 1000));
 ```
 
+### Token Conversion
+
+The SDK includes automatic ATLAS to stardust conversion for rental operations:
+
+```typescript
+import { ATLAS_TO_STARDUST } from '@wuwei-labs/srsly';
+
+// ATLAS_TO_STARDUST = 100_000_000 (1 ATLAS = 100 million stardust)
+console.log('Conversion rate:', ATLAS_TO_STARDUST);
+
+// When using acceptRental with rate and duration:
+// Final amount = rate * duration * ATLAS_TO_STARDUST
+// Example: 100 ATLAS * 86400 seconds * 100_000_000 = 864,000,000,000,000 stardust
+```
+
 ## Program Information
 
 - **Program ID**: `SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT`
@@ -188,67 +226,125 @@ try {
 
 ## Network Configuration
 
-The SDK supports both Solana mainnet and devnet with network-specific program configurations. You can configure networks globally or per instruction.
+The SDK supports both Solana mainnet and devnet with network-specific program configurations. You can set global configuration for convenience or override per instruction for flexibility.
 
-### Global Network Configuration
+### Global Configuration (Recommended)
 
-Set the default network for all SDK operations:
+Set default configuration once for all SDK operations:
 
 ```typescript
-import { setNetwork, getNetwork } from '@wuwei-labs/srsly';
+import { setConfig, setNetwork, getConfig, createContract } from '@wuwei-labs/srsly';
 
-// Set global network (defaults to 'devnet')
+// Option 1: Full configuration
+setConfig({ 
+  network: 'mainnet',
+  gameId: 'custom-game-id...' 
+});
+
+// Option 2: Network-only (convenience function)
 setNetwork('mainnet');
 
-// Check current network
-console.log(getNetwork()); // 'mainnet'
+// Check current configuration
+console.log(getConfig()); // { network: 'mainnet' }
 
-// All instructions will now use mainnet by default (direct await)
-const ix = await createContract(params);
+// All operations now use mainnet by default
+const ix1 = await createContract(params);
+const ix2 = await acceptRental(params);
 ```
 
-### Per-Instruction Network Selection
+### Per-Instruction Configuration
 
-Override the network for specific instructions using the fluent interface:
+Override global configuration for specific instructions using the fluent `.set()` interface:
 
 ```typescript
-import { createContract } from '@wuwei-labs/srsly';
+import { createContract, acceptRental } from '@wuwei-labs/srsly';
 
-// Use mainnet for this specific instruction
-const mainnetIx = await createContract(params).mainnet();
+// Assume global config is set to mainnet
+setConfig({ network: 'mainnet' });
 
-// Use devnet for this specific instruction  
-const devnetIx = await createContract(params).devnet();
+// Use global mainnet config
+const mainnetIx = await createContract(params);
 
-// Use a specific network
-const specificIx = await createContract(params).network('mainnet');
+// Override to use devnet for this specific instruction
+const devnetIx = await createContract(params).set({ network: 'devnet' });
 
-// Use global network setting (direct await - no .build() needed!)
-const globalIx = await createContract(params);
+// Override specific constants while keeping global network
+const customIx = await createContract(params).set({ 
+  sageProgramAddress: 'custom...',
+  gameId: 'custom...'
+  // network: 'mainnet' inherited from global config
+});
 ```
 
-### Network Selection Methods
+### Configuration Options
 
 All SDK functions support these usage patterns:
 
-**Direct await (uses global network):**
+**Direct await (uses global config or devnet fallback):**
+
 ```typescript
+// Uses global configuration if set, otherwise devnet
 await createContract(params);
 await acceptRental(params);
 ```
 
-**Network-specific methods:**
-- `.mainnet()` - Build with mainnet configuration
-- `.devnet()` - Build with devnet configuration  
-- `.network(network)` - Build with specified network
-- `.build()` - Build with current global network setting (explicit)
+**Global configuration functions:**
+
+- `setConfig({ network: 'mainnet', gameId: '...' })` - Set full global config
+- `setNetwork('mainnet')` - Set global network only (convenience)
+- `getConfig()` - Get current global configuration
+- `clearConfig()` - Reset to devnet defaults
+
+**Per-instruction overrides with `.set()` method:**
+
+- `.set({ network: 'mainnet' })` - Override global network
+- `.set({ sageProgramAddress: '...' })` - Override specific constants only
+- `.set({ network: 'mainnet', sageProgramAddress: '...' })` - Multiple overrides
+
+**Chainable configurations:**
+
+```typescript
+// Chain multiple configurations (later ones override earlier ones)
+await createContract(params)
+  .set({ network: 'devnet' })
+  .set({ sageProgramAddress: 'override...' });
+
+// Examples with global config
+setConfig({ network: 'mainnet' });
+await createContract(params); // Uses mainnet
+await acceptRental(params).set({ network: 'devnet' }); // Override to devnet
+await closeContract(params).set({ gameId: 'custom...' }); // Custom gameId, mainnet network
+```
+
+### Available Configuration Options
+
+```typescript
+interface ConfigOptions {
+  network?: 'mainnet' | 'devnet';              // Set/override network
+  sageProgramAddress?: string;                 // Set/override SAGE program address
+  profileFactionProgramAddress?: string;       // Set/override Profile Faction program address  
+  gameId?: string;                            // Set/override SAGE game ID
+}
+```
+
+### Network-Specific Constants
+
+The SDK automatically resolves network-specific constants:
 
 ```typescript
-// Examples across different functions
-await createContract(params).mainnet();
-await acceptRental(params).devnet();
-await closeContract(params).network('mainnet');
-await resetRental(params); // Direct await uses global network
+import { 
+  getSageProgramAddress, 
+  getProfileFactionProgramAddress, 
+  getSageGameId 
+} from '@wuwei-labs/srsly';
+
+// Get constants for devnet (default)
+const sageProgram = await getSageProgramAddress();
+const gameId = await getSageGameId();
+
+// Get constants for specific network
+const mainnetSageProgram = await getSageProgramAddress({ network: 'mainnet' });
+const mainnetGameId = await getSageGameId({ network: 'mainnet' });
 ```
 
 ## IDL and Types
@@ -279,7 +375,8 @@ import type {
   RentalState,
   PaymentFrequency,
   ClockData,
-  ThreadResponse
+  ThreadResponse,
+  ConfigOptions
 } from '@wuwei-labs/srsly';
 
 // Import network-specific Anchor types
@@ -287,6 +384,55 @@ import type { Srsly as SrslyMainnet } from '@wuwei-labs/srsly/types/mainnet';
 import type { Srsly as SrslyDevnet } from '@wuwei-labs/srsly/types/devnet';
 ```
 
+## Constants and Utilities
+
+### Available Constants
+
+```typescript
+import { 
+  ATLAS_TO_STARDUST,
+  STARBASE_SEED,
+  STARBASE_PLAYER_SEED,
+  SAGE_PLAYER_PROFILE_SEED,
+  PROFILE_FACTION_SEED,
+  FACTION_MAPPING,
+  FACTION_SPECIFIC_CSS
+} from '@wuwei-labs/srsly';
+
+// Token conversion
+console.log(ATLAS_TO_STARDUST); // 100_000_000
+
+// Faction mappings
+console.log(FACTION_MAPPING[1]); // 'mud'
+console.log(FACTION_MAPPING[2]); // 'oni'  
+console.log(FACTION_MAPPING[3]); // 'ustur'
+```
+
+### Profile Derivation
+
+```typescript
+import { 
+  deriveProfileFaction,
+  deriveSagePlayerProfile,
+  deriveStarbase,
+  deriveStarbasePlayer,
+  deriveGameAccounts
+} from '@wuwei-labs/srsly';
+
+// Derive individual accounts with network configuration
+const profileFaction = await deriveProfileFaction(profile, { network: 'mainnet' });
+const starbase = await deriveStarbase('mud', gameId, { network: 'mainnet' });
+
+// Derive all game accounts at once
+const gameAccounts = await deriveGameAccounts(
+  profile, 
+  'mud', 
+  gameId, 
+  0, // starbaseSeqId
+  { network: 'mainnet' }
+);
+```
+
 ## Documentation
 
 - **TypeDoc Documentation**: [API Reference](https://wuwei-labs.github.io/srsly/)
@@ -295,4 +441,4 @@ import type { Srsly as SrslyDevnet } from '@wuwei-labs/srsly/types/devnet';
 
 - **Star Atlas**: The metaverse gaming ecosystem
 - **Solana**: The blockchain platform powering SRSLY
-- **Anchor**: The framework used to build the SRSLY program
+- **Anchor**: The framework used to build the SRSLY program

package/dist/cjs/codama/devnet/constants.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Network-specific constants for devnet
+ *
+ * This file is auto-generated from network-configs.mjs
+ * DO NOT EDIT MANUALLY - your changes will be overwritten
+ *
+ * To update these constants:
+ * 1. Edit network-configs.mjs
+ * 2. Run `pnpm build` to regenerate
+ *
+ * Generated on: 2025-06-21T19:10:08.579Z
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_CONFIG = exports.ATLAS_TOKEN_MINT = exports.SRSLY_PROGRAM_ADDRESS = exports.SAGE_GAME_ID = exports.PROFILE_FACTION_PROGRAM_ADDRESS = exports.SAGE_PROGRAM_ADDRESS = void 0;
+exports.SAGE_PROGRAM_ADDRESS = 'sAgeDEVzwJpDb1aHvzNr3o24cKjsETmFEKghBEyJ1askDi';
+exports.PROFILE_FACTION_PROGRAM_ADDRESS = 'pFACDEVobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq';
+exports.SAGE_GAME_ID = 'GAMEDEVJehF8yAnKiTARUuhZMvLvkZVAsCVri5vSfemLr';
+exports.SRSLY_PROGRAM_ADDRESS = 'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT';
+exports.ATLAS_TOKEN_MINT = 'ATLA5nAaVRfH6BNwD4SAyWp96EdQaAh6bBmGeTx956sx';
+/**
+ * Complete network configuration object
+ * Useful for runtime access to all constants
+ */
+exports.NETWORK_CONFIG = {
+    SAGE_PROGRAM_ADDRESS: 'sAgeDEVzwJpDb1aHvzNr3o24cKjsETmFEKghBEyJ1askDi',
+    PROFILE_FACTION_PROGRAM_ADDRESS: 'pFACDEVobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq',
+    SAGE_GAME_ID: 'GAMEDEVJehF8yAnKiTARUuhZMvLvkZVAsCVri5vSfemLr',
+    SRSLY_PROGRAM_ADDRESS: 'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT',
+    ATLAS_TOKEN_MINT: 'ATLA5nAaVRfH6BNwD4SAyWp96EdQaAh6bBmGeTx956sx',
+};
+//# sourceMappingURL=constants.js.map

package/dist/cjs/codama/devnet/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/codama/devnet/constants.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEU,QAAA,oBAAoB,GAAG,gDAAgD,CAAC;AACxE,QAAA,+BAA+B,GAAG,6CAA6C,CAAC;AAChF,QAAA,YAAY,GAAG,+CAA+C,CAAC;AAC/D,QAAA,qBAAqB,GAAG,6CAA6C,CAAC;AACtE,QAAA,gBAAgB,GAAG,8CAA8C,CAAC;AAE/E;;;GAGG;AACU,QAAA,cAAc,GAAG;IAC5B,oBAAoB,EAAE,gDAAgD;IACtE,+BAA+B,EAAE,6CAA6C;IAC9E,YAAY,EAAE,+CAA+C;IAC7D,qBAAqB,EAAE,6CAA6C;IACpE,gBAAgB,EAAE,8CAA8C;CACxD,CAAC"}

package/dist/cjs/codama/mainnet/constants.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Network-specific constants for mainnet
+ *
+ * This file is auto-generated from network-configs.mjs
+ * DO NOT EDIT MANUALLY - your changes will be overwritten
+ *
+ * To update these constants:
+ * 1. Edit network-configs.mjs
+ * 2. Run `pnpm build` to regenerate
+ *
+ * Generated on: 2025-06-21T19:10:03.037Z
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_CONFIG = exports.ATLAS_TOKEN_MINT = exports.SRSLY_PROGRAM_ADDRESS = exports.SAGE_GAME_ID = exports.PROFILE_FACTION_PROGRAM_ADDRESS = exports.SAGE_PROGRAM_ADDRESS = void 0;
+exports.SAGE_PROGRAM_ADDRESS = 'sAgezwJpDb1aHvzNr3o24cKjsETmFEKghBEyJ1askDi';
+exports.PROFILE_FACTION_PROGRAM_ADDRESS = 'pFACSRuobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq';
+exports.SAGE_GAME_ID = 'GAMEzqJehF8yAnKiTARUuhZMvLvkZVAsCVri5vSfemLr';
+exports.SRSLY_PROGRAM_ADDRESS = 'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT';
+exports.ATLAS_TOKEN_MINT = 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx';
+/**
+ * Complete network configuration object
+ * Useful for runtime access to all constants
+ */
+exports.NETWORK_CONFIG = {
+    SAGE_PROGRAM_ADDRESS: 'sAgezwJpDb1aHvzNr3o24cKjsETmFEKghBEyJ1askDi',
+    PROFILE_FACTION_PROGRAM_ADDRESS: 'pFACSRuobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq',
+    SAGE_GAME_ID: 'GAMEzqJehF8yAnKiTARUuhZMvLvkZVAsCVri5vSfemLr',
+    SRSLY_PROGRAM_ADDRESS: 'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT',
+    ATLAS_TOKEN_MINT: 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx',
+};
+//# sourceMappingURL=constants.js.map

package/dist/cjs/codama/mainnet/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/codama/mainnet/constants.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEU,QAAA,oBAAoB,GAAG,6CAA6C,CAAC;AACrE,QAAA,+BAA+B,GAAG,6CAA6C,CAAC;AAChF,QAAA,YAAY,GAAG,8CAA8C,CAAC;AAC9D,QAAA,qBAAqB,GAAG,6CAA6C,CAAC;AACtE,QAAA,gBAAgB,GAAG,8CAA8C,CAAC;AAE/E;;;GAGG;AACU,QAAA,cAAc,GAAG;IAC5B,oBAAoB,EAAE,6CAA6C;IACnE,+BAA+B,EAAE,6CAA6C;IAC9E,YAAY,EAAE,8CAA8C;IAC5D,qBAAqB,EAAE,6CAA6C;IACpE,gBAAgB,EAAE,8CAA8C;CACxD,CAAC"}

package/dist/cjs/contract/close.js

@@ -2,7 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.closeContract = closeContract;
 exports.getCloseContractInstructionAsync = getCloseContractInstructionAsync;
-const network_1 = require("../network");
+const config_1 = require("../utils/config");
+const constants_1 = require("../utils/constants");
 const utils_1 = require("../utils");
 /**
  * Asynchronously creates an instruction to close a rental contract with minimal required parameters.
@@ -10,34 +11,50 @@ const utils_1 = require("../utils");
  *
  * @example
  * ```typescript
- * // Create the instruction with automatic account derivation
+ * // Create the instruction with default devnet settings
  * const ix = await closeContract({
  *   owner: wallet,
  *   fleet: fleetAddress,
  *   contract: contractAddress,
- *   faction: 'mud', // Only needed if starbase and starbasePlayer not provided
- *   // Optional: provide explicit starbase and starbasePlayer if you have them
- *   // Optional: provide rentalState and rentalTokenAccount if active rental exists
+ *   faction: 'mud',
  * });
  *
- * // Add to transaction and sign
- * const tx = new Transaction().add(ix);
- * await sendAndConfirmTransaction(connection, tx, [wallet]);
+ * // Use mainnet configuration
+ * const ix = await closeContract({
+ *   owner: wallet,
+ *   fleet: fleetAddress,
+ *   contract: contractAddress,
+ *   faction: 'mud',
+ * }).set({ network: 'mainnet' });
+ *
+ * // Override specific constants
+ * const ix = await closeContract({
+ *   owner: wallet,
+ *   fleet: fleetAddress,
+ *   contract: contractAddress,
+ *   faction: 'mud',
+ * }).set({
+ *   network: 'mainnet',
+ *   gameId: 'custom-game-id...'
+ * });
  * ```
  *
  * @param params The simplified parameters for closing a rental contract
  * @returns A promise that resolves to the instruction to close a contract
  */
 /**
- * Internal function to close a contract instruction for a specific network
+ * Internal function to close a contract instruction with configuration options
  */
-async function _closeContract(params, network) {
-    const { owner, fleet, contract, faction, gameId = utils_1.DEFAULT_GAME_ID, } = params;
-    const derivedAccounts = await (0, utils_1.deriveGameAccounts)(owner.address, faction, gameId);
+async function _closeContract(params, config) {
+    const { owner, fleet, contract, faction, gameId, } = params;
+    // Get the actual game ID to use (param override, config override, or network default)
+    const actualGameId = gameId || await (0, constants_1.getSageGameId)(config);
+    const derivedAccounts = await (0, utils_1.deriveGameAccounts)(owner.address, faction, actualGameId, 0, // starbaseSeqId
+    config);
     const starbase = derivedAccounts.starbase;
     const starbasePlayer = derivedAccounts.starbasePlayer;
     // Dynamically import network-specific codama functions
-    const codamaModule = await (0, network_1.getCachedNetworkModule)('instructions', network);
+    const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
     const { getCloseContractInstructionAsync, SRSLY_PROGRAM_ADDRESS } = codamaModule;
     // Let codama derive the rest (rentalAuthority, ownerTokenAccount, etc.)
     const input = {
@@ -46,20 +63,35 @@ async function _closeContract(params, network) {
         contract,
         starbase,
         starbasePlayer,
-        gameId,
+        gameId: actualGameId,
     };
     return getCloseContractInstructionAsync(input, { programAddress: SRSLY_PROGRAM_ADDRESS });
 }
 /**
- * Creates an instruction to close a rental contract with fluent network selection.
+ * Creates an instruction to close a rental contract with fluent configuration.
+ *
+ * @param params The contract closing parameters
+ * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ *
+ * @example
+ * ```typescript
+ * // Use devnet defaults
+ * await closeContract(params);
+ *
+ * // Use mainnet
+ * await closeContract(params).set({ network: 'mainnet' });
+ *
+ * // Override game ID
+ * await closeContract(params).set({ gameId: 'custom...' });
+ * ```
  */
 function closeContract(params) {
-    return (0, network_1.createNetworkSelector)((network) => _closeContract(params, network));
+    return (0, config_1.createConfigSelector)((config) => _closeContract(params, config));
 }
-// Export network selector for getCloseContractInstructionAsync
+// Export config selector for getCloseContractInstructionAsync
 function getCloseContractInstructionAsync(input, options) {
-    return (0, network_1.createNetworkSelector)(async (network) => {
-        const codamaModule = await (0, network_1.getCachedNetworkModule)('instructions', network);
+    return (0, config_1.createConfigSelector)(async (config) => {
+        const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
         return codamaModule.getCloseContractInstructionAsync(input, options);
     });
 }

package/dist/cjs/contract/close.js.map

@@ -1 +1 @@
-{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/contract/close.ts"],"names":[],"mappings":";;AAsHA,sCAIC;AAGD,4EAKC;AA7HD,wCAA+G;AAK/G,oCAGkB;AAkClB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,MAA2B,EAC3B,OAAiB;IAEjB,MAAM,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,GAAG,uBAAkC,GAC5C,GAAG,MAAM,CAAC;IAEX,MAAM,eAAe,GAAG,MAAM,IAAA,0BAAkB,EAC9C,KAAK,CAAC,OAAO,EACb,OAAQ,EACR,MAAM,CACP,CAAC;IAEF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;IAC1C,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CAAC;IAEtD,uDAAuD;IACvD,MAAM,YAAY,GAAG,MAAM,IAAA,gCAAsB,EAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC3E,MAAM,EAAE,gCAAgC,EAAE,qBAAqB,EAAE,GAAG,YAAY,CAAC;IAEjF,wEAAwE;IACxE,MAAM,KAAK,GAAG;QACZ,KAAK;QACL,KAAK;QACL,QAAQ;QACR,QAAQ;QACR,cAAc;QACd,MAAM;KACP,CAAC;IAEF,OAAO,gCAAgC,CACrC,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,MAA2B;IAE3B,OAAO,IAAA,+BAAqB,EAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,+DAA+D;AAC/D,SAAgB,gCAAgC,CAAC,KAAU,EAAE,OAAa;IACxE,OAAO,IAAA,+BAAqB,EAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC7C,MAAM,YAAY,GAAG,MAAM,IAAA,gCAAsB,EAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC3E,OAAO,YAAY,CAAC,gCAAgC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/contract/close.ts"],"names":[],"mappings":";;AAuJA,sCAIC;AAGD,4EAKC;AA9JD,4CAAwH;AACxH,kDAAmD;AAKnD,oCAEkB;AAkClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,MAA2B,EAC3B,MAAsB;IAEtB,MAAM,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,GACP,GAAG,MAAM,CAAC;IAEX,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAM,IAAI,MAAM,IAAA,yBAAa,EAAC,MAAM,CAAC,CAAC;IAE3D,MAAM,eAAe,GAAG,MAAM,IAAA,0BAAkB,EAC9C,KAAK,CAAC,OAAO,EACb,OAAQ,EACR,YAA+B,EAC/B,CAAC,EAAE,gBAAgB;IACnB,MAAM,CACP,CAAC;IAEF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;IAC1C,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CAAC;IAEtD,uDAAuD;IACvD,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnF,MAAM,EAAE,gCAAgC,EAAE,qBAAqB,EAAE,GAAG,YAAY,CAAC;IAEjF,wEAAwE;IACxE,MAAM,KAAK,GAAG;QACZ,KAAK;QACL,KAAK;QACL,QAAQ;QACR,QAAQ;QACR,cAAc;QACd,MAAM,EAAE,YAAY;KACrB,CAAC;IAEF,OAAO,gCAAgC,CACrC,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,aAAa,CAC3B,MAA2B;IAE3B,OAAO,IAAA,6BAAoB,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,8DAA8D;AAC9D,SAAgB,gCAAgC,CAAC,KAAU,EAAE,OAAa;IACxE,OAAO,IAAA,6BAAoB,EAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACnF,OAAO,YAAY,CAAC,gCAAgC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}