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

package/dist/esm/pda/srsly.js

@@ -0,0 +1,113 @@
+/**
+ * PDA derivation functions for the SRSLY program
+ * @module pda/srsly
+ */
+import { address, getProgramDerivedAddress, getAddressEncoder } from '@solana/kit';
+import { getAddresses } from '../utils/config';
+import { CONFIG_SEED, CONTRACT_SEED, RENTAL_SEED, RENTAL_AUTHORITY_SEED, BORROWER_STATE_SEED, } from './constants';
+/**
+ * Address encoder for PDA seeds
+ */
+const addressEncoder = getAddressEncoder();
+/**
+ * Text encoder for string seeds
+ */
+const textEncoder = new TextEncoder();
+/**
+ * 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 async function deriveContract(fleet, programAddress) {
+    const fleetAddress = address(typeof fleet === 'string' ? fleet : fleet);
+    const program = programAddress
+        ? address(typeof programAddress === 'string' ? programAddress : programAddress)
+        : address(getAddresses().srsly);
+    // Encode seeds to bytes
+    const contractSeedBytes = textEncoder.encode(CONTRACT_SEED);
+    const fleetBytes = addressEncoder.encode(fleetAddress);
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: program,
+        seeds: [contractSeedBytes, fleetBytes],
+    });
+    return pda;
+}
+/**
+ * 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 async function deriveRental(contract, borrower, programAddress) {
+    const contractAddress = address(typeof contract === 'string' ? contract : contract);
+    const borrowerAddress = address(typeof borrower === 'string' ? borrower : borrower);
+    const program = programAddress
+        ? address(typeof programAddress === 'string' ? programAddress : programAddress)
+        : address(getAddresses().srsly);
+    // Encode seeds to bytes
+    const rentalSeedBytes = textEncoder.encode(RENTAL_SEED);
+    const contractBytes = addressEncoder.encode(contractAddress);
+    const borrowerBytes = addressEncoder.encode(borrowerAddress);
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: program,
+        seeds: [rentalSeedBytes, contractBytes, borrowerBytes],
+    });
+    return pda;
+}
+/**
+ * Derive the rental authority PDA
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived rental authority PDA
+ */
+export async function deriveRentalAuthority(programAddress) {
+    const program = programAddress
+        ? address(typeof programAddress === 'string' ? programAddress : programAddress)
+        : address(getAddresses().srsly);
+    // Encode seeds to bytes
+    const rentalAuthoritySeedBytes = textEncoder.encode(RENTAL_AUTHORITY_SEED);
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: program,
+        seeds: [rentalAuthoritySeedBytes],
+    });
+    return pda;
+}
+/**
+ * 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 async function deriveBorrowerState(borrower, programAddress) {
+    const borrowerAddress = address(typeof borrower === 'string' ? borrower : borrower);
+    const program = programAddress
+        ? address(typeof programAddress === 'string' ? programAddress : programAddress)
+        : address(getAddresses().srsly);
+    // Encode seeds to bytes
+    const borrowerStateSeedBytes = textEncoder.encode(BORROWER_STATE_SEED);
+    const borrowerBytes = addressEncoder.encode(borrowerAddress);
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: program,
+        seeds: [borrowerStateSeedBytes, borrowerBytes],
+    });
+    return pda;
+}
+/**
+ * Derive the config PDA
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived config PDA
+ */
+export async function deriveConfig(programAddress) {
+    const program = programAddress
+        ? address(typeof programAddress === 'string' ? programAddress : programAddress)
+        : address(getAddresses().srsly);
+    // Encode seeds to bytes
+    const configSeedBytes = textEncoder.encode(CONFIG_SEED);
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: program,
+        seeds: [configSeedBytes],
+    });
+    return pda;
+}
+//# sourceMappingURL=srsly.js.map

package/dist/esm/pda/srsly.js.map

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

package/dist/esm/pda/thread.js

@@ -0,0 +1,61 @@
+/**
+ * PDA derivation functions for the Antegen (Thread) program
+ * @module pda/thread
+ */
+import { address, getProgramDerivedAddress, getAddressEncoder } from '@solana/kit';
+import { THREAD_SEED } from './constants';
+/**
+ * Default Antegen program address (same across all networks)
+ */
+const DEFAULT_ANTEGEN_PROGRAM = 'AgV3xRAdyTe1wW4gTW2oAnzHiAGofsxC7jBVGGkzUQbY';
+/**
+ * Address encoder for PDA seeds
+ */
+const addressEncoder = getAddressEncoder();
+/**
+ * Text encoder for string seeds
+ */
+const textEncoder = new TextEncoder();
+/**
+ * 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 async function deriveRentalThread(rental, authority, programAddress) {
+    const rentalAddress = address(typeof rental === 'string' ? rental : rental);
+    const authorityAddr = address(typeof authority === 'string' ? authority : authority);
+    const program = programAddress
+        ? address(typeof programAddress === 'string' ? programAddress : programAddress)
+        : address(DEFAULT_ANTEGEN_PROGRAM);
+    // Encode seeds to bytes
+    // Antegen ALWAYS uses: [SEED_THREAD, authority, id]
+    const threadSeedBytes = textEncoder.encode(THREAD_SEED);
+    const authorityBytes = addressEncoder.encode(authorityAddr);
+    const rentalBytes = addressEncoder.encode(rentalAddress);
+    const seeds = [threadSeedBytes, authorityBytes, rentalBytes];
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: program,
+        seeds,
+    });
+    return pda;
+}
+//# sourceMappingURL=thread.js.map

package/dist/esm/pda/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/pda/thread.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAW,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,uBAAuB,GAAG,8CAA8C,CAAC;AAE/E;;GAEG;AACH,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAwB,EACxB,SAA2B,EAC3B,cAAiC;IAEjC,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,cAAc;QAC5B,CAAC,CAAC,OAAO,CAAC,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QAC/E,CAAC,CAAC,OAAO,CAAC,uBAAkC,CAAC,CAAC;IAEhD,wBAAwB;IACxB,oDAAoD;IACpD,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAEzD,MAAM,KAAK,GAAG,CAAC,eAAe,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;IAE7D,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,wBAAwB,CAAC;QAC3C,cAAc,EAAE,OAAO;QACvB,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/esm/pda/token.js

@@ -0,0 +1,59 @@
+/**
+ * Token account derivation utilities
+ * @module pda/token
+ */
+import { address, getProgramDerivedAddress, getAddressEncoder } from '@solana/kit';
+/**
+ * SPL Token program address
+ */
+const TOKEN_PROGRAM = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+/**
+ * SPL Associated Token Account program address
+ */
+const ASSOCIATED_TOKEN_PROGRAM = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+/**
+ * Address encoder for PDA seeds
+ */
+const addressEncoder = getAddressEncoder();
+/**
+ * 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 async function deriveAssociatedTokenAccount(owner, mint, tokenProgramAddress, associatedTokenProgramAddress) {
+    const ownerAddress = address(typeof owner === 'string' ? owner : owner);
+    const mintAddress = address(typeof mint === 'string' ? mint : mint);
+    const tokenProgram = tokenProgramAddress
+        ? address(typeof tokenProgramAddress === 'string' ? tokenProgramAddress : tokenProgramAddress)
+        : address(TOKEN_PROGRAM);
+    const ataProgram = associatedTokenProgramAddress
+        ? address(typeof associatedTokenProgramAddress === 'string' ? associatedTokenProgramAddress : associatedTokenProgramAddress)
+        : address(ASSOCIATED_TOKEN_PROGRAM);
+    // Encode all address seeds to bytes for PDA derivation
+    const ownerBytes = addressEncoder.encode(ownerAddress);
+    const tokenProgramBytes = addressEncoder.encode(tokenProgram);
+    const mintBytes = addressEncoder.encode(mintAddress);
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: ataProgram,
+        seeds: [ownerBytes, tokenProgramBytes, mintBytes],
+    });
+    return pda;
+}
+//# sourceMappingURL=token.js.map

package/dist/esm/pda/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../../src/pda/token.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAW,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE5F;;GAEG;AACH,MAAM,aAAa,GAAG,6CAA6C,CAAC;AAEpE;;GAEG;AACH,MAAM,wBAAwB,GAAG,8CAA8C,CAAC;AAEhF;;GAEG;AACH,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,KAAuB,EACvB,IAAsB,EACtB,mBAAsC,EACtC,6BAAgD;IAEhD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,mBAAmB;QACtC,CAAC,CAAC,OAAO,CAAC,OAAO,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QAC9F,CAAC,CAAC,OAAO,CAAC,aAAwB,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,6BAA6B;QAC9C,CAAC,CAAC,OAAO,CAAC,OAAO,6BAA6B,KAAK,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,6BAA6B,CAAC;QAC5H,CAAC,CAAC,OAAO,CAAC,wBAAmC,CAAC,CAAC;IAEjD,uDAAuD;IACvD,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,iBAAiB,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAErD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,wBAAwB,CAAC;QAC3C,cAAc,EAAE,UAAU;QAC1B,KAAK,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,SAAS,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/esm/utils/addresses.js

@@ -0,0 +1,85 @@
+/**
+ * @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.
+ */
+import { SRSLY_PROGRAM_ADDRESS } from '../generated/codama';
+/**
+ * Mainnet addresses (production Star Atlas)
+ */
+const MAINNET_ADDRESSES = {
+    srsly: SRSLY_PROGRAM_ADDRESS,
+    sage: 'SAGE2HAwep459SNq61LHvjxPk4pLPEJLoMETef7f7EE',
+    atlasMint: 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx',
+    profileFaction: 'pFACSRuobDmvfMKq1bAzwj27t6d2GJhSCHb1VcfnRmq',
+    gameId: 'GAMEC7U7cqmFFaRow33j1LwuV8u4YhAS1mJ5Dqjnar2k'
+};
+/**
+ * Atlasnet addresses (Star Atlas testnet/devnet)
+ */
+const ATLASNET_ADDRESSES = {
+    srsly: SRSLY_PROGRAM_ADDRESS,
+    sage: 'SAgEeT8u14TE69JXtanGSgNkEdoPUcLabeyZD2uw8x9',
+    atlasMint: 'En3GRDgFiY8ZoHA86k7LwJkBrB7u1UrjxENpni3CFe1C',
+    profileFaction: 'pFACzkX2eSpAjDyEohD6i3VRJvREtH9ynbtM1DwVFsj',
+    gameId: 'GAmEqxNYaUqLmLkXGhzUvv4Ud8FotnWPLj6ChdBkUh9j'
+};
+/**
+ * Program address mappings
+ */
+const PROGRAM_ADDRESS_SETS = {
+    'mainnet': MAINNET_ADDRESSES,
+    'atlasnet': ATLASNET_ADDRESSES,
+    'holosim': ATLASNET_ADDRESSES,
+    'localnet': ATLASNET_ADDRESSES
+};
+/**
+ * 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 function getProgramAddresses(programSet) {
+    const addresses = PROGRAM_ADDRESS_SETS[programSet];
+    if (!addresses) {
+        throw new Error(`Unknown program set: ${programSet}. Valid sets: mainnet, atlasnet, holosim, localnet`);
+    }
+    return addresses;
+}
+/**
+ * @deprecated Use getProgramAddresses instead
+ */
+export function getNetworkAddresses(network) {
+    return getProgramAddresses(network);
+}
+/**
+ * Check if a program set is valid
+ *
+ * @param programSet - Program set to validate
+ * @returns True if program set is supported
+ */
+export function isValidProgramSet(programSet) {
+    return programSet === 'mainnet' || programSet === 'atlasnet' || programSet === 'localnet';
+}
+/**
+ * @deprecated Use isValidProgramSet instead
+ */
+export function isValidNetwork(network) {
+    return isValidProgramSet(network);
+}
+/**
+ * Re-export individual network addresses for direct access
+ */
+export { MAINNET_ADDRESSES, ATLASNET_ADDRESSES };
+//# sourceMappingURL=addresses.js.map

package/dist/esm/utils/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../../src/utils/addresses.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AA6B5D;;GAEG;AACH,MAAM,iBAAiB,GAAqB;IAC1C,KAAK,EAAE,qBAAqB;IAC5B,IAAI,EAAE,6CAA6C;IACnD,SAAS,EAAE,8CAA8C;IACzD,cAAc,EAAE,6CAA6C;IAC7D,MAAM,EAAE,8CAA8C;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAAqB;IAC3C,KAAK,EAAE,qBAAqB;IAC5B,IAAI,EAAE,6CAA6C;IACnD,SAAS,EAAE,8CAA8C;IACzD,cAAc,EAAE,6CAA6C;IAC7D,MAAM,EAAE,8CAA8C;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAAyC;IACjE,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,kBAAkB;IAC7B,UAAU,EAAE,kBAAkB;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsB;IACxD,MAAM,SAAS,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAEnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,wBAAwB,UAAU,oDAAoD,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmB;IACrD,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,UAAU,CAAC;AAC5F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EACnB,CAAC"}

package/dist/esm/utils/config.js

@@ -1,203 +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.
  */
+import { getProgramAddresses } from './addresses';
 /**
- * Network configuration for the SRSLY SDK
+ * Default RPC URLs for each program set
  */
-// Single codama output - network agnostic
-import * as instructions from '../generated/codama/instructions';
-import * as programs from '../generated/codama/programs';
-import * as accounts from '../generated/codama/accounts';
-import { createSolanaRpc } from '@solana/kit';
-import { toAddress } from './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',
-    },
+const DEFAULT_RPC_URLS = {
+    'atlasnet': 'https://api.devnet.solana.com',
+    'holosim': 'https://api.devnet.solana.com',
+    'mainnet': 'https://api.mainnet-beta.solana.com',
+    'localnet': 'http://localhost:8899'
 };
-// 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
+ * Default SRSLY program ID (same across all program sets)
  */
-export 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: toAddress(srslyAddress),
-        sageProgramAddress: toAddress(sageAddress),
-        profileFactionProgramAddress: toAddress(profileFactionAddress),
-        antegenProgramAddress: toAddress(antegenAddress),
-        atlasMint: toAddress(atlasMintAddress),
-        gameId: toAddress(gameId),
-        rpcUrl: rpcUrl,
-    };
-}
+const DEFAULT_PROGRAM_ID = 'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT';
 /**
- * Set global configuration options that will be used as defaults for all SDK operations
- * @param config SDK configuration options to set globally
+ * Global SDK configuration state
+ */
+let globalConfig = {
+    programs: 'atlasnet'
+};
+/**
+ * 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 function setSdkConfig(config) {
-    globalSdkConfig = { ...config };
+    globalConfig = { ...globalConfig, ...config };
 }
 /**
  * Get the current global SDK configuration
- * @returns Current global SDK configuration options
+ *
+ * @returns A copy of the current global configuration
  */
 export function getSdkConfig() {
-    return { ...globalSdkConfig };
+    return { ...globalConfig };
 }
 /**
- * Clear global SDK configuration (resets to atlasnet program set defaults)
+ * Clear global SDK configuration (resets to defaults)
  */
 export function clearSdkConfig() {
-    globalSdkConfig = {};
+    globalConfig = {
+        programs: 'atlasnet'
+    };
 }
 /**
- * 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 function getEffectiveSdkConfig(overrides) {
-    return { ...globalSdkConfig, ...overrides };
+export function mergeConfig(overrides) {
+    return { ...globalConfig, ...overrides };
 }
 /**
- * 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 function getModule(modulePath) {
-    switch (modulePath) {
-        case 'instructions':
-            return instructions;
-        case 'programs':
-            return programs;
-        case 'accounts':
-            return accounts;
-        case 'kit':
-            return { createSolanaRpc };
-        default:
-            throw new Error(`Unsupported module path: ${modulePath}`);
-    }
+export function getRpcUrl(config) {
+    const finalConfig = mergeConfig(config);
+    return finalConfig.rpcUrl || DEFAULT_RPC_URLS[finalConfig.programs] || DEFAULT_RPC_URLS.atlasnet;
 }
 /**
- * @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 async function getCachedNetworkModule(modulePath) {
-    if (modulePath !== 'instructions' && modulePath !== 'programs') {
-        throw new Error(`Unsupported module path: ${modulePath}. Use 'instructions' or 'programs'.`);
-    }
-    return getModule(modulePath);
+export function getProgramId(config) {
+    return config.programId || DEFAULT_PROGRAM_ID;
 }
 /**
- * Create a chainable SDK config selector with existing configuration state.
- * This enables config chaining by merging new options with existing ones.
+ * Get the effective commitment level for a configuration
  *
- * 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 SdkConfigSelector that can chain additional .set() calls
- *
- * @example
- * // This creates a chainable selector that merges { programs: 'atlasnet' }
- * // with any additional config options passed to subsequent .set() calls
- * createChainableSdkConfigSelector(executeFn, { programs: 'atlasnet' })
+ * @param config - SDK configuration
+ * @returns Commitment level to use
  */
-function createChainableSdkConfigSelector(executeFn, existingConfig) {
-    const selector = {
-        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;
+export function getCommitment(config) {
+    return config.commitment || 'confirmed';
 }
 /**
- * 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 function createSdkConfigSelector(executeFn) {
-    const selector = {
-        set: (options) => createChainableSdkConfigSelector(executeFn, getEffectiveSdkConfig(options)),
-        build: () => executeFn(getEffectiveSdkConfig()),
-        // Implement PromiseLike to allow direct awaiting
-        then(onfulfilled, onrejected) {
-            return executeFn(getEffectiveSdkConfig()).then(onfulfilled, onrejected);
-        },
+export function getAddresses(config) {
+    const finalConfig = mergeConfig(config);
+    const networkAddresses = getProgramAddresses(finalConfig.programs);
+    // Return addresses with programId override if provided
+    return {
+        ...networkAddresses,
+        srsly: finalConfig.programId || networkAddresses.srsly
     };
-    return selector;
 }
 //# sourceMappingURL=config.js.map