# Vestiarion

> Vestiarion is an autonomous treasury agent for stablecoin businesses on Arc. Its API reads a workspace's signed ledger, books, counterparties, milestones, treasury and insights, and adds counterparties, invoices, milestones and payee links for the agent to decide; signed webhooks push each ledger entry.

## Docs

- [Overview](https://www.vestiarion.xyz/docs.md): What Vestiarion is, and what its API and webhooks give an integration.
- [Data delivery methods](https://www.vestiarion.xyz/docs/data-delivery.md): REST pull or webhook push: how each delivers data, and when to use which.
- [Contracts on Arc testnet](https://www.vestiarion.xyz/docs/contracts.md): The contracts Vestiarion deploys and the Circle contracts it calls, with their addresses on Arc testnet.
- [Try it in 5 minutes](https://www.vestiarion.xyz/docs/guides/try-it.md): Sign in, load sample data, watch the agent decide, approve a payment and verify the signed ledger.
- [Go live on Arc testnet](https://www.vestiarion.xyz/docs/guides/go-live.md): Create the workspace's wallets, fund them with testnet USDC and take the agent live.
- [Your first payment](https://www.vestiarion.xyz/docs/guides/first-payment.md): Add a counterparty and an invoice, run a cycle, and follow the payment to the explorer and the ledger.
- [Pay a contractor for delivered work](https://www.vestiarion.xyz/docs/guides/pay-a-contractor.md): Add a milestone, verify the work by hand or by a merged pull request, and let the agent release the pay.
- [Get paid as a freelancer](https://www.vestiarion.xyz/docs/guides/get-paid.md): For the person being paid: add your wallet address through the link a business sent, follow each step, and check the payment on Arc testnet.
- [Get the agent's decisions in Telegram](https://www.vestiarion.xyz/docs/guides/telegram.md): Connect your own Telegram chat to a workspace: the agent's decisions as it makes them, what is safe to spend and waiting, and invoices sent to the bot.
- [Add invoices by email](https://www.vestiarion.xyz/docs/guides/email-invoices.md): Turn on a workspace address, forward suppliers' invoices to it, and add each one from AP / AR with one press; nothing arrives as a payable by itself.
- [Get the agent's decisions in Slack](https://www.vestiarion.xyz/docs/guides/slack.md): Connect a workspace to a Slack channel: the agent's decisions as it makes them, /vestiarion for what is safe to spend and waiting, and stopped payments decided from Slack when an owner allows it.
- [Add invoices from your own system](https://www.vestiarion.xyz/docs/guides/api-invoices.md): Create a read-and-write API key, add a counterparty and an invoice through the API, confirm the address, and follow the agent's decision.
- [Pay for merged pull requests](https://www.vestiarion.xyz/docs/guides/api-milestones.md): Add a contractor, a payee link and a milestone through the API, and the agent pays once the pull request is merged. With a GitHub Actions workflow.
- [Show payments on GitHub](https://www.vestiarion.xyz/docs/guides/github.md): Connect GitHub so a milestone paid for a pull request gets a comment on it, pull requests in private repositories verify, and a maintainer attaches a bounty with a comment.
- [Verify an audit export](https://www.vestiarion.xyz/docs/guides/audit-export.md): Download a workspace's signed ledger and check it with a standalone verifier.
- [When the model and the policy disagree](https://www.vestiarion.xyz/docs/research/model-vs-policy.md): Production decisions beside the written policy's answer to the same facts: where they differed, and where code refused the model.
- [Quickstart](https://www.vestiarion.xyz/docs/get-started/quickstart.md): Create a workspace API key and make your first requests.
- [TypeScript SDK](https://www.vestiarion.xyz/docs/get-started/sdk.md): A typed client for the API and its webhooks: every page, safe retries and signature checks.
- [Authentication](https://www.vestiarion.xyz/docs/get-started/authentication.md): Workspace API keys: their format, scope, revocation and use.
- [Errors](https://www.vestiarion.xyz/docs/get-started/errors.md): The error codes, their HTTP statuses and the error body.
- [Pagination](https://www.vestiarion.xyz/docs/get-started/pagination.md): Page through collections with limit and an opaque cursor.
- [Limits](https://www.vestiarion.xyz/docs/get-started/limits.md): Page sizes, backing off on 429 and 503, and how fresh the data is.
- [Endpoint overview](https://www.vestiarion.xyz/docs/api.md): Every v1 endpoint, what it answers, and the conventions they share.
- [Get workspace status](https://www.vestiarion.xyz/docs/api/get-status.md): What this workspace is, and what it can actually do.
- [List ledger entries](https://www.vestiarion.xyz/docs/api/list-ledger-entries.md): The audit chain, oldest first, as a resumable stream.
- [Verify the ledger](https://www.vestiarion.xyz/docs/api/verify-ledger.md): Replays signatures, body hashes and hash-chain continuity for the workspace the calling key belongs to.
- [List invoices](https://www.vestiarion.xyz/docs/api/list-invoices.md): The payable and receivable book, newest first, with the row id breaking equal timestamps.
- [Add an invoice](https://www.vestiarion.xyz/docs/api/create-invoice.md): Adds a payable or a receivable, checked by the rules of the console's invoice form, and recorded in the ledger as `create_invoice` with `via: "api"` and the key's id.
- [List counterparties](https://www.vestiarion.xyz/docs/api/list-counterparties.md): Vendors, clients and contractors, newest first, with the row id breaking equal timestamps.
- [Get a counterparty](https://www.vestiarion.xyz/docs/api/get-counterparty.md): One counterparty, with up to 20 recent compliance screenings, newest first.
- [Add a counterparty](https://www.vestiarion.xyz/docs/api/create-counterparty.md): Adds a vendor, contractor or client, checked by the rules of the console's form and screened as one added there: the answer's `riskLevel` is the screening's verdict, or `unscreened` when screening could not finish.
- [Create a payee link](https://www.vestiarion.xyz/docs/api/create-payee-link.md): Makes a one-time link where a vendor or contractor enters the address they are paid at, recorded in the ledger as `payee_link_created` with `via: "api"` and the key's id.
- [List milestones](https://www.vestiarion.xyz/docs/api/list-milestones.md): Contractor milestones, newest first, with the row id breaking equal timestamps: how each was verified, and whether it was paid.
- [Add a milestone](https://www.vestiarion.xyz/docs/api/create-milestone.md): Adds work a contractor is to be paid for, checked by the rules of the console's Add milestone form, and recorded in the ledger as `create_milestone` with `via: "api"` and the key's id.
- [Get the treasury](https://www.vestiarion.xyz/docs/api/get-treasury.md): The workspace's accounts and reserve position, its obligations from the latest cycle snapshot, the latest liquidity forecast, and up to 20 recent treasury moves.
- [Get insights](https://www.vestiarion.xyz/docs/api/get-insights.md): The telemetry behind the Insights page: recent transfers, cycle runs, cycle snapshots, treasury moves and screenings.
- [Webhooks overview](https://www.vestiarion.xyz/docs/webhooks.md): Signed webhooks that push each ledger entry to your endpoint.
- [Payload and headers](https://www.vestiarion.xyz/docs/webhooks/payload.md): The body and headers of every webhook delivery.
- [Verifying signatures](https://www.vestiarion.xyz/docs/webhooks/verify.md): Check a delivery's signature, and a ledger entry's Ed25519 signature.
- [Retries and disabling](https://www.vestiarion.xyz/docs/webhooks/retries.md): How a failed delivery is retried, and when an endpoint is disabled.
- [Security](https://www.vestiarion.xyz/docs/webhooks/security.md): Which endpoint URLs are accepted, how long deliveries are kept, and who sees them.
- [Delivery guarantees](https://www.vestiarion.xyz/docs/webhooks/guarantees.md): At-least-once and out-of-order delivery, and how a receiver handles both.
- [AI integration](https://www.vestiarion.xyz/docs/ai-integration.md): Markdown views, llms.txt and the OpenAPI document, for coding agents.
- [MCP server](https://www.vestiarion.xyz/docs/ai-integration/mcp.md): Connect an AI agent to your workspace's records through MCP tools: every API read, and with a read-and-write key, adding counterparties, invoices, milestones and payee links.
- [Changelog](https://www.vestiarion.xyz/docs/changelog.md): Changes to the API and webhooks, newest first.

## Optional

- [OpenAPI document](https://www.vestiarion.xyz/api/v1/openapi.json)