# Getting started

> Pick your track: make an agent pay only bonded x402 services, add a stake-backed warranty to your x402 API, or read bonds and claims from any app over HTTP.

*LOPW documentation · Guides.* Canonical page: https://lopw.com/docs/getting-started.html · This Markdown twin: https://lopw.com/docs/getting-started.md · Index of all pages: https://lopw.com/llms.txt · Everything in one file: https://lopw.com/llms-full.txt

Three tracks. If you run an agent, make it pay only services that stand behind their promises. If you run a paid API, back your promise with stake and win the agents that check. If you build apps, read every bond and claim over plain HTTP.

- [For agents (buyers)](https://lopw.com/docs/guides/agents.html): Install the buyer SDK, set a policy, fetch, claim.
- [For API providers (sellers)](https://lopw.com/docs/guides/sellers.html): Register, stake, add the middleware to your x402 server.
- [For app builders](https://lopw.com/docs/guides/apps.html): Services, claims, events and live streams from the public API.

## Before you start

> **Amounts**
>
> Amounts are integers in the stake token’s smallest unit. USDC uses 7 decimals, so `10_000_000n` is 1 USDC and `100n * 10_000_000n` is 100 USDC. The SDKs use `bigint` for every amount; the HTTP API returns amounts as decimal strings.

Packages: `@lopw/buyer-sdk` for agents, `@lopw/seller-middleware` for sellers, and `@lopw/protocol` (types, encoding, hashing, local predicate evaluation and the Stellar binding) used by both. Access is for approved integrators.

Networks: the Stellar binding ships with `STELLAR_TESTNET` (contract addresses included) and `STELLAR_MAINNET` (addresses supplied by you once a mainnet deployment exists). `getNetwork(name)` resolves one by name and applies `LOPW_NETWORK`, `LOPW_REGISTRY`, `LOPW_CLAIMS`, `STELLAR_RPC_URL` and `LOPW_ORACLE` from the environment when set.

## How-to guides

Task-sized recipes once you are set up:

- [Add a warranty to an x402 API](https://lopw.com/docs/guides/add-warranty.html)
- [Make an agent pay only bonded services](https://lopw.com/docs/guides/bonded-only.html)
- [File a claim](https://lopw.com/docs/guides/file-claim.html)
- [Choose predicates and limits](https://lopw.com/docs/guides/predicates-limits.html)
- [Rotate a signing key](https://lopw.com/docs/guides/rotate-key.html)
- [Withdraw stake safely](https://lopw.com/docs/guides/unbonding.html)
- [Read a bond from any app](https://lopw.com/docs/guides/read-bond.html)
- [Run the scenarios yourself](https://lopw.com/docs/guides/run-scenarios.html)
