Docs / Guides

Getting started

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)Install the buyer SDK, set a policy, fetch, claim.For API providers (sellers)Register, stake, add the middleware to your x402 server.For app buildersServices, 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: