CLI

Solidus’u — öz-egemen kimlik, doğrulanabilir kimlik bilgileri, did:solidus — uygulamanıza tek bir komutla bağlayın.


npx @solidus-network/cli init

Her komut iki şekilde çalışır: bir insan için etkileşimli, ve bir yapay zeka kodlama ajanı için ajan-gözetimsiz — --json çıktısı, temiz çıkış kodları, komut istemi gerekmez. Kodlama ajanınızı bu sayfaya yönlendirin, CLI’ı doğrudan çalıştırabilir.

Kurulum

Kurulum gerekmez — npx ile çalıştırın:


npx @solidus-network/cli init

Veya global olarak kurun:


npm install -g @solidus-network/cli
solidus init

Komutlar

Command	Does	Needs a key?
`solidus init [--yes] [--with-mcp]`	Çatınızı (bugün için Next.js) algılar ve `.env.local` yer tutucularını + bir `lib/solidus.ts` SDK taslağını bağlar	Hayır — yalnızca yerel dosyalara yazar, asla bir sır değil
`solidus did resolve <did>`	Bir `did:solidus` DID belgesini çözümler	Hayır
`solidus did create --public-key <hex> [--signer-key <hex>]`	İmzalayan anahtarın sahip olduğu bir DID kaydeder	Evet — `SOLIDUS_SIGNER_KEY` ortam değişkeni veya `--signer-key`
`solidus credential verify <vcId>`	Bir Solidus doğrulanabilir kimlik bilgisini doğrular	Hayır
`solidus mcp install`	`@solidus-network/mcp` (çalışma zamanı ajan araçları) paketini bu projenin `.mcp.json` dosyasına, mevcut sunucularla birleştirerek ekler	Hayır

Her komut ayrıca makine tarafından okunabilir çıktı için genel --json bayrağını kabul eder.

`init` — bir uygulamayı tek komutla bağlama

solidus init çatınızı algılar, ardından bir Next.js uygulamasının Solidus’u kullanmaya başlaması için gereken dosyaları yazar (asla üzerine yazmaz):

.env.local — SOLIDUS_RPC_URL ve SOLIDUS_SIGNER_KEY için yorum satırına alınmış bir yer tutucu
lib/solidus.ts — içe aktarmaya hazır bir createSdk() örneği


cd my-nextjs-app
npx @solidus-network/cli init --yes --json


{"framework":"nextjs","wrote":["/path/to/my-nextjs-app/.env.local","/path/to/my-nextjs-app/lib/solidus.ts"]}

init idempotenttir ve yıkıcı değildir: yeniden çalıştırmak mevcut içeriğin üzerine asla yazmaz ve uygulamanız zaten bağlandıktan sonra yeni bir şey yazmaz.

`--with-mcp` — MCP sunucusunu zincire ekleme

--with-mcp, ayrıca mcp install’ı da çalıştırarak @solidus-network/mcp — ajan-yerel dağıtımın çalışma zamanı yarısı — paketini .mcp.json’a bağlar. Bu, isteğe bağlıdır ve --yes altında bile varsayılan olarak kapalıdır: init uygulamanızın iskeletini kurarken, .mcp.json uygulamanızın kendi ajan araç setini yapılandırır — bir iskelet komutunun sessizce geçmemesi gereken ayrı bir onay sınırı.


npx @solidus-network/cli init --yes --with-mcp --json


{"framework":"nextjs","wrote":[],"mcp":{"wrote":"/path/to/my-nextjs-app/.mcp.json","alreadyPresent":false}}

Başka hiçbir şeye dokunmadan .mcp.json girdisini eklemek veya güncellemek için istediğiniz zaman solidus mcp install’ı tek başına çalıştırın — zaten yapılandırılmış diğer MCP sunucularıyla birlikte birleşir ve solidus girdisi zaten mevcutsa hiçbir işlem yapmaz.

`--json` sözleşmesi

--json açık: stdout tam olarak bir satırlık JSON.stringify(result)’tır — renk yok, yükleniyor göstergesi yok, ekstra günlükleme yok.
--json kapalı: stdout insan tarafından okunabilir (satır başına anahtar: değer).
Çıkış 0: komut tamamlandı ve bir sonuç yazdırdı — bir “bulunamadı” yanıtı bile böyledir (kayıtlı olmayan bir DID üzerinde did resolve, çıkış 0 ile {"resolved":false} döndürür; bu geçerli bir yanıttır, hata değil).
Çıkış 1: komut hata fırlattı — ağ hatası, geçersiz girdi, eksik imzalayan anahtarı. Hata mesajı stderr’e gider, aynı biçimde biçimlendirilir (--json → {"error": "..."}, insan → düz metin).

Ortam değişkenleri

Variable	Default	Used by
`SOLIDUS_RPC_URL`	`https://rpc.solidus.network`	her komut
`SOLIDUS_SDK_MODE`	`testnet`	her komut
`SOLIDUS_SIGNER_KEY`	yok	yalnızca `did create`

solidus login (etkileşimli kimlik bilgisi depolama) henüz yayınlanmadı — şimdilik SOLIDUS_SIGNER_KEY’i kendiniz ayarlayın.

Hızlı başlangıç: bir Next.js uygulamasını bağlayın, ardından çözümleyin ve doğrulayın


cd my-nextjs-app
npx @solidus-network/cli init --yes --json
# {"framework":"nextjs","wrote":["/path/to/my-nextjs-app/.env.local","/path/to/my-nextjs-app/lib/solidus.ts"]}
 
npx @solidus-network/cli did resolve did:solidus:testnet:doesnotexist --json
# {"did":"did:solidus:testnet:doesnotexist","document":null,"resolved":false}
 
npx @solidus-network/cli credential verify vc-123 --json
# {"vcId":"vc-123","result":{"valid":false,"error":"Credential not found","checks":{...}}}

Sonraki adımlar

Başlarken — eksiksiz 5 dakikalık SDK turu
Next.js Entegrasyonu — init’in sizin için oluşturduğu iskeletin elle yazılmış hâli
SDK Referansı — lib/solidus.ts’in üzerine inşa edildiği her paket

CLI