Trusset Protocol - Infrastructure for Asset Tokenization

GET

lending-external-securities-v2

api

markets

{marketId}

handover

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/handover" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/handover`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

for (const leg of data.acceptOwnershipCalldata ?? []) {
  console.log(`${leg.key} must be sent by ${leg.signer}`, { to: leg.to, data: leg.data });
}

{
  "success": true,
  "data": {
    "readable": true,
    "surrendered": true,
    "oraclePending": true,
    "interestModelPending": false,
    "insuranceFundPending": false,
    "nothingPending": false,
    "stage": "PENDING",
    "complete": false,
    "satellites": {
      "oracle": {
        "address": "0x3b25752c1459c5cf1b0bfcfdf0d56883c8047423",
        "owner": "0x70a0e25c7b768b87e658348b3b577678a173e038",
        "pendingOwner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "heldBy": "market",
        "pending": true
      },
      "interestModel": {
        "address": "0x2c7e91d4a3b05f68e1c2a4b7d9f03e5a6c8b1d42",
        "owner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "pendingOwner": null,
        "heldBy": "owner",
        "pending": false
      },
      "insuranceFund": {
        "address": "0x8f1a4c2e9b7d3056a1e8c4f29d0b7a3e5c619c22",
        "owner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "pendingOwner": null,
        "heldBy": "owner",
        "pending": false
      }
    },
    "acceptOwnershipCalldata": [
      {
        "key": "acceptOracleOwnership",
        "to": "0x3b25752c1459c5cf1b0bfcfdf0d56883c8047423",
        "data": "0x79ba5097",
        "signer": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "description": "Accept oracle ownership...",
        "value": "0",
        "chainId": 11155111
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "readable": false
  }
}

Reports whether the market’s three owned satellites have passed to the owners the lender of record named, and returns any transactions still needed to complete the handover. Taking the lender-of-record role grants the market and router roles outright. On a market deployed through the current factory, the market owns the price oracle, the interest rate model and the insurance fund from deployment. It hands each one to its named owner inside the adoption transaction, so stage reads COMPLETE from adoption on and acceptOwnershipCalldata is empty. A market from an earlier generation hands them over in two steps. Adoption nominates each owner, and each nominee must accept by calling acceptOwnership() on that contract. Until a nominee accepts, the market itself stays the owner of record, or the deploying factory on the oldest markets. The lender of record cannot set price signers, tune the rate model, or authorize a market on the insurance fund until then. Neither satellite upgrade can be built either. On such a market, completing the handover is a deployment step, not an option.

Satellite	Nominee named at adoption
Price oracle	`oracleOwner`
Interest rate model	`issuer`
Insurance fund	`admin`

Path Parameters

string

required

Market ID.

Response Fields

object

Show child attributes

boolean

Whether the factory’s handover record could be read. When false, no other field is present.

string

Where the handover stands. NOT_STARTED means no lender of record has taken the market yet. PENDING means at least one nominee has not accepted, and COMPLETE that all three have. UNKNOWN means the adoption flag could not be read.

boolean

true when the market was adopted and nothing is pending.

boolean

Whether the factory has recorded the adoption, after which the satellites can only pass to the lender of record’s owners. null when unreadable.

boolean

The oracle is still held by the market or the factory, not by an owner the lender of record named.

boolean

The same for the interest rate model.

boolean

The same for the insurance fund.

boolean

true when none of the three is pending.

object

One entry per satellite the market records, keyed oracle, interestModel and insuranceFund.

Show child attributes

string

The satellite contract, lowercased.

string

Its current owner, lowercased, or null when unreadable.

string

The nominee that has not accepted yet, or null.

string

market when the market owns it, factory when the deploying factory does, owner when anyone else does, null when unreadable.

boolean

The factory’s pending flag for this satellite.

array

One transaction per pending satellite that has a nominee. Empty when there is nothing to accept.

Show child attributes

string

acceptOracleOwnership, acceptInterestModelOwnership or acceptInsuranceFundOwnership.

string

The satellite contract.

string

Encoded acceptOwnership().

string

Always "0".

integer

The chain your instance resolves to.

string

The nominee, the only address that can send it.

string

What accepting changes, in words.

Each nominee signs and broadcasts its own transaction. This endpoint has no confirm call: read it again once the transactions have mined, and stage moves to COMPLETE when the last one lands.

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/handover" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/handover`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

for (const leg of data.acceptOwnershipCalldata ?? []) {
  console.log(`${leg.key} must be sent by ${leg.signer}`, { to: leg.to, data: leg.data });
}

{
  "success": true,
  "data": {
    "readable": true,
    "surrendered": true,
    "oraclePending": true,
    "interestModelPending": false,
    "insuranceFundPending": false,
    "nothingPending": false,
    "stage": "PENDING",
    "complete": false,
    "satellites": {
      "oracle": {
        "address": "0x3b25752c1459c5cf1b0bfcfdf0d56883c8047423",
        "owner": "0x70a0e25c7b768b87e658348b3b577678a173e038",
        "pendingOwner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "heldBy": "market",
        "pending": true
      },
      "interestModel": {
        "address": "0x2c7e91d4a3b05f68e1c2a4b7d9f03e5a6c8b1d42",
        "owner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "pendingOwner": null,
        "heldBy": "owner",
        "pending": false
      },
      "insuranceFund": {
        "address": "0x8f1a4c2e9b7d3056a1e8c4f29d0b7a3e5c619c22",
        "owner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "pendingOwner": null,
        "heldBy": "owner",
        "pending": false
      }
    },
    "acceptOwnershipCalldata": [
      {
        "key": "acceptOracleOwnership",
        "to": "0x3b25752c1459c5cf1b0bfcfdf0d56883c8047423",
        "data": "0x79ba5097",
        "signer": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "description": "Accept oracle ownership...",
        "value": "0",
        "chainId": 11155111
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "readable": false
  }
}

Error Codes

Code	HTTP	Cause
`MISSING_MARKET_ID`	`400`	`marketId` is longer than 100 characters
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance
`SECURITY_LENDING_V2_NOT_CONFIGURED`	`503`	Lending is not configured for your instance’s network

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/handover" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/handover`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

for (const leg of data.acceptOwnershipCalldata ?? []) {
  console.log(`${leg.key} must be sent by ${leg.signer}`, { to: leg.to, data: leg.data });
}

{
  "success": true,
  "data": {
    "readable": true,
    "surrendered": true,
    "oraclePending": true,
    "interestModelPending": false,
    "insuranceFundPending": false,
    "nothingPending": false,
    "stage": "PENDING",
    "complete": false,
    "satellites": {
      "oracle": {
        "address": "0x3b25752c1459c5cf1b0bfcfdf0d56883c8047423",
        "owner": "0x70a0e25c7b768b87e658348b3b577678a173e038",
        "pendingOwner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "heldBy": "market",
        "pending": true
      },
      "interestModel": {
        "address": "0x2c7e91d4a3b05f68e1c2a4b7d9f03e5a6c8b1d42",
        "owner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "pendingOwner": null,
        "heldBy": "owner",
        "pending": false
      },
      "insuranceFund": {
        "address": "0x8f1a4c2e9b7d3056a1e8c4f29d0b7a3e5c619c22",
        "owner": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "pendingOwner": null,
        "heldBy": "owner",
        "pending": false
      }
    },
    "acceptOwnershipCalldata": [
      {
        "key": "acceptOracleOwnership",
        "to": "0x3b25752c1459c5cf1b0bfcfdf0d56883c8047423",
        "data": "0x79ba5097",
        "signer": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "description": "Accept oracle ownership...",
        "value": "0",
        "chainId": 11155111
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "readable": false
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Get Handover

Path Parameters

Response Fields

Error Codes

​Path Parameters

​Response Fields

​Error Codes

Path Parameters

Response Fields

Error Codes