@kadi.build/deploy-ability 0.0.1

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

@@ -0,0 +1,241 @@
+/**
+ * Akash Network Environment Configuration Module
+ *
+ * Provides pure, readonly configuration for Akash Network deployments.
+ * NO file I/O, NO user prompts, NO environment variable loading.
+ *
+ * @module targets/akash/environment
+ */
+/**
+ * Akash network identifier
+ *
+ * - mainnet: Production network (real AKT tokens)
+ * - testnet: Testing network (free test tokens)
+ */
+export type AkashNetwork = 'mainnet' | 'testnet';
+/**
+ * Network configuration for Akash blockchain
+ *
+ * Contains all data needed to connect to an Akash network:
+ * - RPC endpoint for blockchain queries and transactions
+ * - Chain ID for transaction signing
+ *
+ * @property rpc - RPC endpoint URL
+ * @property chainId - Blockchain chain identifier
+ */
+export interface NetworkConfiguration {
+    /** RPC endpoint URL (e.g., "https://rpc.akashnet.net:443") */
+    readonly rpc: string;
+    /** Chain ID (e.g., "akashnet-2" for mainnet) */
+    readonly chainId: string;
+}
+/**
+ * Mainnet RPC endpoints for Akash Network
+ *
+ * Multiple endpoints provide redundancy and load distribution.
+ * Clients can implement fallback logic if primary endpoint fails.
+ *
+ * Priority order (first is default):
+ * 1. Official Akash RPC (rpc.akashnet.net)
+ * 2. Forbole validator RPC
+ * 3. Ecostake validator RPC
+ * 4. Polkachu validator RPC
+ * 5. Community RPC (c29r3)
+ *
+ * @example
+ * ```typescript
+ * // Use primary endpoint
+ * const rpc = MAINNET_RPC_ENDPOINTS[0];
+ *
+ * // Implement fallback
+ * for (const endpoint of MAINNET_RPC_ENDPOINTS) {
+ *   try {
+ *     const client = await StargateClient.connect(endpoint);
+ *     break; // Success
+ *   } catch {
+ *     continue; // Try next endpoint
+ *   }
+ * }
+ * ```
+ */
+export declare const MAINNET_RPC_ENDPOINTS: readonly string[];
+/**
+ * Testnet RPC endpoints for Akash Network
+ *
+ * Testnet is used for:
+ * - Development and testing
+ * - Learning without risking real tokens
+ * - Integration testing before mainnet deployment
+ *
+ * @example
+ * ```typescript
+ * const rpc = TESTNET_RPC_ENDPOINTS[0];
+ * const client = await StargateClient.connect(rpc);
+ * ```
+ */
+export declare const TESTNET_RPC_ENDPOINTS: readonly string[];
+/**
+ * Akash network configuration mapping
+ *
+ * Immutable configuration for all supported Akash networks.
+ * Used throughout the deployment process for:
+ * - Blockchain queries and transactions
+ * - Network-specific certificate validation
+ * - Provider communication and bid evaluation
+ *
+ * Why as const?
+ * - Ensures configuration cannot be accidentally modified
+ * - Enables TypeScript to infer exact string literal types
+ * - Catches typos at compile time (e.g., 'mainet' vs 'mainnet')
+ *
+ * @example
+ * ```typescript
+ * // Get network config
+ * const network = AKASH_NETWORKS.mainnet;
+ * console.log('RPC:', network.rpc);
+ * console.log('Chain:', network.chainId);
+ *
+ * // Type-safe network selection
+ * function getConfig(net: AkashNetwork) {
+ *   return AKASH_NETWORKS[net]; // Compile-time checked
+ * }
+ * ```
+ */
+export declare const AKASH_NETWORKS: {
+    /**
+     * Mainnet configuration
+     * - Real AKT tokens
+     * - Production deployments
+     * - Chain ID: akashnet-2
+     */
+    readonly mainnet: {
+        readonly rpc: string;
+        readonly chainId: "akashnet-2";
+    };
+    /**
+     * Testnet configuration
+     * - Free test tokens from faucet
+     * - Testing and development
+     * - Chain ID: sandbox-01
+     */
+    readonly testnet: {
+        readonly rpc: string;
+        readonly chainId: "sandbox-01";
+    };
+};
+/**
+ * Blacklisted provider addresses
+ *
+ * Providers in this set have shown unreliable behavior and should be
+ * excluded from bid selection. Issues include:
+ * - Failed deployments
+ * - Unresponsive provider APIs
+ * - Frequent downtime
+ * - Poor performance
+ *
+ * This list is periodically updated based on community reports and
+ * monitoring data.
+ *
+ * Implementation Note:
+ * Using Set for O(1) lookup performance during bid filtering.
+ *
+ * @example
+ * ```typescript
+ * // Filter out blacklisted providers
+ * const validBids = allBids.filter(bid =>
+ *   !BLACKLISTED_PROVIDERS.has(bid.provider)
+ * );
+ *
+ * // Check if specific provider is blacklisted
+ * if (BLACKLISTED_PROVIDERS.has(providerAddress)) {
+ *   console.log('Skipping blacklisted provider');
+ * }
+ * ```
+ */
+export declare const BLACKLISTED_PROVIDERS: ReadonlySet<string>;
+/**
+ * Get network configuration for specified Akash network
+ *
+ * Pure function that returns network configuration.
+ * No side effects, no I/O, just data lookup.
+ *
+ * @param network - Network identifier ('mainnet' or 'testnet')
+ * @returns Network configuration
+ *
+ * @example
+ * ```typescript
+ * const config = getNetworkConfig('mainnet');
+ * console.log('Connecting to:', config.rpc);
+ * console.log('Chain ID:', config.chainId);
+ *
+ * // Use in deployment
+ * const client = await StargateClient.connect(config.rpc);
+ * const wallet = await getOfflineSigner(config.chainId);
+ * ```
+ */
+export declare function getNetworkConfig(network: AkashNetwork): NetworkConfiguration;
+/**
+ * Get all available RPC endpoints for a network
+ *
+ * Returns array of RPC endpoints for failover/load balancing.
+ * Caller can implement retry logic across multiple endpoints.
+ *
+ * @param network - Network identifier
+ * @returns Array of RPC endpoint URLs
+ *
+ * @example
+ * ```typescript
+ * // Try each endpoint until one connects
+ * const endpoints = getAllRpcEndpoints('mainnet');
+ * for (const rpc of endpoints) {
+ *   try {
+ *     const client = await StargateClient.connect(rpc);
+ *     console.log('Connected to:', rpc);
+ *     break;
+ *   } catch (error) {
+ *     console.log('Failed to connect to:', rpc);
+ *     continue; // Try next
+ *   }
+ * }
+ * ```
+ */
+export declare function getAllRpcEndpoints(network: AkashNetwork): readonly string[];
+/**
+ * Check if a provider is blacklisted
+ *
+ * Helper function for bid filtering logic.
+ *
+ * @param providerAddress - Provider's Akash address
+ * @returns True if provider should be avoided
+ *
+ * @example
+ * ```typescript
+ * // Filter bids
+ * const validBids = bids.filter(bid =>
+ *   !isProviderBlacklisted(bid.bidId.provider)
+ * );
+ *
+ * // Log warning
+ * if (isProviderBlacklisted(provider)) {
+ *   logger.warn(`Skipping blacklisted provider: ${provider}`);
+ * }
+ * ```
+ */
+export declare function isProviderBlacklisted(providerAddress: string): boolean;
+/**
+ * Type guard: Check if string is valid AkashNetwork
+ *
+ * @param value - Value to check
+ * @returns True if value is 'mainnet' or 'testnet'
+ *
+ * @example
+ * ```typescript
+ * const userInput = 'mainnet';
+ * if (isAkashNetwork(userInput)) {
+ *   // TypeScript knows userInput is 'mainnet' | 'testnet'
+ *   const config = getNetworkConfig(userInput);
+ * }
+ * ```
+ */
+export declare function isAkashNetwork(value: string): value is AkashNetwork;
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/targets/akash/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAMzC,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAEzC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;OAKG;;;;;IAMH;;;;;OAKG;;;;;CAKK,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAMpD,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,oBAAoB,CAE5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAO3E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE"}

package/dist/targets/akash/environment.js

@@ -0,0 +1,245 @@
+/**
+ * Akash Network Environment Configuration Module
+ *
+ * Provides pure, readonly configuration for Akash Network deployments.
+ * NO file I/O, NO user prompts, NO environment variable loading.
+ *
+ * @module targets/akash/environment
+ */
+/**
+ * Mainnet RPC endpoints for Akash Network
+ *
+ * Multiple endpoints provide redundancy and load distribution.
+ * Clients can implement fallback logic if primary endpoint fails.
+ *
+ * Priority order (first is default):
+ * 1. Official Akash RPC (rpc.akashnet.net)
+ * 2. Forbole validator RPC
+ * 3. Ecostake validator RPC
+ * 4. Polkachu validator RPC
+ * 5. Community RPC (c29r3)
+ *
+ * @example
+ * ```typescript
+ * // Use primary endpoint
+ * const rpc = MAINNET_RPC_ENDPOINTS[0];
+ *
+ * // Implement fallback
+ * for (const endpoint of MAINNET_RPC_ENDPOINTS) {
+ *   try {
+ *     const client = await StargateClient.connect(endpoint);
+ *     break; // Success
+ *   } catch {
+ *     continue; // Try next endpoint
+ *   }
+ * }
+ * ```
+ */
+export const MAINNET_RPC_ENDPOINTS = [
+    'https://rpc.akashnet.net:443',
+    'https://rpc.akash.forbole.com:443',
+    'https://rpc-akash.ecostake.com:443',
+    'https://akash-rpc.polkachu.com:443',
+    'https://akash.c29r3.xyz:443/rpc'
+];
+/**
+ * Testnet RPC endpoints for Akash Network
+ *
+ * Testnet is used for:
+ * - Development and testing
+ * - Learning without risking real tokens
+ * - Integration testing before mainnet deployment
+ *
+ * @example
+ * ```typescript
+ * const rpc = TESTNET_RPC_ENDPOINTS[0];
+ * const client = await StargateClient.connect(rpc);
+ * ```
+ */
+export const TESTNET_RPC_ENDPOINTS = [
+    'https://rpc.sandbox-01.aksh.pw:443'
+];
+/**
+ * Akash network configuration mapping
+ *
+ * Immutable configuration for all supported Akash networks.
+ * Used throughout the deployment process for:
+ * - Blockchain queries and transactions
+ * - Network-specific certificate validation
+ * - Provider communication and bid evaluation
+ *
+ * Why as const?
+ * - Ensures configuration cannot be accidentally modified
+ * - Enables TypeScript to infer exact string literal types
+ * - Catches typos at compile time (e.g., 'mainet' vs 'mainnet')
+ *
+ * @example
+ * ```typescript
+ * // Get network config
+ * const network = AKASH_NETWORKS.mainnet;
+ * console.log('RPC:', network.rpc);
+ * console.log('Chain:', network.chainId);
+ *
+ * // Type-safe network selection
+ * function getConfig(net: AkashNetwork) {
+ *   return AKASH_NETWORKS[net]; // Compile-time checked
+ * }
+ * ```
+ */
+export const AKASH_NETWORKS = {
+    /**
+     * Mainnet configuration
+     * - Real AKT tokens
+     * - Production deployments
+     * - Chain ID: akashnet-2
+     */
+    mainnet: {
+        rpc: MAINNET_RPC_ENDPOINTS[0],
+        chainId: 'akashnet-2'
+    },
+    /**
+     * Testnet configuration
+     * - Free test tokens from faucet
+     * - Testing and development
+     * - Chain ID: sandbox-01
+     */
+    testnet: {
+        rpc: TESTNET_RPC_ENDPOINTS[0],
+        chainId: 'sandbox-01'
+    }
+};
+/**
+ * Blacklisted provider addresses
+ *
+ * Providers in this set have shown unreliable behavior and should be
+ * excluded from bid selection. Issues include:
+ * - Failed deployments
+ * - Unresponsive provider APIs
+ * - Frequent downtime
+ * - Poor performance
+ *
+ * This list is periodically updated based on community reports and
+ * monitoring data.
+ *
+ * Implementation Note:
+ * Using Set for O(1) lookup performance during bid filtering.
+ *
+ * @example
+ * ```typescript
+ * // Filter out blacklisted providers
+ * const validBids = allBids.filter(bid =>
+ *   !BLACKLISTED_PROVIDERS.has(bid.provider)
+ * );
+ *
+ * // Check if specific provider is blacklisted
+ * if (BLACKLISTED_PROVIDERS.has(providerAddress)) {
+ *   console.log('Skipping blacklisted provider');
+ * }
+ * ```
+ */
+export const BLACKLISTED_PROVIDERS = new Set([
+    // Provider addresses with known issues
+    'akash1p5ptazlyc2zpt6jfwa7uupvf97t7wn3ys4kpdg',
+    'akash1p3n6cwgfd5v98nwm8zfjfg99adxz26jx0nehcg',
+    'akash1zlsep362zz46qlwzttm06t8lv9qtg8gtaya97u',
+    'akash1qk9dg3kr3jx6q5l2uf7g7mm8st2mr8ylfakepy'
+]);
+/**
+ * Get network configuration for specified Akash network
+ *
+ * Pure function that returns network configuration.
+ * No side effects, no I/O, just data lookup.
+ *
+ * @param network - Network identifier ('mainnet' or 'testnet')
+ * @returns Network configuration
+ *
+ * @example
+ * ```typescript
+ * const config = getNetworkConfig('mainnet');
+ * console.log('Connecting to:', config.rpc);
+ * console.log('Chain ID:', config.chainId);
+ *
+ * // Use in deployment
+ * const client = await StargateClient.connect(config.rpc);
+ * const wallet = await getOfflineSigner(config.chainId);
+ * ```
+ */
+export function getNetworkConfig(network) {
+    return AKASH_NETWORKS[network];
+}
+/**
+ * Get all available RPC endpoints for a network
+ *
+ * Returns array of RPC endpoints for failover/load balancing.
+ * Caller can implement retry logic across multiple endpoints.
+ *
+ * @param network - Network identifier
+ * @returns Array of RPC endpoint URLs
+ *
+ * @example
+ * ```typescript
+ * // Try each endpoint until one connects
+ * const endpoints = getAllRpcEndpoints('mainnet');
+ * for (const rpc of endpoints) {
+ *   try {
+ *     const client = await StargateClient.connect(rpc);
+ *     console.log('Connected to:', rpc);
+ *     break;
+ *   } catch (error) {
+ *     console.log('Failed to connect to:', rpc);
+ *     continue; // Try next
+ *   }
+ * }
+ * ```
+ */
+export function getAllRpcEndpoints(network) {
+    switch (network) {
+        case 'mainnet':
+            return MAINNET_RPC_ENDPOINTS;
+        case 'testnet':
+            return TESTNET_RPC_ENDPOINTS;
+    }
+}
+/**
+ * Check if a provider is blacklisted
+ *
+ * Helper function for bid filtering logic.
+ *
+ * @param providerAddress - Provider's Akash address
+ * @returns True if provider should be avoided
+ *
+ * @example
+ * ```typescript
+ * // Filter bids
+ * const validBids = bids.filter(bid =>
+ *   !isProviderBlacklisted(bid.bidId.provider)
+ * );
+ *
+ * // Log warning
+ * if (isProviderBlacklisted(provider)) {
+ *   logger.warn(`Skipping blacklisted provider: ${provider}`);
+ * }
+ * ```
+ */
+export function isProviderBlacklisted(providerAddress) {
+    return BLACKLISTED_PROVIDERS.has(providerAddress);
+}
+/**
+ * Type guard: Check if string is valid AkashNetwork
+ *
+ * @param value - Value to check
+ * @returns True if value is 'mainnet' or 'testnet'
+ *
+ * @example
+ * ```typescript
+ * const userInput = 'mainnet';
+ * if (isAkashNetwork(userInput)) {
+ *   // TypeScript knows userInput is 'mainnet' | 'testnet'
+ *   const config = getNetworkConfig(userInput);
+ * }
+ * ```
+ */
+export function isAkashNetwork(value) {
+    return value === 'mainnet' || value === 'testnet';
+}
+//# sourceMappingURL=environment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/targets/akash/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,8BAA8B;IAC9B,mCAAmC;IACnC,oCAAoC;IACpC,oCAAoC;IACpC,iCAAiC;CACzB,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,oCAAoC;CAC5B,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;;;;OAKG;IACH,OAAO,EAAE;QACP,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAE;QAC9B,OAAO,EAAE,YAAY;KACtB;IAED;;;;;OAKG;IACH,OAAO,EAAE;QACP,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAE;QAC9B,OAAO,EAAE,YAAY;KACtB;CACO,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC;IAChE,uCAAuC;IACvC,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;CAC/C,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,qBAAqB,CAAC;QAC/B,KAAK,SAAS;YACZ,OAAO,qBAAqB,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,qBAAqB,CAAC,eAAuB;IAC3D,OAAO,qBAAqB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC;AACpD,CAAC"}