aoform-toolkit 1.0.3 → 1.0.5

package/README.md

@@ -25,10 +25,14 @@ npx aoform --help
 npx aoform init
 ```
 
-2. Set wallet JSON:
+2. Provide a wallet (any one of these):
 
 ```bash
-export WALLET_JSON="$(cat ~/.aos.json)"
+# Option A: explicit env var
+WALLET_JSON="your_wallet_json"
+
+# Option B: local wallet.json in your project
+./wallet.json #at the root of your project
 ```
 
 3. Deploy processes:
@@ -49,6 +53,7 @@ npx aoform deploy
   - `-f, --file <path>` custom YAML file path.
   - `-u, --url <url>` custom HyperBEAM node URL.
   - `-s, --scheduler <scheduler>` custom scheduler.
+  - `--wallet-path <path>` custom wallet JSON file path.
 
 ## Configuration (`processes.yaml`)
 
@@ -71,9 +76,13 @@ Fields:
 - `module` (optional): AO module id.
 - `tags` (optional): spawn tags as `{ name, value }`.
 
-## Environment Variables
+## Wallet Resolution Order
+
+When running `aoform deploy`, wallet JSON is resolved in this order:
 
-- `WALLET_JSON` (required): wallet JSON string used for signing.
+1. `--wallet-path <path>`
+2. `./wallet.json` in the current working directory
+3. `WALLET_JSON` environment variable
 
 Example:
 

package/dist/src/cli/createProgram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createProgram.d.ts","sourceRoot":"","sources":["../../../src/cli/createProgram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,aAAa,YA4B5B"}
+{"version":3,"file":"createProgram.d.ts","sourceRoot":"","sources":["../../../src/cli/createProgram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,aAAa,YA6B5B"}

package/dist/src/cli/createProgram.js

@@ -18,6 +18,7 @@ export function createProgram() {
         .option('-f, --file <path>', 'Specify a custom processes.yaml file')
         .option('-u, --url <url>', 'Specify a HyperBEAM node URL')
         .option('-s, --scheduler <scheduler>', 'Specify a scheduler')
+        .option('--wallet-path <path>', 'Specify a custom path to the wallet file')
         .action(async (options) => {
         const { deployCommand } = await import('../commands/deploy.js');
         await deployCommand(options);

package/dist/src/cli/createProgram.js.map

@@ -1 +1 @@
-{"version":3,"file":"createProgram.js","sourceRoot":"","sources":["../../../src/cli/createProgram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,qCAAqC,CAAC,CAAA;IAErD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,mBAAmB,EAAE,8CAA8C,CAAC;SAC3E,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC5D,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,CAAC;SACnE,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;SACzD,MAAM,CAAC,6BAA6B,EAAE,qBAAqB,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAChE,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"createProgram.js","sourceRoot":"","sources":["../../../src/cli/createProgram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,qCAAqC,CAAC,CAAA;IAErD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,mBAAmB,EAAE,8CAA8C,CAAC;SAC3E,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC5D,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,CAAC;SACnE,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;SACzD,MAAM,CAAC,6BAA6B,EAAE,qBAAqB,CAAC;SAC5D,MAAM,CAAC,sBAAsB,EAAE,0CAA0C,CAAC;SAC1E,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAChE,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,eAAO,MAAM,aAAa,GAAU,SAAS,YAAY,mBASxD,CAAC"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,eAAO,MAAM,aAAa,GAAU,SAAS,YAAY,mBA4BxD,CAAC"}

package/dist/src/commands/deploy.js

@@ -1,7 +1,27 @@
 import { deployProcesses } from '../core/deploy/index.js';
+import { readFile, access } from 'node:fs/promises';
 export const deployCommand = async (options) => {
     try {
-        await deployProcesses({ file: options.file, url: options.url, scheduler: options.scheduler });
+        const walletPath = options.walletPath;
+        let walletJson;
+        if (walletPath) {
+            walletJson = await readFile(walletPath, 'utf-8');
+        }
+        else {
+            try {
+                await access('wallet.json');
+                walletJson = await readFile('wallet.json', 'utf-8');
+            }
+            catch {
+                // If wallet.json is missing, deploy core will use existing WALLET_JSON env or throw.
+            }
+        }
+        await deployProcesses({
+            file: options.file,
+            url: options.url,
+            scheduler: options.scheduler,
+            walletJson
+        });
         process.exit(0);
     }
     catch (err) {

package/dist/src/commands/deploy.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE;IAE3D,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,EAAC,IAAI,EAAC,OAAO,CAAC,IAA0B,EAAE,GAAG,EAAC,OAAO,CAAC,GAAyB,EAAE,SAAS,EAAC,OAAO,CAAC,SAA+B,EAAC,CAAC,CAAC;QAC3J,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE;IAE3D,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAC,UAAgC,CAAC;QAC5D,IAAI,UAA8B,CAAC;QAEnC,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;gBAC5B,UAAU,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,qFAAqF;YACvF,CAAC;QACH,CAAC;QAED,MAAM,eAAe,CAAC;YACpB,IAAI,EAAE,OAAO,CAAC,IAA0B;YACxC,GAAG,EAAE,OAAO,CAAC,GAAyB;YACtC,SAAS,EAAE,OAAO,CAAC,SAA+B;YAClD,UAAU;SACX,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC"}

package/dist/src/core/deploy/index.d.ts

@@ -1,6 +1,7 @@
-export declare function deployProcesses({ file, url, scheduler }: {
+export declare function deployProcesses({ file, url, scheduler, walletJson }: {
     file?: string;
     url?: string;
     scheduler?: string;
+    walletJson?: string;
 }): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/core/deploy/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/index.ts"],"names":[],"mappings":"AAUA,wBAAsB,eAAe,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAC,EAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,iBAgC9G"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/index.ts"],"names":[],"mappings":"AAUA,wBAAsB,eAAe,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAC,EAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAC,iBAkC/I"}

package/dist/src/core/deploy/index.js

@@ -5,11 +5,12 @@ import { spawnProcess } from './spawnProcess.js';
 import { deploySource } from './deploySource.js';
 import { default_hb_url, default_scheduler } from '../../constants.js';
 dotenv.config();
-export async function deployProcesses({ file, url, scheduler }) {
-    if (!process.env.WALLET_JSON) {
-        throw new Error('Missing WALLET_JSON environment variable. Please provide wallet JSON in WALLET_JSON.');
+export async function deployProcesses({ file, url, scheduler, walletJson }) {
+    const resolvedWalletJson = walletJson ?? process.env.WALLET_JSON;
+    if (!resolvedWalletJson) {
+        throw new Error('Missing WALLET_JSON environment variable. Please provide wallet JSON via WALLET_JSON env var, specify --wallet-path flag, or create a wallet.json file at the root of your project.');
     }
-    const wallet = JSON.parse(process.env.WALLET_JSON);
+    const wallet = JSON.parse(resolvedWalletJson);
     const signer = createDataItemSigner(wallet);
     const processes = loadProcesses(file);
     const state = loadState(file);

package/dist/src/core/deploy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/deploy/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAoD;IAE7G,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAY,CAAC;IAC9D,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAa,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,EAAE,GAAG,OAAO,CAChB;QACE,IAAI,EAAE,SAAS;QACf,SAAS,EAAC,SAAS,IAAI,iBAAiB;QACxC,GAAG,EAAE,GAAG,IAAI,cAAc;QAC1B,MAAM;KACP,CACF,CAAC;IAEF,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,KAAK,MAAM,WAAW,IAAI,SAAS,EAAE,CAAC;QACpC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,SAAS,EAAE,CAAC;QACpC,MAAM,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/deploy/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAyE;IAE9I,MAAM,kBAAkB,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAEjE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qLAAqL,CAAC,CAAC;IACzM,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAY,CAAC;IACzD,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAa,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,EAAE,GAAG,OAAO,CAChB;QACE,IAAI,EAAE,SAAS;QACf,SAAS,EAAC,SAAS,IAAI,iBAAiB;QACxC,GAAG,EAAE,GAAG,IAAI,cAAc;QAC1B,MAAM;KACP,CACF,CAAC;IAEF,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,KAAK,MAAM,WAAW,IAAI,SAAS,EAAE,CAAC;QACpC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,SAAS,EAAE,CAAC;QACpC,MAAM,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/templates/processes.yaml

@@ -1,9 +1,8 @@
 # Example processes.yaml file
-#
+
 # - name: process1
 #   file: path/to/process1.lua
-#   scheduler: scheduler_address
-#   module: module_address
+#   module: module_id
 #   tags:
 #     - name: Tag1
 #       value: Value1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aoform-toolkit",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "CLI toolkit to deploy and update AO processes from YAML configs",
   "keywords": [
     "ao",