Insurance Fund
Top Up Insurance Fund
Approve-and-top-up calldata that adds capital to the market insurance fund
POST
/
lending-external-securities-v2
/
api
/
markets
/
{marketId}
/
insurance
/
top-up
curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/insurance/top-up" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"amount": "5000", "fromAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"}'
const base = `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}`;
const headers = { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' };
const fromAddress = await wallet.getAddress();
const built = await fetch(`${base}/insurance/top-up`, {
method: 'POST',
headers,
body: JSON.stringify({ amount: '5000', fromAddress })
});
const { data } = await built.json();
const [approval, topUp] = data.steps;
await (await wallet.sendTransaction(approval.transaction)).wait();
const tx = await wallet.sendTransaction(topUp.transaction);
await tx.wait();
await fetch(`${base}/insurance/record-topup`, {
method: 'POST',
headers,
body: JSON.stringify({ ...data.confirmWith.body, txHash: tx.hash })
});
{
"success": true,
"data": {
"action": "SIGN_TRANSACTIONS",
"steps": [
{
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"data": "0x095ea7b3...",
"chainId": 11155111,
"value": "0"
},
"functionName": "approve",
"description": "Approve the insurance fund to pull 5000 USDC"
},
{
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"data": "0x...",
"chainId": 11155111,
"value": "0"
},
"functionName": "topUp",
"description": "Top up the insurance fund with 5000 USDC, booked as a deposit from 0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
],
"functionName": "topUp",
"confirmStepIndex": 1,
"fundAddress": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"amount": "5000",
"amountRaw": "5000000000",
"booked": true,
"note": "A top-up pulls the settlement asset through topUp(amount) and the fund books it as a deposit with the source recorded, so Lifetime Deposits counts protocol-fee sweeps and top-ups alike, and the balance is what it can pay.",
"confirmWith": {
"endpoint": "POST /lending-external-securities-v2/api/markets/clx_secmarket_001/insurance/record-topup",
"field": "txHash",
"body": {
"amount": "5000",
"fromAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
}
}
}
{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Wallet 0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52 holds 1200.0 USDC, less than the 5000 USDC top-up"
}
}
Builds the two transactions that add capital to the market’s insurance fund: an approval for the fund to pull the settlement token (stablecoin), then the fund’s
Any wallet may top up, whether the operator funding its own reserve or a third party standing behind the pool.
The fund books a top-up as a deposit with the sending wallet recorded as its source. That is what makes the capital count in the fund’s lifetime deposits. An earlier fund implementation cannot book one, so the API refuses it rather than offer a plain transfer.
topUp call.
A top-up is a one-way transfer. The wallet that sends it receives no shares and holds no claim on the fund, and nothing is owed back to it. Money leaves the fund only as coverage paid to a market it authorizes, or through a withdrawal by the fund owner.
Top up and record it
1
Build the calldata
Call this endpoint with
amount and the fromAddress that will sign. The API checks that the wallet holds enough of the borrow asset before offering anything.2
Sign both steps from fromAddress
Broadcast the approval, then
topUp, in order. The fund pulls from the wallet that sends topUp, and records that wallet as the source, so both steps must come from fromAddress.3
Record the top-up
Send the
topUp step’s hash to Record Insurance Top-Up, with the amount and fromAddress that confirmWith.body carries. This route has no confirm call of its own.Path Parameters
string
required
Body Parameters
string
required
Amount to add as a decimal string, for example
"5000". Must be greater than zero. Denominated in the market’s borrow asset and parsed at its decimals.string
required
The wallet that will sign both steps, as a 0x-prefixed 20-byte address. The API checks its balance against
amount, and the fund records it as the top-up’s source.Response Fields
object
Show child attributes
Show child attributes
string
SIGN_TRANSACTIONS.array
Two transactions to broadcast in order: first the approval on the borrow asset, then
topUp on the fund. Each step is { action, transaction, functionName, description }, with transaction carrying to, data, value ("0") and chainId.string
topUp.integer
Always
1. Record the top-up with the topUp step’s hash, not the approval’s.string
The insurance fund the top-up goes to.
string
The amount, echoed back.
string
The amount in the borrow asset’s smallest unit.
boolean
Always
true. The fund books this top-up as a deposit.string
States how the fund books a top-up, in words.
object
Where to record the top-up.
endpoint names Record Insurance Top-Up and field is txHash. body carries the amount and fromAddress to send with the hash.curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/insurance/top-up" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"amount": "5000", "fromAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"}'
const base = `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}`;
const headers = { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' };
const fromAddress = await wallet.getAddress();
const built = await fetch(`${base}/insurance/top-up`, {
method: 'POST',
headers,
body: JSON.stringify({ amount: '5000', fromAddress })
});
const { data } = await built.json();
const [approval, topUp] = data.steps;
await (await wallet.sendTransaction(approval.transaction)).wait();
const tx = await wallet.sendTransaction(topUp.transaction);
await tx.wait();
await fetch(`${base}/insurance/record-topup`, {
method: 'POST',
headers,
body: JSON.stringify({ ...data.confirmWith.body, txHash: tx.hash })
});
{
"success": true,
"data": {
"action": "SIGN_TRANSACTIONS",
"steps": [
{
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"data": "0x095ea7b3...",
"chainId": 11155111,
"value": "0"
},
"functionName": "approve",
"description": "Approve the insurance fund to pull 5000 USDC"
},
{
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"data": "0x...",
"chainId": 11155111,
"value": "0"
},
"functionName": "topUp",
"description": "Top up the insurance fund with 5000 USDC, booked as a deposit from 0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
],
"functionName": "topUp",
"confirmStepIndex": 1,
"fundAddress": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"amount": "5000",
"amountRaw": "5000000000",
"booked": true,
"note": "A top-up pulls the settlement asset through topUp(amount) and the fund books it as a deposit with the source recorded, so Lifetime Deposits counts protocol-fee sweeps and top-ups alike, and the balance is what it can pay.",
"confirmWith": {
"endpoint": "POST /lending-external-securities-v2/api/markets/clx_secmarket_001/insurance/record-topup",
"field": "txHash",
"body": {
"amount": "5000",
"fromAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
}
}
}
{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Wallet 0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52 holds 1200.0 USDC, less than the 5000 USDC top-up"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
VALIDATION_ERROR | 400 | amount is missing or not a positive decimal string, or fromAddress is missing or malformed |
MISSING_MARKET_ID | 400 | The market ID in the path is longer than 100 characters |
NO_INSURANCE_FUND | 400 | The market records no insurance fund |
INVALID_AMOUNT | 400 | amount carries more decimal places than the borrow asset supports |
INSUFFICIENT_BALANCE | 400 | fromAddress holds less of the borrow asset than amount. The message states the balance. Skipped when the balance cannot be read |
MARKET_NOT_FOUND | 404 | No market with this ID on your instance |
FUND_UPGRADE_REQUIRED | 409 | The fund runs the earlier implementation that only its markets may fund, so topUp would revert and a plain transfer would not be booked. The fund owner upgrades it first through Upgrade Market. The message says who holds the fund |
FUND_STATE_UNAVAILABLE | 503 | The fund’s implementation could not be read, so whether it books a top-up is unknown. Retry shortly |
⌘I
curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/insurance/top-up" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"amount": "5000", "fromAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"}'
const base = `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}`;
const headers = { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' };
const fromAddress = await wallet.getAddress();
const built = await fetch(`${base}/insurance/top-up`, {
method: 'POST',
headers,
body: JSON.stringify({ amount: '5000', fromAddress })
});
const { data } = await built.json();
const [approval, topUp] = data.steps;
await (await wallet.sendTransaction(approval.transaction)).wait();
const tx = await wallet.sendTransaction(topUp.transaction);
await tx.wait();
await fetch(`${base}/insurance/record-topup`, {
method: 'POST',
headers,
body: JSON.stringify({ ...data.confirmWith.body, txHash: tx.hash })
});
{
"success": true,
"data": {
"action": "SIGN_TRANSACTIONS",
"steps": [
{
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"data": "0x095ea7b3...",
"chainId": 11155111,
"value": "0"
},
"functionName": "approve",
"description": "Approve the insurance fund to pull 5000 USDC"
},
{
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"data": "0x...",
"chainId": 11155111,
"value": "0"
},
"functionName": "topUp",
"description": "Top up the insurance fund with 5000 USDC, booked as a deposit from 0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
],
"functionName": "topUp",
"confirmStepIndex": 1,
"fundAddress": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"amount": "5000",
"amountRaw": "5000000000",
"booked": true,
"note": "A top-up pulls the settlement asset through topUp(amount) and the fund books it as a deposit with the source recorded, so Lifetime Deposits counts protocol-fee sweeps and top-ups alike, and the balance is what it can pay.",
"confirmWith": {
"endpoint": "POST /lending-external-securities-v2/api/markets/clx_secmarket_001/insurance/record-topup",
"field": "txHash",
"body": {
"amount": "5000",
"fromAddress": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
}
}
}
{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Wallet 0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52 holds 1200.0 USDC, less than the 5000 USDC top-up"
}
}