Unable to run "forge test" in a package that depends upon another package in a monorepo because a library artifact is not found

[PaulRBerg]

Component

Forge

Have you ensured that all of these are up to date?

• Foundry
• Foundryup

What version of Foundry are you on?

v1.3.5-nightly

What version of Foundryup are you on?

v1.3.0

What command(s) is the bug in?

forge test

Operating System

macOS (Apple Silicon)

Describe the bug

Problem

forge test fails to find library artifacts for workspace dependencies, while forge build works fine.

Error:

Error: wasn't able to find artifact for library Helpers at ../node_modules/@sablier/lockup/src/libraries/Helpers.sol

Structure

monorepo/
├── foundry.toml              # Base config: "@sablier/=../node_modules/@sablier/"
├── node_modules/@sablier/
│   └── lockup -> ../../lockup # Bun workspace symlink
├── lockup/                   # Workspace package with Helpers library
│   └── out/Helpers.sol/Helpers.json ✅ Artifact exists
└── airdrops/                 # Workspace package depending on lockup
    ├── foundry.toml          # Inherits base config
    └── tests/                # Tests fail to link Helpers library

Dependency

The airdrops package depends upon the lockup package like so:

"@sablier/lockup": "workspace:*"

Note

Switching to a remote version of the package, e.g. github:sablier-labs/lockup#staging, doesn't solve the issue.

Root Cause

I think the root cause is that the test runner's library linking can't resolve artifacts through Bun workspace symlinks, even though compilation works.

Possible related issue: #11587

Repro

1. Clone https://github.com/sablier-labs/evm-monorepo
2. bun install
3. cd airdrops
4. forge test

The tests in all other packages work.

Environment

• bun v1.2.21 with workspaces enabled
• forge v1.3.5-nightly

[PaulRBerg]

think the bug is here:

foundry/crates/linking/src/lib.rs

Lines 120 to 124 in cff3dec

	.find_artifact_id_by_library_path(file, contract, Some(&target.version))
	.ok_or_else(|| LinkerError::MissingLibraryArtifact {
	file: file.to_string(),
	name: contract.to_string(),
	})?;

[PaulRBerg]

The issue persists even if I change this remapping:

"@sablier/=../node_modules/@sablier/lockup/",

To this:

"@sablier/evm-utils/=../node_modules/@sablier/lockup/",
"@sablier/lockup/=../lockup/",

[PaulRBerg]

@grandizzy how can I run forge test in trace mode to see the stack trace of the error?

[grandizzy]

do a RUST_LOG=trace forge test

[Nanle-code]

can i work on this issue
@PaulRBerg @grandizzy

[grandizzy]

yeah, it is because file is a relative path here (../node_modules/@sablier/lockup/src/libraries/Helpers.sol):

foundry/crates/linking/src/lib.rs

Line 91 in 81d50d9

if artifact_name == *name && artifact_path == Path::new(file) {

so we'd need to canonicalize and compare. However after changing that I run into a different error

Error: failed linking tests/integration/concrete/factory/instant/FactoryMerkleInstant.t.sol

raised here

foundry/crates/forge/src/multi_runner.rs

Line 524 in 81d50d9

linker.ensure_linked(contract, id)?;

Without failing on ensure linking check then tests are executed