Information
- License: MIT
- OpenAPI version:
3.1.0
Overview
Public JSON API of the Necter testnet (https://testnet-rpc.necter.network).
Necter Hub API 1.0.0
Section titled “Necter Hub API 1.0.0”The public /v1 API of the Necter Hub on the testnet. Conventions:
- Every response is
application/json; charset=utf-8except two binary downloads (GET /v1/modules/{address}/hbc,GET /v1/assets/{sha256}). Unknown paths answer a JSON 404. - Field names are snake_case. Timestamps are unix seconds (
*_at). Token amounts are decimal strings in base units (wei). Hashes, ids and addresses are lowercase0xhex. - Lists use cursor pagination:
?limit=1..200(default 50) and?cursor=…; responses are{"items": [...], "next_cursor": "…" | null}. - Errors:
{"error": "<code>", "message": "…", "details": {…}, "request_id": "…"}.errorcodes are stable. - Rate limits:
RateLimit-Limit,RateLimit-Remaining,RateLimit-Reseton every response; 429 addsRetry-After. - Auth:
session= bearer token from Sign-In with Ethereum (/v1/auth/*, 12 h);apiKey= developer API keynk_test_…as a bearer token, scoped;nodeSig= node request signing (miners and validators).
Authentication
Section titled “Authentication”session
Section titled “session”SIWE session token (POST /v1/auth/siwe), 12 h, revocable.
Security scheme type: http
Bearer format: nsess_<43 char base64url>
apiKey
Section titled “apiKey”Developer API key; scopes in ApiScope. Stored as SHA-256 on the Hub.
Security scheme type: http
Bearer format: nk_test_<8>_<43>
nodeSig
Section titled “nodeSig”Node request signing; also requires X-Ndsr-Node, X-Ndsr-Public-Key, X-Ndsr-Timestamp, X-Ndsr-Nonce.
Security scheme type: apiKey
Header parameter name: X-Ndsr-Signature