init Command

The init command creates a configuration file and test wallet for your project.

Usage

npx x402test init [options]

What It Does

Creates Configuration File: Generates x402test.config.js
Creates Test Wallet: Generates and funds a test wallet
Saves Wallet: Stores wallet in .x402test-wallets.json

Options

—force, -f

Overwrite existing configuration file.

npx x402test init --force

Use Case: Recreate configuration after accidental modification

Output

✔ Initializing x402test configuration...
✔ Creating new x402test config...
✔ Creating test wallet...
✔ Config file created at x402test.config.js
✔ Recipient wallet: FcxKSp7YxqYXdq...
✔ USDC balance: 1000 USDC
✔ Ready to start your server! Run 'x402test start' to start the server.

Generated Files

x402test.config.js

// x402test configuration
export default {
  port: 4402,
  network: "solana-devnet",
  rpcUrl: "http://localhost:8899",

  recipient: "FcxKSp7YxqYXdq...",

  routes: {
    "/api/premium": {
      price: "0.10",
      description: "Premium content access",
      response: {
        data: "This is premium content!",
        timestamp: Date.now(),
      },
    },

    "/api/data": {
      price: "0.01",
      description: "Data API access",
      response: (req) => ({
        method: req.method,
        path: req.path,
        data: { message: "Your data here" },
      }),
    },
  },
};

.x402test-wallets.json

{
  "wallets": [{
    "publicKey": "FcxKSp7YxqYXdq...",
    "secretKey": [...],
    "tokenAccounts": {
      "USDC": "EPjFWdd5AufqSSqeM2..."
    }
  }],
  "mints": {
    "USDC": "EPjFWdd5AufqSSqeM2..."
  }
}

Important: Add to .gitignore!

.x402test-wallets.json

Examples

Basic Initialization

npx x402test init

Force Overwrite

npx x402test init --force

Use when you want to:

Reset configuration to defaults
Fix corrupted config file
Start fresh after experiments

Customizing Generated Config

After running init, edit x402test.config.js:

Change Port

export default {
  port: 8080, // Change from 4402
  // ... rest of config
};

Add Routes

export default {
  // ... existing config
  routes: {
    "/api/premium": {
      price: "0.10",
      description: "Premium content",
      response: { data: "Premium content" },
    },
    "/api/basic": {
      price: "0.01",
      description: "Basic content",
      response: { data: "Basic content" },
    },
    // Add your routes here
    "/api/custom": {
      price: "0.05",
      description: "Custom endpoint",
      response: { custom: true },
    },
  },
};

Use Environment Variables

export default {
  port: parseInt(process.env.PORT || "4402"),
  rpcUrl: process.env.RPC_URL || "http://localhost:8899",
  recipient: process.env.RECIPIENT_WALLET || "default-wallet",
  // ... rest of config
};

Error Handling

Config Already Exists

✘ Config file already exists. Use --force to overwrite.

Solution:

npx x402test init --force

Wallet Creation Failed

✘ Failed to create wallet: Connection failed

Solutions:

Check Solana validator is running
Verify RPC URL is correct
Check network connectivity

Permission Denied

✘ EACCES: permission denied