@kadi.build/deploy-ability 0.0.1

package/dist/targets/akash/sdl-generator.js

@@ -0,0 +1,279 @@
+/**
+ * Akash SDL Generator
+ *
+ * Transforms a loaded Akash deployment profile into an SDL (Stack Definition
+ * Language) document that can be submitted to the Akash blockchain and
+ * providers. The generator mirrors the logic from the legacy kadi-deploy
+ * implementation, but is rewritten for clarity and type safety.
+ *
+ * @module targets/akash/sdl-generator
+ */
+import yaml from 'js-yaml';
+import { SDL } from '@akashnetwork/akashjs/build/sdl/index.js';
+/**
+ * Generates Akash SDL YAML string from a loaded deployment profile.
+ */
+export function generateAkashSdl(loadedProfile, options = {}) {
+    const defaults = {
+        defaultCpuUnits: 0.5,
+        defaultMemorySize: '512Mi',
+        defaultStorageSize: '1Gi',
+        defaultPricingDenom: 'uakt',
+        defaultPricingAmount: 1000,
+        ...options,
+    };
+    const services = {};
+    const computeProfiles = {};
+    // Build placement profile with attributes and signedBy from profile
+    const akashProfile = loadedProfile.profile;
+    // Merge placement attributes with any existing attributes
+    // Placement attributes control where the deployment runs (geographic targeting)
+    //
+    // **Important:** The 'placement' field provides type-safe convenience for common
+    // attributes, but it maps to the actual provider attribute names that providers
+    // use on mainnet (e.g., 'region' not 'location-region').
+    const placementAttributes = {
+        ...akashProfile.attributes, // Existing attributes (GPU requirements, etc.)
+    };
+    // Add placement attributes if specified
+    // Maps typed placement fields to actual provider attribute names
+    if (akashProfile.placement) {
+        if (akashProfile.placement.region) {
+            placementAttributes.region = akashProfile.placement.region;
+        }
+        if (akashProfile.placement.tier) {
+            placementAttributes.tier = akashProfile.placement.tier;
+        }
+    }
+    const placementProfiles = {
+        global: {
+            attributes: placementAttributes,
+            signedBy: akashProfile.signedBy || {
+                allOf: ['akash1365yvmc4s7awdyj3n2sav7xfx76adc6dnmlx63'],
+            },
+            pricing: {},
+        },
+    };
+    const deploymentProfiles = {};
+    for (const [serviceName, serviceConfig] of Object.entries(loadedProfile.profile.services)) {
+        const akashServiceName = normaliseServiceName(serviceName);
+        // Support pricing at both profile level and service level
+        const pricing = loadedProfile.profile.pricing?.[serviceName] ?? serviceConfig.pricing;
+        services[akashServiceName] = buildServiceSection(serviceConfig);
+        computeProfiles[akashServiceName] = buildComputeProfile(serviceConfig, defaults);
+        placementProfiles.global.pricing[akashServiceName] = buildPricingProfile(pricing, defaults);
+        deploymentProfiles[akashServiceName] = buildDeploymentProfile(akashServiceName, serviceConfig);
+    }
+    // Build SDL document in the conventional order:
+    // 1. version
+    // 2. services
+    // 3. profiles (compute, placement)
+    // 4. deployment
+    // Clean up placement profile - remove attributes if empty
+    const cleanPlacement = { ...placementProfiles };
+    if (Object.keys(cleanPlacement.global.attributes || {}).length === 0) {
+        delete cleanPlacement.global.attributes;
+    }
+    const sdlDocument = {
+        version: '2.0',
+        services,
+        profiles: {
+            compute: computeProfiles,
+            placement: cleanPlacement,
+        },
+        deployment: deploymentProfiles,
+    };
+    return yaml.dump(sdlDocument, {
+        noRefs: true,
+        lineWidth: 120,
+        indent: 2,
+    });
+}
+/**
+ * Generates SDL string and returns an instantiated SDL helper from akashjs.
+ */
+export function createSdlObject(loadedProfile, options) {
+    const yamlString = generateAkashSdl(loadedProfile, options);
+    return SDL.fromString(yamlString, 'beta3');
+}
+/**
+ * Ensures service names are DNS-friendly (lowercase alphanumeric).
+ */
+function normaliseServiceName(name) {
+    const cleaned = name.trim().toLowerCase().replace(/[^a-z0-9]/g, '');
+    return cleaned || 'service';
+}
+/** Converts EnvironmentVariable definitions into KEY=value strings. */
+function normaliseEnvironment(env) {
+    if (!env || env.length === 0) {
+        return undefined;
+    }
+    const entries = env
+        .map((variable) => {
+        if (typeof variable === 'string') {
+            return variable;
+        }
+        if (variable && typeof variable.name === 'string') {
+            return `${variable.name}=${variable.value ?? ''}`;
+        }
+        return null;
+    })
+        .filter((value) => value !== null);
+    return entries.length > 0 ? entries : undefined;
+}
+/**
+ * Maps PortExposure definitions to Akash SDL format
+ *
+ * Transforms deploy-ability's port exposure format into Akash SDL YAML structure,
+ * including HTTP options for ingress timeout configuration.
+ */
+function normaliseExpose(expose) {
+    if (!expose || expose.length === 0) {
+        return undefined;
+    }
+    return expose.map((exposure) => {
+        const targets = exposure.to?.map((target) => typeof target === 'string'
+            ? { service: target }
+            : { global: target.global ?? false });
+        // Build base exposure object
+        const exposureObj = {
+            port: exposure.port,
+            as: exposure.as ?? exposure.port,
+            to: targets ?? [{ global: false }],
+        };
+        // Add HTTP options if specified
+        // Only relevant for Akash deployments with global exposure
+        if (exposure.http_options) {
+            exposureObj.http_options = exposure.http_options;
+        }
+        return exposureObj;
+    });
+}
+/** Builds services section entry. */
+function buildServiceSection(service) {
+    const section = {
+        image: service.image,
+    };
+    // Add registry credentials if present (for private registries)
+    const credentials = service.credentials;
+    if (credentials) {
+        section.credentials = credentials;
+    }
+    const env = normaliseEnvironment(service.env);
+    if (env)
+        section.env = env;
+    if (service.command && service.command.length > 0) {
+        section.command = service.command;
+    }
+    const expose = normaliseExpose(service.expose);
+    if (expose)
+        section.expose = expose;
+    // Add params for persistent volume mounts
+    const persistentVolumes = service.resources?.persistentVolumes ?? [];
+    if (persistentVolumes.length > 0) {
+        section.params = buildServiceParams(persistentVolumes);
+    }
+    return section;
+}
+/**
+ * Builds service params section for persistent volume mounts
+ *
+ * Generates the params.storage section that maps volume names to mount paths.
+ * This is required for Akash to mount persistent volumes into the container.
+ *
+ * @param volumes - Array of persistent volume specifications
+ * @returns Params object with storage mount configuration
+ *
+ * @example
+ * Input: [{ name: "data", size: "10Gi", mount: "/data", class: "beta2" }]
+ * Output: { storage: { data: { mount: "/data" } } }
+ */
+function buildServiceParams(volumes) {
+    const storage = {};
+    for (const volume of volumes) {
+        storage[volume.name] = {
+            mount: volume.mount,
+        };
+    }
+    return { storage };
+}
+/**
+ * Builds compute profile for CPU/memory/storage/GPU requirements
+ *
+ * Handles the new storage format with separate ephemeral and persistent storage.
+ *
+ * **Format:**
+ * ```yaml
+ * resources:
+ *   storage:
+ *     - size: "512Mi"                    # Ephemeral (from ephemeralStorage)
+ *     - name: data                       # Persistent volume
+ *       size: "10Gi"
+ *       attributes:
+ *         persistent: true
+ *         class: beta2
+ * ```
+ */
+function buildComputeProfile(service, defaults) {
+    const cpuUnits = service.resources?.cpu ?? defaults.defaultCpuUnits;
+    const memory = service.resources?.memory ?? defaults.defaultMemorySize;
+    const ephemeralSize = service.resources?.ephemeralStorage ?? defaults.defaultStorageSize;
+    const persistentVolumes = service.resources?.persistentVolumes ?? [];
+    const resources = {
+        cpu: { units: cpuUnits },
+        memory: { size: memory },
+    };
+    // Generate storage section
+    if (persistentVolumes.length > 0) {
+        // Array format: ephemeral + persistent volumes
+        const storageArray = [
+            { size: ephemeralSize }, // Ephemeral storage (first element)
+        ];
+        // Add each persistent volume with attributes
+        for (const volume of persistentVolumes) {
+            storageArray.push({
+                name: volume.name,
+                size: volume.size,
+                attributes: {
+                    persistent: true,
+                    class: volume.class ?? 'beta2', // Default to SSD if not specified
+                },
+            });
+        }
+        resources.storage = storageArray;
+    }
+    else {
+        // Simple format: only ephemeral storage
+        resources.storage = { size: ephemeralSize };
+    }
+    // Add GPU configuration if present
+    if (service.resources?.gpu) {
+        resources.gpu = service.resources.gpu;
+    }
+    return { resources };
+}
+/** Builds pricing profile (max bid per service). */
+function buildPricingProfile(pricing, defaults) {
+    if (pricing) {
+        return {
+            denom: pricing.denom,
+            amount: parseInt(pricing.amount, 10), // Convert string to number
+        };
+    }
+    return {
+        denom: defaults.defaultPricingDenom,
+        amount: defaults.defaultPricingAmount,
+    };
+}
+/** Builds deployment profile specifying replica count. */
+function buildDeploymentProfile(computeProfileName, _service // Prefix unused param to avoid TS error
+) {
+    const count = 1;
+    return {
+        global: {
+            profile: computeProfileName,
+            count,
+        },
+    };
+}
+//# sourceMappingURL=sdl-generator.js.map

package/dist/targets/akash/sdl-generator.js.map

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

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

@@ -0,0 +1,285 @@
+/**
+ * Akash Network Type Definitions
+ *
+ * This module provides type-safe interfaces for Akash Network deployment operations.
+ * ALL `any` types from the original kadi-deploy implementation have been replaced
+ * with proper TypeScript interfaces from @cosmjs and @walletconnect libraries.
+ *
+ * Key Improvements from kadi-deploy:
+ * - ✅ ZERO `any` types (was 5 any types)
+ * - ✅ Proper imports from typed libraries
+ * - ✅ Readonly properties to prevent mutations
+ * - ✅ Comprehensive JSDoc documentation
+ *
+ * @module targets/akash/types
+ */
+import type { OfflineAminoSigner } from '@cosmjs/amino';
+import type { OfflineDirectSigner } from '@cosmjs/proto-signing';
+import type { SessionTypes } from '@walletconnect/types';
+import { SignClient } from '@walletconnect/sign-client';
+/**
+ * Keplr wallet signer with dual signing capabilities
+ *
+ * Keplr wallet provides BOTH Amino (legacy JSON) and Direct (protobuf) signing.
+ * This intersection type ensures we have access to both signing methods,
+ * which is required for compatibility with different Cosmos SDK versions.
+ *
+ * Note: There's a known type incompatibility between @keplr-wallet/types and
+ * @cosmjs/proto-signing (Long vs bigint for SignDoc.accountNumber). The actual
+ * runtime objects work fine - this is purely a TypeScript type issue.
+ *
+ * Why both?
+ * - Amino: Legacy format, required by some older chains
+ * - Direct: Modern protobuf format, more efficient and type-safe
+ *
+ * @example
+ * ```typescript
+ * const signer: KeplrSigner = await keplrWallet.getOfflineSigner(chainId);
+ * // Can use both signing methods:
+ * await signer.signAmino(address, signDoc);  // Amino signing
+ * await signer.signDirect(address, signDoc); // Direct signing
+ * ```
+ */
+export type KeplrSigner = OfflineAminoSigner & OfflineDirectSigner;
+/**
+ * Account data from the Cosmos blockchain
+ *
+ * Represents the on-chain state of a blockchain account.
+ * Used for transaction signing and nonce management.
+ *
+ * @property address - Bech32 encoded address (e.g., "akash1...")
+ * @property pubkey - Public key bytes (null if account never used)
+ * @property accountNumber - Unique account number (never changes)
+ * @property sequence - Transaction sequence/nonce (increments per tx)
+ */
+export interface AccountData {
+    /** Bech32 address of the account */
+    readonly address: string;
+    /** Public key bytes (null if account has never sent a transaction) */
+    readonly pubkey: Uint8Array | null;
+    /** Unique account number assigned when account first used */
+    readonly accountNumber: number;
+    /**
+     * Transaction sequence number (nonce)
+     * Increments with each transaction to prevent replays
+     */
+    readonly sequence: number;
+}
+/**
+ * Wallet connection context for Akash Network operations
+ *
+ * Contains all the data needed to interact with the Akash blockchain:
+ * - Signing transactions
+ * - Querying account state
+ * - Managing WalletConnect session
+ *
+ * This is the core data structure passed through all deployment operations.
+ *
+ * Key Design Decisions:
+ * - All properties are readonly to prevent accidental mutations
+ * - WalletConnect fields are optional (only needed when using WalletConnect)
+ * - Both signer and offlineSigner are KeplrSigner type (no more `any`!)
+ *
+ * @example
+ * ```typescript
+ * // Create wallet context after successful connection
+ * const walletCtx: WalletContext = {
+ *   address: 'akash1abc...',
+ *   signer: keplrSigner,
+ *   offlineSigner: keplrSigner,
+ *   chainId: 'akashnet-2',
+ *   account: {
+ *     address: 'akash1abc...',
+ *     pubkey: new Uint8Array([...]),
+ *     accountNumber: 12345,
+ *     sequence: 0
+ *   }
+ * };
+ *
+ * // Use in deployment operations
+ * const result = await deployToAkash({ walletCtx, ... });
+ * ```
+ */
+export interface WalletContext {
+    /**
+     * Wallet address in bech32 format
+     * Example: "akash1abc123def456..."
+     */
+    readonly address: string;
+    /**
+     * Keplr signer with both Amino and Direct signing capabilities
+     *
+     * This is a stable offline signer wrapper that provides consistent
+     * transaction signing across different signing modes.
+     *
+     * Type: KeplrSigner (OfflineAminoSigner & OfflineDirectSigner)
+     */
+    readonly signer: KeplrSigner;
+    /**
+     * Offline signer for transaction creation
+     *
+     * Same as `signer` but explicitly typed for offline operations.
+     * Used when creating and signing transactions without network access.
+     *
+     * Type: KeplrSigner (OfflineAminoSigner & OfflineDirectSigner)
+     */
+    readonly offlineSigner: KeplrSigner;
+    /**
+     * WalletConnect SignClient instance (optional)
+     *
+     * Only present when using WalletConnect for mobile wallet connection.
+     * Used for session management and connection lifecycle.
+     *
+     * If undefined, means using browser extension (Keplr) instead of mobile.
+     */
+    readonly signClient?: InstanceType<typeof SignClient>;
+    /**
+     * Active WalletConnect session (optional)
+     *
+     * Contains session data needed for disconnection and session management.
+     * Only present when using WalletConnect.
+     *
+     * Type: SessionTypes.Struct from @walletconnect/types
+     */
+    readonly session?: SessionTypes.Struct;
+    /**
+     * Connected Akash network chain ID (optional)
+     *
+     * Examples:
+     * - 'akashnet-2' (mainnet)
+     * - 'sandbox-01' (testnet)
+     *
+     * Used to verify we're connected to the correct network.
+     */
+    readonly chainId?: string;
+    /**
+     * On-chain account data (optional)
+     *
+     * Cached account state from the blockchain.
+     * Used for transaction nonce (sequence) management.
+     *
+     * If undefined, means we haven't queried account state yet.
+     */
+    readonly account?: AccountData;
+}
+/**
+ * Akash Provider TLS Certificate
+ *
+ * X.509 certificate used for mutual TLS (mTLS) authentication with Akash providers.
+ * Required for secure communication with provider APIs after lease creation.
+ *
+ * Why mTLS?
+ * - Akash providers require client certificates for authentication
+ * - Prevents unauthorized access to deployment management APIs
+ * - Certificate is tied to wallet address via blockchain registration
+ *
+ * Certificate Lifecycle:
+ * 1. Generate key pair (privateKey, publicKey)
+ * 2. Create X.509 certificate signing request
+ * 3. Submit certificate to blockchain
+ * 4. Use for all provider API calls
+ *
+ * @property privateKey - Private key in PEM format (keep secret!)
+ * @property publicKey - Public key in PEM format
+ * @property cert - X.509 certificate in PEM format
+ * @property chain - Certificate chain in PEM format (optional)
+ *
+ * @example
+ * ```typescript
+ * const certificate: AkashProviderTlsCertificate = {
+ *   privateKey: '-----BEGIN PRIVATE KEY-----\n...',
+ *   publicKey: '-----BEGIN PUBLIC KEY-----\n...',
+ *   cert: '-----BEGIN CERTIFICATE-----\n...',
+ *   chain: '-----BEGIN CERTIFICATE-----\n...' // Optional
+ * };
+ *
+ * // Use for provider API calls
+ * const response = await fetch(providerUri, {
+ *   method: 'POST',
+ *   headers: {
+ *     'Content-Type': 'application/json',
+ *   },
+ *   // mTLS authentication:
+ *   cert: certificate.cert,
+ *   key: certificate.privateKey
+ * });
+ * ```
+ */
+export interface AkashProviderTlsCertificate {
+    /**
+     * Private key in PEM format
+     *
+     * SECURITY: Keep this secret! Never log or expose in errors.
+     * Used for mTLS client authentication with providers.
+     *
+     * Format: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
+     */
+    readonly privateKey: string;
+    /**
+     * Public key in PEM format
+     *
+     * Paired with privateKey, can be shared publicly.
+     * Used for certificate verification.
+     *
+     * Format: "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
+     */
+    readonly publicKey: string;
+    /**
+     * X.509 certificate in PEM format
+     *
+     * This is the actual certificate used for mTLS authentication.
+     * Contains public key + metadata signed by certificate authority.
+     *
+     * Format: "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
+     */
+    readonly cert: string;
+    /**
+     * Certificate chain in PEM format (optional)
+     *
+     * Some certificate sources provide the full certificate chain.
+     * Not always required for Akash provider communication.
+     *
+     * Format: "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
+     */
+    readonly chain?: string;
+}
+/**
+ * Type guard: Check if wallet context has WalletConnect session
+ *
+ * @param ctx - Wallet context to check
+ * @returns True if using WalletConnect (has signClient and session)
+ *
+ * @example
+ * ```typescript
+ * if (isWalletConnectSession(walletCtx)) {
+ *   // Can safely disconnect WalletConnect
+ *   await walletCtx.signClient.disconnect({
+ *     topic: walletCtx.session.topic,
+ *     reason: { code: 1, message: 'User disconnected' }
+ *   });
+ * }
+ * ```
+ */
+export declare function isWalletConnectSession(ctx: WalletContext): ctx is WalletContext & {
+    signClient: InstanceType<typeof SignClient>;
+    session: SessionTypes.Struct;
+};
+/**
+ * Type guard: Check if wallet context has account data
+ *
+ * @param ctx - Wallet context to check
+ * @returns True if account data is present
+ *
+ * @example
+ * ```typescript
+ * if (hasAccountData(walletCtx)) {
+ *   // Can safely access account properties
+ *   console.log('Account number:', walletCtx.account.accountNumber);
+ *   console.log('Sequence:', walletCtx.account.sequence);
+ * }
+ * ```
+ */
+export declare function hasAccountData(ctx: WalletContext): ctx is WalletContext & {
+    account: AccountData;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/targets/akash/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EACV,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAEnC,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IAEpC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;IAEtD;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC;IAEvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,aAAa,GAAG;IACjF,UAAU,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;IAC5C,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;CAC9B,CAEA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,aAAa,GAAG;IACzE,OAAO,EAAE,WAAW,CAAC;CACtB,CAEA"}

package/dist/targets/akash/types.js

@@ -0,0 +1,54 @@
+/**
+ * Akash Network Type Definitions
+ *
+ * This module provides type-safe interfaces for Akash Network deployment operations.
+ * ALL `any` types from the original kadi-deploy implementation have been replaced
+ * with proper TypeScript interfaces from @cosmjs and @walletconnect libraries.
+ *
+ * Key Improvements from kadi-deploy:
+ * - ✅ ZERO `any` types (was 5 any types)
+ * - ✅ Proper imports from typed libraries
+ * - ✅ Readonly properties to prevent mutations
+ * - ✅ Comprehensive JSDoc documentation
+ *
+ * @module targets/akash/types
+ */
+/**
+ * Type guard: Check if wallet context has WalletConnect session
+ *
+ * @param ctx - Wallet context to check
+ * @returns True if using WalletConnect (has signClient and session)
+ *
+ * @example
+ * ```typescript
+ * if (isWalletConnectSession(walletCtx)) {
+ *   // Can safely disconnect WalletConnect
+ *   await walletCtx.signClient.disconnect({
+ *     topic: walletCtx.session.topic,
+ *     reason: { code: 1, message: 'User disconnected' }
+ *   });
+ * }
+ * ```
+ */
+export function isWalletConnectSession(ctx) {
+    return ctx.signClient !== undefined && ctx.session !== undefined;
+}
+/**
+ * Type guard: Check if wallet context has account data
+ *
+ * @param ctx - Wallet context to check
+ * @returns True if account data is present
+ *
+ * @example
+ * ```typescript
+ * if (hasAccountData(walletCtx)) {
+ *   // Can safely access account properties
+ *   console.log('Account number:', walletCtx.account.accountNumber);
+ *   console.log('Sequence:', walletCtx.account.sequence);
+ * }
+ * ```
+ */
+export function hasAccountData(ctx) {
+    return ctx.account !== undefined;
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/targets/akash/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA8PH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAkB;IAIvD,OAAO,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,GAAkB;IAG/C,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC;AACnC,CAAC"}