Skip to content
Open

Bme #1056

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/content/About_Page/_pricing/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ disableTableOfContents: true
contentWidth: "full"
---

Akash employs a unique "Reverse Auction" system. Network deployers specify the preferred price for their desired resources, and providers compete to fulfill the request. This approach consistently yields substantially lower costs and greater choice while maintaining self-sovereign control. Akash operates as an open-source, community-driven platform, powered by a L1 blockchain and the AKT utility token.
Akash employs a unique "Reverse Auction" system. Network deployers specify the preferred price for their desired resources, and providers compete to fulfill the request. This approach consistently yields substantially lower costs and greater choice while maintaining self-sovereign control. Akash operates as an open-source, community-driven platform, powered by a L1 blockchain and the AKT utility token. With BME, deployment pricing and provider payouts use ACT (USD-pegged compute credit); AKT is used for staking, governance, and gas.
8 changes: 4 additions & 4 deletions src/content/Docs/api-documentation/getting-started/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Choose the right API for your use case:

- **Blockchain REST/RPC** — Query data from the chain directly (gRPC, REST, RPC on an Akash node). Use this when your app needs to read chain state or submit transactions to the blockchain.
- **Console API** — Query indexed data (stats, deployments, providers) and manage deployments for Console managed wallets. This is **not** a node: it serves aggregated/indexed data and managed-wallet flows, not raw chain queries.
- **Chain SDK** — Integrate with Akash in Go or TypeScript/JavaScript. Use your own wallet (AKT/USDC) or custodial flows.
- **Chain SDK** — Integrate with Akash in Go or TypeScript/JavaScript. Use your own wallet; deployment funding is in **ACT** (credit card or AKT→ACT); top-up with AKT when circuit breaker is in effect.

---

Expand All @@ -26,7 +26,7 @@ Query blockchain state and submit transactions via an Akash node. Use this when

## Akash Blockchain SDK

Build deployment and provider management into your app with the official chain SDK (Go and TypeScript/JavaScript). Integrate with the blockchain using your own wallet or custodial wallets; pay with AKT or USDC.
Build deployment and provider management into your app with the official chain SDK (Go and TypeScript/JavaScript). Integrate with the blockchain using your own wallet or custodial wallets; fund deployments with **ACT** (mint from AKT or via credit card); keep AKT for gas.

- **[Akash SDK](/docs/api-documentation/sdk)** - Official Go and JavaScript/TypeScript SDKs
- **[Installation Guide](/docs/api-documentation/sdk/installation)** - Get started with SDK installation
Expand Down Expand Up @@ -59,7 +59,7 @@ The Console API serves **indexed data** (providers, stats, deployments) and **ma

### When to use the Akash Blockchain SDK
- Full blockchain integration with your own wallet
- Pay with AKT or USDC cryptocurrency
- Fund deployments with ACT (USD-pegged); use AKT for gas and for ACT top-up when circuit breaker in effect
- Build deployment automation tools
- Create custom deployment workflows
- Build provider management dashboards
Expand All @@ -86,7 +86,7 @@ The Console API serves **indexed data** (providers, stats, deployments) and **ma
**Choose your integration method:**

- **Query the chain directly (node)?** → [Node API Layer](/docs/node-operators/architecture/api-layer) - gRPC, REST, RPC on an Akash node
- **Blockchain integration in code?** → [Use the Blockchain SDK](/docs/api-documentation/sdk) - Pay with AKT/USDC, manage your own wallet
- **Blockchain integration in code?** → [Use the Blockchain SDK](/docs/api-documentation/sdk) - Fund with ACT (or AKT when circuit breaker), manage your own wallet
- **Credit card deployments?** → [Managed Wallet API](/docs/api-documentation/console-api) - No wallet needed, pay with credit card via Console
- **Indexed network data (providers, GPU, stats)?** → [Console API — Network Data](/docs/api-documentation/rest-api) - Public endpoints, not a node

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -235,7 +235,7 @@ func CreateDeployment(ctx context.Context, sdl []byte) (*Deployment, error)
// **Good: Explain complex logic
// Calculate bid price using the formula:
// price = (cpu * cpuPrice) + (memory * memPrice) + (storage * storagePrice)
// Prices are in uakt per unit per block.
// Prices are in uact per unit per block (ACT is the deployment/payment denom).
price := calculateBidPrice(resources)

// **Bad: Obvious comments
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -800,7 +800,7 @@ profiles:
akash:
pricing:
web:
denom: uakt
denom: uact
amount: 1000
deployment:
web:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -363,7 +363,7 @@ Use for important information:
```markdown
**Note:** This feature requires provider-services v0.10.0 or later.

**Warning:** This command will close your deployment and refund remaining escrow.
**Warning:** This command will close your deployment and refund remaining escrow (ACT).

**Tip:** Use `--dry-run` to preview changes without applying them.

Expand Down Expand Up @@ -534,7 +534,7 @@ Content...

Before you begin, ensure you have:
- Go 1.25.0 or later installed
- An Akash wallet with at least 5 AKT
- An Akash wallet with ACT for deployment (and AKT for gas); e.g. at least 5 ACT + some AKT
- Basic command-line knowledge

**Not set up yet?** See [Development Environment](/docs/developers/contributing/development-environment)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -123,12 +123,12 @@ Use the SDL Builder or choose a template, then customize your configuration:
Set the initial deposit for your deployment:

![Deployment Review](/images/docs/console/8-deployment-review.png)
*Set your deposit amount - this is held in escrow and refunded when you close the deployment*
*Set your deposit amount - this is held in escrow (ACT) and refunded when you close the deployment*

The deposit:
- Is held in escrow to pay for your deployment
The deposit (in **ACT**):
- Is held in escrow to pay for your deployment; create deployments with ACT only (or AKT when circuit breaker is in effect)
- Gets refunded when you close the deployment
- Automatically tops up if running low
- You can top up with ACT (or AKT when circuit breaker is active) if running low

#### 3. Select a Provider Bid

Expand Down Expand Up @@ -224,7 +224,7 @@ Stop your deployment and reclaim your deposit:
1. Select your deployment
2. Click **"Close"** or **"Stop"**
3. Confirm the action
4. Your deployment will stop and remaining escrow will be refunded
4. Your deployment will stop and remaining escrow (ACT) will be refunded

![Deployment Close Confirmation](/images/docs/console/17-deployment-close.png)
*Confirm deployment closure and reclaim your deposit*
Expand All @@ -234,14 +234,14 @@ Stop your deployment and reclaim your deposit:

### Manage Billing and Credits

View your trial credits and add payment methods:
View your trial credits and add payment methods (credits are in **ACT**):

![Billing and Credits](/images/docs/console/18-billing-credits.png)
*Manage your trial credits, payment methods, and billing*

You can:
- Check remaining trial credits
- Add or update credit card
- Check remaining trial credits (ACT)
- Add or update credit card (funds ACT)
- View spending history
- Convert to pay-as-you-go after trial expires

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ After connecting, you'll see:
### Main Dashboard
- **Active Deployments** - Running deployments and status
- **Quick Actions** - Deploy button, add funds, settings
- **Account Overview** - Balance, escrow, and spending
- **Account Overview** - Balance, escrow (ACT), and spending

![Deployments Dashboard](/images/docs/console/15-deployments-dashboard.png)
*Your Console dashboard showing deployments and quick actions*
Expand Down Expand Up @@ -143,12 +143,12 @@ After connecting, you'll see:
After clicking "Create Deployment":

1. **Set Deposit Amount**
- Default is usually fine (0.5-5 AKT depending on resources)
- This is held in escrow, refunded when you close
- Not a fee—just a security deposit
- Default is usually fine (in **ACT** depending on resources)
- This is held in escrow (ACT), refunded when you close
- Not a fee—just a security deposit. Use ACT only unless circuit breaker is in effect.

![Deposit Screen](/images/docs/console/wallet/6-deposit-amount-wallet.png)
*Set your deposit amount - held in escrow and refunded when you close*
*Set your deposit amount (ACT) - held in escrow and refunded when you close*

2. **Approve Transaction in Wallet**

Expand Down Expand Up @@ -305,7 +305,7 @@ Stop your deployment and reclaim your deposit:
1. **Deposit (Escrow)**
- Held while deployment runs
- Fully refunded when you close
- Typical: 0.5 AKT
- Typical: deposit in ACT (e.g. ~5 ACT); gas in AKT

2. **Provider Fees**
- Paid per block from your deposit
Expand All @@ -320,42 +320,40 @@ Stop your deployment and reclaim your deposit:
### Cost Example

**Simple web app (0.5 CPU, 512MB RAM, 512MB storage):**
- Deposit: 0.5 AKT (~$1-2, refundable)
- Cost: Often less than $5/month
- Gas: ~0.1 AKT total
- Deposit: in **ACT** (~$1-2 equivalent, refundable)
- Cost: Often less than $5/month (paid from ACT escrow)
- Gas: ~0.1 AKT total (network fees in AKT)

**Your 0.5 AKT deposit is held in escrow while hosting runs, and is fully refundable when you close the deployment.**
**Your deposit (ACT) is held in escrow while hosting runs and is fully refundable when you close the deployment. Use ACT only unless the circuit breaker is in effect.**

---

## Wallet vs Trial Comparison

| Feature | Console with Wallet | Trial (Managed Wallet) |
|---------|-------------------|----------------------|
| **Setup** | Need wallet + AKT | Just email + credit card |
| **Setup** | Need wallet + ACT (and AKT for gas) | Just email + credit card |
| **Deployment Limit** | None (run forever) | 24 hours max |
| **Cost** | Pay with AKT | Pay with credit card |
| **Deposit** | 0.5 AKT (refundable) | Included in credits |
| **Cost** | Pay with ACT (mint from AKT or buy) | Pay with credit card (funds ACT) |
| **Deposit** | ACT (refundable) | Included in credits (ACT) |
| **Control** | Full blockchain access | Managed by Console |
| **Best For** | Crypto users | Beginners |

---

## Common Questions

### "How much AKT do I need?"
**Answer:** Start with **5 AKT**:
- 0.5 AKT for deposit (refundable)
- Rest for provider payments and gas fees
### "How much do I need?"
**Answer:** Fund your deployment with **ACT** (deposit is in ACT, refundable). Keep some **AKT** for gas fees. You can get ACT by burning AKT or via credit card in Console.

### "Can I use trial AND wallet?"
**Answer:**
- **Trial** - $100 free credits for 30 days, 24-hour deployment limit
- **Credit Card** - Once you add a credit card, you keep your trial credits but can't go back to trial-only mode
- **Your Wallet** - Use your own Keplr/Leap wallet for production deployments with no limits

### "What if I run out of AKT in escrow?"
**Answer:** Your deployment will close automatically. Monitor your escrow balance and add more AKT if needed (click "Add Funds" on your deployment).
### "What if I run out of ACT in escrow?"
**Answer:** Your deployment will close automatically. Monitor your escrow balance and add more **ACT** if needed (click "Add Funds" on your deployment). When the circuit breaker is in effect, you can top up with **AKT** to keep deployments running; otherwise use ACT only.

### "My wallet isn't connecting"
**Solution:**
Expand All @@ -374,7 +372,7 @@ Stop your deployment and reclaim your deposit:

### "Deployment closed unexpectedly"
**Possible causes:**
- Ran out of funds in escrow
- Ran out of ACT (or AKT when CB) in escrow
- Provider went offline
- Deployment configuration error

Expand All @@ -385,7 +383,7 @@ Stop your deployment and reclaim your deposit:
## Tips for Success

- **Start with templates** - Use Hello World for your first deployment
- **Monitor your escrow** - Keep an eye on your deposit balance
- **Monitor your escrow** - Keep an eye on your ACT deposit balance
- **Check provider stats** - Choose providers with high uptime
- **Use logs** - Logs are your best debugging tool
- **Save your SDLs** - Keep copies of working configurations
Expand Down
2 changes: 1 addition & 1 deletion src/content/Docs/developers/deployment/akash-sdk/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ const client = await AkashClient.create({
// Create deployment
const deployment = await client.deployment.create({
sdl: mySDLConfig,
deposit: '5000000uakt'
deposit: '5000000uact'
})

console.log('Deployment created:', deployment.dseq)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -524,15 +524,15 @@ placement:
region: us-west
pricing:
web:
denom: uakt
denom: uact
amount: 100

eu-central:
attributes:
region: eu-central
pricing:
web:
denom: uakt
denom: uact
amount: 120
```

Expand All @@ -553,7 +553,7 @@ placement:
- akash1... # Required auditor
pricing:
web:
denom: uakt
denom: uact
amount: 150
```

Expand All @@ -576,7 +576,7 @@ placement:
ssd: true
pricing:
web:
denom: uakt
denom: uact
amount: 200
```

Expand Down Expand Up @@ -847,16 +847,16 @@ profiles:
- akash1365yvmc4s7awdyj3n2sav7xfx76adc6dnmlx63
pricing:
frontend:
denom: uakt
denom: uact
amount: 150
backend:
denom: uakt
denom: uact
amount: 200
database:
denom: uakt
denom: uact
amount: 250
cache:
denom: uakt
denom: uact
amount: 100

deployment:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -79,17 +79,9 @@ memory:

## Cost Management

### Use USDC for Stable Pricing

For predictable costs, use USDC instead of AKT:

```yaml
pricing:
web:
denom: ibc/170C677610AC31DF0904FFE09CD3B5C657492170E7E52372E48756B71E56F2F1
amount: 100
```
### Fund with ACT (Stable USD-Pegged Pricing)

Deployment funding uses **ACT** (USD-pegged compute credit). Fund your deployment with ACT (via Console credit card or by burning AKT to mint ACT). Use ACT for escrow unless the circuit breaker is in effect, in which case you can top up with AKT to keep deployments running. The network uses ACT (denom `uact`) for escrow and provider payouts.

---

Expand Down Expand Up @@ -372,7 +364,7 @@ placement:
datacenter: equinix # Specific datacenter
pricing:
web:
denom: uakt
denom: uact
amount: 100
```

Expand All @@ -396,7 +388,7 @@ placement:
- akash1... # Required auditor
pricing:
web:
denom: uakt
denom: uact
amount: 150 # May cost more for audited providers
```

Expand Down Expand Up @@ -448,7 +440,7 @@ placement:
test:
pricing:
web:
denom: uakt
denom: uact
amount: 10 # Sandbox tokens are free from faucet
```

Expand Down
2 changes: 1 addition & 1 deletion src/content/Docs/developers/deployment/akash-sdl/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ profiles:
akash:
pricing:
web:
denom: uakt
denom: uact
amount: 100
deployment:
web:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ profiles:
region: us-west
pricing:
web:
denom: uakt
denom: uact
amount: 100

deployment:
Expand Down Expand Up @@ -318,7 +318,7 @@ placement:
region: us-west
pricing: # Required: max bid per service
web:
denom: uakt
denom: uact
amount: 100 # uakt per block (~6 sec)
```

Expand Down Expand Up @@ -403,7 +403,7 @@ profiles:
akash:
pricing:
web:
denom: uakt
denom: uact
amount: 100
deployment:
web:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ profiles:
akash:
pricing:
web:
denom: uakt
denom: uact
amount: 100
deployment:
web:
Expand Down Expand Up @@ -195,7 +195,7 @@ provider-services tx deployment close \
--from $AKASH_KEY_NAME
```

**Note:** This closes the deployment and all associated leases. Funds in escrow are returned.
**Note:** This closes the deployment and all associated leases. Funds in escrow (ACT) are returned. Recommend funding deployments with ACT unless the circuit breaker is in effect.

---

Expand Down
Loading
Loading