@kadi.build/deploy-ability 0.0.3 → 0.0.5

package/dist/targets/akash/provider-metadata.d.ts

@@ -1,228 +0,0 @@
-/**
- * Provider Metadata Types
- *
- * Type definitions for Akash Network provider information including
- * location, reliability metrics, and general provider details.
- *
- * These types are used to enrich bid information so developers can make
- * informed decisions about which provider to choose based on uptime,
- * location, audit status, and other factors.
- *
- * @module targets/akash/provider-metadata
- */
-/**
- * Geographic location information for a provider
- *
- * Provides detailed location data to help developers choose providers
- * based on geographic proximity, regulatory requirements, or latency needs.
- *
- * Location data typically comes from IP geolocation services and may not
- * always be 100% accurate, but is generally reliable for country/region.
- *
- * @example Provider in California, USA
- * ```typescript
- * {
- *   region: "California",
- *   regionCode: "CA",
- *   country: "United States",
- *   countryCode: "US",
- *   latitude: "37.7749",
- *   longitude: "-122.4194"
- * }
- * ```
- */
-export interface ProviderLocation {
-    /**
-     * Full name of the region/state
-     * @example "California", "Tokyo", "Bavaria"
-     */
-    readonly region: string;
-    /**
-     * Short code for the region/state
-     * @example "CA", "13" (Tokyo), "BY" (Bavaria)
-     */
-    readonly regionCode: string;
-    /**
-     * Full name of the country
-     * @example "United States", "Japan", "Germany"
-     */
-    readonly country: string;
-    /**
-     * ISO 3166-1 alpha-2 country code
-     * @example "US", "JP", "DE"
-     */
-    readonly countryCode: string;
-    /**
-     * Latitude coordinate (optional)
-     * @example "37.7749"
-     */
-    readonly latitude?: string;
-    /**
-     * Longitude coordinate (optional)
-     * @example "-122.4194"
-     */
-    readonly longitude?: string;
-}
-/**
- * Provider reliability and uptime metrics
- *
- * Tracks provider availability over different time periods. Uptime values
- * are percentages expressed as decimals (0.0 to 1.0).
- *
- * These metrics are calculated by the Akash indexer which periodically
- * checks provider availability. A provider is considered "online" if its
- * status endpoint responds successfully.
- *
- * **Important**: Not all providers may have reliability data, especially
- * newly registered providers. Always check if reliability data exists
- * before using it in selection logic.
- *
- * @example High reliability provider
- * ```typescript
- * {
- *   uptime1d: 1.0,      // 100% uptime in last day
- *   uptime7d: 0.9987,   // 99.87% uptime in last 7 days
- *   uptime30d: 0.9954,  // 99.54% uptime in last 30 days
- *   isOnline: true,
- *   lastCheckDate: new Date("2025-10-15T10:30:00Z")
- * }
- * ```
- */
-export interface ProviderReliability {
-    /**
-     * Uptime percentage for the last 1 day
-     * Range: 0.0 (0%) to 1.0 (100%)
-     */
-    readonly uptime1d: number;
-    /**
-     * Uptime percentage for the last 7 days
-     * Range: 0.0 (0%) to 1.0 (100%)
-     */
-    readonly uptime7d: number;
-    /**
-     * Uptime percentage for the last 30 days
-     * Range: 0.0 (0%) to 1.0 (100%)
-     */
-    readonly uptime30d: number;
-    /**
-     * Whether the provider is currently online
-     *
-     * Based on the most recent status check. A provider is online if
-     * its status endpoint responded successfully to the last ping.
-     */
-    readonly isOnline: boolean;
-    /**
-     * Timestamp of the last uptime check (optional)
-     *
-     * Useful for understanding how fresh the reliability data is.
-     */
-    readonly lastCheckDate?: Date;
-}
-/**
- * Complete provider information
- *
- * Aggregates all available information about an Akash provider including
- * identity, location, reliability, and audit status.
- *
- * This is the primary interface for representing provider data throughout
- * the deployment process. Not all fields will be present for all providers
- * (e.g., some may not have location data, or may be too new to have
- * reliability metrics).
- *
- * **Provider Auditing:**
- * Audited providers have been verified by recognized community auditors
- * (like Overclock Labs) to meet certain standards for hardware, uptime,
- * and operational practices. Audited status generally indicates higher
- * reliability but also potentially higher prices.
- *
- * @example Complete provider info
- * ```typescript
- * {
- *   owner: "akash1...",
- *   hostUri: "https://provider.europlots.com:8443",
- *   name: "Europlots Provider",
- *   email: "support@europlots.com",
- *   website: "https://europlots.com",
- *   isAudited: true,
- *   location: {
- *     region: "Frankfurt",
- *     regionCode: "HE",
- *     country: "Germany",
- *     countryCode: "DE"
- *   },
- *   reliability: {
- *     uptime1d: 1.0,
- *     uptime7d: 0.998,
- *     uptime30d: 0.995,
- *     isOnline: true
- *   },
- *   akashVersion: "0.6.0"
- * }
- * ```
- */
-export interface ProviderInfo {
-    /**
-     * Provider's Akash account address (owner)
-     *
-     * This is the unique blockchain identifier for the provider.
-     * @example "akash1..."
-     */
-    readonly owner: string;
-    /**
-     * Provider's API endpoint (host URI)
-     *
-     * This is the HTTPS endpoint where the provider's API is accessible.
-     * Used for sending manifests and querying deployment status.
-     * @example "https://provider.europlots.com:8443"
-     */
-    readonly hostUri: string;
-    /**
-     * Human-readable provider name (optional)
-     *
-     * A friendly name for the provider, if registered.
-     * @example "Europlots Provider", "Akash Cloud Services"
-     */
-    readonly name?: string;
-    /**
-     * Provider contact email (optional)
-     * @example "support@provider.com"
-     */
-    readonly email?: string;
-    /**
-     * Provider website URL (optional)
-     * @example "https://provider.com"
-     */
-    readonly website?: string;
-    /**
-     * Whether the provider is audited by a recognized auditor
-     *
-     * Audited providers have been verified to meet community standards
-     * for hardware quality, uptime, and operational practices.
-     */
-    readonly isAudited: boolean;
-    /**
-     * Geographic location information (optional)
-     *
-     * May not be available for all providers, especially those using VPNs
-     * or privacy-focused infrastructure.
-     */
-    readonly location?: ProviderLocation;
-    /**
-     * Reliability and uptime metrics (optional)
-     *
-     * May not be available for newly registered providers or if the
-     * indexer hasn't collected enough data yet.
-     */
-    readonly reliability?: ProviderReliability;
-    /**
-     * Akash provider software version (optional)
-     * @example "0.6.0", "0.5.5"
-     */
-    readonly akashVersion?: string;
-    /**
-     * Cosmos SDK version the provider is running (optional)
-     * @example "0.47.5"
-     */
-    readonly cosmosSdkVersion?: string;
-}
-//# sourceMappingURL=provider-metadata.d.ts.map

package/dist/targets/akash/provider-metadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider-metadata.d.ts","sourceRoot":"","sources":["../../../src/targets/akash/provider-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAErC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAE3C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC"}

package/dist/targets/akash/provider-metadata.js

@@ -1,14 +0,0 @@
-/**
- * Provider Metadata Types
- *
- * Type definitions for Akash Network provider information including
- * location, reliability metrics, and general provider details.
- *
- * These types are used to enrich bid information so developers can make
- * informed decisions about which provider to choose based on uptime,
- * location, audit status, and other factors.
- *
- * @module targets/akash/provider-metadata
- */
-export {};
-//# sourceMappingURL=provider-metadata.js.map

package/dist/targets/akash/provider-metadata.js.map

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

package/dist/targets/akash/provider-service.d.ts

@@ -1,133 +0,0 @@
-/**
- * Provider Metadata Service
- *
- * Service for fetching enhanced provider information including reliability
- * metrics, location data, and audit status. Supports both Akash Console API
- * and direct blockchain queries.
- *
- * **Data Sources:**
- *
- * 1. **Akash Console API** (Primary) - Provides rich metadata:
- *    - Uptime/reliability metrics (1d, 7d, 30d)
- *    - Geographic location (IP geolocation)
- *    - Audit status and auditor information
- *    - Provider version information
- *
- * 2. **Blockchain Query** (Fallback) - Basic provider data:
- *    - Owner address
- *    - Host URI
- *    - Provider attributes
- *
- * This service tries the Console API first for complete data, and falls back
- * to blockchain-only data if the API is unavailable.
- *
- * @module targets/akash/provider-service
- */
-import { DeploymentError } from '../../errors/index.js';
-import type { Result } from '../../types/index.js';
-import type { AkashNetwork } from './environment.js';
-import type { ProviderInfo } from './provider-metadata.js';
-/**
- * Fetch ALL providers with metadata from Console API
- *
- * Fetches the complete list of providers from the Akash Console API.
- * This is the preferred method as it gets all provider data in a single
- * API call, matching how the web console works.
- *
- * **Performance:**
- * - Single API call for all providers (fast)
- * - Returns complete metadata for all providers
- * - Can be cached and reused across multiple bid queries
- *
- * **Data Included:**
- * - Provider identity (name, owner, hostUri)
- * - Reliability metrics (uptime1d, uptime7d, uptime30d, isOnline)
- * - Geographic location (country, region, coordinates)
- * - Audit status and version information
- *
- * @param network - Akash network (mainnet/testnet)
- * @returns Result with map of provider address to provider info
- *
- * @example Fetch all providers
- * ```typescript
- * const result = await fetchAllProviders('mainnet');
- * if (result.success) {
- *   const providers = result.data;
- *   console.log(`Loaded ${providers.size} providers`);
- *
- *   // Look up a specific provider
- *   const provider = providers.get('akash1...');
- *   if (provider) {
- *     console.log('Uptime:', provider.reliability?.uptime7d);
- *   }
- * }
- * ```
- */
-export declare function fetchAllProviders(network: AkashNetwork): Promise<Result<Map<string, ProviderInfo>, DeploymentError>>;
-/**
- * Fetch provider information with enriched metadata
- *
- * Attempts to fetch complete provider information from the Akash Console API,
- * falling back to blockchain-only data if the API is unavailable.
- *
- * **DEPRECATED:** Use `fetchAllProviders()` instead for better performance.
- * This function makes individual API calls per provider, while `fetchAllProviders()`
- * gets all providers in a single call.
- *
- * **Data Quality:**
- * - Console API: Complete data with reliability metrics and location
- * - Blockchain fallback: Basic identity only (owner, hostUri)
- *
- * **Reliability:**
- * The Console API may be temporarily unavailable during maintenance or
- * network issues. The fallback ensures deployment can continue even without
- * enhanced metadata, though bid selection will have less information.
- *
- * @param network - Akash network (mainnet/testnet)
- * @param providerAddress - Provider's blockchain address
- * @returns Result with complete provider information
- *
- * @example Fetch single provider
- * ```typescript
- * const result = await fetchProviderInfo('mainnet', 'akash1...');
- * if (result.success) {
- *   const provider = result.data;
- *   console.log('Provider:', provider.name || provider.owner);
- *   if (provider.reliability) {
- *     console.log('Uptime (7d):', (provider.reliability.uptime7d * 100).toFixed(1) + '%');
- *   }
- * }
- * ```
- */
-export declare function fetchProviderInfo(network: AkashNetwork, providerAddress: string): Promise<Result<ProviderInfo, DeploymentError>>;
-/**
- * Fetch multiple providers in batch for efficiency
- *
- * Fetches provider information for multiple providers in parallel.
- * This is more efficient than calling `fetchProviderInfo` sequentially
- * when processing multiple bids.
- *
- * **Behavior:**
- * - Fetches all providers in parallel
- * - Failed fetches return minimal provider info (owner + hostUri)
- * - Never fails entirely - partial data is acceptable
- *
- * @param network - Akash network (mainnet/testnet)
- * @param providerAddresses - Array of provider addresses to fetch
- * @returns Result with map of provider address to provider info
- *
- * @example Fetch multiple providers
- * ```typescript
- * const addresses = ['akash1...', 'akash2...', 'akash3...'];
- * const result = await fetchProviderInfoBatch('mainnet', addresses);
- *
- * if (result.success) {
- *   const providers = result.data;
- *   for (const [address, info] of providers) {
- *     console.log(address, ':', info.name || 'Unknown');
- *   }
- * }
- * ```
- */
-export declare function fetchProviderInfoBatch(network: AkashNetwork, providerAddresses: string[]): Promise<Result<Map<string, ProviderInfo>, DeploymentError>>;
-//# sourceMappingURL=provider-service.d.ts.map

package/dist/targets/akash/provider-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider-service.d.ts","sourceRoot":"","sources":["../../../src/targets/akash/provider-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,wBAAwB,CAAC;AAgChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,eAAe,CAAC,CAAC,CAwG7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAsBhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EACrB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,eAAe,CAAC,CAAC,CAuC7D"}