@bananapus/nana-sdk-core 1.2.0 → 1.3.0

package/dist/esm/v6/nft.d.ts

@@ -0,0 +1,98 @@
+import { Address, Hex, PublicClient } from "viem";
+import { JBChainId } from "../types.js";
+/**
+ * JB721TiersHookStore's `DISCOUNT_DENOMINATOR`: a tier's `discountPercent` is
+ * out of 200, so the shopper-facing "% off" is `discountPercent / 2`.
+ */
+export declare const DISCOUNT_DENOMINATOR = 200n;
+/**
+ * A tier's effective (discounted) price, matching the on-chain formula in
+ * JB721TiersHookStore: `price - mulDiv(price, discountPercent, 200)` with
+ * integer-floor division.
+ *
+ * @param price The tier's full (undiscounted) price.
+ * @param discountPercent The tier's discount, out of 200 (`DISCOUNT_DENOMINATOR`).
+ */
+export declare function effectiveTierPrice(price: bigint, discountPercent: number | bigint): bigint;
+/**
+ * A single 721 tier a project sells.
+ */
+export interface Project721Tier {
+    id: number;
+    /** Full (undiscounted) price in the shop's pricing terms. */
+    price: bigint;
+    remainingSupply: number;
+    initialSupply: number;
+    votingUnits: bigint;
+    reserveFrequency: number;
+    category: number;
+    /** Out of 200 — see {@link DISCOUNT_DENOMINATOR}. */
+    discountPercent: number;
+    encodedIpfsUri: Hex;
+    /** tokenUriResolver output (data URI), or "" if the hook has no resolver. */
+    resolvedUri: string;
+}
+/**
+ * A project's resolved 721 tiers hook ("shop"): the hook, its store, the
+ * metadata id target for pay/cash-out metadata, the pricing context, and tiers.
+ */
+export interface Project721Shop {
+    /** The project's 721 tiers hook (the ruleset data hook / revnet hook). */
+    hook: Address;
+    /** The hook's tiers store. */
+    store: Address;
+    /**
+     * The hook's `METADATA_ID_TARGET` (shared implementation address). Pass this
+     * to {@link build721PayMetadata} / {@link build721CashOutMetadata}, never the
+     * `hook` address.
+     */
+    metadataIdTarget: Address;
+    /** The hook's pricing context: `currency` id and `decimals`. */
+    pricing: {
+        currency: number;
+        decimals: number;
+    };
+    tiers: Project721Tier[];
+}
+/**
+ * Read a JB721 hook's `METADATA_ID_TARGET` — the shared *implementation* address
+ * that pay/cash-out metadata ids must key off (a delegatecall clone reports the
+ * implementation, not itself). Falls back to `hook` if the read reverts (e.g. an
+ * older hook without the getter), which is only correct for a non-clone hook.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.hook The project's 721 tiers hook (clone) address.
+ */
+export declare function get721MetadataIdTarget(client: PublicClient, { hook }: {
+    chainId: JBChainId;
+    hook: Address;
+}): Promise<Address>;
+/**
+ * Resolve a project's 721 tiers hook, its store, metadata id target, pricing
+ * context, and tiers in one call.
+ *
+ * Hook resolution mirrors the app patterns: revnets read
+ * `REVOwner.tiered721HookOf`; custom projects read the current ruleset's pay
+ * data hook — either the omnichain deployer (the real hook lives in
+ * `JBOmnichainDeployer.tiered721HookOf(projectId, rulesetId)`) or the 721 hook
+ * itself, verified by probing `STORE()` (a revert means it is not a 721 hook, so
+ * the project has no shop).
+ *
+ * Returns `null` when the project authoritatively has no 721 shop. RPC failures
+ * on authoritative reads throw, so a transient error surfaces as an error rather
+ * than a false "no shop".
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.projectId The project (or revnet) id.
+ * @param args.isRevnet Whether the project is a revnet (changes hook resolution).
+ * @param args.tierLimit Max tiers to read from `tiersOf`. Defaults to 100.
+ * @param args.categories Tier categories to filter by (empty = all). Defaults to `[]`.
+ */
+export declare function getProject721Shop(client: PublicClient, { chainId, projectId, isRevnet, tierLimit, categories, }: {
+    chainId: JBChainId;
+    projectId: bigint;
+    isRevnet: boolean;
+    tierLimit?: number;
+    categories?: bigint[];
+}): Promise<Project721Shop | null>;
+//# sourceMappingURL=nft.d.ts.map

package/dist/esm/v6/nft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft.d.ts","sourceRoot":"","sources":["../../../src/v6/nft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAe,MAAM,MAAM,CAAC;AAQ/D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GAAG,MAAM,GAC/B,MAAM,CAKR;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,GAAG,CAAC;IACpB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,EAAE,IAAI,EAAE,EAAE;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC9C,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,EACE,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAe,EACf,UAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,GACA,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkGhC"}

package/dist/esm/v6/nft.js

@@ -0,0 +1,160 @@
+import { zeroAddress } from "viem";
+import { JBOmnichainDeployerContracts } from "../contracts.js";
+import { jb721TiersHookAbi, jb721TiersHookStoreAbi, jbContractAddress, jbOmnichainDeployerAbi, } from "../generated/juicebox.js";
+import { getRevnetTiered721Hook } from "./revnets.js";
+import { getCurrentRuleset } from "./rulesets.js";
+/**
+ * JB721TiersHookStore's `DISCOUNT_DENOMINATOR`: a tier's `discountPercent` is
+ * out of 200, so the shopper-facing "% off" is `discountPercent / 2`.
+ */
+export const DISCOUNT_DENOMINATOR = 200n;
+/**
+ * A tier's effective (discounted) price, matching the on-chain formula in
+ * JB721TiersHookStore: `price - mulDiv(price, discountPercent, 200)` with
+ * integer-floor division.
+ *
+ * @param price The tier's full (undiscounted) price.
+ * @param discountPercent The tier's discount, out of 200 (`DISCOUNT_DENOMINATOR`).
+ */
+export function effectiveTierPrice(price, discountPercent) {
+    let discount = BigInt(discountPercent);
+    if (discount <= 0n)
+        return price;
+    if (discount > DISCOUNT_DENOMINATOR)
+        discount = DISCOUNT_DENOMINATOR;
+    return price - (price * discount) / DISCOUNT_DENOMINATOR;
+}
+/**
+ * Read a JB721 hook's `METADATA_ID_TARGET` — the shared *implementation* address
+ * that pay/cash-out metadata ids must key off (a delegatecall clone reports the
+ * implementation, not itself). Falls back to `hook` if the read reverts (e.g. an
+ * older hook without the getter), which is only correct for a non-clone hook.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.hook The project's 721 tiers hook (clone) address.
+ */
+export async function get721MetadataIdTarget(client, { hook }) {
+    return client
+        .readContract({
+        address: hook,
+        abi: jb721TiersHookAbi,
+        functionName: "METADATA_ID_TARGET",
+    })
+        .catch(() => hook);
+}
+/**
+ * Resolve a project's 721 tiers hook, its store, metadata id target, pricing
+ * context, and tiers in one call.
+ *
+ * Hook resolution mirrors the app patterns: revnets read
+ * `REVOwner.tiered721HookOf`; custom projects read the current ruleset's pay
+ * data hook — either the omnichain deployer (the real hook lives in
+ * `JBOmnichainDeployer.tiered721HookOf(projectId, rulesetId)`) or the 721 hook
+ * itself, verified by probing `STORE()` (a revert means it is not a 721 hook, so
+ * the project has no shop).
+ *
+ * Returns `null` when the project authoritatively has no 721 shop. RPC failures
+ * on authoritative reads throw, so a transient error surfaces as an error rather
+ * than a false "no shop".
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.projectId The project (or revnet) id.
+ * @param args.isRevnet Whether the project is a revnet (changes hook resolution).
+ * @param args.tierLimit Max tiers to read from `tiersOf`. Defaults to 100.
+ * @param args.categories Tier categories to filter by (empty = all). Defaults to `[]`.
+ */
+export async function getProject721Shop(client, { chainId, projectId, isRevnet, tierLimit = 100, categories = [], }) {
+    // 1. Resolve the 721 hook.
+    let hook = null;
+    // A non-authoritative candidate is the ruleset data hook, which might be some
+    // other kind of hook; the STORE() probe below decides.
+    let authoritative = true;
+    if (isRevnet) {
+        const revnetHook = await getRevnetTiered721Hook(client, {
+            chainId,
+            revnetId: projectId,
+        });
+        hook = revnetHook !== zeroAddress ? revnetHook : null;
+    }
+    else {
+        const { ruleset, metadata } = await getCurrentRuleset(client, {
+            chainId,
+            projectId,
+        });
+        const dataHook = metadata.dataHook;
+        if (metadata.useDataHookForPay && dataHook && dataHook !== zeroAddress) {
+            const omni = jbContractAddress["6"][JBOmnichainDeployerContracts.JBOmnichainDeployer]?.[chainId];
+            if (omni && dataHook.toLowerCase() === omni.toLowerCase()) {
+                // Omnichain project: the real 721 hook lives in the deployer's
+                // per-ruleset mapping.
+                const [omniHook] = await client.readContract({
+                    address: omni,
+                    abi: jbOmnichainDeployerAbi,
+                    functionName: "tiered721HookOf",
+                    args: [projectId, BigInt(ruleset.id)],
+                });
+                hook = omniHook !== zeroAddress ? omniHook : null;
+            }
+            else {
+                // Single-chain custom project: the data hook may be the 721 hook itself.
+                hook = dataHook;
+                authoritative = false;
+            }
+        }
+    }
+    if (!hook)
+        return null;
+    // 2. The hook's store. For a non-authoritative candidate a revert means "not a
+    // 721 hook" (no shop); for an authoritative one, let failures throw.
+    const readStore = () => client.readContract({
+        address: hook,
+        abi: jb721TiersHookAbi,
+        functionName: "STORE",
+    });
+    const store = authoritative
+        ? await readStore()
+        : await readStore().catch(() => null);
+    if (!store)
+        return null;
+    // 3. Metadata id target + pricing context. Pricing is meaningless without the
+    // hook's exact currency + decimals, so a failure here is an error, not a
+    // fallback.
+    const [metadataIdTarget, pricingRaw] = await Promise.all([
+        get721MetadataIdTarget(client, { chainId, hook }),
+        client.readContract({
+            address: hook,
+            abi: jb721TiersHookAbi,
+            functionName: "pricingContext",
+        }),
+    ]);
+    // 4. The tiers, with resolver URIs included so callers can name tiers without
+    // a per-tier resolver read.
+    const raw = await client.readContract({
+        address: store,
+        abi: jb721TiersHookStoreAbi,
+        functionName: "tiersOf",
+        args: [hook, categories, true, 0n, BigInt(tierLimit)],
+    });
+    const tiers = raw
+        .filter((tier) => tier.initialSupply > 0)
+        .map((tier) => ({
+        id: tier.id,
+        price: tier.price,
+        remainingSupply: tier.remainingSupply,
+        initialSupply: tier.initialSupply,
+        votingUnits: tier.votingUnits,
+        reserveFrequency: tier.reserveFrequency,
+        category: tier.category,
+        discountPercent: tier.discountPercent,
+        encodedIpfsUri: tier.encodedIpfsUri,
+        resolvedUri: tier.resolvedUri ?? "",
+    }));
+    return {
+        hook,
+        store,
+        metadataIdTarget,
+        pricing: { currency: Number(pricingRaw[0]), decimals: Number(pricingRaw[1]) },
+        tiers,
+    };
+}
+//# sourceMappingURL=nft.js.map

package/dist/esm/v6/nft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft.js","sourceRoot":"","sources":["../../../src/v6/nft.ts"],"names":[],"mappings":"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"}

package/dist/esm/v6/nft.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nft.test.d.ts.map

package/dist/esm/v6/nft.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft.test.d.ts","sourceRoot":"","sources":["../../../src/v6/nft.test.ts"],"names":[],"mappings":""}

package/dist/esm/v6/nft.test.js

@@ -0,0 +1,204 @@
+import { zeroAddress } from "viem";
+import { describe, expect, test } from "vitest";
+import { JBOmnichainDeployerContracts } from "../contracts.js";
+import { jbContractAddress } from "../generated/juicebox.js";
+import { DISCOUNT_DENOMINATOR, effectiveTierPrice, get721MetadataIdTarget, getProject721Shop, } from "./nft.js";
+const chainId = 11155111;
+const hook = "0x1111111111111111111111111111111111111111";
+const impl = "0x2222222222222222222222222222222222222222";
+const store = "0x3333333333333333333333333333333333333333";
+describe("effectiveTierPrice", () => {
+    test("floors like on-chain mulDiv(price, discountPercent, 200)", () => {
+        // 100 - floor(100 * 25 / 200) = 100 - 12 = 88.
+        expect(effectiveTierPrice(100n, 25)).toEqual(88n);
+    });
+    test("no discount returns the full price", () => {
+        expect(effectiveTierPrice(1000n, 0)).toEqual(1000n);
+    });
+    test("full discount (denominator) is free", () => {
+        expect(effectiveTierPrice(1000n, Number(DISCOUNT_DENOMINATOR))).toEqual(0n);
+    });
+    test("clamps discounts above the denominator to free", () => {
+        expect(effectiveTierPrice(1000n, 500)).toEqual(0n);
+    });
+});
+describe("get721MetadataIdTarget", () => {
+    test("returns METADATA_ID_TARGET (the implementation, not the clone)", async () => {
+        const client = {
+            readContract: async () => impl,
+        };
+        expect(await get721MetadataIdTarget(client, { chainId, hook })).toEqual(impl);
+    });
+    test("falls back to the hook address if the getter reverts", async () => {
+        const client = {
+            readContract: async () => {
+                throw new Error("no such function");
+            },
+        };
+        expect(await get721MetadataIdTarget(client, { chainId, hook })).toEqual(hook);
+    });
+});
+describe("getProject721Shop", () => {
+    test("returns null when a revnet has no 721 hook", async () => {
+        const client = {
+            // getRevnetTiered721Hook -> zero address.
+            readContract: async () => zeroAddress,
+        };
+        expect(await getProject721Shop(client, {
+            chainId,
+            projectId: 1n,
+            isRevnet: true,
+        })).toBeNull();
+    });
+    test("resolves a revnet shop: hook, store, target, pricing, tiers", async () => {
+        const client = {
+            readContract: async ({ address, functionName, }) => {
+                if (functionName === "tiered721HookOf")
+                    return hook; // REVOwner
+                if (address === hook && functionName === "STORE")
+                    return store;
+                if (functionName === "METADATA_ID_TARGET")
+                    return impl;
+                if (functionName === "pricingContext")
+                    return [61166n, 18n];
+                if (functionName === "tiersOf") {
+                    return [
+                        {
+                            id: 1,
+                            price: 1000n,
+                            remainingSupply: 5,
+                            initialSupply: 10,
+                            votingUnits: 0n,
+                            reserveFrequency: 0,
+                            reserveBeneficiary: zeroAddress,
+                            encodedIpfsUri: `0x${"11".repeat(32)}`,
+                            category: 0,
+                            discountPercent: 0,
+                            flags: {},
+                            splitPercent: 0,
+                            resolvedUri: "",
+                        },
+                        // Filtered out: initialSupply 0.
+                        {
+                            id: 2,
+                            price: 0n,
+                            remainingSupply: 0,
+                            initialSupply: 0,
+                            votingUnits: 0n,
+                            reserveFrequency: 0,
+                            reserveBeneficiary: zeroAddress,
+                            encodedIpfsUri: `0x${"00".repeat(32)}`,
+                            category: 0,
+                            discountPercent: 0,
+                            flags: {},
+                            splitPercent: 0,
+                            resolvedUri: "",
+                        },
+                    ];
+                }
+                throw new Error(`unexpected read ${functionName}`);
+            },
+        };
+        const shop = await getProject721Shop(client, {
+            chainId,
+            projectId: 1n,
+            isRevnet: true,
+        });
+        expect(shop).not.toBeNull();
+        expect(shop.hook).toEqual(hook);
+        expect(shop.store).toEqual(store);
+        expect(shop.metadataIdTarget).toEqual(impl);
+        expect(shop.pricing).toEqual({ currency: 61166, decimals: 18 });
+        expect(shop.tiers).toHaveLength(1);
+        expect(shop.tiers[0]).toMatchObject({ id: 1, price: 1000n });
+    });
+    const tiersOfOne = () => [
+        {
+            id: 1,
+            price: 1000n,
+            remainingSupply: 5,
+            initialSupply: 10,
+            votingUnits: 0n,
+            reserveFrequency: 0,
+            reserveBeneficiary: zeroAddress,
+            encodedIpfsUri: `0x${"11".repeat(32)}`,
+            category: 0,
+            discountPercent: 0,
+            flags: {},
+            splitPercent: 0,
+            resolvedUri: "",
+        },
+    ];
+    // The custom-project omnichain deployer address on chain 11155111, read from
+    // the SDK's own address book so the branch matches real wiring.
+    const omniDeployer = jbContractAddress["6"][JBOmnichainDeployerContracts.JBOmnichainDeployer]["11155111"];
+    test("custom project: resolves the real hook via the omnichain deployer", async () => {
+        const client = {
+            readContract: async ({ address, functionName, }) => {
+                // currentRulesetOf -> [ruleset, metadata] with the deployer as data hook.
+                if (functionName === "currentRulesetOf") {
+                    return [
+                        { id: 7 },
+                        { useDataHookForPay: true, dataHook: omniDeployer },
+                    ];
+                }
+                // The deployer maps to the real clone hook.
+                if (address.toLowerCase() === omniDeployer.toLowerCase() &&
+                    functionName === "tiered721HookOf") {
+                    return [hook, false];
+                }
+                if (address === hook && functionName === "STORE")
+                    return store;
+                if (functionName === "METADATA_ID_TARGET")
+                    return impl;
+                if (functionName === "pricingContext")
+                    return [1n, 18n];
+                if (functionName === "tiersOf")
+                    return tiersOfOne();
+                throw new Error(`unexpected read ${functionName} @ ${address}`);
+            },
+        };
+        const shop = await getProject721Shop(client, {
+            chainId: 11155111,
+            projectId: 9n,
+            isRevnet: false,
+        });
+        expect(shop.hook).toEqual(hook);
+        expect(shop.metadataIdTarget).toEqual(impl);
+    });
+    test("custom project: data hook that is not a 721 hook is no shop", async () => {
+        const notAHook = "0x4444444444444444444444444444444444444444";
+        const client = {
+            readContract: async ({ functionName }) => {
+                if (functionName === "currentRulesetOf") {
+                    return [{ id: 7 }, { useDataHookForPay: true, dataHook: notAHook }];
+                }
+                // Non-authoritative candidate: STORE() reverts => not a 721 hook.
+                if (functionName === "STORE")
+                    throw new Error("no STORE");
+                throw new Error(`unexpected read ${functionName}`);
+            },
+        };
+        expect(await getProject721Shop(client, {
+            chainId: 11155111,
+            projectId: 9n,
+            isRevnet: false,
+        })).toBeNull();
+    });
+    test("custom project: no pay data hook is no shop", async () => {
+        const client = {
+            readContract: async ({ functionName }) => {
+                if (functionName === "currentRulesetOf") {
+                    return [{ id: 7 }, { useDataHookForPay: false, dataHook: zeroAddress }];
+                }
+                throw new Error(`unexpected read ${functionName}`);
+            },
+        };
+        expect(await getProject721Shop(client, {
+            chainId: 11155111,
+            projectId: 9n,
+            isRevnet: false,
+        })).toBeNull();
+    });
+});
+//# sourceMappingURL=nft.test.js.map

package/dist/esm/v6/nft.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft.test.js","sourceRoot":"","sources":["../../../src/v6/nft.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/v6/pay.d.ts

@@ -92,18 +92,26 @@ export declare function previewPay(client: PublicClient, { terminal, projectId,
  * Build pay metadata instructing a project's JB721 tiers hook to mint specific tiers.
  *
  * The tier payload is `abi.encode(bool allowOverspending, uint16[] tierIdsToMint)`,
- * keyed by the hook's metadata id (`bytes4(bytes20(hookAddress) ^
+ * keyed by the hook's metadata id (`bytes4(bytes20(metadataIdTarget) ^
  * bytes20(keccak256("pay")))`) and packed into the JBMetadataResolver
  * word-offset-table format.
  *
- * @param args.hookAddress The project's JB721 tiers hook (the ruleset's data hook).
+ * @param args.metadataIdTarget The hook's `METADATA_ID_TARGET` — the shared
+ * *implementation* address, NOT the project's clone hook address (see
+ * {@link get721MetadataIdTarget}). Passing the clone address makes the hook ignore
+ * the tiers and the payment mints ZERO NFTs (it succeeds, minting only tokens).
+ * @param args.hookAddress Deprecated alias for `metadataIdTarget`. Only correct
+ * when it already holds `METADATA_ID_TARGET`; prefer `metadataIdTarget`.
  * @param args.tierIdsToMint The tier ids to mint, one entry per NFT.
  * @param args.allowOverspending Whether payment beyond the tiers' total price is
- * allowed (excess mints no NFT). Defaults to true.
+ * allowed (excess mints no NFT). Defaults to true. Note the hook still gates this
+ * on its store's `preventOverspending` flag.
  * @returns The metadata to pass as `pay`'s `metadata` argument.
  */
-export declare function build721PayMetadata({ hookAddress, tierIdsToMint, allowOverspending, }: {
-    hookAddress: Address;
+export declare function build721PayMetadata({ metadataIdTarget, hookAddress, tierIdsToMint, allowOverspending, }: {
+    metadataIdTarget?: Address;
+    /** @deprecated Use `metadataIdTarget`. */
+    hookAddress?: Address;
     tierIdsToMint: bigint[];
     allowOverspending?: boolean;
 }): Hex;

package/dist/esm/v6/pay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pay.d.ts","sourceRoot":"","sources":["../../../src/v6/pay.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,GAAG,EACH,YAAY,EAKb,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,kBAAkB,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,iBAAsB,EACtB,IAAS,EACT,QAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,cAAc,CAmBjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,EACE,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,QAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GACA,OAAO,CAAC,UAAU,CAAC,CAUrB;AAkBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,aAAa,EACb,iBAA8C,GAC/C,EAAE;IACD,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,GAAG,CAUN"}
+{"version":3,"file":"pay.d.ts","sourceRoot":"","sources":["../../../src/v6/pay.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,GAAG,EACH,YAAY,EAEb,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,kBAAkB,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,iBAAsB,EACtB,IAAS,EACT,QAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,cAAc,CAmBjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,EACE,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,QAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GACA,OAAO,CAAC,UAAU,CAAC,CAUrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,iBAA8C,GAC/C,EAAE;IACD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,GAAG,CAeN"}

package/dist/esm/v6/pay.js

@@ -1,7 +1,7 @@
-import { bytesToHex, encodeAbiParameters, keccak256, toBytes, } from "viem";
+import { encodeAbiParameters, } from "viem";
 import { DEFAULT_ALLOW_OVERSPENDING, NATIVE_TOKEN } from "../constants.js";
 import { jbMultiTerminalAbi } from "../generated/juicebox.js";
-import { createHookMetadata } from "../utils/hook.js";
+import { createHookMetadata, hookMetadataId } from "../utils/hook.js";
 /**
  * Build a `pay(projectId, token, amount, beneficiary, minReturnedTokens, memo,
  * metadata)` transaction request for a v6 terminal.
@@ -72,35 +72,32 @@ export async function previewPay(client, { terminal, projectId, token, amount, b
     });
     return { beneficiaryTokenCount, reservedTokenCount };
 }
-/**
- * The metadata id a JB721 hook looks up in pay metadata:
- * `bytes4(bytes20(target) ^ bytes20(keccak256("pay")))`, where the target is the hook's
- * own address (`JB721Hook.METADATA_ID_TARGET` is `address(this)`).
- *
- * @link https://github.com/Bananapus/nana-core-v6/blob/main/src/libraries/JBMetadataResolver.sol (`getId`)
- */
-function pay721MetadataId(hookAddress) {
-    const targetBytes = toBytes(hookAddress).slice(0, 20);
-    const purposeBytes = toBytes(keccak256(toBytes("pay"))).slice(0, 20);
-    const xorResult = targetBytes.map((byte, i) => byte ^ purposeBytes[i]);
-    return bytesToHex(xorResult.slice(0, 4));
-}
 /**
  * Build pay metadata instructing a project's JB721 tiers hook to mint specific tiers.
  *
  * The tier payload is `abi.encode(bool allowOverspending, uint16[] tierIdsToMint)`,
- * keyed by the hook's metadata id (`bytes4(bytes20(hookAddress) ^
+ * keyed by the hook's metadata id (`bytes4(bytes20(metadataIdTarget) ^
  * bytes20(keccak256("pay")))`) and packed into the JBMetadataResolver
  * word-offset-table format.
  *
- * @param args.hookAddress The project's JB721 tiers hook (the ruleset's data hook).
+ * @param args.metadataIdTarget The hook's `METADATA_ID_TARGET` — the shared
+ * *implementation* address, NOT the project's clone hook address (see
+ * {@link get721MetadataIdTarget}). Passing the clone address makes the hook ignore
+ * the tiers and the payment mints ZERO NFTs (it succeeds, minting only tokens).
+ * @param args.hookAddress Deprecated alias for `metadataIdTarget`. Only correct
+ * when it already holds `METADATA_ID_TARGET`; prefer `metadataIdTarget`.
  * @param args.tierIdsToMint The tier ids to mint, one entry per NFT.
  * @param args.allowOverspending Whether payment beyond the tiers' total price is
- * allowed (excess mints no NFT). Defaults to true.
+ * allowed (excess mints no NFT). Defaults to true. Note the hook still gates this
+ * on its store's `preventOverspending` flag.
  * @returns The metadata to pass as `pay`'s `metadata` argument.
  */
-export function build721PayMetadata({ hookAddress, tierIdsToMint, allowOverspending = DEFAULT_ALLOW_OVERSPENDING, }) {
+export function build721PayMetadata({ metadataIdTarget, hookAddress, tierIdsToMint, allowOverspending = DEFAULT_ALLOW_OVERSPENDING, }) {
+    const target = metadataIdTarget ?? hookAddress;
+    if (!target) {
+        throw new Error("build721PayMetadata requires metadataIdTarget");
+    }
     const tierPayload = encodeAbiParameters([{ type: "bool" }, { type: "uint16[]" }], [allowOverspending, tierIdsToMint.map(Number)]);
-    return createHookMetadata([pay721MetadataId(hookAddress)], [tierPayload]);
+    return createHookMetadata([hookMetadataId(target, "pay")], [tierPayload]);
 }
 //# sourceMappingURL=pay.js.map

package/dist/esm/v6/pay.js.map

@@ -1 +1 @@
-{"version":3,"file":"pay.js","sourceRoot":"","sources":["../../../src/v6/pay.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,OAAO,GACR,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAetD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,iBAAiB,GAAG,EAAE,EACtB,IAAI,GAAG,EAAE,EACT,QAAQ,GAAG,IAAI,GAWhB;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAAC;IAEpE,OAAO;QACL,OAAO;QACP,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,KAAK;QACnB,IAAI,EAAE;YACJ,SAAS;YACT,KAAK;YACL,MAAM;YACN,WAAW;YACX,iBAAiB;YACjB,IAAI;YACJ,QAAQ;SACT;QACD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;KAC9B,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAoB,EACpB,EACE,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,QAAQ,GAAG,IAAI,GAShB;IAED,MAAM,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,GACjD,MAAM,MAAM,CAAC,YAAY,CAAC;QACxB,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,eAAe;QAC7B,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC;KACxD,CAAC,CAAC;IAEL,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,WAAoB;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,WAAW,EACX,aAAa,EACb,iBAAiB,GAAG,0BAA0B,GAK/C;IACC,MAAM,WAAW,GAAG,mBAAmB,CACrC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EACxC,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAC/C,CAAC;IAEF,OAAO,kBAAkB,CACvB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,EAC/B,CAAC,WAAW,CAAC,CACP,CAAC;AACX,CAAC"}
+{"version":3,"file":"pay.js","sourceRoot":"","sources":["../../../src/v6/pay.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,mBAAmB,GACpB,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAetE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,iBAAiB,GAAG,EAAE,EACtB,IAAI,GAAG,EAAE,EACT,QAAQ,GAAG,IAAI,GAWhB;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAAC;IAEpE,OAAO;QACL,OAAO;QACP,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,KAAK;QACnB,IAAI,EAAE;YACJ,SAAS;YACT,KAAK;YACL,MAAM;YACN,WAAW;YACX,iBAAiB;YACjB,IAAI;YACJ,QAAQ;SACT;QACD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;KAC9B,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAoB,EACpB,EACE,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,QAAQ,GAAG,IAAI,GAShB;IAED,MAAM,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,GACjD,MAAM,MAAM,CAAC,YAAY,CAAC;QACxB,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,eAAe;QAC7B,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC;KACxD,CAAC,CAAC;IAEL,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,iBAAiB,GAAG,0BAA0B,GAO/C;IACC,MAAM,MAAM,GAAG,gBAAgB,IAAI,WAAW,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,WAAW,GAAG,mBAAmB,CACrC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EACxC,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAC/C,CAAC;IAEF,OAAO,kBAAkB,CACvB,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAC/B,CAAC,WAAW,CAAC,CACP,CAAC;AACX,CAAC"}

package/dist/esm/v6/pay.test.js

@@ -124,5 +124,12 @@ describe("pay", () => {
         // 0xadc75680 (first 4 bytes of keccak256("pay")) XOR 0x11111111.
         expect(sliceHex(metadata, 32, 36)).toEqual("0xbcd64791");
     });
+    test("build721PayMetadata metadataIdTarget matches the hookAddress alias", () => {
+        const target = "0x1111111111111111111111111111111111111111";
+        expect(build721PayMetadata({ metadataIdTarget: target, tierIdsToMint: [1n] })).toEqual(build721PayMetadata({ hookAddress: target, tierIdsToMint: [1n] }));
+    });
+    test("build721PayMetadata throws when no target is given", () => {
+        expect(() => build721PayMetadata({ tierIdsToMint: [1n] })).toThrow(/metadataIdTarget/);
+    });
 });
 //# sourceMappingURL=pay.test.js.map