Skip to content

fix: stale libs/ paths and misleading FFI comment#284

Merged
Th0rgal merged 1 commit intomainfrom
fix/external-libs-readme-and-docs
Feb 17, 2026
Merged

fix: stale libs/ paths and misleading FFI comment#284
Th0rgal merged 1 commit intomainfrom
fix/external-libs-readme-and-docs

Conversation

@Th0rgal
Copy link
Member

@Th0rgal Th0rgal commented Feb 17, 2026

Summary

  • examples/external-libs/README.md: Fix 5 broken libs/ paths → examples/external-libs/ (the actual directory where library files live)
  • getting-started.mdx: Fix misleading "Property tests (no FFI needed)" comment — all Property*.t.sol files inherit YulTestBase which uses vm.ffi() to invoke solc, so they all require FOUNDRY_PROFILE=difftest

Context

The libs/ directory doesn't exist in the repo. External libraries live in examples/external-libs/. Previous PRs (#280, #283) fixed libs/ paths in README.md, linking-libraries.mdx, and other docs, but the examples/external-libs/README.md quickstart guide was missed — this is the first file a developer opens when trying to use the linker feature.

Test plan

  • check_doc_counts.py passes
  • All libs/ paths in examples/external-libs/README.md updated to match actual directory
  • CI green

🤖 Generated with Claude Code


Note

Low Risk
Docs-only updates: adjusts test commands/comments around vm.ffi() requirements and fixes broken example --link paths. Low risk since no runtime or compiler behavior changes.

Overview
Updates the docs to remove misleading guidance about running tests without FFI: the getting started guide now treats FOUNDRY_PROFILE=difftest forge test as the default for all tests, and provides a separate command to run unit tests only without FFI.

Fixes stale libs/ references in examples/external-libs/README.md, updating the quickstart and troubleshooting snippets to use the correct examples/external-libs/*.yul paths for --link.

Written by Cursor Bugbot for commit 3dfa7d7. This will update automatically on new commits. Configure here.

- examples/external-libs/README.md: fix 5 broken `libs/` paths →
  `examples/external-libs/` (matching actual directory structure)
- getting-started.mdx: fix misleading "Property tests (no FFI needed)"
  comment — all Property*.t.sol files use vm.ffi() to invoke solc and
  require FOUNDRY_PROFILE=difftest

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Feb 17, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
dumbcontracts Ready Ready Preview, Comment Feb 17, 2026 6:07pm

Request Review

@Th0rgal Th0rgal merged commit 53b1bb0 into main Feb 17, 2026
20 checks passed
@Th0rgal Th0rgal deleted the fix/external-libs-readme-and-docs branch February 17, 2026 18:15
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.

2 participants