mobilestacks 0.1.27 → 0.1.30

package/README.md

@@ -1,6 +1,8 @@
 # mobilestacks
 
 [![npm version](https://badge.fury.io/js/mobilestacks.svg)](https://badge.fury.io/js/mobilestacks)
+[![npm downloads](https://img.shields.io/npm/dm/mobilestacks.svg)](https://www.npmjs.com/package/mobilestacks)
+[![Node.js Version](https://img.shields.io/node/v/mobilestacks.svg)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 A Hardhat-style development framework for Stacks. Write, test, and deploy Clarity smart contracts with a task-based CLI, local Simnet testing, and a pluggable runtime.
@@ -65,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
 
@@ -113,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
@@ -137,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/cli/init.js

@@ -82,7 +82,7 @@ STACKS_TESTNET_URL=${answers.testnetUrl}
     writeFileIfMissing(sampleContractPath, '(define-public (hello-world)\n  (ok "Hello, Stacks!"))\n');
     if (!fs_1.default.existsSync(tasksDir))
         fs_1.default.mkdirSync(tasksDir, { recursive: true });
-    writeFileIfMissing(exampleTaskPath, "import { task } from 'mobilestacks';\n\ntask('example', 'An example user task for onboarding')\n  .addParam('name', 'Your name', { type: 'string', required: false, defaultValue: 'World' })\n  .setAction((args) => {\n    return `Hello, ${args.name}! Welcome to mobilestacks.`;\n  });\n");
+    writeFileIfMissing(exampleTaskPath, "import { task } from 'mobilestacks';\n\ntask('example', 'An example user task for onboarding')\n  .addParam('name', 'Your name', { type: 'string', required: false, defaultValue: 'World' })\n  .setAction((args: any) => {\n    return `Hello, ${args.name}! Welcome to mobilestacks.`;\n  });\n");
     console.log('\nCreated:');
     console.log('   - mobilestacks.config.ts  (reads secrets from env vars)');
     console.log('   - .env                    (store your secrets here)');

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.27",
+  "version": "0.1.30",
   "description": "Task Runner & CLI for the Stacks Blockchain",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",