@kadi.build/deploy-ability 0.0.1

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

@@ -0,0 +1,114 @@
+/**
+ * Akash Provider Client Utilities
+ *
+ * This module contains helper functions for interacting with Akash providers
+ * over HTTPS after a lease has been created on-chain. Responsibilities include:
+ *
+ * 1. Delivering the deployment manifest to the selected provider via mTLS
+ * 2. Querying provider status endpoints to monitor container readiness
+ *
+ * Design principles:
+ * - All operations return Result<T, DeploymentError> for explicit error handling
+ * - No `any` usage – every response is normalised into typed objects
+ * - Verbose comments explaining each stage for maintainability
+ *
+ * @module targets/akash/provider-client
+ */
+import type { Result } from '../../types/index.js';
+import { ProviderError } from '../../errors/index.js';
+import type { AkashProviderTlsCertificate } from './types.js';
+/**
+ * Minimal lease identifier required for provider API operations
+ */
+export interface LeaseReference {
+    /** Deployment sequence number */
+    readonly dseq: string | number;
+    /** Group sequence number */
+    readonly gseq: number;
+    /** Order sequence number */
+    readonly oseq: number;
+}
+/**
+ * Options for manifest delivery
+ */
+export interface ManifestDeliveryOptions {
+    /** Provider HTTPS endpoint (e.g., https://provider.example.com:8443) */
+    readonly providerUri: string;
+    /** Lease reference identifying the deployment */
+    readonly lease: LeaseReference;
+    /** SDL manifest encoded as JSON (sorted output from akashjs) */
+    readonly manifest: string;
+    /** Certificate bundle for mutual TLS authentication */
+    readonly certificate: AkashProviderTlsCertificate;
+    /** Request timeout in milliseconds (default: 30s) */
+    readonly timeoutMs?: number;
+}
+/**
+ * Status information for a single service reported by the provider
+ */
+export interface ProviderServiceStatus {
+    readonly name: string;
+    readonly available: number;
+    readonly total: number;
+    readonly ready: number;
+    readonly uris: readonly string[];
+}
+/**
+ * Forwarded port definition (useful when provider maps ports externally)
+ */
+export interface ProviderForwardedPort {
+    readonly port: number;
+    readonly externalPort: number;
+    readonly host: string;
+    readonly available: number;
+}
+/**
+ * Assigned IP metadata reported by provider
+ */
+export interface ProviderAssignedIp {
+    readonly ip: string;
+    readonly port: number;
+    readonly externalPort: number;
+    readonly protocol: string;
+}
+/**
+ * Normalised provider lease status response
+ */
+export interface ProviderLeaseStatus {
+    readonly services: Readonly<Record<string, ProviderServiceStatus>>;
+    readonly forwardedPorts?: Readonly<Record<string, readonly ProviderForwardedPort[]>>;
+    readonly assignedIps?: Readonly<Record<string, readonly ProviderAssignedIp[]>>;
+}
+/**
+ * Options for querying provider container status
+ */
+export interface ProviderStatusOptions {
+    readonly providerUri: string;
+    readonly lease: LeaseReference;
+    readonly certificate: AkashProviderTlsCertificate;
+    readonly timeoutMs?: number;
+}
+/**
+ * Sends the deployment manifest to the provider over mTLS.
+ *
+ * The provider uses this manifest to start containers for the newly created lease.
+ * The workflow mirrors the steps outlined in the Akash Console deployment flow.
+ *
+ * Steps performed:
+ * 1. Validate and normalise the provider URI (must be HTTPS)
+ * 2. Construct the manifest delivery path `/deployment/{dseq}/manifest`
+ * 3. Send a PUT request with the manifest JSON using mutual TLS authentication
+ * 4. Resolve with a success Result when the provider accepts the manifest
+ *
+ * @param options - Manifest delivery configuration
+ * @returns Result signalling success or a ProviderError on failure
+ */
+export declare function sendManifestToProvider(options: ManifestDeliveryOptions): Promise<Result<void, ProviderError>>;
+/**
+ * Queries the provider status endpoint for container readiness information.
+ *
+ * @param options - Provider status request configuration
+ * @returns Result containing normalised provider status data
+ */
+export declare function fetchProviderLeaseStatus(options: ProviderStatusOptions): Promise<Result<ProviderLeaseStatus, ProviderError>>;
+//# sourceMappingURL=provider-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-client.d.ts","sourceRoot":"","sources":["../../../src/targets/akash/provider-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,aAAa,EAId,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC,CAAC,CAAC;IACrF,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAAC,CAAC;CAChF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAyCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CA4FtC;AAmKD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC,CAmDrD"}

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

@@ -0,0 +1,318 @@
+/**
+ * Akash Provider Client Utilities
+ *
+ * This module contains helper functions for interacting with Akash providers
+ * over HTTPS after a lease has been created on-chain. Responsibilities include:
+ *
+ * 1. Delivering the deployment manifest to the selected provider via mTLS
+ * 2. Querying provider status endpoints to monitor container readiness
+ *
+ * Design principles:
+ * - All operations return Result<T, DeploymentError> for explicit error handling
+ * - No `any` usage – every response is normalised into typed objects
+ * - Verbose comments explaining each stage for maintainability
+ *
+ * @module targets/akash/provider-client
+ */
+import https from 'node:https';
+import { URL } from 'node:url';
+import axios from 'axios';
+import { success, failure } from '../../types/index.js';
+import { ProviderError, ProviderErrorCodes, providerUnreachableError, manifestRejectedError, } from '../../errors/index.js';
+/**
+ * Normalises a provider URI string and ensures it uses HTTPS.
+ */
+function normaliseProviderUri(uri) {
+    const parsed = new URL(uri);
+    if (parsed.protocol !== 'https:') {
+        throw new ProviderError(`Provider URI must use HTTPS: ${uri}`, ProviderErrorCodes.PROVIDER_ERROR, { uri }, false, 'Ensure the provider URI begins with https://');
+    }
+    // Force trailing slash removal for consistent downstream concatenation
+    parsed.pathname = parsed.pathname.replace(/\/$/, '');
+    return parsed.toString();
+}
+/**
+ * Builds the HTTPS agent used for mutual TLS authentication with the provider.
+ *
+ * CRITICAL: Sets servername to empty string to disable SNI (Server Name Indication).
+ * Some providers use SNI to route requests, and when SNI contains a hostname, they
+ * route mTLS requests to a non-mTLS handler that returns 401 "unauthorized access".
+ * This matches Akash Console behavior and is required for compatibility with all providers.
+ */
+function createMtlsAgent(certificate) {
+    return new https.Agent({
+        cert: certificate.cert,
+        key: certificate.privateKey,
+        ca: certificate.chain,
+        rejectUnauthorized: false, // Providers often use self-signed certificates
+        servername: '', // Disable SNI for mTLS authentication (required by some providers)
+    });
+}
+/**
+ * Sends the deployment manifest to the provider over mTLS.
+ *
+ * The provider uses this manifest to start containers for the newly created lease.
+ * The workflow mirrors the steps outlined in the Akash Console deployment flow.
+ *
+ * Steps performed:
+ * 1. Validate and normalise the provider URI (must be HTTPS)
+ * 2. Construct the manifest delivery path `/deployment/{dseq}/manifest`
+ * 3. Send a PUT request with the manifest JSON using mutual TLS authentication
+ * 4. Resolve with a success Result when the provider accepts the manifest
+ *
+ * @param options - Manifest delivery configuration
+ * @returns Result signalling success or a ProviderError on failure
+ */
+export async function sendManifestToProvider(options) {
+    const { providerUri, lease, manifest, certificate, timeoutMs = 30_000, } = options;
+    let normalised;
+    try {
+        normalised = normaliseProviderUri(providerUri);
+    }
+    catch (error) {
+        return failure(error);
+    }
+    const parsed = new URL(normalised);
+    const path = `/deployment/${String(lease.dseq)}/manifest`;
+    const agent = createMtlsAgent(certificate);
+    return new Promise((resolve) => {
+        const request = https.request({
+            protocol: parsed.protocol,
+            hostname: parsed.hostname,
+            port: parsed.port || '8443',
+            method: 'PUT',
+            path,
+            headers: {
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+                'Content-Length': Buffer.byteLength(manifest, 'utf8'),
+            },
+            agent,
+            timeout: timeoutMs,
+        }, (response) => {
+            const statusCode = response.statusCode ?? 0;
+            // Fast-path success: provider accepted the manifest (200/202)
+            if (statusCode >= 200 && statusCode < 300) {
+                resolve(success(undefined));
+                response.resume();
+                return;
+            }
+            // Collect error body for diagnostics
+            const chunks = [];
+            response.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+            response.on('end', () => {
+                const body = Buffer.concat(chunks).toString('utf8');
+                if (statusCode === 400 || statusCode === 422) {
+                    resolve(failure(manifestRejectedError(parsed.hostname, body.trim() || undefined)));
+                }
+                else {
+                    resolve(failure(new ProviderError(`Provider returned ${statusCode} while sending manifest`, ProviderErrorCodes.MANIFEST_SEND_FAILED, {
+                        providerUri: normalised,
+                        statusCode,
+                        body: body.trim() || undefined,
+                    }, true, 'Retry the deployment or choose another provider')));
+                }
+            });
+        });
+        request.on('timeout', () => {
+            request.destroy(providerUnreachableError(parsed.host, new Error('Manifest delivery timed out')));
+        });
+        request.on('error', (error) => {
+            // Network errors are wrapped as provider unreachable for caller clarity
+            resolve(failure(providerUnreachableError(parsed.host, error)));
+        });
+        request.write(manifest, 'utf8');
+        request.end();
+    });
+}
+/**
+ * Builds the provider lease status endpoint URL.
+ */
+function buildLeaseStatusUrl(providerUri, lease) {
+    const base = new URL(providerUri);
+    base.pathname = `/lease/${String(lease.dseq)}/${lease.gseq}/${lease.oseq}/status`;
+    return base.toString();
+}
+/**
+ * Normalises provider service status objects returned by the provider API.
+ */
+function normaliseServices(rawServices) {
+    if (!rawServices) {
+        return {};
+    }
+    const entries = [];
+    for (const [name, raw] of Object.entries(rawServices)) {
+        if (!raw || typeof raw !== 'object') {
+            continue;
+        }
+        const record = raw;
+        const available = normaliseNumber(record.available ?? record.available_replicas, 0);
+        const total = normaliseNumber(record.total ?? record.replicas, 0);
+        const ready = normaliseNumber(record.ready_replicas, available);
+        const uris = Array.isArray(record.uris)
+            ? record.uris.filter((uri) => typeof uri === 'string')
+            : [];
+        entries.push([
+            name,
+            {
+                name,
+                available,
+                total,
+                ready,
+                uris,
+            },
+        ]);
+    }
+    return Object.freeze(Object.fromEntries(entries));
+}
+/**
+ * Normalises forwarded ports section of provider response.
+ */
+function normaliseForwardedPorts(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    const entries = [];
+    for (const [service, value] of Object.entries(raw)) {
+        if (!Array.isArray(value)) {
+            continue;
+        }
+        const ports = value
+            .map((item) => {
+            if (!item || typeof item !== 'object') {
+                return null;
+            }
+            const record = item;
+            const port = normaliseNumber(record.port, 0);
+            const externalPort = normaliseNumber(record.externalPort, port);
+            const host = typeof record.host === 'string' ? record.host : '';
+            const available = normaliseNumber(record.available, 0);
+            if (!host) {
+                return null;
+            }
+            return {
+                port,
+                externalPort,
+                host,
+                available,
+            };
+        })
+            .filter((value) => value !== null);
+        if (ports.length > 0) {
+            entries.push([service, Object.freeze(ports)]);
+        }
+    }
+    return entries.length > 0 ? Object.freeze(Object.fromEntries(entries)) : undefined;
+}
+/**
+ * Normalises assigned IPs section of provider response.
+ */
+function normaliseAssignedIps(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    const entries = [];
+    for (const [service, value] of Object.entries(raw)) {
+        if (!Array.isArray(value)) {
+            continue;
+        }
+        const ips = value
+            .map((item) => {
+            if (!item || typeof item !== 'object') {
+                return null;
+            }
+            const record = item;
+            const ip = typeof record.IP === 'string' ? record.IP : undefined;
+            if (!ip) {
+                return null;
+            }
+            return {
+                ip,
+                port: normaliseNumber(record.Port, 0),
+                externalPort: normaliseNumber(record.ExternalPort, 0),
+                protocol: typeof record.Protocol === 'string' ? record.Protocol : 'TCP',
+            };
+        })
+            .filter((value) => value !== null);
+        if (ips.length > 0) {
+            entries.push([service, Object.freeze(ips)]);
+        }
+    }
+    return entries.length > 0 ? Object.freeze(Object.fromEntries(entries)) : undefined;
+}
+/**
+ * Converts various number representations into a safe integer with fallback.
+ */
+function normaliseNumber(value, fallback) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const parsed = Number.parseInt(value, 10);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return fallback;
+}
+/**
+ * Queries the provider status endpoint for container readiness information.
+ *
+ * @param options - Provider status request configuration
+ * @returns Result containing normalised provider status data
+ */
+export async function fetchProviderLeaseStatus(options) {
+    const { providerUri, lease, certificate, timeoutMs = 10_000 } = options;
+    let normalised;
+    try {
+        normalised = normaliseProviderUri(providerUri);
+    }
+    catch (error) {
+        return failure(error);
+    }
+    const statusUrl = buildLeaseStatusUrl(normalised, lease);
+    try {
+        const response = await axios.get(statusUrl, {
+            httpsAgent: createMtlsAgent(certificate),
+            timeout: timeoutMs,
+            headers: { Accept: 'application/json' },
+            transitional: { clarifyTimeoutError: true },
+        });
+        const data = response.data;
+        const services = normaliseServices(data?.services);
+        const forwardedPorts = normaliseForwardedPorts(data?.forwarded_ports);
+        const assignedIps = normaliseAssignedIps(data?.ips);
+        return success(Object.freeze({
+            services,
+            forwardedPorts,
+            assignedIps,
+        }));
+    }
+    catch (error) {
+        // Axios wraps network errors into AxiosError, inspect to categorise
+        if (axios.isAxiosError(error)) {
+            return failure(handleAxiosError(error, normalised));
+        }
+        return failure(new ProviderError(`Failed to query provider status: ${error.message}`, ProviderErrorCodes.PROVIDER_STATUS_ERROR, { providerUri: normalised }, true, 'Retry in a few moments – providers may need time to start the deployment'));
+    }
+}
+/**
+ * Maps Axios errors to ProviderError instances with helpful context.
+ */
+function handleAxiosError(error, providerUri) {
+    if (error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND') {
+        return providerUnreachableError(providerUri, error);
+    }
+    if (error.code === 'ETIMEDOUT' || error.message.includes('timeout')) {
+        return new ProviderError(`Provider ${providerUri} did not respond in time`, ProviderErrorCodes.PROVIDER_TIMEOUT, { providerUri }, true, 'The provider may be busy. Consider retrying the request.');
+    }
+    if (error.response) {
+        const status = error.response.status;
+        const body = typeof error.response.data === 'string'
+            ? error.response.data
+            : JSON.stringify(error.response.data);
+        return new ProviderError(`Provider ${providerUri} returned ${status} when querying status`, ProviderErrorCodes.PROVIDER_STATUS_ERROR, { providerUri, statusCode: status, body }, true, 'Inspect the provider logs or retry with a different provider');
+    }
+    return new ProviderError(`Unknown provider error: ${error.message}`, ProviderErrorCodes.PROVIDER_STATUS_ERROR, { providerUri }, true, 'Retry the request or choose another provider', 'error', error);
+}
+//# sourceMappingURL=provider-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-client.js","sourceRoot":"","sources":["../../../src/targets/akash/provider-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAA0B,MAAM,OAAO,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAiF/B;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAE5B,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CACrB,gCAAgC,GAAG,EAAE,EACrC,kBAAkB,CAAC,cAAc,EACjC,EAAE,GAAG,EAAE,EACP,KAAK,EACL,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,QAAQ,EAAiB,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,WAAwC;IAC/D,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC;QACrB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,GAAG,EAAE,WAAW,CAAC,UAAU;QAC3B,EAAE,EAAE,WAAW,CAAC,KAAK;QACrB,kBAAkB,EAAE,KAAK,EAAE,+CAA+C;QAC1E,UAAU,EAAE,EAAE,EAAE,mEAAmE;KACpF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgC;IAEhC,MAAM,EACJ,WAAW,EACX,KAAK,EACL,QAAQ,EACR,WAAW,EACX,SAAS,GAAG,MAAM,GACnB,GAAG,OAAO,CAAC;IAEZ,IAAI,UAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,UAAU,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,KAAsB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,eAAe,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;IAE1D,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE3C,OAAO,IAAI,OAAO,CAA8B,CAAC,OAAO,EAAE,EAAE;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAC3B;YACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM;YAC3B,MAAM,EAAE,KAAK;YACb,IAAI;YACJ,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;gBAC1B,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;aACtD;YACD,KAAK;YACL,OAAO,EAAE,SAAS;SACnB,EACD,CAAC,QAAQ,EAAE,EAAE;YACX,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC;YAE5C,8DAA8D;YAC9D,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;gBAC1C,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YAED,qCAAqC;YACrC,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAChE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACtB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAEpD,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;oBAC7C,OAAO,CACL,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC,CAC1E,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO,CACL,OAAO,CACL,IAAI,aAAa,CACf,qBAAqB,UAAU,yBAAyB,EACxD,kBAAkB,CAAC,oBAAoB,EACvC;wBACE,WAAW,EAAE,UAAU;wBACvB,UAAU;wBACV,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,SAAS;qBAC/B,EACD,IAAI,EACJ,iDAAiD,CAClD,CACF,CACF,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,OAAO,CAAC,OAAO,CACb,wBAAwB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAChF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,wEAAwE;YACxE,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,WAAwB,EAAE,KAAqB;IAC1E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,GAAG,UAAU,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,SAAS,CAAC;IAClF,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,WAAgD;IAEhD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAA2C,EAAE,CAAC;IAE3D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,GAA8B,CAAC;QAE9C,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAEhE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YACrC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC;YACrE,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ;gBACE,IAAI;gBACJ,SAAS;gBACT,KAAK;gBACL,KAAK;gBACL,IAAI;aACL;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC9B,GAAwC;IAExC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAsD,EAAE,CAAC;IAEtE,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,KAAK;aAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,IAA+B,CAAC;YAC/C,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7C,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAEvD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO;gBACL,IAAI;gBACJ,YAAY;gBACZ,IAAI;gBACJ,SAAS;aACsB,CAAC;QACpC,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,KAAK,EAAkC,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QAErE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,GAAwC;IAExC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAmD,EAAE,CAAC;IAEnE,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,KAAK;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,IAA+B,CAAC;YAC/C,MAAM,EAAE,GAAG,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACjE,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO;gBACL,EAAE;gBACF,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrC,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;gBACrD,QAAQ,EAAE,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;aAC3C,CAAC;QACjC,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,KAAK,EAA+B,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QAElE,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAc,EAAE,QAAgB;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAA8B;IAE9B,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAExE,IAAI,UAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,UAAU,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,KAAsB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAU,SAAS,EAAE;YACnD,UAAU,EAAE,eAAe,CAAC,WAAW,CAAC;YACxC,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,YAAY,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE;SAC5C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA2C,CAAC;QAElE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,EAAE,QAA+C,CAAC,CAAC;QAC1F,MAAM,cAAc,GAAG,uBAAuB,CAC5C,IAAI,EAAE,eAAsD,CAC7D,CAAC;QACF,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,EAAE,GAA0C,CAAC,CAAC;QAE3F,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,CAAC;YACZ,QAAQ;YACR,cAAc;YACd,WAAW;SACZ,CAAC,CACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oEAAoE;QACpE,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,OAAO,CACZ,IAAI,aAAa,CACf,oCAAqC,KAAe,CAAC,OAAO,EAAE,EAC9D,kBAAkB,CAAC,qBAAqB,EACxC,EAAE,WAAW,EAAE,UAAU,EAAE,EAC3B,IAAI,EACJ,0EAA0E,CAC3E,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAiB,EAAE,WAAwB;IACnE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChE,OAAO,wBAAwB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,OAAO,IAAI,aAAa,CACtB,YAAY,WAAW,0BAA0B,EACjD,kBAAkB,CAAC,gBAAgB,EACnC,EAAE,WAAW,EAAE,EACf,IAAI,EACJ,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrC,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;YAClD,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI;YACrB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAExC,OAAO,IAAI,aAAa,CACtB,YAAY,WAAW,aAAa,MAAM,uBAAuB,EACjE,kBAAkB,CAAC,qBAAqB,EACxC,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,EACzC,IAAI,EACJ,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,aAAa,CACtB,2BAA2B,KAAK,CAAC,OAAO,EAAE,EAC1C,kBAAkB,CAAC,qBAAqB,EACxC,EAAE,WAAW,EAAE,EACf,IAAI,EACJ,8CAA8C,EAC9C,OAAO,EACP,KAAK,CACN,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,228 @@
+/**
+ * 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