Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

vaults

{vaultId}

deposit

curl -X POST "https://api.trusset.org/lending-external-securities/api/vaults/{vaultId}/deposit" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"amount": "1000", "holderAddress": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab"}'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/vaults/${vaultId}/deposit`,
  {
    method: 'POST',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ amount: '1000', holderAddress: wallet })
  }
);
const { data } = await res.json();
for (const step of data.steps) {
  const tx = await signer.sendTransaction({ to: step.to, data: step.data });
  await tx.wait();
}

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTIONS",
    "steps": [
      {
        "to": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
        "data": "0x095ea7b3...",
        "description": "Approve the vault to pull 1000 USDC"
      },
      {
        "to": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
        "data": "0xb6b55f25...",
        "description": "Deposit 1000 USDC into Trusset Prime Demo Vault"
      }
    ],
    "functionName": "deposit",
    "confirmWith": { "endpoint": "confirm-tx", "txHash": true, "txType": "DEPOSIT" }
  }
}

{
  "success": false,
  "error": {
    "code": "DEPOSITOR_NOT_VERIFIED",
    "message": "Wallet 0xabc...def is not verified on this vault's identity register (0xe9114c40934f6fb6bb317935156b731f7a86d006), so the deposit would revert. The vault operator's register provider admits depositors."
  }
}

Builds the two transactions a deposit needs: an ERC-20 approval for the vault to pull the settlement asset, then the deposit itself. Both come back as ordered steps for the depositor’s wallet to sign. The depositor receives vault shares at the current share price. Deposits are identity-gated. The vault admits only wallets its identity register verifies, and that register is fixed for the life of the vault. The operator’s register provider admits depositors.

Path Parameters

string

required

Vault ID.

Body Parameters

string

required

Amount to deposit as a decimal string, for example "1000". Denominated in the vault’s settlement asset and parsed at assetDecimals.

string

Wallet that will sign. When supplied, the API checks it against the vault’s identity register before offering a transaction and refuses with DEPOSITOR_NOT_VERIFIED if the deposit would revert on-chain. Omit it to skip the check. The contract enforces the gate either way.

Response Fields

object

Show child attributes

string

SIGN_TRANSACTIONS.

array

Ordered transactions to sign and broadcast: the approval, then the deposit call. Each carries to, data, and a human-readable description.

object

Where to report the hash: the confirm-tx endpoint with txType: "DEPOSIT". Confirm with the deposit step’s hash, not the approval’s.

When a deposit is refused on the vault’s own state

Two refusals are about the vault rather than about the depositor, and both exist to stop shares being issued against a number nobody can stand behind. Neither affects redemptions, which stay open throughout. A deposit is refused with VAULT_BOOK_INCOMPLETE when a market the vault funds is not answering. The vault cannot total its own book, so the share price it would issue at is a price computed from a partial book. The message names the market. It clears when that market answers again, or when the operator writes it off. A deposit is refused with VAULT_WIPED_OUT when shares are in issue against assets totalling zero. A deposit into that vault would be absorbed by the existing holders rather than buying a position. A vault whose value is gone cannot be recapitalized, and the operator has to run a new one.

Errors

Code	Status	Meaning
`VALIDATION_ERROR`	400	Malformed amount. `error.details` names the field.
`INVALID_AMOUNT`	400	`amount` carries more decimal places than the vault’s asset supports.
`DEPOSITOR_NOT_VERIFIED`	403	The wallet is not verified on this vault’s identity register. The message names the register. Show it verbatim.
`VAULT_NOT_FOUND`	404	No such vault, or it is not visible to your instance.
`DEPOSITS_PAUSED`	409	The operator paused deposits. Redemptions stay open.
`VAULT_NOT_DEPLOYED`	409	The vault has no on-chain address yet.
`VAULT_BOOK_INCOMPLETE`	409	A market the vault funds is not answering, so its book cannot be totalled.
`VAULT_WIPED_OUT`	409	Shares are in issue against zero assets.

curl -X POST "https://api.trusset.org/lending-external-securities/api/vaults/{vaultId}/deposit" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"amount": "1000", "holderAddress": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab"}'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/vaults/${vaultId}/deposit`,
  {
    method: 'POST',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ amount: '1000', holderAddress: wallet })
  }
);
const { data } = await res.json();
for (const step of data.steps) {
  const tx = await signer.sendTransaction({ to: step.to, data: step.data });
  await tx.wait();
}

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTIONS",
    "steps": [
      {
        "to": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
        "data": "0x095ea7b3...",
        "description": "Approve the vault to pull 1000 USDC"
      },
      {
        "to": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
        "data": "0xb6b55f25...",
        "description": "Deposit 1000 USDC into Trusset Prime Demo Vault"
      }
    ],
    "functionName": "deposit",
    "confirmWith": { "endpoint": "confirm-tx", "txHash": true, "txType": "DEPOSIT" }
  }
}

{
  "success": false,
  "error": {
    "code": "DEPOSITOR_NOT_VERIFIED",
    "message": "Wallet 0xabc...def is not verified on this vault's identity register (0xe9114c40934f6fb6bb317935156b731f7a86d006), so the deposit would revert. The vault operator's register provider admits depositors."
  }
}

curl -X POST "https://api.trusset.org/lending-external-securities/api/vaults/{vaultId}/deposit" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"amount": "1000", "holderAddress": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab"}'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/vaults/${vaultId}/deposit`,
  {
    method: 'POST',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ amount: '1000', holderAddress: wallet })
  }
);
const { data } = await res.json();
for (const step of data.steps) {
  const tx = await signer.sendTransaction({ to: step.to, data: step.data });
  await tx.wait();
}

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTIONS",
    "steps": [
      {
        "to": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
        "data": "0x095ea7b3...",
        "description": "Approve the vault to pull 1000 USDC"
      },
      {
        "to": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
        "data": "0xb6b55f25...",
        "description": "Deposit 1000 USDC into Trusset Prime Demo Vault"
      }
    ],
    "functionName": "deposit",
    "confirmWith": { "endpoint": "confirm-tx", "txHash": true, "txType": "DEPOSIT" }
  }
}

{
  "success": false,
  "error": {
    "code": "DEPOSITOR_NOT_VERIFIED",
    "message": "Wallet 0xabc...def is not verified on this vault's identity register (0xe9114c40934f6fb6bb317935156b731f7a86d006), so the deposit would revert. The vault operator's register provider admits depositors."
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Deposit

Path Parameters

Body Parameters

Response Fields

When a deposit is refused on the vault’s own state

Errors

​Path Parameters

​Body Parameters

​Response Fields

​When a deposit is refused on the vault’s own state

​Errors

Path Parameters

Body Parameters

Response Fields

When a deposit is refused on the vault’s own state

Errors