> For the complete documentation index, see [llms.txt](https://black-sheep-finance.gitbook.io/black-sheep-finance-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://black-sheep-finance.gitbook.io/black-sheep-finance-docs/reference/glossary.md).

# Glossary

**Account** — A Black Sheep tenant. Owns wallets, policies, API keys, and webhooks.

**Agent wallet** — A wallet issued to a non-human caller (LLM, bot, service). Always policy-gated.

**Allowlist** — Optional set of recipient addresses a wallet is permitted to send to. Empty = unrestricted.

**Approval** — A pending payment, parked because it exceeded the approval threshold, awaiting a human.

**Approval threshold** — Policy field: amount at or above which a send requires human approval.

**Audit log** — Append-only record of every privileged action (policy edits, approvals, sends, denials).

**Bearer key** — A `bs_live_...` / `bs_test_...` token sent as `Authorization: Bearer <key>`.

**BlackSheepError** — SDK error type thrown on non-2xx responses. Has `status` and `message`.

**Devnet** — Solana's developer test network. Tokens are play money.

**HMAC-SHA256** — The signature algorithm used for webhook verification.

**Idempotency** — Property of an operation: calling it twice has the same effect as calling it once. `send` is **not** idempotent yet.

**Mainnet** — Solana's production network. Real money.

**Memo** — Short string attached to a transaction (Solana Memo Program). Visible on-chain.

**Policy** — The rules attached to a wallet that gate spending.

**Pubkey** — Public key. The Solana address that funds are sent to.

**SIWS** — Sign-in-with-Solana. Dashboard auth via wallet signature.

**SOL** — Solana's native token. Pays network fees.

**Treasury wallet** — A user-owned wallet you use to top up agents.

**USDC** — A fully-backed dollar stablecoin. The unit of spending in Black Sheep.

**Webhook** — HTTP POST from Black Sheep to your endpoint, signed with HMAC-SHA256.


---

# 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://black-sheep-finance.gitbook.io/black-sheep-finance-docs/reference/glossary.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.