first integration tests (#64)

resolves #60

Co-authored-by: johba <johba@harb.eth>
Reviewed-on: https://codeberg.org/johba/harb/pulls/64
This commit is contained in:
johba 2025-10-05 19:40:14 +02:00
parent d6f0bf4f02
commit 1645865c5a
14 changed files with 913 additions and 2226 deletions

141
tests/setup/stack.ts Normal file
View file

@ -0,0 +1,141 @@
import { exec as execCallback } from 'node:child_process';
import { readFile } from 'node:fs/promises';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { promisify } from 'node:util';
const exec = promisify(execCallback);
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
const repoRoot = resolve(__dirname, '..', '..');
const DEFAULT_RPC_URL = process.env.STACK_RPC_URL ?? 'http://127.0.0.1:8545';
const DEFAULT_WEBAPP_URL = process.env.STACK_WEBAPP_URL ?? 'http://localhost:5173';
const DEFAULT_GRAPHQL_URL = process.env.STACK_GRAPHQL_URL ?? 'http://localhost:42069/graphql';
let stackStarted = false;
async function cleanupContainers(): Promise<void> {
try {
await run("podman pod ps -q --filter name=harb | xargs -r podman pod rm -f || true");
await run("podman ps -aq --filter name=harb | xargs -r podman rm -f || true");
} catch (error) {
console.warn('[stack] Failed to cleanup containers', error);
}
}
function delay(ms: number): Promise<void> {
return new Promise(resolveDelay => setTimeout(resolveDelay, ms));
}
async function run(command: string): Promise<void> {
await exec(command, { cwd: repoRoot, shell: true });
}
async function checkRpcReady(rpcUrl: string): Promise<void> {
const response = await fetch(rpcUrl, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'eth_chainId', params: [] }),
});
if (!response.ok) {
throw new Error(`RPC health check failed with status ${response.status}`);
}
const payload = await response.json();
if (!payload?.result) {
throw new Error('RPC health check returned no result');
}
}
async function checkWebAppReady(webAppUrl: string): Promise<void> {
const url = webAppUrl.endsWith('/') ? `${webAppUrl}app/` : `${webAppUrl}/app/`;
const response = await fetch(url, {
method: 'GET',
redirect: 'manual',
});
if (!response.ok && response.status !== 308) {
throw new Error(`Web app health check failed with status ${response.status}`);
}
}
async function checkGraphqlReady(graphqlUrl: string): Promise<void> {
const response = await fetch(graphqlUrl, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ query: '{ __typename }' }),
});
if (!response.ok) {
throw new Error(`GraphQL health check failed with status ${response.status}`);
}
}
export async function startStack(): Promise<void> {
if (stackStarted) {
return;
}
await cleanupContainers();
await run('nohup ./scripts/dev.sh start > ./tests/.stack.log 2>&1 &');
stackStarted = true;
}
export async function waitForStackReady(options: {
rpcUrl?: string;
webAppUrl?: string;
graphqlUrl?: string;
timeoutMs?: number;
pollIntervalMs?: number;
} = {}): Promise<void> {
const rpcUrl = options.rpcUrl ?? DEFAULT_RPC_URL;
const webAppUrl = options.webAppUrl ?? DEFAULT_WEBAPP_URL;
const graphqlUrl = options.graphqlUrl ?? DEFAULT_GRAPHQL_URL;
const timeoutMs = options.timeoutMs ?? 180_000;
const pollIntervalMs = options.pollIntervalMs ?? 2_000;
const start = Date.now();
const errors = new Map<string, string>();
while (Date.now() - start < timeoutMs) {
try {
await Promise.all([
checkRpcReady(rpcUrl),
checkWebAppReady(webAppUrl),
checkGraphqlReady(graphqlUrl),
]);
return;
} catch (error) {
const message = error instanceof Error ? error.message : String(error);
errors.set('lastError', message);
await delay(pollIntervalMs);
}
}
const logPath = resolve(repoRoot, 'tests', '.stack.log');
let logTail = '';
try {
const contents = await readFile(logPath, 'utf-8');
logTail = contents.split('\n').slice(-40).join('\n');
} catch (readError) {
logTail = `Unable to read stack log: ${readError}`;
}
throw new Error(`Stack failed to become ready within ${timeoutMs}ms\nLast error: ${errors.get('lastError')}\nLog tail:\n${logTail}`);
}
export async function stopStack(): Promise<void> {
if (!stackStarted) {
return;
}
try {
await run('./scripts/dev.sh stop');
} finally {
stackStarted = false;
}
}

View file

@ -0,0 +1,207 @@
import type { Browser, BrowserContext } from '@playwright/test';
import { Wallet } from 'ethers';
export interface WalletProviderOptions {
privateKey: string;
rpcUrl?: string;
chainId?: number;
chainName?: string;
walletName?: string;
walletUuid?: string;
}
const DEFAULT_CHAIN_ID = 31337;
const DEFAULT_RPC_URL = 'http://127.0.0.1:8545';
const DEFAULT_WALLET_NAME = 'Playwright Wallet';
const DEFAULT_WALLET_UUID = '11111111-2222-3333-4444-555555555555';
export async function createWalletContext(
browser: Browser,
options: WalletProviderOptions,
): Promise<BrowserContext> {
const chainId = options.chainId ?? DEFAULT_CHAIN_ID;
const rpcUrl = options.rpcUrl ?? DEFAULT_RPC_URL;
const chainName = options.chainName ?? 'Kraiken Local Fork';
const walletName = options.walletName ?? DEFAULT_WALLET_NAME;
const walletUuid = options.walletUuid ?? DEFAULT_WALLET_UUID;
const wallet = new Wallet(options.privateKey);
const address = wallet.address;
const chainIdHex = `0x${chainId.toString(16)}`;
const context = await browser.newContext();
await context.addInitScript(() => {
window.localStorage.setItem('authentificated', 'true');
});
await context.addInitScript(
({
account,
chainIdHex: cidHex,
chainId: cid,
rpcEndpoint,
chainLabel,
walletLabel,
walletId,
}) => {
const listeners = new Map<string, Set<(...args: any[]) => void>>();
let rpcRequestId = 0;
let connected = false;
const emit = (event: string, payload: any): void => {
const handlers = listeners.get(event);
if (!handlers) {
return;
}
for (const handler of Array.from(handlers)) {
try {
handler(payload);
} catch (error) {
console.error(`[wallet-provider] listener for ${event} failed`, error);
}
}
};
const sendRpc = async (method: string, params: unknown[]): Promise<unknown> => {
rpcRequestId += 1;
const response = await fetch(rpcEndpoint, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ jsonrpc: '2.0', id: rpcRequestId, method, params }),
});
if (!response.ok) {
throw new Error(`RPC call to ${method} failed with status ${response.status}`);
}
const payload = await response.json();
if (payload?.error) {
const message = payload.error?.message ?? 'RPC error';
throw new Error(message);
}
return payload.result;
};
const provider: any = {
isMetaMask: true,
isPlaywrightWallet: true,
isConnected: () => connected,
selectedAddress: account,
chainId: cidHex,
networkVersion: String(cid),
request: async ({ method, params = [] }: { method: string; params?: unknown[] }) => {
const args = Array.isArray(params) ? params.slice() : [];
switch (method) {
case 'eth_requestAccounts':
connected = true;
provider.selectedAddress = account;
provider.chainId = cidHex;
provider.networkVersion = String(cid);
emit('connect', { chainId: cidHex });
emit('chainChanged', cidHex);
emit('accountsChanged', [account]);
return [account];
case 'eth_accounts':
return [account];
case 'eth_chainId':
return cidHex;
case 'net_version':
return String(cid);
case 'wallet_switchEthereumChain': {
const requested = (args[0] as { chainId?: string } | undefined)?.chainId;
if (requested && requested.toLowerCase() !== cidHex.toLowerCase()) {
throw new Error(`Unsupported chain ${requested}`);
}
return null;
}
case 'wallet_addEthereumChain':
return null;
case 'eth_sendTransaction': {
const [tx = {}] = args as Record<string, unknown>[];
const enrichedTx = { ...tx, from: account };
return sendRpc(method, [enrichedTx]);
}
case 'eth_sign':
case 'personal_sign':
case 'eth_signTypedData':
case 'eth_signTypedData_v3':
case 'eth_signTypedData_v4': {
if (args.length > 0) {
args[0] = account;
}
return sendRpc(method, args);
}
default:
return sendRpc(method, args);
}
},
on: (event: string, listener: (...args: any[]) => void) => {
const handlers = listeners.get(event) ?? new Set();
handlers.add(listener);
listeners.set(event, handlers);
if (event === 'connect' && connected) {
listener({ chainId: cidHex });
}
return provider;
},
removeListener: (event: string, listener: (...args: any[]) => void) => {
const handlers = listeners.get(event);
if (handlers) {
handlers.delete(listener);
}
return provider;
},
enable: () => provider.request({ method: 'eth_requestAccounts' }),
requestPermissions: () =>
Promise.resolve([{ parentCapability: 'eth_accounts' }]),
getProviderState: async () => ({
accounts: [account],
chainId: cidHex,
isConnected: connected,
}),
};
const announce = () => {
const detail = Object.freeze({
info: Object.freeze({
uuid: walletId,
name: walletLabel,
icon: 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><circle cx="32" cy="32" r="32" fill="%234f46e5"/><path d="M20 34l6 6 18-18" fill="none" stroke="white" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/></svg>',
rdns: 'org.playwright.wallet',
}),
provider,
});
window.dispatchEvent(new CustomEvent('eip6963:announceProvider', { detail }));
};
const requestListener = () => announce();
window.addEventListener('eip6963:requestProvider', requestListener);
Object.defineProperty(window, 'ethereum', {
configurable: true,
enumerable: true,
value: provider,
writable: false,
});
provider.providers = [provider];
announce();
window.dispatchEvent(new Event('ethereum#initialized'));
console.info('[wallet-provider] Injected test provider for', chainLabel);
},
{
account: address,
chainIdHex,
chainId,
rpcEndpoint: rpcUrl,
chainLabel: chainName,
walletLabel: walletName,
walletId: walletUuid,
},
);
return context;
}