Skip to content

Commit

Permalink
Merge pull request #26 from erechorse/nip-02
Browse files Browse the repository at this point in the history
Translate NIP-02
  • Loading branch information
erechorse authored Nov 17, 2023
2 parents 394029d + 50ad245 commit 15c04c6
Showing 1 changed file with 20 additions and 20 deletions.
40 changes: 20 additions & 20 deletions 02.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
NIP-02
======

Contact List and Petnames
連絡先リストと愛称
-------------------------

`final` `optional` `author:fiatjaf` `author:arcbtc`

A special event with kind `3`, meaning "contact list" is defined as having a list of `p` tags, one for each of the followed/known profiles one is following.
「連絡先リスト」を意味するkind `3`の特別なイベントは、フォローしている/既知のプロフィールごとの`p`タグのリストを持つものとして定義されます。

Each tag entry should contain the key for the profile, a relay URL where events from that key can be found (can be set to an empty string if not needed), and a local name (or "petname") for that profile (can also be set to an empty string or not provided), i.e., `["p", <32-bytes hex key>, <main relay URL>, <petname>]`. The `content` can be anything and should be ignored.
タグの個々の要素は、プロフィールの鍵・その鍵からのイベントを発見できるリレーのURL (必要なければ空文字列で設定可能です) ・そのプロフィールのローカル名 (あるいは「愛称」) (空文字列が設定されるか、提供されないようできます) を含むべきで、つまり`["p", <32-bytes hex key>, <main relay URL>, <petname>]`です。`content`は何でもかまいませんが、無視されるべきです。

For example:
:

```json
{
Expand All @@ -25,50 +25,50 @@ For example:
}
```

Every new contact list that gets published overwrites the past ones, so it should contain all entries. Relays and clients SHOULD delete past contact lists as soon as they receive a new one.
新しい子連絡先リストが公開されるたびに過去のものは上書きされるので、すべての要素を含むべきです。リレーとクライアントは新しいものを受け取ったら速やかに過去の連絡先リストを削除すべきです (SHOULD) 。

## Uses
## 用途

### Contact list backup
### 連絡先リストのバックアップ

If one believes a relay will store their events for sufficient time, they can use this kind-3 event to backup their following list and recover on a different device.
リレーがイベントを十分な期間保存すると信じているなら、このkind 3イベントを使ってフォローリストをバックアップし、別のデバイスで復元できます。

### Profile discovery and context augmentation
### プロフィールの発見とコンテキストの拡張

A client may rely on the kind-3 event to display a list of followed people by profiles one is browsing; make lists of suggestions on who to follow based on the contact lists of other people one might be following or browsing; or show the data in other contexts.
クライアントは、ブラウジングしているプロフィールがフォローしている人のリストを表示したり、フォローまたはブラウジングしている人の連絡先リストに基づいて誰をフォローするかの提案リストを作成したり、他のコンテキストでデータを表示したりするためにkind 3イベントを頼りにしてもかまいません。

### Relay sharing
### リレーの共有

A client may publish a full list of contacts with good relays for each of their contacts so other clients may use these to update their internal relay lists if needed, increasing censorship-resistance.
クライアントは連絡先の完全なリストともにそれぞれの連絡先のために適したリレーを公開してもよく、これによりほかのクライアントは必要に応じてこれを内部のリレーリストの更新に使うことができ、検閲耐性が高まります。

### Petname scheme
### 愛称スキーム

The data from these contact lists can be used by clients to construct local ["petname"](http://www.skyhunter.com/marcs/petnames/IntroPetNames.html) tables derived from other people's contact lists. This alleviates the need for global human-readable names. For example:
連絡先リストからのデータは、クライアントによってほかの人々の連絡先リストから派生したローカルの["petname"](http://www.skyhunter.com/marcs/petnames/IntroPetNames.html)テーブルを構築するために用いることができます。これにより、グローバルな人間が読める名前の必要性が軽減されます。例えば:

A user has an internal contact list that says
ユーザーは次のような内部の連絡先リストを持っています。

```json
[
["p", "21df6d143fb96c2ec9d63726bf9edc71", "", "erin"]
]
```

And receives two contact lists, one from `21df6d143fb96c2ec9d63726bf9edc71` that says
そして、次のように2つの連絡先リストを受け取り、1つは`21df6d143fb96c2ec9d63726bf9edc71`からです。

```json
[
["p", "a8bb3d884d5d90b413d9891fe4c4e46d", "", "david"]
]
```

and another from `a8bb3d884d5d90b413d9891fe4c4e46d` that says
もう1つは`a8bb3d884d5d90b413d9891fe4c4e46d`からです。

```json
[
["p", "f57f54057d2a7af0efecc8b0b66f5708", "", "frank"]
]
```

When the user sees `21df6d143fb96c2ec9d63726bf9edc71` the client can show _erin_ instead;
When the user sees `a8bb3d884d5d90b413d9891fe4c4e46d` the client can show _david.erin_ instead;
When the user sees `f57f54057d2a7af0efecc8b0b66f5708` the client can show _frank.david.erin_ instead.
ユーザーが`21df6d143fb96c2ec9d63726bf9edc71`を見るとき、クライアントは代わりに _erin_ を表示できます。
ユーザーが`a8bb3d884d5d90b413d9891fe4c4e46d`を見るとき、クライアントは代わりに _david.erin_ を表示できます。
ユーザーが`f57f54057d2a7af0efecc8b0b66f5708`を見るとき、クライアントは代わりに _frank.david.erin_ を表示できます。

0 comments on commit 15c04c6

Please sign in to comment.