> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# قائمة عناوين المحافظ: دفتر عناوين Travel Rule

> اسرد إدخالات دفتر عناوين المحافظ التي تعتمد عليها تحويلات Travel Rule الواردة عبر مسار INTERNAL في Didit، مع حالة التحقق من الملكية.

موجّه API لسرد عناوين المحافظ
نسخ الموجّه إلى الحافظة

<pre>
  \`List the application's Travel Rule wallet address book - the registry of wallets you control that inbound INTERNAL-rail transfers resolve against.

  Endpoint:
  GET [https://verification.didit.me/v3/travel-rule/wallet-addresses/](https://verification.didit.me/v3/travel-rule/wallet-addresses/)

  Authentication:
  Use the x-api-key header with my Didit API key.

  Query parameters:

  * limit / offset - pagination; count/next/previous describe the page window.

  What to read from each entry:

  * uuid - the entry id, used in PATCH/DELETE /v3/travel-rule/wallet-addresses/{entry_uuid}/.
  * address, chain - the registered wallet.
    When a transfer names a chain, sunrise registration, the INTERNAL rail and the outbound TRP travel-address lookup match an entry only when its chain equals the transfer's chain (case-insensitive) or the entry's chain is blank.
    Chain names are not translated, so an entry with chain "ethereum" does not match a transfer with chain "ETH".
    Inbound TRP inquiries and ownership confirmation ignore the chain and match by address (an inbound TRP inquiry that carries no address matches a verified entry by holder\_name instead).
  * holder\_name / holder\_vendor\_data / entity\_type - the wallet holder, used for the beneficiary name match.
  * travel\_address - the counterparty VASP's travel address for this wallet, when known; it lets outbound transfers of an asset TRP carries (BTC, ETH, and USDC on a named network) to this wallet route over TRP.
  * is\_ownership\_verified - whether control of this address has been proven (wallet-ownership widget or self-declaration). Verified entries let inbound transfers skip UNCONFIRMED\_OWNERSHIP.

  Full guide: /transaction-monitoring/travel-rule#wallet-address-book.\`
</pre>

الصق في


## OpenAPI

````yaml ar/openapi-25.json GET /v3/travel-rule/wallet-addresses/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/travel-rule/wallet-addresses/:
    get:
      tags:
        - Travel Rule
      summary: عرض قائمة بإدخالات دفتر عناوين المحافظ
      description: >-
        قائمة مقسمة إلى صفحات لدفتر عناوين محافظ Travel Rule لتطبيقك، الأحدث
        أولاً.
      operationId: listTravelRuleWalletAddresses
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            minimum: 1
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
      responses:
        '200':
          description: مدخلات دفتر عناوين المحافظ مقسّمة إلى صفحات.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type: string
                    nullable: true
                  previous:
                    type: string
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/WalletAddressEntry'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            https://verification.didit.me/v3/travel-rule/wallet-addresses/ \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            for item in client.travel_rule.wallet_addresses.list():
                print(item)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY.
            const didit = new Didit();

            for await (const item of didit.travelRule.walletAddresses.list()) {
              console.log(item);
            }
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.TravelRule.WalletAddresses.ListAutoPaging(ctx, didit.TravelRuleWalletAddressesListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY.
            Didit client = new Didit();

            for (var item : client.travelRule().walletAddresses().list()) {
                System.out.println(item);
            }
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            foreach ($didit->travelRule->walletAddresses->list() as $item) {
                print_r($item->toArray());
            }
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            didit.travel_rule.wallet_addresses.list.auto_paging_each do |item|
              puts item.to_h
            end
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            await foreach (var item in await
            client.TravelRule.WalletAddresses.ListAsync())

            {
                Console.WriteLine(JsonSerializer.Serialize(item));
            }
components:
  schemas:
    WalletAddressEntry:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        address:
          type: string
          description: >-
            عنوان المحفظة؛ القيمة `""` لمدخل تم استيراده بواسطة التجزئة (hash)
            فقط. فريد لكل تطبيق وسلسلة وmemo، مع مقارنة العنوان دون مراعاة حالة
            الأحرف. بعد حذف أحد المدخلات، يمكنك تسجيل نفس العنوان مرة أخرى.
        chain:
          type: string
          description: >-
            رمز الشبكة للعنوان، مثل `ETH` أو `BTC`. عندما تقوم Didit بتوجيه
            تحويل أو تسجيله، فإنها تطابق مدخلات دفتر العناوين بناءً على عنوان
            المحفظة، وعندما يتضمن التحويل شبكة، تطابق هذه القيمة أيضاً بغض النظر
            عن حالة الأحرف. شبكة التحويل هي `beneficiary_data.chain`، وتُملأ من
            شبكة العملات المشفرة للمعاملة أو رمز العملة (مثل `ETH`) عندما لا
            ترسلها بنفسك، أو من `chain` لتسجيل ما بعد الإيداع، لذا استخدم الرمز
            نفسه في كل مكان. المدخلة ذات الشبكة الفارغة تطابق أي شبكة. يُخزن
            المستفيد من Lightning (معرّف العقدة أو Lightning Address) المسجل على
            bitcoin بأحرف صغيرة تحت `LIGHTNING`، حيث تتم مطابقة تحويلات
            Lightning. يتم تخزين الشبكات المعروفة تحت معرّف معياري واحد بغض
            النظر عن طريقة كتابتها في الإرسال: يتم تخزين "ethereum" و"Ethereum"
            و"ERC20" كـ ETH، و"BNB Smart Chain" و"BEP20" كـ BNB، و"tron" كـ TRX.
            أما اسم الشبكة غير المعروف فيُحتفظ به كما هو وارد.
        holder_vendor_data:
          type: string
          description: معرّفك الداخلي للحائز.
        holder_name:
          type: string
          description: اسم صاحب المحفظة، يُستخدم لمطابقة اسم المستفيد.
        entity_type:
          type: string
          description: نص حر، القيمة الافتراضية هي "individual".
        is_ownership_verified:
          type: boolean
          description: للقراءة فقط. ما إذا كان قد تم إثبات ملكية هذا العنوان.
        created_at:
          type: string
          format: date-time
        travel_address:
          type: string
          description: >-
            Travel Address الخاص بـ VASP الطرف المقابل لهذه المحفظة، إن كان
            معلوماً. يتيح لـ Didit توجيه تحويلات هذا المستفيد عبر مسار TRP،
            للأصول التي يدعمها TRP (وهي BTC وETH وUSDC على شبكة مُسمّاة).
        address_hash:
          type: string
          description: >-
            للقراءة فقط. تجزئة SHA-256 للعنوان بالأحرف الصغيرة، بنظام hex ذي
            الأحرف الصغيرة. يتم مطابقة الإدخال المستورد عبر تجزئته فقط عليه.
        memo:
          type: string
          description: >-
            علامة الوجهة (destination tag) أو المذكرة (memo) التي تشكل جزءًا من
            المحفظة على شبكة تستخدم المذكرات (XRP وXLM وEOS وATOM وHBAR)؛ القيمة
            `""` للعنوان بأكمله. لا يطابق الإدخال الذي يحتوي على مذكرة سوى
            التحويلات التي تحدد تلك المذكرة؛ بينما يطابق الإدخال الذي لا يحتوي
            عليها العنوان بأكمله.
        receiving_travel_address:
          type: string
          readOnly: true
          description: >-
            Travel Address الخاص بك لكل محفظة لهذه المحفظة: قدّمه إلى الـ VASP
            المُرسِل لكي يحدد استعلام TRP الخاص به هذه المحفظة. يكون فارغاً
            للمحفظة المسجلة على أنها تابعة لـ VASP آخر، وطالما أن Travel Rule
            معطل، وقبل حفظ ملف تعريف VASP الخاص بك.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console.
        يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا
        شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات
        المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن
        المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم
        إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو
        الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير
        404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة
        بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL
        للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك
        إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.