> 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/readme.md).

# Introduction

![Black Sheep Finance](/files/T2eUtlVBMNEaV9IVDSg1)

> Programmatic USDC agent wallets on Solana — with server-enforced spending policy, human-in-the-loop approvals, signed webhooks, and a typed SDK.

Black Sheep gives every AI agent, automation, or backend service its own real, on-chain USDC wallet that **cannot exceed the policy you set**. The LLM never sees a private key. Every spend runs through your daily caps, per-tx caps, allowlists, and approval thresholds before a single lamport leaves the wallet.

```
┌──────────────┐    send(to, amount)    ┌────────────────────┐
│  Your agent  │ ─────────────────────▶ │  Black Sheep API   │
│  (LLM / bot) │                        │  Policy engine     │
└──────────────┘                        └────────┬───────────┘
                                                 │
                              ┌──────────────────┼──────────────────┐
                              ▼                  ▼                  ▼
                        allow → on-chain   approve → human    deny → blocked
                                              (webhook)
```

## Why teams use it

* **Hard spending limits** — daily, per-tx, and recipient allowlists enforced server-side. The LLM cannot override them.
* **Human-in-the-loop** — anything over the approval threshold pauses and pings your Slack / ops channel via signed webhook.
* **Real money, real chain** — USDC on Solana mainnet (or devnet). Settlement in seconds, fees in fractions of a cent.
* **Drop-in for LangChain** — `blackSheepTools()` returns ready-to-use tools so an agent can pay for things in a workflow.
* **Audit trail** — every decision, approval, and signature is logged and queryable via API.

## Start here

1. [Quickstart →](/black-sheep-finance-docs/getting-started/quickstart.md) — issue an agent wallet, set a policy, send your first USDC in 5 minutes.
2. [Core concepts →](/black-sheep-finance-docs/core-concepts/overview.md) — wallets, policies, approvals, webhooks.
3. [Nous Hermes integration →](/black-sheep-finance-docs/guides/nous-hermes.md) — wire a budgeted wallet into the agent framework that grows with you.
4. [LangChain integration →](/black-sheep-finance-docs/guides/langchain.md) — wire a budgeted wallet into a tool-calling agent.
5. [REST API reference →](/black-sheep-finance-docs/rest-api/overview.md) — every endpoint, request, response.


---

# 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/readme.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.