@0xslots/sdk 0.5.0 → 0.7.0

package/dist/index.js

@@ -1,10 +1,13 @@
 import { gql as gql$1, GraphQLClient } from 'graphql-request';
 import gql from 'graphql-tag';
+import { encodeFunctionData, erc20Abi } from 'viem';
+import { getSlotsHubAddress, slotAbi, slotFactoryAbi } from '@0xslots/contracts';
 
 // src/client.ts
 var AccountFieldsFragmentDoc = gql`
     fragment AccountFields on Account {
   id
+  type
   slotCount
   occupiedCount
   slotsAsRecipient {
@@ -15,6 +18,14 @@ var AccountFieldsFragmentDoc = gql`
   }
 }
     `;
+var CurrencyFieldsFragmentDoc = gql`
+    fragment CurrencyFields on Currency {
+  id
+  name
+  symbol
+  decimals
+}
+    `;
 var SlotFieldsFragmentDoc = gql`
     fragment SlotFields on Slot {
   id
@@ -24,15 +35,22 @@ var SlotFieldsFragmentDoc = gql`
     slotCount
     occupiedCount
   }
-  currency
-  currencyName
-  currencySymbol
-  currencyDecimals
+  currency {
+    id
+    name
+    symbol
+    decimals
+  }
   manager
   mutableTax
   mutableModule
   taxPercentage
-  module
+  module {
+    id
+    verified
+    name
+    version
+  }
   occupant
   occupantAccount {
     id
@@ -78,6 +96,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     buyer
     previousOccupant
     price
@@ -91,6 +112,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     refund
     timestamp
@@ -101,6 +125,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     liquidator
     occupant
     bounty
@@ -112,6 +139,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     oldPrice
     newPrice
     timestamp
@@ -122,6 +152,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     depositor
     amount
     timestamp
@@ -132,6 +165,9 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     amount
     timestamp
@@ -142,13 +178,50 @@ var GetRecentEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     recipient
     amount
     timestamp
     tx
   }
+  taxUpdateProposedEvents(first: $first, orderBy: timestamp, orderDirection: desc) {
+    id
+    slot {
+      id
+    }
+    newPercentage
+    timestamp
+    tx
+  }
+  moduleUpdateProposedEvents(
+    first: $first
+    orderBy: timestamp
+    orderDirection: desc
+  ) {
+    id
+    slot {
+      id
+    }
+    newModule
+    timestamp
+    tx
+  }
+  pendingUpdateCancelledEvents(
+    first: $first
+    orderBy: timestamp
+    orderDirection: desc
+  ) {
+    id
+    slot {
+      id
+    }
+    timestamp
+    tx
+  }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetBoughtEventsDocument = gql`
     query GetBoughtEvents($first: Int!, $skip: Int, $orderBy: BoughtEvent_orderBy, $orderDirection: OrderDirection, $where: BoughtEvent_filter, $block: Block_height) {
   boughtEvents(
@@ -163,6 +236,9 @@ var GetBoughtEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     buyer
     previousOccupant
     price
@@ -173,7 +249,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(
@@ -188,6 +264,9 @@ var GetReleasedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     refund
     timestamp
@@ -195,7 +274,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(
@@ -210,6 +289,9 @@ var GetLiquidatedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     liquidator
     occupant
     bounty
@@ -218,7 +300,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(
@@ -233,6 +315,9 @@ var GetSettledEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     taxOwed
     taxPaid
     depositRemaining
@@ -241,7 +326,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(
@@ -256,6 +341,9 @@ var GetTaxCollectedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     recipient
     amount
     timestamp
@@ -263,7 +351,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(
@@ -278,6 +366,9 @@ var GetDepositedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     depositor
     amount
     timestamp
@@ -285,7 +376,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(
@@ -300,6 +391,9 @@ var GetWithdrawnEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     occupant
     amount
     timestamp
@@ -307,7 +401,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(
@@ -322,6 +416,9 @@ var GetPriceUpdatedEventsDocument = gql`
     slot {
       id
     }
+    currency {
+      ...CurrencyFields
+    }
     oldPrice
     newPrice
     timestamp
@@ -329,7 +426,7 @@ var GetPriceUpdatedEventsDocument = gql`
     tx
   }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetSlotActivityDocument = gql`
     query GetSlotActivity($slotId: String!, $first: Int!) {
   boughtEvents(
@@ -339,6 +436,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     buyer
     previousOccupant
     price
@@ -354,6 +454,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     occupant
     refund
     timestamp
@@ -366,6 +469,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     liquidator
     occupant
     bounty
@@ -379,6 +485,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     oldPrice
     newPrice
     timestamp
@@ -391,6 +500,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     depositor
     amount
     timestamp
@@ -403,6 +515,9 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     occupant
     amount
     timestamp
@@ -415,13 +530,48 @@ var GetSlotActivityDocument = gql`
     where: {slot: $slotId}
   ) {
     id
+    currency {
+      ...CurrencyFields
+    }
     recipient
     amount
     timestamp
     tx
   }
+  taxUpdateProposedEvents(
+    first: $first
+    orderBy: timestamp
+    orderDirection: desc
+    where: {slot: $slotId}
+  ) {
+    id
+    newPercentage
+    timestamp
+    tx
+  }
+  moduleUpdateProposedEvents(
+    first: $first
+    orderBy: timestamp
+    orderDirection: desc
+    where: {slot: $slotId}
+  ) {
+    id
+    newModule
+    timestamp
+    tx
+  }
+  pendingUpdateCancelledEvents(
+    first: $first
+    orderBy: timestamp
+    orderDirection: desc
+    where: {slot: $slotId}
+  ) {
+    id
+    timestamp
+    tx
+  }
 }
-    `;
+    ${CurrencyFieldsFragmentDoc}`;
 var GetFactoryDocument = gql`
     query GetFactory {
   factories(first: 1) {
@@ -549,6 +699,17 @@ 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 {
@@ -568,94 +729,511 @@ var SlotsChain = /* @__PURE__ */ ((SlotsChain2) => {
   return SlotsChain2;
 })(SlotsChain || {});
 var SUBGRAPH_URLS = {
-  [84532 /* BASE_SEPOLIA */]: "https://api.studio.thegraph.com/query/958/0-x-slots-base-sepolia/v3.5.0",
+  [84532 /* BASE_SEPOLIA */]: "https://api.studio.thegraph.com/query/958/0-x-slots-base-sepolia/version/latest",
   [42161 /* ARBITRUM */]: "https://api.studio.thegraph.com/query/958/0-x-slots-arb/version/latest"
 };
 var SlotsClient = class {
   constructor(config) {
     this.chainId = config.chainId;
+    this._publicClient = config.publicClient;
+    this.walletClient = config.walletClient;
+    this._factory = config.factoryAddress ?? getSlotsHubAddress(config.chainId);
     const url = config.subgraphUrl || SUBGRAPH_URLS[config.chainId];
     if (!url) throw new Error(`No subgraph URL for chain ${config.chainId}`);
-    this.client = new GraphQLClient(url, { headers: config.headers });
-    this.sdk = getSdk(this.client);
+    this.gqlClient = new GraphQLClient(url, { headers: config.headers });
+    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.client;
+    return this.gqlClient;
   }
+  /** Returns the generated GraphQL SDK (for queries not wrapped by this client). */
   getSdk() {
     return this.sdk;
   }
+  get publicClient() {
+    if (!this._publicClient) throw new Error("No publicClient provided");
+    return this._publicClient;
+  }
+  get factory() {
+    if (!this._factory) throw new Error("No factoryAddress provided");
+    return this._factory;
+  }
+  get wallet() {
+    if (!this.walletClient) throw new Error("No walletClient provided");
+    return this.walletClient;
+  }
+  get account() {
+    const account = this.wallet.account;
+    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 (full params)
+  // 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.client.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).
+   * @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.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.account,
+      chain: this.chain
+    });
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // WRITE — Slot Functions
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * 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,
+      functionName: "buy",
+      args: [params.depositAmount, params.selfAssessedPrice]
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  /**
+   * 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,
+      functionName: "topUp",
+      args: [amount]
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // WRITE — Manager Functions
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  /**
+   * 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.account,
+      chain: this.chain
+    });
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // WRITE — 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,
+        functionName: call.functionName,
+        args: call.args
+      })
+    );
+    return this.wallet.writeContract({
+      address: slot,
+      abi: slotAbi,
+      functionName: "multicall",
+      args: [data],
+      account: this.account,
+      chain: this.chain
+    });
+  }
+  // ─── Internals ──────────────────────────────────────────────────────────────
+  /** Check if wallet supports atomic batch calls (EIP-5792). */
+  async supportsAtomicBatch() {
+    if (this._atomicSupport !== void 0) return this._atomicSupport;
+    try {
+      const capabilities = await this.wallet.getCapabilities?.();
+      if (!capabilities) {
+        this._atomicSupport = false;
+        return false;
+      }
+      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;
+      this._atomicSupport = status === "supported" || status === "ready";
+    } catch {
+      this._atomicSupport = false;
+    }
+    return this._atomicSupport;
+  }
+  /** Poll EIP-5792 getCallsStatus until the batch settles, then return a tx hash. */
+  async pollBatchReceipt(id) {
+    const MAX_ATTEMPTS = 60;
+    const INTERVAL = 1500;
+    for (let i = 0; i < MAX_ATTEMPTS; i++) {
+      const result = await this.wallet.getCallsStatus({ id });
+      if (result.status === "success") {
+        const receipts = result.receipts ?? [];
+        return receipts[receipts.length - 1]?.transactionHash ?? id;
+      }
+      if (result.status === "failure") {
+        throw new Error("Batch transaction reverted");
+      }
+      await new Promise((r) => setTimeout(r, INTERVAL));
+    }
+    throw new Error("Batch transaction timed out");
+  }
+  /**
+   * Execute a contract call that needs ERC-20 allowance.
+   * If wallet supports atomic batch (EIP-5792): sends approve + action as one atomic call.
+   * Otherwise: chains approve tx (if needed) then action tx.
+   */
+  async withAllowance(spender, amount, call) {
+    const currency = await this.publicClient.readContract({
+      address: spender,
+      abi: slotAbi,
+      functionName: "currency"
+    });
+    const allowance = await this.publicClient.readContract({
+      address: currency,
+      abi: erc20Abi,
+      functionName: "allowance",
+      args: [this.account, spender]
+    });
+    const needsApproval = allowance < amount;
+    if (needsApproval && await this.supportsAtomicBatch()) {
+      const approveData = encodeFunctionData({
+        abi: erc20Abi,
+        functionName: "approve",
+        args: [spender, amount]
+      });
+      const actionData = encodeFunctionData({
+        abi: call.abi,
+        functionName: call.functionName,
+        args: call.args
+      });
+      const id = await this.wallet.sendCalls({
+        account: this.account,
+        chain: this.chain,
+        calls: [
+          { to: currency, data: approveData },
+          { to: call.to, data: actionData }
+        ]
+      });
+      const txHash = await this.pollBatchReceipt(id);
+      return txHash;
+    }
+    if (needsApproval) {
+      const hash = await this.wallet.writeContract({
+        address: currency,
+        abi: erc20Abi,
+        functionName: "approve",
+        args: [spender, amount],
+        account: this.account,
+        chain: this.chain
+      });
+      await this.publicClient.waitForTransactionReceipt({ hash });
+    }
+    return this.wallet.writeContract({
+      address: call.to,
+      abi: call.abi,
+      functionName: call.functionName,
+      args: call.args,
+      account: this.account,
+      chain: this.chain
+    });
   }
 };
 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