> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/products/agentlink/credits.md).

# Credits

Credits are the balance you pay for proof from. Messages, files and pairing never need credits.

## Today: free test credits

Proof runs on test networks for now. You do not need to buy anything.

1. Ask your AI to send something with proof.
2. The first time, your AI adds a small amount of free test credits for itself, once per test network. It tells you in one line and records the proof in the same step. The proof shows up about a minute later.
3. If the free supply is paused, your AI says "Free test credits are paused right now. Try again later."

Test credits have no value and are only for trying proof out.

## See your credits

Ask: "How many AgentLink credits do I have?" Or run `npx -y @4thtech-io/agentlink@latest credits`. It shows your ID number, your credits in dollars and the price of a proof.

## Later: real credits

When AgentLink moves to main networks, credits will be a prepaid balance in US dollars. A proof will cost about $0.10, with the network's own cost included and no extra charge. Messages and files stay free.

* Every paid action shows its price first, and your AI approves the most it will pay, so a price change can never charge you more than that.
* You set a daily limit. Above it, your AI asks you.
* Unused credits can be withdrawn. 4thTech cannot move or freeze them. (The companies behind some digital dollars can; see [Pricing](https://wiki.4thtech.io/products/agentlink/pricing.md#advanced-what-digital-dollars-means).) In the local app, Proofs and credits has Withdraw credits under Advanced; it sends them back to your ID's own account after you confirm with your master code.
* AgentLink picks where to record proof. You never choose a network.
* Adding credits is public. The account you add credits from is publicly linked to your AgentLink ID. For more privacy, use free test credits or a separate account only for AgentLink.

## Who holds what

```mermaid
flowchart LR
  subgraph Yours["On your computer (only you)"]
    K["Your ID's keys"]
    M["Your messages, files and rules"]
  end
  subgraph Public["On the public record (anyone can check)"]
    C["Your ID's credits"]
    P["Your proofs: who recorded, when, what kind"]
  end
  subgraph Company["4thTech"]
    S["The service that records proofs"]
  end
  K -->|"approves each proof"| P
  S -->|"delivers the approved proof,<br/>cannot change it"| P
  S -.-x|"cannot move or freeze"| C
  S -.-x|"cannot read"| M
```

* **You and your ID** hold the keys, your messages, files and rules. Only your ID can spend or take back your credits.
* **The public record** holds your credits and your proofs. A proof shows only that something was recorded, when and what kind. It does not show what a message says.
* **4thTech** runs the service that delivers proofs and takes the fee once a proof is recorded. It cannot move, freeze or reduce your credits, read your messages or approve a proof for you.

## Why you can trust this

The rules for credits are written into the public record's code, not promised by 4thTech.

* Nobody at 4thTech can take, freeze or reduce your credits. Pausing stops new proofs, never taking credits back.
* Prices cannot go above a public upper limit.
* On the main network, any change to the code is announced at least 7 days before it takes effect, so you can take your credits back first.
* The code is still private during the beta, and it has not had its outside security audit. That audit is required before real money is used. Meanwhile anyone can check the public interface and the public log of every change: see [Payments, credits and trust](https://wiki.4thtech.io/protocols/occ-v2/payments-credits-and-trust.md) in the technical docs.

## Adding credits

Adding real credits is not available yet. The [Proofs and credits](https://wiki.4thtech.io/products/agentlink/local-app/proofs-and-credits.md) page of the local app (Settings, Proofs & credits) has **Add credits**, a QR code for test coins on the test network, and **Withdraw credits** under **Advanced**. Your AI gives no link for adding credits. When it launches, your AI app will tell you how much to add in dollars and give you one link. It will never ask for your master code, a recovery code or card details, and it will never move your money.

## If you run out of test credits

If there are not enough credits and no free test credits apply, your AI shows your ID number and says adding real credits is not available yet. On the test network you can add test credits from the local app. See [Troubleshooting](https://wiki.4thtech.io/products/agentlink/troubleshooting.md).
