Frequency Chopsticks XCM Testing Environment

This project provides a complete testing environment for XCM transfers between Frequency parachain and AssetHub using Chopsticks.

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Setup

1. Install dependencies:

npm install

2. Start the XCM testing environment:

# Option 1: Using the XCM configuration (recommended)
npm run fork:xcm

# Option 2: Start chains individually
npm run fork:frequency  # Terminal 1
npm run fork:asset-hub  # Terminal 2

3. Run the tests:

npm test

Chain Endpoints

When the forks are running, you can connect to:

• Relay Chain (Polkadot): ws://localhost:8000
• AssetHub: ws://localhost:8001
• Frequency: ws://localhost:8002

Test Accounts

The configuration includes pre-funded test accounts:

• Alice: 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY
• Bob: 5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty

Available Scripts

• npm test - Run all XCM tests
• npm run fork:xcm - Start XCM testing environment with relay + parachains
• npm run fork:frequency - Start only Frequency parachain fork
• npm run fork:asset-hub - Start only AssetHub fork

Test Structure

• tests/networks.ts - Wire up configurations for each chain

• tests/xcm-utils.ts - XCM utility functions and helpers
• tests/xcm-transfer.test.ts - XCM transfer test cases (in progress)

Configuration Files

• configs/frequency.yml - Frequency parachain configuration
• configs/asset-hub.yml - AssetHub configuration
• configs/xcm-setup.yml - Multi-chain XCM testing configuration