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

package/dist/esm/config/initialize.js

@@ -0,0 +1,92 @@
+/**
+ * @purpose Initialize SRSLY program configuration
+ * @reviewed 2025-07-31
+ */
+/**
+ * # Config Initialize Module
+ *
+ * This module provides functionality for initializing the SRSLY program configuration.
+ * This is a one-time operation that sets up the global config account with default values.
+ *
+ * ## Features
+ *
+ * - **One-time Setup**: Can only be called once to initialize the program
+ * - **Authority Assignment**: Sets the initial config authority
+ * - **Fee Configuration**: Sets the initial fee collection account
+ * - **Token Setup**: Configures the ATLAS token mint
+ *
+ * @module Config/Initialize
+ */
+import { getModule, createSdkConfigSelector, resolveProgramAddresses, getSdkConfig, } from '../utils/config';
+import { toAddress } from '../utils/constants';
+import { createFluentInstruction, createSmartFluentConfigSelector, } from '../utils/instruction-converter';
+import { createTransactionSigner } from '../utils/signer';
+/**
+ * Internal implementation of initializeConfig.
+ *
+ * This function handles the actual logic for creating the initialize config instruction.
+ * It's wrapped by the public initializeConfig function to provide fluent configuration support.
+ *
+ * @internal
+ */
+async function _initializeConfig(params, config) {
+    const { authority, feesAccount, atlasMint, } = params;
+    // Get the resolved addresses from config (including network-specific addresses)
+    const globalConfig = getSdkConfig();
+    const effectiveConfig = { ...globalConfig, ...config };
+    const resolvedAddresses = resolveProgramAddresses(effectiveConfig);
+    // Handle authority using smart signer handler for universal compatibility
+    const authoritySigner = createTransactionSigner(authority);
+    // Use provided ATLAS mint or default from resolved addresses
+    const atlasMintAddress = atlasMint || resolvedAddresses.atlasMint;
+    // Build input for codama instruction
+    const input = {
+        authority: authoritySigner,
+        feesAccount: toAddress(feesAccount),
+        atlasMint: toAddress(atlasMintAddress),
+    };
+    // Get network-specific codama functions from centralized config
+    const instructionsModule = getModule('instructions');
+    const { getInitializeConfigInstructionAsync } = instructionsModule;
+    const rawInstruction = await getInitializeConfigInstructionAsync(input, {
+        programAddress: resolvedAddresses.srslyProgramAddress,
+    });
+    return createFluentInstruction(rawInstruction);
+}
+/**
+ * Initialize the SRSLY program configuration.
+ *
+ * This is a one-time operation that creates the global config account with default values.
+ * After initialization, the config can be updated using the updateConfig function.
+ *
+ * The initialization sets:
+ * - Config authority (who can update the config)
+ * - Fee collection account
+ * - ATLAS token mint
+ * - Default values for all other settings
+ *
+ * @param params - Configuration initialization parameters
+ * @returns SmartFluentConfigSelector for chainable configuration
+ *
+ * @example
+ * ```typescript
+ * // Initialize config with basic settings
+ * const instruction = await initializeConfig({
+ *   authority: wallet,
+ *   feesAccount: 'FeesAccount11111111111111111111111111111111',
+ * }).build();
+ *
+ * // Initialize with custom ATLAS mint
+ * const instruction = await initializeConfig({
+ *   authority: wallet,
+ *   feesAccount: 'FeesAccount11111111111111111111111111111111',
+ *   atlasMint: 'ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx',
+ * })
+ * .set({ rpcUrl: 'https://custom.rpc.url' })
+ * .build();
+ * ```
+ */
+export function initializeConfig(params) {
+    return createSmartFluentConfigSelector(createSdkConfigSelector(() => _initializeConfig(params)));
+}
+//# sourceMappingURL=initialize.js.map

package/dist/esm/config/initialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.js","sourceRoot":"","sources":["../../../src/config/initialize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,GAEb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,+BAA+B,GAGhC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAwB,MAAM,iBAAiB,CAAC;AA+BhF;;;;;;;GAOG;AACH,KAAK,UAAU,iBAAiB,CAC9B,MAA8B,EAC9B,MAAyB;IAEzB,MAAM,EACJ,SAAS,EACT,WAAW,EACX,SAAS,GACV,GAAG,MAAM,CAAC;IAEX,gFAAgF;IAChF,MAAM,YAAY,GAAG,YAAY,EAAE,CAAC;IACpC,MAAM,eAAe,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC;IACvD,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,eAAe,CAAC,CAAC;IAEnE,0EAA0E;IAC1E,MAAM,eAAe,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAE3D,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,SAAS,IAAI,iBAAiB,CAAC,SAAS,CAAC;IAElE,qCAAqC;IACrC,MAAM,KAAK,GAAG;QACZ,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC;QACnC,SAAS,EAAE,SAAS,CAAC,gBAAgB,CAAC;KACvC,CAAC;IAEF,gEAAgE;IAChE,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,EAAE,mCAAmC,EAAE,GAAG,kBAAkB,CAAC;IAEnE,MAAM,cAAc,GAAG,MAAM,mCAAmC,CAAC,KAAK,EAAE;QACtE,cAAc,EAAE,iBAAiB,CAAC,mBAAmB;KACtD,CAAC,CAAC;IAEH,OAAO,uBAAuB,CAAC,cAAc,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA8B;IAE9B,OAAO,+BAA+B,CACpC,uBAAuB,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CACzD,CAAC;AACJ,CAAC"}

package/dist/esm/config/update.js

@@ -0,0 +1,159 @@
+/**
+ * @purpose Update SRSLY program configuration with SDK wrapper
+ * @reviewed 2025-07-31
+ */
+/**
+ * # Config Update Module
+ *
+ * This module provides functionality for updating the SRSLY program configuration.
+ * It allows the config authority to modify system-wide settings including fees,
+ * duration limits, and payment frequencies.
+ *
+ * ## Features
+ *
+ * - **Authority Management**: Transfer config authority to new addresses
+ * - **Fee Configuration**: Update service fees and collection accounts
+ * - **Duration Limits**: Modify minimum and maximum rental durations
+ * - **Payment Frequencies**: Configure allowed payment frequencies
+ *
+ * @module Config/Update
+ */
+import { getModule, createSdkConfigSelector, resolveProgramAddresses, getSdkConfig, } from '../utils/config';
+import { toAddress } from '../utils/constants';
+import { createFluentInstruction, createSmartFluentConfigSelector, } from '../utils/instruction-converter';
+import { createTransactionSigner } from '../utils/signer';
+import { getPaymentFrequencyFromString } from '../types/payment-frequency';
+import { convertDurationToSeconds } from '../utils/param-converters';
+/**
+ * Internal implementation of updateConfig.
+ *
+ * This function handles the actual logic for creating the update config instruction.
+ * It's wrapped by the public updateConfig function to provide fluent configuration support.
+ *
+ * @internal
+ */
+async function _updateConfig(params, config) {
+    const { authority, newAuthority, stardustToAtlas, serviceFeeBps, baseBps, rentalDurationMin, rentalDurationMax, feesAccount, atlasMint, defaultPaymentFrequency, allowedFrequencies, } = params;
+    // Validate service fee if provided
+    if (serviceFeeBps !== undefined && serviceFeeBps > 1000) {
+        throw new Error(`Service fee cannot exceed 10% (1000 basis points). Got: ${serviceFeeBps}`);
+    }
+    // Convert duration parameters to seconds
+    const rentalDurationMinSeconds = rentalDurationMin
+        ? await convertDurationToSeconds(rentalDurationMin)
+        : undefined;
+    const rentalDurationMaxSeconds = rentalDurationMax
+        ? await convertDurationToSeconds(rentalDurationMax)
+        : undefined;
+    // Validate duration limits if provided
+    if (rentalDurationMinSeconds !== undefined && rentalDurationMaxSeconds !== undefined) {
+        if (rentalDurationMaxSeconds < rentalDurationMinSeconds) {
+            throw new Error(`Maximum duration (${rentalDurationMaxSeconds}s) must be greater than or equal to minimum duration (${rentalDurationMinSeconds}s)`);
+        }
+    }
+    // Get the resolved addresses from config (including network-specific addresses)
+    const globalConfig = getSdkConfig();
+    const effectiveConfig = { ...globalConfig, ...config };
+    const resolvedAddresses = resolveProgramAddresses(effectiveConfig);
+    // Handle authority using smart signer handler for universal compatibility
+    const authoritySigner = createTransactionSigner(authority);
+    // Convert payment frequencies if provided
+    const defaultPaymentFrequencyEnum = defaultPaymentFrequency
+        ? getPaymentFrequencyFromString(defaultPaymentFrequency)
+        : null;
+    const allowedFrequenciesEnum = allowedFrequencies
+        ? allowedFrequencies.map((freq) => getPaymentFrequencyFromString(freq))
+        : null;
+    // Build input for codama instruction
+    const input = {
+        authority: authoritySigner,
+        authorityArg: newAuthority ? toAddress(newAuthority) : null,
+        stardustToAtlas: stardustToAtlas ?? null,
+        serviceFeeBps: serviceFeeBps ?? null,
+        baseBps: baseBps ?? null,
+        rentalDurationMinSeconds: rentalDurationMinSeconds ?? null,
+        rentalDurationMaxSeconds: rentalDurationMaxSeconds ?? null,
+        feesAccount: feesAccount ? toAddress(feesAccount) : null,
+        atlasMint: atlasMint ? toAddress(atlasMint) : null,
+        defaultPaymentFrequency: defaultPaymentFrequencyEnum,
+        allowedFrequencies: allowedFrequenciesEnum,
+    };
+    // Get network-specific codama functions from centralized config
+    const instructionsModule = getModule('instructions');
+    const { getUpdateConfigInstructionAsync } = instructionsModule;
+    const rawInstruction = await getUpdateConfigInstructionAsync(input, {
+        programAddress: resolvedAddresses.srslyProgramAddress,
+    });
+    return createFluentInstruction(rawInstruction);
+}
+/**
+ * Update the SRSLY program configuration with fluent configuration support.
+ *
+ * This is the main function for updating the program configuration 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.
+ *
+ * @param params - Configuration update parameters
+ * @returns SmartFluentConfigSelector for chainable configuration
+ *
+ * @example
+ * ```typescript
+ * // Update service fee
+ * const instruction = await updateConfig({
+ *   authority: wallet,
+ *   serviceFeeBps: 750, // 7.5%
+ * }).build();
+ *
+ * // Update duration limits with smart parameters
+ * const durationInstruction = await updateConfig({
+ *   authority: wallet,
+ *   rentalDurationMin: { hours: 1 },     // 1 hour minimum
+ *   rentalDurationMax: { months: 3 },    // 3 months maximum
+ * }).build();
+ *
+ * // Transfer authority with custom RPC
+ * const transferInstruction = await updateConfig({
+ *   authority: currentAuthority,
+ *   newAuthority: 'NewAuthority1111111111111111111111111111111',
+ * })
+ * .set({ rpcUrl: 'https://custom.rpc.url' })
+ * .build();
+ *
+ * // Update multiple settings with mainnet config
+ * const multiUpdateInstruction = await updateConfig({
+ *   authority: wallet,
+ *   serviceFeeBps: 500,
+ *   feesAccount: 'NewFeesAccount11111111111111111111111111111',
+ *   rentalDurationMin: { days: 1 },      // 1 day minimum
+ *   rentalDurationMax: { weeks: 12 },    // 12 weeks maximum
+ *   defaultPaymentFrequency: 'weekly',
+ *   allowedFrequencies: ['daily', 'weekly', 'monthly'],
+ * })
+ * .set({ programs: 'mainnet' })
+ * .build();
+ *
+ * // Backwards compatible - using seconds directly
+ * const legacyInstruction = await updateConfig({
+ *   authority: wallet,
+ *   rentalDurationMin: 3600,    // 1 hour in seconds
+ *   rentalDurationMax: 7776000, // 90 days in seconds
+ * }).build();
+ * ```
+ */
+export function updateConfig(params) {
+    return createSmartFluentConfigSelector(createSdkConfigSelector(() => _updateConfig(params)));
+}
+// Demo export for documentation site
+export const updateConfigDemo = {
+    tabName: 'updateConfig',
+    description: 'Update program configuration settings',
+    imports: `import { updateConfig } from '@wuwei-labs/srsly';`,
+    instruction: `const instruction = await updateConfig({
+  authority: {{signerType}},
+  serviceFeeBps: 500,                    // 5% service fee
+  rentalDurationMin: { hours: 1 },       // 1 hour minimum
+  rentalDurationMax: { months: 3 },      // 3 months maximum
+  allowedFrequencies: ['daily', 'weekly', 'monthly'],
+});`,
+};
+//# sourceMappingURL=update.js.map

package/dist/esm/config/update.js.map

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

package/dist/esm/contract/close.js

@@ -1,94 +1,154 @@
-import { getCachedNetworkModule, createConfigSelector } from '../utils/config';
-import { getSageGameId } from '../utils/constants';
-import { deriveGameAccounts, } from '../utils';
 /**
- * Asynchronously creates an instruction to close a rental contract with minimal required parameters.
- * Derives rentalAuthority automatically and handles optional parameters.
- *
- * @example
- * ```typescript
- * // Create the instruction with default devnet settings
- * const ix = await closeContract({
- *   owner: wallet,
- *   fleet: fleetAddress,
- *   contract: contractAddress,
- *   faction: 'mud',
- * });
- *
- * // Use mainnet configuration
- * const ix = await closeContract({
- *   owner: wallet,
- *   fleet: fleetAddress,
- *   contract: contractAddress,
- *   faction: 'mud',
- * }).set({ network: 'mainnet' });
- *
- * // Override specific constants
- * const ix = await closeContract({
- *   owner: wallet,
- *   fleet: fleetAddress,
- *   contract: contractAddress,
- *   faction: 'mud',
- * }).set({
- *   network: 'mainnet',
- *   gameId: 'custom-game-id...'
- * });
- * ```
- *
- * @param params The simplified parameters for closing a rental contract
- * @returns A promise that resolves to the instruction to close a contract
+ * @purpose Contract closure with fleet ownership return and SAGE integration
+ * @reviewed 2025-07-29
  */
+import { getModule, createSdkConfigSelector, resolveProgramAddresses, getSdkConfig, } from '../utils/config';
+import { toAddress } from '../utils/constants';
+import { deriveGameAccounts } from '../utils';
+import { createFluentInstruction, createSmartFluentConfigSelector, } from '../utils/instruction-converter';
+import { fetchContractState, fetchFleetState } from '../utils/fetch-accounts';
+import { createTransactionSigner } from '../utils/signer';
 /**
- * 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, gameId, } = params;
-    // Get the actual game ID to use (param override, config override, or network default)
-    const actualGameId = gameId || await getSageGameId(config);
-    const derivedAccounts = await deriveGameAccounts(owner.address, faction, actualGameId, 0, // starbaseSeqId
-    config);
-    const starbase = derivedAccounts.starbase;
-    const starbasePlayer = derivedAccounts.starbasePlayer;
-    // Dynamically import network-specific codama functions
-    const codamaModule = await getCachedNetworkModule('instructions', config?.network);
-    const { getCloseContractInstructionAsync, SRSLY_PROGRAM_ADDRESS } = codamaModule;
-    // Let codama derive the rest (rentalAuthority, ownerTokenAccount, etc.)
+    let { owner, fleet, contract, faction } = params;
+    // Get the resolved addresses from config (including network-specific addresses)
+    const globalConfig = getSdkConfig();
+    const effectiveConfig = { ...globalConfig, ...config };
+    const resolvedAddresses = resolveProgramAddresses(effectiveConfig);
+    // Handle owner using smart signer handler for universal compatibility
+    const ownerSigner = createTransactionSigner(owner);
+    // Fetch contract state to get fleet and gameId
+    const contractState = await fetchContractState(contract);
+    if (!fleet) {
+        fleet = contractState.fleet;
+    }
+    // Resolve faction - use provided faction or fetch from fleet
+    if (!faction) {
+        const fleetState = await fetchFleetState(fleet);
+        faction = fleetState.faction;
+    }
+    // Derive SAGE game accounts
+    const derivedAccounts = await deriveGameAccounts(ownerSigner.address, faction, 0, // starbaseSeqId
+    contractState.gameId);
+    // Get network-specific codama functions from centralized config
+    const instructionsModule = getModule('instructions');
+    const { getCloseContractInstructionAsync } = instructionsModule;
+    // Let codama handle all the account derivation and instruction building
     const input = {
-        owner,
-        fleet,
-        contract,
-        starbase,
-        starbasePlayer,
-        gameId: actualGameId,
+        owner: ownerSigner, // Pass TransactionSigner for proper handling
+        fleet: toAddress(fleet), // Convert fleet to Address
+        contract: toAddress(contract), // Convert contract to Address
+        starbase: toAddress(derivedAccounts.starbase), // Convert starbase to Address
+        starbasePlayer: toAddress(derivedAccounts.starbasePlayer), // Convert starbasePlayer to Address
+        gameId: contractState.gameId, // Use gameId from contract state
+        sageProgram: resolvedAddresses.sageProgramAddress, // Already Address from resolveProgramAddresses
     };
-    return getCloseContractInstructionAsync(input, { programAddress: SRSLY_PROGRAM_ADDRESS });
+    const rawInstruction = await getCloseContractInstructionAsync(input, {
+        programAddress: resolvedAddresses.srslyProgramAddress,
+    });
+    return createFluentInstruction(rawInstruction);
 }
 /**
  * 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 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. **Fetch Fleet**: Automatically fetches fleet address from contract if not provided
+ * 2. **Derive Accounts**: Automatically derives required game accounts (starbase, etc.)
+ * 3. **Validate Authority**: Ensures only the contract owner can close it
+ * 4. **Check State**: Verifies no active rentals exist
+ * 5. **Close Contract**: Removes rental capability and closes account
+ * 6. **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 devnet defaults
- * await closeContract(params);
+ * import { closeContract } from '@srsly/sdk';
  *
- * // Use mainnet
- * await closeContract(params).set({ network: 'mainnet' });
+ * // Basic contract closure (fleet automatically fetched)
+ * const instruction = await closeContract({
+ *   owner: wallet,                    // Contract owner
+ *   contract: "ContractAddr...",      // Contract to close
+ *   faction: 'mud'                   // Faction for game account derivation
+ * });
+ *
+ * // Configure for mainnet
+ * const mainnetInstruction = await closeContract({
+ *   owner: wallet,
+ *   contract: "ContractAddr...",
+ *   faction: 'mud'
+ * }).set({ programs: 'mainnet' });
  *
- * // Override game ID
- * await closeContract(params).set({ gameId: 'custom...' });
+ * // Override specific game configuration
+ * const customInstruction = await closeContract({
+ *   owner: wallet,
+ *   contract: "ContractAddr...",
+ *   faction: 'mud'
+ * }).set({
+ *   programs: 'mainnet',
+ *   gameId: 'custom-game-id...'
+ * });
+ *
+ * // 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 SmartFluentConfigSelector that can be configured with .set() or awaited directly
+ * @throws Error when account derivation fails or invalid parameters are provided
  */
 export function closeContract(params) {
-    return createConfigSelector((config) => _closeContract(params, config));
+    const baseSelector = createSdkConfigSelector(config => _closeContract(params, config));
+    return createSmartFluentConfigSelector(baseSelector);
 }
-// Export config selector for getCloseContractInstructionAsync
+/**
+ * Low-level function to create a contract close instruction with raw input parameters.
+ *
+ * @internal
+ */
 export function getCloseContractInstructionAsync(input, options) {
-    return createConfigSelector(async (config) => {
-        const codamaModule = await getCachedNetworkModule('instructions', config?.network);
-        return codamaModule.getCloseContractInstructionAsync(input, options);
+    return createSdkConfigSelector(async () => {
+        const instructionsModule = getModule('instructions');
+        return instructionsModule.getCloseContractInstructionAsync(input, options);
     });
 }
+// Demo export for documentation site
+export const closeContractDemo = {
+    tabName: 'close',
+    description: 'Close an existing rental contract',
+    imports: `import { closeContract } from '@wuwei-labs/srsly';`,
+    instruction: `const instruction = await closeContract({
+  owner: {{signerType}}.publicKey?.toBase58(),
+  contract: "CONTRACT_ADDRESS"
+});`,
+};
 //# sourceMappingURL=close.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/contract/close.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAA2C,MAAM,iBAAiB,CAAC;AACxH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,EACL,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAkClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,MAA2B,EAC3B,MAAsB;IAEtB,MAAM,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,GACP,GAAG,MAAM,CAAC;IAEX,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAM,IAAI,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IAE3D,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAC9C,KAAK,CAAC,OAAO,EACb,OAAQ,EACR,YAA+B,EAC/B,CAAC,EAAE,gBAAgB;IACnB,MAAM,CACP,CAAC;IAEF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;IAC1C,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CAAC;IAEtD,uDAAuD;IACvD,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnF,MAAM,EAAE,gCAAgC,EAAE,qBAAqB,EAAE,GAAG,YAAY,CAAC;IAEjF,wEAAwE;IACxE,MAAM,KAAK,GAAG;QACZ,KAAK;QACL,KAAK;QACL,QAAQ;QACR,QAAQ;QACR,cAAc;QACd,MAAM,EAAE,YAAY;KACrB,CAAC;IAEF,OAAO,gCAAgC,CACrC,KAAK,EACL,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA2B;IAE3B,OAAO,oBAAoB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gCAAgC,CAAC,KAAU,EAAE,OAAa;IACxE,OAAO,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACnF,OAAO,YAAY,CAAC,gCAAgC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../../src/contract/close.ts"],"names":[],"mappings":"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"}