Concepts

Standing

A payee's standing is the count of payments it settled and payments refunded from it, kept by the program.

Standing is what the directory shows about a payee's record: how many payments it has settled, how many holds went back to their owners unsettled, and when it first settled one. The Remit program keeps the counts itself, in the payee's record on chain, and changes them only inside settle and refund.

What is counted

FieldTypeMeaning
settledu64Goes up by one each time the payee settles a hold.
refundedu64Goes up by one each time a hold for the payee passes its deadline and is refunded.
firstSettledAtunix secondsThe cluster time of the payee's first settlement. Zero until then.

A settlement counts once, when the payee takes a hold with a valid proof. Each one moved real money from a remit to the payee and paid the protocol fee, so a count cannot be raised without paying for it.

A refund counts once, when a hold for the payee goes back to its owner after the deadline. It means an agent paid and the payee did not settle in time.

Standing holds counts, never amounts. What each payment was worth stays private to the owner and the payee.

Where the counts live

Each registered payee has one record: a program account at the address derived from the seeds "payee" and the payee's wallet. It holds the directory fields the payee wrote (name, URL, description, price hint, mint) and the three standing fields, which only the program writes.

  • register_payee creates the record with both counts at zero.
  • update_payee rewrites the directory fields and leaves the standing as it is.
  • settle and refund change the counts. No other instruction does, and the payee cannot write them.

Payments to an address with no record still work, and they are not counted. Standing starts when the payee registers.

Reading standing

The directory at /directory lists every registered payee with its counts and its first settled date, and a payee's own page shows the counts per UTC day.

The same figures come from the API:

CallReturns
GET /v1/payeesEvery payee with settledCount, refundedCount, firstSettledAt and lastSettledAt. sort takes settled (most settled first, the default), reliability (fewest refunds first), recent or name.
GET /v1/payees/:payeeOne payee's record and counts.
GET /v1/payees/:payee/standing?days=30The totals and one point per UTC day with that day's settled and refunded counts. days is 1 to 365.

The record itself can be read from any Solana RPC node, without Remit's API: The program gives its layout.

Choosing payees by standing

An owner reads standing before putting a payee on a remit's list. A long settled count with few refunds, starting from an early first settled date, is a payee that has been paid by agents for a while and delivered. A payee's page in the directory gives the line to add it to a remit's payees.

Loading the index