الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
تم تصميم هذه التوثيقات لتُستهلك من قبل أدوات الذكاء الاصطناعي وكذلك البشر. إذا كنت تقوم بالبناء باستخدام عامل ترميز (Claude Code, Cursor, Windsurf, Continue، إلخ) أو تقوم بـ RAG على التوثيقات، فإن الأسطح أدناه تتيح لك دمج توثيق Raydium دون الحاجة إلى أي كشط مخصص.

ما هو متاح

السطحنمط URLاستخدم عندما
خادم MCPhttps://docs.raydium.io/mcpتريد لمحرر الذكاء الاصطناعي لديك (Claude Code, Cursor, Windsurf، إلخ) الاستعلام والاستشهاد بتوثيق Raydium بشكل أصلي.
فهرس llms.txthttps://docs.raydium.io/llms.txtتقوم ببناء خط أنابيب RAG وتحتاج إلى فهرس مسطح لكل صفحة.
نص llms-full.txthttps://docs.raydium.io/llms-full.txtتريد المتن الكامل كملف واحد متسلسل للفهرسة دون الاتصال.
قائمة النسخ لكل صفحةزر نسخ الصفحة في أعلى كل صفحة محتوىتقوم بلصق صفحة واحدة في محادثة مع LLM.
روابط عميقة لكل صفحةعرض كملف Markdown، فتح في ChatGPT، فتح في Claude، فتح في Cursor، فتح في VS Codeنقل بنقرة واحدة من صفحة توثيق إلى الأداة التي تختارها.
يقع زر نسخ الصفحة وقائمة الروابط العميقة في أعلى يمين كل صفحة (بجانب عنوان الصفحة). كلاهما مدعوم من قبل قائمة السياق في منصة التوثيق.

خادم MCP

يسمح خادم MCP (نموذج بروتوكول السياق) لعملاء الذكاء الاصطناعي الاستعلام عن توثيق Raydium كأداة. بمجرد التكوين، يمكن لعاملك أن يسأل “ابحث في توثيق Raydium عن معاملات addLiquidity” والحصول على إجابات موثوقة مع الاستشهادات.

Claude Code

claude mcp add --transport http raydium-docs https://docs.raydium.io/mcp
بعد الإضافة، اطلب من Claude Code البحث في توثيق Raydium عن X وسيستخدم الأداة.

Cursor

أضف إلى إعدادات Cursor الخاصة بك (Cmd/Ctrl + , → MCP):
{
  "mcpServers": {
    "raydium-docs": {
      "url": "https://docs.raydium.io/mcp"
    }
  }
}

Windsurf, Continue, والعملاء العموميون

أي عميل متوافق مع MCP يمكنه الإشارة إلى https://docs.raydium.io/mcp. إذا كان عميلك يتطلب بيان قائمة، فهو متوفر على https://docs.raydium.io/mcp/.well-known/mcp.json.

ما يكشفه الخادم

يكشف خادم MCP توثيق Raydium عن أداة أساسية واحدة، search_docs(query: string)، والتي تعيد أعلى المقاطع المصنفة للاستعلام جنبًا إلى جنب مع عناوين URL الأساسية الخاصة بهم. العامل مسؤول عن الاستشهاد بـ URL الذي استخدمه؛ لا نتتبع أو نحد المعدل لكل عامل.

llms.txt لـ RAG

llms.txt هو معيار ناشئ لـ “فهرس التوثيق الذي يمكن قراءته آليًا”. تنشر Raydium:
  • https://docs.raydium.io/llms.txt — قائمة مسطحة لكل صفحة مع عنوان وملخص سطر واحد، منظمة حسب الفصل.
  • https://docs.raydium.io/llms-full.txt — متن Markdown الكامل لكل صفحة، مسلسلة، مع الحفاظ على حدود الصفحات كعناوين.
يتم إعادة إنشاء المتغير full في كل نشر توثيق. قم بسحبه على جدول زمني (يومي كافي) أو جلبه عند الطلب.
# أسقط المتن الكامل في خط أنابيب RAG الخاص بك.
curl -sSL https://docs.raydium.io/llms-full.txt -o raydium-docs.md

قائمة نقل لكل صفحة

لكل صفحة محتوى قائمة سياق (أعلى يمين، بجانب العنوان) مع إجراءات النقر الواحد التالية:
  • نسخ — نسخ الصفحة كـ Markdown عادي.
  • عرض كملف Markdown — افتح .md المصدر في علامة تبويب جديدة حتى تتمكن من حفظه.
  • فتح في ChatGPT / Claude / Perplexity — حمّل محتوى الصفحة مسبقًا في موجه محادثة للأداة المسماة.
  • فتح في Cursor / VS Code — افتح مخزن مؤقت في محرر الأسماء مع محتوى الصفحة.
هذا هو السطح الصحيح عندما تريد طرح سؤال على نموذج حول صفحة واحدة دون إعداد MCP.

ملفات السياق المعدة مسبقًا لعوامل الترميز

إذا كنت تدمج Raydium وتريد لعاملك أن يحصل على المعرفة الأساسية الصحيحة من البداية، فأسقط هذه الملفات في مشروعك:

.cursorrules / .windsurfrules / موجه النظام

You are integrating with Raydium, a Solana DeFi protocol with five product
surfaces: AMM v4, CPMM, CLMM, Farm, and LaunchLab. Authoritative docs live
at docs.raydium.io. The official SDK is `@raydium-io/raydium-sdk-v2` (pin
the version you've verified against). For server-built swaps, prefer the
Trade API at transaction-v1.raydium.io. Always:

- Pass a `Connection` and `cluster` that match.
- Keep all amounts as `BN` instances; never call `.toNumber()` on amounts.
- Pre-fund the user's wallet for ATA creation rent.
- Pass an explicit `computeBudgetConfig` for any tx that may compete in
  high-volume windows.
- Re-fetch `poolInfo` immediately before high-value transactions; cached
  state goes stale.

When uncertain about an instruction's accounts list, defer to
`docs.raydium.io/products/<product>/accounts` and the on-chain IDL.
احفظ باسم .cursorrules (Cursor)، أو .windsurfrules (Windsurf)، أو CLAUDE.md (Claude Code) — أو الصق في موجه النظام الخاص بعاملك. يختلف الاسم الدقيق والموقع حسب إصدار الأداة، لذا تحقق من وثائق إعدادات أداتك إذا لم تلتقط الملف تلقائيًا.

قائمة السياق المثبتة

لعوامل الترميز التي تقبل قائمة صفحات “يجب تضمينها دائمًا”، هذه القائمة هي الحد الأدنى من السياق المفيد لمعظم تكاملات Raydium:
https://docs.raydium.io/sdk-api/typescript-sdk
https://docs.raydium.io/sdk-api/trade-api
https://docs.raydium.io/products/cpmm/instructions
https://docs.raydium.io/products/clmm/instructions
https://docs.raydium.io/integration-guides/priority-fee-tuning
https://docs.raydium.io/reference/program-addresses
https://docs.raydium.io/reference/error-codes
اضبط بناءً على المنتجات التي تقوم بدمجها.

وصفة الفهرسة

إذا كنت تقوم ببناء RAG خاص بك ولا تريد استخدام llms-full.txt، فإليك الوصفة الأساسية:
import { fetch } from "undici";

const INDEX_URL = "https://docs.raydium.io/llms.txt";
const BASE      = "https://docs.raydium.io";

const index    = await (await fetch(INDEX_URL)).text();
const pageUrls = [...index.matchAll(/^- \[(.+?)\]\((.+?)\)/gm)].map(m => m[2]);

for (const path of pageUrls) {
  const md = await (await fetch(`${BASE}${path}.md`)).text();
  // ingest md into your vector store, keyed by path
}
يتم تقديم كل صفحة في مسارها الأساسي مع إضافة لاحقة .md (على سبيل المثال /sdk-api/typescript-sdk/sdk-api/typescript-sdk.md).

تحذيرات

  • لا تلصق الحالة الخاصة في الموجهات. يعرف خادم MCP فقط ما هو موجود في التوثيق العام. مفاتيح المحفظة وبيانات اعتماد RPC والأسرار المماثلة لا يجب أن تدخل أبدًا سياق العامل.
  • مخرجات الذكاء الاصطناعي ليست موثوقة. تهلوس النماذج عناوين البرامج وأسماء التعليمات وقوائم الحسابات بسهولة مثيرة للقلق. تحقق دائمًا من التوثيق والـ IDL قبل الوثوق بمعاملات يتم إنشاؤها بواسطة العامل.
  • انجراف الإصدار. SDK v2 قبل 1.0؛ قد تصدر العوامل المدربة على الإصدارات الأقدم رمزًا لا يتم تجميعه ضد الإصدار المثبت لديك. أدرج إصدار SDK المثبت في موجه النظام الخاص بعاملك.

المؤشرات

المصادر: