@fepvenancio/stela-sdk 0.9.0 → 0.11.0

package/dist/index.cjs

@@ -22,6 +22,16 @@ var STATUS_LABELS = {
   cancelled: "Cancelled"
 };
 
+// src/types/orderbook.ts
+var DURATION_RANGES = {
+  all: null,
+  "7d": [0, 7 * 86400 + 1],
+  "30d": [7 * 86400, 30 * 86400 + 1],
+  "90d": [30 * 86400, 90 * 86400 + 1],
+  "180d": [90 * 86400, 180 * 86400 + 1],
+  "365d": [180 * 86400, 366 * 86400]
+};
+
 // src/constants/addresses.ts
 var STELA_ADDRESS = {
   sepolia: "0x0109c6caae0c5b4da6e063ed6c02ae784be05aa90806501a48dcfbb213bd7c03",
@@ -62,6 +72,40 @@ var GRACE_PERIOD = 86400n;
 var AUCTION_DURATION = 86400n;
 var AUCTION_PENALTY_BPS = 500n;
 var AUCTION_RESERVE_BPS = 1000n;
+
+// src/constants/presets.ts
+var SWAP_DEADLINE_PRESETS = [
+  { label: "5m", seconds: 300 },
+  { label: "15m", seconds: 900 },
+  { label: "30m", seconds: 1800 },
+  { label: "1h", seconds: 3600 },
+  { label: "12h", seconds: 43200 },
+  { label: "1d", seconds: 86400 },
+  { label: "7d", seconds: 604800 },
+  { label: "30d", seconds: 2592e3 }
+];
+var LEND_DEADLINE_PRESETS = [
+  { label: "7d", seconds: 604800 },
+  { label: "14d", seconds: 1209600 },
+  { label: "30d", seconds: 2592e3 },
+  { label: "60d", seconds: 5184e3 },
+  { label: "90d", seconds: 7776e3 }
+];
+var DURATION_PRESETS = [
+  { label: "1d", seconds: 86400 },
+  { label: "7d", seconds: 604800 },
+  { label: "14d", seconds: 1209600 },
+  { label: "30d", seconds: 2592e3 },
+  { label: "90d", seconds: 7776e3 },
+  { label: "180d", seconds: 15552e3 },
+  { label: "1y", seconds: 31536e3 }
+];
+function formatDurationHuman(seconds) {
+  if (seconds < 3600) return `${Math.round(seconds / 60)} min`;
+  if (seconds < 86400) return `${Math.round(seconds / 3600)} hours`;
+  const days = Math.round(seconds / 86400);
+  return `${days} day${days !== 1 ? "s" : ""}`;
+}
 var U128_MAX = (1n << 128n) - 1n;
 var U256_MAX = (1n << 256n) - 1n;
 var toU256 = (n) => {
@@ -154,6 +198,292 @@ function computeStatus(a, nowSeconds) {
   if (now > signedAt + duration) return "expired";
   return "filled";
 }
+var EXTENDED_LABELS = {
+  overdue: "Overdue",
+  auctioned: "Auctioned",
+  grace_period: "Grace Period"
+};
+function getStatusBadgeVariant(status) {
+  if (status === "overdue") return "overdue";
+  if (status === "auctioned") return "auctioned";
+  if (status === "grace_period") return "grace_period";
+  return status in STATUS_LABELS ? status : "open";
+}
+function getStatusLabel(status) {
+  return EXTENDED_LABELS[status] ?? STATUS_LABELS[status] ?? status;
+}
+var ORDER_STATUS_LABELS = {
+  pending: "Pending",
+  matched: "Matched",
+  settled: "Settled",
+  expired: "Expired",
+  cancelled: "Cancelled"
+};
+function getOrderStatusBadgeVariant(status) {
+  const map = {
+    pending: "pending",
+    matched: "matched",
+    settled: "settled",
+    expired: "expired",
+    cancelled: "cancelled"
+  };
+  return map[status] ?? "pending";
+}
+function getOrderStatusLabel(status) {
+  return ORDER_STATUS_LABELS[status] ?? status;
+}
+var INSCRIPTION_STATUS_GROUPS = {
+  open: /* @__PURE__ */ new Set(["open", "partial"]),
+  active: /* @__PURE__ */ new Set(["filled", "auctioned", "grace_period"]),
+  closed: /* @__PURE__ */ new Set(["repaid", "liquidated", "expired", "overdue", "cancelled"])
+};
+var ORDER_STATUS_GROUPS = {
+  open: /* @__PURE__ */ new Set(["pending"]),
+  active: /* @__PURE__ */ new Set(["matched"]),
+  closed: /* @__PURE__ */ new Set(["settled", "expired", "cancelled"])
+};
+function inscriptionMatchesGroup(enrichedStatus, group) {
+  if (group === "all") return true;
+  return INSCRIPTION_STATUS_GROUPS[group]?.has(enrichedStatus) ?? false;
+}
+function orderMatchesGroup(orderStatus, group) {
+  if (group === "all") return true;
+  return ORDER_STATUS_GROUPS[group]?.has(orderStatus) ?? false;
+}
+var STATUS_DESCRIPTIONS = {
+  open: "Waiting for a lender to sign. The borrower has set the loan terms.",
+  partial: "Partially funded by lenders. More lenders can still contribute.",
+  filled: "Fully funded and active. The borrower received the debt tokens.",
+  repaid: "The borrower repaid the loan. Lenders can redeem their shares.",
+  liquidated: "Loan expired without repayment. Collateral distributed to lenders.",
+  overdue: "Loan duration elapsed without repayment. Anyone can liquidate.",
+  auctioned: "Auction started. The collateral is being sold to the highest bidder.",
+  grace_period: "Loan expired but within the 24-hour grace period. The borrower can still repay.",
+  expired: "Expired before being funded. No lender action was taken.",
+  cancelled: "Cancelled by the borrower before any lender signed.",
+  pending: "Gasless order waiting for a lender offer. No gas was spent.",
+  matched: "A lender offered. The settlement bot will execute it shortly.",
+  settled: "Settled on-chain. The loan is now active as an inscription."
+};
+var CONCEPT_DESCRIPTIONS = {
+  debt: "Tokens the borrower wants to borrow. Lenders provide these.",
+  interest: "Extra tokens the borrower pays as reward for the lender.",
+  collateral: "Tokens locked by the borrower as security for the loan.",
+  duration: "How long the borrower has to repay after funding.",
+  apy: "Annual Percentage Yield \u2014 annualized return for lenders.",
+  offChain: "Gasless orders signed off-chain. No gas until settlement.",
+  shares: "ERC1155 tokens representing a lender's portion of a loan."
+};
+function enrichStatus(row) {
+  const base = computeStatus({
+    signed_at: BigInt(row.signed_at ?? "0"),
+    duration: BigInt(row.duration),
+    issued_debt_percentage: BigInt(row.issued_debt_percentage),
+    is_repaid: row.status === "repaid",
+    liquidated: row.status === "liquidated",
+    deadline: BigInt(row.deadline ?? "0"),
+    status: row.status
+  });
+  if (row.auction_started) {
+    return "auctioned";
+  }
+  if (base === "expired" && row.signed_at && BigInt(row.signed_at) > 0n) {
+    const signedAt = BigInt(row.signed_at);
+    const duration = BigInt(row.duration);
+    const nowSeconds = BigInt(Math.floor(Date.now() / 1e3));
+    const expiryTime = signedAt + duration;
+    if (nowSeconds <= expiryTime + GRACE_PERIOD) {
+      return "grace_period";
+    }
+    return "overdue";
+  }
+  return base;
+}
+
+// src/utils/order.ts
+function normalizeOrderData(raw) {
+  return {
+    borrower: raw.borrower ?? "",
+    debtAssets: raw.debt_assets ?? raw.debtAssets ?? [],
+    interestAssets: raw.interest_assets ?? raw.interestAssets ?? [],
+    collateralAssets: raw.collateral_assets ?? raw.collateralAssets ?? [],
+    duration: raw.duration ?? "0",
+    deadline: raw.deadline ?? "0",
+    multiLender: raw.multi_lender ?? raw.multiLender ?? false
+  };
+}
+function sanitizeAssets(arr) {
+  if (!Array.isArray(arr)) return [];
+  return arr.filter(
+    (a) => a != null && typeof a === "object" && typeof a.asset_address === "string" && typeof a.asset_type === "string"
+  ).map((a) => ({
+    asset_address: String(a.asset_address),
+    asset_type: String(a.asset_type),
+    value: String(a.value ?? "0"),
+    token_id: String(a.token_id ?? "0")
+  }));
+}
+function parseOrderRow(row) {
+  let parsed = {};
+  const raw = row.order_data;
+  if (typeof raw === "string") {
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      parsed = {};
+    }
+  } else if (raw && typeof raw === "object") {
+    parsed = raw;
+  }
+  const debtAssets = sanitizeAssets(parsed.debtAssets ?? parsed.debt_assets);
+  const interestAssets = sanitizeAssets(parsed.interestAssets ?? parsed.interest_assets);
+  const collateralAssets = sanitizeAssets(parsed.collateralAssets ?? parsed.collateral_assets);
+  const { borrower_signature: rawSig, ...safeRow } = row;
+  const includeSig = row.status === "pending" && rawSig != null;
+  return {
+    ...safeRow,
+    ...includeSig ? { borrower_signature: rawSig } : {},
+    order_data: {
+      borrower: parsed.borrower ?? "",
+      debtAssets,
+      interestAssets,
+      collateralAssets,
+      debtCount: debtAssets.length,
+      interestCount: interestAssets.length,
+      collateralCount: collateralAssets.length,
+      duration: String(parsed.duration ?? "0"),
+      deadline: String(parsed.deadline ?? "0"),
+      multiLender: parsed.multiLender ?? parsed.multi_lender ?? false,
+      nonce: String(parsed.nonce ?? row.nonce ?? "0"),
+      orderHash: parsed.orderHash ?? void 0
+    }
+  };
+}
+
+// src/utils/signature.ts
+function formatSig(signature) {
+  if (Array.isArray(signature)) {
+    return signature.map((s) => typeof s === "bigint" ? "0x" + s.toString(16) : String(s));
+  }
+  const sig = signature;
+  return [sig.r, sig.s].map((s) => typeof s === "bigint" ? "0x" + s.toString(16) : String(s));
+}
+function parseSigToArray(raw) {
+  if (Array.isArray(raw)) return raw.map(String);
+  if (typeof raw === "string") {
+    if (raw.startsWith("[")) {
+      const parsed = JSON.parse(raw);
+      if (!Array.isArray(parsed) || parsed.length < 1 || !parsed.every((s) => typeof s === "string" || typeof s === "number"))
+        throw new Error("Invalid signature array format");
+      return parsed.map(String);
+    }
+    if (raw.startsWith("{")) {
+      const obj = JSON.parse(raw);
+      if (typeof obj.r !== "string" || typeof obj.s !== "string")
+        throw new Error("Invalid signature object format: missing r or s");
+      return [obj.r, obj.s];
+    }
+    const parts = raw.split(",");
+    if (parts.length < 2) throw new Error("Invalid signature CSV: expected at least 2 elements");
+    return parts;
+  }
+  throw new Error("Invalid signature format");
+}
+
+// src/utils/calldata.ts
+function serializeAssetCalldata(assets) {
+  const calldata = [String(assets.length)];
+  for (const asset of assets) {
+    const enumVal = ASSET_TYPE_ENUM[asset.asset_type] ?? 0;
+    const [valueLow, valueHigh] = toU256(BigInt(asset.value));
+    const [tokenIdLow, tokenIdHigh] = toU256(BigInt(asset.token_id));
+    calldata.push(
+      normalizeAddress(asset.asset_address),
+      String(enumVal),
+      valueLow,
+      valueHigh,
+      tokenIdLow,
+      tokenIdHigh
+    );
+  }
+  return calldata;
+}
+function parseAssetArray(calldata, offset) {
+  const count = Number(BigInt(calldata[offset]));
+  let pos = offset + 1;
+  const assets = [];
+  for (let i = 0; i < count; i++) {
+    const address = normalizeAddress(calldata[pos]);
+    const typeEnum = Number(BigInt(calldata[pos + 1]));
+    const valueLow = BigInt(calldata[pos + 2]);
+    const valueHigh = BigInt(calldata[pos + 3]);
+    const tokenIdLow = BigInt(calldata[pos + 4]);
+    const tokenIdHigh = BigInt(calldata[pos + 5]);
+    assets.push({
+      asset_address: address,
+      asset_type: ASSET_TYPE_NAMES[typeEnum] ?? "unknown",
+      value: fromU256({ low: valueLow, high: valueHigh }).toString(),
+      token_id: fromU256({ low: tokenIdLow, high: tokenIdHigh }).toString()
+    });
+    pos += 6;
+  }
+  return { assets, nextOffset: pos };
+}
+function serializeSignatureCalldata(sig) {
+  let parts;
+  if (sig.startsWith("[")) {
+    parts = JSON.parse(sig);
+  } else if (sig.startsWith("{")) {
+    const obj = JSON.parse(sig);
+    parts = [obj.r, obj.s];
+  } else {
+    parts = sig.split(",");
+  }
+  return [String(parts.length), ...parts];
+}
+function standardizeHex(hex) {
+  const clean = hex.toLowerCase().replace(/^0x/, "");
+  return "0x" + clean;
+}
+var CREATE_INSCRIPTION_SELECTOR = "0x1883531093e6399258a46b3e397a8ec94952f12d37afeeea49fb35b4361d262";
+var SETTLE_SELECTOR = "0x1482408710165f49db4f7b422428870c37d86b0624cd661b387e24aa64f0249";
+var BATCH_SETTLE_SELECTOR = "0x116475a69261425e56d6d49661fec19f7629381447afd9c70300115e6f44d0f";
+function findCall(calldata, selectors) {
+  const numCalls = Number(BigInt(calldata[0]));
+  if (numCalls > 0 && numCalls < 100) {
+    let pos = 1;
+    for (let i = 0; i < numCalls; i++) {
+      const selector = standardizeHex(calldata[pos + 1]);
+      const cdLen = Number(BigInt(calldata[pos + 2]));
+      const cdStart = pos + 3;
+      if (selectors.includes(selector)) {
+        return { selector, cd: calldata.slice(cdStart, cdStart + cdLen) };
+      }
+      pos = cdStart + cdLen;
+    }
+  }
+  return null;
+}
+function parseInscriptionCalldata(calldata) {
+  try {
+    const match = findCall(calldata, [CREATE_INSCRIPTION_SELECTOR, SETTLE_SELECTOR, BATCH_SETTLE_SELECTOR]);
+    if (!match) return null;
+    let offset;
+    if (match.selector === CREATE_INSCRIPTION_SELECTOR) {
+      offset = 1;
+    } else if (match.selector === SETTLE_SELECTOR) {
+      offset = 11;
+    } else {
+      return null;
+    }
+    const { assets: debt, nextOffset: afterDebt } = parseAssetArray(match.cd, offset);
+    const { assets: interest, nextOffset: afterInterest } = parseAssetArray(match.cd, afterDebt);
+    const { assets: collateral } = parseAssetArray(match.cd, afterInterest);
+    return { debt, interest, collateral };
+  } catch {
+    return null;
+  }
+}
 
 // src/tokens/registry.ts
 var TOKENS = [
@@ -380,6 +710,22 @@ function computeSafePositionFloor(params) {
   });
   return { debtFloor, interestFloor };
 }
+
+// src/math/rate.ts
+function computeInterestRate(debtAssets, interestAssets) {
+  let debtTotal = 0n;
+  let interestTotal = 0n;
+  for (const a of debtAssets) {
+    if (a.asset_type === "ERC721") continue;
+    debtTotal += BigInt(a.value || "0");
+  }
+  for (const a of interestAssets) {
+    if (a.asset_type === "ERC721") continue;
+    interestTotal += BigInt(a.value || "0");
+  }
+  if (debtTotal === 0n) return null;
+  return Number(interestTotal * 1000000n / debtTotal) / 1e6;
+}
 var SELECTORS = {
   InscriptionCreated: starknet.hash.getSelectorFromName("InscriptionCreated"),
   InscriptionSigned: starknet.hash.getSelectorFromName("InscriptionSigned"),
@@ -556,6 +902,29 @@ var STELA_DOMAIN = {
   // filled at call time
   revision: "1"
 };
+function getCancelOrderTypedData(orderId, chainId) {
+  return {
+    types: {
+      StarknetDomain: [
+        { name: "name", type: "shortstring" },
+        { name: "version", type: "shortstring" },
+        { name: "chainId", type: "shortstring" },
+        { name: "revision", type: "shortstring" }
+      ],
+      CancelOrder: [
+        { name: "order_id", type: "string" }
+      ]
+    },
+    primaryType: "CancelOrder",
+    domain: {
+      ...STELA_DOMAIN,
+      chainId
+    },
+    message: {
+      order_id: orderId
+    }
+  };
+}
 function getInscriptionOrderTypedData(params) {
   return {
     types: {
@@ -843,6 +1212,27 @@ function getRefinanceApprovalTypedData(params) {
     }
   };
 }
+function getTermsAcknowledgmentTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: STARKNET_DOMAIN_TYPE,
+      TermsAcknowledgment: [
+        { name: "user", type: "ContractAddress" },
+        { name: "terms_version", type: "shortstring" },
+        { name: "terms_hash", type: "felt" },
+        { name: "agreed_at", type: "u128" }
+      ]
+    },
+    primaryType: "TermsAcknowledgment",
+    domain: { ...STELA_DOMAIN, chainId: params.chainId },
+    message: {
+      user: params.user,
+      terms_version: params.termsVersion,
+      terms_hash: params.termsHash,
+      agreed_at: params.agreedAt.toString()
+    }
+  };
+}
 
 // src/offchain/signature.ts
 function serializeSignature(sig) {
@@ -3933,6 +4323,19 @@ var StelaSdk = class {
   }
 };
 
+// src/client/nonce.ts
+async function getNonce(provider, stelaAddress, accountAddress) {
+  const result = await provider.callContract(
+    {
+      contractAddress: stelaAddress,
+      entrypoint: "nonces",
+      calldata: [accountAddress]
+    },
+    "latest"
+  );
+  return BigInt(result[0]);
+}
+
 exports.ASSET_TYPE_ENUM = ASSET_TYPE_ENUM;
 exports.ASSET_TYPE_NAMES = ASSET_TYPE_NAMES;
 exports.AUCTION_DURATION = AUCTION_DURATION;
@@ -3941,15 +4344,24 @@ exports.AUCTION_RESERVE_BPS = AUCTION_RESERVE_BPS;
 exports.ApiClient = ApiClient;
 exports.ApiError = ApiError;
 exports.CHAIN_ID = CHAIN_ID;
+exports.CONCEPT_DESCRIPTIONS = CONCEPT_DESCRIPTIONS;
 exports.DEFAULT_DUST_BUFFER_SECONDS = DEFAULT_DUST_BUFFER_SECONDS;
+exports.DURATION_PRESETS = DURATION_PRESETS;
+exports.DURATION_RANGES = DURATION_RANGES;
 exports.EXPLORER_TX_URL = EXPLORER_TX_URL;
 exports.GRACE_PERIOD = GRACE_PERIOD;
+exports.INSCRIPTION_STATUS_GROUPS = INSCRIPTION_STATUS_GROUPS;
 exports.InscriptionClient = InscriptionClient;
+exports.LEND_DEADLINE_PRESETS = LEND_DEADLINE_PRESETS;
 exports.LockerClient = LockerClient;
 exports.MAX_BPS = MAX_BPS;
+exports.ORDER_STATUS_GROUPS = ORDER_STATUS_GROUPS;
+exports.ORDER_STATUS_LABELS = ORDER_STATUS_LABELS;
 exports.SELECTORS = SELECTORS;
+exports.STATUS_DESCRIPTIONS = STATUS_DESCRIPTIONS;
 exports.STATUS_LABELS = STATUS_LABELS;
 exports.STELA_ADDRESS = STELA_ADDRESS;
+exports.SWAP_DEADLINE_PRESETS = SWAP_DEADLINE_PRESETS;
 exports.ShareClient = ShareClient;
 exports.StelaSdk = StelaSdk;
 exports.TOKENS = TOKENS;
@@ -3958,41 +4370,61 @@ exports.VIRTUAL_SHARE_OFFSET = VIRTUAL_SHARE_OFFSET;
 exports.accruedInterestWithBuffer = accruedInterestWithBuffer;
 exports.addressesEqual = addressesEqual;
 exports.calculateFeeShares = calculateFeeShares;
+exports.computeInterestRate = computeInterestRate;
 exports.computePositionValue = computePositionValue;
 exports.computeSafePositionFloor = computeSafePositionFloor;
 exports.computeStatus = computeStatus;
 exports.convertToShares = convertToShares;
 exports.deserializeSignature = deserializeSignature;
 exports.divCeil = divCeil;
+exports.enrichStatus = enrichStatus;
 exports.findTokenByAddress = findTokenByAddress;
 exports.formatAddress = formatAddress;
 exports.formatDuration = formatDuration;
+exports.formatDurationHuman = formatDurationHuman;
+exports.formatSig = formatSig;
 exports.formatTimestamp = formatTimestamp;
 exports.formatTokenValue = formatTokenValue;
 exports.fromU256 = fromU256;
 exports.getBatchLendOfferTypedData = getBatchLendOfferTypedData;
+exports.getCancelOrderTypedData = getCancelOrderTypedData;
 exports.getCollateralSaleOfferTypedData = getCollateralSaleOfferTypedData;
 exports.getCollectionBorrowAcceptanceTypedData = getCollectionBorrowAcceptanceTypedData;
 exports.getCollectionLendOfferTypedData = getCollectionLendOfferTypedData;
 exports.getInscriptionOrderTypedData = getInscriptionOrderTypedData;
 exports.getLendOfferTypedData = getLendOfferTypedData;
 exports.getNFTCollections = getNFTCollections;
+exports.getNonce = getNonce;
+exports.getOrderStatusBadgeVariant = getOrderStatusBadgeVariant;
+exports.getOrderStatusLabel = getOrderStatusLabel;
 exports.getRefinanceApprovalTypedData = getRefinanceApprovalTypedData;
 exports.getRefinanceOfferTypedData = getRefinanceOfferTypedData;
 exports.getRenegotiationProposalTypedData = getRenegotiationProposalTypedData;
+exports.getStatusBadgeVariant = getStatusBadgeVariant;
+exports.getStatusLabel = getStatusLabel;
+exports.getTermsAcknowledgmentTypedData = getTermsAcknowledgmentTypedData;
 exports.getTokensForNetwork = getTokensForNetwork;
 exports.hashAssets = hashAssets;
 exports.hashBatchEntries = hashBatchEntries;
 exports.inscriptionIdToHex = inscriptionIdToHex;
+exports.inscriptionMatchesGroup = inscriptionMatchesGroup;
 exports.normalizeAddress = normalizeAddress;
+exports.normalizeOrderData = normalizeOrderData;
+exports.orderMatchesGroup = orderMatchesGroup;
 exports.parseAmount = parseAmount;
+exports.parseAssetArray = parseAssetArray;
 exports.parseEvent = parseEvent;
 exports.parseEvents = parseEvents;
+exports.parseInscriptionCalldata = parseInscriptionCalldata;
+exports.parseOrderRow = parseOrderRow;
+exports.parseSigToArray = parseSigToArray;
 exports.proRataInterest = proRataInterest;
 exports.proportionalAssetValue = proportionalAssetValue;
 exports.resolveNetwork = resolveNetwork;
 exports.scaleByPercentage = scaleByPercentage;
+exports.serializeAssetCalldata = serializeAssetCalldata;
 exports.serializeSignature = serializeSignature;
+exports.serializeSignatureCalldata = serializeSignatureCalldata;
 exports.shareProportionBps = shareProportionBps;
 exports.sharesToPercentage = sharesToPercentage;
 exports.toHex = toHex;