Kimlik belgesi durumu köprüsü nedir ve başka bir zincirdeki sözleşmenin neden ona ihtiyacı olur

Başka bir zincirdeki akıllı sözleşme Solidus'taki bir kimlik belgesini göremez, bu yüzden tek bir sorunun cevabını kopya olarak almaya ihtiyaç duyar: belge hâlâ geçerli mi? Bu sayfa o cevabı taşıyan köprüyü anlatır: neyi taşıdığını, neyi geride bıraktığını ve bir durumun nasıl yol aldığını.

Sorun, tam olarak

Solidus'ta düzenlenen bir kimlik belgesi Solidus'ta yaşar. Ethereum Sepolia üzerindeki bir akıllı sözleşme onu göremez. Bir sözleşme yalnızca kendi zincirini okur. Başka bir zinciri çağıramaz ve bir sunucuya soramaz.

Dolayısıyla "bu işlevi yalnızca bu belgenin sahipleri çağırabilir" demek isteyen bir sözleşmenin okuyacağı hiçbir şey yok.

Belgeyi bir kez karşıya kopyalamak sorunu çözmez. Bir belge değişir. Belgeyi veren onu iptal edebilir. Süresi dolabilir. Geçen hafta alınmış bir kopya, dün iptal edilmiş bir belge için hâlâ "geçerli" der.

Sözleşmenin tek bir şeye ihtiyacı var: kendi zincirinde saklanan, "bu belge şu anda geçerli mi?" sorusunun cevabı. Sahibi hiçbir şey yapmadan güncel kalan bir cevap. Kimlik belgesi durumu köprüsü budur. Belgeyi değil durumu kopyalar ve kopyayı taze tutar.

Neyi taşır, neyi geride bırakır

Bir durum mesajı şu alanları taşır:

• Bir durum: etkin, iptal edilmiş, süresi dolmuş ya da bağı kaldırılmış (active, revoked, expired, unbound).
• Bir son kullanma zamanı, Unix zamanı olarak. Sıfır, süresiz demektir.
• Belgeyi verenin hash'i. Verenin DID'inin hash'idir, DID'in kendisi değil.
• Belge türünün hash'i. Türün adının hash'idir.
• Sahip anahtarı. Hedef zincirdeki bir adrestir: bir EVM adresi ya da bir Solana genel anahtarı.

Üç öğe daha kayıt tutar. Bir aktarım kimliği bu tek aktarımı adlandırır. Bir hash'tir ve her zincirde farklıdır, yani bir belgenin her yerde farklı bir kimliği vardır. Bir bayrak, belgeyi verenin şu anda yetkili olup olmadığını söyler. Bir başlık, sıra numarasını ve Solidus blok yüksekliğini taşır. Mesajın tamamı 156 bayttır.

Geride kalanlar: sahibin DID'i, belgeyi verenin DID'i, belgenin içindeki her beyan ve her doküman. Hiçbiri mesajda bir alan değildir, bu yüzden hiçbiri hedef zincire ulaşamaz.

Hash'lerle ilgili bir olgu burada önemli. Bir hash, tahmin edilebilen hiçbir şeyi gizlemez ve belge veren de belge türü de azdır. Herkes olası olanları hash'leyip karşılaştırabilir. Yani hedef zincir, belirli bir adresin belirli bir verenden belirli bir türde belgeye sahip olduğunu öğrenir. Bu bağ herkese açıktır ve kalıcıdır. Sahibin her aktarım için bir onay mesajı imzalamasının nedeni budur. Solidus da onay imzası geçersiz ya da süresi dolmuş bir aktarımı reddeder.

Bir durum nasıl yol alır

1. Solidus bir mesajı kuyruğa alır. Belgeyi veren bir belgeyi bir zincire aktardığında ya da iptal ettiğinde, Solidus aynı blokta bir durum mesajı kaydeder. Mesaj, o zincir için bir sonraki sıra numarasını taşır. Bir iptal, belgenin etkin olduğu her zincir için bir mesaj kuyruğa alır.
2. Doğrulayıcılar imzalar. Blok kesinleştikten sonra dört Solidus doğrulayıcısının her biri mesajı kendi tasdik anahtarıyla imzalar. İmza hedef zinciri ve sıra numarasını kapsar; bu yüzden Sepolia için atılmış bir imza Fuji'de işe yaramaz.
3. Bir ağ geçidi iletir. Bizim ağ geçidimiz imzaları toplar ve mesajı ayna sözleşmesine gönderir. Ayna, hedef zincirde kimlik belgesi durumunu saklayan bir sözleşmedir. Bu adımı herkes yapabilir. İmzalar herkese açıktır ve ayna, mesajı her çağıran adresten kabul eder.
4. Ayna önce denetler, sonra saklar. Tam olarak bir sonraki sıra numarasını ister; böylece bir iptal atlanamaz. Her imzalayanı imzalardan çıkarır ve yeterli sayıda geçerli imza arar. 2026-10-08 tarihinde API, 4 doğrulayıcıdan 3'ü için bir eşik bildirdi. Ardından kaydı saklar.
5. Bir sözleşme kapıya sorar. Kapı, entegrasyon yapanın çağırdığı küçük bir kütüphanedir. Ya tamam der ya da bir gerekçe verir: aktarım yok, etkin değil, belge veren yetkili değil, süresi dolmuş ya da bayat. Solidus ayrıca zamanlanmış aralıklarla bir kalp atışı gönderir ve çağıran taraf bir kalp atışının en fazla ne kadar eski olabileceğini belirler. İletim durursa kapı "bayat" döner ve kapanır.

Her adımda neye güvendiğiniz güvenlik sayfasında yazıyor. Zincir başına canlı sağlık durumu durum sayfasında.

Tek komutla görün

Köprü API'si her hedefi listeler. Bu çalıştırma cevabı her zincirin anahtarına ve alanına (domain) indirger. Alan, Solidus'un zincir için kullandığı kimliktir. Üç EVM zincirinde zincir kimliğine eşittir.

curl -sL https://bridge.solidus.network/v1/routes | jq -c '.chains[] | {key, domain}'
# {"key":"sepolia","domain":11155111}
# {"key":"fuji","domain":43113}
# {"key":"arc","domain":5042002}
# {"key":"solana","domain":1399811151}

Bu çıktı 2026-10-08 tarihlidir. Dört zincir Ethereum Sepolia, Avalanche Fuji, Arc test ağı ve Solana devnet'tir. Dördü de test ağıdır. Tam yanıt ayrıca her zincirdeki ayna sözleşmesinin adresini de listeler.

Durumu kendi sözleşmenizden okumak için veriyi görmeden bir koşulu denetleyin sayfasına gidin. Bir imzanın başka bir zincirde neden yeniden kullanılamayacağını görmek için hedef, imzalanan şeyin içindedir sayfasına bakın. Entegrasyon adımları geliştiriciler sayfasında, kısa cevaplar SSS sayfasında.