API documentation

smrtspace.net domain registration

Transport

Endpoint: https://btmxj6a37x6zto2vrqkpjq4hqbsltvwulvovtf4nirhib66r5wrvkkid.onion/api.php
Method: HTTP POST
Content-Type: application/json

Request format

{
  "method": "domain_register",
  "params": { ... }
}

Response format

Success:

{ "result": { ... } }

Error:

{ "error": { "code": -32602, "message": "Invalid domain name" } }

Error codes

CodeMeaning
-32600Invalid request format
-32601Method not found
-32602Invalid parameters
-32000Application error (see message)
-32603Internal server error

Methods

price

Returns current pricing and available zones. No parameters.

{ "method": "price", "params": {} }

Result:

{
  "zones":     ["smrtspace.net"],
  "per_day":   "0.05",
  "per_month": "1.00",
  "currency":  "USDT",
  "min_days":  1,
  "max_days":  365
}

domain_register

Register a domain. Requires a signed BB invoice for the exact amount.

ParamTypeDescription
namestring1–63 chars, a–z, 0–9, hyphen
zonestring
periodstringdays or months
valueintNumber of days or months
signed_invoiceobjectSigned BB invoice

Result:

{
  "domain":     "mysite.smrtspace.net",
  "secret":     "a3f9...",
  "expires_at": 1748000000,
  "receipt":    "..."
}

Save the secret — it is the only proof of ownership and cannot be recovered.
The receipt is an encrypted BB envelope. Decrypt with your private key to get the updated balance.

domain_renew

Extend a domain's expiration. No secret required — anyone can renew.

ParamTypeDescription
namestring
zonestring
periodstringdays or months
valueint
signed_invoiceobjectSigned BB invoice

Result: {"expires_at": 1748000000, "receipt": "..."}

domain_update

Replace all DNS records for the domain. Requires secret.

ParamTypeDescription
namestring
zonestring
secretstringOwnership token
recordsarrayDNS records, max 10

Record format: {"type": "A", "content": "1.2.3.4"}
Allowed types: A, AAAA, CNAME, TXT

Result: {}

domain_info

Get expiration date and current DNS records. Requires secret.

ParamTypeDescription
namestring
zonestring
secretstringOwnership token

Result:

{
  "domain":     "mysite.smrtspace.net",
  "expires_at": 1748000000,
  "records": [
    {"type": "A",   "content": "1.2.3.4"},
    {"type": "TXT", "content": "\"v=spf1 ~all\""}
  ]
}

domain_delete

Delete the domain and all its DNS records. Requires secret. No refund.

ParamTypeDescription
namestring
zonestring
secretstringOwnership token

Result: {}