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.

Errors

Code	Status	Meaning
`DEPOSITOR_NOT_VERIFIED`	403	The wallet is not verified on this vault’s identity register. The message names the register. Show it verbatim.
`DEPOSITS_PAUSED`	409	The operator paused deposits. Redemptions stay open.
`VAULT_NOT_DEPLOYED`	409	The vault has no on-chain address yet.
`VALIDATION_ERROR`	400	Malformed amount. `error.details` names the field.

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

Stock Tokenization

Stock Trading

External Securities Trading

Commodity Trading

Stock Lending

External Securities Lending

Vaults

Deposit

Path Parameters

Body Parameters

Response Fields

Errors

​Path Parameters

​Body Parameters

​Response Fields

​Errors

Path Parameters

Body Parameters

Response Fields

Errors