Skip to Content
SDKOverview

SDK’ya Genel Bakış

Solidus SDK, Solidus Network ile etkileşim kurmak için bir TypeScript paketleri kümesidir. Birkaç fonksiyon çağrısıyla DID oluşturun, kimlik bilgisi düzenleyin ve doğrulayın, kullanıcıları kimlik doğrulamasından geçirin.

Paketler

PaketnpmAçıklama
@solidus-network/sdknpmAna SDK — DID işlemleri, kimlik bilgisi düzenleme/doğrulama, kimlik doğrulama meydan okumaları
@solidus-network/authnpmKimlik doğrulama ilkelleri — DID tabanlı kimlik doğrulama için meydan okuma-yanıt protokolü
@solidus-network/auth-otpnpmSMS/e-posta tek kullanımlık kod girişi çekirdeği — sıfır bağımlılık, enjekte edilen saat/RNG/depo/gönderici. E-posta bugün çalışıyor; henüz SMS bağdaştırıcısı yayınlanmadı
@solidus-network/typesnpmTüm paketler arasında paylaşılan TypeScript tip tanımları
@solidus-network/bbsnpmBBS+ seçici ifşa ilkelleri — IRTF draft-irtf-cfrg-bbs-signatures, BLS12-381 SHA-256. Zincirle bayt uyumlu
@solidus-network/jwt(yayınlanmadı)JWT araçları — Ed25519 anahtarlarıyla imzalama, doğrulama, çözme

Ajan kimliği

Yapay zeka ajanları için taşınabilir kimlik. Yukarıdaki çekirdek SDK’dan ayrıdır — insan kimlik bilgilerini düzenlemek veya doğrulamak için bunlara ihtiyacınız yoktur.

PaketnpmAçıklama
@solidus-network/agent-identitynpmYapay zeka ajanları için did:solidus DID’leri, BBS+ seçici ifşa kimlik bilgileri ve ERC-8004 pasaport bağlama
@solidus-network/agent-identity-verifynpmSık çalışan yol doğrulayıcısı — çevrimdışı BBS+ kanıt doğrulaması + önbelleğe alınan, hataya kapalı bir OAuth Status List iptal kontrolü
@solidus-network/agent-identity-reactnpmReact bileşenleri — Solidus Onaylı rozeti, ajan pasaport kartı, yetkilendirme onayı istemi

Kimlik yakalama

Solidus Verify tarafından kullanılan, tarayıcı tarafında belge yakalama ve çıkarma.

PaketnpmAçıklama
@solidus-network/capturenpmGömülebilir web kimlik-yakalama SDK’sı — kalite denetimli, cihaz üzerinde MRZ/barkod çıkarmalı rehberli kamera yakalama
@solidus-network/id-extractnpmİstemci tarafı (WASM) çıkarma — barkod okuma, MRZ OCR, sağlama toplamı yeniden oluşturma, güven eşiği. Çatısız (framework-free)

Kurulum

npm install @solidus-network/sdk @solidus-network/auth @solidus-network/types

Veya başka paket yöneticileriyle:

pnpm add @solidus-network/sdk @solidus-network/auth @solidus-network/types
yarn add @solidus-network/sdk @solidus-network/auth @solidus-network/types

SDK Modları

SDK, istemciyi oluştururken mode seçeneğiyle kontrol edilen üç çalışma modunu destekler.

ModArka uçKullanım alanı
stubYerel Postgres veritabanıYerel geliştirme ve test — ağ çağrısı yok
testnetrpc.solidus.network’e JSON-RPCCanlı testnet’e karşı entegrasyon testi
mainnetMainnet’e JSON-RPC (ayrılmış)Üretim — henüz kullanılamıyor

Hızlı Başlangıç

import { createSdk } from '@solidus-network/sdk'
 
// 1. Create the SDK client in testnet mode
const sdk = createSdk({
  mode: 'testnet',
  rpcUrl: 'https://rpc.solidus.network',
  signerPrivateKey: process.env.SIGNER_PRIVATE_KEY,
})
 
// 2. Generate a key pair and create a DID
const keyPair = crypto.getRandomValues(new Uint8Array(32))
const did = await sdk.did.create(publicKey)
console.log(did.id) // "did:solidus:testnet:7Kf9..."
 
// 3. Issue a credential
const credential = await sdk.credentials.issue({
  subjectDid: did.id,
  issuerDid: 'did:solidus:testnet:issuer123',
  issuerPrivateKey: process.env.ISSUER_PRIVATE_KEY,
  type: ['VerifiableCredential', 'KYCCredential'],
  claims: {
    level: 1,
    country: 'US',
    verifiedAt: new Date().toISOString(),
  },
  expiresInDays: 365,
})
 
// 4. Verify the credential
const result = await sdk.credentials.verify(credential.id)
console.log(result.valid)          // true
console.log(result.checks.signature)  // true
console.log(result.checks.expiry)     // true
console.log(result.checks.revocation) // true

Sonraki Adımlar

Last updated on
MCP Server@solidus-network/sdk