mirror of https://github.com/XRPLF/xrpl-dev-portal.git synced 2025-11-27 23:25:51 +00:00

Files

mDuo13 7645140477 Re-levelization: move non-docs content, rename content→docs

For better URLs, the content folder has been renamed 'docs' and all
other files have been moved up a level. Also, non-docs images have been
moved to the static folder at the top level where they belong.

Many relative paths had to be fixed to make this work.

2024-01-31 17:53:52 -08:00

5.9 KiB

Raw Blame History

html, parent, seo, labels

html

parent

seo

labels

contribute-code.html

resources.html

description
XRP Ledgerプロトコルにどのように機能を実装するかを学びます。

ブロックチェーン

コードへの貢献

XRP Ledgerを動かすソフトウェアはオープンソースです。誰でもダウンロードし、変更し、拡張し、調査することができます。もしあなたがコードに貢献したいのであれば、コミュニティと協力してあなたの変更の仕様を定義し、XRP Ledgerのプロトコルとブロックチェーンの一部になる前にコードをテストすることが重要です。

コアサーバのソースコード

XRP Ledgerを動かすソフトウェアはオープンソースです。コミュニティが参加することで、より良いものが生まれます。ドキュメント内の"[Source]"リンクから関連するソースコードに直接ジャンプしたり、GitHubでソースコードを閲覧することができます：

XRP Ledger ソースコード
リポジトリ	https://github.com/XRPLF/rippled
ライセンス	Multiple; ISC (permissive)
プログラム言語	C++

何から始めたらいいか分からないという方のために、Dev Null Productionsは、XRP Ledgerサーバー(rippled)のコア実装の仕組みや機能を説明した、詳細かつ充実したソースコード・ガイドを提供しています。

XRP Ledgerの規格

rippledに対する変更はXRP Ledger Standard (XLS)、つまり変更の仕様を特定し詳細に記述した文書によって管理されます。開発にコミットする前に、XRPL-Standardsリポジトリで議論を始める必要があります。これにより、コミュニティはあなたの変更に関して議論し、フィードバックを提供する機会を得ることができます。

注記:* バグ修正にはXLSは必要ありませんが、Amendmentが必要になる場合があります。

XLSの作成には独自のプロセスがありますが、簡単にまとめると次のようになります：

ディスカッションを開始し、フィードバックを集めます。
StandardリポジトリにXLSドラフトを作成します。
XLSドラフトを仕様候補として公開します。

詳細については、XLS貢献ガイドをご覧ください。

Amendmentの実装

XLSドラフトを作成した後、その変更にAmendmentが必要かどうかを判断する必要があります。特に次のようなトランザクション処理に影響する変更にはAmendment が必要です。

レジャールールを変更し、異なる結果をもたらすもの。
トランザクションの追加または削除。
コンセンサスへの影響がある変更。

注記: 変更にAmendmentが必要ない場合、そのままコーディングとデプロイに進むことができます。

コードをAmendmentとして実装するには、次のファイルにAmendment情報を追加する必要があります。

Feature.cpp:

開発が完了するまで、Supportedパラメータはnoに設定してください。

バグの修正の場合、DefaultVoteパラメータをyesに設定する必要があります。
Feature.h: numFeatures カウンタを増やし、extern uint256 const 変数を宣言します。

コーディングとデプロイ

一般的な開発プロセスは以下の通りです。

コードを開発するためにはまず、rippled リポジトリをフォークまたはブランチを作成します。

ヒント: 何から始めたらいいかわからない場合は、Dev Null Productions が詳細かつ充実した rippled ソースコードガイドを提供しています。
単体テストと統合テストを実行します。独立した環境で作業をテストするにはスタンドアロンモードでサーバを実行するのが良いでしょう。
XRPLF:developにプルリクエストを作成します。

Amendment向けの注記: Feature.cppのSupportedパラメータをyesに更新します。
プルリクエストがXRP Ledgerのメンテナによって承認されると、あなたのコードはdevelopにマージされ、Devnet上で追加のテストを行うことができます。

Amendment向けの注記:
- DefaultVoteパラメータはロックされます。
- もしAmendmentに問題が見つかれば、Amendmentの修正と新しいPRの提出を再度行う必要があります。新しいPRではDefaultVoteを変更することができます。

年に4回、developで承認されたPRからリリース候補がビルドされます。このパッケージはTestnetとMainnet上のいくつかのノードにデプロイされます。リリース候補に問題がなければ、コードはmasterにマージされ、メインネット上のノードはこのビルドにアップグレードできます。

新しいAmendmentは合意形成プロセスを経て、バリデーターがそのAmendmentを有効にするかどうかを投票します。

コードのフローチャート

![コードのフローチャート](/docs/img/Contribute Code Flowchart.png)

5.9 KiB Raw Blame History Unescape Escape