feat: Create bucket (#10)

* add local network option

* account derivation

* add account scenarios

* add helpers

* derive N accounts

* add missing network info

* remove preflight

* upload deps and package.json

* WIP: account generation + SIWE

* clean up toError

* clean up read envs

* clean up MspClient config

* lint

* WIP: having sequential index for each VU

* common entry point for all tests

* common account derivation step

* clean siwe + getProfile test

* point to index.ts entry point

* mute/restor metrics functions

* update derive accounts

* update authentication

* run with logs & index allocator script

* minor improvements in config

* example getProfile

* clean up

* fmt & clean up

* update download test

* clean up

* update download test

* improve download test

* simplify running test command

* clean up

* update readme

* fmt

* clean up unauth calls

* remove duplicated function

* create bucket example

* script to fund accounts

* create bucket related functions

* types definition

* user api to interact with the chain

* utils function file

* remove SIWE from bucket creation example

* batch fund accounts process

* fmt

* set default log level to info

* fix account derivation to start over from first index

* log account balance

* update package and lock file

* lint

* minor fixes

* lint

* fix merge conflicts

* improve readme with commands descriptions

* remove unused methods for index allocation. Keep only sequential index

* simplify fund accounts

* amount can be set only with decimal values

* remove the dry-run mode

* add some docs to fund accounts script

* fmt

* remove unused script

* add main function as entry point and improve types

Author: ftheirs

README.md

@@ -45,7 +45,35 @@ Local notes:
 - `pnpm fmt:fix` — apply formatting
 - `pnpm lint` — check lint rules
 - `pnpm lint:fix` — apply safe lint fixes
-- `pnpm test:run scenarios/<file>.yml` — run any scenario (build + logs wrapper)
+- `pnpm typecheck` — TypeScript typecheck (no emit)
+- `pnpm build` — compile to `./dist`
+- `pnpm with-logs -- <command>` — run `<command>` with per-run JSONL logs + a local index allocator
+- `pnpm run:with-logs -- <command>` — build, then run `<command>` with logs + index allocator
+- `pnpm test:run <scenario.yml>` — run any Artillery scenario (via the logs/index wrapper)
+- `pnpm test:unauth` — unauthenticated MSP endpoints scenario
+- `pnpm test:examples.getProfile` — SIWE + `getProfile` scenario
+- `pnpm test:examples.createBucket` — derive account + create a bucket scenario
+- `pnpm test:download` — SIWE + download file scenario
+- `pnpm util:fund-accounts` — fund derived test accounts
+
+## Fund accounts utility
+
+`pnpm util:fund-accounts` is a small helper to print or fund EVM accounts derived from a mnemonic.
+
+Print first 10 derived addresses:
+
+```bash
+TEST_MNEMONIC="..." pnpm util:fund-accounts
+```
+
+Fund first 10 derived addresses (0.01 native token each):
+
+```bash
+NETWORK=local TEST_MNEMONIC="..." pnpm util:fund-accounts -- --privateKey 0x... --amount 0.01 --start 0 --count 10
+```
+
+Notes:
+- `--batchSize` controls parallelism per batch (default: 10). If `batchSize > count`, only `count` transfers are sent.
 
 List available scenarios:
 
@@ -62,7 +90,7 @@ NETWORK=stagenet pnpm test:run scenarios/<file>.yml
 Examples (replace the scenario file with anything from `ls scenarios`):
 
 ```bash
-NETWORK=local pnpm test:run scenarios/artillery.msp-unauth.yml
+NETWORK=local pnpm test:run scenarios/msp.unauth.yml
 ```
 
 ```bash
@@ -93,11 +121,11 @@ Env vars:
 Examples:
 
 ```bash
-LOG_LEVEL=debug NETWORK=testnet pnpm test:run scenarios/artillery.msp-unauth.yml
+LOG_LEVEL=debug NETWORK=testnet pnpm test:run scenarios/msp.unauth.yml
 ```
 
 ```bash
-LOG_LEVEL=info LOG_FILE=./artillery.log NETWORK=testnet pnpm test:run scenarios/artillery.msp-unauth.yml
+LOG_LEVEL=info LOG_FILE=./artillery.log NETWORK=testnet pnpm test:run scenarios/msp.unauth.yml
 ```
 
 ## Standalone MSP unauth load test
@@ -111,7 +139,7 @@ It uses `NETWORK=testnet|stagenet` and the MSP base URL from `src/networks.ts`.
 Run:
 
 ```bash
-NETWORK=stagenet pnpm test:run scenarios/artillery.msp-unauth.yml
+NETWORK=stagenet pnpm test:run scenarios/msp.unauth.yml
 ```
 
 Knobs (optional):

package.json

@@ -15,14 +15,16 @@
     "with-logs": "pnpm exec tsx scripts/run-scenario.ts --",
     "run:with-logs": "pnpm build && pnpm with-logs",
     "test:run": "pnpm run:with-logs artillery run",
-
     "test:unauth": "pnpm test:run scenarios/msp.unauth.yml",
     "test:examples.getProfile": "pnpm test:run scenarios/examples.getProfile.yml",
-    "test:download": "pnpm test:run scenarios/download.yml"
+    "test:examples.createBucket": "pnpm test:run scenarios/examples.createBucket.yml",
+    "test:download": "pnpm test:run scenarios/download.yml",
+    "util:fund-accounts": "pnpm exec tsx scripts/fund-accounts.ts"
   },
   "dependencies": {
     "@storagehub-sdk/core": "0.4.0",
     "@storagehub-sdk/msp-client": "0.4.0",
+    "@polkadot/api": "^12.4.2",
     "artillery": "^2.0.0",
     "pino": "^10.1.0",
     "viem": "^2.42.1"