Merge branch 'main' of github.com:push-protocol/push-chain-sdk

Author: mohammeds1992

packages/core/__e2e__/pushchain.spec.ts

@@ -18,7 +18,7 @@ import { CHAIN_INFO } from '../src/lib/constants/chain';
 import dotenv from 'dotenv';
 import path from 'path';
 import { UniversalTxResponse } from '../src/lib/orchestrator/orchestrator.types';
-import { sepolia, arbitrumSepolia, baseSepolia } from 'viem/chains';
+import { sepolia, arbitrumSepolia, baseSepolia, bscTestnet } from 'viem/chains';
 import bs58 from 'bs58';
 
 // Adjust path as needed if your .env is in the root
@@ -446,6 +446,145 @@ describe('PushChain (e2e)', () => {
         });
       }, 300000);
     });
+
+    describe('BNB_TESTNET', () => {
+      const originChain = CHAIN.BNB_TESTNET;
+      let pushClient: PushChain;
+
+      beforeAll(async () => {
+        const privateKey = process.env['EVM_PRIVATE_KEY'] as Hex;
+        if (!privateKey) throw new Error('EVM_PRIVATE_KEY not set');
+
+        const account = privateKeyToAccount(privateKey);
+        const walletClient = createWalletClient({
+          account,
+          transport: http(CHAIN_INFO[originChain].defaultRPC[0]),
+        });
+
+        universalSigner = await PushChain.utils.signer.toUniversalFromKeypair(
+          walletClient,
+          {
+            chain: originChain,
+            library: PushChain.CONSTANTS.LIBRARY.ETHEREUM_VIEM,
+          }
+        );
+
+        pushClient = await PushChain.initialize(universalSigner, {
+          network: pushNetwork,
+          progressHook: (val: any) => {
+            console.log(val);
+          },
+        });
+
+        // Generate random account
+        randomAccount = privateKeyToAccount(generatePrivateKey());
+        // Try to send BNB Testnet ETH to random generated address
+        const txHash = await walletClient.sendTransaction({
+          to: randomAccount.address,
+          chain: bscTestnet,
+          value: PushChain.utils.helpers.parseUnits('1', 14),
+        });
+        const publicClient = createPublicClient({
+          chain: bscTestnet,
+          transport: http(),
+        });
+        await publicClient.waitForTransactionReceipt({
+          hash: txHash,
+        });
+      }, 100000);
+
+      it('should fail to send universal.sendTransaction with invalid feeLockTxHash', async () => {
+        await expect(
+          pushClient.universal.sendTransaction({
+            to,
+            feeLockTxHash: '0xABC', // Invalid txHash
+            value: BigInt(1e3),
+          })
+        ).rejects.toThrow();
+      }, 30000);
+
+      it('should fail to send universal.sendTransaction with fundGas property', async () => {
+        await expect(
+          pushClient.universal.sendTransaction({
+            to,
+            value: BigInt(1e3),
+            fundGas: {
+              chainToken: '0x1234567890123456789012345678901234567890',
+            },
+          })
+        ).rejects.toThrow('Unsupported token');
+      }, 30000);
+
+      it('should successfully send universal.sendTransaction without fundGas (default behavior)', async () => {
+        const tx = await pushClient.universal.sendTransaction({
+          to,
+          value: BigInt(1e3),
+          // fundGas not provided - should work fine
+        });
+        expect(tx).toBeDefined();
+        expect(tx.hash).toMatch(/^0x[a-fA-F0-9]{64}$/);
+        await txValidator(
+          tx,
+          pushClient.universal.origin.address as `0x${string}`,
+          to
+        );
+      }, 300000);
+
+      it('should successfully sendTransaction - Transfer Call', async () => {
+        const tx = await pushClient.universal.sendTransaction({
+          to,
+          value: BigInt(1e3),
+        });
+        const after = await PushChain.utils.account.convertOriginToExecutor(
+          universalSigner.account,
+          {
+            onlyCompute: true,
+          }
+        );
+        expect(after.deployed).toBe(true);
+        await txValidator(
+          tx,
+          pushClient.universal.origin.address as `0x${string}`,
+          to
+        );
+      }, 300000);
+
+      it('should successfully sendTransaction to funded undeployed UEA', async () => {
+        const walletClient = createWalletClient({
+          account: randomAccount,
+          transport: http(CHAIN_INFO[originChain].defaultRPC[0]),
+        });
+        const randomUniversalSigner =
+          await PushChain.utils.signer.toUniversalFromKeypair(walletClient, {
+            chain: originChain,
+            library: PushChain.CONSTANTS.LIBRARY.ETHEREUM_VIEM,
+          });
+        const UEA = await PushChain.utils.account.convertOriginToExecutor(
+          randomUniversalSigner.account,
+          {
+            onlyCompute: true,
+          }
+        );
+
+        // Fund Undeployed UEA - 1PC
+        await pushClient.universal.sendTransaction({
+          to: UEA.address,
+          value: BigInt(1e18),
+        });
+
+        // Send Tx Via Random Address
+        const randomPushClient = await PushChain.initialize(
+          randomUniversalSigner,
+          {
+            network: pushNetwork,
+          }
+        );
+        await randomPushClient.universal.sendTransaction({
+          to,
+          value: BigInt(1e6),
+        });
+      }, 300000);
+    });
   });
   describe('Origin - Push', () => {
     const originChain = CHAIN.PUSH_TESTNET_DONUT;

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "2.0.21",
+  "version": "2.1.0",
   "homepage": "https://push.org",
   "keywords": [
     "pushchain",

packages/core/src/lib/constants/chain.ts

@@ -1,5 +1,5 @@
 import { CHAIN, PUSH_NETWORK, VM } from './enums';
-import { mainnet, sepolia, arbitrumSepolia, baseSepolia } from 'viem/chains';
+import { mainnet, sepolia, arbitrumSepolia, baseSepolia, bscTestnet } from 'viem/chains';
 
 /**
  * Maps VM type to its namespace
@@ -97,6 +97,14 @@ export const CHAIN_INFO: Record<
     confirmations: 1,
     timeout: 30000,
   },
+  [CHAIN.BNB_TESTNET]: {
+    chainId: '97',
+    vm: VM.EVM,
+    lockerContract: '0x44aFFC61983F4348DdddB886349eb992C061EaC0',
+    defaultRPC: [bscTestnet.rpcUrls.default.http[0]],
+    confirmations: 1,
+    timeout: 30000,
+  },
 
   // Solana
   [CHAIN.SOLANA_MAINNET]: {

packages/core/src/lib/constants/enums.ts

@@ -25,6 +25,7 @@ export enum CHAIN {
   ETHEREUM_SEPOLIA = 'eip155:11155111',
   ARBITRUM_SEPOLIA = 'eip155:421614',
   BASE_SEPOLIA = 'eip155:84532',
+  BNB_TESTNET = 'eip155:97',
 
   // Solana
   SOLANA_MAINNET = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',

packages/core/src/lib/constants/tokens.ts

@@ -169,6 +169,22 @@ export const MOVEABLE_TOKENS: Partial<Record<CHAIN, MoveableToken[]>> = {
     },
   ],
 
+  // BNB Testnet
+  [CHAIN.BNB_TESTNET]: [
+    {
+      symbol: 'ETH',
+      decimals: 18,
+      address: EVM_NATIVE,
+      mechanism: 'native',
+    },
+    {
+      symbol: 'USDT',
+      decimals: 6,
+      address: '0xBC14F348BC9667be46b35Edc9B68653d86013DC5',
+      mechanism: 'approve',
+    },
+  ],
+
   // Solana Devnet (decimals are per SPL mint; addresses TBD)
   [CHAIN.SOLANA_DEVNET]: [
     // Native SOL (lamports) sentinel: use 'solana-native' string; not used as a Pubkey
@@ -260,6 +276,20 @@ export const PAYABLE_TOKENS: Partial<Record<CHAIN, PayableToken[]>> = {
       mechanism: 'approve',
     },
   ],
+  [CHAIN.BNB_TESTNET]: [
+    {
+      symbol: 'BNB',
+      decimals: 18,
+      address: EVM_NATIVE,
+      mechanism: 'native',
+    },
+    {
+      symbol: 'USDT',
+      decimals: 6,
+      address: '0xBC14F348BC9667be46b35Edc9B68653d86013DC5',
+      mechanism: 'approve',
+    },
+  ],
   [CHAIN.SOLANA_DEVNET]: [
     {
       symbol: 'SOL',

packages/core/src/lib/orchestrator/orchestrator.ts

@@ -135,11 +135,12 @@ export class Orchestrator {
               chain === CHAIN.ETHEREUM_SEPOLIA ||
               chain === CHAIN.ARBITRUM_SEPOLIA ||
               chain === CHAIN.BASE_SEPOLIA ||
+              chain === CHAIN.BNB_TESTNET ||
               chain === CHAIN.SOLANA_DEVNET
             )
           ) {
             throw new Error(
-              'Funds bridging is only supported on Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, and Solana Devnet for now'
+              'Funds bridging is only supported on Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, BNB Testnet, and Solana Devnet for now'
             );
           }
 
@@ -1693,10 +1694,11 @@ export class Orchestrator {
       chain !== CHAIN.ETHEREUM_SEPOLIA &&
       chain !== CHAIN.ARBITRUM_SEPOLIA &&
       chain !== CHAIN.BASE_SEPOLIA &&
+      chain !== CHAIN.BNB_TESTNET &&
       chain !== CHAIN.SOLANA_DEVNET
     ) {
       throw new Error(
-        'Funds + payload bridging is only supported on Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, and Solana Devnet for now'
+        'Funds + payload bridging is only supported on Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, BNB Testnet, and Solana Devnet for now'
       );
     }
 

packages/core/src/lib/push-chain/push-chain.spec.ts

@@ -15,7 +15,7 @@ import {
   parseAbi,
   PrivateKeyAccount,
 } from 'viem';
-import { sepolia, arbitrumSepolia, baseSepolia } from 'viem/chains';
+import { sepolia, arbitrumSepolia, baseSepolia, bscTestnet } from 'viem/chains';
 import { keccak256, toBytes } from 'viem';
 import { MulticallCall } from '../orchestrator/orchestrator.types';
 import { CHAIN_INFO } from '../constants/chain';
@@ -36,6 +36,9 @@ const ARBITRUM_SEPOLIA_RPC =
 const BASE_SEPOLIA_RPC =
   process.env['BASE_SEPOLIA_RPC'] ||
   CHAIN_INFO[CHAIN.BASE_SEPOLIA].defaultRPC[0];
+const BNB_TESTNET_RPC =
+  process.env['BNB_TESTNET_RPC'] ||
+  CHAIN_INFO[CHAIN.BNB_TESTNET].defaultRPC[0];
 const SOLANA_RPC =
   process.env['SOLANA_RPC_URL'] ||
   CHAIN_INFO[CHAIN.SOLANA_DEVNET].defaultRPC[0];
@@ -44,7 +47,7 @@ const SOLANA_RPC =
 interface EVMChainTestConfig {
   name: string;
   chain: CHAIN;
-  viemChain: typeof sepolia | typeof arbitrumSepolia | typeof baseSepolia;
+  viemChain: typeof sepolia | typeof arbitrumSepolia | typeof baseSepolia | typeof bscTestnet;
   rpcUrl: string;
   gatewayAddress: string;
   tokens: {
@@ -107,6 +110,22 @@ const EVM_CHAIN_CONFIGS: EVMChainTestConfig[] = [
       },
     },
   },
+  {
+    name: 'BNB Testnet',
+    chain: CHAIN.BNB_TESTNET,
+    viemChain: bscTestnet,
+    rpcUrl: BNB_TESTNET_RPC,
+    gatewayAddress: '0x44aFFC61983F4348DdddB886349eb992C061EaC0',
+    tokens: {
+      usdt: {
+        address: '0xBC14F348BC9667be46b35Edc9B68653d86013DC5',
+        decimals: 6,
+      },
+      eth: {
+        decimals: 18,
+      },
+    },
+  },
 ];
 
 // Reusable test helper functions
@@ -273,6 +292,9 @@ async function testSendTxWithFundsUSDT(
   expect(resUSDT.hash.startsWith('0x')).toBe(true);
   await resUSDT.wait();
 
+  // Wait for Push Chain state to finalize
+  await new Promise(resolve => setTimeout(resolve, 3000));
+
   const afterCount = (await pushPublicClient.readContract({
     abi: COUNTER_ABI,
     address: COUNTER_ADDRESS,
@@ -794,6 +816,27 @@ describe('PushChain', () => {
       }, 300000);
     });
 
+    describe('Multicall - BNB Testnet', () => {
+      const config = EVM_CHAIN_CONFIGS[3]; // BNB Testnet
+      const PRIVATE_KEY = process.env['EVM_PRIVATE_KEY'] as
+        | `0x${string}`
+        | undefined;
+      let client: PushChain;
+
+      beforeAll(async () => {
+        if (!PRIVATE_KEY) {
+          throw new Error('EVM_PRIVATE_KEY environment variable is not set');
+        }
+
+        const result = await setupEVMChainClient(config, PRIVATE_KEY);
+        client = result.client;
+      });
+
+      it('integration: should build and send multicall payload', async () => {
+        await testMulticall(client, config);
+      }, 300000);
+    });
+
     describe('signTypedData', () => {
       it('should signTypedData - EIP-712 format', async () => {
         const domain = {
@@ -1606,6 +1649,37 @@ describe('PushChain', () => {
     }, 500000);
   });
 
+  describe('Universal.sendTransaction (FUNDS_TX via UniversalGatewayV0) - BNB Testnet', () => {
+    const config = EVM_CHAIN_CONFIGS[3]; // BNB Testnet
+    const PRIVATE_KEY = process.env['EVM_PRIVATE_KEY'] as
+      | `0x${string}`
+      | undefined;
+    let account: PrivateKeyAccount;
+    let client: PushChain;
+
+    beforeAll(async () => {
+      if (!PRIVATE_KEY) {
+        throw new Error('EVM_PRIVATE_KEY environment variable is not set');
+      }
+
+      const result = await setupEVMChainClient(config, PRIVATE_KEY);
+      account = result.account;
+      client = result.client;
+    });
+
+    it('integration: sendFunds USDT via UniversalGatewayV0', async () => {
+      await testSendFundsUSDT(client, account, config);
+    }, 300000);
+
+    it('integration: sendFunds BNB via UniversalGatewayV0', async () => {
+      await testSendFundsETH(client, config);
+    }, 300000);
+
+    it('integration: sendTxWithFunds USDT via UniversalGatewayV0', async () => {
+      await testSendTxWithFundsUSDT(client, account, config);
+    }, 500000);
+  });
+
   // Test for unsupported origin chains (only needs to run once, not per chain)
   describe('Universal.sendTransaction - Unsupported chains', () => {
     it('should throw on unsupported origin chains', async () => {

packages/core/src/lib/universal/account/account.ts

@@ -153,6 +153,7 @@ function getPushNetworkFromChain(chain: CHAIN): PUSH_NETWORK {
     CHAIN.ETHEREUM_SEPOLIA,
     CHAIN.ARBITRUM_SEPOLIA,
     CHAIN.BASE_SEPOLIA,
+    CHAIN.BNB_TESTNET,
     CHAIN.SOLANA_TESTNET,
     CHAIN.SOLANA_DEVNET,
     CHAIN.PUSH_TESTNET_DONUT,