Files
mDuo13 26b3939747 [JA] Move files to a dir compatible with Redocly
The new folder will be compatible with both Dactyl and Redocly when it
comes to loading the Japanese translation for a given page.

Snippets are not moved for now because importing them would require
more complex changes to the actual Markdown pages, and wouldn't be
cross-compatible anyway (Redocly uses slightly different 'partial'
rather than 'include' syntax.)
2023-10-09 11:33:55 -07:00

7.7 KiB
Raw Blame History

html, parent, blurb, labels
html parent blurb labels
feature.html status-and-debugging-methods.html Amendmentに関してこのサーバーが認識している情報を返します。
ブロックチェーン
コアサーバー

feature

[ソース]

featureコマンドは、Amendmentに関してこのサーバーが認識している情報Amendmentが有効であるかどうか、サーバーがAmendmentプロセスでこれらのAmendmentに賛成票を投じたかどうかなどを返します。[新規: rippled 0.31.0][]

featureコマンドを使用して、Amendmentへの賛成票または反対票を投じるようにサーバーを一時的に設定できます。この変更は、サーバーの再起動後も保持されます。[更新: rippled 1.7.0][]

featureメソッドは、権限のないユーザーは実行できない管理メソッドです。

要求フォーマット

要求フォーマットの例:

WebSocket - すべてリスト

{
 "id": "list_all_features",
 "command": "feature"
}

WebSocket - 拒否

{
 "id": "reject_multi_sign",
 "command": "feature",
 "feature": "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373",
 "vetoed": true
}

JSON-RPC

{
   "method": "feature",
   "params": [
       {
           "feature": "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373",
           "vetoed": false
       }
   ]
}

コマンドライン

#Syntax: feature [<feature_id> [accept|reject]]
rippled feature 4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373 accept

要求には以下のパラメーターが含まれます。

Field 説明
feature 文字列 (省略可) Amendmentの一意のID16進数またはAmendmentの短い名前。指定されている場合は、応答が1つのAmendmentに限定されます。それ以外の場合は応答にすべてのAmendmentのリストが表示されます。
vetoed ブール値 (省略可、featureが指定されていない場合は無視されますtrueの場合、サーバーに対しfeatureで指定されたAmendmentに反対票を投じるように指示します。falseの場合、サーバーに対しAmendmentに賛成票を投じるように指示します。

注記: サーバーが新しいAmendmentの適用方法を現在認識していない場合でも、featureフィールドにAmendment IDを指定すれば、新しいAmendmentに賛成票を投じるようにサーバーを設定できます。たとえば、Amendmentを 確かに サポートする新しいrippledバージョンに間もなくアップグレードする予定がある場合などにこのように設定できます。

応答フォーマット

処理が成功した応答の例:

WebSocket - すべてリスト

{
 "id": "list_all_features",
 "status": "success",
 "type": "response",
 "result": {
   "features": {
     "42426C4D4F1009EE67080A9B7965B44656D7714D104A72F9B4369F97ABF044EE": {
       "enabled": false,
       "name": "FeeEscalation",
       "supported": true,
       "vetoed": false
     },
     "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373": {
       "enabled": false,
       "name": "MultiSign",
       "supported": true,
       "vetoed": false
     },
     "6781F8368C4771B83E8B821D88F580202BCB4228075297B19E4FDC5233F1EFDC": {
       "enabled": false,
       "name": "TrustSetAuth",
       "supported": true,
       "vetoed": false
     },
     "C1B8D934087225F509BEB5A8EC24447854713EE447D277F69545ABFA0E0FD490": {
       "enabled": false,
       "name": "Tickets",
       "supported": true,
       "vetoed": false
     },
     "DA1BD556B42D85EA9C84066D028D355B52416734D3283F85E216EA5DA6DB7E13": {
       "enabled": false,
       "name": "SusPay",
       "supported": true,
       "vetoed": false
     }
   }
 }
}

WebSocket - 拒否

{
   "id": "reject_multi_sign",
   "status": "success",
   "type": "response",
   "result": {
       "features": {
           "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373": {
               "enabled": false,
               "name": "MultiSign",
               "supported": true,
               "vetoed": true
           }
       }
   }
}

JSON-RPC

200 OK

{
   "result": {
       "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373": {
           "enabled": false,
           "name": "MultiSign",
           "supported": true,
           "vetoed": false
       },
       "status": "success"
   }
}

コマンドライン

Loading: "/etc/rippled.cfg"
Connecting to 127.0.0.1:5005

{
   "result": {
       "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373": {
           "enabled": false,
           "name": "MultiSign",
           "supported": true,
           "vetoed": false
       },
       "status": "success"
   }
}

応答は[標準フォーマット][]に従っており、正常に完了した場合は結果にAmendmentのマップがJSONプロジェクトとして含まれています。オブジェクトのキーはAmendment IDです。各キーの値は、そのIDのAmendmentのステータスを記述した Amendmentオブジェクト です。要求にfeatureが指定されいる場合、要求による変更の適用後には、要求されたAmendmentオブジェクトだけがマップに含まれます。各Amendmentオブジェクトのフィールドを次に示します。

Field 説明
enabled ブール値 最新レジャーでこのAmendmentが現在有効であるかどうか。
name 文字列 省略される場合がありますこのAmendmentの人間が読める形式の名前判明している場合
supported ブール値 サーバーがこのAmendmentの適用方法を認識しているかどうか。このフィールドがfalseサーバーがこのAmendmentの適用方法を認識していないに設定されており、enabledtrueこのAmendmentが最新レジャーで有効であるに設定されている場合、このAmendmentによりサーバーがAmendmentブロックされる可能性があります。
vetoed ブール値 または 文字列 ほとんどのAmendmentにおいて、これはサーバがこのAmendmentに反対票を投じるように指示されているかどうかを示すブール値です。コードの中で廃止とマークされているAmendmentについては、代わりにObsoleteという文字列を指定します。[更新: rippled 1.11.0][].

注意: Amendmentのnameは、Amendmentの内容を厳密に示すものではありません。サーバー間でこの名前が一意であることや整合性があることは保証されません。

考えられるエラー

  • [汎用エラータイプ][]のすべて。
  • badFeature - 指定されているfeatureのフォーマットが正しくないか、サーバーがその名前のAmendmentを認識していません。

{% include '_snippets/rippled-api-links.md' %} {% include '_snippets/tx-type-links.md' %} {% include '_snippets/rippled_versions.md' %}