Explorer API

Explorer API, Solidus zincirini Postgres’e indeksler ve bunu aranabilir bir REST yüzeyi olarak geri sunar, ayrıca yeni bloklar, işlemler, DID’ler ve kimlik bilgileri geldikçe bir WebSocket akışı sağlar. explorer.solidus.network ’ün arkasındaki arka uçtur.

Temel URL: https://explorer.solidus.network/api/v1

Aşağıdaki her rota, canlı JSON-RPC düğümüne aktarım yapan POST /txs/broadcast hariç, indeksleyicinin kendi Postgres’ine karşı yalnızca okumadır. Protokolde bugün bir akıllı sözleşme katmanı yoktur, bu yüzden bu API bir sözleşme doğrulayıcısı veya sözleşme çağrıları için bir işlem kod çözücüsü sunmaz — ve sunmayacaktır; bazı eski ürün notları aksini iddia etmiştir. Bu indeksleyicinin okuduğu temel zincir yöntemleri için JSON-RPC’ye bakın.

Kimlik Doğrulama

Yok. Bu sayfadaki her rota herkese açıktır ve kimlik doğrulaması gerektirmez. API anahtarı, hız sınırı kademesi yoktur ve tek işlem-aktarım rotası dışında yazma erişimi yoktur.

Rota dizini

Route group	Path	Auth
Bloklar	`/blocks`, `/blocks/latest`, `/blocks/:height`	Herkese açık
İşlemler	`/txs`, `/txs/:hash`, `/txs/broadcast`	Herkese açık
Adresler	`/addresses`, `/addresses/:address`, `/addresses/:address/txs`	Herkese açık
DID’ler	`/dids/:did`, `/dids/:did/credentials`	Herkese açık
Kimlik bilgileri	`/credentials`, `/credentials/issuers`, `/credentials/:id`	Herkese açık
Doğrulayıcılar	`/validators`, `/validators/:address`	Herkese açık
Arama	`/search`	Herkese açık
İstatistikler	`/stats/network`, `/stats/charts`	Herkese açık
Sağlık	`/health` (`/api/v1` altında değil — kökte sunulur)	Herkese açık
WebSocket	`/ws` (`/api/v1` altında değil — kökte sunulur)	Herkese açık

Bloklar

Blokları listele


curl "https://explorer.solidus.network/api/v1/blocks?page=1&limit=20"

Sorgu parametreleri: page (varsayılan 1), limit (varsayılan 20, maksimum 100).


// Response 200
{
  "data": [
    {
      "height": "82071",
      "hash": "1e6be00359dffd3e6a4924b4446deee37f29220c260a76fba53f5a988116c01d",
      "parent_hash": "954f2d291a277b88ddc04bec0438339ea575462bf2b50711d164c20e81ef1ad1",
      "proposer": "28gvczeVVVQjy6MpP4yexmd3xEsm",
      "timestamp_ms": "1785323253741",
      "tx_count": 0,
      "round": "6512",
      "state_root": "c2a009a8fc5f869aee238febb2e362694bd3828748158d758e52420f5a15c89d",
      "created_at": "2026-07-29T11:17:36.014Z"
    }
  ],
  "total": 63172,
  "page": 1,
  "limit": 20
}

En son blok


curl https://explorer.solidus.network/api/v1/blocks/latest


// Response 200 — measured live
{
  "height": "82071",
  "hash": "1e6be00359dffd3e6a4924b4446deee37f29220c260a76fba53f5a988116c01d",
  "parent_hash": "954f2d291a277b88ddc04bec0438339ea575462bf2b50711d164c20e81ef1ad1",
  "proposer": "28gvczeVVVQjy6MpP4yexmd3xEsm",
  "timestamp_ms": "1785323253741",
  "tx_count": 0,
  "round": "6512",
  "state_root": "c2a009a8fc5f869aee238febb2e362694bd3828748158d758e52420f5a15c89d",
  "created_at": "2026-07-29T11:17:36.014Z"
}

Yüksekliğe göre blok


curl https://explorer.solidus.network/api/v1/blocks/82071

Yukarıdakiyle aynı şekil, artı gömülü bir transactions dizisi (her giriş: hash, tx_index, sender, type, recipient, amount, fee, status, timestamp_ms).

İşlemler

İşlemleri listele


curl "https://explorer.solidus.network/api/v1/txs?page=1&limit=20&type=Transfer&address=3GfjBM7v6LZ1N5zp1b12gfpwCN8j"

Sorgu parametreleri: page, limit, type (işlem türü filtresi), address (gönderen veya alıcı), from_time / to_time (Unix ms penceresi).


// Response 200 — shape
{
  "data": [
    {
      "hash": "<hex>",
      "block_height": 82071,
      "tx_index": 0,
      "sender": "3GfjBM7v6LZ1N5zp1b12gfpwCN8j",
      "type": "Transfer",
      "recipient": "28gvczeVVVQjy6MpP4yexmd3xEsm",
      "amount": "500",
      "fee": "10000",
      "status": "success",
      "timestamp_ms": "1785323253741",
      "raw_payload": { "Transfer": { "amount": 500 } }
    }
  ],
  "total": 1814,
  "page": 1,
  "limit": 20
}

Hash’e göre işlem


curl https://explorer.solidus.network/api/v1/txs/<hash>

Aynı satır şekli, artı error_reason (yalnızca status bir başarısızlık olduğunda doldurulur) ve created_at.

Bir işlemi yayınla (broadcast)


curl -X POST https://explorer.solidus.network/api/v1/txs/broadcast \
  -H "content-type: application/json" \
  -d '{"tx": "<JSON-stringified signed transaction>"}'

İmzalanmış işlemi doğrudan JSON-RPC düğümündeki solidus_sendTransaction’a aktarır — bu rota herhangi bir imzalama yapmaz ve asla bir özel anahtara dokunmaz.


// Response 200
{ "tx_hash": "<hex tx hash>" }

Adresler

Zengin listesi (richlist)


curl "https://explorer.solidus.network/api/v1/addresses?page=1&limit=20&sort=tx_count"

Sorgu parametreleri: page, limit, sort (varsayılan tx_count, veya first_seen).


// Response 200 — shape
{
  "data": [
    { "address": "3GfjBM7v6LZ1N5zp1b12gfpwCN8j", "first_seen": "...", "last_seen": "...", "tx_count": 412, "is_validator": true, "did": null }
  ],
  "total": 480,
  "page": 1,
  "limit": 20
}

Adres ayrıntısı


curl https://explorer.solidus.network/api/v1/addresses/3GfjBM7v6LZ1N5zp1b12gfpwCN8j

İndekslenmiş satır (address, first_seen, last_seen, tx_count, is_validator, did, created_at, updated_at), balance ve nonce’un canlı bir RPC okumasıyla zenginleştirilmiş (solidus_getBalance / solidus_getNonce — RPC çağrısı hata verirse 0’a düşer).

Adres işlemleri


curl "https://explorer.solidus.network/api/v1/addresses/3GfjBM7v6LZ1N5zp1b12gfpwCN8j/txs?page=1&limit=20"

GET /txs ile aynı liste şekli, adresin gönderen veya alıcı olduğu işlemlerle filtrelenmiş.

DID’ler

DID ayrıntısı


curl https://explorer.solidus.network/api/v1/dids/did:solidus:testnet:7Hk3mRtQZvXp2nBw9Lj4K

İndekslenmiş satır (did, controller, public_key, active, created_ms, updated_ms, tx_hash, created_at) artı credentials_count ve bir live_document alanı — zincire karşı canlı bir solidus_didResolve çağrısı (RPC okuması başarısız olursa null). DID Belgesi şekli için DID’ler’e bakın.

Bir DID için kimlik bilgileri


curl "https://explorer.solidus.network/api/v1/dids/did:solidus:testnet:.../credentials?page=1&limit=20"

DID’in konu veya düzenleyici olduğu kimlik bilgilerini, aşağıdaki GET /credentials ile aynı şekilde döndürür.

Kimlik Bilgileri

Kimlik bilgilerini listele


curl "https://explorer.solidus.network/api/v1/credentials?page=1&limit=20&type=KycLevel1Credential"

Sorgu parametreleri: page, limit, type, issuer (düzenleyici DID’i), subject (konu DID’i).


// Response 200 — shape
{
  "data": [
    {
      "credential_id": "urn:solidus:credential:...",
      "issuer_did": "did:solidus:testnet:...",
      "subject_did": "did:solidus:testnet:...",
      "credential_type": "KycLevel1Credential",
      "hash": "<hex>",
      "issued_ms": "1785200000000",
      "revoked": false,
      "revoked_ms": null,
      "tx_hash": "<hex>"
    }
  ],
  "total": 390,
  "page": 1,
  "limit": 20
}

Düzenleyici istatistikleri


curl "https://explorer.solidus.network/api/v1/credentials/issuers?page=1&limit=20"

Düzenleyici başına toplanmış sayılar: issuer_did, credentials_issued, active_credentials, revoked_credentials, first_issued, last_issued. Bu rota, rota tablosunda /credentials/:id’den önce kaydedilmelidir — aksi takdirde issuers, bir kimlik bilgisi kimliği olarak yutulur.

Kimlik bilgisi ayrıntısı


curl https://explorer.solidus.network/api/v1/credentials/urn:solidus:credential:...

İndekslenmiş satır artı bir verification alanı — canlı bir solidus_credentialVerify RPC çağrısı (RPC okuması başarısız olursa null).

Doğrulayıcılar

Doğrulayıcıları listele


curl "https://explorer.solidus.network/api/v1/validators?limit=2"


// Response 200 — measured live
{
  "data": [
    { "address": "3GfjBM7v6LZ1N5zp1b12gfpwCN8j", "staked": "1000000000000", "unbonding": "0", "reputation": 1000, "active": true, "blocks_proposed": 0, "updated_at": "2026-07-29T11:23:00.044Z" },
    { "address": "28gvczeVVVQjy6MpP4yexmd3xEsm", "staked": "0", "unbonding": "0", "reputation": 0, "active": true, "blocks_proposed": 15788, "updated_at": "2026-07-29T11:23:00.063Z" }
  ],
  "summary": { "total_validators": 5, "active_validators": 5, "total_staked": "1000000000000", "total_blocks_proposed": 63172 },
  "total": 5,
  "page": 1,
  "limit": 2
}

Sorgu parametreleri: page, limit, sort (varsayılan staked, blocks_proposed veya reputation).

Doğrulayıcı ayrıntısı


curl https://explorer.solidus.network/api/v1/validators/3GfjBM7v6LZ1N5zp1b12gfpwCN8j

Yukarıdaki bir data girdisiyle aynı satır şekli, artı bu doğrulayıcı tarafından önerilen son bloklar.

Arama


curl "https://explorer.solidus.network/api/v1/search?q=a"

Sorgu parametreleri: q (gerekli), type (isteğe bağlı filtre — block, transaction, validator, did veya credential).


// Response 200 — measured live
{ "data": [], "total": 0 }

İstatistikler

Ağ istatistikleri

Sunucu tarafında 30 saniye önbelleğe alınır.


curl https://explorer.solidus.network/api/v1/stats/network


// Response 200 — measured live
{
  "blocks": { "total_blocks": 63172, "latest_height": "82071", "latest_timestamp": "1785323253741" },
  "transactions": { "total_transactions": 1814, "unique_senders": 1 },
  "addresses": { "total_addresses": 480 },
  "dids": { "total_dids": 1, "active_dids": 1 },
  "credentials": { "total_credentials": 390, "active_credentials": 390 },
  "validators": { "total_validators": 5, "active_validators": 5, "total_staked": "1000000000000" },
  "cached_at": 1785324212542
}

Grafik verisi


curl "https://explorer.solidus.network/api/v1/stats/charts?metric=blocks&range=24h"

Sorgu parametreleri: metric (varsayılan blocks, transactions/txs veya dids), range (1h, varsayılan 24h, 7d, 30d).


// Response 200 — shape
{
  "metric": "blocks",
  "range": "24h",
  "bucket_ms": 864000,
  "data": [{ "bucket": "1785237600000", "count": 42 }]
}

Sağlık


curl https://explorer.solidus.network/health

Yolu not edin — /health, /api/v1 altında değil, kökte kayıtlıdır.


// Response 200
{ "status": "ok", "ts": "2026-07-29T11:17:36.014Z" }

WebSocket akışı


wss://explorer.solidus.network/ws

Ayrıca kök seviyesinde bir yol, /api/v1 altında değil. Bir veya daha fazla konuya abone olmak için bir JSON mesajı gönderin:


{ "subscribe": ["blocks", "transactions", "dids", "credentials"] }

Her yeni indekslenen olay şu şekilde gelir:


{ "type": "block", "data": { "...": "the same block row shape as GET /blocks/latest" } }

type, block, transaction, did, credential’dan biridir. Sunucu ayrıca her 30 saniyede bir nabız (heartbeat) olarak {"type":"ping"} gönderir. Bir konuyu durdurmak için {"unsubscribe": ["blocks"]} gönderin.

Hata biçimi


{
  "type": "https://solidus.network/errors/404",
  "title": "Not Found",
  "status": 404,
  "detail": "Block not found",
  "instance": "/api/v1/blocks/999999999"
}

RFC 7807 Problem Details, her Solidus arka ucunda kullanılan aynı şekil.