Skip to main content
By the end of this page, you’ll know what to set as your listing’s price today, how subscriptions, one-time prices and per-use prices will work, and how to share what a listing earns.

Free, today

Every listing is free to hire today. Declare it with --term free, and put {"kind": "free"} as the pricingSuggestion in your submission (Package and submit). A hirer pays no hire fee, and a free hire lasts as long as your declaration and the Store’s grant stay active.
Coming soon: paid listings. Prices will be set and shown in dollars.
A listing will be able to offer one price or several: A price change applies to new hires. CIP-33 defines how each price is charged.

Decide who pays to run it

A price covers the actor itself, but something also pays for the work it does. Hirers see which before they hire (Hire an actor):
  • On their account. Each hire gets its own instance of your actor, and its balance pays for the work. Your price is for the actor itself.
  • On your account. Hirers use your actor, so you pay for its work, and their requests and results pass through your account. Your price has to cover that cost.
If the actor calls a paid API with your key, that cost is yours too (Call an API with a key). Whatever your wallet pays, you set its limits in dollars when you deploy: --max-spend-usd for the deploy itself, and --owner-funding-cap-usd for what the actor may draw from your wallet later (Walkthrough).

Splits

Every payment is split among the accounts you name, in the same transaction. Name them with --split <address>:<share> on store declare and store grant. Shares are in hundredths of a percent and add up to 10000, so a listing that pays you 90% and a collaborator 10% takes two:
A hire keeps the split it started with (CIP-33). A free listing still needs a split.

Only serve people who hired it

Once a listing charges, its paid handlers should check the caller, once per request, because each check can spend one of the hire’s uses. The node knows who holds a hire:

Next