XRP Ledger とはXRP LedgerはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。PoWやPoSとは異なる独自のコンセンサスアルゴリズム(Proof of Association)が用いられています。EVMによるスマートコントラクトは搭載しておらず、スマートトランザクタ(プロトコルネイティブで提供されている機能)を拡張することで進化し続けています。DEXやNFTなどの機能だけでなく、エスくローやペイメントチャネル等の決済向けの高度な機能も備わっています。 ペイメントチャネル機能ペイメントチャネルとは、送金の一部をオフチェーン...

XRP Ledgerのペイメントチャネルを触ってみる

Xahau Network8/28にXRP Ledgerのサイドチェーン"Xahau Network"のホワイトペーパーが発表されました。https://twitter.com/XRPLLabs/status/1696098331317899679本記事はホワイトペーパーの要約になります。 Xahau NetworkとはXahau Ledger（Xahau）はXRPLエコシステムのスマートコントラクトサイドチェーンです。これはXRP Ledgerのオープンソースコード"rippled"をもとにしたフォークネットワークであり、そのエコロジーの持続可能性を含むXRPLのすべて...

XRP Ledegrのサイドチェーン Xahau Networkの紹介

EvernodeとはEvernodeはXRPレジャー上で動作する「レイヤー2」スマートコントラクトを提供するプロジェクトです。HotPocketプロトコルとHooks Amendmentsを組み合わせ、XRPレジャーと連携して任意のdAppを安価かつ高速に実行できるグローバルな分散ネットワークを作成します。2023年中に予定されているのXRPL Hooksサイドチェーンのリリースに合わせリリースされる予定です。https://zenn.dev/tequ/articles/xrpl-evernode-concept HotPocketHotPocketはスマートコントラクト...

Evernodeのコントラクトチュートリアル

XRPレジャーとはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。XRPレジャーではトランザクションはプロトコルネイティブであり、開発者が個別にNFTやDEXなどを機能を構築することなく、利用できます。 DIDDIDは分散型ID(Decentralized Identifier)を意味し、各ユーザが操作権限を持つグローバルなIDのことを指します。詳しくは次の記事をご覧くだ...

XRPレジャーのDID機能

XRPレジャーXRPレジャー(XRPL)はBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。NFTやDEXなどの機能がプロトコルネイティブに実装されており、他チェーンに比べて安全にこれらの機能を利用することができます。XRPLのよく知られる特徴としては、トランザクション承認までの早さやその手数料の安さが挙げられます。 トランザクション手数料XRPLのトランザクション手数料は他の多くのチェー...

XRPレジャーのトランザクションの手数料

XRPレジャーXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。NFTやDEXなどの機能がプロトコルネイティブに実装されており、他チェーンに比べて安全にこれらの機能を利用することができます。 レジャーオブジェクトレジャーオブジェクトとは、XRPレジャーのステートを構成するデータのことを指します。XRPレジャー上の全てのステートはレジャーオブジェクトで表され、トランザクション...

XRPLトランザクションのメタデータを学ぶ

XRPレジャーの学習こちらの記事にてXRPLの学習フローを作成しました。https://zenn.dev/tequ/articles/xrpl-learning-flow(学習フローには記載していませんが)この記事ではXRPLのトランザクションについて説明します。 XRPレジャーのトランザクションXRPレジャーのトランザクションはXRPレジャーの状態(レジャーオブジェクト)を変更する唯一の手段です。XRPレジャーのトランザクションはプロトコルネイティブで定義されており、どのようなトランザクションタイプを使用するか、どんなフィールド、フラグを設定するかによりさまざまな処理...

XRPレジャーのトランザクションの基礎

はじめに現在様々な暗号資産/ブロックチェーンはそれぞれ主要なまたは独自のコンセンサスの仕組みを搭載しています。
PoWやPoSなどがよく知られていますが、どのようにコンセンサスを行っているのでしょうか？コンセンサスの側面から考えてみましょう。

なぜコンセンサスが必要か？そもそもそのコンセンサスで何を成し遂げようとしているのでしょうか？

それはそのネットワークの参加者との合意を行うためです。

最小限のコンセンサス

私とあなたが取引を行い、そこで発生したお金のやり取りにつ

コンセンサスに対する直接的なアプローチ

EvernodeとはEvernodeはXRPレジャー上で動作する「レイヤー2」スマートコントラクトを提供するプロジェクトです。HotPocketプロトコルとHooks Amendmentsを組み合わせ、XRPレジャーと連携して任意のdAppを安価かつ高速に実行できるグローバルな分散ネットワークを作成します。2023年中に予定されているXRPL Hooksサイドチェーンのリリースに合わせリリースされる予定です。 コンセンサスプロトコルEvernodeはコンセンサスエンジンとしてHotPocketプロトコルを使用します。HotPocketはUnique Node List（U...

XRPレジャーのL2ネットワーク - Evernodeの概要

XRPレジャーの学習こちらの記事にてXRPLの学習フローを作成しました。https://zenn.dev/tequ/articles/xrpl-learning-flow本記事ではフロー内の基礎部分(パート2)について説明したいと思います。パートはこちらhttps://zenn.dev/tequ/articles/xrpl-learning-flow-basic-1 本記事で説明する内容アカウントPayment(XRP)トラストラインRipplingPayment(Token) アカウント アドレスXRPレジャーのアカウントはrf1BiGe...

XRPLの学習フロー 基礎(2)

XRPレジャーの学習こちらの記事にてXRPLの学習フローを作成しました。https://zenn.dev/tequ/articles/xrpl-learning-flow本記事ではフロー内の基礎部分(パート1)について説明したいと思います。 本記事で説明する内容レジャーオブジェクトの概要トランザクションタイプの概要トランザクション手数料と準備金 レジャーオブジェクトの概要レジャーオブジェクトとはXRPレジャーの状態ツリーを構成するオブジェクトのことを指します。例えばXRP残高を含むアカウント情報(AccountRoot)やDEXの注文情報(Offer)、ア...

XRPLの学習フロー 基礎(1)

XRPレジャーの学習これまで初学者がXRPレジャーを学ぼうとする時にドキュメントがあるだけでは何から学んでいくべきなのか、どのように学んでいくべきなのかが分かりにくいと思っていました。それを解決するため、XRPL初学者向けの学習フローを作りました！https://miro.com/app/board/uXjVMeKwEvE=/?share_link_id=427945666442DEXを使ったプロダクトを作ってみたいけど、どう学んでいけば良いかわからない…などといった方もこのフローに沿って学んでいくことで、順序立てて分かりやすく学ぶことができます。!ここでは技術面につい...

XRPLの学習フロー

XRPレジャー とはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。XRPレジャーではトランザクションはプロトコルネイティブであり、開発者が個別にNFTやDEXなどを機能を構築することなく、利用することができます。 HooksXRPLを使ったプロダクトの開発者はNFTやDEXなどで用意された多くのパラメータなどを利用することができますが、独自のロジックを実装することは出来ま...

XRPL HooksのState機能を試す

XRPレジャーとはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。XRPレジャーではトランザクションはプロトコルネイティブであり、開発者が個別にNFTやDEXなどを機能を構築することなく、利用することができます。 XRPLの機能XRPレジャーやXRPと聞くと、多くの人が送金機能に特化したブロックチェーンと認識しているかもしれません。しかし、実際にはXRPレジャーには多くの機...

XRPレジャーの開発中の機能

XRPレジャーのメインネットで利用可能な機能

XRPレジャーとはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。XRPレジャーではトランザクションはプロトコルネイティブであり、開発者が個別にNFTやDEXなどを機能を構築することなく、利用することができます。 HooksXRPLを使ったプロダクトの開発者はNFTやDEXなどで用意された多くのパラメータなどを利用することができますが、独自のロジックを実装することは出来ませ...

XRPLでスマコンの操作の種類

XRPLのスマコン機能「Hooks」を軽く触ってみる

XRPレジャー とはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。XRPレジャーではコントラクトの開発の必要なくトークンを発行することができ、トークンの発行者は自身が発行したトークンに対して一定の権限を持つことができます。!XRPレジャーのネイティブトークンであるXRPは発行者が存在しないため、いかなるアカウントもその管理を行うことはできません。 トークンの管理トー...

XRPLのClawback機能

XRPレジャー とはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。EVMによるスマートコントラクトは搭載しておらず、スマートトランザクタ(プロトコルネイティブで提供されている機能)を拡張することで進化し続けています。代表的な機能としてはトークンの発行や管理、DEX、マルチシグなどがあります。 トークンの仕組みXRPLにおけるトークンはIOUとも呼ばれ、本来は外部の価値の債権を表すものです。次に説明する仕組みを利用することで、XRPL上でのトークン...

XRPLのRippling機能

XRPレジャーとはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。ビットコインの初期コントリビュータを含む3人の開発者により2012年に開発され、PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。XRPレジャーには複数のトランザクションタイプが存在し、トランザクションタイプ毎にさまざまな機能を提供しています。 トランザクションXRPレジャーにおいてトランザクションは次のような形式で表されます。{  "TransactionType": "Payment",  "Account": "r9DVZ8...

XRPLトランザクションの自動入力フィールド

XRPレジャー とはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。トークン機能やDEX機能をプロトコルネイティブに搭載しており、強力な決済機能があります。決済機能だけでなくNFTやAMM(開発中)、Hooks(スマコン/開発中)など様々な機能を搭載しています。 URITokenURITokenはXRPレジャーに軽量かつ第一級オブジェクトとしてのNFT機能をもたらします。このNFTは同一発行者で同一のURIデータを設定することが出来ないため、URIの...

軽量NFTであるURITokenを触ってみる

## はじめに

XRPレジャーは、分散型台帳技術を採用したブロックチェーンの1つです。2012年にXRP Ledgerは3人の開発者によって開発され、現在もXRPL財団やRipple社、XRPL Labsなどを始めとしたXRPLコミュニティによって開発が続けられています。

XRPLのアカウントは単に資産の残高データを持つだけでなく、他のデータも保有することができます。

## アカウント

XRPレジャーのアカウントにはいくつかのメタデータを設定することができます。これらを設定することで他者がアカウントの所有者の情報を確認することが可能になります。
このようなデータはアカウント情報を保持する`AccountRoot`オブジェクトに格納されます。

```json :AccountRoot
{
  "LedgerEntryType": "AccountRoot",
  "Account": "rfe5EiXPyruyrM47jRKkZX7Gx81DrEDuy6",
  "Balance": "999999904",
  "Domain": "6578616D706C652D646F6D61696E2E636F6D",
  "EmailHash": "CF1D201E1FBEA4E38CE832149C0BAB4A",
  "Flags": 0,
  "MessageKey": "020000000000000000000000004CCAE8EBCB878C8DB19A910A5EEBCE32E8693211",
  "OwnerCount": 0,
  "PreviousTxnID": "819CBB4911DE6F354947BA9D9745A3B27B50B91E93F0D467CA7B42C3D63D7F8F",
  "PreviousTxnLgrSeq": 37608192,
  "Sequence": 37607227,
  "index": "D41F5D7BADDBBBBB807804FC0AC6A97EA52775639C5D530F7539B1D790DBBF00",
}
```

### メタデータ

#### Domain

`Domain`フィールドには任意のドメインを表す文字列を設定することができます。
いくつかのサービスではこの情報を利用し、アカウントに紐付くドメインとして表示しています。

このフィールドのドメインを設定するだけではドメインの所有者がこのアカウントを保持することの証明にはなリません。そのドメインのウェブサイトにてXRPレジャーに関する情報を公開することで双方向リンクを確立することが推奨されています。
慣例上、その情報は`{ドメイン名}/.well-known/xrp-ledger.toml`で公開します。

#### EmailHash

`EmailHash`フィールドにはアバター画像の生成のために使用するメールアドレスのハッシュ値を指定します。一般的には[Gravatar](https://ja.gravatar.com/site/implement/hash/)を利用しアバターの生成が行われます。

次のURLでGravatar画像の取得を行うことができます。。
https://secure.gravatar.com/avatar/{EmailHashを小文字で指定}

#### MessageKey

`MessageKey`フィールドには任意の公開鍵を設定することができます。鍵の種類を表す先頭1バイト+任意の32バイトの合計33バイトを設定します。用途などは自由です。

過去にはFlare NetworkがXRPLアドレスの残高をベースにトークン配布を行う際、XRPLアドレスに紐付けるトークン配布先のイーサリアムアドレスを設定するために利用されました。

#### WalletLocator

`WalletLocator`には任意の256ビット値を指定することができます。

#### WalletSize

`WalletSize`には任意の32bit整数値を指定することができます。

https://xrpl.org/ja/accountset.html#accountset-%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89

## メタデータを利用するサービス

いくつかのサービスではDomainやEmailHashの情報を参照し、アカウントの情報として表示しています。

### XRPScan

![xrpscan](https://user-images.githubusercontent.com/69445828/236678843-ac2374fa-47b5-4e4b-97f9-178959330004.png)

https://xrpscan.com/account/rQQQrUdN1cLdNmxH4dHfKgmX5P4kf3ZrM

### bithomp

![bithomp](https://user-images.githubusercontent.com/69445828/236678863-f0f355cd-fc50-4d47-b1de-11e653b8f026.png)

https://bithomp.com/explorer/rQQQrUdN1cLdNmxH4dHfKgmX5P4kf3ZrM

## メタデータの設定

これらのメタデータは`AccountSet`トランザクションを使用し、設定・更新・削除を行うことができます。

ここではXRPレジャーのJavascriptライブラリである`xrpl.js`を使った例を紹介します。

https://www.npmjs.com/package/xrpl

```js
import { Client, Wallet, convertStringToHex } from "xrpl";
const crypto = require('crypto')

const md5hex = (str: string) => {
  const md5 = crypto.createHash('md5')
  return md5.update(str, 'binary').digest('hex')
}

const wallet = Wallet.fromSecret("sEdSS1xTNskRyjzBjBbHMbJW6SsYv7J");
// rfe5EiXPyruyrM47jRKkZX7Gx81DrEDuy6

const client = new Client("wss://testnet.xrpl-labs.com");

const main = async () => {
  await client.connect();
  const response = await client.submitAndWait(
    {
      TransactionType: "AccountSet",
      Account: "rfe5EiXPyruyrM47jRKkZX7Gx81DrEDuy6",
      Domain: convertStringToHex("example-domain.com"),
      EmailHash: md5hex('alice@example-email.com'.trim()).toUpperCase(),
      MessageKey: '020000000000000000000000004CCAE8EBCB878C8DB19A910A5EEBCE32E8693211',
    },
    { wallet }
  );
  console.log(response.result.hash)
};

main()
```

- Domain: Hex値で設定
- EmalHash: メールアドレスをmd5でハッシュ化し設定

## まとめ

XRPレジャーのアカウントにはいくつかのメタデータが設定可能であることを説明しました。メタデータは非常に簡単にかつ低手数料で設定/変更することができます。

メタデータはAccountRootオブジェクトの一部であり、XRPLのバリデータの合意があればフィールドの追加も可能です(コアプログラムであるrippledの修正が必要です)。

XRP Ledgerに興味がある方は開発者Discordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


XRPLアカウントのメタデータ

分散型のパブリックブロックチェーンであるXRPレジャーの状態ツリーはレジャーオブジェクトのセットとして表されます。このセットを総合してXRP Ledgerの全ての残高や設定、関係が表されます。

このレジャーオブジェクトはプロトコルで定義されたものであり、XRPレジャーにおいて第一級オブジェクトとして扱われます。

レジャーオブジェクトレジャーオブジェクトはLedgerEntryTypeによって分類され、次の表に示すものが存在します。
(一部の特殊なレジャーオブジェクトは省略

XRPレジャーの第一級オブジェクト

# はじめに

XRPレジャーは、分散型台帳技術を採用したブロックチェーンの1つです。XRPレジャーは3人の開発者によって開発され、現在もXRPL財団やRipple社、XRPL Labsなどを始めとしたXRPLコミュニティによって開発が続けられています。
この記事では、XRPレジャーのスパム対策としての手数料の仕組みについて解説します。

https://xrpl.org/ja/transaction-cost.html

# XRPレジャーの手数料

XRPレジャーではいくつかの種類の手数料が存在します。これらは**ネットワークを健全に保つための仕組み**であり、ユーザは適切な利用の範囲内ではほぼゼロに近い手数料でXRPレジャーを利用することが出来ます。

使用した手数料はバリデータに分配されることはなく、ネットワークから完全に焼却されます。

## リファレンス手数料

トランザクションを送信するために手数料として必要とする最低限のXRP量です。
「最低限必要となるトランザクション手数料」とほとんど同じものと考えても良いでしょう。

執筆時点でメインネットではリファレンス手数料の額は0.000010XRP(10drops)となっています。

リファレンス手数料はXRPレジャーをスパムやDoS攻撃から守るための仕組みであり、ネットワークの負荷とともに増加するように設計されています。

https://github.com/XRPLF/rippled/blob/release/src/ripple/app/misc/FeeEscalation.md#fee-escalation

実際のコストはトランザクションを送信するノードの負荷によって決定されますが、リファレンス手数料を下回ることはできません。

トランザクション送信時の`Fee`フィールドの値がリファレンス手数料未満の場合、そのトランザクションは送信ノードによって弾かれるため、コンセンサスの対象になりません。

```jsx :トランザクションの例
{
  "TransactionType" : "Payment",
  "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
  "Amount" : {
  "currency" : "USD",
  "value" : "1",
    "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
  },
  "Fee": "12",
  "Flags": 2147483648,
  "Sequence": 2,
}
```

## アカウント準備金

アカウントを使用する上で必要となる準備金であり必要準備金とも呼ばれます。準備金は手数料とは異なり焼却されずに一時的に利用不可なものとしてレジャー上にロックされます。

執筆時点でアカウント準備金の額は10XRP(10,000,000drops)となっています。

アカウント準備金を保有していないアカウントはXRP残高を始めとする一切のデータがレジャー上に存在しません。他のアカウントからアカウント準備金分のXRPをアドレスに送金することでアカウントのデータがレジャー上に作成されます。

https://xrpl.org/ja/accounts.html#アカウントの作成

これはアカウントのスパム作成を防ぎ、レジャーサイズの肥大化を防ぐための仕組みとなっています。

アカウントの削除(AccountDeleteトランザクション)を行うことでアカウント準備金の一部(8XRP)を取り戻すことができます。

https://xrpl.org/ja/accounts.html#アカウントの削除

## 所有者準備金

アカウントがオブジェクト(データ)を所有するために必要な準備金です。アカウント準備金と同様、焼却されることはなく、レジャー上にロックされます。

執筆時点でアカウント準備金の額は2XRP(2,000,000drops)となっています。

XRPレジャーではDEXへの注文を表すOfferオブジェクトや、トークンの保有限度額を表しトラストラインとも呼ばれるRippleStateオブジェクトなど特定のデータを表すオブジェクトが存在します。これらオブジェクトのほとんどはアカウントから送信されるトランザクションによって作成され、そのアカウントの所有するオブジェクトとして表されます。

このようなオブジェクトはレジャー上のデータであるため、アカウントは自身が所有するオブジェクト分の使用料として準備金が必要となります。トランザクションを通して、オブジェクトを削除する/削除されることで準備金を取り戻すことができます(アカウント準備金とは異なり、準備金の全額を取り戻すことが出来ます。)。

この準備金が存在しない場合、アカウントはDEXへの注文を多量に作成することが出来てしまい、レジャーサイズの肥大化を引き起こしてしまいます。

https://xrpl.org/ja/reserves.html#所有者準備金

```mermaid
pie
title オブジェクトによるレジャーの占有割合(執筆時点)
  "RippleState" : 2832.7
  "DirectoryNode": 1290.3
  "AccountRoot" : 808.1
  "NFTokenPage": 211.1
  "Offer" : 52.4
  "NFTokenOffer": 37
  "SignerList": 21.3
  "LedgerHashes": 19.4
  "Ticket": 5.2
  "Escrow" : 2.3
  "PayChannel": 0.8
  "DepositPreauth": 0.01
  "Check": 0.004
  "FeeSetting": 0
  "Amendments": 0
```

# 手数料決定の仕組み

XRP Ledgerにおける手数料や準備金の額はバリデータによる**オンレジャーのガバナンス投票**によって決定されます。投票はフラグレジャーという256毎のレジャーを基準に行われます。

各バリデータは自身のUNLに設定したバリデータからの投票を集計し、バリデータの設定値との妥協を図ります。妥協の結果、設定値に変更がある場合は、フラグレジャーの次のレジャー(フラグレジャー+1)に`SetFee疑似トランザクション`を送信します。

他のバリデータも同様に同一設定の`SetFee擬似トランザクション`を送信していた場合、フラグレジャー+1のコンセンサスラウンドを通過し、検証済みのレジャーに含まれることになります。

UNLの80%超のバリデータが同一設定の`SetFee疑似トランザクション`を送信していない場合は、コンセンサスラウンドを通過することはなく、手数料の変更も行われません。

https://xrpl.org/ja/fee-voting.html

https://xrpl.org/ja/setfee.html

# 現在の手数料を取得する

XRPレジャーの現在の手数料情報を取得するには`fee`メソッドを使用します。

https://xrpl.org/ja/fee.html

```js
const { Client } = require('xrpl');

const client = new Client('wss://xrpl.ws');

client.connect().then(() => {
  client
    .request({
      command: 'fee',
    })
    .then((response) => {
      console.log(response.result);
    });
});
```

```js
{
  current_ledger_size: '46',
  current_queue_size: '0',
  drops: {
    base_fee: '10',
    median_fee: '5000',
    minimum_fee: '10',
    open_ledger_fee: '10'
  },
  expected_ledger_size: '141',
  ledger_current_index: 79203954,
  levels: {
    median_level: '128000',
    minimum_level: '256',
    open_ledger_level: '256',
    reference_level: '256'
  },
  max_queue_size: '2820'
}
```

`drops`フィールドを確認することで現在の手数料を確認することができます。

最小限の負担でトランザクションを送信したい場合は`base_fee`、少なくともトランザクションキューに入るようにトランザクションを送信したい場合は`minimum_fee`、トランザクションキューに入らずに直接トランザクションを送信したい場合は`open_ledger_fee`を使用すると良いでしょう(それぞれを保証する値ではありません)。

## まとめ

本記事では、XRPレジャーの手数料の仕組みについて解説しました。トランザクション手数料や準備金はネットワークを健全に保つために必要な仕組みであり、これによりユーザが大きな負担なくXRPレジャーを利用することができるのです。
またこの手数料はバリデータによるオンレジャーのガバナンス投票で決められているという点も面白いでしょう。

XRP Ledgerに興味がある方は開発者Discordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


XRPLの手数料投票

コンセンサスに対する洗練されたアプローチ

はじめにこちらは2022年12月にStefan Tomasによって公開された"An Elegant Approach to Consensus"の翻訳です。

Stefan TomasはBitcoinJSの開発者であり、XRP Ledgerの初期の開発にも携わっていました。

この翻訳は原著者であるStefan Tomasの許可を得て翻訳したものです。
翻訳に原著者は関わっておらず、訳者によってのみ行われました。

記事の内容は原文執筆時点のものであり、翻訳時点で既に古くなっ

## はじめに

XRP Ledgerは、分散型台帳技術を採用したブロックチェーンの1つです。2012年にXRP Ledgerは3人の開発者によって開発され、現在もXRPL財団やRipple社、XRPL Labsなどを始めとしたXRPLコミュニティによって開発が続けられています。

暗号資産を利用する上で秘密鍵は非常に重要な役割を担っています。秘密鍵を紛失した場合、一般的にはアカウントの資産を取り戻すことはできません。本記事では、XRP Ledgerにおける秘密鍵紛失時でもアカウントの資産にアクセスする方法について解説します。

アカウントリカバリーの方法として次の2つがあります。

- **レギュラーキーを利用したアカウントリカバリー**
- **マルチシグを利用したアカウントリカバリー**

## レギュラーキーを使用したアカウントリカバリー

### レギュラーキーとは

レギュラーキーは、XRP Ledgerのアカウントのマスターキーとは別に設定できるキーです。マスターキーと同様トランザクションへの署名が可能であるため、マスターキーを紛失した場合でもアカウントへのアクセス権を持つことができます。

https://xrpl.org/ja/cryptographic-keys.html#レギュラーキーペア

マスターキーが流出した場合は、マスターキーを無効化することでその後レギュラーキーを使いアカウントを利用し続けることも可能です

### レギュラーキーの設定

https://xrpl.org/ja/assign-a-regular-key-pair.html#レギュラーキーペアの割り当て

https://xrpl.org/ja/setregularkey.html

レギュラーキーは`SetRegularKey`トランザクションにより設定することが可能です。初めてレギュラーキーを設定する場合は、マスターキーが必要となります。

まずはレギュラーキーとするアカウントを作成しましょう。

```js
const { Wallet } = require('xrpl');

const wallet = Wallet.generate();

console.log(wallet);
```

https://stackblitz.com/edit/xrpl-regularkey?file=generate-address.js

実行すると以下のような結果が得られます。
今回はデモのため、値を表示していますが、実際にはprivateKeyやseedが厳重に管理される必要があります。

```sh
Wallet {
  publicKey: 'ED531B7E785F5537CB7BA62B74237519008CEEEC85E864A8F588067AFF59957F9E',
  privateKey: 'ED255BD3ACA7339FE4F669ECE0CE1ED902D761C684E18C1710E49D761A3D3B3081',
  classicAddress: 'rncAosMLDnD2QwMnPxPLqs3ihzPRzSWY3t',
  seed: 'sEdV5mUW2vi9wbFeNvJtBcCmZ23bmu3'
}
```

その後自身のアカウントにレギュラーキーを設定します。

```js
const { Client, Wallet } = require('xrpl');

const client = new Client('wss://testnet.xrpl-labs.com');
// 自身のアカウントのマスターキー(シード)
const wallet = Wallet.fromSeed('sEdTMf58AqhPoKxQ3PK6RBzfN6HYztC');

const main = async () => {
  await client.connect();

  const response = await client.submitAndWait(
    {
      TransactionType: 'SetRegularKey',
      Account: 'rakMd7KDSpnVjgbtfTsCtTu4h7gqJ42DZL',
      // レギュラーキーとするアカウントのアドレス
      RegularKey: 'rncAosMLDnD2QwMnPxPLqs3ihzPRzSWY3t',
    },
    { wallet }
  );
  console.log(response.result.hash);
  // D740755808517728EEB944F60534E43FA3F5A1D27005BB8785E38E2010FB7A3E
};

main();
```

https://stackblitz.com/edit/xrpl-regularkey?file=setRegularKey.js

これでレギュラーキーの設定が完了しました。以下がトランザクションの実行結果です。

https://test.bithomp.com/explorer/D740755808517728EEB944F60534E43FA3F5A1D27005BB8785E38E2010FB7A3E

ページ内のRaw TX dataを見るとレギュラーキーが設定されていることが確認できます。

```json
"FinalFields": {
  "Account": "rakMd7KDSpnVjgbtfTsCtTu4h7gqJ42DZL",
  "Balance": "999999988",
  "Flags": 65536,
  "OwnerCount": 0,
  "RegularKey": "rncAosMLDnD2QwMnPxPLqs3ihzPRzSWY3t",
  "Sequence": 36491881
},
```

### レギュラーキーでのトランザクション署名

レギュラーキーを設定したアカウントは、レギュラーキーを使用してトランザクションを署名することができます。

トランザクション送信者の`rakMd7KDSpnVjgbtfTsCtTu4h7gqJ42DZL`のマスターキーは`sEdTMf58AqhPoKxQ3PK6RBzfN6HYztC`ですが、次のコードではレギュラーキとして設定した`rncAosMLDnD2QwMnPxPLqs3ihzPRzSWY3t`のマスターキー`sEdV5mUW2vi9wbFeNvJtBcCmZ23bmu3`で署名を行っています。

```js
const { Client, Wallet } = require('xrpl');

const client = new Client('wss://testnet.xrpl-labs.com');
// レギュラーキーとしたアカウントのシード
const wallet = Wallet.fromSeed('sEdV5mUW2vi9wbFeNvJtBcCmZ23bmu3');

const main = async () => {
  await client.connect();

  const response = await client.submitAndWait(
    {
      TransactionType: 'Payment',
      Account: 'rakMd7KDSpnVjgbtfTsCtTu4h7gqJ42DZL',
      Destination: 'rQQQrUdN1cLdNmxH4dHfKgmX5P4kf3ZrM',
      Amount: '1000000',
    },
    { wallet }
  );
  console.log(response.result.hash);
  //　02063FA297301B67051FF1BC798BA693D7D45A6519FE6A9BDEB89C9068078B03
};

main();
```

https://stackblitz.com/edit/xrpl-regularkey?file=signTransaction.js

以下がトランザクションの実行結果です。
https://test.bithomp.com/explorer/02063FA297301B67051FF1BC798BA693D7D45A6519FE6A9BDEB89C9068078B03

## マルチシグを利用したアカウントリカバリー

### マルチシグとは

マルチシグとは、複数の署名者がトランザクションへ署名することで、トランザクションを承認する仕組みです。

マスターキーを紛失した場合でも、マルチシグに設定されたアドレスによりトランザクションを作成することでアカウントの管理を継続することができます。

XRP Ledgerではマルチシグのアカウントとして最大32のアドレスを設定することができます。署名に必要な定足数も1~32の範囲で設定することができます。

マルチシグを利用することで以下のようなユースケースが考えられます。

- 1 of 1 でレギュラーキーのような利用方法
- 1 of 3 でアカウントの共同管理
- 3 of 3 でアカウントの厳重な管理

https://xrpl.org/ja/multi-signing.html

### マルチシグの設定

今回は2 of 3のマルチシグを設定します。

まずはマルチシグの署名者とするアカウントを3つ作成しましょう。

```js
const { Wallet } = require('xrpl');

console.log(Wallet.generate());
console.log(Wallet.generate());
console.log(Wallet.generate());
```

```sh
Wallet {
  publicKey: 'ED4A6DC6A7D851C0A92B6349B82C7E7B30AFE02E94B4ECE6AF7615F4A1FDCC2469',
  privateKey: 'ED5B1E73ACFAC6D96286A7BC62951D361D81A0DF8B20137B1A9F020DA37E399EFC',
  classicAddress: 'rBg6tv4fRd8mKKvXQoMg4RpDN8JEQU2GL1',
  seed: 'sEd7yF5VcCsv2FDPgunskUuuKvdb8sg'
}
Wallet {
  publicKey: 'EDEB54971089A74CA51426F1376E33E2F772AD006031F2EB1457EF663DE9AF833A',
  privateKey: 'ED02A945B4C7C2A1CCCA42DA702ED075DC283F029F76C6DE7DED8FB9CF0A2234F3',
  classicAddress: 'rBUjxjCmCwKKyP2gJivhgoBtLksRZ4xGQm',
  seed: 'sEd7cx7AaJA1nHrUC1uAHQB9U6cxzFz'
}
Wallet {
  publicKey: 'ED994F8848463CEC8A35B060C74E7CEE1C5CFBD753EDCE453E785BC84DD160564B',
  privateKey: 'ED2F72CE440A0CFEEA1727EB02444EDA2238E5BE07A07C716F494F4E8D59C3389F',
  classicAddress: 'rDtQwpLzo1CBkCzBaey2Kt6Mcyy6a9ULKj',
  seed: 'sEd7KbkRFTuNj2DYao5Wx8LnhVdEawn'
}
```

https://stackblitz.com/edit/node-lsniff?file=generate-wallet.js

その後自身のアカウントにマルチシグを設定します。

```js
const { Client, Wallet } = require('xrpl');

const client = new Client('wss://testnet.xrpl-labs.com');
const wallet = Wallet.fromSeed('sEdStwpYpMAhfC4g5qjA85pxceRyra7');

const main = async () => {
  await client.connect();

  const response = await client.submitAndWait(
    {
      TransactionType: 'SignerListSet',
      Account: 'rnf4XWcJdALZVg3bUyHGikzfYXfUvUg5vH',
      SignerQuorum: 2,
      SignerEntries: [
        {
          SignerEntry: {
            Account: 'rBg6tv4fRd8mKKvXQoMg4RpDN8JEQU2GL1',
            SignerWeight: 1,
          },
        },
        {
          SignerEntry: {
            Account: 'rBUjxjCmCwKKyP2gJivhgoBtLksRZ4xGQm',
            SignerWeight: 1,
          },
        },
        {
          SignerEntry: {
            Account: 'rDtQwpLzo1CBkCzBaey2Kt6Mcyy6a9ULKj',
            SignerWeight: 1,
          },
        },
      ],
    },
    { wallet }
  );

  console.log(response.result.hash);
  // 1A0A86F78A1FBA91624714CB65BF99954D39E3EDEC38CCED6D088DD77F32D0F9
};

main();
```

以下がトランザクションの実行結果です。
https://test.bithomp.com/explorer/1A0A86F78A1FBA91624714CB65BF99954D39E3EDEC38CCED6D088DD77F32D0F9

https://xrpl.org/ja/signerlistset.html#signerlistset

### マルチシグでのトランザクション署名

トランザクション送信者の`rnf4XWcJdALZVg3bUyHGikzfYXfUvUg5vH`のマスターキーは`sEdStwpYpMAhfC4g5qjA85pxceRyra7`ですが、次のコードではマルチシグの署名者としてとして設定した`rBg6tv4fRd8mKKvXQoMg4RpDN8JEQU2GL1`のマスターキー`sEd7yF5VcCsv2FDPgunskUuuKvdb8sg`および、`rBUjxjCmCwKKyP2gJivhgoBtLksRZ4xGQm`のマスターキー`sEd7cx7AaJA1nHrUC1uAHQB9U6cxzFz`の２つで署名を行っています。

```js
const { Client, Wallet, multisign } = require('xrpl');
const { decode } = require('ripple-binary-codec');

const client = new Client('wss://testnet.xrpl-labs.com');

// rBg6tv4fRd8mKKvXQoMg4RpDN8JEQU2GL1
const wallet1 = Wallet.fromSeed('sEd7yF5VcCsv2FDPgunskUuuKvdb8sg');

// rBUjxjCmCwKKyP2gJivhgoBtLksRZ4xGQm
const wallet2 = Wallet.fromSeed('sEd7cx7AaJA1nHrUC1uAHQB9U6cxzFz');

const main = async () => {
  await client.connect();

  const accountResponse = await client.request({
    command: 'account_info',
    account: 'rnf4XWcJdALZVg3bUyHGikzfYXfUvUg5vH',
  });
  const Sequence = accountResponse.result.account_data.Sequence;

  const tx = {
    TransactionType: 'Payment',
    Account: 'rnf4XWcJdALZVg3bUyHGikzfYXfUvUg5vH',
    Destination: 'rQQQrUdN1cLdNmxH4dHfKgmX5P4kf3ZrM',
    Amount: '1000000',
    Sequence,
    Fee: '50',
  };
  // 署名者の１つで署名
  const tx_blob_1 = wallet1.sign(tx, true).tx_blob;
  // 署名者の１つで署名
  const tx_blob_2 = wallet2.sign(tx, true).tx_blob;
  // 署名の結合
  const tx_blob = multisign([tx_blob_1, tx_blob_2]);
  console.log(JSON.stringify(decode(tx_blob), null, '  '));

  await client.request({
    command: 'submit',
    tx_blob,
  });
};

main();
```

以下は署名結合後のトランザクションデータです。Sigersフィールドに署名者のアカウントアドレスと公開鍵、そして署名が含まれています。

```json
{
  "TransactionType": "Payment",
  "Sequence": 36493102,
  "Amount": "1000000",
  "Fee": "50",
  "SigningPubKey": "",
  "Account": "rnf4XWcJdALZVg3bUyHGikzfYXfUvUg5vH",
  "Destination": "rQQQrUdN1cLdNmxH4dHfKgmX5P4kf3ZrM",
  "Signers": [
    {
      "Signer": {
        "SigningPubKey": "EDEB54971089A74CA51426F1376E33E2F772AD006031F2EB1457EF663DE9AF833A",
        "TxnSignature": "C149F41A1F092FF42A5BF8F45AFFC2E80B2DB212E3E0EDB059F746D6C053EBCE0B82A543140B642505F86815DFB4791EC4D1A7BA92D239CD10CDCD3DF21A8F07",
        "Account": "rBUjxjCmCwKKyP2gJivhgoBtLksRZ4xGQm"
      }
    },
    {
      "Signer": {
        "SigningPubKey": "ED4A6DC6A7D851C0A92B6349B82C7E7B30AFE02E94B4ECE6AF7615F4A1FDCC2469",
        "TxnSignature": "6EF4177D41D7A9F28DD8E87733E3CC9F67CA891838FE8DA33B39CB1BBF2C3226AE0860C8E5F0A1EEFB3EBFBB1C1F1EC3A199F2A6C9336FCA8EA6E51F95DA0B0D",
        "Account": "rBg6tv4fRd8mKKvXQoMg4RpDN8JEQU2GL1"
      }
    }
  ]
}
```

以下がトランザクションの実行結果です

https://test.bithomp.com/explorer/53E175D117192FF40B134C3E1282FF8FDE3B2DC008082395D0D0B887DC4F4929

`rnf4XWcJdALZVg3bUyHGikzfYXfUvUg5vH`のマスターキーがなくとも、`rBg6tv4fRd8mKKvXQoMg4RpDN8JEQU2GL1`と`rBUjxjCmCwKKyP2gJivhgoBtLksRZ4xGQm`の２つの署名者によってでトランザクションを実行することができました。

## まとめ

レギュラーキーやマルチシグの仕組みはEthereumのAccount Abstractionで実現可能と言われていますが、XRP Ledgerではすでにネイティブに実装されています。
資産を安全に管理するための機能がスマートコントラクトなしに利用できることはXRP Ledgerの強みの一つと言えるでしょう。

XRP Ledgerに興味がある方は開発者Discordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


秘密鍵紛失時のアカウントリカバリー【XRP Ledger】

## はじめに

XRP Ledgerは、分散型台帳技術を採用したブロックチェーンの1つです。XRP Ledgerは3人の開発者によって開発され、現在もXRPL財団やRipple社、XRPL Labsなどを始めとしたXRPLコミュニティによって開発が続けられています。本記事ではノード(rippledサーバ)の更新方法について解説します。

https://xrpl.org/ja/update-rippled-manually-on-ubuntu.html

ノードのインストール方法については以下の記事をご覧ください。

https://qiita.com/tequ/items/2cde7d347e96280d49ae

今回はUbuntu 22.04の環境にインストールしたrippledをアップデートします。

## 直近のアップデート

### 1.10.0(2023-03-14)

NFTを初めとしたいくつかの機能の修正、およびいくつかのトランザクションの着信を無効化するための機能の追加を含んでいます。

https://github.com/XRPLF/rippled/releases/tag/1.10.0

https://zenn.dev/tequ/articles/rippled-1-10-0

### 1.10.1(2023-03-23)

非常に軽微な修正のみです。

https://twitter.com/alloynetworks/status/1638608818308546560

https://github.com/XRPLF/rippled/releases/tag/1.10.1

## 手動での更新

- リポジトリを更新
`sudo apt -y update`

<details><summary>実行結果</summary><div>

<pre><code>
...
Hit:12 https://repos.ripple.com/repos/rippled-deb jammy InRelease
Fetched 2,458 kB in 1s (3,037 kB/s)
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
27 packages can be upgraded. Run 'apt list --upgradable' to see them.
</code></pre>
</div></details>

<br/>

- rippledパッケージのアップグレード
`apt -y upgrade rippled`

<details><summary>実行結果</summary><div>

<pre><code>
...
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Calculating upgrade... Done
The following packages have been kept back:
  apparmor grub-efi-amd64 grub-efi-amd64-bin libapparmor1
The following packages will be upgraded:
  base-files fwupd-signed isc-dhcp-client isc-dhcp-common libmbim-glib4 libmbim-proxy libmm-glib0
  libqmi-glib5 libqmi-proxy libsasl2-2 libsasl2-modules libsasl2-modules-db motd-news-config
  python-apt-common python3-apt python3-distupgrade python3-software-properties rippled
  software-properties-common systemd-hwe-hwdb tcpdump ubuntu-advantage-tools ubuntu-release-upgrader-core
23 upgraded, 0 newly installed, 0 to remove and 4 not upgraded.
Need to get 20.1 MB of archives.
After this operation, 10.3 MB of additional disk space will be used.
...
Get:23 https://repos.ripple.com/repos/rippled-deb jammy/stable amd64 rippled amd64 1.10.0-1 [17.3 MB]
Fetched 20.1 MB in 4s (5,707 kB/s)
Preconfiguring packages ...
...
Preparing to unpack .../20-rippled_1.10.0-1_amd64.deb ...
Unpacking rippled (1.10.0-1) over (1.9.4-1) ...
...
Setting up rippled (1.10.0-1) ...

Configuration file '/opt/ripple/etc/rippled.cfg'
...
</code></pre>
</div></details>

<br/>

- systemdユニットファイルを再度読み込む
`sudo systemctl daemon-reload`

- rippledサービスの再起動
`sudo service rippled restart`

`rippled server_info`

<details><summary>実行結果</summary><div>

再起動直後は台帳の読み込みが完了していないため、ネットワークと同期を待つ必要があります。
<pre><code>
Loading: "/etc/opt/ripple/rippled.cfg"
2023-Mar-15 07:41:08.944778846 UTC HTTPClient:NFO Connecting to 127.0.0.1:5005

{
   "result" : {
      "info" : {
         "build_version" : "1.10.0",
         "closed_ledger" : {
            "age" : 8,
            "base_fee_xrp" : 1e-05,
            "hash" : "7D7793B8F9CB99CDCBDFD5056FDFD2DA217E9CE72B333C1EBE84AD465E1CD413",
            "reserve_base_xrp" : 200,
            "reserve_inc_xrp" : 50,
            "seq" : 2
         },
         "complete_ledgers" : "empty",
         "hostid" : "**********",
         "io_latency_ms" : 1,
         "jq_trans_overflow" : "0",
         "last_close" : {
            "converge_time_s" : 0,
            "proposers" : 0
         },
         "load" : {
            "job_types" : [
               {
                  "in_progress" : 1,
                  "job_type" : "clientRPC"
               },
               {
                  "job_type" : "untrustedValidation",
                  "per_second" : 21
               },
               {
                  "avg_time" : 7,
                  "job_type" : "manifest",
                  "peak_time" : 40,
                  "per_second" : 1
               },
               {
                  "job_type" : "untrustedProposal",
                  "per_second" : 10
               },
               {
                  "job_type" : "peerCommand",
                  "per_second" : 376
               }
            ],
            "threads" : 10
         },
         "load_factor" : 1,
         "network_ledger" : "waiting",
         "node_size" : "huge",
         "peer_disconnects" : "0",
         "peer_disconnects_resources" : "0",
         "peers" : 12,
         "pubkey_node" : "n9**********",
         "pubkey_validator" : "none",
         "published_ledger" : "none",
         "server_state" : "connected",
         "server_state_duration_us" : "3787281",
         "state_accounting" : {
            "connected" : {
               "duration_us" : "4787715",
               "transitions" : "2"
            },
            "disconnected" : {
               "duration_us" : "1137687",
               "transitions" : "2"
            },
            "full" : {
               "duration_us" : "0",
               "transitions" : "0"
            },
            "syncing" : {
               "duration_us" : "0",
               "transitions" : "0"
            },
            "tracking" : {
               "duration_us" : "0",
               "transitions" : "0"
            }
         },
         "time" : "2023-Mar-15 07:41:08.945283 UTC",
         "uptime" : 5,
         "validation_quorum" : 4294967295,
         "validator_list" : {
            "count" : 2,
            "expiration" : "2023-Jul-24 00:00:00.000000000 UTC",
            "status" : "active"
         }
      },
      "status" : "success"
   }
}
</code></pre>
</div></details>
<br/>

## スクリプトからの更新

`/opt/ripple/bin/update-rippled.sh`スクリプトを利用することで、上記の手順を一度に実行することが出来ます。このスクリプトはsudoユーザとして実行する必要があります。

`sudo /opt/ripple/bin/update-rippled.sh`

## まとめ

本記事では、XRP Ledgerのrippledサーバーの更新方法について解説しました。XRP Ledgerはrippledによって構成されており、このrippledサーバーはXRP Ledgerのネットワークに参加するための重要な役割を担っています。そのため、rippledサーバーの更新は必須の作業となります。本記事で紹介した手順を参考に、rippledサーバーの更新を行ってみてください。

XRP Ledgerに興味がある方は開発者Discordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


【2023年版】XRP Ledgerのノードの更新

## はじめに

XRP Ledgerは、分散型台帳技術を採用したブロックチェーンの1つです。XRP Ledgerは3人の開発者によって開発され、現在もXRPL財団やRipple社、XRPL Labsなどを始めとしたXRPLコミュニティによって開発が続けられています。この記事では、XRP Ledgerのrippledサーバーを構築する方法について解説します。rippledサーバーを構築することで、トランザクションを自身の管理するサーバからネットワークへ提出することができます。

https://xrpl.org/ja/install-rippled-on-ubuntu.html

rippledはウォレットノード(ストックノード)としてもバリデータノードとしても利用可能です。

今回はUbuntu 22.04の環境にrippledをインストールします。

## システム要件

本番環境では推奨要件が推奨されますが、テスト目的などでは最小要件で十分です(ただしネットワークが常時同期するとは限りません)。

### 推奨要件

OS: Ubuntu (LTF) 、CentOS または RedHat Enterprise Linux (最新版)
CPU: 8コア以上でハイパースレッディングが有効なIntel Xeon 3GHz以上のプロセッサ
ディスク: SSD / NVMe（10,000 IOPS以上）
RAM: 64GB
ネットワーク: ホスト上にギガビットネットワークインターフェイスを備える企業データセンターネットワーク

### 最小要件

OS: Mac OS X、Windows（64ビット）、またはほとんどのLinuxディストリビューション(Red Hat、 Ubuntu、 Debianをサポート)
CPU: 4コア以上の64ビット x86_64、
ディスク: データベースパーティション用に最低50GB。SSDを強く推奨（最低1000IOPS）
RAM: 16GB以上

## 必要なユーティリティのインストール

rippledを実行するためには、いくつかのユーティリティが必要です。

- リポジトリの取得

`sudo apt -y update`

<details><summary>実行結果</summary><div>

<pre><code>
...
Fetched 57.1 MB in 4s (13.6 MB/s)
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
36 packages can be upgraded. Run 'apt list --upgradable' to see them.
</code></pre>
</div></details>

<br/>

- インストール
`sudo apt -y install apt-transport-https ca-certificates wget gnupg`

<details><summary>実行結果</summary><div>

<pre><code>
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
wget is already the newest version (1.21.2-2ubuntu1).
ca-certificates is already the newest version (20211016ubuntu0.22.04.1).
ca-certificates set to manually installed.
gnupg is already the newest version (2.2.27-3ubuntu2.1).
The following NEW packages will be installed:
  apt-transport-https
0 upgraded, 1 newly installed, 0 to remove and 36 not upgraded.
Need to get 1,506 B of archives.
After this operation, 169 kB of additional disk space will be used.
Get:1 http://mirror.hetzner.com/ubuntu/packages jammy-updates/universe amd64 apt-transport-https all 2.4.8 [1,506 B]
Fetched 1,506 B in 0s (21.5 kB/s)
debconf: unable to initialize frontend: Dialog
debconf: (Dialog frontend requires a screen at least 13 lines tall and 31 columns wide.)
debconf: falling back to frontend: Readline
Selecting previously unselected package apt-transport-https.
(Reading database ... 43550 files and directories currently installed.)
Preparing to unpack .../apt-transport-https_2.4.8_all.deb ...
Unpacking apt-transport-https (2.4.8) ...
Setting up apt-transport-https (2.4.8) ...
debconf: unable to initialize frontend: Dialog
debconf: (Dialog frontend requires a screen at least 13 lines tall and 31 columns wide.)
debconf: falling back to frontend: Readline
Scanning processes...
Scanning processor microcode...
Scanning linux images...

Running kernel seems to be up-to-date.

The processor microcode seems to be up-to-date.

No services need to be restarted.

No containers need to be restarted.

No user sessions are running outdated binaries.

No VM guests are running outdated hypervisor (qemu) binaries on this host.
</code></pre>
</div></details>

## rippledのダウンロードとインストール

rippledのダウンロードとインストールが完了すると、rippledサーバーを起動することができます。

- パッケージ署名用のGPGキーを、信頼できるキーのリストに追加します。

```bash
sudo mkdir /usr/local/share/keyrings/
wget -q -O - "https://repos.ripple.com/repos/api/gpg/key/public" | gpg --dearmor > ripple-key.gpg
sudo mv ripple-key.gpg /usr/local/share/keyrings
```

- 追加したキーのフィンガープリントを確認します。

`gpg /usr/local/share/keyrings/ripple-key.gpg`

<details><summary>実行結果</summary><div>

<pre><code>
gpg: directory '/root/.gnupg' created
gpg: keybox '/root/.gnupg/pubring.kbx' created
gpg: WARNING: no command supplied.  Trying to guess what you mean ...
pub   rsa3072 2019-02-14 [SC] [expires: 2026-02-17]
      C0010EC205B35A3310DC90DE395F97FFCCAFD9A2
uid           TechOps Team at Ripple <techops+rippled@ripple.com>
sub   rsa3072 2019-02-14 [E] [expires: 2026-02-17]
</code></pre>
</div></details>

```bash
echo "deb [signed-by=/usr/local/share/keyrings/ripple-key.gpg] https://repos.ripple.com/repos/rippled-deb jammy stable" | \
    sudo tee -a /etc/apt/sources.list.d/ripple.list
deb [signed-by=/usr/local/share/keyrings/ripple-key.gpg] https://repos.ripple.com/repos/rippled-deb jammy stable
```

Ubuntu 20.04以外の場合は、Ubuntuのバージョンに応じてjammyの箇所を変更してください。

- 登録したリポジトリを取得します。

`sudo apt -y update`

<details><summary>実行結果</summary><div>

<pre><code>
...
Get:9 https://repos.ripple.com/repos/rippled-deb jammy InRelease [15.7 kB]
Get:10 https://repos.ripple.com/repos/rippled-deb jammy/stable amd64 Packages [3,112 B]
Fetched 18.8 kB in 1s (17.1 kB/s)
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
36 packages can be upgraded. Run 'apt list --upgradable' to see them.
</code></pre>
</div></details>

<br/>

- rippledソフトウェアパッケージをインストールします。

`sudo apt -y install rippled`

<details><summary>実行結果</summary><div>

<pre><code>
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following NEW packages will be installed:
  rippled
0 upgraded, 1 newly installed, 0 to remove and 36 not upgraded.
Need to get 14.8 MB of archives.
After this operation, 60.7 MB of additional disk space will be used.
Get:1 https://repos.ripple.com/repos/rippled-deb jammy/stable amd64 rippled amd64 1.9.4-1 [14.8 MB]
Fetched 14.8 MB in 4s (4,221 kB/s)
Selecting previously unselected package rippled.
(Reading database ... 43554 files and directories currently installed.)
Preparing to unpack .../rippled_1.9.4-1_amd64.deb ...
Unpacking rippled (1.9.4-1) ...
Setting up rippled (1.9.4-1) ...
Created symlink /etc/systemd/system/multi-user.target.wants/rippled.service → /lib/systemd/system/rippled.service.
Scanning processes...
Scanning processor microcode...
Scanning linux images...

Running kernel seems to be up-to-date.

The processor microcode seems to be up-to-date.

No services need to be restarted.

No containers need to be restarted.

No user sessions are running outdated binaries.

No VM guests are running outdated hypervisor (qemu) binaries on this host.
</code></pre>
</div></details>

## rippledの起動方法

rippledを起動する方法について解説します。具体的には、コマンドラインからrippledを起動する方法と、バックグラウンドでrippledを実行する方法を取り上げます。また、起動時のエラーについても解説し、解決方法を提示します。この章を読むことで、rippledサーバーの起動方法が理解できる

- rippledサービスを開始します

`systemctl start rippled.service`

<details><summary>実行結果</summary><div>

<pre><code>
● rippled.service - Ripple Daemon
     Loaded: loaded (/lib/systemd/system/rippled.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2023-03-07 09:02:53 CET; 4min 20s ago
   Main PID: 3421 (rippled)
      Tasks: 24 (limit: 76929)
     Memory: 6.9G
        CPU: 9min 46.787s
     CGroup: /system.slice/rippled.service
             └─3421 /opt/ripple/bin/rippled --net --silent --conf /etc/opt/ripple/rippled.cfg

Mar 07 09:02:53 Ubuntu-2204-jammy-amd64-base systemd[1]: Started Ripple Daemon.
Mar 07 09:02:53 Ubuntu-2204-jammy-amd64-base rippled[3421]: 2023-Mar-07 08:02:53.973548763 UTC JobQueue:NFO Using 6  threads
Mar 07 09:02:54 Ubuntu-2204-jammy-amd64-base rippled[3421]: 2023-Mar-07 08:02:54.181398505 UTC LedgerConsensus:NFO Consensus engine started (cookie: 16473183795197887710)
Mar 07 09:02:54 Ubuntu-2204-jammy-amd64-base rippled[3421]: 2023-Mar-07 08:02:54.181509404 UTC Application:NFO process starting: rippled-1.9.4
</code></pre>
</div></details>

<br/>

- サービスの自動起動を有効化します

`systemctl enable rippled.service`

## ログの確認

rippledのログはデフォルトでは`/var/log/rippled/debug.log`に格納されています。ログファイルのパスを変更していない場合は、以下のコマンドでログの追跡をすることができます。

`tail /var/log/rippled/debug.log -f`

## コマンドを送信する

rippledからコマンドを実行できます。公開APIに加え、管理者用のAPIも利用可能です。

以下のコマンドでサーバの状況を取得することができます。

`rippled server_info`

`server_state`が`full`でない場合、ネットワークに同期できていません。rippledの起動後、同期が完了するまで15分程度時間がかかる場合があります。

<details><summary>実行結果</summary><div>

<pre><code>
{
   "result" : {
      "info" : {
         "build_version" : "1.9.4",
         "complete_ledgers" : "78364176-78364704",
         "hostid" : "Ubuntu-2204-jammy-amd64-base",
         "initial_sync_duration_us" : "101250319",
         "io_latency_ms" : 1,
         "jq_trans_overflow" : "0",
         "last_close" : {
            "converge_time_s" : 2,
            "proposers" : 34
         },
         "load" : {
            "job_types" : [
               {
                  "job_type" : "clientFeeChange",
                  "per_second" : 13
               },
               {
                  "in_progress" : 1,
                  "job_type" : "clientRPC"
               },
               {
                  "job_type" : "untrustedValidation",
                  "per_second" : 24
               },
               {
                  "job_type" : "transaction",
                  "per_second" : 13
               },
               {
                  "job_type" : "batch",
                  "per_second" : 13
               },
               {
                  "avg_time" : 2,
                  "job_type" : "ledgerData",
                  "peak_time" : 43,
                  "per_second" : 4
               },
               {
                  "job_type" : "advanceLedger",
                  "peak_time" : 15,
                  "per_second" : 4
               },
               {
                  "job_type" : "fetchTxnData",
                  "per_second" : 5
               },
               {
                  "job_type" : "trustedValidation",
                  "per_second" : 5
               },
               {
                  "in_progress" : 1,
                  "job_type" : "acceptLedger"
               },
               {
                  "job_type" : "trustedProposal",
                  "per_second" : 16
               },
               {
                  "job_type" : "heartbeat",
                  "peak_time" : 1
               },
               {
                  "job_type" : "peerCommand",
                  "per_second" : 1267
               },
               {
                  "job_type" : "processTransaction",
                  "per_second" : 13
               },
               {
                  "job_type" : "SyncReadNode",
                  "peak_time" : 24,
                  "per_second" : 62083
               },
               {
                  "job_type" : "AsyncReadNode",
                  "peak_time" : 5,
                  "per_second" : 2406
               },
               {
                  "job_type" : "WriteNode",
                  "peak_time" : 24,
                  "per_second" : 52396
               }
            ],
            "threads" : 10
         },
         "load_factor" : 1,
         "node_size" : "huge",
         "peer_disconnects" : "6",
         "peer_disconnects_resources" : "0",
         "peers" : 21,
         "pubkey_node" : "n9**************************************************",
         "pubkey_validator" : "none",
         "server_state" : "full",
         "server_state_duration_us" : "275497631785",
         "state_accounting" : {
            "connected" : {
               "duration_us" : "97150356",
               "transitions" : "2"
            },
            "disconnected" : {
               "duration_us" : "1049031",
               "transitions" : "2"
            },
            "full" : {
               "duration_us" : "275497631785",
               "transitions" : "1"
            },
            "syncing" : {
               "duration_us" : "3050930",
               "transitions" : "1"
            },
            "tracking" : {
               "duration_us" : "0",
               "transitions" : "1"
            }
         },
         "time" : "2023-Mar-12 10:55:41.675855 UTC",
         "uptime" : 275598,
         "validated_ledger" : {
            "age" : 4,
            "base_fee_xrp" : 1e-05,
            "hash" : "52600391AF367CA4790A1B210D229D2BBA3A953AD356A581F272A69E0EB892BD",
            "reserve_base_xrp" : 10,
            "reserve_inc_xrp" : 2,
            "seq" : 78364704
         },
         "validation_quorum" : 28,
         "validator_list" : {
            "count" : 2,
            "expiration" : "2023-Jul-24 00:00:00.000000000 UTC",
            "status" : "active"
         }
      },
      "status" : "success"
   }
}
</code></pre>
</div></details>

## rippledの設定

rippledの設定には、rippled.cfgという設定ファイルを使用します。インストール時には`/etc/opt/ripple/rippled.cfg`へデフォルトの設定ファイルが作成されています。

- 外部からサーバのパブリックAPIへアクセスする

rippled.cfgファイル内のport_ws_publicを有効にする必要があります。
server項目の`port_ws_public`と、port_ws_public項目のコメントアウトを解除し、値を必要に応じて変更します。

``` text
[server]
port_rpc_admin_local
port_peer
port_ws_admin_local
port_ws_public
```

``` text
[port_ws_public]
port = 51233 # 任意のポート
ip = 0.0.0.0 # 接続を許可するIP
protocol = ws # SSL証明書を用意する場合はwssも利用可能
```

### rippledの再起動

設定の変更後はrippledの再起動が必要です。

`system rippled restart`

### クライアントライブラリからアクセスする

port_ws_publicを設定したことでクライアントライブラリ等からのアクセスが可能になります。

```ts
import { Client } from 'xrpl'

const client = new Client('ws://<サーバのIP>:<port_ws_publicに設定したポート>')

await client.connect()
const response = await client.request({
  command:'server_Info'
})
console.log(response.result)
```

## まとめ

本記事では、XRP Ledgerのrippledサーバーの構築方法について解説しました。rippledサーバーを構築することで、XRPのトランザクションを処理することができます。自身でサーバを運用することで、第三者を介することなくレジャーやトランザクションの情報を取得できたり、RateLimitに左右されずに情報を取得することができます。また、レジャー全体の情報を一括で取得できるようにもなり、レジャーデータの解析も行いやすくなります。

XRP Ledgerに興味がある方は開発者Discordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


【2023年版】XRP Ledgerのノードを構築してみる

XRP LedgerのDEX（分散型取引所）では、ユーザーが自分のデジタル資産をオファーとして提供することができます。オファーは、他のユーザがその資産を購入するために使用できます。

オファーには、取引金額、支払い通貨、受け取り通貨などの情報が含まれます。オファーは自由に設定でき、ユーザーは自分が望む価格でアセットを販売することができます。

オファーはXRP Ledger上で公開されており、個別のオファーだけでなくペアごとのオファーを一括で取得することも可能です。

今回はそのオファーデータを取得し、オーダーブック形式で表示する方法を解説します。

https://xrpl.org/decentralized-exchange.html

## 利用例

オーダーブック機能を利用し表示しているプロジェクトの1つとしてSologenicが挙げられます。
このプロジェクトはオーダーブックの表示だけではなく、チャートの表示、売買機能も搭載しています。

![image](https://user-images.githubusercontent.com/69445828/221449804-a8bc68c7-95ec-419a-915c-8abe9310efe0.png)

## 準備

今回はSavaScriptのクライアントライブラリであるxrpl.jsを利用します。

https://github.com/XRPLF/xrpl.js

https://www.npmjs.com/package/xrpl

https://js.xrpl.org/

JavaScript以外にもPythonなどの他の言語のライブラリも存在します。
チェックしてみてください。

https://xrpl.org/ja/client-libraries.html

オーダーブックを取得するには

- レジャーデータからオファーオブジェクトを直接取得する
- `book_offers`メソッドでask,bidのオーダーブックをそれぞれ取得する
- `subscribe`メソッドでask,bidのオーダーブックを一括取得する

など、いくつかの方法がありますが、今回は`subscribe`メソッドを使ってみたいと思います。

## subscribeメソッド

subscribeメソッドはXRPLで特定のイベントが発生した場合に、メッセージを通知するようにサーバーへ要求するコマンドです。

利用可能なイベントとして、レジャーの検証やトランザクション、アカウントのトランザクションなどが存在します。

ここではオーダーブックイベントを利用し、データを取得します。

https://xrpl.org/ja/subscribe.html#subscribe

## 注文情報を取得する

以下のコードでペアの注文情報を取得することができます。
ここではメインネットのXRP/USD.rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59Bペアを利用します。

```js
const client = new Client('wss://xrpl.ws');
await client.connect()
const response = await client.request({
  command: 'subscribe',
  books: [
    {
      taker_pays: { currency: 'XRP' },
      taker_gets: { issuer: 'rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B', currency: 'USD' },
      snapshot: true,
      both: true,
    },
  ],
});
console.log(response.result);
```

コード内の`snapshot`フィールドがtrueの場合、レスポンスにリクエスト時点での注文情報を含めるようになります。
`both`フィールドがtrueの場合、XRP→USDの注文情報だけでなくUSD→XRPと逆サイドの注文も含めるようになります。

このコードの実行結果は以下のようになります。

```js
{
  asks: {
    {
      Account: 'rBndiPPKs9k5rjBb7HsEiqXKrz8AfUnqWq',
      BookDirectory: 'DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4E0D6ACC35757000',
      BookNode: '0',
      Flags: 0,
      LedgerEntryType: 'Offer',
      OwnerNode: '0',
      PreviousTxnID: '7B88A6D13F0CEF15EF28649C3C7A3E6B987B23B36E1ED04AD8F13839B7F7C3ED',
      PreviousTxnLgrSeq: 78070216,
      Sequence: 2430764,
      TakerGets: '680762087',
      TakerPays: {
        currency: 'USD',
        issuer: 'rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B',
        value: '257.0966105653182'
      },
      index: '43FF075A07BCCE53091C436F3FB428BED2F17501769230397120DB8930BF7B1C',
      owner_funds: '3206390705',
      quality: '0.00000037766'
    },
    {
      Account: 'rPbMHxs7vy5t6e19tYfqG7XJ6Fog8EPZLk',
      BookDirectory: 'DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4E0D6F21B778F500',
      BookNode: '0',
      Flags: 0,
      LedgerEntryType: 'Offer',
      OwnerNode: '0',
      PreviousTxnID: 'B44C3E00D72405D87B1DFE6BF968E905653F0CAE04803BF78F462E4D80430732',
      PreviousTxnLgrSeq: 78072721,
      Sequence: 1070303,
      TakerGets: '2000000000',
      TakerPays: {
        currency: 'USD',
        issuer: 'rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B',
        value: '756.27306'
      },
      index: '27D4658890B561C40ED8820FE61338D5FC6727C39509EC1C24C57F5189D84B20',
      owner_funds: '5375920030',
      quality: '0.00000037813653'
    }
    ...
  },
  bids: {
    {
      Account: 'rsgi7ENscrVaXC44JE2m94XzKQrmAVX2gV',
      BookDirectory: '4627DFFCFF8B5A265EDBD8AE8C14A52325DBFEDAF4F5C32E5B096C6EFAA91865',
      BookNode: '0',
      Expiration: 762310783,
      Flags: 0,
      LedgerEntryType: 'Offer',
      OwnerNode: '0',
      PreviousTxnID: 'BF475896247E2FCABB8FEF3C440F2376E5B6A793B2AF0B14C6B7F18DB3D4AD6E',
      PreviousTxnLgrSeq: 78070492,
      Sequence: 72701643,
      TakerGets: {
        currency: 'USD',
        issuer: 'rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B',
        value: '20.41489722360511'
      },
      TakerPays: '54150487',
      index: 'EC40BD275BF22AA9C40F024EDF6A642ABD3D73A4AA8CD7313330C45C6C4DA6EA',
      owner_funds: '20.37571359826066',
      quality: '2652498.697984101',
      taker_gets_funded: {
        currency: 'USD',
        issuer: 'rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B',
        value: '20.37571359826066'
      },
      taker_pays_funded: '54046553'
    }
    {
      Account: 'rnW98SKRCuw7RM2HDWgNfZJ8qPVu1tUBaU',
      BookDirectory: '4627DFFCFF8B5A265EDBD8AE8C14A52325DBFEDAF4F5C32E5B096C6F97BACA6A',
      BookNode: '0',
      Expiration: 762310774,
      Flags: 0,
      LedgerEntryType: 'Offer',
      OwnerNode: '0',
      PreviousTxnID: '05DB68CCE660DF867A9A7380F8FCB39FD83129FBA095A9C2C1D6B3E6BE2CCCCD',
      PreviousTxnLgrSeq: 78069211,
      Sequence: 68708233,
      TakerGets: {
        currency: 'USD',
        issuer: 'rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B',
        value: '49.161144'
      },
      TakerPays: '130400000',
      index: '72D8A1605F35F422740B30C9FA823392DFCC3D77C3E5D4BFF9EB9730CB54A9EE',
      owner_funds: '49.122187',
      quality: '2652501.333166698',
      taker_gets_funded: {
        currency: 'USD',
        issuer: 'rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B',
        value: '49.122187'
      },
      taker_pays_funded: '130296666'
    },
    ...,
  }
}
```

## オーダーブックの作成

これらの注文情報からオーダーブックを作っていきましょう。
現在bidsとasksにはOfferオブジェクトが複数格納されています。

https://xrpl.org/offer.html#offer

このOfferオブジェクトから価格と注文量を取得します。
ここではXRP/USDのオーダーブックとし、価格は XRP/USD、注文量はXRP建てで表示することとします。

### 価格を揃える

asksとbidsのqualityにはXRP/USDとUSD/XRPの価格情報が設定されています。
またXRPはdropでの価格(1XRP=1,000,000)になっているため、XRPでの表示とします。

これらを揃えるために、asks内のquality: '0.00000037766'は、1000000を掛けることで0.37766となります。

また、bids内のquality: '2652498.697984101'は、1000000をかけることで0.37700となります。

javascriptでの少数計算での誤差をなくすために、**bignumber.js**を使います。

```js
import BigNumber from 'bignumber.js';

const asksPrice = response.result.asks.map((ask) => {
  return BigNumber(ask.quality).multipliedBy(1000000).toString()
})

const bidsPrice = response.result.bids.map((ask) => {
  return BigNumber(1).dividedBy(BigNumber(ask.quality)).multipliedBy(1000000).toString()
})

console.log(asksPrice)
console.log(bidsPrice)
```

実行結果は以下のようになります。

```js
[
  '0.37766',            '0.37831724',         '0.3790894153652532',
  '0.379669541',        '0.3796787613004684', '0.3819853403971212',
  '0.38566128506197',   '0.386',              '0.38818016915949',
  '0.3885826132620423', '0.39',               '0.3900294515983404',
  '0.3905376246907444', '0.3915',             '0.393',
  '0.3933',             '0.3954537361267731', '0.3954545353125844',
  '0.397212',           '0.4',                '0.4048582995951417',
  '0.4090191613927092', '0.41',               '0.41',
  '0.41',               '0.41',               '0.4109073602091388',
  '0.4118107317876703', '0.4155',             '0.4166',
  '0.4199999868148413', '0.420000001',        '0.420333943711323',
  '0.4223054992888399', '0.4275392890329845', '0.4299',
  '0.4309977911012938', '0.431',              '0.4333',
  '0.44',               '0.44',               '0.443',
  '0.4433',             '0.445',              '0.449',
  '0.45',               '0.45',               '0.45',
  '0.45',               '0.45',               '0.45',
  '0.4533',             '0.4533',             '0.455',
  '0.459',              '0.46',               '0.468',
  '0.4683995391705069', '0.48',               '0.48'
]
[
  '0.37700301257829', '0.37700263803681', '0.377',
  '0.37264198009708', '0.37254567512024', '0.369993133',
  '0.36999155268118', '0.36887390482392', '0.36600365988429',
  '0.366',            '0.365',            '0.365',
  '0.36496350364964', '0.3645',           '0.364',
  '0.36363636363636', '0.361',            '0.36',
  '0.36',             '0.36',             '0.355',
  '0.355',            '0.3533',           '0.35158933333333',
  '0.3515',           '0.351',            '0.35099999',
  '0.35000020162269', '0.35',             '0.35',
  '0.35',             '0.35',             '0.347212',
  '0.347',            '0.342',            '0.342',
  '0.342',            '0.34',             '0.337',
  '0.337',            '0.336',            '0.33558933333333',
  '0.335',            '0.3336',           '0.33155',
  '0.3311',           '0.331',            '0.33',
  '0.33',             '0.3259',           '0.32199702534729',
  '0.32',             '0.31858928571429', '0.316',
  '0.316',            '0.31501000000283', '0.315',
  '0.3134',           '0.31310001',       '0.313'
]
```

## 注文量の取得

こちらは価格とは異なり、オファー内の情報を取得し、XRP量へ変換するだけになります。

```js
const asksAmount = response.result.asks.map((ask) => {
  return BigNumber(ask.TakerGets).dividedBy(1000000).toString()
})

const bidsAmount = response.result.bids.map((ask) => {
  return BigNumber(ask.TakerPays).dividedBy(1000000).toString()
})

console.log(asksAmount)
console.log(bidsAmount)
```

```js
[
  '680.762087', '2000',        '38000',       '4659.393721',
  '12.223249',  '5980.570901', '3.92448',     '5',
  '300',        '5.23675',     '20',          '2.79102',
  '2.65557',    '500',         '5',           '600',
  '4.71772',    '4.48183',     '7500',        '7729',
  '247',        '4.68181',     '1489.645582', '1007',
  '10',         '4000',        '2.89951',     '53.290236',
  '690.206805', '10000',       '1736.801245', '100',
  '6.82091',    '4.77389',     '7.37165',     '233',
  '7.9225',     '10000',       '1000',        '2000',
  '10',         '3000',        '1000',        '650',
  '3000',       '5000',        '500',         '500',
  '2500',       '5000',        '0.1',         '1000',
  '233',        '116',         '1000',        '4470.444247',
  '1000',       '217',         '1000',        '391'
]
[
  '54.150487',    '130.4',        '13655.346237', '1303.871344',
  '200000',       '6000',         '0.000002',     '2975.028395',
  '1202.834003',  '9219.166772',  '200',          '5',
  '19.2074',      '6900',         '414.622995',   '58.575',
  '1500',         '390',          '55813.635195', '100000',
  '10.5',         '623.591549',   '56.33',        '7500',
  '1898',         '2000',         '3647',         '1.708102',
  '10076.240904', '0.01',         '5',            '657771.42',
  '7500',         '43',           '900',          '500',
  '2550',         '48369.695428', '400',          '200',
  '297.6193',     '7500',         '10.5',         '225',
  '6600',         '100',          '1',            '0.01',
  '449',          '10',           '228.160191',   '12.735193',
  '5600',         '2531.64',      '31.6456',      '4457.001365',
  '440',          '2000',         '50000',        '100'
]
```

### オーダーブックの表示

価格情報と注文量情報を合わせてオーダーブック情報を表示しましょう。

表示する際、asksは最良レートは要素番号が小さい方から格納されているのでreverse()メソッドで要素を反転させます。

```js
const asks = response.result.asks.map((ask) => {
  return {
    price: BigNumber(ask.quality).multipliedBy(1000000).toString(),
    amount: BigNumber(ask.TakerGets).dividedBy(1000000).toString()
  }
})

const bids = response.result.bids.map((ask) => {
  return {
    price: BigNumber(1).dividedBy(BigNumber(ask.quality)).multipliedBy(1000000).toString(),
    amount: BigNumber(ask.TakerPays).dividedBy(1000000).toString()
  }
})

asks.reverse().forEach(ask => {

  console.log(((ask.amount + Array(25).join(' ')).slice(0, 24)) + (ask.price + Array(20).join(' ')).slice(0, 20))
})
console.log('===========================================================')
bids.forEach(bid => {
  console.log(Array(25).join(' ') + (bid.price + Array(20).join(' ')).slice(0, 20) + bid.amount)
})
```

```sh
...
20                      0.39
5.23675                 0.3885826132620423
300                     0.38818016915949
5                       0.386
3.92448                 0.38566128506197
4676.707211             0.3796489755481657
5985.802251             0.3794550839673051
38000                   0.379446704
12.223249               0.3790894153652532
1895.294448             0.3784276799981424
=====================================================
                        0.37700263803681    36.076796
                        0.377               13655.346237
                        0.372861987         200000
                        0.37285991744149    2975.028395
                        0.37273139          2000
                        0.37254567512024    0.000002
                        0.36713637817091    6000
                        0.36600365988429    1202.834003
                        0.366               9219.166772
                        0.365               200
...
```

### オーダーブックの更新

オーダーブックを取得後にも連続的にDEXに対するトランザクションは送信されます。subscribeメソッド実行後にtransaction streamを取得することで該当のオーダーブックに変更があった場合に変更に関わったトランザクションデータを取得することができます。

複雑な処理となるため、今回は省略します。

```js
client.on('transaction', message => {
  console.log(message)
})
```

## まとめ

第三者が提供しているDEX APIサービスでは、データの提供が突然止まったり不正なデータを提供される可能性がゼロではありません。
XRP LedgerではネイティブなDEX機能により、DEXの注文やオーダーブック情報をノードから直接取得することが可能です。

XRP Ledgerに興味がある方は開発者Discordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


XRPLのオーダーブックを使ってみよう

XRP Ledgerには **スパムなどの悪意ある行為から守り、低い手数料で利用するための仕組み** として準備金が存在します。
例えば誰も保有を望まない何万ものNFTが台帳へ存在することはノードへ不要な負担を強いることになりますが、NFTの保有に対して準備金を設定することで、所有者に対してNFTを **台帳から削除させるインセンティブ** を発生させます。

https://xrpl.org/ja/reserves.html

準備金は次の2種類存在し、準備金の量(XRP)はバリデータの投票により決定されます。

## 基本準備金(Base Reserve)

アカウントアドレスを使用するために必要な準備金です。アカウントがトランザクションを送信するためには少なくともこの準備金分のXRPを保有しておかなければなりません。
執筆時点では **10XRP** となっており、[アカウントの削除](https://xrpl.org/ja/accounts.html#%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%AE%E5%89%8A%E9%99%A4)でのみ基本準備金を取り戻すことができます。
基本準備金を取り戻す際に、その内の一部(2XRP)は償却されます。これはアカウントの作成→削除によるスパムを防ぐためです。

## 所有者準備金(Owner Reserve)

XRP Ledgerにはいくつかの種類のオブジェクトが存在し、アカウントがこのオブジェクトを保有/利用するために必要な準備金です。
オブジェクト毎に準備金が必要となり、執筆時点では1オブジェクトあたり **2XRP** です。

準備金が課されるオブジェクトは次のようなものが存在します。

- Check (小切手)
- Deposit Preauth (事前の入金承認)
- Escrow (エスクロー)
- NFT Offer (NFTの購入/売却オファー)
- NFT Page (NFTを格納するページ)
- Offer (取引オファー)
- Payment Channel (ペイメントチャネル)
- Signer List (マルチシグのアカウントリスト)
- Ticket (アカウントのシーケンス番号の確保)
- TrustLine (トークン保有(正式なオブジェクト名はRippleState))

オブジェクトそれぞれに対応するトランザクション(OfferCancelなど)を通じてオブジェクトを削除することで所有者準備金を取り戻すことができます。

### 特殊なケース

上記の所有者準備金の対象となるオブジェクトのうちTrustLineはXRP Ledgerにおいて特殊で強力な機能であるため、最初の2つのTrustLineオブジェクトには準備金を課さないようになっています。

厳密にはアカウントのオブジェクトの総数が2つ以下の場合、その内のTrustlineオブジェクトについては準備金が課されません。

例えば、

- 2つのTrustLineオブジェクトのみの場合、所有者準備金は0XRP
- OfferオブジェクトとTrustlineオブジェクトの2つのみの場合の所有者準備金は2XRP

となります。

アカウントのオブジェクト数が3以上となった場合は、準備金が課されていなかったTrustlineオブジェクトを含む全てのオブジェクトに対して準備金が課されるようになります。

## 手数料としての利用

アカウントの準備金はトランザクション手数料として使用することが可能です。
例えばアカウントがちょうど10XRPを保有しその全額が基本準備金である場合でも、トランザクション手数料としてのみXRPを使用するトランザクションは送信可能です。XRPを送信するPaymentトランザクションや、Offerの作成などの所有者準備金を増やすようなトランザクションは送信できません。

## 手数料投票

基本準備金と所有者準備金はそれぞれ固定された額ではなく、バリデータの投票により調整されます。
投票が有効化されるには **80%を超えるバリデータの賛成票** が必要となっています。

直近では2021年に基本準備金が20XRPから10XRPへ、所有者準備金が5XRPから2XRPへ調整されました。

現在の投票状況は次のサイトで確認できます。

https://xrpscan.com/validators

## まとめ

準備金はXRP Ledgerをスパムから守り、ノードが必要とする容量を抑え、長期的に健全に運用していくために必要な仕組みです。
これにより、トランザクション手数料としてXRPを多量に消費することなく、DEX取引やNFTの発行・取引などさまざまなトランザクションの実行を可能にします。

XRP Ledgerに興味がある方は開発者Discordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


XRP Ledgerの準備金

XRP Ledgerは強力な支払い機能を持つパブリックなブロックチェーンです。

支払い機能には次の種類のトランザクションが存在します。

#### Payment

XRPおよび発行トークンでの直接支払い、クロスカレンシー支払いなどを行います。

#### [Checks](https://xrpl.org/ja/checks.html)

XRPおよび発行トークンで非同期で支払い、転送を行います。支払人は任意の通貨(XRPや発行トークン)でCheckを発行でき、受取人は支払人が指定した通貨や、DEX流動性を利用して他の通貨に変換して受け取ることもできます。

#### [Escrow](https://xrpl.org/ja/escrow.html)

XRPを利用し、条件付き支払いを行います。終了時間ベースのエスクロー、暗号条件ベースでのエスクロー、この2つを組み合わせたエスクローの3つのケースが利用可能です。
発行トークンでEscrowを利用可能にする機能も開発中です。([XLS-34d](https://github.com/XRPLF/XRPL-Standards/discussions/88))

#### [Payment Channel](https://xrpl.org/ja/payment-channels.html)

少額の単位に分割可能な「非同期」のXRPペイメントを送信し、後日決済を行います。送金は個別に検証されるため、XRP Ledgerのトランザクション処理能力を超える速度での支払いが可能です。Payment Channelの終了時にXRP Ledgerにて一括清算を行います。
発行トークンでPayment Channelを利用可能にする機能も開発中です。([XLS-34d](https://github.com/XRPLF/XRPL-Standards/discussions/88))

## Payment トランザクション

今回はその支払い機能の中での根幹となるPaymentトランザクションに注目して説明します。

[Payment - XRPL.org (日本語)](https://xrpl.org/ja/payment.html)

PaymentトランザクションではXRP LedgerのネイティブトークンであるXRPだけではなく、ユーザが発行できる独自のトークン(発行トークン/IOUなどと呼ばれます)も利用することができます。

## Paymentトランザクションの例

```json
{
  "TransactionType" : "Payment",
  "Account" : "rs7FV1WHDutSL8o6iNy1e1quf7Daf8CNrk",
  "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
  "Amount" : {
     "currency" : "USD",
     "value" : "1",
     "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
  },
  "Fee": "12",
  "Flags": 2147483648,
  "Sequence": 2,
}
```

## 主なフィールド

| フィールド | 説明 |
| --- | --- |
| Amount | 送金先への送金通貨・送金額 |
| Destination | 送金先 |
| DestinationTag | 送金先を識別するためのタグ |
| Paths | 支払いが送金元から受取人に届くまでにたどる経路 |
| SendMax | 送金するために利用する送金元の最大の通貨・額 |
| DeliverMin | 送金先への最小の送金金額 |

## 主な機能

- XRP直接決済
  - 非常に一般的な決済方法
  - XRP-XRP
- クロスカレンシー決済
  - XRP-IOU(発行トークン)
  - IOU(発行トークン)-IOU(発行トークン)
    - DEXを利用した通貨の自動変換も可能
- 通貨変換
  - Account = Destination
  - いわゆるSwap

## 特殊なフィールド

### Amount

- Destinationが受け取る通貨・額を表します。

### SendMax

- Accountが送金する通貨・額を表します。
- 省略されている場合はAmountと同じ通貨・額となります。

### DeliverMin

- Partial Paymentが有効な場合にのみ使用可能です。
- Destinationが受け取る最小の金額を指定します。
- Destinationが受け取る金額は指定値に満たない場合はトランザクションはエラーとなります。

### Partial Payment (Flagsフィールドで指定)

- Destinationに送金する金額がAmountに指定した金額に満たない場合でも送金可能な額まで送金します。

## 種類ごとのトランザクション例

### XRP直接決済

- *XRP-XRP*

  AmountにXRPをdropの単位(1XRP=1000000drops)で指定します。

```json
  {
    "TransactionType" : "Payment",
    "Account" : "rs7FV1WHDutSL8o6iNy1e1quf7Daf8CNrk",
    "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
    "Amount" : "1000000", // 1XRP
    "Fee": "12",
    "Flags": 2147483648,
    "Sequence": 2,
  }
```

### クロスカレンシー決済

- **XRP-IOU(発行トークン)**

  1USDを送信するために最大10XRPを送金します。
  送金の過程でDEXを利用し、XRPをUSDに変換します。

  1USDを送信するために2XRPしか使用しなかった場合、残りの8XRPは送信元アカウントに返されます。

```json
    {
      "TransactionType" : "Payment",
      "Account" : "rs7FV1WHDutSL8o6iNy1e1quf7Daf8CNrk",
      "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
      "Amount" : {
        "currency" : "USD",
        "value" : "1",
        "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
      },
      "SendMax": "10000000", // 10XRP
      "Fee": "12",
      "Flags": 2147483648,
      "Sequence": 2,
    }
```

- **IOU（発行トークン）-IOU（発行トークン）**

  1USDを利用するために最大1EURを送金します。
  送金の過程でDEXを利用し、USDをEURに変換します。
  USD/EURの流動性が小さい場合、USD/XRPやEUR/XRPの流動性も使用します。

```json
    {
      "TransactionType" : "Payment",
      "Account" : "rs7FV1WHDutSL8o6iNy1e1quf7Daf8CNrk",
      "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
      "Amount" : {
        "currency" : "USD",
        "value" : "1",
        "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
      },
      "SendMax": {
        "currency" : "EUR",
        "value" : "1",
        "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
      },
      "Fee": "12",
      "Flags": 2147483648,
      "Sequence": 2,
    }
```

### 通貨変換

Destinationを自身のアカウントとすることで、自身が保有する通貨を別の通貨へ変換することができます。
このトランザクションも他と同様にDEXを利用して変換を行います。

```json
  {
    "TransactionType" : "Payment",
    "Account" : "rs7FV1WHDutSL8o6iNy1e1quf7Daf8CNrk",
    "Destination" : "rs7FV1WHDutSL8o6iNy1e1quf7Daf8CNrk",
    "Amount" : {
      "currency" : "USD",
      "value" : "1",
      "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
    },
    "SendMax": {
      "currency" : "EUR",
      "value" : "1",
      "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
    },
    "Fee": "12",
    "Flags": 2147483648,
    "Sequence": 2,
  }
```

### PartialPayment

FlagsにtfPartialPaymentを設定することでPartialPaymentが有効化されます。
10USDを利用するために最大1EURを送金する場合、1EURをUSDに変換した結果10USDに満たない場合でも、変換した分のUSD分を全て送信します。

```json
  {
    "TransactionType" : "Payment",
    "Account" : "rs7FV1WHDutSL8o6iNy1e1quf7Daf8CNrk",
    "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
    "Amount" : {
      "currency" : "USD",
      "value" : "10",
      "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
    },
    "SendMax": {
      "currency" : "EUR",
      "value" : "1",
      "issuer" : "rwqHQ87A8b5WjobXfVzvXiKAGYePoRfapa"
    },
    "Fee": "12",
    "Flags": 2147614720, // tfFullyCanonicalSig(2147483648) + tfPartialPayment(131072)
    "Sequence": 2,
  }
```

## パス

Pathsフィールドを設定することで、通貨の変換時に利用するオーダーブック等を指定できます。これによりクロスカレンシー決済や通貨変換時により低いコストで通貨の変換を実現することができます。
パスには複数の経路を含めることができ、例えばUSDをEURへ変換する場合に(USD/EUR)と(USD/XRP,EUR/XRP)のオーダーブックを利用することができます。

## まとめ

XRP LedgerのPaymentトランザクションにはXRPの送金だけでなく通貨変換など様々な利用方法があります。
Paymentトランザクション以外にもNFTやDEXでのトレードなどの様々な種類のスマートトランザクタ(プロトコルで提供されているネイティブな機能)が存在します。

ユーザが独自のロジックをアカウントに紐付けられるスマートコントラクト機能(Hooks)やAMM機能などもコミュニティによって開発中です。

興味を持たれた方はXRP Ledger開発者のDiscordチャンネルへ是非お越しください！
日本語チャンネルもありますので、英語が出来なくても大丈夫です！

https://discord.gg/aBH9MwcsbR


TeQu

Posts

XRP Ledgerのペイメントチャネルを触ってみる

XRP Ledegrのサイドチェーン Xahau Networkの紹介

Evernodeのコントラクトチュートリアル

XRPレジャーのDID機能

XRPレジャーのトランザクションの手数料

XRPLトランザクションのメタデータを学ぶ

XRPレジャーのトランザクションの基礎

コンセンサスに対する直接的なアプローチ

XRPレジャーのL2ネットワーク - Evernodeの概要

XRPLの学習フロー基礎(2)

XRPLの学習フロー基礎(1)

XRPLの学習フロー

XRPL HooksのState機能を試す

XRPレジャーの開発中の機能

XRPレジャーのメインネットで利用可能な機能

XRPLでスマコンの操作の種類

XRPLのスマコン機能「Hooks」を軽く触ってみる

XRPLのClawback機能

XRPLのRippling機能

XRPLトランザクションの自動入力フィールド

軽量NFTであるURITokenを触ってみる

XRPLアカウントのメタデータ

XRPレジャーの第一級オブジェクト

XRPLの手数料投票

コンセンサスに対する洗練されたアプローチ

コンセンサスに対する洗練されたアプローチ

秘密鍵紛失時のアカウントリカバリー【XRP Ledger】

【2023年版】XRP Ledgerのノードの更新

【2023年版】XRP Ledgerのノードを構築してみる

XRPLのオーダーブックを使ってみよう

XRP Ledgerの準備金

XRP Ledgerの強力なPayment機能

XRPLのAPIサーバ Clioのベータリリース

NFTに関するよくある間違い

IOU/XRPLトークンとは

XRPアカウントのブラックホール化

XLS20とXLS14

Posts

XRP Ledgerのペイメントチャネルを触ってみる

XRP Ledegrのサイドチェーン Xahau Networkの紹介

Evernodeのコントラクトチュートリアル

XRPレジャーのDID機能

XRPレジャーのトランザクションの手数料

XRPLトランザクションのメタデータを学ぶ

XRPレジャーのトランザクションの基礎

コンセンサスに対する直接的なアプローチ

XRPレジャーのL2ネットワーク - Evernodeの概要

XRPLの学習フロー 基礎(2)

XRPLの学習フロー 基礎(1)

XRPLの学習フロー

XRPL HooksのState機能を試す

XRPレジャーの開発中の機能

XRPレジャーのメインネットで利用可能な機能

XRPLでスマコンの操作の種類

XRPLのスマコン機能「Hooks」を軽く触ってみる

XRPLのClawback機能

XRPLのRippling機能

XRPLトランザクションの自動入力フィールド

軽量NFTであるURITokenを触ってみる

XRPLアカウントのメタデータ

XRPレジャーの第一級オブジェクト

XRPLの手数料投票

コンセンサスに対する洗練されたアプローチ

コンセンサスに対する洗練されたアプローチ

秘密鍵紛失時のアカウントリカバリー【XRP Ledger】

【2023年版】XRP Ledgerのノードの更新

【2023年版】XRP Ledgerのノードを構築してみる

XRPLのオーダーブックを使ってみよう

XRP Ledgerの準備金

XRP Ledgerの強力なPayment機能

XRPLのAPIサーバ Clioのベータリリース

NFTに関するよくある間違い

IOU/XRPLトークンとは

XRPアカウントのブラックホール化

XLS20とXLS14

XRPLの学習フロー基礎(2)

XRPLの学習フロー基礎(1)