DENEYSEL GELİŞTİRME AĞI · BELGELER
HTTP API v1
Base URL http://127.0.0.1:18780. Bind loopback ile sınırlandırılır. TLS yerine yerel HTTP + uzak kullanımda SSH tüneli; açık internete HTTP token göndermeyin. SIS_RPC_TOKEN en az 32 karakter ve whitespace içermemeli. Yetkili istek: Authorization: Bearer <TOKEN>; örnek token gerçek bir sır değildir, dosyaya gömmeyin.
| Yöntem / yol | Yetki | Sonuç |
|---|---|---|
| GET / | Yok | Statik proje sitesi |
| GET /explorer | Yok | Watch-only explorer |
| GET /status | Yok | Ağ, height, tip, genesis, issued_atoms, max_supply_atoms, zorluk, work, mempool, tahmini H/s |
| GET /blocks | Yok | Son 30 bloğun kimlik/zaman/ödül/işlem sayısı özeti |
| GET /account/{address} | Yok | Şeffaf balance_atoms, locked_atoms, nonce ve onaylı işlem geçmişi |
| GET /chain | Bearer | Tam kanonik zincirin JSON array'i |
| GET /mempool | Bearer | Bekleyen işlemler |
| GET /template/{miner_address} | Bearer | PoW araması için Block JSON nesnesi |
| POST /blocks | Bearer | Body: Block; sonuç { "accepted": true } |
| POST /transactions | Bearer | Body: Transaction; sonuç id ve accepted |
Tüm para değerleri atom cinsinden integer; maksimum 2.1e15 olduğundan JS Number exact integer aralığında kalır. Hatalar genellikle 400, chain yetkisiz 401, JSON tür/şema hataları Axum 4xx, payload sınırı 413. Diğer auth hataları bu prototipte 400 döner; üretim öncesi hata standardizasyonu gerekir. Bilinmeyen alanlar reddedilir. Gelen JSON <=16 MiB; işlem başına küçük body alt sınırı/rate limit yoktur. Chain maksimum 4096 blok; büyüyen public ağ için bu snapshot API uygun değildir.
curl --fail http://127.0.0.1:18780/status
curl --fail http://127.0.0.1:18780/blocks
# Aynı makinede, shell tracing kapalıyken:
curl --fail -H "Authorization: Bearer $SIS_RPC_TOKEN" http://127.0.0.1:18780/chain
İşlem alanları ve imza formatı CONSENSUS.md'dedir; elle imza üretmek yerine CLI kullanın. Özel anahtar, mnemonic veya vault hiçbir API body'sine ait değildir. Explorer yalnız onaylı açık veriyi okur. Gizli işlem RPC'si yoktur. Aktif peer sayısı veya global ağ node sayısı iddiası sunulmaz; configured_peers statik yapılandırma sayısıdır.