mobilestacks 0.1.0

package/dist/src/core/extender.d.ts

@@ -0,0 +1,12 @@
+import { RuntimeEnvironment } from './runtime-environment';
+export type ExtensionFunc = (env: RuntimeEnvironment) => void;
+export declare class Extender {
+    private static _instance;
+    private _extensions;
+    private constructor();
+    static getInstance(): Extender;
+    addExtension(func: ExtensionFunc): void;
+    getExtensions(): ExtensionFunc[];
+}
+export declare function extendEnvironment(func: ExtensionFunc): void;
+//# sourceMappingURL=extender.d.ts.map

package/dist/src/core/extender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extender.d.ts","sourceRoot":"","sources":["../../../src/core/extender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAE9D,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAW;IACnC,OAAO,CAAC,WAAW,CAAuB;IAE1C,OAAO;WAEO,WAAW,IAAI,QAAQ;IAO9B,YAAY,CAAC,IAAI,EAAE,aAAa;IAIhC,aAAa,IAAI,aAAa,EAAE;CAGxC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,QAEpD"}

package/dist/src/core/extender.js

@@ -0,0 +1,20 @@
+export class Extender {
+    constructor() {
+        this._extensions = [];
+    }
+    static getInstance() {
+        if (!Extender._instance) {
+            Extender._instance = new Extender();
+        }
+        return Extender._instance;
+    }
+    addExtension(func) {
+        this._extensions.push(func);
+    }
+    getExtensions() {
+        return this._extensions;
+    }
+}
+export function extendEnvironment(func) {
+    Extender.getInstance().addExtension(func);
+}

package/dist/src/core/runtime-environment.d.ts

@@ -0,0 +1,15 @@
+import { MobilestacksConfig } from '../types/config';
+import { StacksNetwork } from '@stacks/network';
+export declare class RuntimeEnvironment {
+    config: MobilestacksConfig;
+    network: StacksNetwork;
+    wallet: {
+        privateKey: string;
+        address: string;
+        accountIndex?: number;
+    };
+    stacks: Record<string, unknown>;
+    [key: string]: unknown;
+    constructor(config: MobilestacksConfig);
+}
+//# sourceMappingURL=runtime-environment.d.ts.map

package/dist/src/core/runtime-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-environment.d.ts","sourceRoot":"","sources":["../../../src/core/runtime-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiB,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAiB,MAAM,iBAAiB,CAAC;AAG/D,qBAAa,kBAAkB;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;gBAEX,MAAM,EAAE,kBAAkB;CA4DvC"}

package/dist/src/core/runtime-environment.js

@@ -0,0 +1,65 @@
+import { getAddressFromPrivateKey } from '@stacks/transactions';
+import { generateWallet } from '@stacks/wallet-sdk';
+import { createNetwork } from '@stacks/network';
+import { Extender } from './extender';
+export class RuntimeEnvironment {
+    constructor(config) {
+        this.config = config;
+        const networkName = config.defaultNetwork;
+        const networkConfig = config.networks[networkName];
+        if (!networkConfig) {
+            throw new Error(`Network config not found for: ${networkName}`);
+        }
+        // Instantiate proper StacksNetwork
+        if (networkName === 'mainnet' || networkName === 'testnet') {
+            this.network = createNetwork({
+                network: networkName,
+                client: { baseUrl: networkConfig.url }
+            });
+        }
+        else {
+            // Default to testnet structure for custom networks
+            this.network = createNetwork({
+                network: 'testnet',
+                client: { baseUrl: networkConfig.url }
+            });
+        }
+        // Wallet: support privateKey, seedPhrase+derivationPath, or both (prefer privateKey)
+        if (config.wallet.privateKey) {
+            // Derive address from privateKey
+            const address = getAddressFromPrivateKey(config.wallet.privateKey, networkName === 'mainnet' ? 'mainnet' : 'testnet');
+            this.wallet = {
+                privateKey: config.wallet.privateKey,
+                address,
+            };
+        }
+        else if (config.wallet.seedPhrase) {
+            const path = config.wallet.derivationPath || "m/44'/5757'/0'/0/0"; // Stacks main path
+            // generateWallet requires a password param
+            generateWallet({ secretKey: config.wallet.seedPhrase, password: '' }).then(wallet => {
+                const index = parseInt(path.split('/').pop() || '0', 10);
+                const account = wallet.accounts[index] || wallet.accounts[0];
+                // Use getStxAddress to get the address
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { getStxAddress } = require('@stacks/wallet-sdk/dist/models/account');
+                // network.addressVersion has singleSig/multiSig lines. 
+                const address = getStxAddress(account, this.network.transactionVersion);
+                this.wallet = {
+                    privateKey: account.stxPrivateKey,
+                    address,
+                    accountIndex: account.index,
+                };
+            }).catch(() => {
+                throw new Error('Failed to generate wallet from seed phrase');
+            });
+        }
+        else {
+            throw new Error('No privateKey or seedPhrase provided in wallet config');
+        }
+        this.stacks = {};
+        // Apply extensions
+        for (const extension of Extender.getInstance().getExtensions()) {
+            extension(this);
+        }
+    }
+}

package/dist/src/core/simnet.d.ts

@@ -0,0 +1,17 @@
+import { initSimnet } from '@hirosystems/clarinet-sdk';
+import { ClarityValue } from '@stacks/transactions';
+type SimnetInstance = Awaited<ReturnType<typeof initSimnet>>;
+export declare class Simnet {
+    private static _instance;
+    simnet: SimnetInstance;
+    accounts: Map<string, string>;
+    private constructor();
+    static init(): Promise<Simnet>;
+    getDeployer(): string;
+    getAccount(name: string): string;
+    callPublic(contract: string, func: string, args: ClarityValue[], sender: string): import("@hirosystems/clarinet-sdk").ParsedTransactionResult;
+    callReadOnly(contract: string, func: string, args: ClarityValue[], sender: string): import("@hirosystems/clarinet-sdk").ParsedTransactionResult;
+    mineBlock(txs: Parameters<SimnetInstance['mineBlock']>[0]): Promise<import("@hirosystems/clarinet-sdk").ParsedTransactionResult[]>;
+}
+export {};
+//# sourceMappingURL=simnet.d.ts.map

package/dist/src/core/simnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simnet.d.ts","sourceRoot":"","sources":["../../../src/core/simnet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AAE7D,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAS;IAC1B,MAAM,EAAG,cAAc,CAAC;IACxB,QAAQ,EAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,OAAO;WAEa,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBpC,WAAW,IAAI,MAAM;IAMrB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMhC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM;IAI/E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM;IAI3E,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAGvE"}

package/dist/src/core/simnet.js

@@ -0,0 +1,42 @@
+import { initSimnet } from '@hirosystems/clarinet-sdk';
+export class Simnet {
+    constructor() { }
+    static async init() {
+        if (!Simnet._instance) {
+            Simnet._instance = new Simnet();
+            // Initialize SDK - auto-detects Clarinet.toml from CWD
+            try {
+                console.log('Initializing Simnet...');
+                Simnet._instance.simnet = await initSimnet();
+                // Get accounts
+                Simnet._instance.accounts = Simnet._instance.simnet.getAccounts();
+            }
+            catch (error) {
+                console.error('Failed to initialize Simnet:', error);
+                throw error;
+            }
+        }
+        return Simnet._instance;
+    }
+    getDeployer() {
+        const deployer = this.accounts.get('deployer');
+        if (!deployer)
+            throw new Error('Deployer account not found');
+        return deployer;
+    }
+    getAccount(name) {
+        const acc = this.accounts.get(name);
+        if (!acc)
+            throw new Error(`Account ${name} not found`);
+        return acc;
+    }
+    callPublic(contract, func, args, sender) {
+        return this.simnet.callPublicFn(contract, func, args, sender);
+    }
+    callReadOnly(contract, func, args, sender) {
+        return this.simnet.callReadOnlyFn(contract, func, args, sender);
+    }
+    async mineBlock(txs) {
+        return this.simnet.mineBlock(txs);
+    }
+}

package/dist/src/core/tasks-definitions.d.ts

@@ -0,0 +1,28 @@
+import { ZodSchema } from 'zod';
+import { RuntimeEnvironment } from './runtime-environment';
+export type TaskParamType = 'string' | 'number' | 'boolean';
+export interface TaskParam {
+    name: string;
+    description: string;
+    type?: TaskParamType;
+    required?: boolean;
+    defaultValue?: unknown;
+    schema?: ZodSchema;
+}
+export interface TaskDefinition {
+    name: string;
+    description: string;
+    params: TaskParam[];
+    action: (args: Record<string, unknown>, env: RuntimeEnvironment) => Promise<unknown>;
+}
+declare class TaskDefinitions {
+    private static _instance;
+    private _tasks;
+    private constructor();
+    static getInstance(): TaskDefinitions;
+    addTask(task: TaskDefinition): void;
+    getTask(name: string): TaskDefinition | undefined;
+    getAllTasks(): TaskDefinition[];
+}
+export { TaskDefinitions };
+//# sourceMappingURL=tasks-definitions.d.ts.map

package/dist/src/core/tasks-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-definitions.d.ts","sourceRoot":"","sources":["../../../src/core/tasks-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC5D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtF;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAkB;IAC1C,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO;WAEO,WAAW,IAAI,eAAe;IAOrC,OAAO,CAAC,IAAI,EAAE,cAAc;IAI5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIjD,WAAW,IAAI,cAAc,EAAE;CAGvC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/src/core/tasks-definitions.js

@@ -0,0 +1,21 @@
+class TaskDefinitions {
+    constructor() {
+        this._tasks = [];
+    }
+    static getInstance() {
+        if (!TaskDefinitions._instance) {
+            TaskDefinitions._instance = new TaskDefinitions();
+        }
+        return TaskDefinitions._instance;
+    }
+    addTask(task) {
+        this._tasks.push(task);
+    }
+    getTask(name) {
+        return this._tasks.find((t) => t.name === name);
+    }
+    getAllTasks() {
+        return this._tasks;
+    }
+}
+export { TaskDefinitions };

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export { task, subtask, extendEnvironment } from './core/dsl';
+export { Simnet } from './core/simnet';
+export { RuntimeEnvironment } from './core/runtime-environment';
+export * from './core/tasks-definitions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,cAAc,0BAA0B,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export { task, subtask, extendEnvironment } from './core/dsl';
+export { Simnet } from './core/simnet';
+export { RuntimeEnvironment } from './core/runtime-environment';
+export * from './core/tasks-definitions';

package/dist/src/tasks/call-contract-function.d.ts

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

package/dist/src/tasks/call-contract-function.d.ts.map

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

package/dist/src/tasks/call-contract-function.js

@@ -0,0 +1,31 @@
+import { task } from '../core/dsl';
+import fetch from 'node-fetch';
+task('call-contract-function', 'Call a public function on a deployed Clarity contract')
+    .addParam('contractAddress', 'Deployed contract address (STX...)', { type: 'string', required: true })
+    .addParam('contractName', 'Contract name', { type: 'string', required: true })
+    .addParam('functionName', 'Function name', { type: 'string', required: true })
+    .addParam('args', 'Comma-separated function arguments', { type: 'string', required: false, defaultValue: '' })
+    .addParam('network', 'Network (mainnet|testnet)', { type: 'string', required: false, defaultValue: 'testnet' })
+    .setAction(async (args) => {
+    const contractAddress = args.contractAddress;
+    const contractName = args.contractName;
+    const functionName = args.functionName;
+    const fnArgs = args.args;
+    const network = args.network;
+    const apiUrl = network === 'mainnet'
+        ? 'https://stacks-node-api.mainnet.stacks.co'
+        : 'https://stacks-node-api.testnet.stacks.co';
+    const url = `${apiUrl}/v2/contracts/call-read/${contractAddress}/${contractName}/${functionName}`;
+    const body = fnArgs
+        ? { arguments: fnArgs.split(',').map((a) => a.trim()) }
+        : { arguments: [] };
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body)
+    });
+    if (!res.ok)
+        throw new Error(`Failed to call contract function: ${res.statusText}`);
+    const result = await res.json();
+    return result;
+});

package/dist/src/tasks/deploy-contract.d.ts

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

package/dist/src/tasks/deploy-contract.d.ts.map

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

package/dist/src/tasks/deploy-contract.js

@@ -0,0 +1,44 @@
+import { task } from '../core/dsl';
+import { makeContractDeploy, broadcastTransaction, } from '@stacks/transactions';
+import { createNetwork } from '@stacks/network';
+import fs from 'fs';
+function maskAddress(address) {
+    return address ? address.slice(0, 6) + '...' + address.slice(-4) : '';
+}
+function containsSecret(obj) {
+    const str = JSON.stringify(obj);
+    return /[A-Za-z0-9]{32,}/.test(str); // crude check for long secrets
+}
+// Deploy a Clarity contract to Stacks mainnet or testnet
+task('deploy-contract', 'Deploy a Clarity smart contract to Stacks blockchain')
+    .addParam('contractName', 'Name of the contract', { type: 'string', required: true })
+    .addParam('file', 'Path to Clarity contract file', { type: 'string', required: true })
+    .addParam('network', 'Network to deploy to (mainnet|testnet)', { type: 'string', required: false, defaultValue: 'testnet' })
+    .setAction(async (args, env) => {
+    const contractName = args.contractName;
+    const file = args.file;
+    const network = args.network;
+    const codeBody = fs.readFileSync(file, 'utf8');
+    // Switch network if needed
+    if (network === 'mainnet') {
+        env.network = createNetwork({ network: 'mainnet', client: { baseUrl: env.config.networks.mainnet.url } });
+    }
+    else {
+        env.network = createNetwork({ network: 'testnet', client: { baseUrl: env.config.networks.testnet.url } });
+    }
+    const tx = await makeContractDeploy({
+        contractName,
+        codeBody,
+        senderKey: env.wallet.privateKey,
+        network: env.network,
+    });
+    const result = await broadcastTransaction({ transaction: tx, network: env.network });
+    if (containsSecret(result)) {
+        console.warn('[mobilestacks] Warning: Output may contain sensitive data.');
+    }
+    // Mask any address fields if present
+    if (result && result.txid) {
+        result.txid = maskAddress(result.txid);
+    }
+    return result;
+});

package/dist/src/tasks/example-task.d.ts

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

package/dist/src/tasks/example-task.d.ts.map

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

package/dist/src/tasks/example-task.js

@@ -0,0 +1,6 @@
+import { task } from '../core/dsl';
+task('example', 'An example user task for onboarding')
+    .addParam('name', 'Your name', { type: 'string', required: false, defaultValue: 'World' })
+    .setAction(async (args) => {
+    return `Hello, ${args.name}! Welcome to mobilestacks.`;
+});

package/dist/src/tasks/faucet-request.d.ts

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

package/dist/src/tasks/faucet-request.d.ts.map

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

package/dist/src/tasks/faucet-request.js

@@ -0,0 +1,21 @@
+import { task } from '../core/dsl';
+import fetch from 'node-fetch';
+task('faucet-request', 'Request STX from the testnet faucet')
+    .addParam('address', 'STX address to fund', { type: 'string', required: true })
+    .setAction(async (args, env) => {
+    if (env.network.client.baseUrl && env.network.client.baseUrl.includes('testnet')) {
+        const url = `https://stacks-node-api.testnet.stacks.co/extended/v1/faucet/stx`; // Default testnet faucet
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ address: args.address })
+        });
+        if (!res.ok) {
+            throw new Error(`Faucet request failed: ${res.statusText}`);
+        }
+        return await res.json();
+    }
+    else {
+        throw new Error('Faucet is only available on testnet.');
+    }
+});

package/dist/src/tasks/get-balance.d.ts

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

package/dist/src/tasks/get-balance.d.ts.map

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

package/dist/src/tasks/get-balance.js

@@ -0,0 +1,33 @@
+import { task } from '../core/dsl';
+import fetch from 'node-fetch';
+function maskAddress(address) {
+    return address ? address.slice(0, 6) + '...' + address.slice(-4) : '';
+}
+function containsSecret(obj) {
+    const str = JSON.stringify(obj);
+    return /[A-Za-z0-9]{32,}/.test(str); // crude check for long secrets
+}
+task('get-balance', 'Get STX balance for the configured wallet address or a provided address')
+    .addParam('address', 'STX address to check (optional, defaults to wallet main address)', { type: 'string', required: false })
+    .setAction(async (args, env) => {
+    const address = args.address || env.wallet.address;
+    if (!address)
+        throw new Error('No wallet address found.');
+    const network = env.network;
+    const apiUrl = network.client.baseUrl;
+    const url = `${apiUrl}/extended/v1/address/${address}/balances`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Failed to fetch balance: ${res.statusText}`);
+    const data = await res.json();
+    const result = {
+        address: maskAddress(address),
+        stx: data.stx.balance,
+        locked: data.stx.locked,
+        unlock_height: data.stx.unlock_height
+    };
+    if (containsSecret(result)) {
+        console.warn('[mobilestacks] Warning: Output may contain sensitive data.');
+    }
+    return result;
+});

package/dist/src/tasks/get-contract-info.d.ts

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

package/dist/src/tasks/get-contract-info.d.ts.map

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

package/dist/src/tasks/get-contract-info.js

@@ -0,0 +1,18 @@
+import { task } from '../core/dsl';
+import fetch from 'node-fetch';
+task('get-contract-info', 'Get contract attributes and details from Stacks blockchain')
+    .addParam('contractAddress', 'Deployed contract address (STX...)', { type: 'string', required: true })
+    .addParam('contractName', 'Contract name', { type: 'string', required: true })
+    .addParam('network', 'Network (mainnet|testnet)', { type: 'string', required: false, defaultValue: 'testnet' })
+    .setAction(async (args) => {
+    const { contractAddress, contractName, network } = args;
+    const apiUrl = network === 'mainnet'
+        ? 'https://stacks-node-api.mainnet.stacks.co'
+        : 'https://stacks-node-api.testnet.stacks.co';
+    const url = `${apiUrl}/extended/v1/contract/${contractAddress}/${contractName}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Failed to fetch contract info: ${res.statusText}`);
+    const info = await res.json();
+    return info;
+});

package/dist/src/tasks/get-tx-history.d.ts

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

package/dist/src/tasks/get-tx-history.d.ts.map

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

package/dist/src/tasks/get-tx-history.js

@@ -0,0 +1,38 @@
+import { task } from '../core/dsl';
+import fetch from 'node-fetch';
+function maskAddress(address) {
+    return address ? address.slice(0, 6) + '...' + address.slice(-4) : '';
+}
+function containsSecret(obj) {
+    const str = JSON.stringify(obj);
+    return /[A-Za-z0-9]{32,}/.test(str); // crude check for long secrets
+}
+task('get-tx-history', 'Get transaction history for the configured wallet address')
+    .addParam('limit', 'Number of transactions to fetch', { type: 'number', required: false, defaultValue: 10 })
+    .setAction(async (args, env) => {
+    const address = env.wallet.address;
+    if (!address)
+        throw new Error('No wallet address found.');
+    const network = env.network;
+    const apiUrl = network.client.baseUrl;
+    const url = `${apiUrl}/extended/v1/address/${address}/transactions?limit=${args.limit}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Failed to fetch tx history: ${res.statusText}`);
+    const data = await res.json();
+    const txs = data.results.map((tx) => ({
+        tx_id: tx.tx_id,
+        type: tx.tx_type,
+        status: tx.tx_status,
+        fee_rate: tx.fee_rate,
+        block_height: tx.block_height
+    }));
+    // Mask address in logs and warn if secrets detected
+    if (containsSecret(txs)) {
+        console.warn('[mobilestacks] Warning: Output may contain sensitive data.');
+    }
+    return {
+        address: maskAddress(address),
+        transactions: txs
+    };
+});

package/dist/src/tasks/list-accounts.d.ts

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

package/dist/src/tasks/list-accounts.d.ts.map

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

package/dist/src/tasks/list-accounts.js

@@ -0,0 +1,24 @@
+import { task } from '../core/dsl';
+import { generateWallet } from '@stacks/wallet-sdk';
+function maskAddress(address) {
+    return address ? address.slice(0, 6) + '...' + address.slice(-4) : '';
+}
+function containsSecret(obj) {
+    const str = JSON.stringify(obj);
+    return /[A-Za-z0-9]{32,}/.test(str); // crude check for long secrets
+}
+task('list-accounts', 'List all accounts derived from the configured seed phrase')
+    .setAction(async (args, env) => {
+    if (!env.config.wallet.seedPhrase) {
+        throw new Error('No seed phrase configured.');
+    }
+    const wallet = await generateWallet({ secretKey: env.config.wallet.seedPhrase, password: '' });
+    const result = wallet.accounts.map((a) => ({
+        address: maskAddress(a.address || a.stxAddress),
+        index: a.index
+    }));
+    if (containsSecret(result)) {
+        console.warn('[mobilestacks] Warning: Output may contain sensitive data.');
+    }
+    return result;
+});

package/dist/src/tasks/send-stx.d.ts

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

package/dist/src/tasks/send-stx.d.ts.map

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

package/dist/src/tasks/send-stx.js

@@ -0,0 +1,36 @@
+import { task } from '../core/dsl';
+import { broadcastTransaction, makeSTXTokenTransfer } from '@stacks/transactions';
+function maskAddress(address) {
+    return address ? address.slice(0, 6) + '...' + address.slice(-4) : '';
+}
+function containsSecret(obj) {
+    const str = JSON.stringify(obj);
+    return /[A-Za-z0-9]{32,}/.test(str); // crude check for long secrets
+}
+// This task sends STX to an address using the loaded SRE (env)
+task('send-stx', 'Sends STX to an address')
+    .addParam('to', 'Recipient STX address', { type: 'string', required: true })
+    .addParam('amount', 'Amount in microSTX', { type: 'number', required: true })
+    .addParam('memo', 'Optional memo', { type: 'string', required: false, defaultValue: '' })
+    .setAction(async (args, env) => {
+    const to = args.to;
+    const amount = args.amount;
+    const memo = args.memo;
+    const { wallet, network } = env;
+    const tx = await makeSTXTokenTransfer({
+        recipient: to,
+        amount: BigInt(amount),
+        senderKey: wallet.privateKey,
+        network,
+        memo: memo || undefined
+    });
+    const result = await broadcastTransaction({ transaction: tx, network });
+    if (containsSecret(result)) {
+        console.warn('[mobilestacks] Warning: Output may contain sensitive data.');
+    }
+    // Mask any address fields if present
+    if (result && result.txid) {
+        result.txid = maskAddress(result.txid);
+    }
+    return result;
+});

package/dist/src/tasks/verify-contract.d.ts

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

package/dist/src/tasks/verify-contract.d.ts.map

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

package/dist/src/tasks/verify-contract.js

@@ -0,0 +1,33 @@
+import { task } from '../core/dsl';
+import fetch from 'node-fetch';
+import fs from 'fs';
+task('verify-contract', 'Verify a deployed Clarity contract on the Stacks explorer')
+    .addParam('contractAddress', 'Deployed contract address (STX...)', { type: 'string', required: true })
+    .addParam('contractName', 'Contract name', { type: 'string', required: true })
+    .addParam('source', 'Path to contract source file', { type: 'string', required: true })
+    .addParam('network', 'Network (mainnet|testnet)', { type: 'string', required: false, defaultValue: 'testnet' })
+    .setAction(async (args) => {
+    const contractAddress = args.contractAddress;
+    const contractName = args.contractName;
+    const source = args.source;
+    const network = args.network;
+    const codeBody = fs.readFileSync(source, 'utf8');
+    const apiUrl = network === 'mainnet'
+        ? 'https://stacks-node-api.mainnet.stacks.co'
+        : 'https://stacks-node-api.testnet.stacks.co';
+    // Fetch contract source from chain
+    const url = `${apiUrl}/extended/v1/contract/source/${contractAddress}/${contractName}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Failed to fetch on-chain contract source: ${res.statusText}`);
+    const onChain = await res.json();
+    const verified = onChain.source_code && onChain.source_code.trim() === codeBody.trim();
+    const explorer = network === 'mainnet'
+        ? `https://explorer.stacks.co/txid/${contractAddress}.${contractName}`
+        : `https://explorer.stacks.co/txid/${contractAddress}.${contractName}?chain=testnet`;
+    return {
+        verified,
+        message: verified ? 'Contract source matches on-chain code!' : 'Source does NOT match on-chain code!',
+        explorer
+    };
+});