filter_iter example fails to compile on Windows because it depends on bdk_testenv

已关闭 适合新手
  • 哪里不对？
#2,338 3 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 2 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
72/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
rust
领域
build-system, developer-experience

调研方向

先查看 crates/bitcoind_rpc/examples/README.md 和 filter_iter 示例，然后在 Windows 上运行 cargo build -p bdk_bitcoind_rpc --example filter_iter。检查 bdk_testenv::anyhow import 及其 dev-dependency 路径。完成的标准是：文档中的示例能够编译，且不会引入仅适用于 Unix 的 electrsd test harness；其现有的运行时要求仍应保留在文档中。

由索引模型根据 Issue 内容生成。

描述

Context

Discovered while using BDK as a new developer: after the bdk_bitcoind_rpc library crate compiled, I followed the in-tree example instructions to run the only official example.

Reproduction

On Windows, from a checkout of this repository:

cargo build -p bdk_bitcoind_rpc
cargo build -p bdk_bitcoind_rpc --example filter_iter

The first command succeeds. The second fails.

crates/bitcoind_rpc/examples/README.md documents the same example as:

cargo run -p bdk_bitcoind_rpc --example filter_iter
Expected behavior

The documented example should compile on a host where bdk_bitcoind_rpc itself compiles. Runtime still needs a local bitcoind (RPC_URL / RPC_COOKIE); that is already documented. Compile should not require the Unix-only test harness.

Actual behavior

Building the example pulls in the bdk_testenv dev-dependency and fails in electrsd 0.38.1's build.rs:

error[E0433]: cannot find `unix` in `os`
  --> electrsd-0.38.1\build.rs:14:18
   |
14 |     use std::os::unix::fs::PermissionsExt;

error[E0599]: no associated function or constant named `from_mode` found for struct `Permissions`
  --> electrsd-0.38.1\build.rs:78:39

The example does not use TestEnv. It only imports anyhow from bdk_testenv:

use anyhow::Context;
use bdk_testenv::anyhow;

Because Cargo examples may use the package's dev-dependencies, that import is enough to compile electrsd.

Environment
  • BDK commit: 0790f0400b108974b538e44d6498dc6fe1157548
  • Crate: bdk_bitcoind_rpc 0.22.0 (filter_iter example)
  • OS: Windows 10 (10.0.26200), x86_64-pc-windows-msvc
  • Rust: rustc 1.97.1 (8bab26f4f 2026-07-14)

Which backend(s) are relevant (if any)?

  • Bitcoin Core RPC

Is this blocking production use?

  • No
Additional context

bdk_testenv depending on electrsd is reasonable for integration tests. It is surprising for this example, because the example talks to an already-running Signet bitcoind and does not start a regtest node.

This is a build/developer-experience issue, not a runtime bug in FilterIter.

Related but different:

  • #1618 / PR #2329 — CI coverage for the example path on Ubuntu
  • #2268 — FilterIter safety
主要语言
Rust
星标
1.1k
派生
520
平均合并
4 天 1 小时
30 天内合并 PR
21

环境准备

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

bitcoindevkit/bdk 的其他 Issue

查看 bitcoindevkit/bdk 的全部 Issue

相似的 Issue

更多 Rust Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。