> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles and signatures

> The ten roles on a lending market, who receives each one at adoption, and which wallet signs every step.

Every write on a market is a transaction that one wallet signs. This page lists the ten roles a lending market runs on, who receives each one, and which role or party signs each step. [How lending works](https://docs.trusset.org/protocol/concepts/how-lending-works.md) defines the objects named here, and [Operators](https://docs.trusset.org/endpoints/operators/introduction.md#roles) is the reference for the same roles.

Trusset holds none of these roles and never signs for another party. The API builds each transaction, the named wallet signs and broadcasts it, and the API verifies the mined receipt before recording anything.

## The ten market roles

A market starts with no role holders. The lender of record names them when it takes the market, in one transaction. The guardian is the only role granted afterwards. The first four sit on the market and the next two on its liquidation router. The price signer and the oracle owner act on the price oracle, and the last two own the rate model and the insurance fund.

| Role | Named at adoption as | What it can do | Example holder |
| - | - | - | - |
| Market admin (`MARKET_ADMIN`) | `admin` | Grants and revokes the market's roles, pauses and resumes the market, sets identity registers, vault liquidity and the auction venue, confirms loan extensions, writes off timed-out liquidations, and announces upgrades of the market and its rate model | The lender of record, usually the bank operating the market |
| Issuer (`MARKET_ISSUER`) | `issuer` | Sets the risk parameters, loan terms and reserve ratio, and proposes loan extensions | The bank's credit or risk desk |
| Liquidator (`MARKET_LIQUIDATOR`) | `liquidator`, optional. The signing wallet when omitted | Starts the liquidation of a loan that is unhealthy or past its term | A collateral management desk, a liquidation agent or a liquidation bot |
| Guardian (`MARKET_GUARDIAN`) | Not named. The market admin grants it after adoption | Pauses the market, halts prices for at most 24 hours and removes a price signer. Nothing else | The bank's security or incident response team |
| Router admin (`ROUTER_ADMIN`) | `admin` | Grants and revokes the router's roles, authorizes the market, changes the sale recipient, writes off and reopens liquidations, returns collateral to a borrower, and announces router upgrades | The lender of record |
| Router operator (`ROUTER_OPERATOR`) | `liquidationOperator` | Withdraws seized collateral to the sale recipient, reports sales and settles liquidations | A broker or trading desk that sells the collateral |
| Price signer (`ORACLE_SIGNER`) | `priceSigner` | Pushes prices and signs price quotes, within the oracle's deviation bound | A valuation agent, a fund administrator, an auditor or the bank's pricing desk |
| Oracle owner | `oracleOwner` | Everything a price signer can do, plus adding and removing signers, setting the staleness window and deviation bound, lifting a price halt and announcing oracle upgrades | The bank's pricing or risk function |
| Rate model owner | `issuer` | Sets the interest curve, the rate mode and the fixed-rate ceiling | The bank's treasury or ALM desk |
| Insurance fund owner | `admin` | Announces, cancels and executes withdrawals from the reserve, each after a seven-day notice, and announces fund upgrades | The bank's treasury or risk function |

Two adoption fields therefore carry more than one role. The `admin` wallet becomes market admin, router admin and insurance fund owner. The `issuer` wallet becomes issuer and rate model owner. [Set Access Role](https://docs.trusset.org/endpoints/operators/set-access-role.md) later grants or revokes the seven roles that sit on the market, the router and the oracle, and [Get Access Role](https://docs.trusset.org/endpoints/operators/get-access-role.md) checks any address.

## Loan approver

A market can run [approve-only loans](https://docs.trusset.org/endpoints/lending/loan-approvals.md), where every draw needs the lender of record's approval. The market admin signs approvals, and so does any wallet that holds `LOAN_APPROVER_ROLE`.

`LOAN_APPROVER_ROLE` approves and revokes loan approvals, nothing else. It is granted and revoked by the market admin.

## Named at adoption, but not roles

Adoption also names two addresses that carry no capability on the market.

**Collateral agent** (`collateralAgent`). Recorded as the pledgee on every collateral lock. It can do nothing on the market, the adapter or the router.

**Sale recipient** (`saleRecipient`). Where seized collateral goes when the router operator withdraws it for sale.

The wallet that signs the adoption becomes the **operator wallet**. It is the only address besides registered vaults that deposits into the pool directly, and it receives the operator share of interest. It moves only by its own signature, with [Rotate Operator Wallet](https://docs.trusset.org/endpoints/lending/rotate-operator-wallet.md).

## Other parties

These parties act on a market without holding any of its roles.

| Party | Who | What they sign |
| - | - | - |
| Deployer | The instance that imported the token and deployed the market, often a tokenization platform | The deployment and its nominations |
| Token agent | The agent or identity registry operator of the collateral token, outside Trusset | The authorizations that let the market's contracts hold or freeze the token |
| Borrower | A client of a fintech or of the bank | Its own loans, draws and collateral |
| Depositor | An investor in one of the lender of record's vaults | Its own deposits and redemptions |
| Distributor | The instance whose deposit call brought the depositor | Nothing on the market. It earns the distributor share once the vault owner approves it |
| Register provider | The keeper of the token's register | The register entry, in its own register |

The deployer can name the register provider of the collateral token on the market, with [Set Market Register](https://docs.trusset.org/endpoints/asset-register/set-market-register.md) or on the page of the market in the Issuer Portal, under Asset register. That assignment is a record beside the market and not an eleventh role. It grants nothing on the market, the adapter or the router, and the lending contracts never read it. The register belongs to the token, so only the deployer names or clears it, and the lender of record reads it. The named register provider takes the market into its own instance with [Import Market](https://docs.trusset.org/endpoints/asset-register/import-market.md). From then on it reads the pledge record and receives each change as a [pledge webhook](https://docs.trusset.org/endpoints/asset-register/pledge-webhooks.md).

## Who signs each step

| Step | Signed by | Endpoint |
| - | - | - |
| Deploy the market | Deployer | [Deploy Market](https://docs.trusset.org/endpoints/lending/deploy-market.md) |
| Nominate a candidate | Deployer, or Trusset's factory owner | [Nominate Candidate](https://docs.trusset.org/endpoints/lending/nominate-candidate.md) |
| Authorize the market's contracts on the token | Token agent | [Configure Market](https://docs.trusset.org/endpoints/lending/configure-market.md) |
| Take the market | The lender of record's wallet, which becomes the operator wallet | [Accept Lender Role](https://docs.trusset.org/endpoints/operators/accept-lender-role.md) |
| Set risk parameters, loan terms and the reserve ratio | Issuer | [Update Market Config](https://docs.trusset.org/endpoints/lending/update-config.md), [Set Term Config](https://docs.trusset.org/endpoints/lending/set-term-config.md), [Set Reserve Ratio](https://docs.trusset.org/endpoints/lending/set-reserve-ratio.md) |
| Set the rate mode and the fixed-rate ceiling | Rate model owner | [Set Rate Mode](https://docs.trusset.org/endpoints/lending/set-rate-mode.md), [Set Max Fixed Rate](https://docs.trusset.org/endpoints/lending/set-max-fixed-rate.md) |
| Install the borrower and provider registers | Market admin | [Set Identity Gates](https://docs.trusset.org/endpoints/lending/set-identity-gates.md) |
| Connect vault liquidity | Market admin | [Set Vault Liquidity](https://docs.trusset.org/endpoints/lending/set-vault-liquidity.md), [Register Vault](https://docs.trusset.org/endpoints/lending/register-vault.md) |
| Grant or revoke a role | Market admin for market roles, router admin for router roles, oracle owner for price signers | [Set Access Role](https://docs.trusset.org/endpoints/operators/set-access-role.md) |
| Propose and confirm a loan extension | Issuer proposes, market admin confirms | [Propose Extension](https://docs.trusset.org/endpoints/lending/propose-extension.md), [Extension Action](https://docs.trusset.org/endpoints/lending/extension-action.md) |
| Publish terms of use | No signature. A database write by an instance whose wallet is the lender of record, market admin or issuer | [Save Terms](https://docs.trusset.org/endpoints/lending/save-terms.md) |
| Push a price | Price signer or oracle owner | [Sync Oracle Price](https://docs.trusset.org/endpoints/lending/sync-oracle.md) |
| Fund the pool directly | Operator wallet | [Add Liquidity](https://docs.trusset.org/endpoints/lending/add-liquidity.md) |
| Deposit into a vault | Depositor | [Deposit](https://docs.trusset.org/endpoints/vaults/deposit.md) |
| Switch approve-only loans on or off | Market admin | [Set Loan Approvals](https://docs.trusset.org/endpoints/lending/set-loan-approvals.md) |
| Approve a loan request, revoke an approval | Market admin, or a holder of `LOAN_APPROVER_ROLE` | [Approve Loan Request](https://docs.trusset.org/endpoints/lending/approve-loan-request.md), [Revoke Loan Approval](https://docs.trusset.org/endpoints/lending/revoke-loan-approval.md) |
| Revoke every open approval at once | Market admin | [Revoke All Loan Approvals](https://docs.trusset.org/endpoints/lending/revoke-all-loan-approvals.md) |
| Open a loan, draw more, add collateral | Borrower | [Open Loan](https://docs.trusset.org/endpoints/lending/open-loan.md), [Borrow More](https://docs.trusset.org/endpoints/lending/borrow-more.md), [Add Collateral](https://docs.trusset.org/endpoints/lending/add-collateral.md) |
| Repay | Any wallet. The collateral always returns to the borrower | [Repay Loan](https://docs.trusset.org/endpoints/lending/repay.md) |
| Start a liquidation | Liquidator | [Liquidate Loan](https://docs.trusset.org/endpoints/lending/liquidate.md) |
| Withdraw seized collateral for sale, report and settle | Router operator | [Withdraw Collateral for Sale](https://docs.trusset.org/endpoints/lending/withdraw-collateral-for-sale.md), [Report Partial Sale](https://docs.trusset.org/endpoints/lending/report-partial-sale.md), [Settle Liquidation](https://docs.trusset.org/endpoints/lending/settle-liquidation.md) |
| Switch the router to atomic sale | Router admin | [Set Atomic Mode](https://docs.trusset.org/endpoints/lending/set-atomic-mode.md) |
| Write off a liquidation unsettled for 7 days | Market admin | [Handle Liquidation Timeout](https://docs.trusset.org/endpoints/lending/handle-timeout.md) |
| Close or reopen a router record | Router admin | [Close Liquidation](https://docs.trusset.org/endpoints/lending/close-liquidation.md), [Reopen Liquidation](https://docs.trusset.org/endpoints/lending/reopen-liquidation.md) |
| Pause the market | Guardian or market admin. Only the market admin resumes it | [Pause Market](https://docs.trusset.org/endpoints/lending/pause-market.md) |
| Halt prices | Guardian. The oracle owner lifts the halt, or it ends by itself | [Halt Prices](https://docs.trusset.org/endpoints/lending/halt-prices.md) |
| Withdraw from the insurance fund | Insurance fund owner, after a seven-day notice | [Withdraw from Insurance Fund](https://docs.trusset.org/endpoints/lending/withdraw-insurance.md) |
| Top up the insurance fund | Any wallet | [Top Up Insurance Fund](https://docs.trusset.org/endpoints/lending/top-up-insurance.md) |
| Announce an upgrade | Market admin for the market and its rate model, router admin for the router, oracle owner for the oracle, insurance fund owner for the fund | [Upgrade Market](https://docs.trusset.org/endpoints/lending/upgrade-market.md) |
| Collect and pay distributor fees | Any wallet. The vault pays the distributor, never the signer | [Collect Distributor Fees](https://docs.trusset.org/endpoints/vaults/collect-distributor-fees.md), [Pay Distributor](https://docs.trusset.org/endpoints/vaults/pay-distributor.md) |
| Name the asset register of the collateral token | No signature. A database write by the deployer | [Set Market Register](https://docs.trusset.org/endpoints/asset-register/set-market-register.md) |
| Record the pledge in the register | Register provider, in its own register | [List Pledges](https://docs.trusset.org/endpoints/asset-register/list-pledges.md) and [Pledge Webhooks](https://docs.trusset.org/endpoints/asset-register/pledge-webhooks.md) supply the facts |

## Where each audience starts

A bank's first signature is the adoption. From then on, the wallets it named sign every configuration change. [Launch a credit line](https://docs.trusset.org/protocol/guides/launch-a-credit-line.md) walks through them in order.

A tokenization platform signs the deployment and, when it is the token agent, the authorizations on the token. [Open a market for your asset](https://docs.trusset.org/protocol/guides/open-a-market.md) covers both.

A fintech app holds no market role. Its clients sign deposits, loans and repayments from their own wallets, and the app's instance builds each transaction. [Embed earn and borrow](https://docs.trusset.org/protocol/guides/embed-earn-and-borrow.md) shows the flow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.