> ## 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.
# Get Handover
> Track the ownership handover of the oracle, rate model and insurance fund after adoption
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
Market ID.
## Response Fields
Whether the factory's handover record could be read. When `false`, no other field is present.
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.
`true` when the market was adopted and nothing is pending.
Whether the factory has recorded the adoption, after which the satellites can only pass to the lender of record's owners. `null` when unreadable.
The oracle is still held by the market or the factory, not by an owner the lender of record named.
The same for the interest rate model.
The same for the insurance fund.
`true` when none of the three is pending.
One entry per satellite the market records, keyed `oracle`, `interestModel` and `insuranceFund`.
The satellite contract, lowercased.
Its current owner, lowercased, or `null` when unreadable.
The nominee that has not accepted yet, or `null`.
`market` when the market owns it, `factory` when the deploying factory does, `owner` when anyone else does, `null` when unreadable.
The factory's pending flag for this satellite.
One transaction per pending satellite that has a nominee. Empty when there is nothing to accept.
`acceptOracleOwnership`, `acceptInterestModelOwnership` or `acceptInsuranceFundOwnership`.
The satellite contract.
Encoded `acceptOwnership()`.
Always `"0"`.
The chain your instance resolves to.
The nominee, the only address that can send it.
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.
```bash cURL theme={null}
curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/handover" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
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 });
}
```
```json Response - Pending theme={null}
{
"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
}
]
}
}
```
```json Response - Unreadable theme={null}
{
"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 |