@kadi.build/deploy-ability 0.0.1

package/dist/targets/akash/logs.types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Akash Deployment Log Streaming Types
+ *
+ * Provides type-safe interfaces for streaming container logs from Akash deployments.
+ *
+ * @module targets/akash/logs.types
+ */
+import type { EventEmitter } from 'node:events';
+import type { AkashDeploymentData } from '../../types/index.js';
+import type { WalletContext } from './types.js';
+import type { AkashProviderTlsCertificate } from './types.js';
+import type { Network } from '../../types/common.js';
+/**
+ * Options for streaming deployment logs
+ */
+export interface StreamLogsOptions {
+    /** Deployment data returned from deployToAkash() */
+    readonly deployment: AkashDeploymentData;
+    /** Wallet context (for provider address verification) */
+    readonly wallet: WalletContext;
+    /** Akash certificate (for mTLS authentication) */
+    readonly certificate: AkashProviderTlsCertificate;
+    /** Network (mainnet or testnet) */
+    readonly network: Network;
+    /** Optional: Filter logs by service names (default: all services) */
+    readonly services?: readonly string[];
+    /** Keep connection open and stream new logs (default: true) */
+    readonly follow?: boolean;
+    /** Show last N lines before streaming (default: 100) */
+    readonly tail?: number;
+    /** Optional: Custom logger for debugging */
+    readonly logger?: {
+        readonly debug?: (msg: string) => void;
+        readonly warn?: (msg: string) => void;
+        readonly error?: (msg: string) => void;
+    };
+}
+/**
+ * Options for getting logs as an array (non-streaming)
+ */
+export interface GetLogsOptions extends Omit<StreamLogsOptions, 'follow'> {
+    /** Maximum logs to retrieve (default: 1000) */
+    readonly maxLogs?: number;
+    /** Timeout in milliseconds (default: 30000) */
+    readonly timeout?: number;
+}
+/**
+ * Parsed log entry from Akash provider
+ */
+export interface LogEntry {
+    /** Service name (e.g., "ollama", "vllm") */
+    readonly service: string;
+    /** Log message content */
+    readonly message: string;
+    /** Raw log data from provider */
+    readonly raw: {
+        /** Full service name with replica suffix */
+        readonly name: string;
+        /** Original message before parsing */
+        readonly message: string;
+        /** ISO timestamp from provider */
+        readonly timestamp?: string;
+    };
+    /** When this log was received by deploy-ability */
+    readonly receivedAt: Date;
+}
+/**
+ * Log stream emitter
+ *
+ * Events:
+ * - 'log': Emitted for each log line
+ * - 'connected': WebSocket connection established
+ * - 'error': Connection or parsing error
+ * - 'end': Stream ended (natural or via close())
+ */
+export interface LogStream extends EventEmitter {
+    /** Close the stream and disconnect */
+    close(): void;
+    /** Check if stream is currently connected */
+    isConnected(): boolean;
+    on(event: 'log', listener: (log: LogEntry) => void): this;
+    on(event: 'connected', listener: () => void): this;
+    on(event: 'error', listener: (error: Error) => void): this;
+    on(event: 'end', listener: () => void): this;
+    once(event: 'log', listener: (log: LogEntry) => void): this;
+    once(event: 'connected', listener: () => void): this;
+    once(event: 'error', listener: (error: Error) => void): this;
+    once(event: 'end', listener: () => void): this;
+    off(event: 'log', listener: (log: LogEntry) => void): this;
+    off(event: 'connected', listener: () => void): this;
+    off(event: 'error', listener: (error: Error) => void): this;
+    off(event: 'end', listener: () => void): this;
+}
+/**
+ * Internal raw log message from Akash provider
+ */
+export interface RawProviderLogMessage {
+    readonly name: string;
+    readonly message: string;
+    readonly timestamp?: string;
+}
+//# sourceMappingURL=logs.types.d.ts.map

package/dist/targets/akash/logs.types.d.ts.map

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

package/dist/targets/akash/logs.types.js

@@ -0,0 +1,9 @@
+/**
+ * Akash Deployment Log Streaming Types
+ *
+ * Provides type-safe interfaces for streaming container logs from Akash deployments.
+ *
+ * @module targets/akash/logs.types
+ */
+export {};
+//# sourceMappingURL=logs.types.js.map

package/dist/targets/akash/logs.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.types.js","sourceRoot":"","sources":["../../../src/targets/akash/logs.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/targets/akash/pricing.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Akash Lease Pricing Utilities
+ *
+ * Provides accurate price calculations for Akash Network deployments using the same
+ * formulas as Akash Console. Supports multiple price formats (per block, per hour,
+ * per month) and USD conversion.
+ *
+ * **Price Calculation Background:**
+ *
+ * Akash leases are priced per block on the blockchain. The raw price from the
+ * blockchain is in uAKT (micro AKT, where 1 AKT = 1,000,000 uAKT) per block.
+ *
+ * To make this human-readable, we calculate:
+ * - Price per hour: Based on average blocks per hour
+ * - Price per month: Based on average blocks per month
+ * - Price in USD: Requires current AKT market price
+ *
+ * **Constants (from Akash Console):**
+ * - Average block time: 6.098 seconds
+ * - Average days in month: 30.437 days (365.25 / 12)
+ *
+ * @module targets/akash/pricing
+ */
+/**
+ * Average time between blocks on Akash Network (in seconds)
+ *
+ * This value is determined empirically by observing actual block times.
+ * Akash Console uses 6.098 seconds as the average.
+ *
+ * @see https://github.com/akash-network/console
+ */
+export declare const AVERAGE_BLOCK_TIME_SECONDS = 6.098;
+/**
+ * Average number of days in a month (365.25 / 12)
+ *
+ * Using the astronomical year (365.25 days) divided by 12 months
+ * provides accurate monthly cost estimates.
+ */
+export declare const AVERAGE_DAYS_IN_MONTH = 30.437;
+/**
+ * Conversion factor: 1 AKT = 1,000,000 uAKT
+ */
+export declare const UAKT_PER_AKT = 1000000;
+/**
+ * Lease price information with multiple time periods and currencies
+ *
+ * This class encapsulates all pricing information for an Akash lease and provides
+ * methods to convert between different formats (per block, per hour, per month)
+ * and currencies (uAKT, AKT, USD).
+ *
+ * **Usage Philosophy:**
+ *
+ * The blockchain provides raw price per block in uAKT. This class:
+ * 1. Stores the raw value (immutable)
+ * 2. Pre-computes common formats (per hour, per month)
+ * 3. Provides USD conversion only when caller provides AKT price
+ *
+ * This design keeps deploy-ability pure (no external API dependencies) while
+ * giving callers maximum flexibility in displaying prices.
+ *
+ * @example Basic usage - uAKT prices
+ * ```typescript
+ * const price = new LeasePrice({ denom: 'uakt', amount: '1234' });
+ *
+ * console.log(price.uakt.perBlock);  // 1234
+ * console.log(price.uakt.perHour);   // ~720,000
+ * console.log(price.uakt.perMonth);  // ~522,000,000
+ * ```
+ *
+ * @example USD conversion
+ * ```typescript
+ * const price = new LeasePrice({ denom: 'uakt', amount: '1234' });
+ *
+ * // Fetch current AKT price from your preferred source
+ * const aktPrice = 0.50; // $0.50 per AKT
+ *
+ * const usd = price.toUSD(aktPrice);
+ * console.log(`$${usd.perMonth.toFixed(2)}/month`);  // "$0.26/month"
+ * console.log(`$${usd.perHour.toFixed(4)}/hour`);    // "$0.0004/hour"
+ * ```
+ *
+ * @example Displaying in kadi-deploy CLI
+ * ```typescript
+ * const result = await deployToAkash({ ... });
+ *
+ * if (result.success) {
+ *   const { leasePrice } = result.data;
+ *
+ *   // Fetch AKT price
+ *   const aktPrice = await fetchAktPriceFromCoinGecko();
+ *   const usd = leasePrice.toUSD(aktPrice);
+ *
+ *   logger.log('Lease Pricing:');
+ *   logger.log(`  ${leasePrice.uakt.perMonth} uAKT/month ($${usd.perMonth.toFixed(2)}/month)`);
+ *   logger.log(`  ${leasePrice.uakt.perHour} uAKT/hour ($${usd.perHour.toFixed(4)}/hour)`);
+ *   logger.log(`  ${leasePrice.perBlock.amount} uAKT/block ($${usd.perBlock.toFixed(6)}/block)`);
+ * }
+ * ```
+ */
+export declare class LeasePrice {
+    /**
+     * Raw price from blockchain (per block)
+     *
+     * This is the authoritative source - all other prices are computed from this.
+     */
+    readonly perBlock: {
+        readonly denom: string;
+        readonly amount: string;
+    };
+    /**
+     * Pre-computed prices in uAKT for different time periods
+     *
+     * All values are in micro AKT (uAKT). To convert to AKT, divide by 1,000,000.
+     */
+    readonly uakt: {
+        /** Price in uAKT per block (same as perBlock.amount, but as number) */
+        readonly perBlock: number;
+        /** Price in uAKT per hour */
+        readonly perHour: number;
+        /** Price in uAKT per month (30.437 days) */
+        readonly perMonth: number;
+    };
+    /**
+     * Pre-computed prices in AKT (1 AKT = 1,000,000 uAKT)
+     *
+     * Convenient for display without manual conversion.
+     */
+    readonly akt: {
+        /** Price in AKT per block */
+        readonly perBlock: number;
+        /** Price in AKT per hour */
+        readonly perHour: number;
+        /** Price in AKT per month */
+        readonly perMonth: number;
+    };
+    /**
+     * Create a LeasePrice instance from blockchain price data
+     *
+     * @param price - Price object from blockchain query
+     * @param price.denom - Denomination (typically "uakt")
+     * @param price.amount - Amount per block as string
+     *
+     * @example
+     * ```typescript
+     * const price = new LeasePrice({
+     *   denom: 'uakt',
+     *   amount: '1234'
+     * });
+     * ```
+     */
+    constructor(price: {
+        denom: string;
+        amount: string;
+    });
+    /**
+     * Convert prices to USD using current AKT market price
+     *
+     * **Important:** This method requires you to provide the current AKT price.
+     * deploy-ability does not fetch market data to remain pure and dependency-free.
+     *
+     * **Where to get AKT price:**
+     * - CoinGecko API: https://api.coingecko.com/api/v3/simple/price?ids=akash-network&vs_currencies=usd
+     * - Your own price oracle
+     * - Akash Console API (if available)
+     * - Cached/hardcoded value for estimates
+     *
+     * @param aktPriceUSD - Current price of 1 AKT in USD
+     * @returns Prices in USD for different time periods
+     *
+     * @example Fetch from CoinGecko
+     * ```typescript
+     * const aktPrice = await fetch(
+     *   'https://api.coingecko.com/api/v3/simple/price?ids=akash-network&vs_currencies=usd'
+     * )
+     *   .then(r => r.json())
+     *   .then(data => data['akash-network'].usd);
+     *
+     * const usdPricing = leasePrice.toUSD(aktPrice);
+     * console.log(`Cost: $${usdPricing.perMonth.toFixed(2)}/month`);
+     * ```
+     *
+     * @example Use hardcoded estimate
+     * ```typescript
+     * // For quick estimates (update periodically)
+     * const aktPrice = 0.50; // $0.50 per AKT
+     * const usdPricing = leasePrice.toUSD(aktPrice);
+     * ```
+     */
+    toUSD(aktPriceUSD: number): {
+        readonly perBlock: number;
+        readonly perHour: number;
+        readonly perMonth: number;
+    };
+    /**
+     * Get a formatted summary of all pricing information
+     *
+     * Useful for logging or debugging. Returns a plain object with all computed prices.
+     *
+     * @returns Complete pricing breakdown
+     *
+     * @example
+     * ```typescript
+     * console.log(leasePrice.toJSON());
+     * // {
+     * //   perBlock: { denom: 'uakt', amount: '1234' },
+     * //   uakt: { perBlock: 1234, perHour: 729234, perMonth: 522456789 },
+     * //   akt: { perBlock: 0.001234, perHour: 0.729234, perMonth: 522.456789 }
+     * // }
+     * ```
+     */
+    toJSON(): {
+        perBlock: {
+            readonly denom: string;
+            readonly amount: string;
+        };
+        uakt: {
+            /** Price in uAKT per block (same as perBlock.amount, but as number) */
+            readonly perBlock: number;
+            /** Price in uAKT per hour */
+            readonly perHour: number;
+            /** Price in uAKT per month (30.437 days) */
+            readonly perMonth: number;
+        };
+        akt: {
+            /** Price in AKT per block */
+            readonly perBlock: number;
+            /** Price in AKT per hour */
+            readonly perHour: number;
+            /** Price in AKT per month */
+            readonly perMonth: number;
+        };
+    };
+    /**
+     * Create LeasePrice from uAKT amount (convenience method)
+     *
+     * @param amountUakt - Price per block in uAKT
+     * @returns New LeasePrice instance
+     *
+     * @example
+     * ```typescript
+     * const price = LeasePrice.fromUakt(1234);
+     * // Equivalent to: new LeasePrice({ denom: 'uakt', amount: '1234' })
+     * ```
+     */
+    static fromUakt(amountUakt: number): LeasePrice;
+}
+//# sourceMappingURL=pricing.d.ts.map

package/dist/targets/akash/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../../src/targets/akash/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,YAAY,UAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,qBAAa,UAAU;IACrB;;;;OAIG;IACH,SAAgB,QAAQ,EAAE;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF;;;;OAIG;IACH,SAAgB,IAAI,EAAE;QACpB,uEAAuE;QACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,6BAA6B;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,4CAA4C;QAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IAEF;;;;OAIG;IACH,SAAgB,GAAG,EAAE;QACnB,6BAA6B;QAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,4BAA4B;QAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,6BAA6B;QAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IAEF;;;;;;;;;;;;;;OAcG;gBACS,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAkCpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B;IASD;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM;;4BAjJY,MAAM;6BACL,MAAM;;;YASvB,uEAAuE;+BACpD,MAAM;YACzB,6BAA6B;8BACX,MAAM;YACxB,4CAA4C;+BACzB,MAAM;;;YASzB,6BAA6B;+BACV,MAAM;YACzB,4BAA4B;8BACV,MAAM;YACxB,6BAA6B;+BACV,MAAM;;;IA4H3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU;CAMhD"}

package/dist/targets/akash/pricing.js

@@ -0,0 +1,246 @@
+/**
+ * Akash Lease Pricing Utilities
+ *
+ * Provides accurate price calculations for Akash Network deployments using the same
+ * formulas as Akash Console. Supports multiple price formats (per block, per hour,
+ * per month) and USD conversion.
+ *
+ * **Price Calculation Background:**
+ *
+ * Akash leases are priced per block on the blockchain. The raw price from the
+ * blockchain is in uAKT (micro AKT, where 1 AKT = 1,000,000 uAKT) per block.
+ *
+ * To make this human-readable, we calculate:
+ * - Price per hour: Based on average blocks per hour
+ * - Price per month: Based on average blocks per month
+ * - Price in USD: Requires current AKT market price
+ *
+ * **Constants (from Akash Console):**
+ * - Average block time: 6.098 seconds
+ * - Average days in month: 30.437 days (365.25 / 12)
+ *
+ * @module targets/akash/pricing
+ */
+/**
+ * Average time between blocks on Akash Network (in seconds)
+ *
+ * This value is determined empirically by observing actual block times.
+ * Akash Console uses 6.098 seconds as the average.
+ *
+ * @see https://github.com/akash-network/console
+ */
+export const AVERAGE_BLOCK_TIME_SECONDS = 6.098;
+/**
+ * Average number of days in a month (365.25 / 12)
+ *
+ * Using the astronomical year (365.25 days) divided by 12 months
+ * provides accurate monthly cost estimates.
+ */
+export const AVERAGE_DAYS_IN_MONTH = 30.437;
+/**
+ * Conversion factor: 1 AKT = 1,000,000 uAKT
+ */
+export const UAKT_PER_AKT = 1_000_000;
+/**
+ * Lease price information with multiple time periods and currencies
+ *
+ * This class encapsulates all pricing information for an Akash lease and provides
+ * methods to convert between different formats (per block, per hour, per month)
+ * and currencies (uAKT, AKT, USD).
+ *
+ * **Usage Philosophy:**
+ *
+ * The blockchain provides raw price per block in uAKT. This class:
+ * 1. Stores the raw value (immutable)
+ * 2. Pre-computes common formats (per hour, per month)
+ * 3. Provides USD conversion only when caller provides AKT price
+ *
+ * This design keeps deploy-ability pure (no external API dependencies) while
+ * giving callers maximum flexibility in displaying prices.
+ *
+ * @example Basic usage - uAKT prices
+ * ```typescript
+ * const price = new LeasePrice({ denom: 'uakt', amount: '1234' });
+ *
+ * console.log(price.uakt.perBlock);  // 1234
+ * console.log(price.uakt.perHour);   // ~720,000
+ * console.log(price.uakt.perMonth);  // ~522,000,000
+ * ```
+ *
+ * @example USD conversion
+ * ```typescript
+ * const price = new LeasePrice({ denom: 'uakt', amount: '1234' });
+ *
+ * // Fetch current AKT price from your preferred source
+ * const aktPrice = 0.50; // $0.50 per AKT
+ *
+ * const usd = price.toUSD(aktPrice);
+ * console.log(`$${usd.perMonth.toFixed(2)}/month`);  // "$0.26/month"
+ * console.log(`$${usd.perHour.toFixed(4)}/hour`);    // "$0.0004/hour"
+ * ```
+ *
+ * @example Displaying in kadi-deploy CLI
+ * ```typescript
+ * const result = await deployToAkash({ ... });
+ *
+ * if (result.success) {
+ *   const { leasePrice } = result.data;
+ *
+ *   // Fetch AKT price
+ *   const aktPrice = await fetchAktPriceFromCoinGecko();
+ *   const usd = leasePrice.toUSD(aktPrice);
+ *
+ *   logger.log('Lease Pricing:');
+ *   logger.log(`  ${leasePrice.uakt.perMonth} uAKT/month ($${usd.perMonth.toFixed(2)}/month)`);
+ *   logger.log(`  ${leasePrice.uakt.perHour} uAKT/hour ($${usd.perHour.toFixed(4)}/hour)`);
+ *   logger.log(`  ${leasePrice.perBlock.amount} uAKT/block ($${usd.perBlock.toFixed(6)}/block)`);
+ * }
+ * ```
+ */
+export class LeasePrice {
+    /**
+     * Raw price from blockchain (per block)
+     *
+     * This is the authoritative source - all other prices are computed from this.
+     */
+    perBlock;
+    /**
+     * Pre-computed prices in uAKT for different time periods
+     *
+     * All values are in micro AKT (uAKT). To convert to AKT, divide by 1,000,000.
+     */
+    uakt;
+    /**
+     * Pre-computed prices in AKT (1 AKT = 1,000,000 uAKT)
+     *
+     * Convenient for display without manual conversion.
+     */
+    akt;
+    /**
+     * Create a LeasePrice instance from blockchain price data
+     *
+     * @param price - Price object from blockchain query
+     * @param price.denom - Denomination (typically "uakt")
+     * @param price.amount - Amount per block as string
+     *
+     * @example
+     * ```typescript
+     * const price = new LeasePrice({
+     *   denom: 'uakt',
+     *   amount: '1234'
+     * });
+     * ```
+     */
+    constructor(price) {
+        // Store raw blockchain price
+        this.perBlock = {
+            denom: price.denom,
+            amount: price.amount,
+        };
+        // Parse amount to number for calculations
+        const pricePerBlock = parseFloat(price.amount);
+        // Calculate blocks per hour
+        // 60 seconds/minute * 60 minutes/hour / 6.098 seconds/block = ~590.8 blocks/hour
+        const blocksPerHour = (60 * 60) / AVERAGE_BLOCK_TIME_SECONDS;
+        // Calculate blocks per month
+        // 30.437 days/month * 24 hours/day * 60 minutes/hour * 60 seconds/minute / 6.098 seconds/block
+        const blocksPerMonth = (AVERAGE_DAYS_IN_MONTH * 24 * 60 * 60) / AVERAGE_BLOCK_TIME_SECONDS;
+        // Pre-compute uAKT prices
+        this.uakt = {
+            perBlock: pricePerBlock,
+            perHour: pricePerBlock * blocksPerHour,
+            perMonth: pricePerBlock * blocksPerMonth,
+        };
+        // Pre-compute AKT prices (divide uAKT by 1,000,000)
+        this.akt = {
+            perBlock: pricePerBlock / UAKT_PER_AKT,
+            perHour: this.uakt.perHour / UAKT_PER_AKT,
+            perMonth: this.uakt.perMonth / UAKT_PER_AKT,
+        };
+    }
+    /**
+     * Convert prices to USD using current AKT market price
+     *
+     * **Important:** This method requires you to provide the current AKT price.
+     * deploy-ability does not fetch market data to remain pure and dependency-free.
+     *
+     * **Where to get AKT price:**
+     * - CoinGecko API: https://api.coingecko.com/api/v3/simple/price?ids=akash-network&vs_currencies=usd
+     * - Your own price oracle
+     * - Akash Console API (if available)
+     * - Cached/hardcoded value for estimates
+     *
+     * @param aktPriceUSD - Current price of 1 AKT in USD
+     * @returns Prices in USD for different time periods
+     *
+     * @example Fetch from CoinGecko
+     * ```typescript
+     * const aktPrice = await fetch(
+     *   'https://api.coingecko.com/api/v3/simple/price?ids=akash-network&vs_currencies=usd'
+     * )
+     *   .then(r => r.json())
+     *   .then(data => data['akash-network'].usd);
+     *
+     * const usdPricing = leasePrice.toUSD(aktPrice);
+     * console.log(`Cost: $${usdPricing.perMonth.toFixed(2)}/month`);
+     * ```
+     *
+     * @example Use hardcoded estimate
+     * ```typescript
+     * // For quick estimates (update periodically)
+     * const aktPrice = 0.50; // $0.50 per AKT
+     * const usdPricing = leasePrice.toUSD(aktPrice);
+     * ```
+     */
+    toUSD(aktPriceUSD) {
+        // Convert AKT prices to USD by multiplying by AKT price
+        return {
+            perBlock: this.akt.perBlock * aktPriceUSD,
+            perHour: this.akt.perHour * aktPriceUSD,
+            perMonth: this.akt.perMonth * aktPriceUSD,
+        };
+    }
+    /**
+     * Get a formatted summary of all pricing information
+     *
+     * Useful for logging or debugging. Returns a plain object with all computed prices.
+     *
+     * @returns Complete pricing breakdown
+     *
+     * @example
+     * ```typescript
+     * console.log(leasePrice.toJSON());
+     * // {
+     * //   perBlock: { denom: 'uakt', amount: '1234' },
+     * //   uakt: { perBlock: 1234, perHour: 729234, perMonth: 522456789 },
+     * //   akt: { perBlock: 0.001234, perHour: 0.729234, perMonth: 522.456789 }
+     * // }
+     * ```
+     */
+    toJSON() {
+        return {
+            perBlock: this.perBlock,
+            uakt: this.uakt,
+            akt: this.akt,
+        };
+    }
+    /**
+     * Create LeasePrice from uAKT amount (convenience method)
+     *
+     * @param amountUakt - Price per block in uAKT
+     * @returns New LeasePrice instance
+     *
+     * @example
+     * ```typescript
+     * const price = LeasePrice.fromUakt(1234);
+     * // Equivalent to: new LeasePrice({ denom: 'uakt', amount: '1234' })
+     * ```
+     */
+    static fromUakt(amountUakt) {
+        return new LeasePrice({
+            denom: 'uakt',
+            amount: String(amountUakt),
+        });
+    }
+}
+//# sourceMappingURL=pricing.js.map

package/dist/targets/akash/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../../src/targets/akash/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,OAAO,UAAU;IACrB;;;;OAIG;IACa,QAAQ,CAGtB;IAEF;;;;OAIG;IACa,IAAI,CAOlB;IAEF;;;;OAIG;IACa,GAAG,CAOjB;IAEF;;;;;;;;;;;;;;OAcG;IACH,YAAY,KAAwC;QAClD,6BAA6B;QAC7B,IAAI,CAAC,QAAQ,GAAG;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;QAEF,0CAA0C;QAC1C,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE/C,4BAA4B;QAC5B,iFAAiF;QACjF,MAAM,aAAa,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,0BAA0B,CAAC;QAE7D,6BAA6B;QAC7B,+FAA+F;QAC/F,MAAM,cAAc,GAClB,CAAC,qBAAqB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,0BAA0B,CAAC;QAEtE,0BAA0B;QAC1B,IAAI,CAAC,IAAI,GAAG;YACV,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,aAAa,GAAG,aAAa;YACtC,QAAQ,EAAE,aAAa,GAAG,cAAc;SACzC,CAAC;QAEF,oDAAoD;QACpD,IAAI,CAAC,GAAG,GAAG;YACT,QAAQ,EAAE,aAAa,GAAG,YAAY;YACtC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,YAAY;YACzC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,YAAY;SAC5C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,WAAmB;QAKvB,wDAAwD;QACxD,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,WAAW;YACzC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,WAAW;YACvC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,WAAW;SAC1C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM;QACJ,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAkB;QAChC,OAAO,IAAI,UAAU,CAAC;YACpB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;CACF"}