المخططات

يُعرّف المخطط البنية وقواعد التحقق لبيانات الاعتماد في نظام شهادات سولانا. تعمل المخططات كقوالب تحدد الحقول التي يجب أن تحتويها بيانات الاعتماد وكيفية تنسيقها. يرتبط كل مخطط بنوع بيانات اعتماد ويمكن إصداره بنسخ متعددة لدعم تطور بنية البيانات.

البنية

يمثل هيكل Schema مخططاً في نظام شهادات سولانا. يحدد كل مخطط قالباً لبيانات الاعتماد التي يمكن إنشاؤها تحته.

تعريفات الأنواع

Schema

export type Schema = {
  discriminator: number; // Internal discriminator
  credential: Address; // Associated credential address
  name: ReadonlyUint8Array; // Schema name
  description: ReadonlyUint8Array; // Schema description
  layout: ReadonlyUint8Array; // Schema layout definition
  fieldNames: ReadonlyUint8Array; // Names of fields in the schema
  isPaused: boolean; // Pause status
  version: number; // Schema version
};

الدوال

جلب المخططات

التسلسل

أمثلة الاستخدام

جلب مخطط واحد

const schema = await fetchSchema(rpc, schemaAddress);
console.log("Schema name:", schema.name);

جلب مخططات متعددة

const schemas = await fetchAllSchema(rpc, [schema1Address, schema2Address]);
schemas.forEach((schema) => console.log("Schema:", schema.name));

الجلب الآمن

const schema = await fetchMaybeSchema(rpc, schemaAddress);
if (schema) {
  console.log("Schema found:", schema.name);
} else {
  console.log("Schema not found");
}

أنواع بيانات تخطيط المخطط

يستخدم حقل layout قيمًا رقمية لتحديد أنواع البيانات لكل حقل في المخطط:

مثال على الاستخدام

على سبيل المثال، تخطيط [12, 0, 12] سيحدد ثلاثة حقول: نص String، يتبعه عدد صحيح U8، ثم نص String آخر. يوفر مصفوفة fieldNames أسماءً قابلة للقراءة البشرية تتوافق موضعياً مع كل قيمة في التخطيط، لذا مع أسماء الحقول ["name", "age", "country"]، سيتم تسمية حقل String الأول بـ "name"، وحقل U8 سيكون "age"، وحقل String الثاني سيكون "country".

فيما يلي مثال على كيفية استخدامها عند إنشاء Schema:

const createSchemaInstruction = getCreateSchemaInstruction({
  authority,
  payer,
  credential: credentialPda,
  schema: schemaPda,
  name: "Test Schema",
  description: "Just an example",
  fieldNames: ["name", "age", "country"],
  layout: Buffer.from([12, 0, 12])
});

ملاحظات مهمة

• يُستخدم حقل discriminator داخلياً ولا ينبغي تعديله
• يربط حقل credential المخطط بنوع بيانات الاعتماد المرتبط به
• يمكن استخدام isPaused لتعطيل استخدام المخطط مؤقتاً
• يسمح حقل version بتطوير المخطط مع الحفاظ على التوافق العكسي
• يحدد layout و fieldNames بنية بيانات الاعتماد باستخدام هذا المخطط
• يجب ترميز/فك ترميز جميع حقول مصفوفة البايتات (name، description، layout، fieldNames) بشكل صحيح وفقاً لاحتياجات تطبيقك