mobilestacks 0.1.29 → 0.1.30

package/README.md

@@ -67,6 +67,7 @@ Missing required params are prompted interactively. Run any task with `--help` f
 | `callcontractfunction` | Call a read-only contract function |
 | `getcontractinfo` | Fetch deployed contract metadata |
 | `verifycontract` | Diff on-chain source against a local file |
+| `setupsimnet` | Generate local Simnet/Devnet configuration and test accounts |
 
 ## Writing Tasks
 
@@ -115,6 +116,8 @@ extendEnvironment((env) => {
 
 ## Testing with Simnet
 
+**Simnet** (simulated network) is a local, offline simulation of the Stacks provided by Clarinet. It is used to test smart contracts rapidly and deterministically without needing to run a full node, use a public testnet, or wait for real block times.
+
 Test contracts locally using the Clarinet SDK. No devnet is needed:
 
 ```ts
@@ -139,10 +142,10 @@ describe('My Contract', () => {
 
 ### Setup
 
-Contract tests need a `Clarinet.toml` and test accounts. Run the setup script once:
+Contract tests need a `Clarinet.toml` and test accounts. Run the setup task once:
 
 ```bash
-npm run setup:simnet
+npx mobilestacks setupsimnet
 ```
 
 Then run tests:

package/dist/tasks/SetupSimnet.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SetupSimnet.d.ts.map

package/dist/tasks/SetupSimnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetupSimnet.d.ts","sourceRoot":"","sources":["../../src/tasks/SetupSimnet.ts"],"names":[],"mappings":""}

package/dist/tasks/SetupSimnet.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dsl_1 = require("../core/dsl");
+const wallet_sdk_1 = require("@stacks/wallet-sdk");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+(0, dsl_1.task)('setupsimnet', 'Generates Simnet.toml and Devnet.toml with test accounts')
+    .setAction(async () => {
+    const dir = path_1.default.resolve(process.cwd(), 'settings');
+    if (!fs_1.default.existsSync(dir))
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    const accounts = ['deployer', 'wallet_1', 'wallet_2'];
+    const sections = accounts.map((name) => {
+        const mnemonic = (0, wallet_sdk_1.generateSecretKey)();
+        return `[accounts.${name}]\nmnemonic = "${mnemonic}"\nbalance = 100_000_000_000_000`;
+    });
+    const toml = `[network]\nname = "simnet"\n\n${sections.join('\n\n')}\n`;
+    fs_1.default.writeFileSync(path_1.default.join(dir, 'Simnet.toml'), toml, 'utf-8');
+    fs_1.default.writeFileSync(path_1.default.join(dir, 'Devnet.toml'), toml.replace(/simnet/g, 'devnet'), 'utf-8');
+    return 'Generated settings/Simnet.toml and settings/Devnet.toml with test accounts';
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mobilestacks",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Task Runner & CLI for the Stacks Blockchain",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",