@sly-rentals/core 0.1.0

package/dist/types/instructions/updateContractThread.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @purpose Simplified updateContractThread instruction wrapper
+ *
+ * Thin convenience wrapper around Codama-generated updateContractThread instruction.
+ * Funds additional lamports and/or updates the payment frequency for a contract thread.
+ */
+import { type Address } from '@solana/kit';
+import { type SdkConfig } from '../utils/config';
+import { type UniversalSigner } from '../utils/signer';
+import { prepareInstructions } from '../utils/instructions';
+import { type ScheduleParam } from '../params/schedule';
+import { type SolParam } from '../params/sol';
+/**
+ * Parameters for updating a contract automation thread
+ */
+export interface UpdateContractThreadParams {
+    /**
+     * Contract owner (payer for additional lamports)
+     * Accepts string address, web3.js Keypair, or @solana/kit signer
+     */
+    owner: UniversalSigner;
+    /** Contract address whose thread to update */
+    contract: Address | string;
+    /**
+     * Additional SOL to top up the thread with.
+     * Accepts a plain number / bigint (lamports), `{ sol: number }`, or
+     * `{ lamports: number | bigint }`.
+     * @example { sol: 0.05 } // top up by 0.05 SOL
+     * @example { lamports: 50_000_000 }
+     * @default
+     * ```ts
+     * 0 // no additional funding
+     * ```
+     */
+    lamports?: SolParam;
+    /** Optional new payment frequency (cron expression or named schedule) */
+    paymentsFreq?: ScheduleParam;
+    /**
+     * Sets compute units to allocate for the transaction.
+     * @example 400000
+     */
+    computeUnits?: number;
+}
+/**
+ * Top up a contract thread's lamports balance and (optionally)
+ * reschedule its payment frequency.
+ *
+ * @param params - Thread update parameters
+ * @param config - Optional SDK configuration overrides
+ * @returns Kit instruction (or web3.js if PublicKey in config)
+ */
+export declare function updateContractThread(params: UpdateContractThreadParams, config?: Partial<SdkConfig>): Promise<ReturnType<typeof prepareInstructions>>;
+//# sourceMappingURL=updateContractThread.d.ts.map

package/dist/types/instructions/updateContractThread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateContractThread.d.ts","sourceRoot":"","sources":["../../../src/instructions/updateContractThread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,KAAK,EAAE,eAAe,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,yEAAyE;IACzE,YAAY,CAAC,EAAE,aAAa,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,EAClC,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAC1B,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAqCjD"}

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

@@ -0,0 +1,27 @@
+/**
+ * @sly-rentals/core/kit
+ *
+ * Kit-native entry point for @solana/kit users.
+ * All instruction functions return InstructionResult (extends Instruction[]).
+ *
+ * @example
+ * ```typescript
+ * import { createContract, setSdkConfig } from '@sly-rentals/core/kit';
+ *
+ * const ixs = await createContract(params);
+ * // ixs is InstructionResult (extends Instruction[]) - use directly with Kit
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { VERSION } from '../version';
+export * from '../utils';
+export * from '../instructions';
+export * from '../accounts';
+export * from '../params';
+export * from '../pda';
+export * from '../cost';
+export { claim, type ClaimParams } from '@sly-rentals/vault';
+export * as codama from '../generated/codama';
+export * as audit from '../audit';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * @sly-rentals/core/legacy
+ *
+ * Legacy subpath for @solana/web3.js users.
+ * All instruction functions return LegacyInstruction[] directly.
+ *
+ * Requires PublicKey to be configured via setSdkConfig before use:
+ *
+ * @example
+ * ```typescript
+ * import { PublicKey } from '@solana/web3.js';
+ * import { setSdkConfig, createContract } from '@sly-rentals/core/legacy';
+ *
+ * // Configure PublicKey once at startup
+ * setSdkConfig({ PublicKey });
+ *
+ * // Now all instructions return LegacyInstruction[]
+ * const ixs = await createContract(params);
+ * // ixs is ready for web3.js Transaction
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { type LegacyInstruction } from '../utils';
+import * as kit from '../instructions';
+export * from '../utils';
+export * from '../accounts';
+export * from '../params';
+export * from '../pda';
+export { VERSION } from '../version';
+export * as codama from '../generated/codama';
+export type * from '../instructions';
+export { type ClaimParams } from '@sly-rentals/vault';
+export declare const createContract: (params: kit.CreateContractParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const updateContract: (params: kit.UpdateContractParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const closeContract: (params: kit.CloseContractParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const deleteContract: (params: kit.DeleteContractParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const setDelegate: (params: kit.SetDelegateParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const acceptRental: (params: kit.AcceptRentalParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const cancelRental: (params: kit.CancelRentalParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const closeRental: (params: kit.CloseRentalParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const releaseRental: (params: kit.ReleaseRentalParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const invalidateRental: (params: kit.InvalidateRentalParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const reserveRental: (params: kit.ReserveRentalParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const deleteRental: (params: kit.DeleteRentalParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const claimBorrower: (params: kit.ClaimBorrowerParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const closeBorrower: (params: kit.CloseBorrowerParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const createBorrower: (params: kit.CreateBorrowerParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const deleteBorrower: (params: kit.DeleteBorrowerParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const claimContract: (params: kit.ClaimContractParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const createContractThread: (params: kit.CreateContractThreadParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const closeContractThread: (params: kit.CloseContractThreadParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const updateContractThread: (params: kit.UpdateContractThreadParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const createConfig: (params: kit.CreateConfigParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const updateConfig: (params: kit.UpdateConfigParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const deleteConfig: (params: kit.DeleteConfigParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const createAffiliate: (params: kit.CreateAffiliateParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const approveAffiliate: (params: kit.ApproveAffiliateParams, config?: Partial<import("@sly-rentals/vault").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const removeAffiliate: (params: kit.RemoveAffiliateParams, config?: Partial<import("@sly-rentals/vault").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const updateAffiliate: (params: kit.UpdateAffiliateParams, config?: Partial<import("../utils").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+export declare const claim: (params: import("@sly-rentals/vault").ClaimParams, config?: Partial<import("@sly-rentals/vault").SdkConfig> | undefined) => Promise<LegacyInstruction[]>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/params/amount.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @purpose Amount parameter conversion utilities
+ *
+ * Converts user-friendly ATLAS amounts to stardust (smallest unit) for use with Solana programs.
+ * 1 ATLAS = 100,000,000 stardust (8 decimal places)
+ */
+/**
+ * Amount parameter type
+ *
+ * Accepts either:
+ * - Plain `number` / `bigint` — interpreted as **stardust** (smallest unit)
+ * - `{ atlas: number }` — convenience form for whole ATLAS with decimals
+ * - `{ stardust: number | bigint }` — explicit smallest unit (same as a bare number)
+ *
+ * Bare numbers default to stardust because the on-chain program operates
+ * in stardust — `convertAmount(100)` is 100 stardust (0.000001 ATLAS),
+ * not 100 ATLAS. Pass `{ atlas: 100 }` for one hundred ATLAS.
+ */
+export type AmountParam = number | bigint | {
+    atlas: number;
+} | {
+    stardust: number | bigint;
+};
+/**
+ * Convert amount parameter to stardust (smallest unit)
+ *
+ * @param amount - Amount in any supported format
+ * @returns Amount in stardust (u64 for Solana program)
+ * @throws Error if amount is invalid, negative, or non-integer stardust
+ *
+ * @example
+ * ```typescript
+ * convertAmount(10_000_000_000)         // 10_000_000_000n stardust (100 ATLAS)
+ * convertAmount({ atlas: 10 })          // 1_000_000_000n stardust (10 ATLAS)
+ * convertAmount({ stardust: 1_000_000 }) // 1_000_000n stardust (0.01 ATLAS)
+ * ```
+ */
+export declare function convertAmount(amount: AmountParam): bigint;
+/**
+ * Convert stardust to ATLAS for display
+ *
+ * @param stardust - Amount in stardust
+ * @returns Amount in ATLAS (decimal)
+ *
+ * @example
+ * ```typescript
+ * stardustToAtlas(100_000_000n)  // 1.0 ATLAS
+ * stardustToAtlas(150_000_000n)  // 1.5 ATLAS
+ * ```
+ */
+export declare function stardustToAtlas(stardust: bigint | number): number;
+/**
+ * Format amount for display
+ *
+ * @param stardust - Amount in stardust
+ * @param decimals - Number of decimal places (default: 8 for full precision)
+ * @returns Formatted ATLAS amount string
+ *
+ * @example
+ * ```typescript
+ * formatAmount(100_000_000n)      // "1.00000000 ATLAS"
+ * formatAmount(150_000_000n, 2)   // "1.50 ATLAS"
+ * ```
+ */
+export declare function formatAmount(stardust: bigint | number, decimals?: number): string;
+/**
+ * Validate amount is within reasonable bounds
+ *
+ * @param stardust - Amount in stardust
+ * @param min - Minimum allowed amount in stardust (default: 0)
+ * @param max - Maximum allowed amount in stardust (default: MAX_U64)
+ * @throws Error if amount is out of bounds
+ */
+export declare function validateAmount(stardust: bigint, min?: bigint, max?: bigint): void;
+//# sourceMappingURL=amount.d.ts.map

package/dist/types/params/amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../../src/params/amount.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,GACN;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AASlC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA0BzD;AA4BD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAGpF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAW,EAChB,GAAG,GAAE,MAAoC,GACxC,IAAI,CAWN"}

package/dist/types/params/duration.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @purpose Duration parameter conversion utilities
+ *
+ * Converts user-friendly duration formats to seconds for use with Solana programs.
+ */
+/**
+ * Duration parameter type
+ *
+ * Accepts either a plain number (seconds) or an object with time units.
+ */
+export type DurationParam = number | {
+    seconds?: number;
+} | {
+    minutes?: number;
+} | {
+    hours?: number;
+} | {
+    days?: number;
+} | {
+    weeks?: number;
+} | {
+    months?: number;
+};
+/**
+ * Convert duration parameter to seconds
+ *
+ * @param duration - Duration in any supported format
+ * @returns Duration in seconds
+ * @throws Error if duration is invalid or negative
+ *
+ * @example
+ * ```typescript
+ * convertDuration(3600)              // 3600 seconds
+ * convertDuration({ hours: 1 })      // 3600 seconds
+ * convertDuration({ days: 7 })       // 604800 seconds
+ * convertDuration({ weeks: 2 })      // 1209600 seconds
+ * ```
+ */
+export declare function convertDuration(duration: DurationParam): number;
+/**
+ * Validate duration limits
+ *
+ * Ensures duration is within reasonable bounds for rental contracts.
+ *
+ * @param durationSeconds - Duration in seconds
+ * @param min - Minimum allowed duration (default: 1 hour)
+ * @param max - Maximum allowed duration (default: 1 year)
+ * @throws Error if duration is out of bounds
+ */
+export declare function validateDuration(durationSeconds: number, min?: number, max?: number): void;
+/**
+ * Format duration in seconds to human-readable string
+ *
+ * @param seconds - Duration in seconds
+ * @returns Human-readable duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(3600)   // "1 hour"
+ * formatDuration(86400)  // "1 day"
+ * formatDuration(7200)   // "2 hours"
+ * ```
+ */
+export declare function formatDuration(seconds: number): string;
+//# sourceMappingURL=duration.d.ts.map

package/dist/types/params/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../../src/params/duration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAWxB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAmC/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,GAAG,GAAE,MAAyB,EAC9B,GAAG,GAAE,MAA8B,GAClC,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBtD"}

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

@@ -0,0 +1,5 @@
+export * from './amount';
+export * from './duration';
+export * from './schedule';
+export * from './sol';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/params/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC"}

package/dist/types/params/schedule.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @purpose Payment schedule parameter conversion utilities
+ *
+ * Converts user-friendly schedule formats to strings for use with Solana programs.
+ * Supports common shortcuts and cron expressions.
+ */
+/**
+ * Schedule parameter type
+ *
+ * Accepts either:
+ * - Schedule shortcuts (e.g., '@daily', 'daily', '@hourly', 'hourly')
+ * - Cron expressions for custom schedules
+ */
+export type ScheduleParam = string;
+/**
+ * Common schedule shortcuts
+ */
+export declare const SCHEDULE_SHORTCUTS: readonly ["@hourly", "@daily", "@weekly", "@monthly", "@yearly", "@annually", "@decasecond", "@minute", "hourly", "daily", "weekly", "monthly", "yearly", "annually", "decasecond", "minute"];
+/**
+ * Normalize payment schedule input to program-compatible format
+ *
+ * @param schedule - Payment schedule string
+ * @returns Normalized schedule string for Solana program
+ * @throws Error if schedule format is invalid
+ *
+ * @example
+ * ```typescript
+ * normalizeSchedule('daily')           // '@daily'
+ * normalizeSchedule('@hourly')         // '@hourly'
+ * normalizeSchedule('0 * * * *')       // '0 * * * *'
+ * normalizeSchedule('0 0 * * * *')     // '0 0 * * * *' (with seconds)
+ * ```
+ */
+export declare function normalizeSchedule(schedule: ScheduleParam): string;
+/**
+ * Validate schedule format
+ *
+ * Checks if a schedule string is either:
+ * - A valid @shortcut
+ * - A valid cron expression (5 or 6 fields)
+ *
+ * @param schedule - Schedule string to validate
+ * @returns True if valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * validateScheduleFormat('@daily')     // true
+ * validateScheduleFormat('0 * * * *')  // true
+ * validateScheduleFormat('invalid')    // false
+ * ```
+ */
+export declare function validateScheduleFormat(schedule: string): boolean;
+/**
+ * Convert schedule string to human-readable description
+ *
+ * @param schedule - Normalized schedule string
+ * @returns Human-readable description
+ *
+ * @example
+ * ```typescript
+ * formatSchedule('@daily')     // "Daily"
+ * formatSchedule('@hourly')    // "Hourly"
+ * formatSchedule('0 * * * *')  // "Custom: 0 * * * *"
+ * ```
+ */
+export declare function formatSchedule(schedule: string): string;
+/**
+ * Check if a schedule is a known shortcut
+ *
+ * @param schedule - Schedule string to check
+ * @returns True if it's a shortcut (with or without @)
+ */
+export declare function isScheduleShortcut(schedule: string): boolean;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/types/params/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/params/schedule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,kBAAkB,+LAiBrB,CAAC;AA0BX;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAoCjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAehE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWvD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG5D"}

package/dist/types/params/sol.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @purpose SOL parameter conversion utilities
+ *
+ * Converts user-friendly SOL amounts to lamports (smallest unit) for use with Solana programs.
+ * 1 SOL = 1,000,000,000 lamports (9 decimal places)
+ */
+/**
+ * SOL parameter type
+ *
+ * Accepts either:
+ * - Plain `number` / `bigint` — interpreted as **lamports** (smallest unit)
+ * - `{ sol: number }` — convenience form for whole SOL with decimals
+ * - `{ lamports: number | bigint }` — explicit smallest unit (same as a bare number)
+ *
+ * Bare numbers default to lamports because the on-chain program operates
+ * in lamports — `convertSol(1)` is 1 lamport, not 1 SOL. Pass `{ sol: 1 }`
+ * for one whole SOL.
+ */
+export type SolParam = number | bigint | {
+    sol: number;
+} | {
+    lamports: number | bigint;
+};
+/**
+ * Convert SOL parameter to lamports (smallest unit)
+ *
+ * @param amount - Amount in any supported format
+ * @returns Amount in lamports as bigint (u64 for Solana program)
+ * @throws Error if amount is invalid, negative, or non-integer lamports
+ *
+ * @example
+ * ```typescript
+ * convertSol(10_000_000)               // 10_000_000n lamports (0.01 SOL)
+ * convertSol({ sol: 0.1 })             // 100_000_000n lamports (0.1 SOL)
+ * convertSol({ lamports: 10_000_000 }) // 10_000_000n lamports
+ * ```
+ */
+export declare function convertSol(amount: SolParam): bigint;
+//# sourceMappingURL=sol.d.ts.map

package/dist/types/params/sol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sol.d.ts","sourceRoot":"","sources":["../../../src/params/sol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,MAAM,GACN;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AASlC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CA2BnD"}

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

@@ -0,0 +1,56 @@
+/**
+ * Constants used for PDA derivation across SRSLY, SAGE, and Thread programs
+ * @module pda/constants
+ */
+/**
+ * Faction-specific coordinates for starbase derivation in SAGE
+ * These coordinates are used to derive starbase PDAs
+ */
+export declare const FACTION_COORDINATES: Record<string, {
+    x: number;
+    y: number;
+}>;
+/**
+ * Mapping of numeric faction IDs to faction names
+ */
+export declare const FACTION_MAPPING: Record<number, string>;
+/**
+ * Seed constants for SAGE program PDA derivation
+ */
+export declare const STARBASE_SEED = "Starbase";
+export declare const STARBASE_PLAYER_SEED = "starbase_player";
+export declare const SAGE_PLAYER_PROFILE_SEED = "sage_player_profile";
+export declare const PROFILE_FACTION_SEED = "player_faction";
+/**
+ * Seed constants for SRSLY program PDA derivation
+ */
+export declare const CONTRACT_SEED = "rental_contract";
+export declare const RENTAL_SEED = "rental_state";
+export declare const RENTAL_AUTHORITY_SEED = "rental_authority";
+export declare const BORROWER_STATE_SEED = "borrower_state";
+export declare const CONFIG_SEED = "config";
+export declare const ACTIVE_RENTAL_SEED = "active";
+export declare const QUEUED_RENTAL_SEED = "queued";
+/**
+ * Antegen program addresses and seed constants for PDA derivation
+ */
+export declare const ANTEGEN_THREAD_PROGRAM = "AgTv5w1UvUb6zeqkThwMrztGu9hpepBu8YLghuR4dpSx";
+export declare const ANTEGEN_FIBER_PROGRAM = "AgFv5afjW9DmSPkiEvJ1er5bAAmRUqaBeTB6Cr8e1hKx";
+export declare const THREAD_SEED = "thread";
+export declare const THREAD_FIBER_SEED = "thread_fiber";
+/**
+ * Type guard to check if a value is a valid faction name
+ */
+export declare function isValidFactionName(faction: string): faction is 'mud' | 'oni' | 'ustur';
+/**
+ * Get faction name from numeric faction ID
+ */
+export declare function getFactionName(factionId: number): string;
+/**
+ * Get faction coordinates by name
+ */
+export declare function getFactionCoordinates(faction: string): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/pda/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/pda/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAIxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAC/C,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAC3C,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,sBAAsB,iDAAiD,CAAC;AACrF,eAAO,MAAM,qBAAqB,iDAAiD,CAAC;AACpF,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,KAAK,GAAG,KAAK,GAAG,OAAO,CAEtF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAM/E"}

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

@@ -0,0 +1,20 @@
+/**
+ * PDA (Program Derived Address) derivation utilities
+ *
+ * This module provides helper functions for deriving PDAs across multiple Solana programs:
+ * - SRSLY: Contract, rental, borrower state, and config PDAs
+ * - SAGE: Player profiles, starbase, and faction PDAs
+ * - Antegen: Thread PDAs for automated payments
+ * - Token: Associated Token Account (ATA) derivation
+ *
+ * @module pda
+ */
+export { FACTION_COORDINATES, FACTION_MAPPING, STARBASE_SEED, STARBASE_PLAYER_SEED, SAGE_PLAYER_PROFILE_SEED, PROFILE_FACTION_SEED, CONTRACT_SEED, RENTAL_SEED, RENTAL_AUTHORITY_SEED, BORROWER_STATE_SEED, CONFIG_SEED, ACTIVE_RENTAL_SEED, QUEUED_RENTAL_SEED, THREAD_SEED, ANTEGEN_THREAD_PROGRAM, ANTEGEN_FIBER_PROGRAM, isValidFactionName, getFactionName, getFactionCoordinates, } from './constants';
+export { deriveContract, deriveActiveRental, deriveQueuedRental, deriveRentalAuthority, deriveBorrowerState, deriveConfig, } from './srsly';
+export { deriveProfileFaction, deriveSagePlayerProfile, deriveStarbase, deriveStarbasePlayer, deriveGameAccounts, } from './sage';
+export { deriveContractThread, deriveFiber } from './thread';
+export { deriveAssociatedTokenAccount } from './token';
+export { deriveVault } from './slyvault';
+export { deriveLookupTable } from './lookupTable';
+export type { UniversalSigner } from '../utils/signer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pda/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Address Lookup Table (ALT) derivation utilities
+ * @module pda/lookupTable
+ */
+import { Address } from '@solana/kit';
+import { type UniversalSigner } from '../utils/signer';
+/**
+ * Derive an Address Lookup Table (ALT) address
+ *
+ * ALT addresses are deterministically derived from an authority and a recent slot.
+ * The slot is typically obtained from getSlot() RPC call.
+ *
+ * @param authority - The authority that will own the lookup table
+ * @param recentSlot - A recent slot number (from getSlot RPC)
+ * @param altProgramAddress - Optional ALT program address (defaults to mainnet)
+ * @returns The derived lookup table address
+ *
+ * @example
+ * ```typescript
+ * import { deriveLookupTable } from './lookupTable';
+ *
+ * // Get recent slot from RPC
+ * const slot = await rpc.getSlot().send();
+ *
+ * // Derive the lookup table address
+ * const lookupTable = await deriveLookupTable(authorityAddress, slot);
+ * ```
+ */
+export declare function deriveLookupTable(authority: UniversalSigner, recentSlot: bigint | number, altProgramAddress?: UniversalSigner): Promise<Address>;
+//# sourceMappingURL=lookupTable.d.ts.map

package/dist/types/pda/lookupTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookupTable.d.ts","sourceRoot":"","sources":["../../../src/pda/lookupTable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,OAAO,EAA+C,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAmBzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,iBAAiB,CAAC,EAAE,eAAe,GAClC,OAAO,CAAC,OAAO,CAAC,CAclB"}

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

@@ -0,0 +1,70 @@
+/**
+ * PDA derivation functions for SAGE and Profile Faction programs
+ * @module pda/sage
+ */
+import { Address } from '@solana/kit';
+import { type UniversalSigner } from '../utils/signer';
+/**
+ * Derive the profile faction PDA from a profile address
+ * @param profile - The player profile public key
+ * @param programAddress - Optional Profile Faction program address (defaults to network-specific address)
+ * @returns The derived profile faction PDA
+ */
+export declare function deriveProfileFaction(profile: UniversalSigner, programAddress?: UniversalSigner): Promise<Address>;
+/**
+ * Derive the SAGE player profile PDA
+ * @param profile - The player profile public key
+ * @param gameId - The game ID public key
+ * @param programAddress - Optional SAGE program address (defaults to network-specific address)
+ * @returns The derived SAGE player profile PDA
+ */
+export declare function deriveSagePlayerProfile(profile: UniversalSigner, gameId: UniversalSigner, programAddress?: UniversalSigner): Promise<Address>;
+/**
+ * Derive the starbase PDA from faction and game ID
+ * @param faction - Faction name ('mud', 'oni', 'ustur') or faction ID (1, 2, 3)
+ * @param gameId - The game ID public key
+ * @param programAddress - Optional SAGE program address (defaults to network-specific address)
+ * @returns The derived starbase PDA
+ */
+export declare function deriveStarbase(faction: string | number, gameId: UniversalSigner, programAddress?: UniversalSigner): Promise<Address>;
+/**
+ * Derive the starbase player PDA
+ * @param sagePlayerProfile - The SAGE player profile public key
+ * @param starbase - The starbase public key
+ * @param starbaseSeqId - Optional starbase sequence ID (defaults to 0)
+ * @param programAddress - Optional SAGE program address (defaults to network-specific address)
+ * @returns The derived starbase player PDA
+ */
+export declare function deriveStarbasePlayer(sagePlayerProfile: UniversalSigner, starbase: UniversalSigner, starbaseSeqId?: number, programAddress?: UniversalSigner): Promise<Address>;
+/**
+ * Derive all SAGE game accounts at once (convenience function)
+ *
+ * This is a helper that derives all three SAGE-related accounts needed for most operations:
+ * - Profile faction (from Profile Faction program)
+ * - SAGE player profile (from SAGE program)
+ * - Starbase (from SAGE program using faction coordinates)
+ * - Starbase player (from SAGE program)
+ *
+ * @param profile - The player profile public key
+ * @param faction - Faction name ('mud', 'oni', 'ustur') or faction ID (1, 2, 3)
+ * @param gameId - The game ID public key
+ * @param starbaseSeqId - Optional starbase sequence ID (defaults to 0)
+ * @returns Object containing all derived SAGE accounts
+ *
+ * @example
+ * ```typescript
+ * const accounts = await deriveGameAccounts(
+ *   playerProfile,
+ *   'mud',
+ *   gameId
+ * );
+ * // Returns: { profileFaction, sagePlayerProfile, starbase, starbasePlayer }
+ * ```
+ */
+export declare function deriveGameAccounts(profile: UniversalSigner, faction: string | number, gameId: UniversalSigner, starbaseSeqId?: number): Promise<{
+    profileFaction: Address;
+    sagePlayerProfile: Address;
+    starbase: Address;
+    starbasePlayer: Address;
+}>;
+//# sourceMappingURL=sage.d.ts.map

package/dist/types/pda/sage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sage.d.ts","sourceRoot":"","sources":["../../../src/pda/sage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,OAAO,EAA+C,MAAM,aAAa,CAAC;AAE5F,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAoBzE;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,EACxB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,eAAe,EACvB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,eAAe,EACvB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,eAAe,EAClC,QAAQ,EAAE,eAAe,EACzB,aAAa,GAAE,MAAU,EACzB,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,eAAe,EACvB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC;IACT,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC,CAiBD"}