Skip to content

Commit 0804fd9

Browse files
authored
Merge pull request #999 from akash-network/update-testnet8-guide
chore: update category 0 and 1 testnet-8 instructions
2 parents c9af1e9 + c0c3392 commit 0804fd9

File tree

2 files changed

+102
-74
lines changed

2 files changed

+102
-74
lines changed

src/content/Docs/testnet/testplan/deployment-creation/index.mdx

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -216,6 +216,15 @@ BME conversion (AKT → ACT) happens at **mint time** (Step 1.1.1), not at deplo
216216
akash tx deployment close --dseq <dseq> --from <wallet> -y
217217
```
218218

219+
**Proof to Submit:**
220+
- Pre-deployment ACT balance
221+
- Deployment create tx hash and DSEQ (from tx output)
222+
- Lease status showing service ready:
223+
```bash
224+
provider-services lease-status --dseq <dseq> --provider <provider> --from <wallet>
225+
```
226+
- Post-deployment ACT balance (confirming escrow deducted)
227+
219228
---
220229

221230
### Test 1.2: Create Deployment - Insufficient Funds
@@ -245,6 +254,10 @@ akash tx deployment close --dseq <dseq> --from <wallet> -y
245254
- BME vault state unchanged
246255
- No deployment created
247256

257+
**Proof to Submit:**
258+
- Current ACT balance (showing amount is less than attempted deposit)
259+
- Error message from deployment attempt: `deposit invalid: insufficient balance`
260+
248261
---
249262

250263
### Test 1.3: Create Deployment - Minimum Deposit
@@ -285,6 +298,17 @@ akash tx deployment close --dseq <dseq> --from <wallet> -y
285298
akash tx deployment close --dseq <dseq> --from <wallet> -y
286299
```
287300

301+
**Proof to Submit:**
302+
- Deployment create tx hash with minimum deposit amount (e.g., 1000000uact)
303+
- Deployment state showing active:
304+
```bash
305+
akash query deployment get --owner <user-address> --dseq <dseq> | head -n 10
306+
```
307+
- Bid received (showing provider address and price):
308+
```bash
309+
akash query market bid list --owner <user-address> --dseq <dseq> | head -n 20
310+
```
311+
288312
---
289313

290314
### Test 1.4: Multiple Deployments from Single Wallet
@@ -388,4 +412,13 @@ akash query market lease list --owner <user-address>
388412
akash tx deployment close --dseq <dseq-a> --from <wallet> -y
389413
akash tx deployment close --dseq <dseq-b> --from <wallet> -y
390414
akash tx deployment close --dseq <dseq-c> --from <wallet> -y
391-
```
415+
```
416+
417+
**Proof to Submit:**
418+
- Pre-test ACT balance
419+
- Both deployments showing active (query each individually):
420+
```bash
421+
akash query deployment get --owner <user-address> --dseq <dseq-a> | head -n 10
422+
akash query deployment get --owner <user-address> --dseq <dseq-b> | head -n 10
423+
```
424+
- Post-test ACT balance (confirming multiple escrow deposits deducted)

src/content/Docs/testnet/testplan/pre-flight/index.mdx

Lines changed: 68 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -18,16 +18,19 @@ Before running functional tests, verify the BME module and dependencies are heal
1818
**User Actions:**
1919
1. Check node status:
2020
```bash
21-
akash status
21+
akash status | jq '.sync_info | {latest_block_height, catching_up, latest_block_time}'
2222
```
23-
2. Verify node is synced (catching_up: false)
23+
2. Verify node is synced (`catching_up: false`)
2424
3. Note current block height
2525

2626
**Expected Results:**
2727
- Node responds
2828
- `catching_up: false`
2929
- Block height advancing
3030

31+
**Proof to Submit:**
32+
- Output showing `catching_up: false` and current block height
33+
3134
---
3235

3336
### Test 0.2: BME Module Enabled
@@ -43,39 +46,36 @@ Before running functional tests, verify the BME module and dependencies are heal
4346

4447
**Expected Results:**
4548
- Query succeeds (no "unknown query path" error)
46-
- Returns: CircuitBreakerWarnThreshold, CircuitBreakerHaltThreshold, MinEpochBlocks, EpochBlocksBackoff
49+
- Returns: circuit_breaker_warn_threshold, circuit_breaker_halt_threshold, min_epoch_blocks, epoch_blocks_backoff
50+
51+
**Proof to Submit:**
52+
- Full output of `akash query bme params`
4753

4854
---
4955

5056
### Test 0.3: Oracle Health Check
5157

5258
**Objective:** Verify oracle is providing AKT/USD price feeds with recent timestamps
5359

54-
**Important Note:** The oracle module stores prices using the **base denom** `akt`, not the micro-denom `uakt`. The `--asset-denom` flag, if used, must specify `akt` — using `uakt` or `uact` will return empty results.
55-
5660
**User Actions:**
57-
1. Query oracle prices (pipe through `head` to limit verbose output):
58-
```bash
59-
akash query oracle prices | head -n 50
60-
```
61-
2. Examine the output — confirm price entries exist for `denom: akt` with `base_denom: usd`
62-
3. Check the `timestamp` field on the most recent price entry (first entry in output)
63-
4. Compare the timestamp against current time — it should be within 60 seconds:
61+
1. Query oracle prices and current time:
6462
```bash
63+
akash query oracle prices | head -n 15
6564
date -u +"%Y-%m-%dT%H:%M:%S"
6665
```
67-
5. Verify the price value is reasonable (e.g., AKT ~$0.30-$5.00 range depending on market)
66+
2. Confirm price entries exist for `denom: akt` with `base_denom: usd`
67+
3. Check the `timestamp` field — should be within 60 seconds of current time
68+
4. Verify the price value is reasonable (e.g., AKT ~$0.30-$5.00 range)
6869

6970
**Expected Results:**
7071
- Oracle returns price entries (prices list is NOT empty)
7172
- Entries show `denom: akt` and `base_denom: usd`
72-
- Price value is a reasonable AKT/USD value (non-zero, non-negative)
73+
- Price value is reasonable (non-zero, non-negative)
7374
- Most recent timestamp is within 60 seconds of current UTC time
7475

75-
**If This Test Fails:**
76-
- Empty results → Oracle price feeder may not be running
77-
- Stale timestamps (>60s old) → Price feeder may have stopped submitting
78-
- Unreasonable prices → Check Pyth feed ID configuration
76+
**Proof to Submit:**
77+
- Oracle prices output showing recent timestamp
78+
- Current UTC time for comparison
7979

8080
---
8181

@@ -88,77 +88,66 @@ Before running functional tests, verify the BME module and dependencies are heal
8888
```bash
8989
akash query bme vault-state
9090
```
91-
2. Record baseline values:
92-
- Balances (VaultAKT)
93-
- TotalBurned
94-
- TotalMinted
95-
- RemintCredits
91+
2. Record baseline values for later comparison
9692

9793
**Expected Results:**
9894
- Query succeeds
99-
- All fields returned (may be zero on fresh testnet)
100-
- Document baseline for later comparison
95+
- All fields returned: balances, total_burned, total_minted, remint_credits
96+
97+
**Proof to Submit:**
98+
- Full output of `akash query bme vault-state`
10199

102100
---
103101

104102
### Test 0.5: Collateral Ratio Check
105103

106104
**Objective:** Verify collateral ratio calculation is working
107105

106+
**Note:** Tests 0.5 and 0.6 use the same command. This test focuses on the `collateral_ratio` value; Test 0.6 focuses on the `status` field and flags.
107+
108108
**User Actions:**
109-
1. Query BME status (collateral ratio is included in output):
109+
1. Query BME status:
110110
```bash
111111
akash query bme status
112112
```
113113
2. Locate the `collateral_ratio` field in the response
114+
3. Verify value is reasonable (typically 0.9 - 2.0+ range when healthy)
114115

115116
**Expected Results:**
116117
- `collateral_ratio` field is present with a decimal value
117-
- On fresh testnet with no activity, may return `0.000000000000000000`
118-
- Non-error response confirms module is calculating correctly
118+
- Value is > `halt_threshold` (0.90) for healthy operation
119+
- Value is > `warn_threshold` (0.95) for normal operation
119120

120-
**Example output:**
121-
```yaml
122-
collateral_ratio: "0.950000000000000000"
123-
halt_threshold: "0.900000000000000000"
124-
mints_allowed: true
125-
...
126-
```
121+
**Proof to Submit:**
122+
- Output showing `collateral_ratio` value
127123

128124
---
129125

130126
### Test 0.6: Mint Status Check
131127

132128
**Objective:** Verify BME mint status is Healthy (required for most testing)
133129

130+
**Note:** Uses same command as Test 0.5. This test focuses on the `status` field and boolean flags.
131+
134132
**User Actions:**
135-
1. Query BME status:
133+
1. Query BME status (if not already captured in 0.5):
136134
```bash
137135
akash query bme status
138136
```
139137
2. Check the `status` field and related flags
140138

141-
**Example Output:**
142-
```yaml
143-
collateral_ratio: "0.999328857700195767"
144-
halt_threshold: "0.900000000000000000"
145-
mints_allowed: true
146-
refunds_allowed: true
147-
status: mint_status_healthy
148-
warn_threshold: "0.950000000000000000"
149-
```
150-
151139
**Expected Results:**
152140
- `status`: `mint_status_healthy` (required to proceed with most tests)
153141
- `mints_allowed`: `true`
154142
- `refunds_allowed`: `true`
155-
- `warn_threshold`: `0.95` (status changes to warning below this)
156-
- `halt_threshold`: `0.90` (mints halt below this)
157143

158144
**If status is NOT `mint_status_healthy`:**
159-
- `mint_status_warning`: Collateralization Ratio dropped below 0.95 — investigate
160-
- `mint_status_halt_cr`: Collateralization Ratio dropped below 0.90 — mints blocked, investigate before proceeding
161-
- `mint_status_halt_oracle`: Oracle failure — investigate oracle health (Test 0.3)
145+
- `mint_status_warning`: Collateral Ratio below 0.95 — investigate
146+
- `mint_status_halt_cr`: Collateral Ratio below 0.90 — mints blocked
147+
- `mint_status_halt_oracle`: Oracle failure — check Test 0.3
148+
149+
**Proof to Submit:**
150+
- Output showing `status: mint_status_healthy` and `mints_allowed: true`
162151

163152
---
164153

@@ -171,40 +160,41 @@ warn_threshold: "0.950000000000000000"
171160
```bash
172161
akash query bank total --denom uakt
173162
```
174-
2. Query total ACT supply (OutstandingACT):
163+
2. Query total ACT supply:
175164
```bash
176165
akash query bank total --denom uact
177166
```
178-
3. Document baseline values
179167

180168
**Expected Results:**
181-
- AKT supply returned (note for inflation tracking in later tests)
169+
- AKT supply returned (baseline for inflation tracking)
182170
- ACT supply returned (may be 0 on fresh testnet)
183171

172+
**Proof to Submit:**
173+
- Both supply values (uakt and uact amounts)
174+
184175
---
185176

186177
### Test 0.8: Vault State Baseline (Pending Operations Check)
187178

188-
**Objective:** Record vault state baseline and verify no unexpected pending operations
179+
**Objective:** Verify no unexpected pending operations
189180

190-
**Note:** There is no direct `pending-records` CLI query. Pending operations are inferred by comparing vault-state before and after operations, and by observing state changes across epoch boundaries.
181+
**Note:** Pending operations are inferred by comparing `balances.uakt` vs `remint_credits`. If `balances.uakt` > `remint_credits`, there are pending mint operations.
191182

192183
**User Actions:**
193184
1. Query current vault state:
194185
```bash
195186
akash query bme vault-state
196187
```
197-
2. Record the current values as a baseline
198-
3. Query again after ~1-2 minutes (one epoch) to verify state is stable:
199-
```bash
200-
sleep 90
201-
akash query bme vault-state
202-
```
188+
2. Compare `balances.uakt` to `remint_credits`
203189

204190
**Expected Results:**
205-
- Vault state query succeeds
206-
- If vault state is changing unexpectedly between queries (without you initiating operations), there may be stale operations from prior testing — investigate before proceeding
207-
- Stable state indicates clean baseline for testing
191+
- Query succeeds
192+
- If `balances.uakt``remint_credits`: no significant pending operations
193+
- If `balances.uakt` > `remint_credits`: pending mints exist (may be from prior testing)
194+
195+
**Proof to Submit:**
196+
- Vault state output
197+
- Note if any pending operations detected
208198

209199
---
210200

@@ -213,7 +203,7 @@ warn_threshold: "0.950000000000000000"
213203
**Objective:** Prepare test wallet with AKT for subsequent tests
214204

215205
**User Actions:**
216-
1. Create a new test wallet:
206+
1. Create a new test wallet (or use existing):
217207
```bash
218208
akash keys add test-account
219209
```
@@ -227,13 +217,16 @@ warn_threshold: "0.950000000000000000"
227217

228218
4. Verify balance:
229219
```bash
230-
akash query bank balances <test-wallet-address>
220+
akash query bank balances <your-wallet-address>
231221
```
232222

233223
**Expected Results:**
234-
- Wallet created successfully
224+
- Wallet exists with AKT balance
235225
- After faucet: balance shows `500000000uakt` (500 AKT)
236-
- No ACT balance initially (`uact` not listed)
226+
227+
**Proof to Submit:**
228+
- Wallet address
229+
- Balance output showing AKT
237230

238231
---
239232

@@ -246,9 +239,11 @@ warn_threshold: "0.950000000000000000"
246239
```bash
247240
akash query provider list
248241
```
249-
2. Verify at least one provider is online
242+
2. Verify at least one provider is listed
250243

251244
**Expected Results:**
252-
- At least one provider listed
253-
- Provider status indicates availability
254-
- If no providers, deployment tests (Category 1-3) cannot proceed
245+
- At least one provider listed with `host_uri`
246+
- If no providers, deployment tests (Category 1-3) cannot proceed
247+
248+
**Proof to Submit:**
249+
- Provider list output showing at least one provider

0 commit comments

Comments
 (0)