CollateralVault: Asset-Backed Loans on Stellar Soroban

import { CollateralVault, LoanStatus } from "@ankarachain/sdk";

new CollateralVault(adapter: IAdapter, vaultAddress: string)

import { TokenFactory, CollateralVault } from "@ankarachain/sdk";

const factory = new TokenFactory({
  network:         "stellar-testnet",
  stellarSecretKey: process.env.STELLAR_SECRET!,
});

const vault = new CollateralVault(factory.adapter, "CCollateralVaultContractId...");

openLoan(
  collateralToken: string,
  collateralAmount: bigint,
  borrowAmount: bigint
): Promise<{ loanId: number; txHash: string }>

// Borrow 600 USDC against 1,000 farmland tokens
// (assumes vault LTV is 60% and oracle prices the collateral at $1 each)
const { loanId, txHash } = await vault.openLoan(
  farmlandTokenContractId,
  1_000n * 10_000_000n,  // 1,000 tokens (7 decimal places)
  600n  * 10_000_000n    // 600 USDC
);

console.log("Loan opened, ID:", loanId);

repayLoan(loanId: number): Promise<string>

const txHash = await vault.repayLoan(loanId);
console.log("Loan repaid, collateral returned. Tx:", txHash);

liquidate(loanId: number): Promise<string>

// Check before liquidating
const canLiquidate = await vault.isLiquidatable(loanId);
if (canLiquidate) {
  const txHash = await vault.liquidate(loanId);
}

getLoan(loanId: number): Promise<Loan>

import { LoanStatus } from "@ankarachain/sdk";

const loan = await vault.getLoan(loanId);

if (loan.status === LoanStatus.OPEN) {
  console.log("Collateral locked:", loan.collateralAmount);
  console.log("Outstanding debt:", loan.borrowedAmount);
}

getBorrowerLoans(borrower?: string): Promise<number[]>

const myLoanIds = await vault.getBorrowerLoans();
const theirLoans = await vault.getBorrowerLoans("GBORROWERSTELLARADDRESS...");

currentLtvBps(loanId: number): Promise<number>

const ltv = await vault.currentLtvBps(loanId);
console.log(`Current LTV: ${ltv / 100}%`);

const threshold = await vault.getLiquidationThresholdBps();
if (ltv > threshold) {
  console.warn("Loan is undercollateralized and can be liquidated.");
}

isLiquidatable(loanId: number): Promise<boolean>

getBorrowedToken(): Promise<string>

getOracle(): Promise<string>

getLtvBps(): Promise<number>

getLiquidationThresholdBps(): Promise<number>

isPaused(): Promise<boolean>

setLtvBps(newLtvBps: number): Promise<string>

setLiquidationThresholdBps(newThresholdBps: number): Promise<string>

setOracle(oracleAddress: string): Promise<string>

pause(): Promise<string>

unpause(): Promise<string>

vault.address  // The vaultAddress passed to the constructor

import { TokenFactory, CollateralVault, LoanStatus } from "@ankarachain/sdk";

const factory = new TokenFactory({
  network:          "stellar-testnet",
  stellarSecretKey: process.env.STELLAR_SECRET!,
});

const vault = new CollateralVault(factory.adapter, process.env.VAULT_CONTRACT_ID!);

// ── Check vault config ───────────────────────────────────────────────────
const maxLtv       = await vault.getLtvBps();
const liquidThresh = await vault.getLiquidationThresholdBps();
console.log(`Max LTV: ${maxLtv / 100}% — Liquidation at: ${liquidThresh / 100}%`);

// ── Open a loan ──────────────────────────────────────────────────────────
const { loanId } = await vault.openLoan(
  process.env.FARMLAND_TOKEN_CONTRACT_ID!,
  1_000n * 10_000_000n,  // 1,000 tokens
  500n  * 10_000_000n    // 500 USDC (50% LTV)
);

// ── Monitor live LTV ─────────────────────────────────────────────────────
const liveLtv = await vault.currentLtvBps(loanId);
console.log(`Live LTV: ${liveLtv / 100}%`);

// ── Repay ────────────────────────────────────────────────────────────────
const txHash = await vault.repayLoan(loanId);
console.log("Repaid. Tx:", txHash);

const loan = await vault.getLoan(loanId);
console.log("Loan status:", LoanStatus[loan.status]); // "REPAID"

enum LoanStatus {
  OPEN       = 0,
  REPAID     = 1,
  LIQUIDATED = 2,
}

interface Loan {
  borrower:         string;
  collateralToken:  string;
  collateralAmount: bigint;
  borrowedToken:    string;
  borrowedAmount:   bigint;
  /** LTV at open time — locked in. Does not update when the vault's global LTV config changes. */
  ltvBps:           number;
  openedAt:         bigint;
  status:           LoanStatus;
}