ConceptsVendors

Vendors

A vendor is any address an agent pays: an API provider, a compute network, a lending pool, another agent. Each wallet keeps its own vendor list in the shared VendorRegistry contract. One wallet’s list never affects another’s, so the same address can be approved for one wallet and blocked for another.

What the owner can set

  • Approve a vendor with addVendor, giving it a category, an optional per-payment cap and an optional metadata hash.
  • Block a vendor with blockVendor. Any payment to it is refused, or freezes the wallet if the policy says so.
  • Remove a vendor with removeVendor.

Categories

Every approved vendor has one category. The policy’s allowedCategories decides which ones the agent may pay.

CategoryTypical use
APIModel, search or data APIs
COMPUTEGPU, hosting, decentralised compute
DATADatasets and feeds
SUBCONTRACTINGPaying other agents or people for work
OTHERAnything else

Per-vendor caps

A vendor’s own cap applies to each single payment to that vendor, on top of the wallet’s per-payment, daily and monthly caps.

const vendor = await arc.getVendor("0x...")
console.log(vendor.allowed, vendor.blocked, vendor.perVendorCap)