API service for crypto payouts across EVM (ETH Sepolia, Base Sepolia, Arbitrum Sepolia, BSC testnet, Polygon Amoy), Litecoin Testnet, Solana devnet (SOL & SPL/Token-2022), and Tron Nile (TRX/TRC20). Handles signing, fee selection, RPC failover, and Telegram alerts.

• Single payouts and batched multi-send per chain.
• Telegram alerts with explorer links for success and errors.
• EVM fee helpers (maxPriorityFee/maxFee bumping, provider failover).
• SPL/Token-2022 on Solana; TRX/TRC20 on Tron; Litecoin Testnet support.
• Native ETH bridging from Sepolia to Base/Arbitrum Sepolia (L1→L2 deposits).

• EVM: ETH Sepolia, Base Sepolia, Arbitrum Sepolia, BSC testnet, Polygon Amoy
• Litecoin: Litecoin Testnet
• Solana: devnet (SOL, SPL, Token-2022)
• Tron: Nile (TRX, TRC20)

• Node.js 18+
• Access to the necessary RPC endpoints and private keys for the chains you use
• Telegram bot token and chat id (for alerts)

1. Install dependencies

npm install

2. Create .env in the repo root

# Litecoin Core RPC
RPC_URL=litecoin_core_host
RPC_USER=litecoin_core_user
RPC_PASS=litecoin_core_password

# Telegram bot (alerts)
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_CHAT_ID=your_chat_id

# Test automation (optional)
AUTOMATION_EVM_PRIVATE_KEY=...
AUTOMATION_SERVICE_PRIVATE_KEY=...
AUTOMATION_SERVICE_EMAIL=...
AUTOMATION_GOOGLE_TOKEN=...
AUTOMATION_SERVICE_SCOPES=...

3. Build and run

npm run app:build
npm run app:start   # PORT defaults to 3000

All endpoints respond with:

{ "tx_id": "transaction_hash" }

POST /payout/evm

{
  "data": {
    "payway": "eth",
    "payee_address": "0x...",
    "amount": "0.1",
    "contract": "0x...",
    "currency": "ETH",
    "private_key": "...",
    "wait_for_receipt": true,
    "request_id": "uuid-or-stable-client-id"
  }
}

Omit contract to send native ETH instead of ERC20. Set wait_for_receipt to false to return tx_id immediately after submission; the service will wait for the receipt in the background. Pass a stable request_id on client retries so the same payout request can be safely replayed without creating a new transaction.

POST /payout/evm/multi_send

{
  "data": {
    "payway": "eth",
    "recipients": [
      { "address": "0x...", "amount": "0.05" },
      { "address": "0x...", "amount": "0.05" }
    ],
    "currency": "ETH",
    "private_key": "...",
    "multi_send_contract": "0x...",
    "wait_for_receipt": true,
    "request_id": "uuid-or-stable-client-id"
  }
}

POST /payout/evm/batch_send Allows sending both native currency and multiple ERC20 tokens in a single transaction. Automatically converts amounts based on decimals and approves tokens if allowance is insufficient.

{
  "data": {
    "payway": "eth",
    "private_key": "...",
    "currency": "ETH",
    "batch_send_contract": "0x...",
    "native_transfers": [
      {
        "to": "0x...",
        "amount": "0.015"
      }
    ],
    "token_transfers": [
      {
        "token_address": "0x...",
        "to": "0x...",
        "amount": "1"
      }
    ]
  }
}

POST /payout/ltc

{
  "data": {
    "method": "sendtoaddress",
    "payee_address": "LTC...",
    "amount": "1.0",
    "payway": "LTC",
    "currency": "LTC"
  }
}

POST /payout/ltc/multi_send

{
  "data": {
    "method": "sendmany",
    "payway": "LTC",
    "currency": "LTC",
    "recipients": [
      { "address": "LTC...", "amount": "0.5" },
      { "address": "LTC...", "amount": "0.5" }
    ],
    "comment": "Payment for services",
    "minconf": 1,
    "account": "wallet_label"
  }
}

POST /payout/solana

{
  "data": {
    "payway": "sol",
    "currency": "SOL",
    "amount": "0.1",
    "payee_address": "5x...",
    "private_key": "...",
    "token_mint": null,
    "is_token_2022": false
  }
}

Set token_mint and is_token_2022: true for Token-2022; set token_mint for classic SPL tokens.

POST /payout/solana/multi_send

{
  "data": {
    "private_key": "...",
    "currency": "SOL",
    "token_mint": null,
    "recipients": [
      { "address": "5x...", "amount": "0.05" },
      { "address": "5y...", "amount": "0.05" }
    ]
  }
}

POST /payout/tron

{
  "data": {
    "payway": "tron",
    "payee_address": "T...",
    "amount": "0.1",
    "contract": "T...",
    "currency": "TRX",
    "private_key": "..."
  }
}

For TRC20, set payway to trc20, provide contract, and set currency accordingly.

POST /payout/tron/multi_send

{
  "data": {
    "payway": "tron",
    "recipients": [
      { "address": "T...", "amount": "0.05" },
      { "address": "T...", "amount": "0.05" }
    ],
    "private_key": "...",
    "currency": "TRX",
    "multi_send_contract": "T...",
    "token_contract": "T..."
  }
}

token_contract is required for TRC20 multi-send; omit for TRX.

POST /bridge/eth Deposits native ETH from Sepolia (L1) to an L2 - Base Sepolia (OP Stack) or Arbitrum Sepolia (Nitro). The source chain is always Sepolia.

{
  "data": {
    "destination": "base",
    "amount": "0.01",
    "payee_address": "0x...",
    "private_key": "...",
    "wait_for_receipt": true,
    "request_id": "uuid-or-stable-client-id"
  }
}

• destination: base or arbitrum.
• Omit payee_address to bridge to the sender's own address on the L2; provide it to credit a different recipient. (For Arbitrum with a custom recipient the service uses a retryable ticket, reading the submission fee and L2 gas price on-chain.)
• The returned tx_id is the L1 deposit hash; funds arrive on the L2 asynchronously (≈1-3 min for Base, ≈10-15 min for Arbitrum).
• request_id gives the same idempotency behaviour as the EVM payout endpoints.

• Logs to stdout with timestamps and network tags.
• Telegram alerts via TELEGRAM_BOT_TOKEN / TELEGRAM_CHAT_ID.

• Build: npm run app:build
• Start: npm run app:start (uses PORT or 3000)
• Tests: npm run tests:start
• Lint: npm run lint (auto-fix: npm run lint-fix)

GitHub Actions workflow .github/workflows/depoly.yml builds and deploys on pushes to main. Configure required secrets/env vars in repo settings.

Contributions are welcome. See CONTRIBUTING.md before opening PRs.