@sly-rentals/core 0.1.0

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

@@ -0,0 +1,8 @@
+/**
+ * Slyvault PDA derivation utilities
+ * @module pda/slyvault
+ *
+ * Re-exports from @sly-rentals/vault for convenience
+ */
+export { deriveVault } from '@sly-rentals/vault';
+//# 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;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * PDA derivation functions for the SRSLY program
+ * @module pda/srsly
+ */
+import { Address } from '@solana/kit';
+import { type UniversalSigner } from '../utils/signer';
+/**
+ * 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: UniversalSigner, programAddress?: UniversalSigner): Promise<Address>;
+/**
+ * Derive the active rental PDA from contract address
+ *
+ * Seeds: ["rental_state", contract, "active"]
+ *
+ * @param contract - The contract public key
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived active rental PDA
+ */
+export declare function deriveActiveRental(contract: UniversalSigner, programAddress?: UniversalSigner): Promise<Address>;
+/**
+ * Derive the queued rental PDA from contract address
+ *
+ * Seeds: ["rental_state", contract, "queued"]
+ *
+ * @param contract - The contract public key
+ * @param programAddress - Optional SRSLY program address (defaults to network-specific address)
+ * @returns The derived queued rental PDA
+ */
+export declare function deriveQueuedRental(contract: UniversalSigner, programAddress?: UniversalSigner): 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?: UniversalSigner): 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: UniversalSigner, programAddress?: UniversalSigner): 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?: UniversalSigner): 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;AAE5F,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAqBzE;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EACtB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAclB;AAyBD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,cAAc,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAY9F;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,eAAe,EACzB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,cAAc,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAYrF"}

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';
+import { type UniversalSigner } from '../utils/signer';
+/**
+ * Derive the contract thread PDA
+ *
+ * Per-contract thread used by Antegen for automated payment scheduling.
+ * Thread PDAs use seeds: [SEED_THREAD, authority, id]
+ * where id = contract address.
+ *
+ * @param contract - The contract PDA (used as the thread ID)
+ * @param authority - The rental authority PDA (thread authority)
+ * @param programAddress - Optional Antegen program address (defaults to Antegen program)
+ * @returns The derived contract thread PDA
+ */
+export declare function deriveContractThread(contract: UniversalSigner, authority: UniversalSigner, programAddress?: UniversalSigner): Promise<Address>;
+/**
+ * Derive the fiber PDA for a thread
+ *
+ * Fiber PDAs use seeds: ["thread_fiber", thread, fiber_index (u8)]
+ *
+ * @param thread - The thread PDA
+ * @param fiberIndex - The fiber index (1 for close_rental, 2 for activate_rental)
+ * @param programAddress - Optional Antegen program address
+ * @returns The derived fiber PDA
+ */
+export declare function deriveFiber(thread: UniversalSigner, fiberIndex: number, programAddress?: UniversalSigner): 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;AAC5F,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAkBzE;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,eAAe,EAC1B,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

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

@@ -0,0 +1,30 @@
+/**
+ * Token account derivation utilities
+ * @module pda/token
+ */
+import { Address } from '@solana/kit';
+import { type UniversalSigner } from '../utils/signer';
+/**
+ * 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: UniversalSigner, mint: UniversalSigner, tokenProgramAddress?: UniversalSigner, associatedTokenProgramAddress?: UniversalSigner): 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;AAC5F,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAiBzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,eAAe,EACrB,mBAAmB,CAAC,EAAE,eAAe,EACrC,6BAA6B,CAAC,EAAE,eAAe,GAC9C,OAAO,CAAC,OAAO,CAAC,CAqBlB"}

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

@@ -0,0 +1,97 @@
+/**
+ * @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.
+ */
+/**
+ * Genesis hash constants — canonical chain identifiers
+ */
+export declare const MAINNET_GENESIS = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+export declare const DEVNET_GENESIS = "EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG";
+export declare const ATLASNET_GENESIS = "Ccod9gttTtZWqCeMgyTW3iCSoPLjkptAGsBUeP2CpchR";
+/**
+ * Named aliases for CLI/human convenience
+ */
+export type ProgramSetAlias = 'mainnet' | 'atlasnet' | 'holosim' | 'localnet';
+/**
+ * Program set type — accepts either a genesis hash or a named alias
+ */
+export type ProgramSet = string;
+/**
+ * Addresses for a specific program set
+ */
+export interface ProgramAddresses {
+    /** SRSLY rental program address */
+    srsly: string;
+    /** Star Atlas SAGE program address */
+    sage: string;
+    /** Antegen (thread/automation) program address */
+    antegen: string;
+    /**
+     * ATLAS token mint address
+     * @deprecated Instructions now source atlasMint from on-chain ConfigState.
+     * Only used for createConfig bootstrap and CLI display.
+     */
+    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;
+/**
+ * Resolve a program set input (alias or genesis hash) to a genesis hash
+ *
+ * @param programSet - Named alias or genesis hash string
+ * @returns Genesis hash string
+ */
+export declare function resolveGenesisHash(programSet: string): string;
+/**
+ * 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;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe,iDAAiD,CAAC;AAC9E,eAAO,MAAM,cAAc,iDAAiD,CAAC;AAC7E,eAAO,MAAM,gBAAgB,iDAAiD,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAS9E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,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;AAOhD;;GAEG;AACH,QAAA,MAAM,iBAAiB,EAAE,gBAOxB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,kBAAkB,EAAE,gBAOzB,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;;;;;;;;;;;;;;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,CAM9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,UAAU,CAErE;AAED;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC"}

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

@@ -0,0 +1,89 @@
+/**
+ * @purpose Reservation bid math helpers
+ *
+ * Pure-math + on-chain-fetch helpers for computing the contest minimum-bid
+ * floor that a challenger must clear to take an existing reservation.
+ * Mirrors the on-chain `ConfigState::bid_min_stardust` formula so client UIs
+ * (and on-chain-aware tooling) can preview the floor without hitting an RPC
+ * for every keystroke.
+ */
+import { type Address } from '@solana/kit';
+/**
+ * Pure math: contest minimum-bid floor in stardust.
+ *
+ * Mirror of `ConfigState::bid_min_stardust` on-chain.
+ *
+ *   floor = max(rate, defenderBid) × ramp
+ *   ramp  = max(captureRate, 1 + (maxMult - 1) × closeness)
+ *
+ * `closenessFraction` is in `[0, 1]` — the fraction of the active rental's
+ * remaining window that has elapsed since the defender's reservation. 0 =
+ * defender just placed; 1 = active rental about to end (snipe).
+ *
+ * `contestedMultiplierMaxBps` is on the protocol's custom 100=1× scale:
+ * 100 disables the ramp, 10_000 = 100×.
+ */
+export declare function computeMinimumBid(args: {
+    rateStardust: bigint;
+    defenderBidStardust?: bigint;
+    contestedMultiplierMaxBps: number;
+    captureRateBps: bigint;
+    closenessFraction: number;
+}): bigint;
+export type MinimumBid = {
+    /** Stardust amount a challenger must bid to clear the floor. */
+    minBidStardust: bigint;
+    /** Stardust amount of the existing defender bid (sum of bidAtlas + bidPoints
+     *  converted via `atlasPerPoint`). 0 if no defender. */
+    defenderBidStardust: bigint;
+    /** Contract rate per day in stardust. */
+    rateStardust: bigint;
+    /** Closeness fraction at the moment of evaluation (0..1). */
+    closenessFraction: number;
+    /** Effective ramp multiplier applied (e.g. 4.65 for 4.65×). */
+    rampMultiplier: number;
+    /** Unix-second timestamp the floor was computed for (now + delaySeconds). */
+    evaluatedAtSeconds: number;
+    /** Active rental's end_time in unix seconds, if an active rental exists. */
+    activeEndSeconds: number | null;
+    /** Active rental's start_time in unix seconds, if one exists. */
+    activeStartSeconds: number | null;
+};
+/**
+ * High-level helper: compute the contest minimum bid for a contract right
+ * now (or at `now + delaySeconds`).
+ *
+ * Fetches `ConfigState`, `ContractState`, and the active/queued `RentalState`
+ * accounts, derives `closeness` from the active rental window, and returns
+ * the floor a challenger must clear plus enough context to render a UI.
+ *
+ * @example
+ * ```ts
+ * const floor = await getMinimumBid({ contractAddress: 'Abc...' });
+ * console.log('Bid at least', floor.minBidStardust, 'stardust');
+ *
+ * // Preview the floor 4 hours from now (snipe-window pricing):
+ * const later = await getMinimumBid({
+ *   contractAddress: 'Abc...',
+ *   delaySeconds: 4 * 60 * 60,
+ * });
+ * ```
+ *
+ * If the contract has no active rental yet, closeness = 0 and the floor
+ * collapses to the rate-bump floor (`rate × captureRate`).
+ */
+export declare function getMinimumBid(args: {
+    contractAddress: Address | string;
+    /** Seconds to advance the evaluation past `now`. Negative values are
+     *  clamped to 0 (no back-dating). Default 0. */
+    delaySeconds?: number;
+    /** Override the evaluation moment outright (unix seconds). Takes priority
+     *  over `delaySeconds`. */
+    nowSeconds?: number;
+    /** ATLAS-per-point conversion (whole-ATLAS per whole-point). Defaults to
+     *  the cached `cfg.atlasPerPoint`; override if you want to project a
+     *  different conversion. */
+    atlasPerPoint?: bigint;
+    rpcUrl?: string;
+}): Promise<MinimumBid>;
+//# sourceMappingURL=bidMath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bidMath.d.ts","sourceRoot":"","sources":["../../../src/utils/bidMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAa3C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAYT;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB;4DACwD;IACxD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC;oDACgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+BAC2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;gCAE4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyFtB"}

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

@@ -0,0 +1,213 @@
+/**
+ * @purpose Simple SDK configuration management
+ *
+ * Provides global configuration with per-call overrides.
+ * Supports both @solana/kit (default) and @solana/web3.js modes.
+ */
+import type { Commitment } from '@solana/kit';
+import { type ProgramSet as AddressesProgramSet, type NetworkAddresses } from './addresses';
+import type { TransactionSigner } from '@solana/kit';
+/**
+ * PublicKey constructor type for web3.js compatibility
+ */
+export interface PublicKeyConstructor<TPublicKey = any> {
+    new (address: string): TPublicKey;
+}
+/**
+ * Program address set type
+ * Re-exported from addresses module for convenience
+ */
+export type ProgramSet = AddressesProgramSet;
+/**
+ * Affiliate configuration for automatic discount handling
+ *
+ * When configured, the SDK can automatically create discount authorizations
+ * for rental operations (acceptRental, claimRental) when discountBps is specified.
+ */
+export interface AffiliateConfig {
+    /** Affiliate member PDA address */
+    address: string;
+    /** Signer for discount creation (discount_authority or main authority) */
+    signer: TransactionSigner;
+    /** Slot buffer for expiry (default: 1000 slots, ~6-7 minutes) */
+    expirySlotBuffer?: bigint;
+}
+/**
+ * SDK configuration options
+ */
+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;
+    /**
+     * Affiliate configuration for automatic discount handling
+     *
+     * When configured, the SDK can automatically create discount authorizations
+     * for rental operations when discountBps is specified.
+     *
+     * @example
+     * ```typescript
+     * setSdkConfig({
+     *   programs: 'mainnet',
+     *   affiliate: {
+     *     address: 'AFFILIATE_MEMBER_PDA',
+     *     signer: affiliateWallet,
+     *   }
+     * });
+     *
+     * // Then use discountBps in rental operations
+     * await acceptRental({
+     *   borrower: wallet,
+     *   contract: contractAddress,
+     *   duration: { days: 7 },
+     *   discountBps: 500, // SDK auto-creates discount auth
+     * });
+     * ```
+     */
+    affiliate?: AffiliateConfig;
+}
+/**
+ * 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 atlasnet programs with default devnet RPC
+ * setSdkConfig({ programs: 'atlasnet' });
+ *
+ * // Use mainnet programs with web3.js
+ * import { PublicKey } from '@solana/web3.js';
+ * setSdkConfig({
+ *   programs: 'mainnet',
+ *   PublicKey
+ * });
+ *
+ * // Use mainnet programs with custom RPC (e.g., Helius, QuickNode)
+ * setSdkConfig({
+ *   programs: 'mainnet',
+ *   rpcUrl: 'https://my-custom-mainnet-rpc.com'
+ * });
+ *
+ * // Use atlasnet programs with custom devnet RPC
+ * setSdkConfig({
+ *   programs: 'atlasnet',
+ *   rpcUrl: 'https://my-custom-devnet-rpc.com'
+ * });
+ * ```
+ */
+export declare function setSdkConfig(config: Partial<SdkConfig>): void;
+/**
+ * Get the current global SDK configuration
+ *
+ * @returns A copy of the current global configuration
+ */
+export declare function getSdkConfig(): SdkConfig;
+/**
+ * Clear global SDK configuration (resets to defaults)
+ */
+export declare function clearSdkConfig(): void;
+/**
+ * Merge global config with optional overrides
+ *
+ * @param overrides - Optional configuration overrides
+ * @returns Merged configuration
+ */
+export declare function mergeConfig(overrides?: Partial<SdkConfig>): SdkConfig;
+/**
+ * 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 getRpcUrl(config?: Partial<SdkConfig>): string;
+/**
+ * Get the effective program ID for a configuration
+ *
+ * @param config - SDK configuration
+ * @returns Program ID to use
+ */
+export declare function getProgramId(config: SdkConfig): string;
+/**
+ * Get the effective commitment level for a configuration
+ *
+ * @param config - SDK configuration
+ * @returns Commitment level to use
+ */
+export declare function getCommitment(config: SdkConfig): Commitment;
+/**
+ * Get the affiliate configuration from global config with optional overrides
+ *
+ * @param config - Optional SDK configuration overrides
+ * @returns Affiliate configuration if set, undefined otherwise
+ */
+export declare function getAffiliateConfig(config?: Partial<SdkConfig>): AffiliateConfig | undefined;
+/**
+ * Get program-specific addresses with optional overrides
+ *
+ * Returns addresses for the configured program set. The SRSLY program ID
+ * can be overridden via config.programId.
+ *
+ * @param config - Optional SDK configuration overrides
+ * @returns Program addresses with any config overrides applied
+ *
+ * @example
+ * ```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 getAddresses(config?: Partial<SdkConfig>): NetworkAddresses & {
+    srsly: string;
+};
+/**
+ * Auto-detect the correct program set by querying the chain's genesis hash
+ *
+ * Returns the raw genesis hash string, which can be passed directly to
+ * `setSdkConfig({ programs: genesisHash })` or `getProgramAddresses(genesisHash)`.
+ *
+ * @param rpcUrl - RPC endpoint URL to query
+ * @returns Genesis hash string identifying the chain
+ *
+ * @example
+ * ```typescript
+ * const genesisHash = await detectProgramSet('https://api.mainnet-beta.solana.com');
+ * setSdkConfig({ programs: genesisHash });
+ * ```
+ */
+export declare function detectProgramSet(rpcUrl: string): Promise<string>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAML,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;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;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;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;IAEjC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAQ7D;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,CAS7D;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;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,eAAe,GAAG,SAAS,CAG3F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAS9F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAItE"}

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

@@ -0,0 +1,57 @@
+/**
+ * @purpose Discount authorization helper for server-side signing
+ * @module utils/discountAuth
+ *
+ * Convenience wrapper that fetches member nonce + vault automatically,
+ * then delegates to slyvault's createDiscountAuth for signing.
+ */
+import { type Address } from '@solana/kit';
+import { type MessageSigner, type SerializedDiscountAuth } from '@sly-rentals/vault';
+import { type SdkConfig } from './config';
+export interface CreateDiscountParams {
+    /** Affiliate member state PDA address */
+    memberAddress: Address | string;
+    /** Borrower wallet address (discount is bound to this address) */
+    contextKey: Address | string;
+    /** Discount basis points (10000 = 100%) */
+    discountBps: number;
+    /** Seconds from now until discount expires */
+    expirySeconds: number;
+    /**
+     * The discount authority signer
+     *
+     * Accepts:
+     * - A KeyPairSigner from @solana/kit
+     * - A Uint8Array or number[] of 64 bytes (secret key)
+     * - A JSON stringified keypair: "[1,2,3,...64 bytes]"
+     */
+    discountAuthority: MessageSigner | Uint8Array | number[] | string;
+}
+/**
+ * Sign and serialize a discount authorization. Server-side helper that
+ * lets a designated authority pre-grant a fee discount, which the holder
+ * can later attach to a vault deposit to redeem.
+ *
+ * @param params - Discount parameters
+ * @param config - Optional SDK configuration overrides
+ * @returns SerializedDiscountAuth ready for JSON API response
+ *
+ * @example
+ * ```typescript
+ * // Server-side: create discount for a borrower
+ * const auth = await createDiscount({
+ *   memberAddress: 'AFFILIATE_MEMBER_PDA',
+ *   contextKey: borrowerWallet,
+ *   discountBps: 500, // 5%
+ *   expirySeconds: 300, // 5 minutes
+ *   discountAuthority: process.env.DISCOUNT_KEY, // JSON keypair string
+ * });
+ *
+ * // Return via API — all fields are JSON-safe strings/numbers
+ * res.json(auth);
+ * ```
+ */
+export declare function createDiscount(params: CreateDiscountParams, config?: Partial<SdkConfig>): Promise<SerializedDiscountAuth>;
+export { deserializeDiscountAuth } from '@sly-rentals/vault';
+export type { SerializedDiscountAuth, MessageSigner } from '@sly-rentals/vault';
+//# sourceMappingURL=discountAuth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discountAuth.d.ts","sourceRoot":"","sources":["../../../src/utils/discountAuth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAW,KAAK,OAAO,EAAgC,MAAM,aAAa,CAAC;AAClF,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,kEAAkE;IAClE,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,iBAAiB,EAAE,aAAa,GAAG,UAAU,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;CACnE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAuBjC;AAsBD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * @purpose Utility functions and helpers
+ * @module utils
+ */
+export { setSdkConfig, getSdkConfig, clearSdkConfig, mergeConfig, getAddresses, getAffiliateConfig, getRpcUrl, detectProgramSet, type SdkConfig, type PublicKeyConstructor, type AffiliateConfig, } from './config';
+export { getProgramAddresses, getNetworkAddresses, isValidProgramSet, isValidNetwork, resolveGenesisHash, MAINNET_GENESIS, DEVNET_GENESIS, ATLASNET_GENESIS, MAINNET_ADDRESSES, ATLASNET_ADDRESSES, type ProgramSet, type ProgramSetAlias, 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';
+export { InstructionResult, type LegacyInstruction } from './instructionResult';
+export { createRpc, setRpcDebug, isRpcDebugEnabled } from './rpc';
+export { fetchLookupTable, getLookupTableAddress, type AddressLookupTableData, } from './lookupTable';
+export { hasActiveRental, hasQueuedRental } from './rental';
+export { computeMinimumBid, getMinimumBid, type MinimumBid } from './bidMath';
+export { createDiscount, deserializeDiscountAuth, type CreateDiscountParams, type SerializedDiscountAuth, type MessageSigner, } from './discountAuth';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,GACrC,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGlE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAG9E,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC"}