<aside>

Overview

:ambient-logo-original: Docs Home

What is Ambient?

Getting Started

Testnet

App

API

On-Chain

Tool Oracle

Claude Code

Miners

Encyclopedia

Solana Quickstart

Developers

OpenAI SDK

Anthropic SDK

API Docs

API Playground

Links

🌐 Homepage

✉️ [email protected]

:discord-symbol-blurple: Discord

:github-mark-white-bg: github.com/ambient-xyz

:x-logo-black: @ambient_xyz

:x-logo-black: @IridiumEagle

</aside>

<aside> 🔥

Testnet is now live!

</aside>

High‑Level Testnet Architecture

The testnet architecture includes an on‑chain program, off‑chain miners/validators and external services.

image.png

External Services

On‑Chain Program (Ambient Main Program)

The Ambient Main Program runs on the Solana‑compatible chain and manages core logic:

Off‑Chain Components

Workflow Example

  1. User query submission: A developer or agent sends a request via the API service, specifying constraints such as maximum response time and the amount they are willing to pay. Queries are grouped into bundles by the auction app.
  2. Auction and bidding: The on‑chain program announces an auction for a bundle. Miners listen for auctions and place bids. Miners whose bids win commit to delivering the results within the agreed time. According to the litepaper, miners’ bids are refunded if they complete the query within the specified period .
  3. Inference and result submission: The winning miner runs the query on its vLLM instance, generates hashed logits for each token and submits the output and PoL hashes to the chain. Validators are randomly selected based on their logit stake to audit the result .
  4. Validation: Validators recompute a small portion of the query (a randomly selected token) using the same context and model. If the hashed logits match, the result is accepted . This process ensures that validation is inexpensive (only one token of inference) compared with the original computation.
  5. Settlement and reward: When results are accepted, the miner receives compensation (transaction + inflation‑based) and the user’s payment is released. If the miner fails to deliver on time or produces incorrect results, they forfeit their bond and the query is re‑auctioned.

Participating in the Testnet