@fepvenancio/stela-sdk 0.7.0 → 0.8.0

package/dist/index.cjs

@@ -24,7 +24,7 @@ var STATUS_LABELS = {
 
 // src/constants/addresses.ts
 var STELA_ADDRESS = {
-  sepolia: "0x038a0b195e011fbfd75e9bce9bbc4137ebc5296882e11c5769c333b90bda4f89",
+  sepolia: "0x0109c6caae0c5b4da6e063ed6c02ae784be05aa90806501a48dcfbb213bd7c03",
   mainnet: "0x0"
 };
 var VALID_NETWORKS = ["sepolia", "mainnet"];
@@ -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) {
@@ -1159,17 +1342,6 @@ var stela_default = [
         ],
         state_mutability: "view"
       },
-      {
-        type: "function",
-        name: "is_paused",
-        inputs: [],
-        outputs: [
-          {
-            type: "core::bool"
-          }
-        ],
-        state_mutability: "view"
-      },
       {
         type: "function",
         name: "is_order_registered",
@@ -1355,36 +1527,55 @@ var stela_default = [
       },
       {
         type: "function",
-        name: "pause",
-        inputs: [],
-        outputs: [],
-        state_mutability: "external"
-      },
-      {
-        type: "function",
-        name: "unpause",
-        inputs: [],
+        name: "set_governance_target",
+        inputs: [
+          {
+            name: "target",
+            type: "core::starknet::contract_address::ContractAddress"
+          },
+          {
+            name: "whitelisted",
+            type: "core::bool"
+          }
+        ],
         outputs: [],
         state_mutability: "external"
       },
       {
         type: "function",
-        name: "get_pauser",
-        inputs: [],
-        outputs: [
+        name: "is_governance_target_whitelisted",
+        inputs: [
           {
+            name: "target",
             type: "core::starknet::contract_address::ContractAddress"
           }
         ],
+        outputs: [
+          {
+            type: "core::bool"
+          }
+        ],
         state_mutability: "view"
       },
       {
         type: "function",
-        name: "set_pauser",
+        name: "set_locker_allowed_selector",
         inputs: [
           {
-            name: "new_pauser",
+            name: "locker",
+            type: "core::starknet::contract_address::ContractAddress"
+          },
+          {
+            name: "target",
             type: "core::starknet::contract_address::ContractAddress"
+          },
+          {
+            name: "selector",
+            type: "core::felt252"
+          },
+          {
+            name: "allowed",
+            type: "core::bool"
           }
         ],
         outputs: [],
@@ -1392,11 +1583,11 @@ var stela_default = [
       },
       {
         type: "function",
-        name: "set_locker_allowed_selector",
+        name: "set_borrower_governance_selector",
         inputs: [
           {
-            name: "locker",
-            type: "core::starknet::contract_address::ContractAddress"
+            name: "inscription_id",
+            type: "core::integer::u256"
           },
           {
             name: "target",
@@ -1850,10 +2041,6 @@ var stela_default = [
       {
         name: "implementation_hash",
         type: "core::felt252"
-      },
-      {
-        name: "pauser",
-        type: "core::starknet::contract_address::ContractAddress"
       }
     ]
   },
@@ -2050,47 +2237,6 @@ var stela_default = [
     kind: "enum",
     variants: []
   },
-  {
-    type: "event",
-    name: "openzeppelin_security::pausable::PausableComponent::Paused",
-    kind: "struct",
-    members: [
-      {
-        name: "account",
-        type: "core::starknet::contract_address::ContractAddress",
-        kind: "data"
-      }
-    ]
-  },
-  {
-    type: "event",
-    name: "openzeppelin_security::pausable::PausableComponent::Unpaused",
-    kind: "struct",
-    members: [
-      {
-        name: "account",
-        type: "core::starknet::contract_address::ContractAddress",
-        kind: "data"
-      }
-    ]
-  },
-  {
-    type: "event",
-    name: "openzeppelin_security::pausable::PausableComponent::Event",
-    kind: "enum",
-    variants: [
-      {
-        name: "Paused",
-        type: "openzeppelin_security::pausable::PausableComponent::Paused",
-        kind: "nested"
-      },
-      {
-        name: "Unpaused",
-        type: "openzeppelin_security::pausable::PausableComponent::Unpaused",
-        kind: "nested"
-      }
-    ]
-  },
   {
     type: "event",
     name: "openzeppelin_utils::cryptography::nonces::NoncesComponent::Event",
@@ -2322,6 +2468,28 @@ var stela_default = [
       }
     ]
   },
+  {
+    type: "event",
+    name: "stela::stela::StelaProtocol::CollateralReturned",
+    kind: "struct",
+    members: [
+      {
+        name: "inscription_id",
+        type: "core::integer::u256",
+        kind: "key"
+      },
+      {
+        name: "borrower",
+        type: "core::starknet::contract_address::ContractAddress",
+        kind: "data"
+      },
+      {
+        name: "asset_count",
+        type: "core::integer::u32",
+        kind: "data"
+      }
+    ]
+  },
   {
     type: "event",
     name: "stela::stela::StelaProtocol::Event",
@@ -2347,11 +2515,6 @@ var stela_default = [
         type: "openzeppelin_security::reentrancyguard::ReentrancyGuardComponent::Event",
         kind: "flat"
       },
-      {
-        name: "PausableEvent",
-        type: "openzeppelin_security::pausable::PausableComponent::Event",
-        kind: "flat"
-      },
       {
         name: "NoncesEvent",
         type: "openzeppelin_utils::cryptography::nonces::NoncesComponent::Event",
@@ -2406,6 +2569,11 @@ var stela_default = [
         name: "OrdersBulkCancelled",
         type: "stela::stela::StelaProtocol::OrdersBulkCancelled",
         kind: "nested"
+      },
+      {
+        name: "CollateralReturned",
+        type: "stela::stela::StelaProtocol::CollateralReturned",
+        kind: "nested"
       }
     ]
   }
@@ -2626,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.
@@ -2667,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)];
@@ -2706,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) {
@@ -3038,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;
@@ -3065,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;