feat: formalize ethereum test for variables/helper

Author: cesarenaldi

packages/client/src/test-utils.ts

@@ -3,11 +3,22 @@
 import { local, staging } from '@aave/env';
 import type { AnyVariables } from '@aave/graphql';
 import { schema } from '@aave/graphql/test-utils';
-import { chainId } from '@aave/types';
+import {
+  type BigDecimal,
+  bigDecimal,
+  chainId,
+  type EvmAddress,
+} from '@aave/types';
 import type { TypedDocumentNode } from '@urql/core';
 import { validate } from 'graphql';
 import type { ValidationRule } from 'graphql/validation/ValidationContext';
-import { createWalletClient, http, type WalletClient } from 'viem';
+import {
+  createPublicClient,
+  createWalletClient,
+  http,
+  parseEther,
+  type WalletClient,
+} from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { sepolia } from 'viem/chains';
 import { expect } from 'vitest';
@@ -18,7 +29,13 @@ export const signer = privateKeyToAccount(import.meta.env.PRIVATE_KEY);
 export const environment =
   import.meta.env.ENVIRONMENT === 'local' ? local : staging;
 
-export const tenderlyFork = chainId(99999999);
+export const ETHEREUM_FORK_ID = chainId(99999999);
+
+export const ETHEREUM_FORK_RPC_URL =
+  'https://virtual.mainnet.rpc.tenderly.co/27ff3c60-0e2c-4d46-8190-f5170dc7da8c';
+
+// Re-export for convenience
+export { bigDecimal } from '@aave/types';
 
 export const client = AaveClient.create({
   environment,
@@ -30,6 +47,48 @@ export const wallet: WalletClient = createWalletClient({
   transport: http(),
 });
 
+// Tenderly RPC type for setBalance
+type TSetBalanceRpc = {
+  Method: 'tenderly_setBalance';
+  Parameters: [addresses: string[], amount: string];
+  ReturnType: string;
+};
+
+/**
+ * Fund an address on Tenderly fork with specified ETH amount
+ * @param address - Address to fund
+ * @param amount - Amount in ETH (BigDecimal string, e.g., "1.5" for 1.5 ETH)
+ * @returns Transaction hash
+ */
+export async function fundAddress(
+  address: EvmAddress,
+  amount: BigDecimal = bigDecimal('1.0'), // 1 ETH
+): Promise<string> {
+  // Create client with fork chain - you'll need to replace this with your actual fork chain config
+  const publicClient = createPublicClient({
+    chain: {
+      id: ETHEREUM_FORK_ID,
+      name: 'Tenderly Fork',
+      network: 'tenderly-fork',
+      nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+      rpcUrls: {
+        default: { http: [ETHEREUM_FORK_RPC_URL] },
+      },
+    },
+    transport: http(ETHEREUM_FORK_RPC_URL),
+  });
+
+  const amountInWei = parseEther(amount);
+  const amountHex = `0x${amountInWei.toString(16)}`;
+
+  const txHash = await publicClient.request<TSetBalanceRpc>({
+    method: 'tenderly_setBalance',
+    params: [[address], amountHex],
+  });
+
+  return txHash;
+}
+
 const messages: Record<GraphQLErrorCode, string> = {
   [GraphQLErrorCode.UNAUTHENTICATED]:
     "Unauthenticated - Authentication is required to access '<operation>'",