vana-cli 0.29.2 → 0.30.0

package/README.md

@@ -73,8 +73,10 @@ it from escrow and `--max-fee` to cap it. The rest of the group:
 | `vana app escrow balance\|fund`                      | what the app can spend, and funding it                                          |
 | `vana app onchain <scope> --owner <addr>`            | data point version, hashes, deletion state                                      |
 
-Everything defaults to **moksha**, the testnet; `--network mainnet` spends
-real money and is never implied.
+Everything defaults to **mainnet**, where your data and apps live. Paying is
+never implied: a paid read stops with the exact price until you add `--pay`,
+and `--max-fee` caps it. `--network moksha` is the testnet, where fees are
+play money.
 
 ## For agents
 
@@ -88,6 +90,7 @@ Install the skills that teach an agent each half:
 
 ```bash
 vana skills install builder        # ask for access, read, pay
+vana skills install agent-access   # give your own agent (OpenClaw, Hermes) scoped, paid access
 vana skills install connect-data   # collect your own data
 ```
 

package/dist/cli/index.js

@@ -203,7 +203,7 @@ More:
     for (const [flags, description] of GLOBAL_FLAG_DEFS) {
         program.option(flags, description);
     }
-    program.addOption(new Option("--network <network>", "Vana network for protocol operations (default: moksha)").choices([...VANA_NETWORKS]));
+    program.addOption(new Option("--network <network>", "Vana network: mainnet (default) or moksha, the testnet").choices([...VANA_NETWORKS]));
     program.hook("preAction", (_thisCommand, actionCommand) => {
         mergeParsedGlobalOptions(parsedOptions, actionCommand);
     });

package/dist/core/network.d.ts

@@ -3,12 +3,14 @@
  *
  * The owner-side commands keep using {@link getEnvConfig} from constants.ts
  * (a dev/prod host axis) untouched. Builder commands need one resolved
- * object carrying the chain and every host, selected with `--network`:
- * moksha is the default because its fees are play money, and mainnet spends
- * real USDC.e from the app's escrow.
+ * object carrying the chain and every host, selected with `--network`.
+ * mainnet is the default: it is where a person's data and apps live. Paying
+ * is never implied by it; a paid read still stops at exit 4 until `--pay`,
+ * and `--max-fee` caps it. `--network moksha` is the testnet, where fees
+ * are play money.
  *
  * `VANA_ENV=dev` swaps in the dev host set (internal use; dev serves the
- * moksha chain).
+ * moksha chain), and there moksha stays the default.
  */
 export type VanaNetworkName = "moksha" | "mainnet";
 export declare const VANA_NETWORKS: readonly VanaNetworkName[];
@@ -44,7 +46,8 @@ export declare function isVanaNetworkName(value: string): value is VanaNetworkNa
 /**
  * Resolve a network selection into hosts and chain.
  *
- * @param name - `--network` value; falls back to `VANA_NETWORK`, then moksha.
+ * @param name - `--network` value; falls back to `VANA_NETWORK`, then
+ *   mainnet (moksha under `VANA_ENV=dev`, which has no mainnet hosts).
  * @param env - process env, injectable for tests.
  * @throws {UnknownNetworkError} for a name outside {@link VANA_NETWORKS}.
  */

package/dist/core/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/core/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnD,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAG1C,CAAC;AAEX,eAAO,MAAM,eAAe,EAAE,eAA0B,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,wEAAwE;IACxE,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf;0EACsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAsCD,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAM1C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,CAAC,EAAE,MAAM,EACb,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,eAAe,CAYjB"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/core/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnD,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAG1C,CAAC;AAEX,eAAO,MAAM,eAAe,EAAE,eAA2B,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,wEAAwE;IACxE,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf;0EACsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAsCD,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAM1C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,CAAC,EAAE,MAAM,EACb,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,eAAe,CAajB"}

package/dist/core/network.js

@@ -3,18 +3,20 @@
  *
  * The owner-side commands keep using {@link getEnvConfig} from constants.ts
  * (a dev/prod host axis) untouched. Builder commands need one resolved
- * object carrying the chain and every host, selected with `--network`:
- * moksha is the default because its fees are play money, and mainnet spends
- * real USDC.e from the app's escrow.
+ * object carrying the chain and every host, selected with `--network`.
+ * mainnet is the default: it is where a person's data and apps live. Paying
+ * is never implied by it; a paid read still stops at exit 4 until `--pay`,
+ * and `--max-fee` caps it. `--network moksha` is the testnet, where fees
+ * are play money.
  *
  * `VANA_ENV=dev` swaps in the dev host set (internal use; dev serves the
- * moksha chain).
+ * moksha chain), and there moksha stays the default.
  */
 export const VANA_NETWORKS = [
     "moksha",
     "mainnet",
 ];
-export const DEFAULT_NETWORK = "moksha";
+export const DEFAULT_NETWORK = "mainnet";
 const NETWORKS = {
     moksha: {
         name: "moksha",
@@ -63,12 +65,14 @@ export function isVanaNetworkName(value) {
 /**
  * Resolve a network selection into hosts and chain.
  *
- * @param name - `--network` value; falls back to `VANA_NETWORK`, then moksha.
+ * @param name - `--network` value; falls back to `VANA_NETWORK`, then
+ *   mainnet (moksha under `VANA_ENV=dev`, which has no mainnet hosts).
  * @param env - process env, injectable for tests.
  * @throws {UnknownNetworkError} for a name outside {@link VANA_NETWORKS}.
  */
 export function resolveNetwork(name, env = process.env) {
-    const raw = (name ?? env.VANA_NETWORK ?? DEFAULT_NETWORK).toLowerCase();
+    const fallback = env.VANA_ENV === "dev" ? "moksha" : DEFAULT_NETWORK;
+    const raw = (name ?? env.VANA_NETWORK ?? fallback).toLowerCase();
     if (!isVanaNetworkName(raw)) {
         throw new UnknownNetworkError(raw);
     }

package/dist/core/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/core/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,QAAQ;IACR,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAoB,QAAQ,CAAC;AA0BzD,MAAM,QAAQ,GAA0D;IACtE,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,KAAK;QACd,gBAAgB,EAAE,4CAA4C;QAC9D,UAAU,EAAE,gCAAgC;QAC5C,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,sBAAsB;QACnC,eAAe,EAAE,gCAAgC;QACjD,WAAW,EAAE,4BAA4B;QACzC,MAAM,EAAE,6BAA6B;KACtC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,4CAA4C;QAC9D,UAAU,EAAE,yBAAyB;QACrC,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,sBAAsB;QACnC,eAAe,EAAE,gCAAgC;QACjD,WAAW,EAAE,qBAAqB;QAClC,MAAM,EAAE,sBAAsB;KAC/B;CACF,CAAC;AAEF,sEAAsE;AACtE,MAAM,SAAS,GAAG;IAChB,UAAU,EAAE,6BAA6B;IACzC,UAAU,EAAE,8BAA8B;IAC1C,uDAAuD;IACvD,oEAAoE;IACpE,iEAAiE;IACjE,WAAW,EAAE,0BAA0B;IACvC,eAAe,EAAE,oCAAoC;CAC7C,CAAC;AAEX,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAChB;IAA5B,YAA4B,KAAa;QACvC,KAAK,CACH,oBAAoB,KAAK,uBAAuB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5E,CAAC;QAHwB,UAAK,GAAL,KAAK,CAAQ;QAIvC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAQ,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAa,EACb,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,YAAY,IAAI,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;IACxE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC;IACnC,IAAI,GAAG,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,kEAAkE;QAClE,MAAM,IAAI,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAChF,CAAC"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/core/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,QAAQ;IACR,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAoB,SAAS,CAAC;AA0B1D,MAAM,QAAQ,GAA0D;IACtE,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,KAAK;QACd,gBAAgB,EAAE,4CAA4C;QAC9D,UAAU,EAAE,gCAAgC;QAC5C,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,sBAAsB;QACnC,eAAe,EAAE,gCAAgC;QACjD,WAAW,EAAE,4BAA4B;QACzC,MAAM,EAAE,6BAA6B;KACtC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,4CAA4C;QAC9D,UAAU,EAAE,yBAAyB;QACrC,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,sBAAsB;QACnC,eAAe,EAAE,gCAAgC;QACjD,WAAW,EAAE,qBAAqB;QAClC,MAAM,EAAE,sBAAsB;KAC/B;CACF,CAAC;AAEF,sEAAsE;AACtE,MAAM,SAAS,GAAG;IAChB,UAAU,EAAE,6BAA6B;IACzC,UAAU,EAAE,8BAA8B;IAC1C,uDAAuD;IACvD,oEAAoE;IACpE,iEAAiE;IACjE,WAAW,EAAE,0BAA0B;IACvC,eAAe,EAAE,oCAAoC;CAC7C,CAAC;AAEX,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAChB;IAA5B,YAA4B,KAAa;QACvC,KAAK,CACH,oBAAoB,KAAK,uBAAuB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5E,CAAC;QAHwB,UAAK,GAAL,KAAK,CAAQ;QAIvC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAQ,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAa,EACb,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC;IACrE,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,YAAY,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC;IACnC,IAAI,GAAG,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,kEAAkE;QAClE,MAAM,IAAI,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAChF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vana-cli",
-  "version": "0.29.2",
+  "version": "0.30.0",
   "description": "Collect your data into a Vana Personal Server, or request, read and pay for someone else's with their consent",
   "keywords": [
     "vana",