XRP LedgerとはXRP Ledgerは、XRP(エックスアールピー)をネイティブなトークンとして持つブロックチェーンです。各ノードはバリデータによって検証されたレジャーの情報を持っており、また作業領域として幾つかの種類のレジャー(台帳)情報を持っています。 オープンレジャー(Open ledger)オープンレジャーは各ノードの作業用のレジャーです。ノード毎に1つしか存在しえず、コンセンサスラウンド毎に直前の検証済みレジャーを元に作成されます。ノードは受け取ったトランザクションを順にこのレジャーに適用し、トランザクションの一時的な結果などをユーザへと返します。このレジ...

XRPLノード内の3種類の台帳

XRP LedgerとはXRP Ledgerは、XRPをネイティブなトークンとして持つブロックチェーンです。XRPLのトランザクションは各ノードによって共謀しないと信頼されているバリデータの検証を通じてネットワークに適用されます。この記事ではXRPL(mainnet)からXahau Networkにトークンをブリッジする際にも利用されているXPOP(Proof of Payment)について説明します。原文:0041 XLS-41d: XRPL Proof of Payment Standard (XPOP) 概要XRP Ledger Proof of Payment(...

XRPLトランザクションのオフライン検証

rippledとはrippledは、XRP Ledgerのサーバーソフトウェアです。XRP Ledgerの各バリデータやノードの実体は、「rippled」によって提供され、XRP Ledgerがネイティブなトークン機能、DEX機能、NFT機能等を備えているのは、rippledにこれらの機能が実装されているためです。https://github.com/XRPLF/rippledまた、XRP Ledgerにおけるトランザクション処理やコンセンサスプロセスに影響を与える新しい機能や修正を実装する場合は、Amendmentsシステムを通じて有効化する必要があります。このれには、80%...

rippled 2.0.0がリリースされました！

XRP LedgerとはXRP Ledgerは、分散型のパブリックブロックチェーンです。XRP Ledgerは、DEX機能やNFT機能をはじめとした様々なネイティブ機能を備えており、日々進化を続けています。https://xrpl.org/ja/index.htmlこの記事ではXRPL DEXのロウソク足情報の取得方法について説明します。XRPL DEX自体の解説については次の記事をご覧ください。https://zenn.dev/tequ/articles/use-original-dex book_changesコマンドXRPL DEXのロウソク足情報はbook_c...

XRPL DEXのロウソク足を取得する

はじめにこの記事はXLS-33dとして提案されているMulti-Purpose Tokens (MPT)を紹介するものです。元々はCompact Fungible Token(CFT)として提案されていましたが、その後MPTと変更されています。原文この提案はまだ確定しているものではないため、今後変更される可能性があります。 1. Multi-Purpose Tokens (MPTs) 1.1. 概要トラストラインは、CBDCやフィアット担保ステーブルコインを含む、多くのXRP Ledgerのトークン化機能の基本的な構成要素です。しかし、より多くのトークン発行者がXR...

XRP LedgerのMulti-Purpose Tokensとは？

XRP LedgerXRP Ledgerは、分散型のパブリックブロックチェーンです。XRP Ledgerは、DEX機能やNFT機能をはじめとした様々なネイティブ機能を備えており、日々進化を続けています。特徴の一つに非常に低いトランザクションコストがあります。この記事では、特定のトランザクションでは通常のトランザクションよりも高いコストがかかることを紹介します。 トランザクションコストXRP Ledgerではトランザクションを送信する際に少額の手数料を支払う必要があります。これらの手数料はネットワークへ多量のトランザクションが送信されることを防ぐために必要とされています。...

XRP Ledgerの特殊なトランザクションコスト

ClawbackとはClawback機能はXRP Ledgerでトークンを管理する機能の一つであり、トークンの発行者がトークンを保有しているアカウントからトークンを回収する機能です。https://xrpl.org/ja/clawing-back-tokens.htmlrippledの1.12.0で導入され、執筆時点ではバリデータによる投票中となっています。https://xrpl.org/blog/2023/rippled-1.12.0.htmlhttps://xrpscan.com/amendment/Clawback機能の詳細についてはこちらの記事で説明しています。...

XRPLのClawback機能を試してみる

HooksとはHooksは、XRP Ledger(XRPL)プロトコルのスマートコントラクト機能です。この機能により、開発者は独自のロジックを実装することが可能になります。Hooksではアカウントから送信したトランザクションやアカウントが受信したトランザクションをトリガーにHookを呼び出してそのトランザクションの送信/受信を拒否したり、別のトランザクションを発行したり、State情報の追加・変更・削除などを行うことができます。現在はXahau Networkで利用可能ですが、将来的にはXRP Ledgerのメインネットでも利用可能になることが期待されています。https://...

Hooksの基本的なコード

HooksとはHooksはXRP Ledgerへスマートコントラクト機能を追加するための機能です。https://hooks.xrpl.org執筆時点ではXRPLのサイドチェーンであるXahau Networkでのみ利用可能ですが、将来的にはXRPL本体でも利用可能になる可能性があります。https://xahau.networkHooksの特徴の1つとして、Hook(コントラクト)専用のコントラクトアカウントが作成されるのではなく、既存のアカウントにHookを追加できる点が挙げられます。アカウントからのトランザクションの送信や着信に対して、ロジックが実行されるようになり...

Hookのトランザクションを読む

XRP LedgerとはXRPレジャーはBitcoinやEthereumなどと同じ分散型のパブリックブロックチェーンです。PoWやPoSとは異なる独自のコンセンサスアルゴリズムが用いられています。EVMによるスマートコントラクトは搭載しておらず、スマートトランザクタ(プロトコルネイティブで提供されている機能)を拡張することで進化し続けています。XRP Lederの情報はレジャーオブジェクトやレジャーエントリなどと呼ばれ、レジャー全体で一意となるキーで識別されています。 データの取得XRP Ledgerからデータを取得する方法の最も基礎的なものとしてPublic APIが提...

XRP LedgerのパブリックAPI

XRP LedgerとはXRP Ledgerは、分散型のパブリックブロックチェーンです。XRP Ledgerは、DEX機能やNFT機能をはじめとした様々なネイティブ機能を備えており、日々進化を続けています。https://xrpl.org/ja/index.htmlこれらの機能が分散型の仕組みの中でどうやって有効化されているかを解説します。 機能の有効化イーサリアムなど他のブロックチェーンでは、プロトコルなどの新規機能などをリリースする際はハードコードされたブロック高などによりその機能が有効化されるようになっています。https://github.com/ethereu...

XRPLの新機能の有効化

本記事は次のXのスレッドを翻訳したものです。https://twitter.com/XahauCommunity/status/1719276175560986700 Xahau に関する巨大スレッドこのスレッドには、新しいスマートコントラクトに対応したXRPLエコシステム上のサイドチェーンであるXahauに関する情報が含まれています。XahauとはXahauの特徴と提案Xahauにコアなニーズがある理由 1. XahauとはXahauはXRPLエコシステム上のスマートコントラクト対応サイドチェーンで、XRPLコンセンサスプロトコルとその台帳構造に基づくネットワー...

Xahau に関する巨大スレッド

rippledとはrippledは、XRP Ledgerのサーバーソフトウェアです。XRP Ledgerの各バリデータやノードの実体は、「rippled」であり、XRP Ledgerがネイティブなトークン機能、DEX機能、NFT機能等を備えているのは、rippledにこれらの機能が実装されているためです。https://github.com/XRPLF/rippledこの記事ではそのトランザクションのコードについて簡単に解説します。!rippledはC++で実装されています。この記事ではC++に関連する説明は行わず、データのチェックや取得、登録などのロジックについて解説し...

XRPLのトランザクションコード

XRP LedgerとはXRP Ledgerは、分散型のブロックチェーンの1つであり、ネイティブにトークンの発行やDEX、NFTなどの機能を持っていることが大きな特徴です。2012年から稼働しており、10年以上に渡り8200万レジャー(ブロック)以上を処理してきた歴史があります。https://xrpl.org/ja/index.html XRPLのサーバプログラムXRP Ledgerのサーバプログラムは、C++で書かれたrippledです。rippled内にコンセンサスやトランザクション、ネットワークなどの機能が実装されています。執筆時点での最新バージョンは2023...

XRP Ledgerをローカル環境でテストする

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トランザクションのメタデータを学ぶ

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

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

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

最小限のコンセンサス

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

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

## はじめに

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

XRPLノード内の3種類の台帳

XRPLトランザクションのオフライン検証

rippled 2.0.0がリリースされました！

XRPL DEXのロウソク足を取得する

XRP LedgerのMulti-Purpose Tokensとは？

XRP Ledgerの特殊なトランザクションコスト

XRPLのClawback機能を試してみる

Hooksの基本的なコード

Hookのトランザクションを読む

XRP LedgerのパブリックAPI

XRPLの新機能の有効化

Xahau に関する巨大スレッド

XRPLのトランザクションコード

XRP Ledgerをローカル環境でテストする

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

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

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

XRPレジャーのDID機能

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

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

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

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