@wuwei-labs/srsly 2.0.0-beta.37 → 2.0.0-beta.41

package/dist/esm/codama/types/paymentFrequency.js.map

@@ -1 +1 @@
-{"version":3,"file":"paymentFrequency.js","sourceRoot":"","sources":["../../../../src/codama/types/paymentFrequency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,GAIf,MAAM,aAAa,CAAC;AAErB,MAAM,CAAN,IAAY,gBAQX;AARD,WAAY,gBAAgB;IAC1B,2DAAM,CAAA;IACN,yDAAK,CAAA;IACL,+DAAQ,CAAA;IACR,2DAAM,CAAA;IACN,6DAAO,CAAA;IACP,mEAAU,CAAA;IACV,2DAAM,CAAA;AACR,CAAC,EARW,gBAAgB,KAAhB,gBAAgB,QAQ3B;AAID,MAAM,UAAU,0BAA0B;IACxC,OAAO,cAAc,CAAC,gBAAgB,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,cAAc,CAAC,gBAAgB,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,wBAAwB;IAItC,OAAO,YAAY,CACjB,0BAA0B,EAAE,EAC5B,0BAA0B,EAAE,CAC7B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"paymentFrequency.js","sourceRoot":"","sources":["../../../../src/codama/types/paymentFrequency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,GAIf,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,CAAN,IAAY,gBAQX;AARD,WAAY,gBAAgB;IAC1B,2DAAM,CAAA;IACN,yDAAK,CAAA;IACL,+DAAQ,CAAA;IACR,2DAAM,CAAA;IACN,6DAAO,CAAA;IACP,mEAAU,CAAA;IACV,2DAAM,CAAA;AACR,CAAC,EARW,gBAAgB,KAAhB,gBAAgB,QAQ3B;AAID,MAAM,UAAU,0BAA0B;IACxC,OAAO,cAAc,CAAC,gBAAgB,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,cAAc,CAAC,gBAAgB,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,wBAAwB;IAItC,OAAO,YAAY,CACjB,0BAA0B,EAAE,EAC5B,0BAA0B,EAAE,CAC7B,CAAC;AACJ,CAAC"}

package/dist/esm/contract/close.js

@@ -1,7 +1,7 @@
 import { getModule, createConfigSelector, resolveProgramAddresses } from '../utils/config';
 import { toAddress } from '../utils/constants';
 import { deriveGameAccounts } from '../utils';
-import { createFluentInstruction, createFluentConfigSelector } from '../utils/instruction-converter';
+import { createFluentInstruction, createSmartFluentConfigSelector } from '../utils/instruction-converter';
 /**
  * Asynchronously creates an instruction to close a rental contract with minimal required parameters.
  * Derives rentalAuthority automatically and handles optional parameters.
@@ -46,12 +46,21 @@ import { createFluentInstruction, createFluentConfigSelector } from '../utils/in
  * @returns A promise that resolves to the instruction to close a contract
  */
 /**
- * Internal function to close a contract instruction with configuration options
+ * Internal function to close a contract instruction with configuration options.
+ *
+ * This function handles the core logic of creating a contract closure instruction,
+ * including account derivation, address resolution, and instruction generation.
+ *
+ * @internal
+ * @param params - The contract closure parameters
+ * @param config - Optional configuration for network and program settings
+ * @returns Promise resolving to a fluent instruction object
+ * @throws Error when account derivation fails or required parameters are missing
  */
 async function _closeContract(params, config) {
     const { owner, fleet, contract, faction, } = params;
     // Get the resolved addresses from config (including network-specific addresses)
-    const resolvedAddresses = resolveProgramAddresses(config || {});
+    const resolvedAddresses = await resolveProgramAddresses(config || {});
     const derivedAccounts = await deriveGameAccounts(toAddress(owner), faction, resolvedAddresses.gameId, 0, // starbaseSeqId
     config);
     // Get network-specific codama functions from centralized config
@@ -75,24 +84,75 @@ async function _closeContract(params, config) {
 /**
  * Creates an instruction to close a rental contract with fluent configuration.
  *
- * @param params The contract closing parameters
- * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ * This function permanently closes an existing rental contract, making it unavailable
+ * for new rentals. The contract can only be closed by its original owner and only
+ * when there are no active rentals.
+ *
+ * ## Features
+ *
+ * - **Permanent Closure**: Irreversibly closes the contract
+ * - **Account Cleanup**: Closes contract account and returns lamports to owner
+ * - **SAGE Integration**: Removes rental capability from the fleet in SAGE
+ * - **Automatic Derivation**: Derives required game accounts automatically
+ * - **Network Agnostic**: Works with different Solana networks
+ *
+ * ## Process
+ *
+ * 1. **Derive Accounts**: Automatically derives required game accounts (starbase, etc.)
+ * 2. **Validate Authority**: Ensures only the contract owner can close it
+ * 3. **Check State**: Verifies no active rentals exist
+ * 4. **Close Contract**: Removes rental capability and closes account
+ * 5. **Transfer Lamports**: Returns remaining SOL to the owner
+ *
+ * ## Requirements
+ *
+ * - Contract must not have any active rentals
+ * - Caller must be the original contract owner
+ * - All pending payments must be completed
  *
  * @example
  * ```typescript
- * // Use atlasnet defaults (instruction building only)
- * await closeContract(params);
+ * import { closeContract } from '@srsly/sdk';
+ *
+ * // Basic contract closure
+ * const instruction = await closeContract({
+ *   owner: wallet,                    // Contract owner
+ *   fleet: "FleetAddress123...",      // Fleet address
+ *   contract: "ContractAddr...",      // Contract to close
+ *   faction: 'mud'                   // Faction for game account derivation
+ * });
+ *
+ * // Configure for mainnet
+ * const mainnetInstruction = await closeContract({
+ *   owner: wallet,
+ *   fleet: "FleetAddress123...",
+ *   contract: "ContractAddr...",
+ *   faction: 'mud'
+ * }).set({ programs: 'mainnet' });
  *
- * // Use mainnet
- * await closeContract(params).set({ programs: 'mainnet' });
+ * // Override specific game configuration
+ * const customInstruction = await closeContract({
+ *   owner: wallet,
+ *   fleet: "FleetAddress123...",
+ *   contract: "ContractAddr...",
+ *   faction: 'mud'
+ * }).set({
+ *   programs: 'mainnet',
+ *   gameId: 'custom-game-id...'
+ * });
  *
- * // Override game ID
- * await closeContract(params).set({ gameId: 'custom...' }); // gameId configured via .set()
+ * // Use with your preferred Solana library
+ * const transaction = new Transaction().add(instruction);
+ * await sendAndConfirmTransaction(connection, transaction, [wallet]);
  * ```
+ *
+ * @param params - The contract closing parameters including owner, fleet, and contract addresses
+ * @returns A FluentConfigSelector that can be configured with .set() or awaited directly
+ * @throws Error when account derivation fails or invalid parameters are provided
  */
 export function closeContract(params) {
     const baseSelector = createConfigSelector((config) => _closeContract(params, config));
-    return createFluentConfigSelector(baseSelector);
+    return createSmartFluentConfigSelector(baseSelector);
 }
 // Export config selector for getCloseContractInstructionAsync
 export function getCloseContractInstructionAsync(input, options) {

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

@@ -1 +1 @@
-{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/contract/close.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,uBAAuB,EAA2C,MAAM,iBAAiB,CAAC;AACpI,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAqD,MAAM,gCAAgC,CAAC;AAgCxJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,MAA2B,EAC3B,MAAsB;IAEtB,MAAM,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,GACR,GAAG,MAAM,CAAC;IAEX,gFAAgF;IAChF,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAEhE,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAC9C,SAAS,CAAC,KAAK,CAAC,EAChB,OAAQ,EACR,iBAAiB,CAAC,MAAM,EACxB,CAAC,EAAE,gBAAgB;IACnB,MAAM,CACP,CAAC;IAEF,gEAAgE;IAChE,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,EAAE,gCAAgC,EAAE,GAAG,kBAAkB,CAAC;IAChE,MAAM,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAAC;IAEjD,wEAAwE;IACxE,MAAM,KAAK,GAAG;QACZ,KAAK,EAAqC,gCAAgC;QAC1E,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAmB,2BAA2B;QACrE,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAa,8BAA8B;QACxE,QAAQ,EAAE,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAQ,8BAA8B;QACnF,cAAc,EAAE,SAAS,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,oCAAoC;QAC/F,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAsB,yDAAyD;QAC/G,WAAW,EAAE,iBAAiB,CAAC,kBAAkB,EAAG,+CAA+C;KACpG,CAAC;IAEF,MAAM,cAAc,GAAG,MAAM,gCAAgC,CAC3D,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;IACF,OAAO,uBAAuB,CAAC,cAAc,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA2B;IAE3B,MAAM,YAAY,GAAG,oBAAoB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gCAAgC,CAAC,KAAU,EAAE,OAAa;IACxE,OAAO,oBAAoB,CAAC,KAAK,IAAI,EAAE;QACrC,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;QACrD,OAAO,kBAAkB,CAAC,gCAAgC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/contract/close.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,uBAAuB,EAA2C,MAAM,iBAAiB,CAAC;AACpI,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,+BAA+B,EAA0D,MAAM,gCAAgC,CAAC;AA0ClK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,cAAc,CAC3B,MAA2B,EAC3B,MAAsB;IAEtB,MAAM,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,GACR,GAAG,MAAM,CAAC;IAEX,gFAAgF;IAChF,MAAM,iBAAiB,GAAG,MAAM,uBAAuB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAC9C,SAAS,CAAC,KAAK,CAAC,EAChB,OAAQ,EACR,iBAAiB,CAAC,MAAM,EACxB,CAAC,EAAE,gBAAgB;IACnB,MAAM,CACP,CAAC;IAEF,gEAAgE;IAChE,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,EAAE,gCAAgC,EAAE,GAAG,kBAAkB,CAAC;IAChE,MAAM,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAAC;IAEjD,wEAAwE;IACxE,MAAM,KAAK,GAAG;QACZ,KAAK,EAAqC,gCAAgC;QAC1E,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAmB,2BAA2B;QACrE,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAa,8BAA8B;QACxE,QAAQ,EAAE,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAQ,8BAA8B;QACnF,cAAc,EAAE,SAAS,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,oCAAoC;QAC/F,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAsB,yDAAyD;QAC/G,WAAW,EAAE,iBAAiB,CAAC,kBAAkB,EAAG,+CAA+C;KACpG,CAAC;IAEF,MAAM,cAAc,GAAG,MAAM,gCAAgC,CAC3D,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;IACF,OAAO,uBAAuB,CAAC,cAAc,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA2B;IAE3B,MAAM,YAAY,GAAG,oBAAoB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,OAAO,+BAA+B,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gCAAgC,CAAC,KAAU,EAAE,OAAa;IACxE,OAAO,oBAAoB,CAAC,KAAK,IAAI,EAAE;QACrC,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;QACrD,OAAO,kBAAkB,CAAC,gCAAgC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/contract/create.js

@@ -1,29 +1,58 @@
 /**
- * Unified contract creation - works with both @solana/kit and @solana/web3.js
- * Uses strings for all addresses to eliminate library-specific type complexity
+ * # Contract Creation Module
+ *
+ * This module provides functionality for creating rental contracts on the SRSLY program.
+ * It offers a unified API that works with both @solana/kit and @solana/web3.js libraries,
+ * using strings for all addresses to eliminate library-specific type complexity.
+ *
+ * ## Features
+ *
+ * - **Universal Compatibility**: Works with both major Solana libraries
+ * - **Fluent API**: Chainable configuration and format conversion
+ * - **Validation**: Built-in parameter validation and duration alignment checking
+ * - **Network Agnostic**: Supports mainnet, devnet, and custom configurations
+ *
+ * @module Contract/Create
  */
 import { getModule, createConfigSelector, resolveProgramAddresses } from '../utils/config';
 import { toAddress } from '../utils/constants';
 import { validateDurationAlignment, paymentFrequencyStringToSeconds } from '../utils/paymentFrequency';
 import { isValidPaymentFrequency } from '../types/paymentFrequency';
-import { createFluentInstruction, createFluentConfigSelector } from '../utils/instruction-converter';
+import { createFluentInstruction, createSmartFluentConfigSelector } from '../utils/instruction-converter';
 /**
- * Internal function to create a rental contract instruction with configuration options
+ * Internal function to create a rental contract instruction with configuration options.
+ *
+ * This function handles the core logic of creating a contract instruction, including
+ * parameter validation, address resolution, and instruction generation. It's used
+ * internally by the public createContract function.
+ *
+ * @internal
+ * @param params - The contract creation parameters
+ * @param config - Optional configuration for network and program settings
+ * @returns Promise resolving to a fluent instruction object
+ * @throws Error when validation fails or required parameters are missing
  */
 async function _createContract(params, config) {
-    const { owner, fleet, ownerProfile, rate, durationMax, paymentsFreq, ownerKeyIndex = 0, } = params;
+    const { owner, fleet, ownerProfile, rate, durationMin: customDurationMin, durationMax, paymentsFreq, ownerKeyIndex = 0, } = params;
     // Validate payment frequency
     if (!isValidPaymentFrequency(paymentsFreq)) {
         throw new Error(`Invalid payment frequency: "${paymentsFreq}". Valid values are: ${JSON.stringify(Object.keys({ daily: true, weekly: true, monthly: true, hourly: true }))}`);
     }
-    // Validate duration alignment
+    // Get the payment frequency interval
+    const paymentFrequencySeconds = paymentFrequencyStringToSeconds(paymentsFreq);
+    // Use custom durationMin if provided, otherwise default to 1 payment frequency period
+    const durationMin = customDurationMin ?? paymentFrequencySeconds;
+    // Validate duration alignment for both min and max
+    validateDurationAlignment(Number(durationMin), paymentsFreq);
     validateDurationAlignment(Number(durationMax), paymentsFreq);
-    // Get the payment frequency interval (this will be the minimum duration)
-    const durationMin = paymentFrequencyStringToSeconds(paymentsFreq);
+    // Validate that max is greater than or equal to min
+    if (durationMax < durationMin) {
+        throw new Error(`Maximum duration (${durationMax}s) must be greater than or equal to minimum duration (${durationMin}s)`);
+    }
     // Convert the payment frequency to the format expected by the Rust program (with @ prefix)
     const paymentsFreqWithPrefix = `@${paymentsFreq}`;
     // Get the resolved addresses from config (including network-specific addresses)
-    const resolvedAddresses = resolveProgramAddresses(config || {});
+    const resolvedAddresses = await resolveProgramAddresses(config || {});
     const input = {
         owner, // Pass as-is (string or signer)
         fleet: toAddress(fleet), // Convert fleet to Address
@@ -47,23 +76,59 @@ async function _createContract(params, config) {
 }
 /**
  * Creates an instruction to create a rental contract with fluent configuration.
- * This unified version works with both @solana/kit and @solana/web3.js using strings for addresses.
+ *
+ * This is the main function for creating rental contracts on the SRSLY program.
+ * It provides a unified API that works with both @solana/kit and @solana/web3.js
+ * libraries, using strings for all addresses to eliminate compatibility issues.
+ *
+ * ## Features
+ *
+ * - **Universal Library Support**: Works with both @solana/kit and @solana/web3.js
+ * - **Fluent Configuration**: Chain configuration options with `.set()`
+ * - **Format Conversion**: Convert between library formats with `.web3js()`
+ * - **Validation**: Built-in parameter validation and duration alignment
+ * - **Network Support**: Configurable for different Solana networks
+ *
+ * ## Validation
+ *
+ * The function automatically validates:
+ * - Payment frequency is supported
+ * - Duration alignment with payment frequency
+ * - Required parameters are provided
+ *
+ * ## Process
+ *
+ * 1. **Validate Parameters**: Checks payment frequency and duration alignment
+ * 2. **Resolve Addresses**: Gets network-specific program and mint addresses
+ * 3. **Generate Instruction**: Creates the contract creation instruction
+ * 4. **Return Fluent Object**: Allows for configuration and format conversion
  *
  * @example
  * ```typescript
- * // Works with any library - just use strings for addresses!
+ * import { createContract, days, hours } from '@srsly/sdk';
  *
- * // Default returns @solana/kit format
- * const kitInstruction = await createContract({
+ * // Basic usage - returns @solana/kit format by default
+ * const instruction = await createContract({
  *   owner: wallet,                    // Can be signer object or string
  *   fleet: "FleetAddress123...",      // String address
  *   ownerProfile: "ProfileAddr...",   // String address
- *   rate: 1000,
- *   durationMax: days(7),
- *   paymentsFreq: 'daily'
+ *   rate: 1000,                      // 1000 ATLAS per payment period
+ *   durationMax: days(7),            // 7 days maximum rental
+ *   paymentsFreq: 'daily'            // Daily payments
+ * });
+ *
+ * // With custom minimum duration
+ * const customMinInstruction = await createContract({
+ *   owner: wallet,
+ *   fleet: "FleetAddress123...",
+ *   ownerProfile: "ProfileAddr...",
+ *   rate: 100,                       // 100 ATLAS per hour
+ *   durationMin: hours(10),          // 10 hours minimum rental
+ *   durationMax: hours(24),          // 24 hours maximum rental
+ *   paymentsFreq: 'hourly'           // Hourly payments
  * });
  *
- * // Convert to @solana/web3.js format using fluent interface
+ * // Convert to @solana/web3.js format
  * const web3jsInstruction = await createContract({
  *   owner: wallet,
  *   fleet: "FleetAddress123...",
@@ -73,8 +138,8 @@ async function _createContract(params, config) {
  *   paymentsFreq: 'daily'
  * }).web3js();
  *
- * // Chain configuration and format conversion
- * const web3jsInstructionWithConfig = await createContract({
+ * // Configure network and convert format
+ * const mainnetInstruction = await createContract({
  *   owner: wallet,
  *   fleet: "FleetAddress123...",
  *   ownerProfile: "ProfileAddr...",
@@ -85,13 +150,15 @@ async function _createContract(params, config) {
  *
  * // Use with your preferred Solana library
  * const transaction = new Transaction().add(web3jsInstruction);
+ * await sendAndConfirmTransaction(connection, transaction, [wallet]);
  * ```
  *
- * @param params The simplified parameters for creating a rental contract
- * @returns A ConfigSelector that can be configured with .set() or awaited directly
+ * @param params - The contract creation parameters including owner, fleet, rate, and duration
+ * @returns A FluentConfigSelector that can be configured with .set() or awaited directly
+ * @throws Error when payment frequency is invalid or duration alignment fails
  */
 export function createContract(params) {
     const baseSelector = createConfigSelector((config) => _createContract(params, config));
-    return createFluentConfigSelector(baseSelector);
+    return createSmartFluentConfigSelector(baseSelector);
 }
 //# sourceMappingURL=create.js.map

package/dist/esm/contract/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/contract/create.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,uBAAuB,EAAsB,MAAM,iBAAiB,CAAC;AAC/G,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AACvG,OAAO,EAA0B,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAqD,MAAM,gCAAgC,CAAC;AAmBxJ;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,MAA4B,EAAE,MAAsB;IACjF,MAAM,EACJ,KAAK,EACL,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,aAAa,GAAG,CAAC,GAClB,GAAG,MAAM,CAAC;IAEX,6BAA6B;IAC7B,IAAI,CAAC,uBAAuB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,wBAAwB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAChL,CAAC;IAED,8BAA8B;IAC9B,yBAAyB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC;IAE7D,yEAAyE;IACzE,MAAM,WAAW,GAAG,+BAA+B,CAAC,YAAY,CAAC,CAAC;IAElE,2FAA2F;IAC3F,MAAM,sBAAsB,GAAG,IAAI,YAAY,EAAE,CAAC;IAElD,gFAAgF;IAChF,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG;QACZ,KAAK,EAAqC,gCAAgC;QAC1E,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAkB,2BAA2B;QACpE,YAAY,EAAE,SAAS,CAAC,YAAY,CAAC,EAAI,kCAAkC;QAC3E,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAS,+CAA+C;QACxF,WAAW,EAAE,iBAAiB,CAAC,kBAAkB,EAAE,+CAA+C;QAClG,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAQ,+CAA+C;QACxF,WAAW;QACX,WAAW;QACX,IAAI;QACJ,WAAW,EAAE,sBAAsB,EAAM,+CAA+C;QACxF,aAAa;KACd,CAAC;IAEF,gEAAgE;IAChE,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,EAAE,iCAAiC,EAAE,GAAG,kBAAkB,CAAC;IACjE,MAAM,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAAC;IAEjD,MAAM,cAAc,GAAG,MAAM,iCAAiC,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACjH,OAAO,uBAAuB,CAAC,cAAc,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,MAAM,YAAY,GAAG,oBAAoB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvF,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/contract/create.ts"],"names":[],"mappings":"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"}

package/dist/esm/contract/index.js

@@ -1,3 +1,48 @@
+/**
+ * # Contract Management Module
+ *
+ * This module provides comprehensive functionality for managing rental contracts
+ * on the SRSLY program. It includes functions for creating and closing contracts,
+ * with full support for both @solana/kit and @solana/web3.js libraries.
+ *
+ * ## Available Functions
+ *
+ * - **createContract**: Create a new rental contract for a fleet
+ * - **closeContract**: Permanently close an existing rental contract
+ *
+ * ## 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
+ * - **Validation**: Built-in parameter validation and error checking
+ *
+ * @example
+ * ```typescript
+ * import { createContract, closeContract, days } from '@srsly/sdk';
+ *
+ * // Create a rental contract
+ * const createInstruction = await createContract({
+ *   owner: wallet,
+ *   fleet: "FleetAddress123...",
+ *   ownerProfile: "ProfileAddr...",
+ *   rate: 1000,
+ *   durationMax: days(30),
+ *   paymentsFreq: 'daily'
+ * });
+ *
+ * // Close the contract later
+ * const closeInstruction = await closeContract({
+ *   owner: wallet,
+ *   fleet: "FleetAddress123...",
+ *   contract: "ContractAddr...",
+ *   faction: 'mud'
+ * });
+ * ```
+ *
+ * @module Contract
+ */
 export * from "./close";
 export * from "./create";
 //# sourceMappingURL=index.js.map

package/dist/esm/contract/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/esm/index.js

@@ -1,15 +1,119 @@
+/**
+ * # SRSLY SDK - Solana Rental System Library
+ *
+ * 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, days } from '@srsly/sdk';
+ *
+ * // Create a rental contract
+ * const instruction = await createContract({
+ *   owner: wallet,
+ *   fleet: "FleetAddress123...",
+ *   ownerProfile: "ProfileAddr...",
+ *   rate: 1000,
+ *   durationMax: days(7),
+ *   paymentsFreq: 'daily'
+ * });
+ *
+ * // Accept a rental
+ * const rentalInstruction = await acceptRental({
+ *   borrower: borrowerWallet,
+ *   contract: contractAddress,
+ *   amount: 7000,
+ *   duration: days(7)
+ * });
+ * ```
+ *
+ * ## 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
+ */
 // Export main SDK functions
 export * from "./contract";
 export * from "./rental";
 export * from "./utils";
-// Export account fetch functions that accept RPC URL strings
+/**
+ * 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
+ * );
+ * ```
+ */
 export { fetchContractState, fetchRentalState, fetchMultipleContractStates, fetchMultipleRentalStates } from "./utils/fetch-accounts";
-// Export PaymentFrequency from codama (generated from Rust)
+/**
+ * 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.
+ */
 export { PaymentFrequency } from "./codama/types/paymentFrequency";
-// Export auto-generated payment frequency types and utilities
+/**
+ * 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');
+ * }
+ * ```
+ */
 export { VALID_PAYMENT_FREQUENCIES, PAYMENT_FREQUENCY_MAP, PAYMENT_FREQUENCY_CONSTANTS, getPaymentFrequencyFromString, isValidPaymentFrequency } from "./types/paymentFrequency";
-// Export payment frequency utilities that mirror Rust implementation
+/**
+ * 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');
+ * ```
+ */
 export { paymentFrequencyToSeconds, paymentFrequencyStringToSeconds, validateDurationAlignment } from "./utils/paymentFrequency";
-// Export duration helper functions for convenient time unit conversion
-export { decaseconds, minutes, hours, days, weeks, months, duration } from "./utils/duration";
+/**
+ * Duration helper functions for convenient time unit conversion.
+ *
+ * These functions make it easy to specify durations in human-readable terms
+ * and convert them to the seconds required by the program.
+ *
+ * @example
+ * ```typescript
+ * const rentalDuration = days(7);           // 7 days in seconds
+ * const paymentPeriod = hours(6);           // 6 hours in seconds
+ * const longRental = duration(2, 'weeks');  // 2 weeks in seconds
+ * ```
+ */
+export { minutes, hours, days, weeks, months, duration } from "./utils/duration";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAsBxB,6DAA6D;AAC7D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,8DAA8D;AAC9D,OAAO,EAEL,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAElC,qEAAqE;AACrE,OAAO,EACL,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAElC,uEAAuE;AACvE,OAAO,EACL,WAAW,EACX,OAAO,EACP,KAAK,EACL,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,EACT,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,4BAA4B;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAyBxB;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,OAAO,EAEL,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,OAAO,EACL,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,OAAO,EACP,KAAK,EACL,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,EACT,MAAM,kBAAkB,CAAC"}

package/dist/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wuwei-labs/srsly",
-  "version": "2.0.0-beta.37",
+  "version": "2.0.0-beta.41",
   "description": "",
   "source": "./src/index.ts",
   "sideEffects": false,
@@ -21,12 +21,12 @@
     "sdk"
   ],
   "scripts": {
-    "package": "pnpm run clean && pnpm build && pnpm run package:cjs && pnpm run package:esm && pnpm run generate",
+    "build": "anchor run build && pnpm run package:cjs && pnpm run package:esm && pnpm run generate",
+    "build:clean": "pnpm run clean && pnpm run build",
     "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",
     "clean": "rm -rf dist && cargo clean && pnpm install",
     "generate": "node generate.mjs",
-    "build": "anchor build && pnpm run generate",
     "docs": "typedoc",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -36,7 +36,7 @@
   "license": "ISC",
   "packageManager": "pnpm@10.6.5",
   "dependencies": {
-    "@solana/kit": "^2.0.0"
+    "@solana/kit": "^2.1.1"
   },
   "devDependencies": {
     "@codama/nodes-from-anchor": "^1.1.13",