Skip to main content
This guide is for a bank that will act as lender of record. By the end you hold a market, have set its limits and gates, funded it, and chosen how seized collateral is sold. Each step names the decision you make and links the endpoint that carries it out. How lending works defines the terms used here. Before you start, you need an instance with a registered wallet, and Trusset’s approval as a lender of record. Without the approval, taking a market is refused with CURATOR_NOT_APPROVED.

1. Choose the market

Markets reach you two ways. A deployer nominates your institution, or offers the market to any approved lender. List Queued Markets returns both, with canAccept saying whether your instance can take each one. Get Queued Market is the credit file. It shows the collateral token as the chain reports it and as the issuer published it. It adds the offering, the terms status and the asset data the issuer attested, and ends with a deterministic review. Three things were fixed at deployment and cannot change: A MARKET-priced market needs a borrower register that admits professional clients only, and refuses Dutch auctions. A FIXED price never goes stale, and it rules out the free-hand exchange sale.

2. Take the role and name the parties

Accept Lender Role builds the adoption. It assigns the market’s roles to the wallets you name: You also name the collateral agent, recorded as pledgee on every lock, and the sale recipient that receives seized collateral. Neither holds a role. Roles and signatures says what each role can do. Then you declare the realization mode:
  • EXCHANGE_SALE: seized collateral is sold on a market.
  • ISSUER_REDEMPTION: the issuer redeems it.
  • AUCTION: it is sold through the market’s Dutch auction.
Adoption is final, and every address in it receives its role in the same transaction. Check each one before signing. The wallet that signs becomes the market’s operator wallet. After it mines, Confirm Lender Role records the market and returns the market.id every later call takes. Your market admin then grants a guardian with Set Access Role: an emergency wallet that can pause the market, halt prices for at most 24 hours and remove a price signer, and nothing else.

3. Set the limits

Your issuer role sets the risk parameters with Update Market Config. Defaults are seeded at deployment. While loans are open, the liquidation threshold moves at most 10 percentage points per call and at most once every 24 hours. Lowering it immediately puts loans at risk that were healthy a moment earlier. Then decide the loan shape. Your issuer sets the maximum duration, a terminal due date and the grace period, 3 days by default, with Set Term Config, and holds back up to 50 percent of the pool from borrowing with Set Reserve Ratio. Your rate model owner, the same issuer wallet, chooses a utilization curve, a capped curve or a fixed rate stamped per loan with Set Rate Mode. A fixed rate needs loan terms. Publish your terms of use with Save Terms. A loan on a market without them is not refused, but its calldata carries a warning.

4. Decide who borrows and who funds

Your market admin installs two registers with Set Identity Gates. The borrower register examines every loan and every further draw. The provider register examines every vault depositor. Choose one kind for each: A MARKET-priced market needs a professional-only profile as its borrower gate, never a whitelist. A whitelist becomes a provider gate only with your attestation that it lists identified wallets only. To read a fintech’s KYC files before you list its clients, add its verifier as a KYC source bound to your whitelist. The verifier seals each file with KYC Courier so only your bank can open it, and approving a file lists the wallet. Set up the receiving side with the KYC Courier bank walkthrough. Onboarding and access maps every onboarding path to these gates.

5. Price the collateral

On a NAV or MARKET market your price signer publishes prices with Sync Oracle Price. A price older than maxPriceAge, 24 hours by default, blocks new loans, further draws and liquidations. Repayment never waits on a price, so a missed push freezes growth without trapping borrowers. A signer that keeps its key outside your instance signs with Sign Price or posts its attestation to Record Price Attestation.

6. Fund the market

Your operator wallet deposits first with Add Liquidity. The first deposit into an empty pool must be at least 1,000 whole units of the settlement token. Everyone else funds through your vaults. Create a vault in the Issuer Portal and allocate it to the market. A market can also draw on the vault when a loan needs liquidity. Your market admin switches that on with Set Vault Liquidity and Register Vault, and you set a cap for the market in the portal. An instance runs at most three live vault products. Fintech apps bring depositors to your vaults. Approve each one with Set Distributor Approval, and the deposits it brings credit it the fixed distributor share. A deposit brought by a fintech you have not approved still goes through, and that share goes to you. Nothing a fintech does changes your vault or market settings.

7. Check readiness, then lend

Get Configuration Status reports what is still outstanding, including token-side authorizations that the token’s agent must sign. Direct borrowers at the market only once it reports ready.

8. Watch the book and realize collateral

Hooks run risk monitors on a schedule and send signed notices. Get Liquidatable Loans lists every position that can be liquidated now, with its trigger: health, term, or both. Liquidation needs the liquidator role, which your market admin grants with Set Liquidator Role to a desk or a liquidation bot. What follows depends on your route:
  • Two-step router, where every router starts. Seized collateral waits on the router. Your router operator withdraws it to the sale recipient, sells it off-platform, reports the proceeds and settles.
  • Atomic sale, for MARKET-priced markets with EXCHANGE_SALE. The sale recipient buys at its standing bid inside the liquidation. Your router admin switches it on with Set Atomic Mode.
  • Dutch auction. Bidders buy from the market’s auction venue at a decaying price. Your market admin wires it with Wire Auction Module.
Your market admin can write off a liquidation left unsettled for 7 days against the insurance fund with Handle Liquidation Timeout. Write-off does not recover collateral from the router, so dispose of or return the collateral first.

9. Collect fees and run the market

The operator share, 8 percent of interest after Trusset’s fee, leaves through Sweep Operator Fees to your operator wallet. Your issuer proposes loan extensions and your market admin confirms them. Your insurance fund owner withdraws from the reserve only after a seven-day notice. Every upgrade of the market and its contracts is announced 7 days before it executes, so borrowers and providers can exit first.

Next

Embed earn and borrow shows what a fintech builds on top of your market. Operators and Lending are the full reference.