@fepvenancio/stela-sdk 0.6.0 → 0.7.0

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: "0x038a0b195e011fbfd75e9bce9bbc4137ebc5296882e11c5769c333b90bda4f89",
   mainnet: "0x0"
 };
 var VALID_NETWORKS = ["sepolia", "mainnet"];
@@ -762,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",
@@ -974,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",
@@ -1070,17 +1132,6 @@ var stela_default = [
         ],
         state_mutability: "view"
       },
-      {
-        type: "function",
-        name: "get_inscription_fee",
-        inputs: [],
-        outputs: [
-          {
-            type: "core::integer::u256"
-          }
-        ],
-        state_mutability: "view"
-      },
       {
         type: "function",
         name: "nonces",
@@ -1097,17 +1148,6 @@ var stela_default = [
         ],
         state_mutability: "view"
       },
-      {
-        type: "function",
-        name: "get_relayer_fee",
-        inputs: [],
-        outputs: [
-          {
-            type: "core::integer::u256"
-          }
-        ],
-        state_mutability: "view"
-      },
       {
         type: "function",
         name: "get_treasury",
@@ -1223,15 +1263,19 @@ var stela_default = [
       },
       {
         type: "function",
-        name: "set_inscription_fee",
+        name: "is_volume_token_whitelisted",
         inputs: [
           {
-            name: "fee",
-            type: "core::integer::u256"
+            name: "token",
+            type: "core::starknet::contract_address::ContractAddress"
           }
         ],
-        outputs: [],
-        state_mutability: "external"
+        outputs: [
+          {
+            type: "core::bool"
+          }
+        ],
+        state_mutability: "view"
       },
       {
         type: "function",
@@ -1271,11 +1315,11 @@ var stela_default = [
       },
       {
         type: "function",
-        name: "set_relayer_fee",
+        name: "set_implementation_hash",
         inputs: [
           {
-            name: "fee",
-            type: "core::integer::u256"
+            name: "implementation_hash",
+            type: "core::felt252"
           }
         ],
         outputs: [],
@@ -1283,11 +1327,15 @@ var stela_default = [
       },
       {
         type: "function",
-        name: "set_implementation_hash",
+        name: "set_volume_token_whitelisted",
         inputs: [
           {
-            name: "implementation_hash",
-            type: "core::felt252"
+            name: "token",
+            type: "core::starknet::contract_address::ContractAddress"
+          },
+          {
+            name: "whitelisted",
+            type: "core::bool"
           }
         ],
         outputs: [],
@@ -1330,6 +1378,18 @@ var stela_default = [
         ],
         state_mutability: "view"
       },
+      {
+        type: "function",
+        name: "set_pauser",
+        inputs: [
+          {
+            name: "new_pauser",
+            type: "core::starknet::contract_address::ContractAddress"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
       {
         type: "function",
         name: "set_locker_allowed_selector",
@@ -1338,6 +1398,10 @@ var stela_default = [
             name: "locker",
             type: "core::starknet::contract_address::ContractAddress"
           },
+          {
+            name: "target",
+            type: "core::starknet::contract_address::ContractAddress"
+          },
           {
             name: "selector",
             type: "core::felt252"
@@ -2366,10 +2430,6 @@ var InscriptionClient = class {
     const result = await this.contract.call("get_locker", toU256(inscriptionId));
     return String(result[0]);
   }
-  async getInscriptionFee() {
-    const result = await this.contract.call("get_inscription_fee");
-    return extractU256(result);
-  }
   async convertToShares(inscriptionId, percentage) {
     const result = await this.contract.call("convert_to_shares", [
       ...toU256(inscriptionId),