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

package/dist/cjs/rental/accept.js.map

@@ -1 +1 @@
-{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../../src/rental/accept.ts"],"names":[],"mappings":";;AA8KA,oCAIC;AAED,0EAKC;AApLD,4CAAwH;AACxH,kDAAsE;AAMtE,oCAEkB;AAuDlB;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,MAA0B,EAC1B,MAAsB;IAEtB,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,oBAAoB,GACrB,GAAG,MAAM,CAAC;IAEX,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAM,IAAI,MAAM,IAAA,yBAAa,EAAC,MAAM,CAAC,CAAC;IAE3D,oDAAoD;IACpD,4EAA4E;IAC5E,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,6BAAiB,CAAC,CAAC;IAE3E,oCAAoC;IACpC,MAAM,EACJ,cAAc,EACd,QAAQ,EACR,cAAc,EACf,GAAG,MAAM,IAAA,0BAAkB,EAC1B,eAAe,EACf,eAAe,EACf,YAA+B,EAC/B,CAAC,EAAE,gBAAgB;IACnB,MAAM,CACP,CAAC;IAEF,gFAAgF;IAChF,MAAM,KAAK,GAAoC;QAC7C,QAAQ;QACR,eAAe;QACf,sBAAsB,EAAE,cAAc;QACtC,KAAK;QACL,QAAQ;QACR,MAAM,EAAE,YAAY;QACpB,QAAQ;QACR,cAAc;QACd,MAAM;QACN,QAAQ;QACR,oBAAoB;KACrB,CAAC;IAEF,uDAAuD;IACvD,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnF,MAAM,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,GAAG,YAAY,CAAC;IAEhF,OAAO,+BAA+B,CACpC,KAAY,EACZ,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,SAAgB,YAAY,CAC1B,MAA0B;IAE1B,OAAO,IAAA,6BAAoB,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,+BAA+B,CAAC,KAAU,EAAE,OAAa;IACvE,OAAO,IAAA,6BAAoB,EAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACnF,OAAO,YAAY,CAAC,+BAA+B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../../src/rental/accept.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwUH,oCAKC;AAcD,0EAKC;AA9VD,4CAOyB;AACzB,kDAAkE;AAClE,oCAA8C;AAC9C,0EAKwC;AACxC,4DAAgG;AAChG,wCAAwD;AACxD,oDAAqH;AACrH,4CAAgF;AAEhF,gEAAqE;AA4DrE;;;;;;;;;;;;;GAaG;AACH,KAAK,UAAU,aAAa,CAC1B,MAA0B,EAC1B,MAAyB;IAEzB,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEtE,gFAAgF;IAChF,MAAM,YAAY,GAAG,IAAA,qBAAY,GAAE,CAAC;IACpC,MAAM,eAAe,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC;IACvD,MAAM,iBAAiB,GAAG,IAAA,gCAAuB,EAAC,eAAe,CAAC,CAAC;IAEnE,wEAAwE;IACxE,MAAM,aAAa,GAAG,MAAM,IAAA,mCAAkB,EAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,MAAM,IAAA,iCAAgB,GAAE,CAAC;IAE7C,mCAAmC;IACnC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,iBAAiB;IAClD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IAElC,6DAA6D;IAC7D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,MAAM,IAAA,gCAAe,EAAC,KAAK,CAAC,CAAC;QAChD,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC;IACvC,CAAC;IAED,8DAA8D;IAC9D,MAAM,eAAe,GAAG,MAAM,IAAA,2CAAwB,EAAC,QAAQ,CAAC,CAAC;IAEjE,wDAAwD;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAElD,6DAA6D;IAC7D,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC;QAC9D,CAAC,CAAC;YACE,SAAS,EAAE,WAAW;YACtB,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,WAAW;YACtB,UAAU,EAAE,WAAW;YACvB,aAAa,EAAE,gBAAgB;YAC/B,SAAS,EAAE,aAAa;SACzB,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW;QAC3D,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC;IAE9B,yDAAyD;IACzD,MAAM,oBAAoB,GAAG,IAAA,8BAAuB,EAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAElF,mDAAmD;IACnD,wDAAwD;IACxD,MAAM,MAAM,GAAG,IAAI;UACf,MAAM,CAAC,eAAe,CAAC;UACvB,MAAM,CAAC,oBAAoB,CAAC;UAC5B,WAAW,CAAC,eAAe,CAAC;IAEhC,iDAAiD;IACjD,MAAM,eAAe,GAAG,MAAM,IAAA,kCAAqB,EAAC,WAAW,CAAC,CAAC;IAEjE,sGAAsG;IACtG,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,IAAA,0BAAkB,EAC3E,IAAA,qBAAS,EAAC,eAAe,CAAC,EAC1B,eAAe,EACf,CAAC,EAAE,gBAAgB;IACnB,aAAa,CAAC,MAAM,CACrB,CAAC;IAEF,yEAAyE;IACzE,MAAM,QAAQ,GAAG,IAAA,gCAAuB,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE1D,gDAAgD;IAChD,MAAM,cAAc,GAAG,MAAM,IAAA,yBAAY,EACvC,IAAA,qBAAS,EAAC,QAAQ,CAAC,EACnB,QAAQ,CAAC,OAAO,EAAE,mDAAmD;IACrE,iBAAiB,CAAC,mBAAmB,CACtC,CAAC;IAEF,MAAM,kBAAkB,GAAG,MAAM,IAAA,kCAAqB,EAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IAE9F,MAAM,eAAe,GAAG,MAAM,IAAA,+BAAkB,EAC9C,kBAAkB,EAClB,cAAc,EACd,iBAAiB,CAAC,qBAAqB,CACxC,CAAC;IAEF,MAAM,KAAK,GAAoC;QAC7C,QAAQ,EAAE,QAAQ;QAClB,eAAe,EAAE,IAAA,qBAAS,EAAC,eAAe,CAAC;QAC3C,sBAAsB,EAAE,IAAA,qBAAS,EAAC,cAAc,CAAC;QACjD,KAAK,EAAE,IAAA,qBAAS,EAAC,KAAK,CAAC;QACvB,QAAQ,EAAE,IAAA,qBAAS,EAAC,QAAQ,CAAC;QAC7B,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,QAAQ,EAAE,IAAA,qBAAS,EAAC,QAAQ,CAAC;QAC7B,cAAc,EAAE,IAAA,qBAAS,EAAC,cAAc,CAAC;QAEzC,iDAAiD;QACjD,WAAW,EAAE,cAAc;QAC3B,eAAe,EAAE,kBAAkB;QACnC,YAAY,EAAE,eAAe;QAE7B,MAAM;QACN,QAAQ,EAAE,eAAe;QACzB,eAAe;QACf,IAAI,EAAE,iBAAiB,CAAC,SAAS;QACjC,WAAW,EAAE,iBAAiB,CAAC,kBAAkB;QACjD,cAAc,EAAE,iBAAiB,CAAC,qBAAqB;KACxD,CAAC;IAEF,gEAAgE;IAChE,MAAM,kBAAkB,GAAG,IAAA,kBAAS,EAAC,cAAc,CAAC,CAAC;IACrD,MAAM,EAAE,+BAA+B,EAAE,GAAG,kBAAkB,CAAC;IAE/D,MAAM,cAAc,GAAG,MAAM,+BAA+B,CAAC,KAAY,EAAE;QACzE,cAAc,EAAE,iBAAiB,CAAC,mBAAmB;KACtD,CAAC,CAAC;IACH,OAAO,IAAA,+CAAuB,EAAC,cAAc,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmHG;AACH,SAAgB,YAAY,CAC1B,MAA0B;IAE1B,MAAM,YAAY,GAAG,IAAA,gCAAuB,EAAC,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,OAAO,IAAA,uDAA+B,EAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,+BAA+B,CAAC,KAAU,EAAE,OAAa;IACvE,OAAO,IAAA,gCAAuB,EAAC,KAAK,IAAI,EAAE;QACxC,MAAM,kBAAkB,GAAG,IAAA,kBAAS,EAAC,cAAc,CAAC,CAAC;QACrD,OAAO,kBAAkB,CAAC,+BAA+B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qCAAqC;AACxB,QAAA,gBAAgB,GAAG;IAC9B,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,iDAAiD;IAC9D,OAAO,EAAE,mDAAmD;IAC5D,WAAW,EAAE;;;;;IAKX;CACH,CAAC"}

package/dist/cjs/rental/cancel.js

@@ -1,54 +1,184 @@
 "use strict";
+/**
+ * @purpose Rental cancellation with penalty processing and thread cleanup
+ * @reviewed 2025-07-29
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelRentalDemo = void 0;
 exports.cancelRental = cancelRental;
 exports.getCancelRentalInstructionAsync = getCancelRentalInstructionAsync;
 const config_1 = require("../utils/config");
+const constants_1 = require("../utils/constants");
+const signer_1 = require("../utils/signer");
+const instruction_converter_1 = require("../utils/instruction-converter");
+const fetch_accounts_1 = require("../utils/fetch-accounts");
+const derive_pda_1 = require("../utils/derive-pda");
 /**
- * Internal function to cancel a rental instruction with configuration options
+ * Internal function to cancel a rental instruction with configuration options.
+ *
+ * This function handles the core logic of creating a rental cancellation instruction,
+ * including address resolution and instruction generation. The cancellation stops
+ * automated payments and may incur penalty fees.
+ *
+ * @internal
+ * @param params - The rental cancellation parameters
+ * @param config - Optional configuration for network and program settings
+ * @returns Promise resolving to a cancellation instruction
+ * @throws Error when instruction generation fails or required parameters are missing
  */
 async function _cancelRental(params, config) {
-    const { borrower, contract, } = params;
-    // Let codama derive all the optional accounts
+    let { contract, rental } = params;
+    // Validate that at least one parameter is provided
+    if (!contract && !rental) {
+        throw new Error('Either contract or rental must be provided');
+    }
+    // Prioritize rental over contract if both are provided
+    if (rental || !contract) {
+        const rentalState = await (0, fetch_accounts_1.fetchRentalState)((0, constants_1.toAddress)(rental));
+        contract = rentalState.contract;
+    }
+    // Handle borrower using smart signer handler for universal compatibility
+    const borrower = (0, signer_1.createTransactionSigner)(params.borrower);
+    // 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 using high-level function (same pattern as close contract)
+    const contractState = await (0, fetch_accounts_1.fetchContractState)((0, constants_1.toAddress)(contract));
+    // Fetch config state to get the authority using zero-argument overload
+    const configState = await (0, fetch_accounts_1.fetchConfigState)();
+    const authorityAddress = configState.authority;
+    // Derive PDAs individually (same pattern as accept rental to ensure consistency)
+    if (!rental) {
+        rental = await (0, derive_pda_1.deriveRental)((0, constants_1.toAddress)(contract), (0, constants_1.toAddress)(borrower.address), resolvedAddresses.srslyProgramAddress);
+    }
+    const rentalAuthorityPda = await (0, derive_pda_1.deriveRentalAuthority)(resolvedAddresses.srslyProgramAddress);
+    const rentalThreadPda = await (0, derive_pda_1.deriveRentalThread)(rentalAuthorityPda, (0, constants_1.toAddress)(rental), resolvedAddresses.antegenProgramAddress);
+    // Build the input with all required accounts (same pattern as accept rental)
     const input = {
-        borrower,
-        contract,
+        borrower: borrower,
+        owner: (0, constants_1.toAddress)(contractState.owner),
+        contract: (0, constants_1.toAddress)(contract),
+        authority: (0, constants_1.toAddress)(authorityAddress),
+        mint: resolvedAddresses.atlasMint,
+        // Override the auto-generated PDAs with our manually derived ones (same as accept rental)
+        rentalState: (0, constants_1.toAddress)(rental),
+        rentalAuthority: rentalAuthorityPda,
+        rentalThread: rentalThreadPda,
     };
-    // Dynamically import network-specific codama functions
-    const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
-    const { getCancelRentalInstructionAsync, SRSLY_PROGRAM_ADDRESS } = codamaModule;
-    return getCancelRentalInstructionAsync(input, { programAddress: SRSLY_PROGRAM_ADDRESS });
+    // Get network-specific codama functions from centralized config
+    const instructionsModule = (0, config_1.getModule)('instructions');
+    const { getCancelRentalInstructionAsync } = instructionsModule;
+    const rawInstruction = await getCancelRentalInstructionAsync(input, {
+        programAddress: resolvedAddresses.srslyProgramAddress,
+    });
+    return (0, instruction_converter_1.createFluentInstruction)(rawInstruction);
 }
 /**
  * Creates an instruction to cancel a rental with fluent configuration.
  *
+ * This function allows a borrower to cancel their active rental before the
+ * rental period expires. Canceling a rental stops automated payments but
+ * may incur penalty fees as defined in the contract terms. The fleet ownership
+ * is immediately returned to the original owner.
+ *
+ * ## Features
+ *
+ * - **Immediate Cancellation**: Stops the rental and automated payments immediately
+ * - **Fleet Transfer**: Returns fleet control to the original owner
+ * - **Thread Cleanup**: Cancels the automated payment thread
+ * - **Penalty Processing**: Handles any cancellation fees as defined in the contract
+ * - **Universal Library Support**: Works with both @solana/kit and @solana/web3.js
+ *
+ * ## Process
+ *
+ * 1. **Validate Authority**: Ensures only the borrower can cancel their rental
+ * 2. **Calculate Penalties**: Computes any cancellation fees owed
+ * 3. **Transfer Fleet**: Returns fleet ownership to the original owner
+ * 4. **Cancel Thread**: Stops automated payment processing
+ * 5. **Update State**: Marks rental as canceled in the rental state account
+ *
+ * ## Requirements
+ *
+ * - Rental must be active (not already canceled or completed)
+ * - Caller must be the original borrower
+ * - Borrower must have sufficient funds for any cancellation penalties
+ *
+ * ## Cancellation Effects
+ *
+ * - **Fleet Control**: Immediately returned to owner
+ * - **Automated Payments**: Stopped permanently
+ * - **Rental State**: Marked as canceled
+ * - **Thread Account**: Cleaned up and closed
+ * - **Penalties**: Charged according to contract terms
+ *
  * @example
  * ```typescript
- * // Use devnet defaults
- * const ix = await cancelRental({
+ * import { cancelRental } from '@srsly/sdk';
+ *
+ * // Cancel rental using contract address
+ * const instruction = await cancelRental({
  *   borrower: wallet,
- *   contract: contractAddress
+ *   contract: "ContractAddr..."
  * });
  *
- * // Use mainnet configuration
- * const ix = await cancelRental(params).set({ network: 'mainnet' });
- *
- * // Override specific constants
- * const ix = await cancelRental(params).set({
- *   network: 'mainnet',
- *   sageProgramAddress: 'custom...'
+ * // Cancel rental using rental state address (alternative approach)
+ * const instruction2 = await cancelRental({
+ *   borrower: wallet,
+ *   rental: "RentalStateAddr..."
  * });
+ *
+ * // Configure for mainnet
+ * const mainnetInstruction = await cancelRental({
+ *   borrower: wallet,
+ *   contract: "ContractAddr..."
+ * }).set({ programs: 'mainnet' });
+ *
+ * // Convert to @solana/web3.js format
+ * const web3jsInstruction = await cancelRental({
+ *   borrower: wallet,
+ *   rental: "RentalStateAddr..."
+ * }).web3js();
+ *
+ * // Use with your preferred Solana library
+ * const transaction = new Transaction().add(web3jsInstruction);
+ * await sendAndConfirmTransaction(connection, transaction, [wallet]);
  * ```
  *
- * @param params The simplified parameters for canceling a rental
- * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ * @param params - The rental cancellation parameters including borrower and either contract or rentalState
+ * @returns A SmartFluentConfigSelector that can be configured with .set() or awaited directly
+ * @throws Error when rental is not active, caller is not the borrower, or instruction generation fails
  */
 function cancelRental(params) {
-    return (0, config_1.createConfigSelector)((config) => _cancelRental(params, config));
+    const baseSelector = (0, config_1.createSdkConfigSelector)(config => _cancelRental(params, config));
+    return (0, instruction_converter_1.createSmartFluentConfigSelector)(baseSelector);
 }
+/**
+ * Low-level function to create a rental cancellation 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 getCancelRentalInstructionAsync(input, options) {
-    return (0, config_1.createConfigSelector)(async (config) => {
-        const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
-        return codamaModule.getCancelRentalInstructionAsync(input, options);
+    return (0, config_1.createSdkConfigSelector)(async () => {
+        const instructionsModule = (0, config_1.getModule)('instructions');
+        return instructionsModule.getCancelRentalInstructionAsync(input, options);
     });
 }
+// Demo export for documentation site
+exports.cancelRentalDemo = {
+    tabName: 'cancel',
+    description: 'Cancel an active rental (using contract address)',
+    imports: `import { cancelRental } from '@wuwei-labs/srsly';`,
+    instruction: `const instruction = await cancelRental({
+  borrower: {{signerType}}.publicKey?.toBase58(),
+  rental: "RENTAL_STATE_ADDRESS" // or contract: "CONTRACT_ADDRESS"
+});`,
+};
 //# sourceMappingURL=cancel.js.map

package/dist/cjs/rental/cancel.js.map

@@ -1 +1 @@
-{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../../src/rental/cancel.ts"],"names":[],"mappings":";;AA6EA,oCAIC;AAED,0EAKC;AAnFD,4CAAwH;AAoBxH;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,MAA0B,EAC1B,MAAsB;IAEtB,MAAM,EACJ,QAAQ,EACR,QAAQ,GACT,GAAG,MAAM,CAAC;IAEX,8CAA8C;IAC9C,MAAM,KAAK,GAAG;QACZ,QAAQ;QACR,QAAQ;KACT,CAAC;IAEF,uDAAuD;IACvD,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnF,MAAM,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,GAAG,YAAY,CAAC;IAEhF,OAAO,+BAA+B,CACpC,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,YAAY,CAC1B,MAA0B;IAE1B,OAAO,IAAA,6BAAoB,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,+BAA+B,CAAC,KAAU,EAAE,OAAa;IACvE,OAAO,IAAA,6BAAoB,EAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACnF,OAAO,YAAY,CAAC,+BAA+B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../../src/rental/cancel.ts"],"names":[],"mappings":"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"}

package/dist/cjs/rental/close.js

@@ -1,56 +1,184 @@
 "use strict";
+/**
+ * @purpose Rental closure with fund transfer and thread cleanup
+ * @reviewed 2025-07-29
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.closeRentalDemo = void 0;
 exports.closeRental = closeRental;
 exports.getCloseRentalInstructionAsync = getCloseRentalInstructionAsync;
 const config_1 = require("../utils/config");
+const constants_1 = require("../utils/constants");
+const instruction_converter_1 = require("../utils/instruction-converter");
+const fetch_accounts_1 = require("../utils/fetch-accounts");
+const derive_pda_1 = require("../utils/derive-pda");
+const signer_1 = require("../utils/signer");
 /**
- * Internal function to close a rental instruction with configuration options
+ * Internal function to close a rental instruction with configuration options.
+ *
+ * This function handles the core logic of creating a rental closure instruction,
+ * including address resolution and instruction generation. The closure finalizes
+ * the rental period and transfers any remaining funds to the owner.
+ *
+ * @internal
+ * @param params - The rental closure parameters
+ * @param config - Optional configuration for network and program settings
+ * @returns Promise resolving to a closure instruction
+ * @throws Error when instruction generation fails or required parameters are missing
  */
 async function _closeRental(params, config) {
-    const { borrower, ownerTokenAccount, contract, } = params;
-    // Let codama derive the optional accounts
+    let { payer, rental, borrowerProfile, borrowerFaction } = 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);
+    const rentalState = await (0, fetch_accounts_1.fetchRentalState)(rental);
+    // Extract required addresses from rental state
+    const contract = rentalState.contract;
+    const borrower = rentalState.borrower;
+    const rentalAuthorityPda = await (0, derive_pda_1.deriveRentalAuthority)(resolvedAddresses.srslyProgramAddress.toString());
+    const rentalThreadPda = await (0, derive_pda_1.deriveRentalThread)(rentalAuthorityPda, (0, constants_1.toAddress)(rental), // Use the passed-in rental state address
+    resolvedAddresses.antegenProgramAddress);
+    // Fetch contract state to get owner and SAGE-related accounts
+    const contractState = await (0, fetch_accounts_1.fetchContractState)(contract);
+    // Fetch config state to get the authority using zero-argument overload
+    const configState = await (0, fetch_accounts_1.fetchConfigState)();
+    // Handle payer using smart signer handler for universal compatibility
+    const payerSigner = (0, signer_1.createTransactionSigner)(payer);
+    // Resolve faction - use provided faction or fetch from fleet
+    if (!borrowerFaction) {
+        const fleetState = await (0, fetch_accounts_1.fetchFleetState)(contractState.fleet);
+        borrowerFaction = fleetState.faction;
+    }
+    // Derive game accounts for the BORROWER (not the owner)
+    const gameAccounts = await (0, derive_pda_1.deriveGameAccounts)((0, constants_1.toAddress)(borrowerProfile), borrowerFaction, 0, // starbaseSeqId
+    contractState.gameId);
+    const starbase = (0, constants_1.toAddress)(gameAccounts.starbase);
+    const starbasePlayer = (0, constants_1.toAddress)(gameAccounts.starbasePlayer);
+    // Only provide required fields - let Codama auto-generate the rest except rental_thread
     const input = {
-        borrower,
-        ownerTokenAccount,
-        contract,
+        payer: payerSigner, // Pass TransactionSigner for proper handling
+        mint: resolvedAddresses.atlasMint, // Use resolved ATLAS mint from config
+        authority: (0, constants_1.toAddress)(configState.authority), // Config authority for fee collection
+        borrower: (0, constants_1.toAddress)(borrower),
+        owner: (0, constants_1.toAddress)(contractState.owner),
+        contract: (0, constants_1.toAddress)(contract),
+        // Only override rental_thread since Codama can't auto-generate this one
+        rentalThread: rentalThreadPda, // Uses Antegen program ID!
+        // Add SAGE-related accounts
+        fleet: (0, constants_1.toAddress)(contractState.fleet),
+        gameId: contractState.gameId,
+        starbase: (0, constants_1.toAddress)(starbase),
+        starbasePlayer: (0, constants_1.toAddress)(starbasePlayer),
+        sageProgram: resolvedAddresses.sageProgramAddress,
     };
-    // Dynamically import network-specific codama functions
-    const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
-    const { getCloseRentalInstructionAsync, SRSLY_PROGRAM_ADDRESS } = codamaModule;
-    return getCloseRentalInstructionAsync(input, { programAddress: SRSLY_PROGRAM_ADDRESS });
+    // Get network-specific codama functions from centralized config
+    const instructionsModule = (0, config_1.getModule)('instructions');
+    const { getCloseRentalInstructionAsync } = instructionsModule;
+    const rawInstruction = await getCloseRentalInstructionAsync(input, {
+        programAddress: resolvedAddresses.srslyProgramAddress,
+    });
+    return (0, instruction_converter_1.createFluentInstruction)(rawInstruction);
 }
 /**
- * Creates an instruction to close a rental with fluent configuration.
+ * Creates an instruction to close a completed rental with fluent configuration.
+ *
+ * This function finalizes a rental that has reached its expiration or been fully paid.
+ * It transfers any remaining funds to the owner, returns fleet control, and cleans up
+ * the rental state account. This instruction can be called by anyone once the rental
+ * period has ended.
+ *
+ * ## Features
+ *
+ * - **Rental Finalization**: Properly closes completed or expired rentals
+ * - **Fund Transfer**: Moves any remaining payments or deposits to the owner
+ * - **Fleet Return**: Ensures fleet ownership is returned to the original owner
+ * - **State Cleanup**: Closes rental state account and returns lamports
+ * - **Thread Cleanup**: Cleans up automated payment threads
+ * - **Universal Library Support**: Works with both @solana/kit and @solana/web3.js
+ *
+ * ## Process
+ *
+ * 1. **Validate Completion**: Ensures rental period has ended or been fully paid
+ * 2. **Transfer Funds**: Moves any remaining ATLAS tokens to owner's account
+ * 3. **Return Fleet**: Transfers fleet ownership back to original owner
+ * 4. **Clean State**: Closes rental state account and returns SOL to payer
+ * 5. **Cancel Thread**: Cleans up any remaining automated payment threads
+ *
+ * ## Requirements
+ *
+ * - Rental must be completed or expired
+ * - Owner token account must be valid ATLAS token account
+ * - Rental state account must exist and be properly initialized
+ *
+ * ## When to Use
+ *
+ * - **Natural Expiration**: When rental period has ended
+ * - **Full Payment**: When all required payments have been made
+ * - **Account Cleanup**: To close expired rental accounts and recover SOL
+ * - **Fleet Recovery**: When fleet needs to be returned to owner
  *
  * @example
  * ```typescript
- * // Use devnet defaults
- * const ix = await closeRental({
- *   borrower: borrowerAddress,
- *   ownerTokenAccount: ownerTokenAccountAddress,
- *   contract: contractAddress
+ * import { closeRental } from '@srsly/sdk';
+ *
+ * // Close a completed rental
+ * const instruction = await closeRental({
+ *   payer: wallet,                         // Transaction payer
+ *   rental: "RentalState..."   // Rental state address
  * });
  *
- * // Use mainnet configuration
- * const ix = await closeRental(params).set({ network: 'mainnet' });
+ * // Configure for mainnet
+ * const mainnetInstruction = await closeRental({
+ *   payer: wallet,
+ *   rental: "RentalState..."
+ * }).set({ programs: 'mainnet' });
  *
- * // Override specific constants
- * const ix = await closeRental(params).set({
- *   network: 'mainnet',
- *   sageProgramAddress: 'custom...'
- * });
+ * // Convert to @solana/web3.js format
+ * const web3jsInstruction = await closeRental({
+ *   payer: wallet,
+ *   rental: "RentalState..."
+ * }).web3js(PublicKey);
+ *
+ * // Use with your preferred Solana library
+ * const transaction = new Transaction().add(web3jsInstruction);
+ * await sendAndConfirmTransaction(connection, transaction, [wallet]);
  * ```
  *
- * @param params The simplified parameters for closing a rental
- * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ * @param params - The rental closure parameters including payer and rental state address
+ * @returns A FluentConfigSelector that can be configured with .set() or awaited directly
+ * @throws Error when rental is not ready for closure or instruction generation fails
  */
 function closeRental(params) {
-    return (0, config_1.createConfigSelector)((config) => _closeRental(params, config));
+    const baseSelector = (0, config_1.createSdkConfigSelector)(config => _closeRental(params, config));
+    return (0, instruction_converter_1.createSmartFluentConfigSelector)(baseSelector);
 }
+/**
+ * Low-level function to create a rental closure 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 getCloseRentalInstructionAsync(input, options) {
-    return (0, config_1.createConfigSelector)(async (config) => {
-        const codamaModule = await (0, config_1.getCachedNetworkModule)('instructions', config?.network);
-        return codamaModule.getCloseRentalInstructionAsync(input, options);
+    return (0, config_1.createSdkConfigSelector)(async () => {
+        const instructionsModule = (0, config_1.getModule)('instructions');
+        return instructionsModule.getCloseRentalInstructionAsync(input, options);
     });
 }
+// Demo export for documentation site
+exports.closeRentalDemo = {
+    tabName: 'close',
+    description: 'Close a completed rental',
+    imports: `import { closeRental } from '@wuwei-labs/srsly';`,
+    instruction: `const instruction = await closeRental({
+  payer: {{signerType}}.publicKey?.toBase58(),
+  rental: "RENTAL_STATE_ADDRESS"
+});`,
+};
 //# sourceMappingURL=close.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/rental/close.ts"],"names":[],"mappings":";;AAoFA,kCAIC;AAED,wEAKC;AA3FD,4CAAwH;AAyBxH;;GAEG;AACH,KAAK,UAAU,YAAY,CACzB,MAAyB,EACzB,MAAsB;IAEtB,MAAM,EACJ,QAAQ,EACR,iBAAiB,EACjB,QAAQ,GACT,GAAG,MAAM,CAAC;IAEX,0CAA0C;IAC1C,MAAM,KAAK,GAAG;QACZ,QAAQ;QACR,iBAAiB;QACjB,QAAQ;KACT,CAAC;IAEF,uDAAuD;IACvD,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnF,MAAM,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,GAAG,YAAY,CAAC;IAE/E,OAAO,8BAA8B,CACnC,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,WAAW,CACzB,MAAyB;IAEzB,OAAO,IAAA,6BAAoB,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,SAAgB,8BAA8B,CAAC,KAAU,EAAE,OAAa;IACtE,OAAO,IAAA,6BAAoB,EAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,IAAA,+BAAsB,EAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACnF,OAAO,YAAY,CAAC,8BAA8B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/rental/close.ts"],"names":[],"mappings":"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"}

package/dist/cjs/rental/index.js

@@ -1,4 +1,8 @@
 "use strict";
+/**
+ * @purpose Rental operations module with accept, cancel, close, and reset functionality
+ * @reviewed 2025-07-29
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,6 +18,86 @@ 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 });
+/**
+ * # Rental Operations Module
+ *
+ * This module provides comprehensive functionality for managing rental operations
+ * on the SRSLY program. It includes functions for accepting, canceling, closing,
+ * and resetting rentals, with full support for both @solana/kit and @solana/web3.js libraries.
+ *
+ * ## Available Functions
+ *
+ * - **acceptRental**: Accept an existing rental contract as a borrower
+ * - **cancelRental**: Cancel an active rental before completion
+ * - **closeRental**: Close a completed or expired rental
+ * - **resetRental**: Reset a canceled rental to make the contract available again
+ *
+ * ## Rental Lifecycle
+ *
+ * ```text
+ * Contract Created → Accept → [Active Rental] → Close (Complete)
+ *                     ↓            ↓
+ *                 [Payment]    Cancel → Reset → [Available Again]
+ *                     ↑            ↓
+ *                 [Automated]   [Cleanup]
+ * ```
+ *
+ * ## Features
+ *
+ * - **Universal Library Support**: Works with both major Solana libraries
+ * - **String-Based Addresses**: Eliminates library-specific type conflicts
+ * - **Fluent API**: Chainable configuration and format conversion
+ * - **Network Agnostic**: Supports different Solana networks
+ * - **Automated Payments**: Integration with Clockwork for scheduled payments
+ * - **SAGE Integration**: Fleet ownership management in Star Atlas ecosystem
+ *
+ * ## Common Patterns
+ *
+ * ### Accept a Rental
+ * ```typescript
+ * import { acceptRental } from '@srsly/sdk';
+ *
+ * const instruction = await acceptRental({
+ *   borrower: wallet,
+ *   borrowerProfile: "ProfileAddr...",
+ *   contract: "ContractAddr...",
+ *   duration: { days: 7 }  // Smart parameter format
+ * });
+ * ```
+ *
+ * ### Cancel Active Rental
+ * ```typescript
+ * import { cancelRental } from '@srsly/sdk';
+ *
+ * const instruction = await cancelRental({
+ *   borrower: wallet,
+ *   contract: "ContractAddr..."
+ * });
+ * ```
+ *
+ * ### Close Completed Rental
+ * ```typescript
+ * import { closeRental } from '@srsly/sdk';
+ *
+ * const instruction = await closeRental({
+ *   payer: wallet,
+ *   rental: "RentalStateAddr..."
+ * });
+ * ```
+ *
+ * ### Reset Canceled Rental
+ * ```typescript
+ * import { resetRental } from '@srsly/sdk';
+ *
+ * const instruction = await resetRental({
+ *   payer: wallet,
+ *   contract: "ContractAddr..."
+ *   // fleet, rental, faction, ownerProfile auto-fetched if not provided
+ * });
+ * ```
+ *
+ * @module Rental
+ */
 __exportStar(require("./accept"), exports);
 __exportStar(require("./cancel"), exports);
 __exportStar(require("./close"), exports);

package/dist/cjs/rental/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rental/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rental/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AAEH,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB"}