@fepvenancio/stela-sdk 0.7.1 → 0.8.0

package/dist/index.cjs

@@ -58,6 +58,10 @@ var ASSET_TYPE_NAMES = {
   2: "ERC1155",
   3: "ERC4626"
 };
+var GRACE_PERIOD = 86400n;
+var AUCTION_DURATION = 86400n;
+var AUCTION_PENALTY_BPS = 500n;
+var AUCTION_RESERVE_BPS = 1000n;
 var U128_MAX = (1n << 128n) - 1n;
 var U256_MAX = (1n << 256n) - 1n;
 var toU256 = (n) => {
@@ -568,6 +572,185 @@ function getBatchLendOfferTypedData(params) {
     }
   };
 }
+function u256Message(value) {
+  return {
+    low: (value & (1n << 128n) - 1n).toString(),
+    high: (value >> 128n).toString()
+  };
+}
+var STARKNET_DOMAIN_TYPE = [
+  { name: "name", type: "shortstring" },
+  { name: "version", type: "shortstring" },
+  { name: "chainId", type: "shortstring" },
+  { name: "revision", type: "shortstring" }
+];
+var U256_TYPE = [
+  { name: "low", type: "u128" },
+  { name: "high", type: "u128" }
+];
+function getCollectionLendOfferTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: STARKNET_DOMAIN_TYPE,
+      CollectionLendOffer: [
+        { name: "lender", type: "ContractAddress" },
+        { name: "debt_hash", type: "felt" },
+        { name: "interest_hash", type: "felt" },
+        { name: "debt_count", type: "u128" },
+        { name: "interest_count", type: "u128" },
+        { name: "collection_address", type: "ContractAddress" },
+        { name: "duration", type: "u128" },
+        { name: "deadline", type: "u128" },
+        { name: "nonce", type: "felt" }
+      ]
+    },
+    primaryType: "CollectionLendOffer",
+    domain: { ...STELA_DOMAIN, chainId: params.chainId },
+    message: {
+      lender: params.lender,
+      debt_hash: hashAssets(params.debtAssets),
+      interest_hash: hashAssets(params.interestAssets),
+      debt_count: params.debtCount.toString(),
+      interest_count: params.interestCount.toString(),
+      collection_address: params.collectionAddress,
+      duration: params.duration.toString(),
+      deadline: params.deadline.toString(),
+      nonce: params.nonce.toString()
+    }
+  };
+}
+function getCollectionBorrowAcceptanceTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: STARKNET_DOMAIN_TYPE,
+      CollectionBorrowAcceptance: [
+        { name: "offer_hash", type: "felt" },
+        { name: "borrower", type: "ContractAddress" },
+        { name: "token_id", type: "u256" },
+        { name: "nonce", type: "felt" }
+      ],
+      u256: U256_TYPE
+    },
+    primaryType: "CollectionBorrowAcceptance",
+    domain: { ...STELA_DOMAIN, chainId: params.chainId },
+    message: {
+      offer_hash: params.offerHash,
+      borrower: params.borrower,
+      token_id: u256Message(params.tokenId),
+      nonce: params.nonce.toString()
+    }
+  };
+}
+function getRenegotiationProposalTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: STARKNET_DOMAIN_TYPE,
+      RenegotiationProposal: [
+        { name: "inscription_id", type: "u256" },
+        { name: "proposer", type: "ContractAddress" },
+        { name: "new_duration", type: "u128" },
+        { name: "new_interest_hash", type: "felt" },
+        { name: "new_interest_count", type: "u128" },
+        { name: "proposal_deadline", type: "u128" },
+        { name: "nonce", type: "felt" }
+      ],
+      u256: U256_TYPE
+    },
+    primaryType: "RenegotiationProposal",
+    domain: { ...STELA_DOMAIN, chainId: params.chainId },
+    message: {
+      inscription_id: u256Message(params.inscriptionId),
+      proposer: params.proposer,
+      new_duration: params.newDuration.toString(),
+      new_interest_hash: hashAssets(params.newInterestAssets),
+      new_interest_count: params.newInterestCount.toString(),
+      proposal_deadline: params.proposalDeadline.toString(),
+      nonce: params.nonce.toString()
+    }
+  };
+}
+function getCollateralSaleOfferTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: STARKNET_DOMAIN_TYPE,
+      CollateralSaleOffer: [
+        { name: "inscription_id", type: "u256" },
+        { name: "borrower", type: "ContractAddress" },
+        { name: "min_price", type: "u256" },
+        { name: "payment_token", type: "ContractAddress" },
+        { name: "allowed_buyer", type: "ContractAddress" },
+        { name: "deadline", type: "u128" },
+        { name: "nonce", type: "felt" }
+      ],
+      u256: U256_TYPE
+    },
+    primaryType: "CollateralSaleOffer",
+    domain: { ...STELA_DOMAIN, chainId: params.chainId },
+    message: {
+      inscription_id: u256Message(params.inscriptionId),
+      borrower: params.borrower,
+      min_price: u256Message(params.minPrice),
+      payment_token: params.paymentToken,
+      allowed_buyer: params.allowedBuyer,
+      deadline: params.deadline.toString(),
+      nonce: params.nonce.toString()
+    }
+  };
+}
+function getRefinanceOfferTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: STARKNET_DOMAIN_TYPE,
+      RefinanceOffer: [
+        { name: "inscription_id", type: "u256" },
+        { name: "new_lender", type: "ContractAddress" },
+        { name: "new_debt_hash", type: "felt" },
+        { name: "new_interest_hash", type: "felt" },
+        { name: "new_debt_count", type: "u128" },
+        { name: "new_interest_count", type: "u128" },
+        { name: "new_duration", type: "u128" },
+        { name: "deadline", type: "u128" },
+        { name: "nonce", type: "felt" }
+      ],
+      u256: U256_TYPE
+    },
+    primaryType: "RefinanceOffer",
+    domain: { ...STELA_DOMAIN, chainId: params.chainId },
+    message: {
+      inscription_id: u256Message(params.inscriptionId),
+      new_lender: params.newLender,
+      new_debt_hash: hashAssets(params.newDebtAssets),
+      new_interest_hash: hashAssets(params.newInterestAssets),
+      new_debt_count: params.newDebtCount.toString(),
+      new_interest_count: params.newInterestCount.toString(),
+      new_duration: params.newDuration.toString(),
+      deadline: params.deadline.toString(),
+      nonce: params.nonce.toString()
+    }
+  };
+}
+function getRefinanceApprovalTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: STARKNET_DOMAIN_TYPE,
+      RefinanceApproval: [
+        { name: "inscription_id", type: "u256" },
+        { name: "offer_hash", type: "felt" },
+        { name: "borrower", type: "ContractAddress" },
+        { name: "nonce", type: "felt" }
+      ],
+      u256: U256_TYPE
+    },
+    primaryType: "RefinanceApproval",
+    domain: { ...STELA_DOMAIN, chainId: params.chainId },
+    message: {
+      inscription_id: u256Message(params.inscriptionId),
+      offer_hash: params.offerHash,
+      borrower: params.borrower,
+      nonce: params.nonce.toString()
+    }
+  };
+}
 
 // src/offchain/signature.ts
 function serializeSignature(sig) {
@@ -2611,6 +2794,155 @@ var InscriptionClient = class {
       calldata: [minNonce]
     };
   }
+  // ── T1 Call Builders ─────────────────────────────────────────────────
+  /** T1-2: Settle a collection-wide lend offer */
+  buildSettleCollection(params) {
+    const calldata = [
+      // CollectionLendOffer struct (9 fields)
+      params.offer.lender,
+      params.offer.debtHash,
+      params.offer.interestHash,
+      String(params.offer.debtCount),
+      String(params.offer.interestCount),
+      params.offer.collectionAddress,
+      params.offer.duration.toString(),
+      params.offer.deadline.toString(),
+      params.offer.nonce.toString(),
+      // CollectionBorrowAcceptance struct (4 fields)
+      params.acceptance.offerHash,
+      params.acceptance.borrower,
+      ...toU256(params.acceptance.tokenId),
+      params.acceptance.nonce.toString(),
+      // debt_assets array
+      ...serializeAssets(params.debtAssets),
+      // interest_assets array
+      ...serializeAssets(params.interestAssets),
+      // lender_sig array
+      String(params.lenderSig.length),
+      ...params.lenderSig,
+      // borrower_sig array
+      String(params.borrowerSig.length),
+      ...params.borrowerSig
+    ];
+    return { contractAddress: this.address, entrypoint: "settle_collection", calldata };
+  }
+  /** T1-4: Commit a renegotiation proposal hash on-chain */
+  buildCommitRenegotiation(inscriptionId, proposalHash) {
+    return {
+      contractAddress: this.address,
+      entrypoint: "commit_renegotiation",
+      calldata: [...toU256(inscriptionId), proposalHash]
+    };
+  }
+  /** T1-4: Execute a committed renegotiation proposal */
+  buildExecuteRenegotiation(params) {
+    const calldata = [
+      ...toU256(params.inscriptionId),
+      // RenegotiationProposal struct (7 fields)
+      ...toU256(params.proposal.inscriptionId),
+      params.proposal.proposer,
+      params.proposal.newDuration.toString(),
+      params.proposal.newInterestHash,
+      String(params.proposal.newInterestCount),
+      params.proposal.proposalDeadline.toString(),
+      params.proposal.nonce.toString(),
+      // proposer_sig array
+      String(params.proposerSig.length),
+      ...params.proposerSig,
+      // new_interest_assets array
+      ...serializeAssets(params.newInterestAssets)
+    ];
+    return { contractAddress: this.address, entrypoint: "execute_renegotiation", calldata };
+  }
+  /** T1-5: Buy collateral from a borrower's sale offer */
+  buildBuyCollateral(params) {
+    const calldata = [
+      ...toU256(params.inscriptionId),
+      // CollateralSaleOffer struct (7 fields)
+      ...toU256(params.offer.inscriptionId),
+      params.offer.borrower,
+      ...toU256(params.offer.minPrice),
+      params.offer.paymentToken,
+      params.offer.allowedBuyer,
+      params.offer.deadline.toString(),
+      params.offer.nonce.toString(),
+      // borrower_sig array
+      String(params.borrowerSig.length),
+      ...params.borrowerSig,
+      // sale_price
+      ...toU256(params.salePrice)
+    ];
+    return { contractAddress: this.address, entrypoint: "buy_collateral", calldata };
+  }
+  /** T1-1: Refinance an existing loan with a new lender */
+  buildRefinance(params) {
+    const calldata = [
+      // RefinanceOffer struct (9 fields)
+      ...toU256(params.offer.inscriptionId),
+      params.offer.newLender,
+      params.offer.newDebtHash,
+      params.offer.newInterestHash,
+      String(params.offer.newDebtCount),
+      String(params.offer.newInterestCount),
+      params.offer.newDuration.toString(),
+      params.offer.deadline.toString(),
+      params.offer.nonce.toString(),
+      // new_debt_assets array
+      ...serializeAssets(params.newDebtAssets),
+      // new_interest_assets array
+      ...serializeAssets(params.newInterestAssets),
+      // new_lender_sig array
+      String(params.newLenderSig.length),
+      ...params.newLenderSig,
+      // RefinanceApproval struct (4 fields)
+      ...toU256(params.approval.inscriptionId),
+      params.approval.offerHash,
+      params.approval.borrower,
+      params.approval.nonce.toString(),
+      // borrower_sig array
+      String(params.borrowerSig.length),
+      ...params.borrowerSig
+    ];
+    return { contractAddress: this.address, entrypoint: "refinance", calldata };
+  }
+  /** T1-3: Start a Dutch auction on an expired, unfilled inscription */
+  buildStartAuction(inscriptionId) {
+    return {
+      contractAddress: this.address,
+      entrypoint: "start_auction",
+      calldata: [...toU256(inscriptionId)]
+    };
+  }
+  /** T1-3: Bid on an active Dutch auction */
+  buildBid(inscriptionId) {
+    return {
+      contractAddress: this.address,
+      entrypoint: "bid",
+      calldata: [...toU256(inscriptionId)]
+    };
+  }
+  /** T1-3: Claim collateral after an auction expires with no bids */
+  buildClaimCollateral(inscriptionId) {
+    return {
+      contractAddress: this.address,
+      entrypoint: "claim_collateral",
+      calldata: [...toU256(inscriptionId)]
+    };
+  }
+  // ── T1 Read Methods ──────────────────────────────────────────────────
+  /** T1-3: Get the current Dutch auction price for a specific debt asset */
+  async getAuctionPrice(inscriptionId, debtIndex) {
+    const result = await this.contract.call("get_auction_price", [
+      ...toU256(inscriptionId),
+      String(debtIndex)
+    ]);
+    return extractU256(result);
+  }
+  /** T1-3: Get the auction end timestamp */
+  async getAuctionEndTime(inscriptionId) {
+    const result = await this.contract.call("get_auction_end_time", toU256(inscriptionId));
+    return BigInt(String(result[0] ?? "0"));
+  }
   // ── Execute Methods ────────────────────────────────────────────────
   /**
    * Execute one or more calls via the connected account.
@@ -2652,6 +2984,35 @@ var InscriptionClient = class {
   async cancelOrdersByNonce(minNonce) {
     return this.execute([this.buildCancelOrdersByNonce(minNonce)]);
   }
+  // ── T1 Execute Methods ───────────────────────────────────────────────
+  async settleCollection(params) {
+    return this.execute([this.buildSettleCollection(params)]);
+  }
+  async commitRenegotiation(inscriptionId, proposalHash) {
+    return this.execute([this.buildCommitRenegotiation(inscriptionId, proposalHash)]);
+  }
+  async executeRenegotiation(params, approvals) {
+    const calls = [...approvals ?? [], this.buildExecuteRenegotiation(params)];
+    return this.execute(calls);
+  }
+  async buyCollateral(params, approvals) {
+    const calls = [...approvals ?? [], this.buildBuyCollateral(params)];
+    return this.execute(calls);
+  }
+  async refinance(params, approvals) {
+    const calls = [...approvals ?? [], this.buildRefinance(params)];
+    return this.execute(calls);
+  }
+  async startAuction(inscriptionId) {
+    return this.execute([this.buildStartAuction(inscriptionId)]);
+  }
+  async bid(inscriptionId, approvals) {
+    const calls = [...approvals ?? [], this.buildBid(inscriptionId)];
+    return this.execute(calls);
+  }
+  async claimCollateral(inscriptionId) {
+    return this.execute([this.buildClaimCollateral(inscriptionId)]);
+  }
 };
 function serializeAssets(assets) {
   const calldata = [String(assets.length)];
@@ -2691,7 +3052,9 @@ function parseStoredInscription(result) {
     multi_lender: Boolean(get("multi_lender", 8)),
     debt_asset_count: Number(get("debt_asset_count", 9)),
     interest_asset_count: Number(get("interest_asset_count", 10)),
-    collateral_asset_count: Number(get("collateral_asset_count", 11))
+    collateral_asset_count: Number(get("collateral_asset_count", 11)),
+    auction_started: Boolean(get("auction_started", 12)),
+    auction_start_time: BigInt(String(get("auction_start_time", 13) ?? "0"))
   };
 }
 function extractFieldU256(val) {
@@ -3023,10 +3386,14 @@ var StelaSdk = class {
 
 exports.ASSET_TYPE_ENUM = ASSET_TYPE_ENUM;
 exports.ASSET_TYPE_NAMES = ASSET_TYPE_NAMES;
+exports.AUCTION_DURATION = AUCTION_DURATION;
+exports.AUCTION_PENALTY_BPS = AUCTION_PENALTY_BPS;
+exports.AUCTION_RESERVE_BPS = AUCTION_RESERVE_BPS;
 exports.ApiClient = ApiClient;
 exports.ApiError = ApiError;
 exports.CHAIN_ID = CHAIN_ID;
 exports.EXPLORER_TX_URL = EXPLORER_TX_URL;
+exports.GRACE_PERIOD = GRACE_PERIOD;
 exports.InscriptionClient = InscriptionClient;
 exports.LockerClient = LockerClient;
 exports.MAX_BPS = MAX_BPS;
@@ -3050,8 +3417,14 @@ exports.formatTimestamp = formatTimestamp;
 exports.formatTokenValue = formatTokenValue;
 exports.fromU256 = fromU256;
 exports.getBatchLendOfferTypedData = getBatchLendOfferTypedData;
+exports.getCollateralSaleOfferTypedData = getCollateralSaleOfferTypedData;
+exports.getCollectionBorrowAcceptanceTypedData = getCollectionBorrowAcceptanceTypedData;
+exports.getCollectionLendOfferTypedData = getCollectionLendOfferTypedData;
 exports.getInscriptionOrderTypedData = getInscriptionOrderTypedData;
 exports.getLendOfferTypedData = getLendOfferTypedData;
+exports.getRefinanceApprovalTypedData = getRefinanceApprovalTypedData;
+exports.getRefinanceOfferTypedData = getRefinanceOfferTypedData;
+exports.getRenegotiationProposalTypedData = getRenegotiationProposalTypedData;
 exports.getTokensForNetwork = getTokensForNetwork;
 exports.hashAssets = hashAssets;
 exports.hashBatchEntries = hashBatchEntries;