@fepvenancio/stela-sdk 0.5.4 → 0.6.1

package/README.md

@@ -118,6 +118,7 @@ Return a `Call` object for use with `account.execute()`. Bundle multiple calls (
 | `buildLiquidate(id)` | Liquidate an expired inscription |
 | `buildRedeem(id, shares)` | Redeem shares for underlying assets |
 | `buildSettle(params)` | Settle an off-chain order (used by relayer bots) |
+| `buildBatchSettle(params)` | Settle multiple off-chain orders atomically with 1 lender signature (BatchLendOffer) |
 | `buildFillSignedOrder(order, sig, fillBps)` | Fill a signed order on-chain |
 | `buildCancelOrder(order)` | Cancel a specific signed order |
 | `buildCancelOrdersByNonce(minNonce)` | Bulk cancel orders below a nonce |
@@ -197,7 +198,9 @@ Functions for creating SNIP-12 typed data for gasless order creation and settlem
 import {
   getInscriptionOrderTypedData,
   getLendOfferTypedData,
+  getBatchLendOfferTypedData,
   hashAssets,
+  hashBatchEntries,
   serializeSignature,
   deserializeSignature,
 } from '@fepvenancio/stela-sdk'
@@ -207,7 +210,9 @@ import {
 |----------|-------------|
 | `getInscriptionOrderTypedData(params)` | Build SNIP-12 typed data for a borrower's InscriptionOrder |
 | `getLendOfferTypedData(params)` | Build SNIP-12 typed data for a lender's LendOffer |
+| `getBatchLendOfferTypedData(params)` | Build SNIP-12 typed data for a lender's BatchLendOffer (multi-order settlement) |
 | `hashAssets(assets)` | Poseidon hash of an asset array (matches Cairo's `hash_assets()`) |
+| `hashBatchEntries(entries)` | Poseidon hash of BatchEntry array for batch_settle() |
 | `serializeSignature(sig)` | Convert `string[]` signature to `{ r, s }` for storage |
 | `deserializeSignature(stored)` | Convert `{ r, s }` back to `string[]` |
 
@@ -313,6 +318,7 @@ All exported types from the SDK:
 | `StoredInscription` | Raw on-chain inscription data |
 | `Inscription` | Parsed inscription with computed status |
 | `SignedOrder` | Signed order for the matching engine |
+| `BatchEntry` | Entry in a batch settle (order hash + fill BPS) |
 | `InscriptionRow` | API response row for inscriptions |
 | `AssetRow` | API response row for assets |
 | `ApiListResponse<T>` | Paginated list response envelope |
@@ -397,7 +403,7 @@ npm publish --access public
 
 ## Running a Relayer
 
-The Stela protocol is fully permissionless — anyone can run a relayer to settle matched orders and earn **5 BPS** on every settlement. See [RELAYER.md](RELAYER.md) for the SDK integration guide and the [stela-relayer](https://github.com/fepvenancio/stela-relayer) repo for a standalone implementation.
+The Stela protocol is fully permissionless — anyone can run a relayer to settle matched orders and earn **0.05%** on every settlement. See [RELAYER.md](RELAYER.md) for the SDK integration guide and the [stela-relayer](https://github.com/fepvenancio/stela-relayer) repo for a standalone implementation.
 
 ## License
 

package/dist/index.cjs

@@ -24,7 +24,7 @@ var STATUS_LABELS = {
 
 // src/constants/addresses.ts
 var STELA_ADDRESS = {
-  sepolia: "0x0400ed08d0507b1f229c3283ecfc8567fb7240a7d0d99d5af9167993c51d062e",
+  sepolia: "0x012998e49cc8205d0bb56b5c10202bd32994091b1cacdb7bcbd03dc6781d4974",
   mainnet: "0x0"
 };
 var VALID_NETWORKS = ["sepolia", "mainnet"];
@@ -428,6 +428,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 = starknet.hash.computePoseidonHashOnElements([U256_TYPE_HASH, low, high]);
+    elements.push(bpsHash);
+  }
+  return starknet.hash.computePoseidonHashOnElements(elements);
+}
 function hashAssets(assets) {
   const elements = [String(assets.length)];
   for (const asset of assets) {
@@ -528,6 +539,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) {
@@ -722,6 +762,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",
@@ -934,6 +996,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",
@@ -2451,6 +2553,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
@@ -2926,10 +3066,12 @@ exports.formatDuration = formatDuration;
 exports.formatTimestamp = formatTimestamp;
 exports.formatTokenValue = formatTokenValue;
 exports.fromU256 = fromU256;
+exports.getBatchLendOfferTypedData = getBatchLendOfferTypedData;
 exports.getInscriptionOrderTypedData = getInscriptionOrderTypedData;
 exports.getLendOfferTypedData = getLendOfferTypedData;
 exports.getTokensForNetwork = getTokensForNetwork;
 exports.hashAssets = hashAssets;
+exports.hashBatchEntries = hashBatchEntries;
 exports.inscriptionIdToHex = inscriptionIdToHex;
 exports.normalizeAddress = normalizeAddress;
 exports.parseAmount = parseAmount;