@morpho-org/midnight-sdk 2.1.0-next.0 → 2.2.0-next.0

package/lib/cjs/api/version.generated.d.ts

@@ -1,2 +1,2 @@
 /** @internal Installed Midnight SDK package version. */
-export declare const MIDNIGHT_SDK_VERSION = "2.1.0-next.0";
+export declare const MIDNIGHT_SDK_VERSION = "2.2.0-next.0";

package/lib/cjs/api/version.generated.js

@@ -3,4 +3,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIDNIGHT_SDK_VERSION = void 0;
 /** @internal Installed Midnight SDK package version. */
-exports.MIDNIGHT_SDK_VERSION = "2.1.0-next.0";
+exports.MIDNIGHT_SDK_VERSION = "2.2.0-next.0";

package/lib/cjs/offers/Offer.d.ts

@@ -150,6 +150,7 @@ export declare class Offer {
     readonly tick: bigint;
     private cachedGroup;
     private cachedHash;
+    private cachedOnchainHash;
     /**
      * Whether the group id was supplied at construction rather than derived.
      *
@@ -329,6 +330,55 @@ export declare class Offer {
      * ```
      */
     get hash(): Hash;
+    /**
+     * Returns the on-chain offer identifier emitted by Midnight's `Take` event.
+     *
+     * This `keccak256(abi.encode(offer))` hash identifies offers on-chain and is
+     * distinct from `hash`, the typehash-prefixed ratifier hash.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @returns The cached on-chain offer hash.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = offer.onchainHash;
+     * console.log(offerHash);
+     * ```
+     */
+    get onchainHash(): Hash;
     /**
      * WAD zero-coupon price at this offer's tick.
      *

package/lib/cjs/offers/Offer.js

@@ -71,6 +71,7 @@ class Offer {
     tick;
     cachedGroup;
     cachedHash;
+    cachedOnchainHash;
     /**
      * Whether the group id was supplied at construction rather than derived.
      *
@@ -281,6 +282,58 @@ class Offer {
         this.cachedHash ??= OfferUtils_js_1.OfferUtils.hash(this);
         return this.cachedHash;
     }
+    /**
+     * Returns the on-chain offer identifier emitted by Midnight's `Take` event.
+     *
+     * This `keccak256(abi.encode(offer))` hash identifies offers on-chain and is
+     * distinct from `hash`, the typehash-prefixed ratifier hash.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @returns The cached on-chain offer hash.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = offer.onchainHash;
+     * console.log(offerHash);
+     * ```
+     */
+    get onchainHash() {
+        this.cachedOnchainHash ??= OfferUtils_js_1.OfferUtils.onchainHash(this);
+        return this.cachedOnchainHash;
+    }
     /**
      * WAD zero-coupon price at this offer's tick.
      *

package/lib/cjs/offers/OfferUtils.d.ts

@@ -160,6 +160,114 @@ export declare namespace OfferUtils {
      * ```
      */
     function hash(offer: IOffer & Required<Pick<IOffer, "group">>): Hash;
+    /**
+     * Computes the on-chain offer identifier from the supplied offer struct.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hashStruct` and `hash`, which produce the typehash-prefixed ratifier hash.
+     * Collaterals are hashed in the supplied order; Midnight rejects unsorted
+     * collateral params with `CollateralParamsNotSorted`, so pass a sorted struct,
+     * for example one returned by `toStruct`.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offerStruct - ABI-compatible offer to hash without normalization.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHashStruct(
+     *   OfferUtils.toStruct({ offer }),
+     * );
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHashStruct(offerStruct: OfferStruct): Hash;
+    /**
+     * Computes the on-chain offer identifier from an offer with a group id.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hash`, which returns the typehash-prefixed ratifier hash. `toStruct`
+     * normalizes the offer and sorts collateral params as required by Midnight.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offer - Offer with the protocol group id encoded in its struct.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHash(offer);
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHash(offer: IOffer & Required<Pick<IOffer, "group">>): Hash;
     /**
      * Computes the offer hash used to derive a content-addressed group id.
      *

package/lib/cjs/offers/OfferUtils.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OfferUtils = void 0;
 const morpho_ts_1 = require("@morpho-org/morpho-ts");
 const viem_1 = require("viem");
+const abis_js_1 = require("../abis.js");
 const constants_js_1 = require("../constants.js");
 const errors_js_1 = require("../errors.js");
 const index_js_1 = require("../market/index.js");
 const index_js_2 = require("../math/index.js");
 const Offer_js_1 = require("./Offer.js");
+const takeOfferParam = (0, viem_1.getAbiItem)({ abi: abis_js_1.midnightAbi, name: "take" }).inputs[0];
 const offerHashParams = [
     { name: "typehash", type: "bytes32" },
     { name: "marketHash", type: "bytes32" },
@@ -226,6 +228,120 @@ var OfferUtils;
         return hashStruct(toStruct({ offer }));
     }
     OfferUtils.hash = hash;
+    /**
+     * Computes the on-chain offer identifier from the supplied offer struct.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hashStruct` and `hash`, which produce the typehash-prefixed ratifier hash.
+     * Collaterals are hashed in the supplied order; Midnight rejects unsorted
+     * collateral params with `CollateralParamsNotSorted`, so pass a sorted struct,
+     * for example one returned by `toStruct`.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offerStruct - ABI-compatible offer to hash without normalization.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHashStruct(
+     *   OfferUtils.toStruct({ offer }),
+     * );
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHashStruct(offerStruct) {
+        return (0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)([takeOfferParam], [offerStruct]));
+    }
+    OfferUtils.onchainHashStruct = onchainHashStruct;
+    /**
+     * Computes the on-chain offer identifier from an offer with a group id.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hash`, which returns the typehash-prefixed ratifier hash. `toStruct`
+     * normalizes the offer and sorts collateral params as required by Midnight.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offer - Offer with the protocol group id encoded in its struct.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHash(offer);
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHash(offer) {
+        return onchainHashStruct(toStruct({ offer }));
+    }
+    OfferUtils.onchainHash = onchainHash;
     /**
      * Computes the offer hash used to derive a content-addressed group id.
      *

package/lib/esm/api/version.generated.d.ts

@@ -1,2 +1,2 @@
 /** @internal Installed Midnight SDK package version. */
-export declare const MIDNIGHT_SDK_VERSION = "2.1.0-next.0";
+export declare const MIDNIGHT_SDK_VERSION = "2.2.0-next.0";

package/lib/esm/api/version.generated.js

@@ -1,3 +1,3 @@
 // Generated by scripts/generate-midnight-package-version.ts. Do not edit.
 /** @internal Installed Midnight SDK package version. */
-export const MIDNIGHT_SDK_VERSION = "2.1.0-next.0";
+export const MIDNIGHT_SDK_VERSION = "2.2.0-next.0";

package/lib/esm/offers/Offer.d.ts

@@ -150,6 +150,7 @@ export declare class Offer {
     readonly tick: bigint;
     private cachedGroup;
     private cachedHash;
+    private cachedOnchainHash;
     /**
      * Whether the group id was supplied at construction rather than derived.
      *
@@ -329,6 +330,55 @@ export declare class Offer {
      * ```
      */
     get hash(): Hash;
+    /**
+     * Returns the on-chain offer identifier emitted by Midnight's `Take` event.
+     *
+     * This `keccak256(abi.encode(offer))` hash identifies offers on-chain and is
+     * distinct from `hash`, the typehash-prefixed ratifier hash.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @returns The cached on-chain offer hash.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = offer.onchainHash;
+     * console.log(offerHash);
+     * ```
+     */
+    get onchainHash(): Hash;
     /**
      * WAD zero-coupon price at this offer's tick.
      *

package/lib/esm/offers/Offer.js

@@ -68,6 +68,7 @@ export class Offer {
     tick;
     cachedGroup;
     cachedHash;
+    cachedOnchainHash;
     /**
      * Whether the group id was supplied at construction rather than derived.
      *
@@ -278,6 +279,58 @@ export class Offer {
         this.cachedHash ??= OfferUtils.hash(this);
         return this.cachedHash;
     }
+    /**
+     * Returns the on-chain offer identifier emitted by Midnight's `Take` event.
+     *
+     * This `keccak256(abi.encode(offer))` hash identifies offers on-chain and is
+     * distinct from `hash`, the typehash-prefixed ratifier hash.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @returns The cached on-chain offer hash.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = offer.onchainHash;
+     * console.log(offerHash);
+     * ```
+     */
+    get onchainHash() {
+        this.cachedOnchainHash ??= OfferUtils.onchainHash(this);
+        return this.cachedOnchainHash;
+    }
     /**
      * WAD zero-coupon price at this offer's tick.
      *

package/lib/esm/offers/OfferUtils.d.ts

@@ -160,6 +160,114 @@ export declare namespace OfferUtils {
      * ```
      */
     function hash(offer: IOffer & Required<Pick<IOffer, "group">>): Hash;
+    /**
+     * Computes the on-chain offer identifier from the supplied offer struct.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hashStruct` and `hash`, which produce the typehash-prefixed ratifier hash.
+     * Collaterals are hashed in the supplied order; Midnight rejects unsorted
+     * collateral params with `CollateralParamsNotSorted`, so pass a sorted struct,
+     * for example one returned by `toStruct`.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offerStruct - ABI-compatible offer to hash without normalization.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHashStruct(
+     *   OfferUtils.toStruct({ offer }),
+     * );
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHashStruct(offerStruct: OfferStruct): Hash;
+    /**
+     * Computes the on-chain offer identifier from an offer with a group id.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hash`, which returns the typehash-prefixed ratifier hash. `toStruct`
+     * normalizes the offer and sorts collateral params as required by Midnight.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offer - Offer with the protocol group id encoded in its struct.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHash(offer);
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHash(offer: IOffer & Required<Pick<IOffer, "group">>): Hash;
     /**
      * Computes the offer hash used to derive a content-addressed group id.
      *

package/lib/esm/offers/OfferUtils.js

@@ -1,10 +1,12 @@
 import { assertNonNegative, DivisionByZeroError, MathLib, } from "@morpho-org/morpho-ts";
-import { encodeAbiParameters, isAddressEqual, keccak256, zeroAddress, zeroHash, } from "viem";
+import { encodeAbiParameters, getAbiItem, isAddressEqual, keccak256, zeroAddress, zeroHash, } from "viem";
+import { midnightAbi } from "../abis.js";
 import { DEFAULT_TICK_SPACING, MAX_OFFER_CAP, MAX_TICK, OFFER_TYPEHASH, } from "../constants.js";
 import { InvalidOfferGroupError, InvalidOfferParameterError, } from "../errors.js";
 import { Market, MarketParams, MarketUtils } from "../market/index.js";
 import { TakeAmountsLib, TickLib } from "../math/index.js";
 import { Offer, } from "./Offer.js";
+const takeOfferParam = getAbiItem({ abi: midnightAbi, name: "take" }).inputs[0];
 const offerHashParams = [
     { name: "typehash", type: "bytes32" },
     { name: "marketHash", type: "bytes32" },
@@ -223,6 +225,120 @@ export var OfferUtils;
         return hashStruct(toStruct({ offer }));
     }
     OfferUtils.hash = hash;
+    /**
+     * Computes the on-chain offer identifier from the supplied offer struct.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hashStruct` and `hash`, which produce the typehash-prefixed ratifier hash.
+     * Collaterals are hashed in the supplied order; Midnight rejects unsorted
+     * collateral params with `CollateralParamsNotSorted`, so pass a sorted struct,
+     * for example one returned by `toStruct`.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offerStruct - ABI-compatible offer to hash without normalization.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHashStruct(
+     *   OfferUtils.toStruct({ offer }),
+     * );
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHashStruct(offerStruct) {
+        return keccak256(encodeAbiParameters([takeOfferParam], [offerStruct]));
+    }
+    OfferUtils.onchainHashStruct = onchainHashStruct;
+    /**
+     * Computes the on-chain offer identifier from an offer with a group id.
+     *
+     * This is `keccak256(abi.encode(offer))`, the hash emitted by Midnight's
+     * `Take` event and used to identify offers on-chain. It is distinct from
+     * `hash`, which returns the typehash-prefixed ratifier hash. `toStruct`
+     * normalizes the offer and sorts collateral params as required by Midnight.
+     * It matches a `Take` event only for the offer exactly as published. For
+     * RateRatifierV1 and PriceRatifierV1, hash the offers in the descriptor's
+     * `offers`: `buildDescriptor` replaces both the default group and a
+     * `Group.create` group.
+     *
+     * @param offer - Offer with the protocol group id encoded in its struct.
+     * @returns The offer hash emitted by Midnight's `Take` event.
+     * @throws {viem.InvalidAddressError} when an address has an invalid mixed-case checksum.
+     * @throws {viem.IntegerOutOfRangeError} when a uint field overflows its ABI size.
+     * @example
+     * ```ts
+     * import { Offer, OfferUtils } from "@morpho-org/midnight-sdk";
+     * import { zeroAddress } from "viem";
+     *
+     * const offer = Offer.create({
+     *   market: {
+     *     chainId: 8453,
+     *     midnight: "0x0000000000000000000000000000000000001000",
+     *     loanToken: "0x0000000000000000000000000000000000006000",
+     *     collateralParams: [
+     *       {
+     *         token: "0x0000000000000000000000000000000000007000",
+     *         lltv: 770000000000000000n,
+     *         liquidationCursor: 250000000000000000n,
+     *         oracle: "0x0000000000000000000000000000000000008000",
+     *       },
+     *     ],
+     *     maturity: 54_000n,
+     *     rcfThreshold: 0n,
+     *     enterGate: zeroAddress,
+     *     liquidatorGate: zeroAddress,
+     *   },
+     *   buy: true,
+     *   maker: "0x0000000000000000000000000000000000009000",
+     *   tick: 5_000n,
+     *   group: "0x1111111111111111111111111111111111111111111111111111111111111111",
+     *   expiry: 3_600n,
+     *   ratifier: "0x0000000000000000000000000000000000004000",
+     *   maxUnits: 100n,
+     * });
+     * const offerHash = OfferUtils.onchainHash(offer);
+     * console.log(offerHash);
+     * ```
+     */
+    function onchainHash(offer) {
+        return onchainHashStruct(toStruct({ offer }));
+    }
+    OfferUtils.onchainHash = onchainHash;
     /**
      * Computes the offer hash used to derive a content-addressed group id.
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morpho-org/midnight-sdk",
   "description": "Viem-based package for Morpho Midnight that exports protocol utilities, fetch helpers, and Midnight API utilities under a dedicated API subpath.",
-  "version": "2.1.0-next.0",
+  "version": "2.2.0-next.0",
   "author": "Morpho Association <contact@morpho.org>",
   "repository": {
     "type": "git",
@@ -46,7 +46,7 @@
   },
   "devDependencies": {
     "@morpho-org/morpho-ts": "^4.1.0-next.0",
-    "@morpho-org/test": "^2.11.0-next.0",
+    "@morpho-org/test": "^2.12.0-next.0",
     "fast-check": "^4.9.0",
     "typescript": "7.0.2",
     "viem": "^2.55.10",