@fepvenancio/stela-sdk 0.8.0 → 0.9.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"),
@@ -1052,6 +1144,210 @@ var stela_default = [
       {
         name: "collateral_asset_count",
         type: "core::integer::u32"
+      },
+      {
+        name: "auction_started",
+        type: "core::bool"
+      },
+      {
+        name: "auction_start_time",
+        type: "core::integer::u64"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "stela::snip12::CollectionLendOffer",
+    members: [
+      {
+        name: "lender",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "debt_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "interest_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "debt_count",
+        type: "core::integer::u32"
+      },
+      {
+        name: "interest_count",
+        type: "core::integer::u32"
+      },
+      {
+        name: "collection_address",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "duration",
+        type: "core::integer::u64"
+      },
+      {
+        name: "deadline",
+        type: "core::integer::u64"
+      },
+      {
+        name: "nonce",
+        type: "core::felt252"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "stela::snip12::CollectionBorrowAcceptance",
+    members: [
+      {
+        name: "offer_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "borrower",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "token_id",
+        type: "core::integer::u256"
+      },
+      {
+        name: "nonce",
+        type: "core::felt252"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "stela::snip12::RenegotiationProposal",
+    members: [
+      {
+        name: "inscription_id",
+        type: "core::integer::u256"
+      },
+      {
+        name: "proposer",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "new_duration",
+        type: "core::integer::u64"
+      },
+      {
+        name: "new_interest_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "new_interest_count",
+        type: "core::integer::u32"
+      },
+      {
+        name: "proposal_deadline",
+        type: "core::integer::u64"
+      },
+      {
+        name: "nonce",
+        type: "core::felt252"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "stela::snip12::CollateralSaleOffer",
+    members: [
+      {
+        name: "inscription_id",
+        type: "core::integer::u256"
+      },
+      {
+        name: "borrower",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "min_price",
+        type: "core::integer::u256"
+      },
+      {
+        name: "payment_token",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "allowed_buyer",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "deadline",
+        type: "core::integer::u64"
+      },
+      {
+        name: "nonce",
+        type: "core::felt252"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "stela::snip12::RefinanceOffer",
+    members: [
+      {
+        name: "inscription_id",
+        type: "core::integer::u256"
+      },
+      {
+        name: "new_lender",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "new_debt_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "new_interest_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "new_debt_count",
+        type: "core::integer::u32"
+      },
+      {
+        name: "new_interest_count",
+        type: "core::integer::u32"
+      },
+      {
+        name: "new_duration",
+        type: "core::integer::u64"
+      },
+      {
+        name: "deadline",
+        type: "core::integer::u64"
+      },
+      {
+        name: "nonce",
+        type: "core::felt252"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "stela::snip12::RefinanceApproval",
+    members: [
+      {
+        name: "inscription_id",
+        type: "core::integer::u256"
+      },
+      {
+        name: "offer_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "borrower",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "nonce",
+        type: "core::felt252"
       }
     ]
   },
@@ -1604,6 +1900,206 @@ var stela_default = [
         ],
         outputs: [],
         state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "settle_collection",
+        inputs: [
+          {
+            name: "offer",
+            type: "stela::snip12::CollectionLendOffer"
+          },
+          {
+            name: "acceptance",
+            type: "stela::snip12::CollectionBorrowAcceptance"
+          },
+          {
+            name: "debt_assets",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          },
+          {
+            name: "interest_assets",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          },
+          {
+            name: "lender_sig",
+            type: "core::array::Array::<core::felt252>"
+          },
+          {
+            name: "borrower_sig",
+            type: "core::array::Array::<core::felt252>"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "commit_renegotiation",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          },
+          {
+            name: "proposal_hash",
+            type: "core::felt252"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "execute_renegotiation",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          },
+          {
+            name: "proposal",
+            type: "stela::snip12::RenegotiationProposal"
+          },
+          {
+            name: "proposer_sig",
+            type: "core::array::Array::<core::felt252>"
+          },
+          {
+            name: "new_interest_assets",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "buy_collateral",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          },
+          {
+            name: "offer",
+            type: "stela::snip12::CollateralSaleOffer"
+          },
+          {
+            name: "borrower_sig",
+            type: "core::array::Array::<core::felt252>"
+          },
+          {
+            name: "sale_price",
+            type: "core::integer::u256"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "refinance",
+        inputs: [
+          {
+            name: "offer",
+            type: "stela::snip12::RefinanceOffer"
+          },
+          {
+            name: "new_debt_assets",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          },
+          {
+            name: "new_interest_assets",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          },
+          {
+            name: "new_lender_sig",
+            type: "core::array::Array::<core::felt252>"
+          },
+          {
+            name: "approval",
+            type: "stela::snip12::RefinanceApproval"
+          },
+          {
+            name: "borrower_sig",
+            type: "core::array::Array::<core::felt252>"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "start_auction",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "bid",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "claim_collateral",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "get_auction_price",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          },
+          {
+            name: "debt_index",
+            type: "core::integer::u32"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::integer::u256"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "get_auction_end_time",
+        inputs: [
+          {
+            name: "inscription_id",
+            type: "core::integer::u256"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::integer::u64"
+          }
+        ],
+        state_mutability: "view"
       }
     ]
   },
@@ -3066,9 +3562,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)]);
@@ -3092,6 +3593,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;
@@ -3376,7 +3924,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);
@@ -3392,6 +3941,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;
@@ -3405,11 +3955,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;
@@ -3422,6 +3976,7 @@ exports.getCollectionBorrowAcceptanceTypedData = getCollectionBorrowAcceptanceTy
 exports.getCollectionLendOfferTypedData = getCollectionLendOfferTypedData;
 exports.getInscriptionOrderTypedData = getInscriptionOrderTypedData;
 exports.getLendOfferTypedData = getLendOfferTypedData;
+exports.getNFTCollections = getNFTCollections;
 exports.getRefinanceApprovalTypedData = getRefinanceApprovalTypedData;
 exports.getRefinanceOfferTypedData = getRefinanceOfferTypedData;
 exports.getRenegotiationProposalTypedData = getRenegotiationProposalTypedData;
@@ -3433,9 +3988,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;