Imported from priors-agents/priors (
docs/AGENTS.md). Install upstream withnpx skills add priors-agents/priors --skill docs. Copyright stays with the author.
Priors for agent builders
Three calls give an agent a credit history nobody can forge. The SDK is a thin ethers v6 wrapper in
sdk/priors.mjs, the raw ABI is in the same file if you would rather call the contract, and the CLI in
bin/priors.mjs is one subcommand per step.
Everything below is the same procedure the skill (skills/priors/SKILL.md) hands to a coding agent. This page
is for you reading it yourself.
0. A chain, and a wallet
npm install
npm run quickstart # local chain, deployed pool, one agent taken through the whole recordThat is the fastest way to see what you are integrating with: it starts anvil, deploys the pool with its mocks, lends it money, funds the first-loss reserve, stakes the treasury, and then registers an agent, takes its first line, borrows, repays and prints the score.
Against a real chain, set RPC_URL and PRIVATE_KEY in .env and run npx priors doctor first. The wallet
needs native gas and enough USDG to cover loan fees. The pool never sees your keys — only the agent id.
1. Get a first line
An ERC-8004 identity that has never been enrolled can take a first line of $5 from the treasury, and it
takes two people: someone the treasury's owner has named signs an invite for your agent id, and you, its
controller, redeem it. Registration is still open to anyone; treasury money is not.
import { Priors } from "priors";
const s = new Priors({ rpc, pool, treasury, signer }); // signer owns the ERC-8004 id (or is its delegate)
await s.firstLine(agentId, inviteCode); // priors-invite:<id>:<expiry>:<signature>Ask for a code at priors.trade/invite. A code names one agent id and expires;
one code seats that agent once. If you hold an inviter key yourself, s.signInvite(agentId, hours) makes one.
The treasury vouches out of its own stake, capped per 7-day epoch. If the cap is spent, wait for the next one
or find a sponsor: any root sponsor can vouch() for you with a larger line, no invite involved.
Why the gate exists: a fresh identity costs cents, so treasury money handed to one unconditionally is a faucet, however tightly it is rate-limited. The invite is what makes a seat cost someone's judgement.
No identity yet? await s.register(uri) mints one on registries that expose register(string).
2. Borrow, hold, repay
const { fee, qualifiesForScore } = await s.quote(5, 7); // 1% per 30 days, pro rata
const loanId = await s.borrow(agentId, 5, 7); // $5 for 7 days, USDG lands in your wallet
// ... do work ...
await s.repay(loanId); // principal + feeLoans shorter than the minimum scoring term (7 days) are real loans, but they do not count as qualified loans for the score. The score rewards dollar-days: how much you borrowed, times how long you held it, summed over everything you repaid. Churning one-day loans gets you nowhere. Holding real money for real time does.
3. Grow
After three qualified loans, fourteen days on the ledger and a clean record, anyone can call raise(agentId)
and the treasury lifts the line to $50. Repaying also earns capacity of your own — 50% of repaid principal,
at most $25 per epoch and $250 in total — and an agent with earned capacity can vouch for other agents.
Losses flow up the tree, so vouch carefully.
Reading the score
await s.score(agentId); // 0..1000
await s.report(agentId); // every input the score is computed from
await s.loans(agentId); // every loan, with statusOr from any contract: score(uint256) on the pool. Every input is a public event you can recompute yourself.
What ends it
Miss a due date by more than three days and anyone can mark the loan defaulted. The score goes to zero forever, the identity can never borrow or vouch again, and the sponsor eats the loss. There is no appeal, which is the point.
Before you integrate for real
A lender-loss defect in default accounting was found and fixed, and no independent review of the economics has happened yet. Read the Status section of the README first — it explains both.