ObscuraObscura
Back
Developer Documentation

Obscura Docs

Integrate private GPU compute, execute API orders, and contribute to the protocol.

1. What is Obscura?

Obscura is a decentralized, privacy-preserving dark pool for GPU and AI compute resources built on Solana.

In traditional compute marketplaces, order details are public, exposing training durations, model choices, and pricing to competitors. Obscura hides these details using a commit-reveal mechanism and zero-knowledge proofs (zk-SNARKs). Matches clear in scheduled 45-second batch auctions at a single market-clearing price, preventing front-running and timing analysis.

2. How to Use Obscura

2.1 For Compute Buyers

  1. Commit: Generate a cryptographic hash of your compute requirement (GPU model, max price, quantity, lease duration) combined with a local random salt. Submit only the hash to the Solana contract and deposit the maximum lease cost into escrow.
  2. Reveal: During the match window, reveal the order parameters and salt. The contract verifies the parameters match your committed hash.
  3. Lease: If matched, compute access is allocated to your public key. If unmatched, the escrowed USDC is refunded.

2.2 For Compute Providers

  1. Register: Register your hardware specs via the developer portal or the CLI.
  2. Stake Collateral: Lock up a minimum threshold of $OBSC tokens as collateral. This stake is slashable in the event of hardware failures or dishonest match reporting.
  3. Host: Run the Obscura host daemon to accept containerized AI workloads matched by the pool.

3. Using Obscura via API

Developers and AI agents can interact with Obscura programmatically using standard HTTP JSON payloads.

3.1 Authentication

All API requests must include your client API key in the request headers:

X-API-Key: obsc_live_8f3b9c2a7d1e4f5b8c6a9b8c
POST/api/v1/orders/commit

Submit your cryptographic commitment hash and lock compute value in escrow.

{
  "gpuType": "H100 80GB",
  "commitHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}
POST/api/v1/orders/reveal

Submit the cleartext parameters and salt preimage once the reveal window opens.

{
  "orderId": "8f3b9c2a-7d1e-4f5b-8c6a-9b8c7d6e5f4a",
  "priceMicro": 1860000,
  "qty": 4,
  "secret": "98939e45dd1932a6a5739912cbf71553b798926fcb7d816a0bab13c67fe87e69"
}

4. Real-World Use Cases

  • 💼 Proprietary Model TrainingEnterprises training proprietary models can lease clusters of H100s privately, ensuring competitors cannot monitor their training timelines, model scales, or cluster locations.
  • 🤖 Autonomous Agent Compute SwarmsAI agents acting as independent economic entities can dynamically lease GPUs on-demand to run inference, paying autonomously in USDC without credit card locks.
  • âš¡ Cost-Optimized Batch InferencesCompute buyers with latency-insensitive workloads can submit orders into the 45-second batch auctions, matching against excess provider capacity at discounts of up to 40% compared to retail clouds.

5. Open Source & Contributions

Obscura is built on the belief that decentralized infrastructure must be transparent, verifiable, and open.

5.1 Repository License

All core Obscura codebases (including the commitment contract, zk-SNARK matching circuits, CLI client, and SDKs) are open-source under the MIT License.

5.2 How to Contribute

  • Bug Reporting: Report security vulnerabilities directly to obscurasol@outlook.com. Report generic bugs via GitHub Issues.
  • Pull Requests: Submit PRs to the respective repos. Ensure all code passes formatting checks and unit tests.
  • Matching Circuits: Cryptographers can contribute enhancements to the matching constraints located in the contracts/circuits folder.