@fepvenancio/stela-sdk 0.8.1 → 0.10.0

package/dist/index.cjs

@@ -258,11 +258,35 @@ var TOKENS = [
     addresses: {
       sepolia: "0x04f2345306bf8ef1c8c1445661354ef08421aa092459445a5d6b46641237e943"
     }
+  },
+  // NFT Collections (ERC721)
+  {
+    symbol: "GENESIS",
+    name: "Stela Genesis",
+    decimals: 0,
+    assetType: "ERC721",
+    addresses: {
+      sepolia: "0x0265ea52ffbf1b7e1a029b94fe1a2023899dd0bc02eb1f11c9b04ea90e957d28"
+    }
+  },
+  {
+    symbol: "MockNFT",
+    name: "Mock ERC721",
+    decimals: 0,
+    assetType: "ERC721",
+    addresses: {
+      sepolia: "0x032bfd52134ad92beae1bc5018a3748e1d1240efd627220e314c07e4c63433d5"
+    }
   }
 ];
 function normalizeHex(addr) {
   return "0x" + addr.replace(/^0x0*/i, "").toLowerCase();
 }
+function getNFTCollections(network) {
+  return TOKENS.filter(
+    (t) => t.assetType === "ERC721" && t.addresses[network] !== void 0
+  );
+}
 function getTokensForNetwork(network) {
   return TOKENS.filter((t) => t.addresses[network] !== void 0);
 }
@@ -288,6 +312,74 @@ function sharesToPercentage(shares, totalSupply, currentIssuedPercentage) {
 function calculateFeeShares(shares, feeBps) {
   return shares * feeBps / MAX_BPS;
 }
+function divCeil(a, b) {
+  if (a === 0n) return 0n;
+  return (a + b - 1n) / b;
+}
+function proRataInterest(amount, elapsed, duration) {
+  if (amount === 0n || elapsed === 0n) return 0n;
+  if (elapsed >= duration) return amount;
+  return divCeil(amount * elapsed, duration);
+}
+
+// src/math/position.ts
+var DEFAULT_DUST_BUFFER_SECONDS = 60n;
+function shareProportionBps(shares, totalSupply) {
+  if (totalSupply === 0n) return 0n;
+  return shares * MAX_BPS / totalSupply;
+}
+function proportionalAssetValue(assetValue, shares, totalSupply) {
+  if (totalSupply === 0n || shares === 0n) return 0n;
+  return assetValue * shares / totalSupply;
+}
+function computePositionValue(params) {
+  const { shares, totalSupply, elapsed, duration } = params;
+  const shareBps = shareProportionBps(shares, totalSupply);
+  const debt = params.debtAssets.map((asset) => ({
+    asset,
+    proportionalValue: proportionalAssetValue(asset.value, shares, totalSupply)
+  }));
+  const interest = params.interestAssets.map((asset) => {
+    const fullInterest = proportionalAssetValue(asset.value, shares, totalSupply);
+    const accruedInterest = duration === 0n ? fullInterest : proRataInterest(fullInterest, elapsed, duration);
+    return { asset, fullInterest, accruedInterest };
+  });
+  const collateral = params.collateralAssets.map((asset) => ({
+    asset,
+    proportionalValue: proportionalAssetValue(asset.value, shares, totalSupply)
+  }));
+  return {
+    inscriptionId: params.inscriptionId,
+    shares,
+    totalSupply,
+    shareBps,
+    debt,
+    interest,
+    collateral,
+    accrued: interest,
+    elapsed,
+    duration
+  };
+}
+function accruedInterestWithBuffer(amount, elapsed, duration, bufferSeconds = DEFAULT_DUST_BUFFER_SECONDS) {
+  if (duration === 0n) return amount;
+  const bufferedElapsed = elapsed + bufferSeconds;
+  return proRataInterest(amount, bufferedElapsed, duration);
+}
+function computeSafePositionFloor(params) {
+  const { shares, totalSupply, elapsed, duration } = params;
+  const buffer = params.bufferSeconds ?? DEFAULT_DUST_BUFFER_SECONDS;
+  const debtFloor = params.debtAssets.map((asset) => ({
+    asset,
+    proportionalValue: proportionalAssetValue(asset.value, shares, totalSupply)
+  }));
+  const interestFloor = params.interestAssets.map((asset) => {
+    const fullInterest = proportionalAssetValue(asset.value, shares, totalSupply);
+    const safeAccrued = accruedInterestWithBuffer(fullInterest, elapsed, duration, buffer);
+    return { asset, proportionalValue: safeAccrued };
+  });
+  return { debtFloor, interestFloor };
+}
 var SELECTORS = {
   InscriptionCreated: starknet.hash.getSelectorFromName("InscriptionCreated"),
   InscriptionSigned: starknet.hash.getSelectorFromName("InscriptionSigned"),
@@ -751,6 +843,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) {
@@ -3470,9 +3583,14 @@ function extractFieldU256(val) {
 }
 var ShareClient = class {
   contract;
+  address;
+  account;
   constructor(opts) {
+    this.address = opts.stelaAddress;
     this.contract = new starknet.Contract(stela_default, opts.stelaAddress, opts.provider);
+    this.account = opts.account;
   }
+  // ── Read Methods ───────────────────────────────────────────────────
   /** Get share balance for an account on a specific inscription */
   async balanceOf(account, inscriptionId) {
     const result = await this.contract.call("balance_of", [account, ...toU256(inscriptionId)]);
@@ -3496,6 +3614,53 @@ var ShareClient = class {
     const result = await this.contract.call("is_approved_for_all", [owner, operator]);
     return Boolean(result[0]);
   }
+  // ── Call Builders ──────────────────────────────────────────────────
+  /**
+   * Build a call to transfer shares (ERC1155 safeTransferFrom).
+   * This enables secondary market trading of lending positions.
+   *
+   * @param from - Current share holder
+   * @param to - Recipient address
+   * @param inscriptionId - The inscription (token ID)
+   * @param amount - Number of shares to transfer
+   * @param data - Optional calldata (empty array by default)
+   */
+  buildTransferShares(from, to, inscriptionId, amount, data = []) {
+    return {
+      contractAddress: this.address,
+      entrypoint: "safe_transfer_from",
+      calldata: [from, to, ...toU256(inscriptionId), ...toU256(amount), String(data.length), ...data]
+    };
+  }
+  /**
+   * Build a call to approve an operator for all ERC1155 tokens.
+   * Required before a marketplace contract can transfer shares on your behalf.
+   *
+   * @param operator - The address to approve (e.g., marketplace contract)
+   * @param approved - Whether to approve or revoke
+   */
+  buildSetApprovalForAll(operator, approved) {
+    return {
+      contractAddress: this.address,
+      entrypoint: "set_approval_for_all",
+      calldata: [operator, approved ? "1" : "0"]
+    };
+  }
+  // ── Execute Methods ────────────────────────────────────────────────
+  /** Transfer shares to another address */
+  async transferShares(from, to, inscriptionId, amount, data = []) {
+    if (!this.account) throw new Error("Account required for write operations");
+    const result = await this.account.execute([
+      this.buildTransferShares(from, to, inscriptionId, amount, data)
+    ]);
+    return { transaction_hash: result.transaction_hash };
+  }
+  /** Approve or revoke an operator for all ERC1155 tokens */
+  async setApprovalForAll(operator, approved) {
+    if (!this.account) throw new Error("Account required for write operations");
+    const result = await this.account.execute([this.buildSetApprovalForAll(operator, approved)]);
+    return { transaction_hash: result.transaction_hash };
+  }
 };
 function extractBigInt(result) {
   const arr = result;
@@ -3780,7 +3945,8 @@ var StelaSdk = class {
     });
     this.shares = new ShareClient({
       stelaAddress: this.stelaAddress,
-      provider: opts.provider
+      provider: opts.provider,
+      account: opts.account
     });
     const stelaContract = new starknet.Contract(stela_default, this.stelaAddress, opts.provider);
     this.locker = new LockerClient(stelaContract, opts.provider, opts.account);
@@ -3796,6 +3962,7 @@ exports.AUCTION_RESERVE_BPS = AUCTION_RESERVE_BPS;
 exports.ApiClient = ApiClient;
 exports.ApiError = ApiError;
 exports.CHAIN_ID = CHAIN_ID;
+exports.DEFAULT_DUST_BUFFER_SECONDS = DEFAULT_DUST_BUFFER_SECONDS;
 exports.EXPLORER_TX_URL = EXPLORER_TX_URL;
 exports.GRACE_PERIOD = GRACE_PERIOD;
 exports.InscriptionClient = InscriptionClient;
@@ -3809,11 +3976,15 @@ exports.StelaSdk = StelaSdk;
 exports.TOKENS = TOKENS;
 exports.VALID_STATUSES = VALID_STATUSES;
 exports.VIRTUAL_SHARE_OFFSET = VIRTUAL_SHARE_OFFSET;
+exports.accruedInterestWithBuffer = accruedInterestWithBuffer;
 exports.addressesEqual = addressesEqual;
 exports.calculateFeeShares = calculateFeeShares;
+exports.computePositionValue = computePositionValue;
+exports.computeSafePositionFloor = computeSafePositionFloor;
 exports.computeStatus = computeStatus;
 exports.convertToShares = convertToShares;
 exports.deserializeSignature = deserializeSignature;
+exports.divCeil = divCeil;
 exports.findTokenByAddress = findTokenByAddress;
 exports.formatAddress = formatAddress;
 exports.formatDuration = formatDuration;
@@ -3826,9 +3997,11 @@ exports.getCollectionBorrowAcceptanceTypedData = getCollectionBorrowAcceptanceTy
 exports.getCollectionLendOfferTypedData = getCollectionLendOfferTypedData;
 exports.getInscriptionOrderTypedData = getInscriptionOrderTypedData;
 exports.getLendOfferTypedData = getLendOfferTypedData;
+exports.getNFTCollections = getNFTCollections;
 exports.getRefinanceApprovalTypedData = getRefinanceApprovalTypedData;
 exports.getRefinanceOfferTypedData = getRefinanceOfferTypedData;
 exports.getRenegotiationProposalTypedData = getRenegotiationProposalTypedData;
+exports.getTermsAcknowledgmentTypedData = getTermsAcknowledgmentTypedData;
 exports.getTokensForNetwork = getTokensForNetwork;
 exports.hashAssets = hashAssets;
 exports.hashBatchEntries = hashBatchEntries;
@@ -3837,9 +4010,12 @@ exports.normalizeAddress = normalizeAddress;
 exports.parseAmount = parseAmount;
 exports.parseEvent = parseEvent;
 exports.parseEvents = parseEvents;
+exports.proRataInterest = proRataInterest;
+exports.proportionalAssetValue = proportionalAssetValue;
 exports.resolveNetwork = resolveNetwork;
 exports.scaleByPercentage = scaleByPercentage;
 exports.serializeSignature = serializeSignature;
+exports.shareProportionBps = shareProportionBps;
 exports.sharesToPercentage = sharesToPercentage;
 exports.toHex = toHex;
 exports.toU256 = toU256;