mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-25 14:15:50 +00:00
[JA] translate PermissionedDomains
This commit is contained in:
@@ -0,0 +1,39 @@
|
|||||||
|
---
|
||||||
|
seo:
|
||||||
|
description: 許可型ドメインの定義と詳細
|
||||||
|
labels:
|
||||||
|
- コンプライアンス
|
||||||
|
- 許可型ドメイン
|
||||||
|
---
|
||||||
|
# 許可型ドメイン
|
||||||
|
|
||||||
|
許可型ドメインは、XRP Ledgerブロックチェーンのより広いエコシステム内の制御された環境です。ドメインは何もしませんが、許可型DEXや貸付プロトコルなどの機能は、ドメインを使用してアクセスを制限するため、従来の金融機関は、様々なコンプライアンスルールに従って、チェーン上でサービスを提供できます。
|
||||||
|
|
||||||
|
ドメインの唯一の設定可能なルールは、[資格情報][]のセットです。将来のAmendmentは、金融機関が業務を行う地域の法律に従ってコンプライアンスを維持するために必要な制限をカバーするために、新しいおよび異なるタイプのルールを追加することができます。
|
||||||
|
|
||||||
|
誰でもドメインを定義できます。その人はそのドメインの所有者になり、設定を更新したり削除したりできます。ドメインの数の制限は、所有者の準備金要件に対して1つのアイテムとしてカウントされるため、レジャーに存在できるドメインの数の制限は、準備金要件のみです。
|
||||||
|
|
||||||
|
_([PermissionedDomains amendment][]が必要です {% not-enabled /%})_
|
||||||
|
|
||||||
|
{% admonition type="info" name="注記" %}
|
||||||
|
[Credentials amendment][]も必要です。[PermissionedDomains amendment][]が有効でない場合、PermissionedDomainSetトランザクションは無効とみなされます。
|
||||||
|
{% /admonition %}
|
||||||
|
|
||||||
|
## 許可された資格情報
|
||||||
|
|
||||||
|
許可型ドメインには、アクセスを許可する1から10個の資格情報のセットがあります。リストの各項目は、発行者と資格情報の種類によって資格情報を説明します。_少なくとも1つ_ 一致する資格情報を保持するアカウントは、自動的にドメインにアクセスできます。
|
||||||
|
|
||||||
|
ドメインは、資格情報と制限されたリソースの間の抽象化レイヤーとして機能します。ドメインの所有者は、制限されたリソース自体を変更せずに、必要な資格情報のリストを更新できます。
|
||||||
|
|
||||||
|
[{% inline-svg file="../../../img/permissioned-domain.svg" /%}](../../../img/permissioned-domain.svg "図: 許可型DEXは、IDによって許可型ドメインを指します。ドメインの許可された資格情報は、アクセスを取得するための3つの可能な資格情報を説明します")
|
||||||
|
|
||||||
|
ユーザは、ドメインに参加または退出するために申請する必要はありません。トランザクションがドメインによって制限されたリソースへのアクセスを必要とする場合、トランザクションは自動的にアカウントがドメインの許可された資格情報と一致する資格情報を保持しているかどうかを確認し、一致しない場合は失敗します。ユーザの資格情報は、許可されており、有効期限が切れていない必要があります。
|
||||||
|
|
||||||
|
## ドメインの用途
|
||||||
|
|
||||||
|
現在、許可型ドメインを使用するXRP Ledgerの機能はありません。ただし、ドメインを利用する開発中のAmendmentには次のものがあります。
|
||||||
|
|
||||||
|
- 単一資産Vaultと貸付プロトコル
|
||||||
|
- 許可型DEX
|
||||||
|
|
||||||
|
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||||
@@ -0,0 +1,103 @@
|
|||||||
|
---
|
||||||
|
seo:
|
||||||
|
description: PermissionedDomainレジャーエントリは、他の機能へのアクセスを制限するために使用される許可型ドメインを表します。
|
||||||
|
labels:
|
||||||
|
- コンプライアンス
|
||||||
|
- 許可型ドメイン
|
||||||
|
---
|
||||||
|
# PermissionedDomain
|
||||||
|
[[ソース]](https://github.com/XRPLF/rippled/blob/master/include/xrpl/protocol/detail/ledger_entries.macro#L451-L461 "ソース")
|
||||||
|
|
||||||
|
`PermissionedDomain`レジャーエントリは、単一の[許可型ドメイン][]インスタンスを記述します。[PermissionedDomainSetトランザクション][]を送信することで、許可型ドメインを作成できます。
|
||||||
|
|
||||||
|
_([PermissionedDomains amendment][]が必要です {% not-enabled /%})_
|
||||||
|
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}のJSONの例
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"LedgerEntryType": "PermissionedDomain",
|
||||||
|
"Fee": "10",
|
||||||
|
"Flags": 0,
|
||||||
|
"Owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
|
||||||
|
"OwnerNode": "0000000000000000",
|
||||||
|
"Sequence": 390,
|
||||||
|
"AcceptedCredentials": [
|
||||||
|
{
|
||||||
|
"Credential": {
|
||||||
|
"Issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
|
||||||
|
"CredentialType": "6D795F63726564656E7469616C"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"PreviousTxnID": "E7E3F2BBAAF48CF893896E48DC4A02BDA0C747B198D5AE18BC3D7567EE64B904",
|
||||||
|
"PreviousTxnLgrSeq": 8734523,
|
||||||
|
"index": "3DFA1DDEA27AF7E466DE395CCB16158E07ECA6BC4EB5580F75EBD39DE833645F"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
<!-- TODO: use a real example above -->
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}のフィールド
|
||||||
|
|
||||||
|
[共通フィールド](../common-fields.md)に加えて、{% code-page-name /%}エントリには次のフィールドがあります。
|
||||||
|
|
||||||
|
| フィールド | JSONの型 | [内部の型][] | 必須? | 説明 |
|
||||||
|
|:----------------------|:----------------------|:-------------|:------|:------|
|
||||||
|
| `AcceptedCredentials` | 配列 | Array | はい | このドメインへのアクセスを許可する1から10個の[Credential](#acceptedcredentialsオブジェクト)オブジェクトのリスト。配列は発行者でソートされて保存されます。 |
|
||||||
|
| `Owner` | 文字列 - [アドレス][] | AccountID | はい | このドメインの所有者のアドレス。 |
|
||||||
|
| `OwnerNode` | 文字列 | UInt64 | はい | 所有者ディレクトリが複数のページで構成されている場合、このエントリにリンクする所有者ディレクトリのページを示すヒント。 |
|
||||||
|
| `PreviousTxnID` | 文字列 - [ハッシュ][] | Hash256 | はい | このエントリを最後に変更したトランザクションの識別ハッシュ。 |
|
||||||
|
| `PreviousTxnLgrSeq` | 数値 | UInt32 | はい | このオブジェクトを最後に変更したトランザクションを含む[レジャーのインデックス][Ledger Index]。 |
|
||||||
|
| `Sequence` | 数値 | UInt32 | はい | このエントリを作成したトランザクションの`Sequence`値。 |
|
||||||
|
|
||||||
|
|
||||||
|
### AcceptedCredentialsオブジェクト
|
||||||
|
|
||||||
|
`AcceptedCredentials`配列の各メンバーは、次のネストされたフィールドを持つ内部オブジェクトです。
|
||||||
|
|
||||||
|
| フィールド | JSONの型 | [内部の型][] | 必須? | 説明 |
|
||||||
|
|:-----------------|:---------------------|:------------------|:----------|--------------|
|
||||||
|
| `Issuer` | 文字列 - [アドレス][] | AccountID | はい | 資格情報の発行者。 |
|
||||||
|
| `CredentialType` | 文字列 | Blob | はい | 資格情報の種類。これは、発行者が資格情報を発行するときに設定する1から64バイトの任意の値です。 |
|
||||||
|
|
||||||
|
{% admonition type="info" name="注記" %}
|
||||||
|
通常のJSON形式では、内部オブジェクトは、内部オブジェクトの種類を定義する名前を持つ1つのフィールドを持つオブジェクトでラップされます。この場合、ラッピングフィールドは`Credential`と呼ばれます。
|
||||||
|
|
||||||
|
```json
|
||||||
|
"AcceptedCredentials": [
|
||||||
|
{
|
||||||
|
"Credential": {
|
||||||
|
"Issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
|
||||||
|
"CredentialType": "6D795F63726564656E7469616C"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
// ... 追加のCredential内部オブジェクト ...
|
||||||
|
]
|
||||||
|
```
|
||||||
|
{% /admonition %}
|
||||||
|
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}のフラグ
|
||||||
|
|
||||||
|
{% code-page-name /%}エントリには、フラグは定義されていません。
|
||||||
|
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}の準備金要件
|
||||||
|
|
||||||
|
{% code-page-name /%}エントリは、所有者の準備金要件に対して1つのアイテムとしてカウントされます。
|
||||||
|
|
||||||
|
{% code-page-name /%}エントリは、削除ブロッカーであり、つまり、アカウントが{% code-page-name /%}エントリを所有している場合、アカウントは削除できません。
|
||||||
|
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %} IDのフォーマット
|
||||||
|
|
||||||
|
{% code-page-name /%}エントリのIDは、次の値を順番に連結した[SHA-512Half][]です。
|
||||||
|
|
||||||
|
1. {% code-page-name /%}の名前空間キー(`0x0082`)
|
||||||
|
2. 所有者のアカウントID
|
||||||
|
3. 作成した{% code-page-name /%}トランザクションのシーケンス番号
|
||||||
|
|
||||||
|
|
||||||
|
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
---
|
||||||
|
seo:
|
||||||
|
description: 許可型ドメインのレジャーエントリを削除する
|
||||||
|
labels:
|
||||||
|
- コンプライアンス
|
||||||
|
- 許可型ドメイン
|
||||||
|
---
|
||||||
|
# PermissionedDomainDelete
|
||||||
|
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/tx/detail/PermissionedDomainDelete.cpp "ソース")
|
||||||
|
|
||||||
|
所有する[許可型ドメイン][]を削除します。
|
||||||
|
|
||||||
|
_([PermissionedDomains amendment][]が必要です {% not-enabled /%})_
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}のJSONの例
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"TransactionType": "PermissionedDomainDelete",
|
||||||
|
"Account": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
|
||||||
|
"Fee": "10",
|
||||||
|
"Sequence": 392,
|
||||||
|
"DomainID": "77D6234D074E505024D39C04C3F262997B773719AB29ACFA83119E4210328776"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
<!-- TODO: {% tx-example txid="TODO" /%} -->
|
||||||
|
|
||||||
|
{% raw-partial file="/@l10n/ja/docs/_snippets/tx-fields-intro.md" /%}
|
||||||
|
|
||||||
|
| フィールド | JSONの型 | [内部の型][] | 必須? | 説明 |
|
||||||
|
|:-----------|:----------------------|:-------------|:------|:-----|
|
||||||
|
| `DomainID` | 文字列 - [ハッシュ][] | Hash256 | はい | 削除する許可型ドメインのレジャーエントリID。 |
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}のフラグ
|
||||||
|
|
||||||
|
{% $frontmatter.seo.title %}トランザクションには、フラグは定義されていません。
|
||||||
|
|
||||||
|
## エラーケース
|
||||||
|
|
||||||
|
すべてのトランザクションで発生する可能性のあるエラーに加えて、{% $frontmatter.seo.title %}トランザクションでは、次の[トランザクション結果コード](../transaction-results/index.md)が発生する可能性があります。
|
||||||
|
|
||||||
|
| エラーコード | 説明 |
|
||||||
|
|:--------------|:--------------------------------------|
|
||||||
|
| `tecNO_ENTRY` | `DomainID`フィールドで指定された許可型ドメインがレジャーに存在しません。 |
|
||||||
|
| `temDISABLED` | `PermissionedDomains` amendmentが有効ではありません。 |
|
||||||
|
|
||||||
|
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||||
@@ -0,0 +1,63 @@
|
|||||||
|
---
|
||||||
|
seo:
|
||||||
|
description: 許可型ドメインを作成または更新する
|
||||||
|
labels:
|
||||||
|
- コンプライアンス
|
||||||
|
- 許可型ドメイン
|
||||||
|
---
|
||||||
|
# PermissionedDomainSet
|
||||||
|
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/tx/detail/PermissionedDomainSet.cpp "ソース")
|
||||||
|
|
||||||
|
[許可型ドメイン][]を作成するか、所有するドメインを変更します。
|
||||||
|
|
||||||
|
_([PermissionedDomains amendment][]が必要です {% not-enabled /%})_
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}のJSONの例
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"TransactionType": "PermissionedDomainSet",
|
||||||
|
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
|
||||||
|
"Fee": "10",
|
||||||
|
"Sequence": 390,
|
||||||
|
"AcceptedCredentials": [
|
||||||
|
{
|
||||||
|
"Credential": {
|
||||||
|
"Issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
|
||||||
|
"CredentialType": "6D795F63726564656E7469616C"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
<!-- TODO: {% tx-example txid="TODO" /%} -->
|
||||||
|
|
||||||
|
{% raw-partial file="/@l10n/ja/docs/_snippets/tx-fields-intro.md" /%}
|
||||||
|
|
||||||
|
| フィールド | JSONの型 | [内部の型][] | 必須? | 説明 |
|
||||||
|
|:----------------------|:----------------------|:-------------|:-------|:------------|
|
||||||
|
| `DomainID` | 文字列 - [ハッシュ][] | Hash256 | いいえ | 変更する既存の許可型ドメインのレジャーエントリID。省略すると、新しい許可型ドメインが作成されます。 |
|
||||||
|
| `AcceptedCredentials` | 配列 | Array | はい | このドメインへのアクセスを許可する1から10個の[**Accepted Credentialsオブジェクト**](#accepted-credentials-objects)のリスト。リストはソートする必要はありませんが、重複ことはできません。既存のドメインを変更する場合、このリストは既存のリストを置き換えます。 |
|
||||||
|
|
||||||
|
{% raw-partial file="/@l10n/ja/docs/_snippets/accepted-credentials-objects.md" /%}
|
||||||
|
|
||||||
|
## {% $frontmatter.seo.title %}のフラグ
|
||||||
|
|
||||||
|
{% $frontmatter.seo.title %}トランザクションには、フラグは定義されていません。
|
||||||
|
|
||||||
|
## エラーケース
|
||||||
|
|
||||||
|
すべてのトランザクションで発生する可能性のあるエラーに加えて、{% $frontmatter.seo.title %}トランザクションでは、次の[トランザクション結果コード](../transaction-results/index.md)が発生する可能性があります。
|
||||||
|
|
||||||
|
| エラーコード | 説明 |
|
||||||
|
|:--------------------------|:-----|
|
||||||
|
| `tecDIR_FULL` | このトランザクションは、新しい許可型ドメインを作成しますが、送信者の所有者ディレクトリがいっぱいです。 |
|
||||||
|
| `tecINSUFFICIENT_RESERVE` | このトランザクションは、新しい許可型ドメインを作成しますが、送信者が増加分の所有者準備金を満たす十分なXRPを持っていません。 |
|
||||||
|
| `tecNO_ENTRY` | このトランザクションは、存在しないドメインを変更しようとしました。トランザクションの`DomainID`フィールドを確認してください。 |
|
||||||
|
| `tecNO_ISSUER` | `AcceptedCredentials`フィールドで指定された発行者の少なくとも1つがXRP Ledgerに存在しません。配列の各メンバーの`Issuer`フィールドを確認してください。 |
|
||||||
|
| `tecNO_PERMISSION` | このトランザクションは、既存のドメインを変更しようとしましたが、トランザクションの送信者は指定されたドメインの所有者ではありません。 |
|
||||||
|
| `temDISABLED` | `PermissionedDomains` amendmentが有効ではないか、または`Credentials` amendmentが有効ではありません。 |
|
||||||
|
|
||||||
|
|
||||||
|
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||||
@@ -254,8 +254,10 @@
|
|||||||
[PermissionDelegation amendment]: /resources/known-amendments.md#permissiondelegation
|
[PermissionDelegation amendment]: /resources/known-amendments.md#permissiondelegation
|
||||||
[PermissionedDEX amendment]: /resources/known-amendments.md#permissioneddex
|
[PermissionedDEX amendment]: /resources/known-amendments.md#permissioneddex
|
||||||
[PermissionedDomainSet transaction]: /docs/references/protocol/transactions/types/permissioneddomainset.md
|
[PermissionedDomainSet transaction]: /docs/references/protocol/transactions/types/permissioneddomainset.md
|
||||||
|
[PermissionedDomainSetトランザクション]: /@l10n/ja/docs/references/protocol/transactions/types/permissioneddomainset.md
|
||||||
[PermissionedDomains amendment]: /resources/known-amendments.md#permissioneddomains
|
[PermissionedDomains amendment]: /resources/known-amendments.md#permissioneddomains
|
||||||
[permissioned domain]: /docs/concepts/tokens/decentralized-exchange/permissioned-domains.md
|
[permissioned domain]: /docs/concepts/tokens/decentralized-exchange/permissioned-domains.md
|
||||||
|
[許可型ドメイン]: /@l10n/ja/docs/concepts/tokens/decentralized-exchange/permissioned-domains.md
|
||||||
[PriceOracle amendment]: /resources/known-amendments.md#priceoracle
|
[PriceOracle amendment]: /resources/known-amendments.md#priceoracle
|
||||||
[MPToken entry]: /docs/references/protocol/ledger-data/ledger-entry-types/mptoken.md
|
[MPToken entry]: /docs/references/protocol/ledger-data/ledger-entry-types/mptoken.md
|
||||||
[MPTokensV1_1 amendment]: /resources/known-amendments.md#priceoracle
|
[MPTokensV1_1 amendment]: /resources/known-amendments.md#priceoracle
|
||||||
|
|||||||
@@ -54,7 +54,7 @@ Clawback is disabled by default. To use clawback, you must send an [AccountSet t
|
|||||||
|
|
||||||
## Error Cases
|
## Error Cases
|
||||||
|
|
||||||
Besides errors that can occur for all transactions, `AMMClawback` transactions can result in the following [transaction result codes](https://xrpl.org/docs/references/protocol/transactions/transaction-results):
|
Besides errors that can occur for all transactions, `AMMClawback` transactions can result in the following [transaction result codes](../transaction-results/index.md):
|
||||||
|
|
||||||
| Error Code | Description |
|
| Error Code | Description |
|
||||||
|:-------------------|:------------|
|
|:-------------------|:------------|
|
||||||
|
|||||||
@@ -38,7 +38,7 @@ There are no flags defined for {% $frontmatter.seo.title %} transactions.
|
|||||||
|
|
||||||
## Error Cases
|
## Error Cases
|
||||||
|
|
||||||
Besides errors that can occur for all transactions, {% $frontmatter.seo.title %} transactions can result in the following [transaction result codes](https://xrpl.org/docs/references/protocol/transactions/transaction-results):
|
Besides errors that can occur for all transactions, {% $frontmatter.seo.title %} transactions can result in the following [transaction result codes](../transaction-results/index.md):
|
||||||
|
|
||||||
| Error Code | Description |
|
| Error Code | Description |
|
||||||
|:--------------|:---------------------------------------------|
|
|:--------------|:---------------------------------------------|
|
||||||
|
|||||||
@@ -48,7 +48,7 @@ There are no flags defined for {% $frontmatter.seo.title %} transactions.
|
|||||||
|
|
||||||
## Error Cases
|
## Error Cases
|
||||||
|
|
||||||
Besides errors that can occur for all transactions, {% $frontmatter.seo.title %} transactions can result in the following [transaction result codes](https://xrpl.org/docs/references/protocol/transactions/transaction-results):
|
Besides errors that can occur for all transactions, {% $frontmatter.seo.title %} transactions can result in the following [transaction result codes](../transaction-results/index.md):
|
||||||
|
|
||||||
| Error Code | Description |
|
| Error Code | Description |
|
||||||
|:--------------------------|:------------|
|
|:--------------------------|:------------|
|
||||||
|
|||||||
Reference in New Issue
Block a user