API Reference

Health & Status

Endpoints for checking API health and retrieving network configuration.

Health Check

GET /health

Checks the API status. No authentication required.

Response:

json
{
  "status": "OK",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "service": "ACTA API"
}

Example:

bash
curl https://api.testnet.acta.build/health

Live

Runs GET https://api.testnet.acta.build/health through this site’s proxy - no API key required. OpenAPI UI: https://api.testnet.acta.build/docs

Network Configuration

GET /config

Gets public network configuration. No authentication required (public bootstrap endpoint, not rate limited).

Response:

json
{
  "rpcUrl": "https://soroban-testnet.stellar.org:443",
  "networkPassphrase": "Test SDF Network ; September 2015",
  "networkType": "testnet",
  "factoryContractId": "C...",
  "vaultWasmHash": "2bd0323a...",
  "didStellarRegistryId": "C...",
  "actaContractId": "C..."
}
  • factoryContractId: the vc-vault-factory contract id for this network.
  • networkType: testnet or mainnet.
  • vaultWasmHash: the vc-vault template WASM hash deployed by the factory.
  • didStellarRegistryId: the did:stellar registry contract id used to resolve issuer DIDs.
  • actaContractId: back-compat alias of factoryContractId.

Example:

bash
curl https://api.testnet.acta.build/config