Encumbra
Menu

Keepers & underwriters

How keepers are paid, and the repayment record underwriters can use as a reference signal.

Keeper and underwriter incentives

Two incentive loops are meant to keep the book healthy. Keepers enforce defaults. Underwriters price risk. Only the keeper loop is in the contract today. Underwriting happens off-chain, for example in the reference underwriter at src/underwriter.ts.

Keepers

  1. Lien becomes liquidatablepast due, or collateral too thin
  2. Any keeper calls liquidateliquidate / liquidateAsset
  3. Reward is paid firsteven if the lien is under water
  4. Default is settledon-chain, up to the collateral
  • Liquidation is permissionless, so anyone can enforce.
  • The reward is paid senior. This is designed to keep even a deeply under-water lien worth liquidating. The creditor can lose up to the reward even when collateral is worth more than the debt. The contract flags this ordering as intentional but pending a product-owner decision, so it is a policy choice that may be revisited.
  • For a title-backed lease the keeper buys the title at the owner's declared value. The price is fixed, not auctioned, so a keeper will only take the title if it is worth at least that value to them. The contract flags this as pending a product-owner decision too.
  • The reward is capped by MAX_FEE_BPS, which bounds the keeper's edge.

Underwriters and the data flywheel

Every lien updates a per-agent repayment record, agentStats. An underwriter can read it as a reference signal when it sets a credit limit.

Reference signal only. agentStats is credited to the agent named when a lien is opened, with no consent from that agent. A third party can open liens naming any agent and inflate or poison its record, so the contract notes it as sybil-forgeable. It must not drive real credit limits without off-chain consent checks.
FieldWhat it counts
liensOpenedLiens opened with this agent
liensSettledLiens closed with the debt repaid and never late
liensCuredLateLiens closed with the debt repaid after going past due
liensDefaultedLiens that ended in a default
totalRepaidTotal value repaid
totalBadDebtTotal value left unrecovered

See Agents: underwriting the limit for how a record earns headroom.

  1. 1More credit flowsthrough Encumbra
  2. 2Richer repayment dataon-chain, per agent
  3. 3Sharper risk pricingby underwriters
  4. 4More efficient lineslarger limits for good payers
In the reference underwriter, an agent that repays on time earns a larger line, above 100% of collateral value in the upper tiers. An agent with a default is restricted to a collateral-only line at 20-30% of collateral value.

A usage fee, if the admin sets one (the SDK default is 0), would apply to that volume. Staking for underwriters is intended but does not exist on-chain today.

Keep reading