@magnaflow/chain-provider

Chain provider abstractions for unified EVM and Tron operations.

What It Provides

• A shared ChainProvider interface for balances, transfers, receipts, and gas estimation
• EvmProvider backed by viem
• TronProvider backed by tronweb
• Factory helpers for creating providers from backend chain configuration

Install

npm install @magnaflow/chain-provider

Key Exports

• createChainProvider
• createEvmProvider
• createTronProvider
• getChainType
• EvmProvider
• TronProvider
• createViemChainFromConfig

Example

import { createChainProvider } from '@magnaflow/chain-provider';

const provider = createChainProvider(
  {
    name: 'BSC Mainnet',
    chain: 'bsc',
    rpc_url: 'https://bsc-dataseed.binance.org',
    rest_url: 'https://bsc-dataseed.binance.org',
    payout_contract: '0x0000000000000000000000000000000000000000',
  },
  process.env.MNEMONIC,
);

const balances = await provider.getBalances('0x1234...', [
  '0x55d398326f99059fF775485246999027B3197955',
]);

Notes

• The default EVM chain resolver is currently tuned for BSC and BSC testnet style configs.
• TronProvider supports native transfers and balance queries. Advanced Tron contract interaction lives outside this package.

Development

bunx nx run chain-provider:lint
bunx nx run chain-provider:test
bunx nx run chain-provider:build

License

This package is part of the merchant-v2-sdk monorepo and is covered by the root MIT license.

See ../../LICENSE for details.