@fepvenancio/stela-sdk 0.5.4 → 0.6.1

package/dist/index.d.cts

@@ -371,6 +371,17 @@ declare function parseEvent(raw: RawEvent): StelaEvent | null;
 /** Parse an array of raw events, skipping unrecognized ones. */
 declare function parseEvents(rawEvents: RawEvent[]): StelaEvent[];
 
+interface BatchEntry {
+    orderHash: string;
+    bps: bigint;
+}
+/**
+ * Hash an array of BatchEntry using Poseidon -- matches Cairo's hash_batch_entries().
+ *
+ * Format: Poseidon(count, order_hash_1, u256_hash(bps_1), order_hash_2, u256_hash(bps_2), ...)
+ * where u256_hash(bps) = Poseidon(U256_TYPE_HASH, low, high)
+ */
+declare function hashBatchEntries(entries: BatchEntry[]): string;
 /**
  * Hash an array of assets using Poseidon -- matches Cairo's hash_assets().
  *
@@ -414,6 +425,17 @@ declare function getLendOfferTypedData(params: {
     nonce: bigint;
     chainId: string;
 }): TypedData;
+/**
+ * Build SNIP-12 TypedData for a lender's BatchLendOffer.
+ * The lender signs this off-chain to accept multiple orders atomically.
+ */
+declare function getBatchLendOfferTypedData(params: {
+    batchHash: string;
+    count: number;
+    lender: string;
+    startNonce: bigint;
+    chainId: string;
+}): TypedData;
 
 /**
  * Serialize a starknet.js signature (Signature type) for storage in D1.
@@ -479,6 +501,33 @@ declare class InscriptionClient {
         };
         lenderSig: string[];
     }): Call;
+    buildBatchSettle(params: {
+        orders: Array<{
+            borrower: string;
+            debtHash: string;
+            interestHash: string;
+            collateralHash: string;
+            debtCount: number;
+            interestCount: number;
+            collateralCount: number;
+            duration: bigint;
+            deadline: bigint;
+            multiLender: boolean;
+            nonce: bigint;
+        }>;
+        debtAssetsFlat: Asset[];
+        interestAssetsFlat: Asset[];
+        collateralAssetsFlat: Asset[];
+        borrowerSigs: string[][];
+        batchOffer: {
+            batchHash: string;
+            count: number;
+            lender: string;
+            startNonce: bigint;
+        };
+        lenderSig: string[];
+        bpsList: bigint[];
+    }): Call;
     buildFillSignedOrder(order: SignedOrder, signature: string[], fillBps: bigint): Call;
     buildCancelOrder(order: SignedOrder): Call;
     buildCancelOrdersByNonce(minNonce: string): Call;
@@ -656,4 +705,4 @@ declare class StelaSdk {
     constructor(opts: StelaSdkOptions);
 }
 
-export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, CHAIN_ID, type Call, EXPLORER_TX_URL, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type OrderCancelledEvent, type OrderFilledEvent, type OrderSettledEvent, type OrdersBulkCancelledEvent, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type SignedOrder, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };
+export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, type BatchEntry, CHAIN_ID, type Call, EXPLORER_TX_URL, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type OrderCancelledEvent, type OrderFilledEvent, type OrderSettledEvent, type OrdersBulkCancelledEvent, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type SignedOrder, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getBatchLendOfferTypedData, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, hashBatchEntries, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };

package/dist/index.d.ts

@@ -371,6 +371,17 @@ declare function parseEvent(raw: RawEvent): StelaEvent | null;
 /** Parse an array of raw events, skipping unrecognized ones. */
 declare function parseEvents(rawEvents: RawEvent[]): StelaEvent[];
 
+interface BatchEntry {
+    orderHash: string;
+    bps: bigint;
+}
+/**
+ * Hash an array of BatchEntry using Poseidon -- matches Cairo's hash_batch_entries().
+ *
+ * Format: Poseidon(count, order_hash_1, u256_hash(bps_1), order_hash_2, u256_hash(bps_2), ...)
+ * where u256_hash(bps) = Poseidon(U256_TYPE_HASH, low, high)
+ */
+declare function hashBatchEntries(entries: BatchEntry[]): string;
 /**
  * Hash an array of assets using Poseidon -- matches Cairo's hash_assets().
  *
@@ -414,6 +425,17 @@ declare function getLendOfferTypedData(params: {
     nonce: bigint;
     chainId: string;
 }): TypedData;
+/**
+ * Build SNIP-12 TypedData for a lender's BatchLendOffer.
+ * The lender signs this off-chain to accept multiple orders atomically.
+ */
+declare function getBatchLendOfferTypedData(params: {
+    batchHash: string;
+    count: number;
+    lender: string;
+    startNonce: bigint;
+    chainId: string;
+}): TypedData;
 
 /**
  * Serialize a starknet.js signature (Signature type) for storage in D1.
@@ -479,6 +501,33 @@ declare class InscriptionClient {
         };
         lenderSig: string[];
     }): Call;
+    buildBatchSettle(params: {
+        orders: Array<{
+            borrower: string;
+            debtHash: string;
+            interestHash: string;
+            collateralHash: string;
+            debtCount: number;
+            interestCount: number;
+            collateralCount: number;
+            duration: bigint;
+            deadline: bigint;
+            multiLender: boolean;
+            nonce: bigint;
+        }>;
+        debtAssetsFlat: Asset[];
+        interestAssetsFlat: Asset[];
+        collateralAssetsFlat: Asset[];
+        borrowerSigs: string[][];
+        batchOffer: {
+            batchHash: string;
+            count: number;
+            lender: string;
+            startNonce: bigint;
+        };
+        lenderSig: string[];
+        bpsList: bigint[];
+    }): Call;
     buildFillSignedOrder(order: SignedOrder, signature: string[], fillBps: bigint): Call;
     buildCancelOrder(order: SignedOrder): Call;
     buildCancelOrdersByNonce(minNonce: string): Call;
@@ -656,4 +705,4 @@ declare class StelaSdk {
     constructor(opts: StelaSdkOptions);
 }
 
-export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, CHAIN_ID, type Call, EXPLORER_TX_URL, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type OrderCancelledEvent, type OrderFilledEvent, type OrderSettledEvent, type OrdersBulkCancelledEvent, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type SignedOrder, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };
+export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, type BatchEntry, CHAIN_ID, type Call, EXPLORER_TX_URL, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type OrderCancelledEvent, type OrderFilledEvent, type OrderSettledEvent, type OrdersBulkCancelledEvent, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type SignedOrder, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getBatchLendOfferTypedData, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, hashBatchEntries, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };

package/dist/index.js

@@ -22,7 +22,7 @@ var STATUS_LABELS = {
 
 // src/constants/addresses.ts
 var STELA_ADDRESS = {
-  sepolia: "0x0400ed08d0507b1f229c3283ecfc8567fb7240a7d0d99d5af9167993c51d062e",
+  sepolia: "0x012998e49cc8205d0bb56b5c10202bd32994091b1cacdb7bcbd03dc6781d4974",
   mainnet: "0x0"
 };
 var VALID_NETWORKS = ["sepolia", "mainnet"];
@@ -426,6 +426,17 @@ function parseEvents(rawEvents) {
   }
   return results;
 }
+var U256_TYPE_HASH = "0x3b143be38b811560b45593fb2a071ec4ddd0a020e10782be62ffe6f39e0e82c";
+function hashBatchEntries(entries) {
+  const elements = [String(entries.length)];
+  for (const entry of entries) {
+    elements.push(entry.orderHash);
+    const [low, high] = toU256(entry.bps);
+    const bpsHash = hash.computePoseidonHashOnElements([U256_TYPE_HASH, low, high]);
+    elements.push(bpsHash);
+  }
+  return hash.computePoseidonHashOnElements(elements);
+}
 function hashAssets(assets) {
   const elements = [String(assets.length)];
   for (const asset of assets) {
@@ -526,6 +537,35 @@ function getLendOfferTypedData(params) {
     }
   };
 }
+function getBatchLendOfferTypedData(params) {
+  return {
+    types: {
+      StarknetDomain: [
+        { name: "name", type: "shortstring" },
+        { name: "version", type: "shortstring" },
+        { name: "chainId", type: "shortstring" },
+        { name: "revision", type: "shortstring" }
+      ],
+      BatchLendOffer: [
+        { name: "batch_hash", type: "felt" },
+        { name: "count", type: "u128" },
+        { name: "lender", type: "ContractAddress" },
+        { name: "start_nonce", type: "felt" }
+      ]
+    },
+    primaryType: "BatchLendOffer",
+    domain: {
+      ...STELA_DOMAIN,
+      chainId: params.chainId
+    },
+    message: {
+      batch_hash: params.batchHash,
+      count: params.count.toString(),
+      lender: params.lender,
+      start_nonce: params.startNonce.toString()
+    }
+  };
+}
 
 // src/offchain/signature.ts
 function serializeSignature(sig) {
@@ -720,6 +760,28 @@ var stela_default = [
       }
     ]
   },
+  {
+    type: "struct",
+    name: "stela::snip12::BatchLendOffer",
+    members: [
+      {
+        name: "batch_hash",
+        type: "core::felt252"
+      },
+      {
+        name: "count",
+        type: "core::integer::u32"
+      },
+      {
+        name: "lender",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "start_nonce",
+        type: "core::felt252"
+      }
+    ]
+  },
   {
     type: "struct",
     name: "stela::types::signed_order::SignedOrder",
@@ -932,6 +994,46 @@ var stela_default = [
         outputs: [],
         state_mutability: "external"
       },
+      {
+        type: "function",
+        name: "batch_settle",
+        inputs: [
+          {
+            name: "orders",
+            type: "core::array::Array::<stela::snip12::InscriptionOrder>"
+          },
+          {
+            name: "debt_assets_flat",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          },
+          {
+            name: "interest_assets_flat",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          },
+          {
+            name: "collateral_assets_flat",
+            type: "core::array::Array::<stela::types::asset::Asset>"
+          },
+          {
+            name: "borrower_sigs",
+            type: "core::array::Array::<core::array::Array::<core::felt252>>"
+          },
+          {
+            name: "batch_offer",
+            type: "stela::snip12::BatchLendOffer"
+          },
+          {
+            name: "lender_sig",
+            type: "core::array::Array::<core::felt252>"
+          },
+          {
+            name: "bps_list",
+            type: "core::array::Array::<core::integer::u256>"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
       {
         type: "function",
         name: "fill_signed_order",
@@ -2449,6 +2551,44 @@ var InscriptionClient = class {
     ];
     return { contractAddress: this.address, entrypoint: "settle", calldata };
   }
+  buildBatchSettle(params) {
+    const calldata = [];
+    calldata.push(String(params.orders.length));
+    for (const order of params.orders) {
+      calldata.push(
+        order.borrower,
+        order.debtHash,
+        order.interestHash,
+        order.collateralHash,
+        String(order.debtCount),
+        String(order.interestCount),
+        String(order.collateralCount),
+        order.duration.toString(),
+        order.deadline.toString(),
+        order.multiLender ? "1" : "0",
+        order.nonce.toString()
+      );
+    }
+    calldata.push(...serializeAssets(params.debtAssetsFlat));
+    calldata.push(...serializeAssets(params.interestAssetsFlat));
+    calldata.push(...serializeAssets(params.collateralAssetsFlat));
+    calldata.push(String(params.borrowerSigs.length));
+    for (const sig of params.borrowerSigs) {
+      calldata.push(String(sig.length), ...sig);
+    }
+    calldata.push(
+      params.batchOffer.batchHash,
+      String(params.batchOffer.count),
+      params.batchOffer.lender,
+      params.batchOffer.startNonce.toString()
+    );
+    calldata.push(String(params.lenderSig.length), ...params.lenderSig);
+    calldata.push(String(params.bpsList.length));
+    for (const bps of params.bpsList) {
+      calldata.push(...toU256(bps));
+    }
+    return { contractAddress: this.address, entrypoint: "batch_settle", calldata };
+  }
   buildFillSignedOrder(order, signature, fillBps) {
     const calldata = [
       // SignedOrder struct fields
@@ -2896,6 +3036,6 @@ var StelaSdk = class {
   }
 };
 
-export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, ApiError, CHAIN_ID, EXPLORER_TX_URL, InscriptionClient, LockerClient, MAX_BPS, SELECTORS, STATUS_LABELS, STELA_ADDRESS, ShareClient, StelaSdk, TOKENS, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };
+export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, ApiError, CHAIN_ID, EXPLORER_TX_URL, InscriptionClient, LockerClient, MAX_BPS, SELECTORS, STATUS_LABELS, STELA_ADDRESS, ShareClient, StelaSdk, TOKENS, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getBatchLendOfferTypedData, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, hashBatchEntries, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map