認可トラストライン

XRP Ledgerの認可トラストライン機能により、発行者は、発行者が許可したアカウントのみが保有できるトークンを作成することができます。認可トラストライン機能はトークンにのみ適用され、XRPには影響しません。

認可トラストライン機能を使用するには、発行アドレスでRequireAuthフラグを有効にします。その後、他のアカウントは、あなたがそのアカウントのトラストラインをあなたの発行アカウントに承認した場合にのみ、あなたが発行したトークンを保持することができます。

発行アドレスからTrustSetトランザクションを送信し、自分のアカウントと認可するアカウントとの間のトラストラインを設定することで、トラストラインを認可することができます。トラストラインを認可した後、その認可を取り消すことはできません。(ただし、必要に応じてトラストラインを凍結することは可能です)。

トラストラインを認可するためのトランザクションは、発行アドレスの署名が必要であり、残念ながらそのアドレスのリスクエクスポージャーが増加することを意味します。

注意: Require Authを有効にできるのは、アカウントにトラストラインがなく、XRP LedgerにOffersがない場合だけなので、トークンの発行前に使用するかどうかを決定する必要があります。

ステーブルコインの発行

XRP Ledger上のステーブルコインと認可トラストラインの使用により、新規顧客の獲得プロセスは以下のようなものになります。

顧客は、ステーブルコイン発行会社のシステムに登録し、身元を証明する情報（「Know Your Customer」（KYC）情報とも呼ばれる）を送信します。
顧客とステーブルコイン発行者は、お互いのXRP Ledgerアドレスを提示し合います。
顧客はTrustSetトランザクションを送信し、発行者のアドレスにトラストラインを作成し、正のリミットを設定します。
発行者はTrustSetトランザクションを送信し、顧客のトラストラインを認可します。

ヒント: 2つのTrustSetトランザクション（ステップ3および4）は、どちらの順序で発生しても構いません。発行者がトラストラインを先に認可した場合、これにより限度額が0に設定されたトラストラインが作成され、顧客のTrustSetトランザクションは、事前に認可されたトラストラインの限度額を設定することになります。(TrustSetAuth amendmentにより追加されました。)_

注意事項

認可トラストラインを使用するつもりがない場合でも、運用アカウントと予備アカウントのRequire Auth設定を有効にし、これらのアカウントにトラストラインを認可させないようにすることができます。これは、これらのアカウントが誤ってトークンを発行することを防止します（たとえば、ユーザが誤って間違ったアドレスをトラストしてしまった場合など）。これはあくまで予防措置であり、運用アカウントと予備アカウントが意図したとおりに 発行者の トークンを転送することを止めるものではありません。

技術情報

RequireAuthの有効化

以下は、ローカルでホストされているrippledのsubmitメソッドを使って、asfRequireAuthフラグを使ってRequire Authを有効にするAccountSetトランザクションを送信する例です。（このメソッドは、アドレスが発行アドレス、運用アドレス、待機アドレスのいずれであっても同様に機能します。）

リクエスト:

POST http://localhost:5005/
{
   "method": "submit",
   "params": [
       {
           "secret": "s████████████████████████████",
           "tx_json": {
               "Account": "rUpy3eEg8rqjqfUoLeBnZkscbKbFsKXC3v",
               "Fee": "15000",
               "Flags": 0,
               "SetFlag": 2,
               "TransactionType": "AccountSet"
           }
       }
   ]
}

注意

自分が管理していないサーバに秘密鍵を送信しないでください。暗号化されていない秘密鍵をネットワーク経由で送信しないでください。

アカウントのRequireAuthの有効化の確認

アカウントのRequireAuth設定の有効化の状態を確認するには、account_infoメソッドを使用してアカウントを調べます。Flagsフィールド（result.account_dataオブジェクト）の値を、AccountRootレジャーオブジェクトのビット単位フラグと比較します。

Flags値とlsfRequireAuthフラグ値（0x00040000）のビット単位のANDの結果がゼロ以外の場合、アカウントではRequireAuthが有効になっています。結果がゼロの場合、アカウントではRequireAuthが無効になっています。

トラストラインの認可

認可トラストライン機能を使用している場合、他のアカウントからのトラストラインを認可しなければ、これらの他のアカウントはあなたが発行する残高を保有できません。複数のトークンを発行する場合には、各通貨のトラストラインを個別に認可する必要があります。

トラストラインを認可するには、LimitAmountのissuerとして信頼するユーザを指定して、発行アドレスからTrustSetトランザクションを送信します。value（信頼する額）を0のままにし、トランザクションのtfSetfAuthフラグを有効にします。

以下は、ローカルでホストされているrippledのsubmitメソッドを使用して、顧客アドレスrf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2JpnがアドレスrsA2LpzuawewSBQXkiju3YQTMzW13pAAdWで発行したUSDを持つことを認可するTrustSetトランザクションを送信する例です。

リクエスト:

POST http://localhost:8088/
{
   "method": "submit",
   "params": [
       {
           "secret": "s████████████████████████████",
           "tx_json": {
               "Account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
               "Fee": "15000",
               "TransactionType": "TrustSet",
               "LimitAmount": {
                   "currency": "USD",
                   "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                   "value": 0
               },
               "Flags": 65536
           }
       }
   ]
}

注意

自分が管理していないサーバに秘密鍵を送信しないでください。暗号化されていない秘密鍵をネットワーク経由で送信しないでください。

トラストラインの認可状況の確認

トラストラインの認可状況を確認するには、account_linesメソッドを使用してトラストラインを調べます。レスポンスのaccountフィールドに顧客のアドレスを指定し、peerフィールドに発行者のアドレスを指定します。

レスポンスのresult.lines配列で、必要とする通貨のトラストラインを表しているcurrencyフィールドを持つオブジェクトを見つけます。そのオブジェクトのpeer_authorizedフィールドに値trueが設定されている場合は、発行者（レスポンスのpeerフィールドとして使用したアドレス）によりそのトラストラインが承認されています。