bip32-descriptors

本サイトが提示する下記のベストプラクティスを実行するプロジェクトは、Open Source Security Foundation (OpenSSF) バッジを達成したことを自主的に自己認証し、そのことを外部に示すことができます。

ソフトウェアに欠陥や脆弱性がないことを保証する手立てはありません。形式論的な証明ができたとしても、仕様や前提が間違っていると誤動作の可能性があります。また、プロジェクトが健全で、かつ機能的な開発コミュニティであり続けることを保証する手立てもありません。しかし、ベストプラクティスの採用は、プロジェクトの成果の向上に寄与する可能性があります。たとえば、いくつものベストプラクティスがリリース前の複数人によるレビューを定めていますが、それによりレビュー以外では発見困難な技術的脆弱性を見つけるのを助け、同時に異なる企業の開発者間の信頼を築き、さらに交流を続けることに対する意欲を生んでいます。バッジを獲得するには、すべてのMUSTおよびMUST NOT基準を満たさなければなりません。すべてのSHOULD基準も満たさなければなりませんが、正当な理由がある場合は満たさなくても構いません。そしてすべてのSUGGESTED基準も満たさなければなりませんが、満たさないとしても、少なくとも考慮することが望まれます。フィードバックは、 GitHubサイトのissueまたはpull requestとして提示されれば歓迎します。また、議論のためのメールリストも用意されています。

私たちは多言語で情報を提供していますが、翻訳版に矛盾や意味の不一致がある場合は、英語版を正式な記述とします。
これがあなたのプロジェクトなら、あなたのプロジェクトページにあなたのバッジステータスを表示してください！バッジステータスは次のようになります。 プロジェクト 16116 のバッジ レベルは silver です バッジステータスの埋め込み方法は次のとおりです。
バッジステータスを表示するには、あなたのプロジェクトのマークダウンファイルに以下を埋め込みます
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/16116/badge)](https://www.bestpractices.dev/projects/16116)
あるいは、以下をHTMLに埋め込みます
<a href="https://www.bestpractices.dev/projects/16116"><img src="https://www.bestpractices.dev/projects/16116/badge"></a>


これらはゴールドレベルの基準です。合格またはシルバーレベル基準を表示することもできます。

Baseline Series: ベースラインレベル1 ベースラインレベル2 ベースラインレベル3

        

 基本的情報 3/5 ●

  • 一般

    他のプロジェクトが同じ名前を使用していないか注意してください。

    BIP32 keys, output script descriptors and miniscript, built on btclib

    SPDXライセンスの表現形式を使用してください。 例：「Apache-2.0」、「BSD-2-Clause」、「BSD-3-Clause」、「GPL-2.0+」、「LGPL-3.0+」、「MIT」、「(BSD-2-Clause OR Ruby)」。一重引用符または二重引用符を含めないでください。
    複数の言語がある場合は、コンマを区切り（スペースを入れてもよい）としてリストし、使用頻度の高いものから順に並べます。使用言語が多くある場合は、少なくとも最初の3つの最も多く使われるものをリストアップしてください。言語がない場合（例：ドキュメントだけ、またはテスト専用のプロジェクトの場合）、1文字 " - "を使用します。言語ごとにある大文字・小文字の慣用を踏襲してください（例：「JavaScript」）。
    Common Platform Enumeration（CPE）は、情報技術（IT）システム、ソフトウェア、およびパッケージのための構造化された命名体系です。脆弱性を報告する際に、多くのシステムやデータベースで使用されています。

  • 前提要件


    バッジには十分です！

    プロジェクトは、シルバー レベル バッジを達成しなければなりません。 [achieve_silver]

  • プロジェクトの管理・運営


    バッジには不十分です。

    プロジェクトは2以上の "バス ファクタ"を持つ必要があります。 (URLが必要です) [bus_factor]
    「バス ファクタ」（別名「トラック ファクタ」）は、知見があり有能な人材が離脱して、プロジェクトが停止に至る時に、プロジェクトから突然消失する（「バスに当たった」）プロジェクトメンバーの最小人数です。 トラック ファクタツールは、GitHub上のプロジェクトに対してこれを見積もることができます。詳細については、Cosentino et al。の Gitリポジトリのバス ファクタの評価を参照してください。

    We estimate the bus factor at one: fametrano wrote most of the code this repository carries from btclib-wallet. Of the commits to btclib-wallet's src/btclib_wallet/bip32 and src/btclib_wallet/descriptors up to b8b5c9b, git log credits Ferdinando Ametrano (fametrano) with 33 of 59, adding 11528 of 12781 lines. 9488 of fametrano's added lines come from 67a7910, which copied bip32 and descriptors from btclib b7b571a0 without their history, adapting their imports and qualifying their issue references as btclib-org/btclib#N; git blame over the 9489 lines of the originals at b7b571a0 credits fametrano with 9446, Giacomo Caironi (giacomocaironi) with 36 and Stefano Pellegrini (St333p) with 7. All 8 commits up to v2026.10.31 are fametrano's, each AI-assisted with a Co-Authored-By: Claude trailer. The organization owners administer every repository. https://github.com/btclib-org/.github/blob/main/GOVERNANCE.md#continuity https://github.com/btclib-org/bip32-descriptors/graphs/contributors


    バッジには不十分です。

    プロジェクトには少なくとも2人の関係を持たない重要な貢献者がいなければなりません。 (URLが必要です) [contributors_unassociated]
    同じ組織によって作業に対しに支払われ（従業員または請負業者）、組織がプロジェクトの成果の恩恵を受ける場合、貢献者は関連します。財務補助金が他の組織を通過する場合、同じ組織のものであると見なされません（例えば、共通の政府やNGOのソースから異なる組織に支払われた科学補助金は、貢献者を関連させません）。過去1年間にプロジェクトに些細でない貢献をしていれば、その人は大きな貢献をしています。重要な貢献者の良い指標の例としては、少なくとも1,000行のコード、50個のコミット、または少なくとも20ページの文書化が挙げられます。

    All commits of this repository are fametrano's. The code they carry from btclib-wallet has other authors: git blame at btclib-wallet b8b5c9b over src/btclib_wallet/bip32, src/btclib_wallet/descriptors and the tests this repository carries credits Paolo Mazzocchi (pmazzocchi) with 2151 lines, past the criterion's 1,000-line indicator, and no one else but Ferdinando Ametrano (fametrano) with more than 511. fametrano and pmazzocchi are associated: CheckSig, where both are co-founders, pays both to work on this project and stands to benefit from it. https://github.com/fametrano https://github.com/pmazzocchi


  • その他


    バッジには十分です！

    プロジェクトは、各ソースファイルにライセンスステートメントを含まなければなりません。これは、各ファイルの先頭近くに次のコメントを含めることによって行うことができます： SPDXライセンス識別子：[プロジェクトに対するSPDXライセンス表現] [license_per_file]
    これは、ライセンスを特定する自然言語での記述を含めることによっても行うことができます。プロジェクトには、ライセンス テキストまたは完全なライセンステキストを指し示す安定したURLを含めることもできます。 license_location基準は、プロジェクトライセンスが標準の場所にあることを要求します。 SPDXライセンスの詳細については、このSPDXチュートリアルを参照してください。 copyright_per_file との関係に注意してください。その内容は通常、ライセンス情報に先行します。

    Every Python file states "Distributed under the MIT software license, see the accompanying LICENSE file or https://opensource.org/license/mit", e.g. https://github.com/btclib-org/bip32-descriptors/blob/main/src/bip32_descriptors/__init__.py


 変更管理 4/4 ●

  • 公開されたバージョン管理ソースリポジトリ


    バッジには十分です！

    プロジェクトのソースリポジトリは、共通の分散バージョン管理ソフトウェア（gitやmercurialなど）を使用しなければなりません。 [repo_distributed]
    Gitが特別に必要とされているわけでなく、プロジェクトでは、集中型バージョン管理ソフトウェア（例：subversion）を正当とする証拠を持って使用できます。

    Repository on GitHub, which uses git. git is distributed.


    バッジには十分です！

    プロジェクトは、新規または偶に参加する貢献者によって実行できる小さなタスクを明確に識別しなければなりません。 (URLが必要です) [small_tasks]
    この特定は、通常、課題トラッカーの選択された課題に対して、プロジェクトがそのために使用する1つまたは複数のタグ、たとえば、 up-for-grabs（誰でも使用可能）、first-timers-only（初心者専用）、Small fix（小修正）、microtask（小タスク）、またはIdealFirstBug（理想的な最初のバグ）のいずれかをマークすることによって行われます。 これらの新しいタスクには機能を追加する必要はありません。ドキュメントを改善したり、テストケースを追加したり、プロジェクトを支援したり、プロジェクトの詳細を貢献者が理解できるようにすることができます。

    The label good first issue marks a small task for a first contribution, as CONTRIBUTING.md says, and one search lists the open ones across the organization. Issue #9 carries it and is open; issue #3, which asked for one, was closed as answered by #9. https://github.com/btclib-org/bip32-descriptors/blob/main/CONTRIBUTING.md#the-issue-tracker https://github.com/btclib-org/bip32-descriptors/issues/9 https://github.com/search?q=org%3Abtclib-org+label%3A%22good+first+issue%22+is%3Aopen&type=issues


    バッジには十分です！

    プロジェクトは、中央リポジトリを変更したり、機密データ（プライベート脆弱性レポートなど）にアクセスするために、開発者に対して二要素認証（2FA）を要求する必要があります。推奨されませんが、2FAメカニズムは、SMSのような暗号化メカニズムを持たないメカニズムを使用することができます。 [require_2FA]

    The btclib-org organization requires two-factor authentication of every member. https://github.com/btclib-org


    バッジには十分です！

    プロジェクトの2要素認証（2FA）は、偽装を防ぐために暗号化メカニズムを使用すべきです。ショート メッセージ サービス（SMS）ベースの2FA自体は、暗号化されていないため、この基準を満たしていません。 [secure_2FA]
    この基準を満たす2FAメカニズムは、一定時間後に変更される認証コードを自動的に生成するタイムベースのワン タイム パスワード（TOTP）アプリケーションです。 GitHubはTOTPをサポートしています。

    The btclib-org organization requires two-factor authentication and allows only secure methods: TOTP apps, security keys or passkeys, and GitHub Mobile, not SMS. https://github.com/btclib-org/.github/issues/1362#issuecomment-5903994882


 品質 6/7 ●

  • コーディング標準


    バッジには十分です！

    プロジェクトは、コードレビューの実施方法、チェックする必要があるもの、受け入れられる必要があるものなど、コードレビュー要件を文書化しなければなりません。 (URLが必要です) [code_review_standards]
    two_person_review とcontribution_requirementsも参照してください。

    REVIEWING.md states what a review checks, how a finding is written and what clears a pull request; the part shared by every repository is followed by what this tree checks in particular. https://github.com/btclib-org/bip32-descriptors/blob/main/REVIEWING.md


    バッジには不十分です。

    プロジェクトは、公開する前に、提案されたすべての変更の少なくとも50％を著作者以外の人がレビューして、それが価値のある変更であり、取り込みに反対する既知の問題がないかどうかを判断しなければなりません。 [two_person_review]

    No pull request has been merged in this repository: every change on main, through the next-cycle commit bb37e84, was pushed directly to main by fametrano, before main was protected. Since then main's main-self-merge ruleset requires one approving review from somebody other than the author. No change has yet been approved by anyone. https://github.com/btclib-org/.github/blob/main/README.md#branch-protection-and-rulesets


  • 作業ビルドシステム


    バッジには十分です！

    プロジェクトが再現可能なビルドを持たなければなりません。ビルドが発生しない場合（たとえば、コンパイルされないでソースコードが直接使用されるスクリプト言語）、「該当なし」（N/A）を選択します。 (URLが必要です) [build_reproducible]
    再現可能なビルドは、複数の当事者がソース ファイルから情報を生成するプロセスを独立にやり直し、ビット単位でまったく同じ結果を得られることを意味します。ある場合には、これ（再現可能なビルド）は、あるソート順を強いることで解決されます。Javaスクリプトの開発者は、npm shrinkwrapとwebpack OccurenceOrderPluginの使用を検討するかもしれません。GCCとclangのユーザーは、-frandom-seedオプションが有用であることを見つけるかもしれません。ビルド環境（ツールセットを含む）は、リビルドに使用できる特定のコンテナや仮想マシンの暗号化ハッシュを指定することによって、外部パーティのために、しばしば定義可能です。再現可能なビルド プロジェクトは、これを行う方法を記載したドキュメントを有します。

    The sdist is built with SOURCE_DATE_EPOCH from the commit and normalized by .github/scripts/normalize_sdist.py. A rebuild of v2026.10.31 on 2026-11-01 gave the same SHA-256 as the released sdist and wheel, on PyPI and on the GitHub release. RELEASING.md's Rebuild a release from its tag gives the command. https://github.com/btclib-org/bip32-descriptors/blob/main/RELEASING.md#rebuild-a-release-from-its-tag


  • 自動テスト スイート


    バッジには十分です！

    テストスイートは、その言語の標準的な方法で呼び出すことができなければなりません。 (URLが必要です) [test_invocation]
    たとえば、「make check」、「mvn test」、「rake test」（Ruby）などです。

    https://github.com/btclib-org/bip32-descriptors?tab=contributing-ov-file


    バッジには十分です！

    プロジェクトは、新しいコードまたは変更されたコードが頻繁に中央コードリポジトリに統合され、その結果に対して自動化されたテストが実行される、継続的な統合を実装しなければなりません。 (URLが必要です) [test_continuous_integration]
    ほとんどの場合、これは、プロジェクトでフルタイムで働く各開発者が少なくとも1日に1回統合作業をすることを意味します。

    test.yml runs the suite on every pull request and on every push to main that changes more than Markdown files, and integration-bitcoind.yml runs the regtest tests on every pull request and push to main. test: every job passed and regtest / Regtest against Bitcoin Core are required checks on main. https://github.com/btclib-org/bip32-descriptors/blob/main/.github/workflows/test.yml


    バッジには十分です！

    プロジェクトは、選択された言語でこの基準を測定できる少なくとも1つのFLOSSツールがある場合、少なくとも80％のステートメント カバレッジを提供するFLOSS自動テストスイートを備えていなければなりません。 [test_statement_coverage90]

    pyproject.toml sets fail_under = 100.0 under [tool.coverage.report], and the required test check enforces it on every pull request: https://github.com/btclib-org/bip32-descriptors/blob/main/pyproject.toml


    バッジには十分です！

    選択された言語でこの基準を測定できる少なくとも1つのFLOSSツールがあれば、少なくとも80％のブランチカバレッジを提供するFLOSS自動テストスイートがプロジェクトに存在しなければなりません。 [test_branch_coverage80]

    pyproject.toml sets branch = true under [tool.coverage.run], and the 100% fail_under gate includes branches: https://github.com/btclib-org/bip32-descriptors/blob/main/pyproject.toml


 セキュリティ 4/5 ●

  • 優良な暗号手法を使用する

    一部のソフトウェアは暗号化メカニズムを使用する必要がないことに注意してください。あなたのプロジェクトが作成するソフトウェアが、(1) 暗号化機能を含む、アクティブ化する、または有効化し、(2) 米国（US）から米国外または米国市民以外にリリースされる可能性がある場合は、法的に義務付けられた追加手順の実行を要求される可能性があります。通常、これにはメールの送信が含まれます。詳細については、 Understanding Open Source Technology & US Export Controls（「オープンソース技術と米国の輸出管理について」）の暗号化のセクションを参照してください。

    バッジには十分です！

    プロジェクトで作成されたソフトウェアは、ネットワーク通信すべてに対して、SSHv2以降、TLS1.2以降 (HTTPS)、IPsec、SFTP、SNMPv3などのセキュア プロトコルをサポートしなければなりません。FTP、HTTP、telnet、SSLv3以前、SSHv1などのセキュアでないプロトコルは、デフォルトで無効にしておき、ユーザーが特別に設定した亜場合のみ有効にしなければなりません。プロジェクトによって作成されたソフトウェアがネットワーク通信をサポートしない場合は、「該当なし」（N/A）を選択します。 [crypto_used_network]

    bip32-descriptors does not use the network: no module under src/ imports socket, ssl, http or urllib, and ASSURANCE_CASE.md's threat model states it opens no socket. https://github.com/btclib-org/bip32-descriptors/tree/main/src/bip32_descriptors


    バッジには十分です！

    プロジェクトによって作成されたソフトウェアは、TLSをサポートあるいは使用する場合、少なくともTLSバージョン1.2をサポートしなければなりません。TLSの前身は、SSLと呼ばれていたことに注意して下さい。ソフトウェアがTLSを使用ない場合、「該当なし」（N/A）を選択します。 [crypto_tls12]

    bip32-descriptors performs no network communications and so uses no TLS. https://github.com/btclib-org/bip32-descriptors/tree/main/src/bip32_descriptors


  • MITM（man-in-the-middle：中間者）攻撃に対応できる安全な配信


    バッジには十分です！

    プロジェクトウェブサイト、リポジトリ（ウェブからアクセス可能な場合）、およびダウンロードサイト（別々の場合）には、許容できない値を持つキー強化ヘッダーが含まれていなければなりません。 (URLが必要です) [hardened_site]
    GitHubやGitLabはこれを満たしていることが知られているので注意してください。https://securityheaders.com/ のようなサイトは、これをすぐに確認することができます。重要なセキュリティ強化ヘッダーは以下の通りです。Content Security Policy (CSP)、HTTP Strict Transport Security (HSTS)、X-Content-Type-Options (「nosniff」として)、および X-Frame-Options 。Web ページからログインする機能のない完全に静的な Web サイトでは、いくつかの強化ヘッダーを省略してもリスクは少なくて済みますが、そのようなサイトを検出する信頼できる方法がないため、完全に静的なサイトであってもこれらのヘッダーが必要です。

    https://btclib.org/bip32-descriptors/, the project's page on the organization's site, answers 200 with Strict-Transport-Security, Content-Security-Policy, X-Frame-Options DENY and X-Content-Type-Options nosniff, measured with curl -sI on 2026-10-31. The repository on github.com sends all four. The documentation site https://bip32-descriptors.readthedocs.io/ is served by Read the Docs over HTTPS with Strict-Transport-Security and X-Content-Type-Options nosniff, and no Content-Security-Policy or X-Frame-Options; that is Read the Docs' to set. PyPI's project page sends all but the CSP.


  • その他のセキュリティ上の課題


    バッジには不十分です。

    プロジェクトは過去5年間にセキュリティレビューを実施していなければなりません。このレビューは、セキュリティ要件とセキュリティ境界を考慮しなければならりません。 [security_review]
    これは、プロジェクトメンバーおよび/または独立した評価によって行うことができます。この評価は、静的および動的解析ツールによってサポートされることができますが、ツールが検出できない問題（特に設計上）を特定するためには、人間によるレビューが必要です。

    No security review of this repository has been done. SECURITY.md's Security review says so, and ASSURANCE_CASE.md is what one will be done against. https://github.com/btclib-org/bip32-descriptors/blob/main/SECURITY.md#security-review


    バッジには十分です！

    プロジェクトによって作成されたソフトウェアで強化メカニズムを使用しなければならないので、ソフトウェア欠陥がセキュリティ上の脆弱性を引き起こす可能性が低くなります。 (URLが必要です) [hardening]
    強化メカニズムは、Content Security Policy（CSP）などのHTTPヘッダー、攻撃を緩和するコンパイラ フラグ（-fstack-protectorなど）、または未定義の動作を排除するためのコンパイラ フラグを含みます。私たちの目的のために、最低限の特権は強化メカニズムとはみなされません（最低の特権は重要ですが、別の話です）。

    ruff's select = ["ALL"] includes the bandit S rules, so a hardening defect such as unsafe deserialization or shell injection fails the lint gate. CodeQL also runs on every pull request and every push to main. https://github.com/btclib-org/bip32-descriptors/blob/main/.github/workflows/codeql.yml


 分析 2/2 ●

  • 動的コード分析


    バッジには十分です！

    プロジェクトは、リリース前にプロジェクトによって作成されたソフトウェアの主要な製品リリースに対して、少なくとも1つの動的解析ツールを適用しなければなりません。 [dynamic_analysis]
    動的解析ツールは、ソフトウェアを特定の入力で実行して検査します。たとえば、プロジェクトは、ファジングツール（アメリカンファジーロップなど）やウェブ アプリケーション スキャナ（例： ZAP または w3af ）です。場合によっては、 OSS-Fuzz プロジェクトがプロジェクトにファズテストを適用する可能性があります。この基準のために、動的分析ツールは、様々な種類の問題を探すために何らかの方法で入力を変更するかまたは少なくとも80％のブランチ カバレッジを持つ自動テスト スイートである必要があります。 動的解析に関するWikipediaのページと ファジングに関するOWASPページで、いくつかの動的解析ツールを特定しています。解析ツールは、セキュリティの脆弱性を探すことに重点を置くことができますが、これは必須ではありません。

    Every release runs the test suite and the regtest tests before it is published: release.yml calls test.yml and integration-bitcoind.yml, and the PyPI upload runs only if both pass, as they did for v2026.10.31. The suite fails below 100% coverage, branches included. fuzz.yml is scheduled weekly to run two ClusterFuzzLite atheris harnesses, fuzz/fuzz_bip32.py over the BIP32 wire decoders and fuzz/fuzz_descriptor.py over descriptor parsing. mutation.yml is scheduled weekly to run cosmic-ray mutation testing on two profiles, .github/mutation/bip32.toml and .github/mutation/descriptors.toml. qa-assets.yml is scheduled weekly to replay Bitcoin Core's descriptor fuzz corpus, and has not run yet. Manually dispatched on 2026-10-31 at bb37e84: fuzz.yml ran fuzz_descriptor and fuzz_bip32 for 30 minutes each with no reportable crash (https://github.com/btclib-org/bip32-descriptors/actions/runs/41245162550). mutation.yml's time-budgeted run executed part of each profile: descriptors killed 714, survived 263, never run 12483; bip32 killed 824, survived 70, skipped 242, never run 474 (https://github.com/btclib-org/bip32-descriptors/actions/runs/41250474104). https://github.com/btclib-org/bip32-descriptors/blob/main/.github/workflows/release.yml https://github.com/btclib-org/bip32-descriptors/blob/main/.github/workflows/fuzz.yml


    バッジには十分です！

    プロジェクトは、生成するソフトウェアに多くの実行時アサーションを含めるべきであり、動的分析中にそれらのアサーションをチェックするべきです。 [dynamic_analysis_enable_assertions]
    この基準は、本番環境でアサーションを有効にすることを示唆するものではありません。それは完全にプロジェクトとそのユーザーが決定することです。この基準の焦点は、展開前の動的分析中の障害検出を改善することです。プロダクション環境でのアサーションの有効化は、動的分析（テストなど）中にアサーションを有効にすることとはまったく異なります。場合によっては、プロダクション環境でアサーションを有効にすることは非常に賢明ではありません（特に高整合性コンポーネントの場合）。プロダクション環境でアサーションを有効にすることには多くの議論があります。たとえば、ライブラリは呼び出し元をクラッシュさせてはなりません。ライブラリが存在するとアプリストアによる拒否が発生する可能性があります。また、プロダクション環境でアサーションをアクティブにすると、秘密鍵などの秘密データが公開される可能性があります。多くのLinuxディストリビューションではNDEBUGが定義されていないため、これらのディストリビューションのプロダクション環境ではデフォルトで C/C++ assert() が有効になります。これらの環境でのプロダクション環境では、別のアサーションメカニズムを使用するか、 NDEBUGを定義することが重要です。

    pytest, the regtest tests, the mutation runs and the ClusterFuzzLite targets run Python without -O, so every assert is checked. https://github.com/btclib-org/bip32-descriptors/blob/main/.github/workflows/fuzz.yml



ツールやAIシステムを使って、https://www.bestpractices.dev/ja/projects/16116/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforcedのような簡単なURLで変更を提案できます。その方法については、自動化提案システムをご覧ください。 このデータは、Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0)のもとで利用可能です。これは、データ受領者が、データ受領者がこの契約のテキストを共有データとともに利用可能にする限り、変更の有無にかかわらずデータを共有できることを意味します。Ferdinando AmetranoおよびOpenSSFベストプラクティスバッジのコントリビューターにクレジットを表示してください。

プロジェクト バッジ登録の所有者： Ferdinando Ametrano.
エントリの作成日時 2026-10-31 10:16:11 UTC、 最終更新日 2026-11-01 09:17:08 UTC 最後に2026-11-01 01:50:34 UTCにバッジ合格を達成しました。