Skip to content

Attempt to add integration tests which simulate graph calculations #1612

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
arwer13 wants to merge 13 commits into
base: develop
Choose a base branch
from
Open

Attempt to add integration tests which simulate graph calculations #1612

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
70ea809
test: the first of graph simulating integration tests
arwer13 Dec 14, 2025
62b5548
fix: integration tests
tamtamchik Dec 14, 2025
6368603
chore: better output
tamtamchik Dec 14, 2025
a2426bd
chore: cleanup
tamtamchik Dec 14, 2025
1c38c95
test(graph): add handling of Totals entity + tests edge cases
arwer13 Dec 16, 2025
8e3f35f
Merge remote-tracking branch 'refs/remotes/origin/test/graph-mvp' int…
arwer13 Dec 16, 2025
84d6e8a
test(graph): add more entities and human-readable README.md
arwer13 Dec 17, 2025
59b9819
Merge branch 'develop' into test/graph-mvp
arwer13 Dec 17, 2025
989a997
test(graph): support mainnet
arwer13 Dec 18, 2025
8537495
test(graph): add graph entities NodeOperatorFees and NodeOperatorsShares
arwer13 Dec 18, 2025
a793f47
Merge branch 'develop' into test/graph-mvp
arwer13 Dec 18, 2025
e5ace0c
test(graph): remove unsed graph query-related code
arwer13 Dec 18, 2025
738cc99
test(graph): make graph simulator track absolute values
arwer13 Dec 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
79 changes: 79 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

Lido on Ethereum liquid-staking protocol core contracts repository. Users deposit ETH and receive stETH tokens representing their stake. The protocol uses Aragon DAO for governance.

## Build & Test Commands

```bash
yarn compile # Compile all contracts
yarn test # Run all unit tests (parallel)
yarn test:sequential # Run tests sequentially (required for .only)
yarn test:trace # Run with call tracing
yarn test:forge # Run Foundry fuzzing tests
yarn test:integration:scratch # Integration tests on scratch deploy
yarn test:integration # Integration tests on mainnet fork
yarn lint # Run all linters
yarn lint:sol:fix # Fix Solidity lint issues
yarn lint:ts:fix # Fix TypeScript lint issues
yarn format:fix # Fix formatting
yarn typecheck # TypeScript type checking
```

To run a single test: add `.only` to the test and run `yarn test:sequential`.

Environment: Copy `.env.example` to `.env` and configure `RPC_URL` for mainnet fork tests.

## Project Structure

### Contracts (`/contracts`)

Organized by Solidity version:

- `0.4.24/` - Core Aragon-managed contracts (Lido, stETH, NodeOperatorsRegistry)
- `0.6.12/` - wstETH (non-upgradeable, version-locked)
- `0.8.9/` - Modern contracts (StakingRouter, WithdrawalQueue, Oracles, Accounting)
- `0.8.25/` - Staking Vaults system (VaultHub, StakingVault, Dashboard, PredepositGuarantee)
- `common/` - Shared interfaces and libraries across versions

### Tests (`/test`)

Mirror the contracts structure. Naming conventions:

- `*.test.ts` - Hardhat unit tests
- `*.integration.ts` - Integration tests
- `*.t.sol` - Foundry tests (fuzzing)
- `__Harness` suffix - Test wrappers exposing private functions
- `__Mock` suffix - Simulated contract behavior

### Library (`/lib`)

TypeScript utilities for tests and scripts. Key modules:

- `protocol/` - Protocol discovery and helpers (accounting, staking, withdrawal, vaults)
- `eips/` - EIP implementations (EIP-712, EIP-4788, EIP-7002, EIP-7251)
- Test helpers: deposit, dsm, oracle, signing-keys

### Scripts (`/scripts`)

- `scratch/steps/` - Scratch deployment steps
- `upgrade/steps/` - Protocol upgrade scripts

## Architecture Notes

**Multi-compiler setup**: Different contracts use different Solidity versions due to Aragon compatibility (0.4.24) and feature requirements. See `contracts/COMPILERS.md`.

**OpenZeppelin v5.2 local copies**: Located in `contracts/openzeppelin/5.2/upgradeable/` with modified imports to support the aliased dependency `@openzeppelin/contracts-v5.2`.

**Tracing in tests**: Wrap code with `Tracing.enable()` and `Tracing.disable()` from `test/suite`, then run with `yarn test:trace`.

## Conventions

- Package manager: yarn (not npx)
- Commits: Conventional Commits format
- Solidity: Follow Official Solidity Style Guide, auto-format with Solhint
- TypeScript: Auto-format with ESLint
- Temporary data: Store in `data/temp/` directory
Loading
Loading