Skip to content

chore: added CLAUDE.md and AGENTS.md files#962

Open
frolvanya wants to merge 4 commits intomasterfrom
chore/add-claude-md
Open

chore: added CLAUDE.md and AGENTS.md files#962
frolvanya wants to merge 4 commits intomasterfrom
chore/add-claude-md

Conversation

@frolvanya
Copy link
Contributor

No description provided.

CLAUDE.md Outdated
cd contracts/near/eth2-client/src/data && uv run dump_sepolia_data.py
```

## Migration Pattern
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To remove

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed in fb150d4

CLAUDE.md Outdated

`__DeprecatedUnfinalizedHeaders` and `__DeprecatedSubmitters` are leftover from V1 migration — do not reuse.

## Access Control
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To remove

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed in fb150d4

CLAUDE.md Outdated
- One sync committee period = 8192 slots ≈ 27 hours
- `hashes_gc_threshold` is typically 51000 (~7 days of blocks)

## Storage Keys
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To remove

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed in fb150d4


**CI** (`.github/workflows/contracts-near.yml`): runs `make build-eth2-client`, `./test.sh`, and relayer tests. Requires `git-lfs` for test data.

## Contract State Machine
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lets extend it with more details

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in fb150d4


Light client updates can advance by at most 1 sync committee period (8192 slots ≈ 27 hours). This bounds GC to at most one period's worth of removals per cycle.

## Key Protocol Constants
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's extend and put ref to the spec

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in fb150d4

@karim-en karim-en requested review from kiseln and olga24912 February 16, 2026 23:35
@karim-en karim-en marked this pull request as ready for review February 16, 2026 23:37
CLAUDE.md Outdated
cd contracts/near && cargo test -p eth2-client

# Run a single test
cd contracts/near && cargo test -p eth2-client test_gc_headers -- --nocapture
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably useless for an agent

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree, removed in 6cfddc5

@frolvanya frolvanya requested a review from karim-en February 22, 2026 22:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants