Close the trove

GET 
/v1/actions/river/close

Close the caller's trove on a market: burns entireDebt − gasCompensation satUSD from the wallet, returns all collateral. Blocked in Recovery Mode (global TCR < 150%). Equivalent to lending/repay with isAll=true.

River (rebranded Satoshi Protocol) is a Prisma-lineage pooled CDP minting satUSD behind one SatoshiXApp diamond per chain (BNB, Base, Hemi). One TroveManager per collateral = one RIVER_<chainId>_<TM_INDEX> market; troves are keyed by OWNER ADDRESS — at most one per user per market, no ids. Interest is protocol-set (currently 0%); the only borrowing cost is a one-off decaying-baseRate mint fee (0.5%–5%) on open/borrow-more, guarded by maxFeePercentage (quoted automatically).

Standard lending actions cover the day-to-day ops:

• satUSD deposit/withdraw → the single per-chain Stability Pool (attached to market index 0; zero approvals)
• collateral deposit/withdraw → addColl/withdrawColl (no troveId — address-keyed)
• borrow → withdrawDebt (mint fee applies)
• repay → repayDebt clamped to entireDebt − gasComp − minNetDebt; isAll=true routes to closeTrove (burns entireDebt − gasComp from the wallet, returns all collateral; blocked in Recovery Mode)

The 2-satUSD debt-side gas compensation is minted on open and burned from the GasPool on close — it never touches the wallet.

Request

Responses

200

400