Stacks Transaction Generators & Simulations

This repository contains tools for interacting with the Stacks blockchain, including scripts to generate transactions and simulate Daily Active Users (DAU) using burner wallets.

File Structure

• simulate-burners-mint.ts / simulate-burners-mint.js: Merges the burner wallet creation and funding logic with the token minting contract calls, allowing you to simulate unique minting interactions from multiple users.

---

Getting Started

1. Installation

Install dependencies:

npm install

2. Configuration

Create a .env file in the root of the project directory with the following variables:

# Private key of the main funding wallet
STX_PRIVATE_KEY=0x...   # Or PRIVATE_KEY, DEPLOYER_KEY, privateKey

# Stacks Network settings ("mainnet" or "testnet")
STACKS_NETWORK=mainnet
STACKS_API_URL=         # Optional custom API URL

# Contract details for the mint simulation
CONTRACT_ADDRESS=
CONTRACT_NAME=btoken

# Recipient address for minting (leave empty to mint to each burner's own address)
RECIPIENT_ADDRESS=

# Simulation parameters
TX_COUNT=60             # Number of users/transactions to simulate
FEE=6000                # Transaction fee per broadcast (micro-STX)
FUND_AMOUNT=12000       # Amount to fund each burner wallet (micro-STX)
DELAY_MS=5000           # Delay between actions to respect API rate limits (ms)
BURNERS_FILE=./burners.json

---

Usage

Run Burner Wallet & Mint Simulation

This script generates burner wallets, checks their balances, funds them if needed, and broadcasts mint transactions from each burner.

npm run simulate-mint