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

package/dist/cjs/index.js

@@ -1,4 +1,56 @@
 "use strict";
+/**
+ * @purpose SRSLY SDK - Solana Rental System Library main entry point
+ * @reviewed 2025-07-29
+ *
+ * A comprehensive TypeScript SDK for interacting with the SRSLY Solana program,
+ * which facilitates fleet rentals in the Star Atlas ecosystem. This SDK provides
+ * a fluent, developer-friendly interface that works with both @solana/kit and
+ * @solana/web3.js libraries.
+ *
+ * ## Features
+ *
+ * - **Universal Compatibility**: Works with both @solana/kit and @solana/web3.js
+ * - **Fluent API**: Chainable methods for intuitive development experience
+ * - **String-Based Addresses**: Uses strings for all addresses to eliminate library conflicts
+ * - **Network Agnostic**: Supports mainnet, devnet, and custom RPC endpoints
+ * - **Type Safety**: Full TypeScript support with comprehensive type definitions
+ * - **Auto-Generated Types**: Types generated from Solana program IDL for accuracy
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { createContract, acceptRental } from '@srsly/sdk';
+ *
+ * // Create a rental contract
+ * const instruction = await createContract({
+ *   owner: wallet,
+ *   fleet: "FleetAddress123...",
+ *   ownerProfile: "ProfileAddr...",
+ *   rate: 1000,
+ *   durationMax: 7,  // 7 payment periods (7 days for @daily)
+ *   paymentsFreq: 'daily'
+ * });
+ *
+ * // Accept a rental
+ * const rentalInstruction = await acceptRental({
+ *   borrower: borrowerWallet,
+ *   contract: contractAddress,
+ *   amount: 7000,
+ *   duration: { days: 7 }  // Smart parameter format
+ * });
+ * ```
+ *
+ * ## Architecture
+ *
+ * The SDK is organized into several main modules:
+ * - **Contract**: Functions for creating and managing rental contracts
+ * - **Rental**: Functions for rental operations (accept, cancel, close)
+ * - **Utils**: Helper functions for duration, payment frequency, and account management
+ * - **Types**: TypeScript type definitions and interfaces
+ *
+ * @packageDocumentation
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,12 +66,200 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaymentFrequency = void 0;
+exports.IDL = exports.createSchedule = exports.ScheduleBuilder = exports.validateFrequencyForDuration = exports.validateRentalSchedule = exports.formatPaymentSchedulePreview = exports.calculatePaymentSchedule = exports.parseScheduleString = exports.paymentFrequencyToCron = exports.validateCronExpression = exports.getNextCronOccurrence = exports.normalizePaymentSchedule = exports.validateDurationAlignment = exports.paymentFrequencyStringToSeconds = exports.paymentFrequencyToSeconds = exports.isValidPaymentFrequency = exports.getPaymentFrequencyFromString = exports.CRON_TO_PAYMENT_FREQUENCY = exports.PAYMENT_FREQUENCY_TO_CRON = exports.PAYMENT_FREQUENCY_CONSTANTS = exports.PAYMENT_FREQUENCY_MAP = exports.VALID_PAYMENT_FREQUENCIES = exports.PaymentFrequency = exports.fetchMultipleRentalStates = exports.fetchMultipleContractStates = exports.fetchFleetState = exports.fetchConfigState = exports.fetchRentalState = exports.fetchContractState = exports.resolveProgramAddresses = exports.clearConfig = exports.getConfig = exports.setConfig = void 0;
 // Export main SDK functions
 __exportStar(require("./contract"), exports);
 __exportStar(require("./rental"), exports);
+// Export config instruction functions
+__exportStar(require("./config"), exports);
+// Export config functions with public-facing names from utils
+var config_1 = require("./utils/config");
+Object.defineProperty(exports, "setConfig", { enumerable: true, get: function () { return config_1.setSdkConfig; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_1.getSdkConfig; } });
+Object.defineProperty(exports, "clearConfig", { enumerable: true, get: function () { return config_1.clearSdkConfig; } });
+Object.defineProperty(exports, "resolveProgramAddresses", { enumerable: true, get: function () { return config_1.resolveProgramAddresses; } });
 __exportStar(require("./utils"), exports);
-// Export PaymentFrequency from utils since it's not in codama
-var constants_1 = require("./utils/constants");
-Object.defineProperty(exports, "PaymentFrequency", { enumerable: true, get: function () { return constants_1.PaymentFrequency; } });
+/**
+ * Account fetch functions that work with any RPC endpoint.
+ *
+ * These functions accept RPC URL strings and return account data,
+ * making it easy to fetch program state from any network.
+ *
+ * @example
+ * ```typescript
+ * const contract = await fetchContractState(
+ *   "https://api.mainnet-beta.solana.com",
+ *   contractAddress
+ * );
+ *
+ * // Fetch SAGE fleet data using manual struct parsing
+ * const fleet = await fetchFleetState(fleetAddress);
+ * ```
+ */
+var fetch_accounts_1 = require("./utils/fetch-accounts");
+Object.defineProperty(exports, "fetchContractState", { enumerable: true, get: function () { return fetch_accounts_1.fetchContractState; } });
+Object.defineProperty(exports, "fetchRentalState", { enumerable: true, get: function () { return fetch_accounts_1.fetchRentalState; } });
+Object.defineProperty(exports, "fetchConfigState", { enumerable: true, get: function () { return fetch_accounts_1.fetchConfigState; } });
+Object.defineProperty(exports, "fetchFleetState", { enumerable: true, get: function () { return fetch_accounts_1.fetchFleetState; } });
+Object.defineProperty(exports, "fetchMultipleContractStates", { enumerable: true, get: function () { return fetch_accounts_1.fetchMultipleContractStates; } });
+Object.defineProperty(exports, "fetchMultipleRentalStates", { enumerable: true, get: function () { return fetch_accounts_1.fetchMultipleRentalStates; } });
+/**
+ * Payment frequency enum generated from the Rust program.
+ *
+ * This enum mirrors the Rust PaymentFrequency type and provides
+ * type-safe payment frequency values for contract creation.
+ */
+var payment_frequency_1 = require("./types/payment-frequency");
+Object.defineProperty(exports, "PaymentFrequency", { enumerable: true, get: function () { return payment_frequency_1.PaymentFrequency; } });
+/**
+ * Payment frequency types and validation utilities.
+ *
+ * These exports provide string-based payment frequency handling,
+ * validation functions, and mapping between different representations.
+ *
+ * @example
+ * ```typescript
+ * if (isValidPaymentFrequency('daily')) {
+ *   const frequency = getPaymentFrequencyFromString('daily');
+ * }
+ * ```
+ */
+var payment_frequency_2 = require("./types/payment-frequency");
+Object.defineProperty(exports, "VALID_PAYMENT_FREQUENCIES", { enumerable: true, get: function () { return payment_frequency_2.VALID_PAYMENT_FREQUENCIES; } });
+Object.defineProperty(exports, "PAYMENT_FREQUENCY_MAP", { enumerable: true, get: function () { return payment_frequency_2.PAYMENT_FREQUENCY_MAP; } });
+Object.defineProperty(exports, "PAYMENT_FREQUENCY_CONSTANTS", { enumerable: true, get: function () { return payment_frequency_2.PAYMENT_FREQUENCY_CONSTANTS; } });
+Object.defineProperty(exports, "PAYMENT_FREQUENCY_TO_CRON", { enumerable: true, get: function () { return payment_frequency_2.PAYMENT_FREQUENCY_TO_CRON; } });
+Object.defineProperty(exports, "CRON_TO_PAYMENT_FREQUENCY", { enumerable: true, get: function () { return payment_frequency_2.CRON_TO_PAYMENT_FREQUENCY; } });
+Object.defineProperty(exports, "getPaymentFrequencyFromString", { enumerable: true, get: function () { return payment_frequency_2.getPaymentFrequencyFromString; } });
+Object.defineProperty(exports, "isValidPaymentFrequency", { enumerable: true, get: function () { return payment_frequency_2.isValidPaymentFrequency; } });
+/**
+ * Payment frequency utilities that mirror the Rust program implementation.
+ *
+ * These functions provide conversion between payment frequencies and time durations,
+ * ensuring consistency with the on-chain program logic.
+ *
+ * @example
+ * ```typescript
+ * const seconds = paymentFrequencyStringToSeconds('weekly');
+ * validateDurationAlignment(duration, 'daily');
+ * ```
+ */
+var payment_frequency_3 = require("./utils/payment-frequency");
+Object.defineProperty(exports, "paymentFrequencyToSeconds", { enumerable: true, get: function () { return payment_frequency_3.paymentFrequencyToSeconds; } });
+Object.defineProperty(exports, "paymentFrequencyStringToSeconds", { enumerable: true, get: function () { return payment_frequency_3.paymentFrequencyStringToSeconds; } });
+Object.defineProperty(exports, "validateDurationAlignment", { enumerable: true, get: function () { return payment_frequency_3.validateDurationAlignment; } });
+Object.defineProperty(exports, "normalizePaymentSchedule", { enumerable: true, get: function () { return payment_frequency_3.normalizePaymentSchedule; } });
+/**
+ * Cron expression utilities for advanced payment scheduling.
+ *
+ * These functions provide cron expression parsing, validation, and scheduling
+ * capabilities using the croner library, mirroring the Rust implementation.
+ *
+ * @example
+ * ```typescript
+ * // Validate a cron expression
+ * if (validateCronExpression("0 9 * * MON-FRI")) {
+ *   // Calculate next payment time
+ *   const nextPayment = getNextCronOccurrence("@daily", Date.now() / 1000);
+ * }
+ *
+ * // Preview payment schedule
+ * const schedule = calculatePaymentSchedule("@hourly", startTime, duration);
+ * console.log(`${schedule.totalPayments} payments will occur`);
+ * ```
+ */
+var cron_1 = require("./utils/cron");
+Object.defineProperty(exports, "getNextCronOccurrence", { enumerable: true, get: function () { return cron_1.getNextCronOccurrence; } });
+Object.defineProperty(exports, "validateCronExpression", { enumerable: true, get: function () { return cron_1.validateCronExpression; } });
+Object.defineProperty(exports, "paymentFrequencyToCron", { enumerable: true, get: function () { return cron_1.paymentFrequencyToCron; } });
+Object.defineProperty(exports, "parseScheduleString", { enumerable: true, get: function () { return cron_1.parseScheduleString; } });
+Object.defineProperty(exports, "calculatePaymentSchedule", { enumerable: true, get: function () { return cron_1.calculatePaymentSchedule; } });
+Object.defineProperty(exports, "formatPaymentSchedulePreview", { enumerable: true, get: function () { return cron_1.formatPaymentSchedulePreview; } });
+/**
+ * Schedule validation utilities for rental contracts.
+ *
+ * These functions validate payment schedules against contract constraints
+ * and provide detailed feedback on potential issues.
+ *
+ * @example
+ * ```typescript
+ * const validation = validateRentalSchedule(
+ *   "@daily",
+ *   { days: 7 },   // Smart parameter format
+ *   { days: 1 },   // Smart parameter format
+ *   { days: 30 }   // Smart parameter format
+ * );
+ *
+ * if (validation.valid) {
+ *   console.log(`${validation.paymentCount} payments scheduled`);
+ * }
+ * ```
+ */
+var schedule_validation_1 = require("./utils/schedule-validation");
+Object.defineProperty(exports, "validateRentalSchedule", { enumerable: true, get: function () { return schedule_validation_1.validateRentalSchedule; } });
+Object.defineProperty(exports, "validateFrequencyForDuration", { enumerable: true, get: function () { return schedule_validation_1.validateFrequencyForDuration; } });
+/**
+ * Schedule builder for creating and previewing payment schedules.
+ *
+ * Provides a fluent API for building payment schedules with validation
+ * and preview capabilities.
+ *
+ * @example
+ * ```typescript
+ * // From standard frequency
+ * const schedule = ScheduleBuilder
+ *   .fromFrequency("daily")
+ *   .preview(Date.now() / 1000, { days: 7 });
+ *
+ * // Custom cron expression
+ * const custom = ScheduleBuilder
+ *   .fromCron("0 12 * * MON")
+ *   .validate({ days: 30 }, { days: 1 }, { days: 90 });
+ *
+ * // Common intervals
+ * const every3Hours = ScheduleBuilder
+ *   .every('hours', 3)
+ *   .preview(Date.now() / 1000, { days: 1 });
+ * ```
+ */
+var schedule_builder_1 = require("./utils/schedule-builder");
+Object.defineProperty(exports, "ScheduleBuilder", { enumerable: true, get: function () { return schedule_builder_1.ScheduleBuilder; } });
+Object.defineProperty(exports, "createSchedule", { enumerable: true, get: function () { return schedule_builder_1.createSchedule; } });
+/**
+ * Duration helper functions (DEPRECATED)
+ *
+ * Duration helper functions have been deprecated in favor of smart parameters.
+ * Use the smart parameter format instead for better type safety and clarity.
+ *
+ * @example
+ * ```typescript
+ * // Old approach (deprecated):
+ * // const rentalDuration = days(7);
+ *
+ * // New approach with smart parameters:
+ * const rentalDuration = { days: 7 };
+ * const paymentPeriod = { hours: 6 };
+ * const longRental = { weeks: 2 };
+ * ```
+ */
+/**
+ * SRSLY Program IDL
+ *
+ * Export the complete IDL for the SRSLY program, useful for:
+ * - Building custom decoders
+ * - Generating client code
+ * - Inspecting program structure
+ * - Version-aware deserialization
+ */
+var idl_1 = require("./idl");
+Object.defineProperty(exports, "IDL", { enumerable: true, get: function () { return idl_1.IDL; } });
+/**
+ * Legacy versioned decoders are now deprecated.
+ *
+ * Use the native Codama lazy decoder instead:
+ * - Replace: fetchMaybeRentalStateVersioned(rpc, address)
+ * - With: fetchMaybeRentalState(rpc, address, { lazy: true })
+ *
+ * The lazy decoder is available in all generated account fetch functions.
+ */
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4BAA4B;AAC5B,6CAA2B;AAC3B,2CAAyB;AACzB,0CAAwB;AAuBxB,8DAA8D;AAC9D,+CAAqD;AAA5C,6GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;;;;;;;;;;;;;;;;;AAEH,4BAA4B;AAC5B,6CAA2B;AAC3B,2CAAyB;AAEzB,sCAAsC;AACtC,2CAAyB;AAEzB,8DAA8D;AAC9D,yCAUwB;AATtB,mGAAA,YAAY,OAAa;AACzB,mGAAA,YAAY,OAAa;AACzB,qGAAA,cAAc,OAAe;AAC7B,iHAAA,uBAAuB,OAAA;AAQzB,0CAAwB;AA0BxB;;;;;;;;;;;;;;;;GAgBG;AACH,yDAQgC;AAP9B,oHAAA,kBAAkB,OAAA;AAClB,kHAAA,gBAAgB,OAAA;AAChB,kHAAA,gBAAgB,OAAA;AAChB,iHAAA,eAAe,OAAA;AACf,6HAAA,2BAA2B,OAAA;AAC3B,2HAAA,yBAAyB,OAAA;AAI3B;;;;;GAKG;AACH,+DAA6D;AAApD,qHAAA,gBAAgB,OAAA;AAEzB;;;;;;;;;;;;GAYG;AACH,+DASmC;AAPjC,8HAAA,yBAAyB,OAAA;AACzB,0HAAA,qBAAqB,OAAA;AACrB,gIAAA,2BAA2B,OAAA;AAC3B,8HAAA,yBAAyB,OAAA;AACzB,8HAAA,yBAAyB,OAAA;AACzB,kIAAA,6BAA6B,OAAA;AAC7B,4HAAA,uBAAuB,OAAA;AAGzB;;;;;;;;;;;GAWG;AACH,+DAKmC;AAJjC,8HAAA,yBAAyB,OAAA;AACzB,oIAAA,+BAA+B,OAAA;AAC/B,8HAAA,yBAAyB,OAAA;AACzB,6HAAA,wBAAwB,OAAA;AAG1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qCAOsB;AANpB,6GAAA,qBAAqB,OAAA;AACrB,8GAAA,sBAAsB,OAAA;AACtB,8GAAA,sBAAsB,OAAA;AACtB,2GAAA,mBAAmB,OAAA;AACnB,gHAAA,wBAAwB,OAAA;AACxB,oHAAA,4BAA4B,OAAA;AAG9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,mEAIqC;AAHnC,6HAAA,sBAAsB,OAAA;AACtB,mIAAA,4BAA4B,OAAA;AAI9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,6DAKkC;AAJhC,mHAAA,eAAe,OAAA;AACf,kHAAA,cAAc,OAAA;AAKhB;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AACH,6BAAiD;AAAxC,0FAAA,GAAG,OAAA;AAEZ;;;;;;;;GAQG"}

package/dist/cjs/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@wuwei-labs/srsly",
+  "version": "2.3.2",
+  "description": "",
+  "source": "./src/index.ts",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/cjs",
+    "dist/esm",
+    "dist/types",
+    "target/idl/srsly.json",
+    "target/types/srsly.ts"
+  ],
+  "keywords": [
+    "SRSLY",
+    "Star",
+    "Atlas",
+    "sdk"
+  ],
+  "scripts": {
+    "build": "pnpm run generate && pnpm run package",
+    "build:quick": "pnpm run generate && pnpm run package",
+    "package": "pnpm run package:cjs && pnpm run package:esm",
+    "package:cjs": "tsc -p tsconfig.cjs.json && tsconfig-to-dual-package tsconfig.cjs.json",
+    "package:esm": "tsc -p tsconfig.esm.json && tsconfig-to-dual-package tsconfig.esm.json",
+    "generate": "node generate.mjs",
+    "dev": "vitest",
+    "pretest": "pnpm run build:quick",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist target && cargo clean",
+    "docs": "typedoc",
+    "format": "prettier --write \"src/**/*.{ts,js,json}\" --ignore-path .prettierignore",
+    "format:check": "prettier --check \"src/**/*.{ts,js,json}\" --ignore-path .prettierignore",
+    "lint": "pnpm run format:check"
+  },
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.13.1",
+  "dependencies": {
+    "@solana/kit": "^2.1.1",
+    "cron-parser": "^5.3.0"
+  },
+  "optionalDependencies": {
+    "@srsly/program": "workspace:*"
+  },
+  "devDependencies": {
+    "@codama/nodes-from-anchor": "^1.1.13",
+    "@wuwei-labs/renderers-js": "^1.4.2",
+    "@types/node": "^24.0.3",
+    "codama": "^1.2.13",
+    "nodemon": "^3.0.2",
+    "tsconfig-to-dual-package": "^1.2.0",
+    "typedoc": "^0.27.6",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "webpack": "^5.99.9"
+  },
+  "type": "commonjs"
+}

package/dist/cjs/rental/accept.js

@@ -1,90 +1,263 @@
 "use strict";
+/**
+ * @purpose Rental contract acceptance with payment calculation and SAGE integration
+ * @reviewed 2025-07-29
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.acceptRentalDemo = void 0;
 exports.acceptRental = acceptRental;
 exports.getAcceptRentalInstructionAsync = getAcceptRentalInstructionAsync;
 const config_1 = require("../utils/config");
 const constants_1 = require("../utils/constants");
 const utils_1 = require("../utils");
+const instruction_converter_1 = require("../utils/instruction-converter");
+const fetch_accounts_1 = require("../utils/fetch-accounts");
+const cron_1 = require("../utils/cron");
+const derive_pda_1 = require("../utils/derive-pda");
+const signer_1 = require("../utils/signer");
+const param_converters_1 = require("../utils/param-converters");
 /**
- * Internal function to accept a rental instruction with configuration options
+ * Internal function to accept a rental instruction with configuration options.
+ *
+ * This function handles the core logic of creating a rental acceptance instruction,
+ * including contract state fetching, payment calculation, account derivation, and
+ * instruction generation. It automatically validates contract constraints and
+ * calculates the required payment amount.
+ *
+ * @internal
+ * @param params - The rental acceptance parameters
+ * @param config - Optional configuration for network and program settings
+ * @returns Promise resolving to a fluent instruction object
+ * @throws Error when contract is not found, duration constraints are violated, or account derivation fails
  */
 async function _acceptRental(params, config) {
-    const { borrower, borrowerProfile, borrowerFaction, fleet, contract, gameId, rate, duration, referralTokenAccount, } = params;
-    // Get the actual game ID to use (param override, config override, or network default)
-    const actualGameId = gameId || await (0, constants_1.getSageGameId)(config);
-    // Calculate the total amount from rate and duration
-    // Convert ATLAS to stardust (smallest unit): 1 ATLAS = 100,000,000 stardust
-    const amount = BigInt(rate) * BigInt(duration) * BigInt(constants_1.ATLAS_TO_STARDUST);
-    // Derive the three accounts we need
-    const { profileFaction, starbase, starbasePlayer } = await (0, utils_1.deriveGameAccounts)(borrowerProfile, borrowerFaction, actualGameId, 0, // starbaseSeqId
-    config);
-    // Let codama derive the rest (rentalThread, rentalState, rentalAuthority, etc.)
+    let { borrowerProfile, borrowerFaction, contract, duration } = params;
+    // Get the resolved addresses from config (including network-specific addresses)
+    const globalConfig = (0, config_1.getSdkConfig)();
+    const effectiveConfig = { ...globalConfig, ...config };
+    const resolvedAddresses = (0, config_1.resolveProgramAddresses)(effectiveConfig);
+    // Fetch contract state to get payment frequency and validate parameters
+    const contractState = await (0, fetch_accounts_1.fetchContractState)(contract);
+    const configState = await (0, fetch_accounts_1.fetchConfigState)();
+    // Extract data from contract state
+    const rate = contractState.rate; // Keep as bigint
+    const fleet = contractState.fleet;
+    // Resolve faction - use provided faction or fetch from fleet
+    if (!borrowerFaction) {
+        const fleetState = await (0, fetch_accounts_1.fetchFleetState)(fleet);
+        borrowerFaction = fleetState.faction;
+    }
+    // Convert duration to seconds using smart parameter converter
+    const durationSeconds = await (0, param_converters_1.convertDurationToSeconds)(duration);
+    // Get the actual period duration using prev/next method
+    const currentTime = Math.floor(Date.now() / 1000);
+    // Normalize the payment frequency for JavaScript cron-parser
+    const normalizedFreq = contractState.paymentsFeq.startsWith('@')
+        ? {
+            '@hourly': '0 * * * *',
+            '@daily': '0 0 * * *',
+            '@weekly': '0 0 * * 0',
+            '@monthly': '0 0 1 * *',
+            '@decasecond': '*/10 * * * * *',
+            '@minute': '0 * * * * *',
+        }[contractState.paymentsFeq] || contractState.paymentsFeq
+        : contractState.paymentsFeq;
+    // Get actual period duration (not time-to-first-payment)
+    const actualPeriodDuration = (0, cron_1.getActualPeriodDuration)(normalizedFreq, currentTime);
+    // Calculate proportional amount using integer math
+    // amount = rate * duration / period * stardust_to_atlas
+    const amount = rate
+        * BigInt(durationSeconds)
+        / BigInt(actualPeriodDuration)
+        * configState.stardustToAtlas;
+    // Derive the fee_token_account from config state
+    const feeTokenAccount = await (0, derive_pda_1.deriveFeeTokenAccount)(configState);
+    // Manually derive ALL game accounts - they all use different program addresses than main SAGE program
+    const { profileFaction, starbase, starbasePlayer } = await (0, utils_1.deriveGameAccounts)((0, constants_1.toAddress)(borrowerProfile), borrowerFaction, 0, // starbaseSeqId
+    contractState.gameId);
+    // Handle borrower using smart signer handler for universal compatibility
+    const borrower = (0, signer_1.createTransactionSigner)(params.borrower);
+    // Manually derive PDAs with correct program IDs
+    const rentalStatePda = await (0, derive_pda_1.deriveRental)((0, constants_1.toAddress)(contract), borrower.address, // Use TransactionSigner.address for PDA derivation
+    resolvedAddresses.srslyProgramAddress);
+    const rentalAuthorityPda = await (0, derive_pda_1.deriveRentalAuthority)(resolvedAddresses.srslyProgramAddress);
+    const rentalThreadPda = await (0, derive_pda_1.deriveRentalThread)(rentalAuthorityPda, rentalStatePda, resolvedAddresses.antegenProgramAddress);
     const input = {
-        borrower,
-        borrowerProfile,
-        borrowerProfileFaction: profileFaction,
-        fleet,
-        contract,
-        gameId: actualGameId,
-        starbase,
-        starbasePlayer,
+        borrower: borrower,
+        borrowerProfile: (0, constants_1.toAddress)(borrowerProfile),
+        borrowerProfileFaction: (0, constants_1.toAddress)(profileFaction),
+        fleet: (0, constants_1.toAddress)(fleet),
+        contract: (0, constants_1.toAddress)(contract),
+        gameId: contractState.gameId,
+        starbase: (0, constants_1.toAddress)(starbase),
+        starbasePlayer: (0, constants_1.toAddress)(starbasePlayer),
+        // Override PDAs with correctly derived addresses
+        rentalState: rentalStatePda,
+        rentalAuthority: rentalAuthorityPda,
+        rentalThread: rentalThreadPda,
         amount,
-        duration,
-        referralTokenAccount,
+        duration: durationSeconds,
+        feeTokenAccount,
+        mint: resolvedAddresses.atlasMint,
+        sageProgram: resolvedAddresses.sageProgramAddress,
+        antegenProgram: resolvedAddresses.antegenProgramAddress,
     };
-    // Dynamically import network-specific codama functions
-    const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
-    const { getAcceptRentalInstructionAsync, SRSLY_PROGRAM_ADDRESS } = codamaModule;
-    return getAcceptRentalInstructionAsync(input, { programAddress: SRSLY_PROGRAM_ADDRESS });
+    // Get network-specific codama functions from centralized config
+    const instructionsModule = (0, config_1.getModule)('instructions');
+    const { getAcceptRentalInstructionAsync } = instructionsModule;
+    const rawInstruction = await getAcceptRentalInstructionAsync(input, {
+        programAddress: resolvedAddresses.srslyProgramAddress,
+    });
+    return (0, instruction_converter_1.createFluentInstruction)(rawInstruction);
 }
 /**
- * Creates an instruction to accept a rental with fluent configuration.
+ * Creates an instruction to accept a rental contract with fluent configuration.
+ *
+ * This function allows a borrower to accept an existing rental contract, automatically
+ * calculating the required payment amount based on the contract's rate and payment frequency.
+ * The SDK fetches contract details, validates duration constraints, and derives all
+ * necessary accounts for the rental operation.
+ *
+ * ## Features
+ *
+ * - **Automatic Payment Calculation**: Fetches contract state and calculates exact payment amount
+ * - **Automatic Faction Resolution**: Optionally fetches faction from fleet account if not provided
+ * - **Duration Validation**: Ensures rental duration meets contract constraints
+ * - **Account Derivation**: Automatically derives all required game accounts
+ * - **SAGE Integration**: Sets up fleet ownership transfer in the Star Atlas ecosystem
+ * - **Clockwork Integration**: Configures automated payment scheduling
+ * - **Universal Library Support**: Works with both @solana/kit and @solana/web3.js
+ *
+ * ## Process
+ *
+ * 1. **Fetch Contract**: Retrieves contract state from the blockchain
+ * 2. **Validate Duration**: Checks that rental duration meets contract constraints
+ * 3. **Calculate Payment**: Computes payment amount using contract rate and payment frequency
+ * 4. **Derive Accounts**: Generates required game accounts (starbase, faction, etc.)
+ * 5. **Create Instruction**: Builds the rental acceptance instruction
+ * 6. **Setup Threading**: Configures automated payment processing
+ *
+ * ## Payment Calculation
+ *
+ * The payment amount is calculated using the formula:
+ * ```text
+ * payment = rate × payment_periods × stardust_to_atlas_conversion
+ * ```
+ *
+ * Where:
+ * - `rate`: Contract's rental rate per payment period
+ * - `payment_periods`: Duration divided by payment frequency interval
+ * - `stardust_to_atlas_conversion`: Network-specific conversion factor
+ *
+ * ## Requirements
+ *
+ * - Contract must exist and be active
+ * - Duration must be within contract's min/max limits
+ * - Duration must be multiple of payment frequency
+ * - Borrower must have sufficient ATLAS tokens for payment
  *
  * @example
  * ```typescript
- * // Use devnet defaults
- * const ix = await acceptRental({
+ * import { acceptRental } from '@srsly/sdk';
+ *
+ * // Using smart duration parameters (recommended)
+ * const instruction = await acceptRental({
+ *   borrower: wallet,                      // Wallet object for signing
+ *   borrowerProfile: "ProfileAddr...",     // Borrower's Star Atlas profile
+ *   contract: "ContractAddr...",           // Contract to accept
+ *   duration: { days: 7 }                  // 7 days rental duration
+ *   // borrowerFaction auto-resolved from fleet account
+ * });
+ *
+ * // Different duration formats
+ * const hourlyRental = await acceptRental({
  *   borrower: wallet,
- *   borrowerProfile: profileAddress,
- *   borrowerFaction: 1, // 1 = mud, 2 = oni, 3 = ustur
- *   fleet: fleetAddress,
- *   contract: contractAddress,
- *   rate: 1000, // ATLAS tokens
- *   duration: 86400  // 1 day in seconds (total: 1000 * 86400 * 100M stardust)
+ *   borrowerProfile: "ProfileAddr...",
+ *   contract: "ContractAddr...",
+ *   duration: { hours: 12 }                // 12 hours
  * });
  *
- * // With referral (referrer gets 5% of platform fees)
- * const ix = await acceptRental({
+ * const weeklyRental = await acceptRental({
  *   borrower: wallet,
- *   borrowerProfile: profileAddress,
- *   borrowerFaction: 1,
- *   fleet: fleetAddress,
- *   contract: contractAddress,
- *   rate: 1000,
- *   duration: 86400,
- *   referralTokenAccount: referrerTokenAddress
+ *   borrowerProfile: "ProfileAddr...",
+ *   contract: "ContractAddr...",
+ *   duration: { weeks: 2 }                 // 2 weeks
  * });
  *
- * // Use mainnet configuration
- * const ix = await acceptRental(params).set({ network: 'mainnet' });
+ * const monthlyRental = await acceptRental({
+ *   borrower: wallet,
+ *   borrowerProfile: "ProfileAddr...",
+ *   contract: "ContractAddr...",
+ *   duration: { months: 1 }                // 1 month
+ * });
  *
- * // Override specific constants
- * const ix = await acceptRental(params).set({
- *   network: 'mainnet',
- *   gameId: 'custom-game-id...'
+ * // Backwards compatible - raw seconds
+ * const legacyRental = await acceptRental({
+ *   borrower: wallet,
+ *   borrowerProfile: "ProfileAddr...",
+ *   contract: "ContractAddr...",
+ *   duration: 604800                       // 7 days in seconds
  * });
+ *
+ * // Manual faction specification (optional)
+ * const manualInstruction = await acceptRental({
+ *   borrower: wallet.publicKey.toString(), // Address string for browser
+ *   borrowerProfile: "ProfileAddr...",     // Borrower's Star Atlas profile
+ *   borrowerFaction: 'mud',                // Optional: 'mud', 'oni', or 'ustur'
+ *   contract: "ContractAddr...",           // Contract to accept
+ *   duration: { days: 7 }                  // 7 days rental duration
+ * });
+ *
+ * // Configure for mainnet
+ * const mainnetInstruction = await acceptRental({
+ *   borrower: wallet,                      // Wallet object (CLI style)
+ *   borrowerProfile: "ProfileAddr...",
+ *   borrowerFaction: 1,                    // Can use numbers: 1=mud, 2=oni, 3=ustur
+ *   contract: "ContractAddr...",
+ *   duration: { days: 7 }
+ * }).set({ programs: 'mainnet' });
+ *
+ * // Use with your preferred Solana library
+ * const transaction = new Transaction().add(mainnetInstruction);
+ * await sendAndConfirmTransaction(connection, transaction, [wallet]);
  * ```
  *
- * @param params The simplified parameters for accepting a rental
- * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ * @param params - The rental acceptance parameters including borrower, contract, and duration
+ * @returns A SmartFluentConfigSelector that can be configured with .set() or awaited directly
+ * @throws Error when contract is not found, duration constraints are violated, or payment calculation fails
  */
 function acceptRental(params) {
-    return (0, config_1.createConfigSelector)((config) => _acceptRental(params, config));
+    const baseSelector = (0, config_1.createSdkConfigSelector)(config => _acceptRental(params, config));
+    return (0, instruction_converter_1.createSmartFluentConfigSelector)(baseSelector);
 }
+/**
+ * Low-level function to create a rental acceptance instruction with raw input parameters.
+ *
+ * This function provides direct access to the underlying codama-generated instruction
+ * builder. It's primarily used internally by the SDK but can be used for advanced
+ * use cases where full control over instruction parameters is needed.
+ *
+ * @internal
+ * @param input - Raw instruction input parameters as expected by codama
+ * @param options - Optional instruction options including program address
+ * @returns A SdkConfigSelector for the raw instruction
+ */
 function getAcceptRentalInstructionAsync(input, options) {
-    return (0, config_1.createConfigSelector)(async (config) => {
-        const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
-        return codamaModule.getAcceptRentalInstructionAsync(input, options);
+    return (0, config_1.createSdkConfigSelector)(async () => {
+        const instructionsModule = (0, config_1.getModule)('instructions');
+        return instructionsModule.getAcceptRentalInstructionAsync(input, options);
     });
 }
+// Demo export for documentation site
+exports.acceptRentalDemo = {
+    tabName: 'accept',
+    description: 'Accept a rental offer from an existing contract',
+    imports: `import { acceptRental } from '@wuwei-labs/srsly';`,
+    instruction: `const instruction = await acceptRental({
+  borrower: {{signerType}}.publicKey?.toBase58(),
+  borrowerProfile: "BORROWER_PROFILE_ADDRESS",
+  contract: "CONTRACT_ADDRESS",
+  duration: { days: 7 }
+});`,
+};
 //# sourceMappingURL=accept.js.map