MADX

MADX contains:

• A multi-chain TypeScript utility library/CLI in src/
• A Solidity contract in contracts/madx_nexus.sol (MADX_Nexus)

Contract workflows

The repository now includes a local EVM workflow for:

• compiling and testing MADX_Nexus
• minting the fixed token supply at deployment time
• launching the token on supported EVM chains
• transferring deployed tokens to a target wallet

Install

npm install

Build the TypeScript utilities

npm run build

Test the repository

npm test now runs:

• the existing Jest-based multichain utility tests
• local Hardhat tests for the Solidity token contract

npm test

On Termux/Android, Hardhat may fail before tests execute with HH18 due to missing native @nomicfoundation binaries. In that specific case, npm test skips only the Hardhat contract-test step and still runs the Jest suite. For strict Solidity test execution on supported platforms, run:

npm run contracts:test:hardhat

Compile the Solidity contract

npm run contracts:compile

Launch MADX_Nexus on an EVM chain

1. Copy .env.example to .env
2. Set:
   • DEPLOYER_PRIVATE_KEY
   • DEX_ROUTER_ADDRESS
   • MARKETING_WALLET
   • one RPC URL for the chain you want to use
3. Optionally set:
   • TOKEN_RECIPIENT_WALLET
   • TOKEN_TRANSFER_AMOUNT
   • ENABLE_TRADING=true

Example:

cp .env.example .env
npm run token:launch -- --network base

Supported configured EVM networks:

• localhost
• sepolia
• ethereum
• baseSepolia
• base
• arbitrum
• optimism
• polygon
• bsc
• avalanche

Deliver deployed tokens to a wallet

If the deployer wallet already holds MADX tokens, you can transfer some of them to another wallet:

npm run wallet:deliver -- --network base

This uses:

• TOKEN_ADDRESS
• TOKEN_RECIPIENT_WALLET
• TOKEN_TRANSFER_AMOUNT

Minting behavior

MADX_Nexus is a fixed-supply ERC-20. Its supply is minted once during deployment to the deployer wallet. There is no post-deployment public mint function in this contract.

EVM scope

MADX_Nexus is a Solidity/EVM contract. The deployment workflow in this repository targets EVM-compatible networks, not native Bitcoin, Solana, Cosmos, or Polkadot token deployment.

ETH-only purchase scope

MADX_Nexus is not a full sale/exchange system. If policy requires purchase constraints (for example, “ETH-only”), enforce those in dedicated sale/router contracts or external policy controls.