Akash Network Skill
Comprehensive skill for working with the Akash Network - the decentralized cloud computing marketplace.
Capabilities
This skill covers all aspects of the Akash Network:
| Area | Description |
|---|---|
| SDL Generation | Create valid Stack Definition Language configurations |
| Deployments | Deploy via CLI, Console API, or SDKs |
| Provider Operations | Set up and manage Akash providers |
| Node Operations | Run full nodes and validators |
| SDK Integration | TypeScript and Go SDK usage |
Critical Rules
NEVER use :latest or omit image tags. Always specify explicit version tags for reproducible deployments.
# CORRECT
image: nginx:1.25.3
image: node:20-alpine
image: postgres:16
# WRONG - will cause deployment issues
image: nginx:latest
image: nginx # implies :latestQuick Reference
SDL Structure
Every SDL file has four required sections:
version: "2.0" # or "2.1" for IP endpoints
services: # Container definitions
profiles: # Compute resources & placement
deployment: # Service-to-profile mappingOptional section for IP endpoints:
endpoints: # IP lease endpoints (requires version 2.1)Minimal SDL Template
version: "2.0"
services:
web:
image: nginx:1.25.3
expose:
- port: 80
as: 80
to:
- global: true
profiles:
compute:
web:
resources:
cpu:
units: 0.5
memory:
size: 512Mi
storage:
size: 1Gi
placement:
dcloud:
pricing:
web:
denom: uakt
amount: 1000
deployment:
web:
dcloud:
profile: web
count: 1Documentation Structure
Core Concepts
- @overview.md - Akash Network introduction and architecture
- @terminology.md - Key terms (lease, bid, dseq, gseq, oseq)
- @pricing.md - Payment with uakt, USDC, IBC denoms
SDL Configuration
- @sdl/schema-overview.md - Version requirements and SDL structure
- @sdl/services.md - Service configuration (image, expose, env, credentials)
- @sdl/compute-resources.md - CPU, memory, storage, and GPU specifications
- @sdl/placement-pricing.md - Provider selection and pricing (uakt/USDC)
- @sdl/deployment.md - Service-to-profile mapping
- @sdl/endpoints.md - IP endpoint configuration (v2.1)
- @sdl/validation-rules.md - All constraints and validation rules
SDL Examples
- @sdl/examples/web-app.md - Simple web deployment
- @sdl/examples/wordpress-db.md - Multi-service with persistent storage
- @sdl/examples/gpu-workload.md - GPU deployment with NVIDIA
- @sdl/examples/ip-lease.md - IP endpoint configuration
Deployment Methods
- @deploy/overview.md - Comparison of deployment options
- @deploy/cli/ - Akash CLI installation and usage
- @deploy/console-api/ - Console API for programmatic deployments
- @deploy/certificates/ - Authentication methods (JWT, mTLS)
SDK Documentation
- @sdk/overview.md - SDK comparison and selection
- @sdk/typescript/ - TypeScript SDK for web and Node.js
- @sdk/go/ - Go SDK for backend services
AuthZ (Delegated Permissions)
- @authz/ - Fee grants and deployment authorization
Provider Operations
- @provider/overview.md - Provider requirements and setup
- @provider/setup/ - Kubernetes and provider installation
- @provider/configuration/ - Attributes, pricing, bid engine
- @provider/operations/ - Monitoring and troubleshooting
Node Operations
- @node/overview.md - Running Akash nodes
- @node/full-node/ - Full node setup and state sync
- @node/validator/ - Validator operations and security
Reference
- @reference/storage-classes.md - beta2, beta3, ram storage
- @reference/gpu-models.md - Supported NVIDIA GPUs
- @reference/ibc-denoms.md - Payment denominations
- @reference/rpc-endpoints.md - Public RPC endpoints
Common Patterns
Environment Variables
services:
app:
env:
- "DATABASE_URL=postgres://..."
- "NODE_ENV=production"Persistent Storage
profiles:
compute:
app:
resources:
storage:
- size: 10Gi
attributes:
persistent: true
class: beta2GPU Workloads
profiles:
compute:
ml:
resources:
gpu:
units: 1
attributes:
vendor:
nvidia:
- model: a100Payment Options
- uakt: Native Akash Token (e.g.,
amount: 1000) - USDC: Via IBC denom (e.g.,
denom: ibc/170C677610AC31DF0904FFE09CD3B5C657492170E7E52372E48756B71E56F2F1)
Additional Resources
- awesome-akash - 100+ production-ready SDL templates
- Akash Network Docs - Official documentation
- Console - Web-based deployment interface
- Console API - REST API documentation
- chain-sdk - Official TypeScript SDK