@0xslots/sdk 0.6.0 → 0.8.0

package/dist/index.js

@@ -7,6 +7,7 @@ import { getSlotsHubAddress, slotAbi, slotFactoryAbi } from '@0xslots/contracts'
 var AccountFieldsFragmentDoc = gql`
     fragment AccountFields on Account {
   id
+  type
   slotCount
   occupiedCount
   slotsAsRecipient {
@@ -17,19 +18,30 @@ var AccountFieldsFragmentDoc = gql`
   }
 }
     `;
+var CurrencyFieldsFragmentDoc = gql`
+    fragment CurrencyFields on Currency {
+  id
+  name
+  symbol
+  decimals
+}
+    `;
 var SlotFieldsFragmentDoc = gql`
     fragment SlotFields on Slot {
   id
   recipient
   recipientAccount {
     id
+    type
     slotCount
     occupiedCount
   }
-  currency
-  currencyName
-  currencySymbol
-  currencyDecimals
+  currency {
+    id
+    name
+    symbol
+    decimals
+  }
   manager
   mutableTax
   mutableModule
@@ -43,6 +55,7 @@ var SlotFieldsFragmentDoc = gql`
   occupant
   occupantAccount {
     id
+    type
     slotCount
     occupiedCount
   }
@@ -85,6 +98,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     buyer
     previousOccupant
     price
@@ -98,6 +114,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     refund
     timestamp
@@ -108,6 +127,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     liquidator
     occupant
     bounty
@@ -119,6 +141,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     oldPrice
     newPrice
     timestamp
@@ -129,6 +154,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     depositor
     amount
     timestamp
@@ -139,6 +167,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     amount
     timestamp
@@ -149,6 +180,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     recipient
     amount
     timestamp
@@ -189,7 +223,7 @@ var GetRecentEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetBoughtEventsDocument = gql`
     query GetBoughtEvents($first: Int!, $skip: Int, $orderBy: BoughtEvent_orderBy, $orderDirection: OrderDirection, $where: BoughtEvent_filter, $block: Block_height) {
   boughtEvents(
@@ -204,6 +238,9 @@ var GetBoughtEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     buyer
     previousOccupant
     price
@@ -214,7 +251,7 @@ var GetBoughtEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetReleasedEventsDocument = gql`
     query GetReleasedEvents($first: Int!, $skip: Int, $orderBy: ReleasedEvent_orderBy, $orderDirection: OrderDirection, $where: ReleasedEvent_filter, $block: Block_height) {
   releasedEvents(
@@ -229,6 +266,9 @@ var GetReleasedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     refund
     timestamp
@@ -236,7 +276,7 @@ var GetReleasedEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetLiquidatedEventsDocument = gql`
     query GetLiquidatedEvents($first: Int!, $skip: Int, $orderBy: LiquidatedEvent_orderBy, $orderDirection: OrderDirection, $where: LiquidatedEvent_filter, $block: Block_height) {
   liquidatedEvents(
@@ -251,6 +291,9 @@ var GetLiquidatedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     liquidator
     occupant
     bounty
@@ -259,7 +302,7 @@ var GetLiquidatedEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetSettledEventsDocument = gql`
     query GetSettledEvents($first: Int!, $skip: Int, $orderBy: SettledEvent_orderBy, $orderDirection: OrderDirection, $where: SettledEvent_filter, $block: Block_height) {
   settledEvents(
@@ -274,6 +317,9 @@ var GetSettledEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     taxOwed
     taxPaid
     depositRemaining
@@ -282,7 +328,7 @@ var GetSettledEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetTaxCollectedEventsDocument = gql`
     query GetTaxCollectedEvents($first: Int!, $skip: Int, $orderBy: TaxCollectedEvent_orderBy, $orderDirection: OrderDirection, $where: TaxCollectedEvent_filter, $block: Block_height) {
   taxCollectedEvents(
@@ -297,6 +343,9 @@ var GetTaxCollectedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     recipient
     amount
     timestamp
@@ -304,7 +353,7 @@ var GetTaxCollectedEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetDepositedEventsDocument = gql`
     query GetDepositedEvents($first: Int!, $skip: Int, $orderBy: DepositedEvent_orderBy, $orderDirection: OrderDirection, $where: DepositedEvent_filter, $block: Block_height) {
   depositedEvents(
@@ -319,6 +368,9 @@ var GetDepositedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     depositor
     amount
     timestamp
@@ -326,7 +378,7 @@ var GetDepositedEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetWithdrawnEventsDocument = gql`
     query GetWithdrawnEvents($first: Int!, $skip: Int, $orderBy: WithdrawnEvent_orderBy, $orderDirection: OrderDirection, $where: WithdrawnEvent_filter, $block: Block_height) {
   withdrawnEvents(
@@ -341,6 +393,9 @@ var GetWithdrawnEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     amount
     timestamp
@@ -348,7 +403,7 @@ var GetWithdrawnEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetPriceUpdatedEventsDocument = gql`
     query GetPriceUpdatedEvents($first: Int!, $skip: Int, $orderBy: PriceUpdatedEvent_orderBy, $orderDirection: OrderDirection, $where: PriceUpdatedEvent_filter, $block: Block_height) {
   priceUpdatedEvents(
@@ -363,6 +418,9 @@ var GetPriceUpdatedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     oldPrice
     newPrice
     timestamp
@@ -370,7 +428,7 @@ var GetPriceUpdatedEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetSlotActivityDocument = gql`
     query GetSlotActivity($slotId: String!, $first: Int!) {
   boughtEvents(
@@ -380,6 +438,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     buyer
     previousOccupant
     price
@@ -395,6 +456,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     occupant
     refund
     timestamp
@@ -407,6 +471,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     liquidator
     occupant
     bounty
@@ -420,6 +487,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     oldPrice
     newPrice
     timestamp
@@ -432,6 +502,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     depositor
     amount
     timestamp
@@ -444,6 +517,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     occupant
     amount
     timestamp
@@ -456,6 +532,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     recipient
     amount
     timestamp
@@ -494,7 +573,7 @@ var GetSlotActivityDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetFactoryDocument = gql`
     query GetFactory {
   factories(first: 1) {
@@ -621,6 +700,19 @@ function getSdk(client, withWrapper = defaultWrapper) {
     }
   };
 }
+
+// src/errors.ts
+var SlotsError = class extends Error {
+  constructor(operation, cause) {
+    const msg = cause instanceof Error ? cause.message : String(cause);
+    super(`${operation}: ${msg}`);
+    this.operation = operation;
+    this.name = "SlotsError";
+    this.cause = cause;
+  }
+};
+
+// src/client.ts
 var META_QUERY = gql$1`
   query GetMeta {
     _meta {
@@ -654,12 +746,15 @@ var SlotsClient = class {
     this.sdk = getSdk(this.gqlClient);
   }
   // ─── Accessors ──────────────────────────────────────────────────────────────
+  /** Returns the chain ID this client was configured for. */
   getChainId() {
     return this.chainId;
   }
+  /** Returns the underlying GraphQL client (for advanced usage). */
   getClient() {
     return this.gqlClient;
   }
+  /** Returns the generated GraphQL SDK (for queries not wrapped by this client). */
   getSdk() {
     return this.sdk;
   }
@@ -680,111 +775,171 @@ var SlotsClient = class {
     if (!account) throw new Error("WalletClient must have an account");
     return account.address;
   }
+  get chain() {
+    const chain = this.wallet.chain;
+    if (!chain) throw new Error("WalletClient must have a chain");
+    return chain;
+  }
+  // ─── Helpers ────────────────────────────────────────────────────────────────
+  assertPositive(value, name) {
+    if (value <= 0n) throw new SlotsError(name, `${name} must be > 0`);
+  }
+  async query(operation, fn) {
+    try {
+      return await fn();
+    } catch (error) {
+      throw new SlotsError(operation, error);
+    }
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // READ — Subgraph Queries
   // ═══════════════════════════════════════════════════════════════════════════
   // Slot queries
+  /** Fetch a paginated list of slots. */
   getSlots(...args) {
-    return this.sdk.GetSlots(...args);
+    return this.query("getSlots", () => this.sdk.GetSlots(...args));
   }
+  /** Fetch a single slot by its address. */
   getSlot(...args) {
-    return this.sdk.GetSlot(...args);
+    return this.query("getSlot", () => this.sdk.GetSlot(...args));
   }
+  /** Fetch all slots owned by a given recipient address. */
   getSlotsByRecipient(...args) {
-    return this.sdk.GetSlotsByRecipient(...args);
+    return this.query("getSlotsByRecipient", () => this.sdk.GetSlotsByRecipient(...args));
   }
+  /** Fetch all slots currently occupied by a given address. */
   getSlotsByOccupant(...args) {
-    return this.sdk.GetSlotsByOccupant(...args);
+    return this.query("getSlotsByOccupant", () => this.sdk.GetSlotsByOccupant(...args));
   }
   // Factory queries
+  /** Fetch factory configuration. */
   getFactory() {
-    return this.sdk.GetFactory();
+    return this.query("getFactory", () => this.sdk.GetFactory());
   }
+  /** Fetch registered modules. */
   getModules(...args) {
-    return this.sdk.GetModules(...args);
+    return this.query("getModules", () => this.sdk.GetModules(...args));
   }
   // Event queries
+  /** Fetch bought events with optional filters. */
   getBoughtEvents(...args) {
-    return this.sdk.GetBoughtEvents(...args);
+    return this.query("getBoughtEvents", () => this.sdk.GetBoughtEvents(...args));
   }
+  /** Fetch settled events with optional filters. */
   getSettledEvents(...args) {
-    return this.sdk.GetSettledEvents(...args);
+    return this.query("getSettledEvents", () => this.sdk.GetSettledEvents(...args));
   }
+  /** Fetch tax-collected events with optional filters. */
   getTaxCollectedEvents(...args) {
-    return this.sdk.GetTaxCollectedEvents(...args);
+    return this.query("getTaxCollectedEvents", () => this.sdk.GetTaxCollectedEvents(...args));
   }
+  /** Fetch all activity for a specific slot (all event types). */
   getSlotActivity(...args) {
-    return this.sdk.GetSlotActivity(...args);
+    return this.query("getSlotActivity", () => this.sdk.GetSlotActivity(...args));
   }
+  /** Fetch the most recent events across all slots. */
   getRecentEvents(...args) {
-    return this.sdk.GetRecentEvents(...args);
+    return this.query("getRecentEvents", () => this.sdk.GetRecentEvents(...args));
   }
   // Account queries
+  /** Fetch a single account by address. */
   getAccount(...args) {
-    return this.sdk.GetAccount(...args);
+    return this.query("getAccount", () => this.sdk.GetAccount(...args));
   }
+  /** Fetch a paginated list of accounts. */
   getAccounts(...args) {
-    return this.sdk.GetAccounts(...args);
+    return this.query("getAccounts", () => this.sdk.GetAccounts(...args));
   }
   // Individual event queries
+  /** Fetch released events with optional filters. */
   getReleasedEvents(...args) {
-    return this.sdk.GetReleasedEvents(...args);
+    return this.query("getReleasedEvents", () => this.sdk.GetReleasedEvents(...args));
   }
+  /** Fetch liquidated events with optional filters. */
   getLiquidatedEvents(...args) {
-    return this.sdk.GetLiquidatedEvents(...args);
+    return this.query("getLiquidatedEvents", () => this.sdk.GetLiquidatedEvents(...args));
   }
+  /** Fetch deposited events with optional filters. */
   getDepositedEvents(...args) {
-    return this.sdk.GetDepositedEvents(...args);
+    return this.query("getDepositedEvents", () => this.sdk.GetDepositedEvents(...args));
   }
+  /** Fetch withdrawn events with optional filters. */
   getWithdrawnEvents(...args) {
-    return this.sdk.GetWithdrawnEvents(...args);
+    return this.query("getWithdrawnEvents", () => this.sdk.GetWithdrawnEvents(...args));
   }
+  /** Fetch price-updated events with optional filters. */
   getPriceUpdatedEvents(...args) {
-    return this.sdk.GetPriceUpdatedEvents(...args);
+    return this.query("getPriceUpdatedEvents", () => this.sdk.GetPriceUpdatedEvents(...args));
   }
   // Meta
+  /** Fetch subgraph indexing metadata (latest block, indexing errors). */
   getMeta() {
-    return this.gqlClient.request(META_QUERY);
+    return this.query("getMeta", () => this.gqlClient.request(META_QUERY));
   }
   // ═══════════════════════════════════════════════════════════════════════════
   // READ — On-chain (RPC)
   // ═══════════════════════════════════════════════════════════════════════════
-  /** Read full slot info from on-chain (RPC, not subgraph). */
-  async getSlotInfo(slot) {
-    return this.publicClient.readContract({
-      address: slot,
-      abi: slotAbi,
-      functionName: "getSlotInfo"
-    });
+  /**
+   * Read full slot info from on-chain (RPC, not subgraph).
+   * @param slot - Slot contract address.
+   * @returns On-chain slot info tuple.
+   * @throws {SlotsError} If the RPC call fails.
+   */
+  getSlotInfo(slot) {
+    return this.query(
+      "getSlotInfo",
+      () => this.publicClient.readContract({
+        address: slot,
+        abi: slotAbi,
+        functionName: "getSlotInfo"
+      })
+    );
   }
   // ═══════════════════════════════════════════════════════════════════════════
   // WRITE — Factory Functions
   // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * Deploy a new slot via the factory contract.
+   * @param params - Slot creation parameters (recipient, currency, config, initParams).
+   * @returns Transaction hash.
+   */
   async createSlot(params) {
     return this.wallet.writeContract({
       address: this.factory,
       abi: slotFactoryAbi,
       functionName: "createSlot",
       args: [params.recipient, params.currency, params.config, params.initParams],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
+  /**
+   * Deploy multiple identical slots in a single transaction via the factory contract.
+   * @param params - Slot creation parameters including count.
+   * @returns Transaction hash.
+   */
   async createSlots(params) {
     return this.wallet.writeContract({
       address: this.factory,
       abi: slotFactoryAbi,
       functionName: "createSlots",
       args: [params.recipient, params.currency, params.config, params.initParams, params.count],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
   // ═══════════════════════════════════════════════════════════════════════════
   // WRITE — Slot Functions
   // ═══════════════════════════════════════════════════════════════════════════
-  /** Buy a slot (or force buy an occupied one). Handles ERC-20 approval automatically. */
+  /**
+   * Buy a slot (or force-buy an occupied one). Handles ERC-20 approval automatically.
+   * @param params - Buy parameters (slot address, deposit amount, self-assessed price).
+   * @returns Transaction hash.
+   * @throws {SlotsError} If depositAmount or selfAssessedPrice is not positive, or the transaction fails.
+   */
   async buy(params) {
+    this.assertPositive(params.depositAmount, "depositAmount");
+    this.assertPositive(params.selfAssessedPrice, "selfAssessedPrice");
     return this.withAllowance(params.slot, params.depositAmount, {
       to: params.slot,
       abi: slotAbi,
@@ -792,19 +947,31 @@ var SlotsClient = class {
       args: [params.depositAmount, params.selfAssessedPrice]
     });
   }
-  /** Self-assess a new price for an occupied slot (occupant only). */
+  /**
+   * Self-assess a new price for an occupied slot (occupant only).
+   * @param slot - The slot contract address.
+   * @param newPrice - The new self-assessed price (can be 0).
+   * @returns Transaction hash.
+   */
   async selfAssess(slot, newPrice) {
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "selfAssess",
       args: [newPrice],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
-  /** Top up deposit on a slot (occupant only). Handles ERC-20 approval automatically. */
+  /**
+   * Top up deposit on a slot (occupant only). Handles ERC-20 approval automatically.
+   * @param slot - The slot contract address.
+   * @param amount - The amount to deposit (must be > 0).
+   * @returns Transaction hash.
+   * @throws {SlotsError} If amount is not positive, or the transaction fails.
+   */
   async topUp(slot, amount) {
+    this.assertPositive(amount, "amount");
     return this.withAllowance(slot, amount, {
       to: slot,
       abi: slotAbi,
@@ -812,98 +979,145 @@ var SlotsClient = class {
       args: [amount]
     });
   }
-  /** Withdraw from deposit (occupant only). Cannot go below minimum deposit. */
+  /**
+   * Withdraw from deposit (occupant only). Cannot go below minimum deposit.
+   * @param slot - The slot contract address.
+   * @param amount - The amount to withdraw (must be > 0).
+   * @returns Transaction hash.
+   * @throws {SlotsError} If amount is not positive, or the transaction fails.
+   */
   async withdraw(slot, amount) {
+    this.assertPositive(amount, "amount");
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "withdraw",
       args: [amount],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
-  /** Release a slot (occupant only). Returns remaining deposit. */
+  /**
+   * Release a slot (occupant only). Returns remaining deposit to the occupant.
+   * @param slot - The slot contract address.
+   * @returns Transaction hash.
+   */
   async release(slot) {
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "release",
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
-  /** Collect accumulated tax (permissionless). */
+  /**
+   * Collect accumulated tax (permissionless).
+   * @param slot - The slot contract address.
+   * @returns Transaction hash.
+   */
   async collect(slot) {
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "collect",
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
-  /** Liquidate an insolvent slot (permissionless). Caller receives bounty. */
+  /**
+   * Liquidate an insolvent slot (permissionless). Caller receives bounty.
+   * @param slot - The slot contract address.
+   * @returns Transaction hash.
+   */
   async liquidate(slot) {
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "liquidate",
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
   // ═══════════════════════════════════════════════════════════════════════════
   // WRITE — Manager Functions
   // ═══════════════════════════════════════════════════════════════════════════
-  /** Propose a tax rate update (manager only, slot must have mutableTax). */
+  /**
+   * Propose a tax rate update (manager only, slot must have mutableTax).
+   * @param slot - The slot contract address.
+   * @param newPct - The new tax percentage.
+   * @returns Transaction hash.
+   */
   async proposeTaxUpdate(slot, newPct) {
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "proposeTaxUpdate",
       args: [newPct],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
-  /** Propose a module update (manager only, slot must have mutableModule). */
+  /**
+   * Propose a module update (manager only, slot must have mutableModule).
+   * @param slot - The slot contract address.
+   * @param newModule - The new module contract address.
+   * @returns Transaction hash.
+   */
   async proposeModuleUpdate(slot, newModule) {
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "proposeModuleUpdate",
       args: [newModule],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
-  /** Cancel pending updates (manager only). */
+  /**
+   * Cancel pending updates (manager only).
+   * @param slot - The slot contract address.
+   * @returns Transaction hash.
+   */
   async cancelPendingUpdates(slot) {
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "cancelPendingUpdates",
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
-  /** Set liquidation bounty bps (manager only). */
+  /**
+   * Set liquidation bounty bps (manager only).
+   * @param slot - The slot contract address.
+   * @param newBps - The new bounty in basis points (0-10000).
+   * @returns Transaction hash.
+   * @throws {SlotsError} If newBps is outside 0-10000, or the transaction fails.
+   */
   async setLiquidationBounty(slot, newBps) {
+    if (newBps < 0n || newBps > 10000n) throw new SlotsError("setLiquidationBounty", "newBps must be 0-10000");
     return this.wallet.writeContract({
       address: slot,
       abi: slotAbi,
       functionName: "setLiquidationBounty",
       args: [newBps],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
   // ═══════════════════════════════════════════════════════════════════════════
   // WRITE — Multicall
   // ═══════════════════════════════════════════════════════════════════════════
-  /** Batch multiple slot calls into one transaction via multicall. */
+  /**
+   * Batch multiple slot calls into one transaction via multicall.
+   * @param slot - The slot contract address.
+   * @param calls - Array of function calls to batch.
+   * @returns Transaction hash.
+   * @throws {SlotsError} If calls array is empty, or the transaction fails.
+   */
   async multicall(slot, calls) {
+    if (calls.length === 0) throw new SlotsError("multicall", "calls array must not be empty");
     const data = calls.map(
       (call) => encodeFunctionData({
         abi: slotAbi,
@@ -916,8 +1130,8 @@ var SlotsClient = class {
       abi: slotAbi,
       functionName: "multicall",
       args: [data],
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
   // ─── Internals ──────────────────────────────────────────────────────────────
@@ -930,7 +1144,7 @@ var SlotsClient = class {
         this._atomicSupport = false;
         return false;
       }
-      const chainId = this.wallet.chain.id;
+      const chainId = this.chain.id;
       const chainCaps = capabilities[chainId] || capabilities[`0x${chainId.toString(16)}`];
       const atomic = chainCaps?.atomicBatch ?? chainCaps?.atomic;
       const status = atomic && typeof atomic === "object" && "status" in atomic ? atomic.status : void 0;
@@ -987,8 +1201,8 @@ var SlotsClient = class {
         args: call.args
       });
       const id = await this.wallet.sendCalls({
-        account: this.wallet.account,
-        chain: this.wallet.chain,
+        account: this.account,
+        chain: this.chain,
         calls: [
           { to: currency, data: approveData },
           { to: call.to, data: actionData }
@@ -1003,8 +1217,8 @@ var SlotsClient = class {
         abi: erc20Abi,
         functionName: "approve",
         args: [spender, amount],
-        account: this.wallet.account,
-        chain: this.wallet.chain
+        account: this.account,
+        chain: this.chain
       });
       await this.publicClient.waitForTransactionReceipt({ hash });
     }
@@ -1013,8 +1227,8 @@ var SlotsClient = class {
       abi: call.abi,
       functionName: call.functionName,
       args: call.args,
-      account: this.wallet.account,
-      chain: this.wallet.chain
+      account: this.account,
+      chain: this.chain
     });
   }
 };
@@ -1022,6 +1236,6 @@ function createSlotsClient(config) {
   return new SlotsClient(config);
 }
 
-export { AccountFieldsFragmentDoc, GetAccountDocument, GetAccountsDocument, GetBoughtEventsDocument, GetDepositedEventsDocument, GetFactoryDocument, GetLiquidatedEventsDocument, GetModulesDocument, GetPriceUpdatedEventsDocument, GetRecentEventsDocument, GetReleasedEventsDocument, GetSettledEventsDocument, GetSlotActivityDocument, GetSlotDocument, GetSlotsByOccupantDocument, GetSlotsByRecipientDocument, GetSlotsDocument, GetTaxCollectedEventsDocument, GetWithdrawnEventsDocument, SUBGRAPH_URLS, SlotFieldsFragmentDoc, SlotsChain, SlotsClient, createSlotsClient, getSdk };
+export { AccountFieldsFragmentDoc, CurrencyFieldsFragmentDoc, GetAccountDocument, GetAccountsDocument, GetBoughtEventsDocument, GetDepositedEventsDocument, GetFactoryDocument, GetLiquidatedEventsDocument, GetModulesDocument, GetPriceUpdatedEventsDocument, GetRecentEventsDocument, GetReleasedEventsDocument, GetSettledEventsDocument, GetSlotActivityDocument, GetSlotDocument, GetSlotsByOccupantDocument, GetSlotsByRecipientDocument, GetSlotsDocument, GetTaxCollectedEventsDocument, GetWithdrawnEventsDocument, SUBGRAPH_URLS, SlotFieldsFragmentDoc, SlotsChain, SlotsClient, SlotsError, createSlotsClient, getSdk };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map