Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities-v2

api

positions

{marketId}

permit-quote

curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/positions/{marketId}/permit-quote" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanId": 5, "all": true}'

import { ethers } from 'ethers';

const base = `https://api.trusset.org/lending-external-securities-v2/api/positions/${marketId}`;
const headers = {
  'X-API-Key': 'trusset_your_key_here',
  'Content-Type': 'application/json'
};

const quoteRes = await fetch(`${base}/permit-quote`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ loanId: 5, all: true })
});
const { data: quote } = await quoteRes.json();

const { domain, types, message } = quote.typedData;
const signature = await borrowerWallet._signTypedData(domain, types, message);
const { v, r, s } = ethers.utils.splitSignature(signature);

const repayRes = await fetch(`${base}/repay`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    ...quote.repay,
    permit: { value: quote.permit.value, deadline: quote.permit.deadline, v, r, s }
  })
});
const { data: repayment } = await repayRes.json();

const hashes: string[] = [];
for (const step of repayment.steps) {
  const tx = await borrowerWallet.sendTransaction(step.transaction);
  await tx.wait();
  hashes.push(tx.hash);
}

await fetch(`${base}/repay`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ loanId: 5, txHash: hashes[repayment.confirmStepIndex] })
});

{
  "success": true,
  "data": {
    "success": true,
    "action": "SIGN_TYPED_DATA",
    "typedData": {
      "domain": {
        "name": "USD Coin",
        "version": "2",
        "chainId": 11155111,
        "verifyingContract": "0x98ad0ca091552e23c564b41c74282e5343d03e8a"
      },
      "types": {
        "Permit": [
          { "name": "owner", "type": "address" },
          { "name": "spender", "type": "address" },
          { "name": "value", "type": "uint256" },
          { "name": "nonce", "type": "uint256" },
          { "name": "deadline", "type": "uint256" }
        ]
      },
      "primaryType": "Permit",
      "message": {
        "owner": "0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3",
        "spender": "0x70a0e25c7b768b87e658348b3b577678a173e038",
        "value": "50515706763",
        "nonce": "0",
        "deadline": 1790418600
      }
    },
    "permit": {
      "value": "50515.706763",
      "deadline": 1790418600
    },
    "repay": {
      "loanId": "5",
      "all": true
    },
    "fullRepayment": true,
    "outstandingDebt": "50412.881",
    "borrowAssetSymbol": "USDC",
    "borrowAssetAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "signer": "0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3",
    "nonce": "0",
    "transactionFee": {
      "kind": "REPAY",
      "fee": "2.0",
      "feeRaw": "2000000",
      "message": "This market charges a repayment fee of about 2.0 USDC on top of the debt, taken from the payment before it reduces the loan. The amount approved and offered covers the debt, the accrual buffer and the fee, and the market pulls only what closes the loan."
    },
    "warning": "This market charges a repayment fee of about 2.0 USDC on top of the debt, taken from the payment before it reduces the loan. The amount approved and offered covers the debt, the accrual buffer and the fee, and the market pulls only what closes the loan.",
    "description": "Sign this EIP-2612 permit from the borrower wallet 0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3 over 50515.706763 USDC (the outstanding debt plus a 20 bps accrual buffer and the repayment fee), then send the repayment with all:true and the permit; the market pulls exactly the true debt and the fee and the second step clears the leftover allowance"
  }
}

{
  "success": false,
  "error": {
    "code": "PERMIT_UNSUPPORTED",
    "message": "The settlement asset USDT does not implement EIP-2612, so single-signature repayment is not available on this market. Use the approve-then-repay steps instead."
  }
}

{
  "success": false,
  "error": {
    "code": "PERMIT_DOMAIN_UNRESOLVED",
    "message": "The EIP-712 domain of USDC could not be rebuilt from its name() and version(): no candidate reproduces the token's DOMAIN_SEPARATOR, so a permit quoted here could not be verified. Sign the permit with tooling that knows the token's domain, or use the approve-then-repay steps."
  }
}

Returns the EIP-2612 permit the borrower signs to repay a loan through Repay Loan in a single transaction. A wallet cannot read the figures the permit has to carry, so the quote supplies all of them. That is the value, the token’s current nonce for the borrower, a bounded deadline and the token’s EIP-712 domain. The permit names the market as spender. The quote exists only where the settlement asset provably implements EIP-2612, and only the loan’s borrower can use it. A third party repaying someone else’s loan uses the approve-then-repay steps on Repay Loan. Signing the permit moves nothing by itself: the repayment transaction redeems it.

Path Parameters

string

required

Market ID.

Body Parameters

integer

required

On-chain loan ID. A positive integer. Accepted as a JSON number or as a numeric string.

string

Amount to repay, as a positive decimal string in borrow asset units. The permit is quoted over exactly this amount. Required unless all is true.

boolean

Quote a full repayment. The value is the live debt plus a 20 basis point accrual buffer, plus the repayment fee on that figure.

integer

How long the permit stays valid, in seconds from now. An integer from 60 to 86400. Defaults to 1800.

Sign and repay

Quote

Request the quote with the loan and either amount or all: true.

Sign

Sign typedData from the wallet named in signer, which is the loan’s borrower, and split the signature into v, r and s.

Build the repayment

Call Repay Loan with the fields in repay, plus a permit holding permit.value, permit.deadline, v, r and s.

Broadcast and confirm

Send the returned steps from the borrower’s wallet, then confirm with the hash of the step at confirmStepIndex.

A partial quote is exact: the repayment must carry the same amount. A full-repayment quote covers the debt at quote time plus the buffer, and interest keeps accruing. If the live debt plus the fee has outgrown the value by the time Repay Loan is called, it refuses with INVALID_PERMIT. If the growth only eats into the buffer, the repayment builds with a warning. The repay call also checks the signature against the borrower’s current nonce. If another permit from the borrower is redeemed on the token in between, the nonce moves and the repay call refuses this signature with INVALID_PERMIT. Request a fresh quote.

Domain resolution

A token does not expose its EIP-712 domain as a readable struct, so the API rebuilds it from name() and version(). It tries the token’s own version() first, then 1 and 2, and accepts a candidate only when it reproduces the token’s DOMAIN_SEPARATOR. The wallet therefore signs a digest the token will recover. When no candidate matches, the call returns PERMIT_DOMAIN_UNRESOLVED. Sign with tooling that knows the token’s domain, or use the approve-then-repay steps.

Response Fields

object

Show child attributes

boolean

true, nested inside data.

string

SIGN_TYPED_DATA.

object

The EIP-712 payload to sign. Pass domain, types and message straight to the wallet’s typed-data signer.

Show child attributes

object

name, version, chainId and verifyingContract, the settlement asset’s address.

object

The EIP-2612 Permit type: owner, spender, value, nonce, deadline.

string

Permit.

object

owner (the borrower), spender (the market), value in the smallest unit, nonce and deadline in unix seconds.

object

value as a decimal string in borrow asset units, and deadline in unix seconds. Carry both into the permit of the repayment.

object

The body fields for Repay Loan: loanId as a string, plus all: true or the amount.

boolean

Whether the quote covers the whole debt.

string

Principal plus accrued interest at quote time, without the repayment fee.

string

Symbol of the settlement asset.

string

Address of the settlement asset, the token the permit is signed for.

string

The loan’s borrower, the only wallet whose signature the repayment accepts.

string

The borrower’s current permit nonce on the token.

object

The repayment fee, present only when it is not zero. Same shape as on Repay Loan.

string

The fee message, present alongside transactionFee.

string

Plain-language instruction for the borrower.

curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/positions/{marketId}/permit-quote" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanId": 5, "all": true}'

import { ethers } from 'ethers';

const base = `https://api.trusset.org/lending-external-securities-v2/api/positions/${marketId}`;
const headers = {
  'X-API-Key': 'trusset_your_key_here',
  'Content-Type': 'application/json'
};

const quoteRes = await fetch(`${base}/permit-quote`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ loanId: 5, all: true })
});
const { data: quote } = await quoteRes.json();

const { domain, types, message } = quote.typedData;
const signature = await borrowerWallet._signTypedData(domain, types, message);
const { v, r, s } = ethers.utils.splitSignature(signature);

const repayRes = await fetch(`${base}/repay`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    ...quote.repay,
    permit: { value: quote.permit.value, deadline: quote.permit.deadline, v, r, s }
  })
});
const { data: repayment } = await repayRes.json();

const hashes: string[] = [];
for (const step of repayment.steps) {
  const tx = await borrowerWallet.sendTransaction(step.transaction);
  await tx.wait();
  hashes.push(tx.hash);
}

await fetch(`${base}/repay`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ loanId: 5, txHash: hashes[repayment.confirmStepIndex] })
});

{
  "success": true,
  "data": {
    "success": true,
    "action": "SIGN_TYPED_DATA",
    "typedData": {
      "domain": {
        "name": "USD Coin",
        "version": "2",
        "chainId": 11155111,
        "verifyingContract": "0x98ad0ca091552e23c564b41c74282e5343d03e8a"
      },
      "types": {
        "Permit": [
          { "name": "owner", "type": "address" },
          { "name": "spender", "type": "address" },
          { "name": "value", "type": "uint256" },
          { "name": "nonce", "type": "uint256" },
          { "name": "deadline", "type": "uint256" }
        ]
      },
      "primaryType": "Permit",
      "message": {
        "owner": "0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3",
        "spender": "0x70a0e25c7b768b87e658348b3b577678a173e038",
        "value": "50515706763",
        "nonce": "0",
        "deadline": 1790418600
      }
    },
    "permit": {
      "value": "50515.706763",
      "deadline": 1790418600
    },
    "repay": {
      "loanId": "5",
      "all": true
    },
    "fullRepayment": true,
    "outstandingDebt": "50412.881",
    "borrowAssetSymbol": "USDC",
    "borrowAssetAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "signer": "0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3",
    "nonce": "0",
    "transactionFee": {
      "kind": "REPAY",
      "fee": "2.0",
      "feeRaw": "2000000",
      "message": "This market charges a repayment fee of about 2.0 USDC on top of the debt, taken from the payment before it reduces the loan. The amount approved and offered covers the debt, the accrual buffer and the fee, and the market pulls only what closes the loan."
    },
    "warning": "This market charges a repayment fee of about 2.0 USDC on top of the debt, taken from the payment before it reduces the loan. The amount approved and offered covers the debt, the accrual buffer and the fee, and the market pulls only what closes the loan.",
    "description": "Sign this EIP-2612 permit from the borrower wallet 0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3 over 50515.706763 USDC (the outstanding debt plus a 20 bps accrual buffer and the repayment fee), then send the repayment with all:true and the permit; the market pulls exactly the true debt and the fee and the second step clears the leftover allowance"
  }
}

{
  "success": false,
  "error": {
    "code": "PERMIT_UNSUPPORTED",
    "message": "The settlement asset USDT does not implement EIP-2612, so single-signature repayment is not available on this market. Use the approve-then-repay steps instead."
  }
}

{
  "success": false,
  "error": {
    "code": "PERMIT_DOMAIN_UNRESOLVED",
    "message": "The EIP-712 domain of USDC could not be rebuilt from its name() and version(): no candidate reproduces the token's DOMAIN_SEPARATOR, so a permit quoted here could not be verified. Sign the permit with tooling that knows the token's domain, or use the approve-then-repay steps."
  }
}

Error Codes

Code	HTTP	Cause
`NO_MARKET_ADDRESS`	`400`	The market has no on-chain address recorded
`MISSING_MARKET_ID`	`400`	`marketId` is longer than 100 characters
`VALIDATION_ERROR`	`400`	`loanId` is not a positive integer, neither `amount` nor `all: true` was supplied, `amount` is malformed or carries more decimal places than the borrow asset supports, or `deadlineSeconds` is not an integer from `60` to `86400`
`LOAN_NOT_ACTIVE`	`400`	The loan is closed and can no longer be repaid
`NO_OUTSTANDING_DEBT`	`400`	`all` was set on a loan that owes nothing
`PERMIT_QUOTE_FAILED`	`400`	The quote could not be prepared and no more specific code applied
`LOAN_NOT_FOUND`	`404`	No such loan on this market
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance
`PERMIT_UNSUPPORTED`	`409`	The settlement asset does not implement EIP-2612, or its support could not be verified. Use the approve-then-repay steps
`PERMIT_DOMAIN_UNRESOLVED`	`409`	No domain rebuilt from the token’s `name()` and `version()` reproduces its `DOMAIN_SEPARATOR`
`LOAN_STATE_UNAVAILABLE`	`503`	The loan could not be read from the network right now. Retry shortly
`MARKET_STATE_UNAVAILABLE`	`503`	The market’s transaction fees could not be read. Retry shortly
`PERMIT_UNVERIFIABLE`	`503`	The token’s permit domain or the borrower’s nonce could not be read or decoded. Retry, or use the approve-then-repay steps

curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/positions/{marketId}/permit-quote" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanId": 5, "all": true}'

import { ethers } from 'ethers';

const base = `https://api.trusset.org/lending-external-securities-v2/api/positions/${marketId}`;
const headers = {
  'X-API-Key': 'trusset_your_key_here',
  'Content-Type': 'application/json'
};

const quoteRes = await fetch(`${base}/permit-quote`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ loanId: 5, all: true })
});
const { data: quote } = await quoteRes.json();

const { domain, types, message } = quote.typedData;
const signature = await borrowerWallet._signTypedData(domain, types, message);
const { v, r, s } = ethers.utils.splitSignature(signature);

const repayRes = await fetch(`${base}/repay`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    ...quote.repay,
    permit: { value: quote.permit.value, deadline: quote.permit.deadline, v, r, s }
  })
});
const { data: repayment } = await repayRes.json();

const hashes: string[] = [];
for (const step of repayment.steps) {
  const tx = await borrowerWallet.sendTransaction(step.transaction);
  await tx.wait();
  hashes.push(tx.hash);
}

await fetch(`${base}/repay`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ loanId: 5, txHash: hashes[repayment.confirmStepIndex] })
});

{
  "success": true,
  "data": {
    "success": true,
    "action": "SIGN_TYPED_DATA",
    "typedData": {
      "domain": {
        "name": "USD Coin",
        "version": "2",
        "chainId": 11155111,
        "verifyingContract": "0x98ad0ca091552e23c564b41c74282e5343d03e8a"
      },
      "types": {
        "Permit": [
          { "name": "owner", "type": "address" },
          { "name": "spender", "type": "address" },
          { "name": "value", "type": "uint256" },
          { "name": "nonce", "type": "uint256" },
          { "name": "deadline", "type": "uint256" }
        ]
      },
      "primaryType": "Permit",
      "message": {
        "owner": "0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3",
        "spender": "0x70a0e25c7b768b87e658348b3b577678a173e038",
        "value": "50515706763",
        "nonce": "0",
        "deadline": 1790418600
      }
    },
    "permit": {
      "value": "50515.706763",
      "deadline": 1790418600
    },
    "repay": {
      "loanId": "5",
      "all": true
    },
    "fullRepayment": true,
    "outstandingDebt": "50412.881",
    "borrowAssetSymbol": "USDC",
    "borrowAssetAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
    "signer": "0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3",
    "nonce": "0",
    "transactionFee": {
      "kind": "REPAY",
      "fee": "2.0",
      "feeRaw": "2000000",
      "message": "This market charges a repayment fee of about 2.0 USDC on top of the debt, taken from the payment before it reduces the loan. The amount approved and offered covers the debt, the accrual buffer and the fee, and the market pulls only what closes the loan."
    },
    "warning": "This market charges a repayment fee of about 2.0 USDC on top of the debt, taken from the payment before it reduces the loan. The amount approved and offered covers the debt, the accrual buffer and the fee, and the market pulls only what closes the loan.",
    "description": "Sign this EIP-2612 permit from the borrower wallet 0xaBc7f1093D5E26B804a1C3f78dE025916B47C0d3 over 50515.706763 USDC (the outstanding debt plus a 20 bps accrual buffer and the repayment fee), then send the repayment with all:true and the permit; the market pulls exactly the true debt and the fee and the second step clears the leftover allowance"
  }
}

{
  "success": false,
  "error": {
    "code": "PERMIT_UNSUPPORTED",
    "message": "The settlement asset USDT does not implement EIP-2612, so single-signature repayment is not available on this market. Use the approve-then-repay steps instead."
  }
}

{
  "success": false,
  "error": {
    "code": "PERMIT_DOMAIN_UNRESOLVED",
    "message": "The EIP-712 domain of USDC could not be rebuilt from its name() and version(): no candidate reproduces the token's DOMAIN_SEPARATOR, so a permit quoted here could not be verified. Sign the permit with tooling that knows the token's domain, or use the approve-then-repay steps."
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Get Permit Quote

Path Parameters

Body Parameters

Sign and repay

Domain resolution

Response Fields

Error Codes

​Path Parameters

​Body Parameters

​Sign and repay

​Domain resolution

​Response Fields

​Error Codes

Path Parameters

Body Parameters

Sign and repay

Domain resolution

Response Fields

Error Codes