Şemalar

Bir şema, Solana Onaylama Sistemi'ndeki kimlik bilgileri için yapı ve doğrulama kurallarını tanımlar. Şemalar, bir kimlik bilgisinin hangi alanları içermesi gerektiğini ve nasıl biçimlendirilmesi gerektiğini belirten şablonlar olarak hizmet eder. Her şema bir kimlik bilgisi türüyle ilişkilendirilir ve veri yapısının evrimini desteklemek için sürümlenebilir.

Yapı

Schema yapısı, Solana Onaylama Sistemi'ndeki bir şemayı temsil eder. Her şema, altında oluşturulabilecek kimlik bilgileri için bir şablon tanımlar.

Tür Tanımlamaları

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
};

Metodlar

Şemaları Çekme

Serileştirme

Kullanım Örnekleri

Tek Bir Şema Getirme

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

Birden Fazla Şema Getirme

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

Güvenli Getirme

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

Şema Düzeni Veri Tipleri

layout alanı, şemadaki her alan için veri tiplerini belirtmek üzere sayısal değerler kullanır:

Örnek Kullanım

Örneğin, [12, 0, 12] düzeni üç alan tanımlar: bir String, ardından bir U8 tam sayısı, ardından başka bir String. fieldNames dizisi, her düzen değerine konumsal olarak karşılık gelen okunabilir isimler sağlar, dolayısıyla ["name", "age", "country"] alan adlarıyla, ilk String alanı "name" olarak, U8 alanı "age" olarak ve ikinci String alanı "country" olarak adlandırılır.

Bir Schema oluştururken bunların nasıl kullanılacağına dair bir örnek:

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])
});

Önemli Notlar

• discriminator alanı dahili olarak kullanılır ve değiştirilmemelidir
• credential alanı, şemayı ilişkili kimlik bilgisi türüne bağlar
• isPaused, şema kullanımını geçici olarak devre dışı bırakmak için kullanılabilir
• version alanı, geriye dönük uyumluluğu korurken şema evrimine izin verir
• layout ve fieldNames, bu şemayı kullanan kimlik bilgilerinin yapısını tanımlar
• Tüm bayt dizisi alanları (name, description, layout, fieldNames), uygulamanızın ihtiyaçlarına göre düzgün şekilde kodlanmalı/çözülmelidir