Deposit Authorization

（DepositAuth Amendmentにより追加されました。）

Deposit Authorizationは、XRP Ledgerのアカウントのオプション機能です。Deposit Authorizationが有効な場合、トランザクションはそのトランザクションの送信者がアカウント自体でない限り、アカウントへはどのような資産も送信できません。Deposit Authorizationのアカウントは、次の2つの方法でのみ入金することができます。

事前承認されたアカウントから。
トランザクションを送信して資金を受け取ることにより。例えば、Deposit Authorizationが設定されたアカウントは、他のアカウントによって開始されたエスクローを完了することができます。

デフォルトでは、新しいアカウントではDepositAuthが無効になっています。

背景

金融サービスの規制やライセンスによっては、企業や組織に対して、受領するすべてのトランザクションの送信者を把握するよう義務付けています。これは、自由に生成できる偽名で参加者を識別し、デフォルトですべてのアドレスからあらゆる宛先への支払いを可能とするXRP Ledgerのような分散型システムとっては課題となります。

Deposit Authorizationフラグにより、XRP Ledgerを使用するユーザが分散型レジャーの基本的な特性を変えずにこのような規制に準拠するためのオプションを採用しました。Deposit Authorizationが有効な場合、アカウントはトランザクションを送信することで明示的に承認した資金のみを受領できます。Deposit Authorizationを使用するアカウントの所有者は、アカウントに資金を入金するトランザクションを送信する前に、資金の送金元の確認に必要なデューディリジェンス（確認調査）を実施できます。

Deposit Authorizationを有効にすると、Checks、Escrow、およびPayment Channelから資金を受領できます。このような「二段階」トランザクションモデルでは、最初に送金元は資金の送金を承認するトランザクションを送信し、次に送金先は資金受領を承認するトランザクションを送信します。

Deposit Authorizationが有効になっている場合にPaymentトランザクションから資金を受領するには、このような支払の送金元を事前承認する必要があります。（DepositPreauth Amendmentにより追加されました。）

推奨される使い方

Deposit Authorizationを最大限に活用するため、以下の実施を推奨します。

XRP残高が常に最低必要準備金を上回るようにする。
DefaultRippleフラグをデフォルトの状態（無効）にしておく。トラストラインに対してRipplingを有効にしない。TrustSetトランザクションを送信するときには常にtfSetNoRippleフラグを使用する。
オファーを行わない。このようなトランザクションの実行にあたり、消費される一致オファーを事前に把握することは不可能です。

詳細なセマンティクス

Deposit Authorizationが有効化されているアカウントの特徴は次のとおりです。

Paymentトランザクションの送信先にはできません。ただし以下の例外は除きます。
- 送金先により、支払の送金元が事前承認されている場合。（DepositPreauth Amendmentにより追加されました。）
- アカウントのXRP残高がアカウントの最低必要準備金以下で、XRP PaymentのAmountがアカウントの最低準備金（現時点では10XRP）以下である場合は、このアカウントを送金先に指定できます。これにより、アカウントがトランザクションを送信することも、XRPを受領することもできずに操作不可能な状態になるのを防ぎます。この場合、アカウントの所有者の準備金は関係ありません。
以下に該当する場合にのみPaymentChannelClaimトランザクションからXRPを受領できます。
- PaymentChannelClaimトランザクションの送金元がPayment Channelの送金先である場合。
- PaymentChannelClaimトランザクションの送金先がPaymentChannelClaimの送金元を事前承認している場合。（DepositPreauth Amendmentにより追加されました。）
以下に該当する場合にのみEscrowFinishトランザクションからXRPを受領できます。
- EscrowFinishトランザクションの送金元がEscrowの送金先である場合。
- EscrowFinishトランザクションの送金先がEscrowFinishの送金元を事前承認している場合。（DepositPreauth Amendmentにより追加されました。）
CheckCashトランザクションを送信してXRPまたはトークンを受領できます。 （Checks Amendmentにより追加されました。）
OfferCreateトランザクションを送信してXRPまたはトークンを受領できます。
- 即時には完全に実行されないOfferCreateトランザクションがアカウントから送信される場合、このアカウントは、後でオファーが他のアカウントのPaymentトランザクションとOfferCreateトランザクションによって消費される時点で、注文済みXRPとトークンのリマインダーを受信することがあります。
アカウントがNoRippleフラグを有効にせずにトラストラインを作成している場合、またはDefaultRippleフラグを有効にして通貨を発行した場合は、アカウントはRipplingの結果として、Paymentトランザクションでそれらのトラストラインのトークンを受領できます。このようなトランザクションの送金先にすることはできません。
一般的に、以下のすべての条件に該当する場合は、XRP LedgerのアカウントはXRP LedgerでXRP以外の通貨を受領できません。（このルールは、DepositAuthフラグに特有のものではありません。）
- アカウントにより、ゼロ以外の限度を指定したトラストラインが作成されていない。
- アカウントが、その他のアカウントにより作成されたトラストラインで通貨を発行していない。
- アカウントがまだオファーを出していない。

以下の表に、トランザクションタイプ別にDepositAuthが有効または無効な状態での入金の可否をまとめました。

	DepositAuth Disabled		DepositAuth Enabled
Transaction Type	Sent by Destination	Sent by Others	Sent by Destination	Sent by Others	Sent by Preauthorized Others
AccountSet	(This transaction type never sends money.)
CheckCancel	(This transaction type never sends money.)
CheckCash	OK	No Permission	OK	No Permission	No Permission
CheckCreate	(This transaction type never sends money.)
EscrowCancel	Can return XRP from an expired escrow
EscrowCreate	(This transaction type can only debit XRP, not credit it.)
EscrowFinish	OK	OK	OK	No Permission	OK
OfferCancel	This transaction type never sends money.
OfferCreate	OK	Only if account previously created a matching offer	OK	Only if account previously created a matching offer	Only if account previously created a matching offer
Payment (If account has more than the minimum XRP reserve, enables No Ripple on all trust lines, and places no offers)	Cross-currency only	OK	Cross-currency only ¹	No Permission	OK
Payment (If account XRP balance is below the minimum XRP reserve)	Cross-currency only	OK	Cross-currency only ¹	XRP payments up to the minimum reserve	OK
Payment (If account has any trust lines with No Ripple disabled)	Cross-currency only	OK	Cross-currency only ¹	Balance changes from rippling	OK
Payment (If account has placed offers)	Cross-currency only	OK	Cross-currency only ¹	Balance changes from executing offers	OK
PaymentChannelClaim	OK	OK	OK	No Permission	OK
PaymentChannelCreate	(This transaction type can only debit XRP, not credit it.)
PaymentChannelFund	Can return XRP when closing a channel created by self
SetRegularKey	(This transaction type never sends money.)
SignerListSet	(This transaction type never sends money.)
TrustSet	(This transaction type never sends money.)

¹: The DepositPreauth amendment fixes a bug in DepositAuth which causes cross-currency payments to oneself to fail if the account requires deposit authorization. If the DepositPreauth amendment is not enabled, these cases result in "No Permission" instead.

Deposit Authorizationの有効化または無効化

アカウントのDeposit Authorizationを有効にするには、SetFlagフィールドにasfDepositAuthの値（9）を設定したAccountSetトランザクションを送信します。アカウントのDeposit Authorizationを無効にするには、ClearFlagフィールドにasfDepositAuthの値（9）を設定したAccountSetトランザクションを送信します。AccountSetフラグについての詳細は、AccountSetフラグをご覧ください。

AccountのDepositAuthの有効化の確認

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

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

事前承認

（DepositPreauth Amendmentにより追加されました。）

DepositAuthが有効なアカウントは、特定の送金元を 事前承認 することにより、DepositAuthが有効になっていても、これらの送金元からの支払を受領することができます。これにより、特定の送金元からの資金の直接送金が可能となり、受取人はトランザクションごとに個別にアクションを実行する必要がなくなります。事前承認はDepositAuthの使用にあたり必須の要件ではありませんが、事前承認により特定の操作を実行しやすくなります。

事前承認は通貨に依存しません。特定の通貨のみについてアカウントを事前承認することはできません。

特定の送金元を事前承認するには、Authorizeフィールドに事前承認する別のアカウントのアドレスを指定したDepositPreauthトランザクションを送信します。事前承認を取り消すには、当該アカウントのアドレスをUnauthorizeフィールドに指定します。通常どおり、Accountフィールドには自分自身のアドレスを指定します。現在DepositAuthを有効にしていない場合でも、アカウントを事前承認または承認解除できます。他のアカウントに設定した事前認証ステータスは保存されますが、DepositAuthを有効にしない限り、このステータスの影響はありません。アカウントがアカウント自体を事前認証することはできません。事前認証は一方向であり、反対方向の支払には影響しません。

別のアカウントを事前認証すると、レジャーにDepositPreauthオブジェクトが追加されます。これにより、認証を提供するアカウントの所有者準備金が増加します。アカウントで事前承認が取り消されると、オブジェクトが削除され、準備金はこれに伴い減少します。

DepositPreauthトランザクションの処理が完了すると、承認済みアカウントからあなたのアカウントに資金を送金できるようになります。これは、以下のトランザクションタイプのいずれかを使用してDepositAuthを有効にしている場合にも該当します。

事前承認は、DepositAuthが有効なアカウントへのその他の送金方法には影響しません。詳しいルールについては、詳細なセマンティクスをご覧ください。

承認の確認

deposit_authorizedメソッドを使用して、特定のアカウントに対し別のアカウントへの入金が許可されているかどうかを確認できます。このメソッドは次の2点を確認します。

送金先アカウントがDeposit Authorizationを必要としているかどうか。（承認を必要としていない場合は、すべての送金元アカウントが承認済みとみなされます。）
送金元アカウントに対し、送金先への送金が事前承認されているかどうか。