> For the complete documentation index, see [llms.txt](https://sonic-ai-works.gitbook.io/sonic-networks-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sonic-ai-works.gitbook.io/sonic-networks-docs/documentation/developers/programs/credits-program.md).

# Credits Program

SONIC on-chain credit primitives and reservation-state contract, separated from SaaS billing and the application AI Credits ledger.

**Configured program ID:** `3jBmsZsq5PwkB9SGWDSACZCrvhRCtna93oD6q21D6eEq`\
**Mainnet deployment:** **TBA / unverified**\
**Explorer:** [Open configured address on Solscan](https://solscan.io/account/3jBmsZsq5PwkB9SGWDSACZCrvhRCtna93oD6q21D6eEq)

### ⚙️ Responsibility

Where on-chain credit execution is enabled, the `credits` program is intended to support primitives such as:

* credit accounts;
* durable reservation state;
* reserve;
* settle;
* release.

### 💳 Accounting boundary

The on-chain program is **not** the same thing as SONIC SaaS billing or the customer-facing AI Credits ledger. Subscription entitlements, provider capacity, invoices and application accounting remain server-authoritative systems with their own reconciliation rules.

Provider credits are infrastructure capacity and are never presented as user balances.

### 🚦 Deployment status

| Check                                | State                       |
| ------------------------------------ | --------------------------- |
| Configured program ID                | **Configured**              |
| Approved executable artifact         | **TBA**                     |
| Devnet deployment verification       | **TBA**                     |
| Mainnet-beta executable verification | **TBA**                     |
| Authority verification               | **TBA**                     |
| Product capability activation        | **Disabled until verified** |

### ✅ Settlement rule

A transaction signature alone is not credit settlement. SONIC advances application credit state only after the expected chain effect is verified and the corresponding ledger transition is reconciled exactly once.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sonic-ai-works.gitbook.io/sonic-networks-docs/documentation/developers/programs/credits-program.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.