@bananapus/nana-sdk-core 1.3.0 → 1.4.1

package/dist/esm/v6/nft.js

@@ -1,13 +1,192 @@
 import { zeroAddress } from "viem";
 import { JBOmnichainDeployerContracts } from "../contracts.js";
 import { jb721TiersHookAbi, jb721TiersHookStoreAbi, jbContractAddress, jbOmnichainDeployerAbi, } from "../generated/juicebox.js";
+import { ipfsAssetPath, isIpfsCid } from "../utils/ipfs.js";
 import { getRevnetTiered721Hook } from "./revnets.js";
 import { getCurrentRuleset } from "./rulesets.js";
+/**
+ * App-level sentinel convention used by Juicebox 721 shops for effectively
+ * unlimited inventory.
+ */
+export const TIER_UNLIMITED_SUPPLY = 999_999_999;
 /**
  * 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;
+function nonEmptyString(value) {
+    return typeof value === "string" && value ? value : undefined;
+}
+function decodeBase64Utf8(value) {
+    const binary = atob(value);
+    return new TextDecoder().decode(Uint8Array.from(binary, (character) => character.charCodeAt(0)));
+}
+/**
+ * Parse a `data:application/json` tier URI. Invalid, non-object, and non-data
+ * values return `null` so callers can fall back to an IPFS metadata fetch.
+ */
+export function parseTierMetadataJson(uri) {
+    if (!uri.startsWith("data:application/json"))
+        return null;
+    const comma = uri.indexOf(",");
+    if (comma === -1)
+        return null;
+    try {
+        const header = uri.slice(0, comma);
+        const payload = uri.slice(comma + 1);
+        const json = JSON.parse(header.split(";").includes("base64")
+            ? decodeBase64Utf8(payload)
+            : decodeURIComponent(payload));
+        return json !== null && typeof json === "object" && !Array.isArray(json)
+            ? json
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Normalize legacy and current tier metadata field names into one display
+ * shape. Only non-empty strings are returned.
+ */
+export function pickTierMetadata(json) {
+    return {
+        name: nonEmptyString(json.productName) ?? nonEmptyString(json.name),
+        description: nonEmptyString(json.productDescription) ??
+            nonEmptyString(json.description),
+        image: nonEmptyString(json.image) ?? nonEmptyString(json.imageUri),
+        animationUrl: nonEmptyString(json.animation_url) ?? nonEmptyString(json.animationUrl),
+        mediaType: nonEmptyString(json.mediaType) ??
+            nonEmptyString(json.animationType) ??
+            nonEmptyString(json.mimeType),
+        categoryName: nonEmptyString(json.categoryName),
+    };
+}
+/** Whether a tier media value uses an immutable or browser-loadable URI form. */
+export function isSafeTierMediaUri(value) {
+    const uri = value.trim();
+    if (!uri || /\s/.test(uri))
+        return false;
+    const ipfsPath = ipfsAssetPath(uri);
+    if (ipfsPath && isIpfsCid(ipfsPath.split("/")[0]))
+        return true;
+    if (isIpfsCid(uri.split("/")[0]))
+        return true;
+    if (/^data:(image|audio|video)\/[a-z0-9.+-]+[;,]/i.test(uri))
+        return true;
+    try {
+        const url = new URL(uri);
+        return url.protocol === "https:" || url.protocol === "http:";
+    }
+    catch {
+        return false;
+    }
+}
+/** Build the canonical JSON object pinned for one tier. */
+export function buildTierMetadata(input) {
+    const name = input.name.trim();
+    if (!name)
+        throw new Error("Tier name is required.");
+    const optional = (value) => value?.trim() || undefined;
+    const image = optional(input.image);
+    const animationUrl = optional(input.animationUrl);
+    const mediaType = optional(input.mediaType);
+    if (image && !isSafeTierMediaUri(image)) {
+        throw new Error("Tier images must use IPFS, HTTP, HTTPS, or an image data URI.");
+    }
+    if (animationUrl && !isSafeTierMediaUri(animationUrl)) {
+        throw new Error("Tier animations must use IPFS, HTTP, HTTPS, or a media data URI.");
+    }
+    if (mediaType &&
+        !/^[a-z0-9!#$&^_.+-]+\/[a-z0-9!#$&^_.+-]+$/i.test(mediaType)) {
+        throw new Error("Tier media type must be a valid MIME type.");
+    }
+    return {
+        name,
+        description: optional(input.description),
+        image,
+        animation_url: animationUrl,
+        mediaType,
+        categoryName: optional(input.categoryName),
+    };
+}
+/**
+ * Route IPFS media through a caller-selected gateway base URL. Data URIs and
+ * ordinary HTTP URLs pass through unchanged.
+ */
+export function tierMediaAssetUrl(value, ipfsGatewayBaseUrl = "https://ipfs.io/ipfs/") {
+    if (typeof value !== "string" || !value)
+        return undefined;
+    if (value.startsWith("data:"))
+        return value;
+    const trimmed = value.trim();
+    const path = ipfsAssetPath(trimmed) ??
+        (isIpfsCid(trimmed.split("/")[0]) ? trimmed : null);
+    if (!path)
+        return value;
+    return `${ipfsGatewayBaseUrl.replace(/\/?$/, "/")}${path}`;
+}
+function svgDataUriMarkup(uri) {
+    const match = /^data:image\/svg\+xml([^,]*),([\s\S]*)$/.exec(uri);
+    if (!match)
+        return null;
+    try {
+        return match[1].split(";").includes("base64")
+            ? decodeBase64Utf8(match[2])
+            : decodeURIComponent(match[2]);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Return a browser-renderable tier image URL. SVG data URIs that only wrap an
+ * external `<image href>` are unwrapped because browsers block that nested
+ * network request when the SVG itself is used as an `<img>` source.
+ */
+export function tierMediaImageUrl(image, ipfsGatewayBaseUrl) {
+    if (typeof image !== "string" || !image)
+        return undefined;
+    const markup = svgDataUriMarkup(image);
+    if (markup) {
+        const href = /<image[^>]+href=["']([^"']+)["']/.exec(markup)?.[1];
+        if (href && !href.startsWith("data:")) {
+            return tierMediaAssetUrl(href, ipfsGatewayBaseUrl);
+        }
+        return image;
+    }
+    return tierMediaAssetUrl(image, ipfsGatewayBaseUrl);
+}
+/** Pick and resolve all tier metadata fields in one pass. */
+export function tierDisplayMetadata(json, ipfsGatewayBaseUrl) {
+    const metadata = pickTierMetadata(json);
+    return {
+        ...metadata,
+        image: tierMediaImageUrl(metadata.image, ipfsGatewayBaseUrl),
+        animationUrl: tierMediaAssetUrl(metadata.animationUrl, ipfsGatewayBaseUrl),
+    };
+}
+/** Stable first-seen category ids, with blank categories assigned to 0. */
+export function buildTierCategoryPlan(tiers) {
+    const categoryIds = new Map();
+    const categoryByTierId = {};
+    const storeCategories = {};
+    for (const tier of tiers) {
+        const name = tier.categoryName?.trim() || "";
+        if (!name) {
+            categoryByTierId[tier.id] = 0;
+            continue;
+        }
+        let category = categoryIds.get(name);
+        if (category === undefined) {
+            category = categoryIds.size + 1;
+            categoryIds.set(name, category);
+            storeCategories[String(category)] = name;
+        }
+        categoryByTierId[tier.id] = category;
+    }
+    return { categoryByTierId, storeCategories };
+}
 /**
  * A tier's effective (discounted) price, matching the on-chain formula in
  * JB721TiersHookStore: `price - mulDiv(price, discountPercent, 200)` with
@@ -153,7 +332,10 @@ export async function getProject721Shop(client, { chainId, projectId, isRevnet,
         hook,
         store,
         metadataIdTarget,
-        pricing: { currency: Number(pricingRaw[0]), decimals: Number(pricingRaw[1]) },
+        pricing: {
+            currency: Number(pricingRaw[0]),
+            decimals: Number(pricingRaw[1]),
+        },
         tiers,
     };
 }

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

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

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

@@ -58,6 +58,27 @@ export declare const JBPermissionIdsV6: {
  * A v6 permission id.
  */
 export type JBPermissionIdV6 = (typeof JBPermissionIdsV6)[keyof typeof JBPermissionIdsV6];
+/** A symbolic v6 permission name, such as `QUEUE_RULESETS`. */
+export type JBPermissionKeyV6 = keyof typeof JBPermissionIdsV6;
+/** Canonical permission names and ids, sorted by id. */
+export declare const JBPermissionCatalogV6: readonly {
+    key: JBPermissionKeyV6;
+    id: JBPermissionIdV6;
+}[];
+/** Return the SDK permission name for an id, or `null` for a newer/unknown id. */
+export declare function permissionKeyV6(id: number): JBPermissionKeyV6 | null;
+/**
+ * Decode `JBPermissions.permissionsOf`'s packed bitmap into ascending ids.
+ *
+ * By default only ids known to this SDK release are returned. Pass
+ * `includeUnknown: true` to preserve set bits from future permission-id
+ * releases as well.
+ */
+export declare function decodePermissionBitmap(bitmap: bigint, { includeUnknown }?: {
+    includeUnknown?: boolean;
+}): number[];
+/** Encode permission ids into the packed bitmap returned by `permissionsOf`. */
+export declare function encodePermissionBitmap(permissionIds: readonly number[]): bigint;
 /**
  * A prepared `setPermissionsFor` transaction request.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/v6/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,gBAAgB,CAAC;IAC7B,YAAY,EAAE,mBAAmB,CAAC;IAClC,IAAI,EAAE,SAAS;QACb,OAAO;QACP;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,EAAE,CAAA;SAAE;KAClE,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,aAAa,GACd,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,yBAAyB,CAQ5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,EACE,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAkB,EAClB,wBAA+B,GAChC,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GACA,OAAO,CAAC,OAAO,CAAC,CAclB"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/v6/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE7D,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE/D,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,EAAE,SAAS;IAC3C,GAAG,EAAE,iBAAiB,CAAC;IACvB,EAAE,EAAE,gBAAgB,CAAC;CACtB,EAI6B,CAAC;AAM/B,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,EAAE,cAAsB,EAAE,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5D,MAAM,EAAE,CAUV;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,CASR;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,gBAAgB,CAAC;IAC7B,YAAY,EAAE,mBAAmB,CAAC;IAClC,IAAI,EAAE,SAAS;QACb,OAAO;QACP;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,EAAE,CAAA;SAAE;KAClE,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,aAAa,GACd,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,yBAAyB,CAQ5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,EACE,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAkB,EAClB,wBAA+B,GAChC,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GACA,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/esm/v6/permissions.js

@@ -59,6 +59,46 @@ export const JBPermissionIdsV6 = {
     REALLOCATE_LOAN: 38,
     REPAY_LOAN: 39,
 };
+/** Canonical permission names and ids, sorted by id. */
+export const JBPermissionCatalogV6 = Object.entries(JBPermissionIdsV6)
+    .map(([key, id]) => ({ key, id }))
+    .sort((a, b) => a.id - b.id);
+const JB_PERMISSION_KEY_BY_ID = new Map(JBPermissionCatalogV6.map(({ key, id }) => [id, key]));
+/** Return the SDK permission name for an id, or `null` for a newer/unknown id. */
+export function permissionKeyV6(id) {
+    return JB_PERMISSION_KEY_BY_ID.get(id) ?? null;
+}
+/**
+ * Decode `JBPermissions.permissionsOf`'s packed bitmap into ascending ids.
+ *
+ * By default only ids known to this SDK release are returned. Pass
+ * `includeUnknown: true` to preserve set bits from future permission-id
+ * releases as well.
+ */
+export function decodePermissionBitmap(bitmap, { includeUnknown = false } = {}) {
+    if (bitmap < 0n)
+        throw new Error("A permission bitmap cannot be negative.");
+    const ids = [];
+    const maxId = includeUnknown
+        ? 255
+        : (JBPermissionCatalogV6[JBPermissionCatalogV6.length - 1]?.id ?? 0);
+    for (let id = 1; id <= maxId; id++) {
+        if (((bitmap >> BigInt(id)) & 1n) === 1n)
+            ids.push(id);
+    }
+    return ids;
+}
+/** Encode permission ids into the packed bitmap returned by `permissionsOf`. */
+export function encodePermissionBitmap(permissionIds) {
+    let bitmap = 0n;
+    for (const id of permissionIds) {
+        if (!Number.isInteger(id) || id < 1 || id > 255) {
+            throw new Error(`Invalid permission id: ${id}.`);
+        }
+        bitmap |= 1n << BigInt(id);
+    }
+    return bitmap;
+}
 /**
  * Build a `JBPermissions.setPermissionsFor(account, { operator, projectId,
  * permissionIds })` transaction request.

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

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/v6/permissions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;OAEG;IACH,IAAI,EAAE,CAAC;IAEP,eAAe;IACf,cAAc,EAAE,CAAC;IACjB,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,YAAY,EAAE,CAAC;IACf,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC;IAClB,YAAY,EAAE,CAAC;IACf,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,EAAE;IAChB,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,oBAAoB,EAAE,EAAE;IACxB,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,EAAE;IAClB,uBAAuB,EAAE,EAAE;IAC3B,kBAAkB,EAAE,EAAE;IACtB,cAAc,EAAE,EAAE;IAElB,mBAAmB;IACnB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,EAAE;IACpB,QAAQ,EAAE,EAAE;IACZ,wBAAwB,EAAE,EAAE;IAE5B,uBAAuB;IACvB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,EAAE;IAEpB,0BAA0B;IAC1B,mBAAmB,EAAE,EAAE;IAEvB,kBAAkB;IAClB,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,EAAE;IAClB,eAAe,EAAE,EAAE;IACnB,aAAa,EAAE,EAAE;IACjB,sBAAsB,EAAE,EAAE;IAE1B,iBAAiB;IACjB,SAAS,EAAE,EAAE;IACb,eAAe,EAAE,EAAE;IACnB,UAAU,EAAE,EAAE;CACN,CAAC;AAsBX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,aAAa,GAOd;IACC,OAAO;QACL,OAAO;QACP,OAAO,EAAE,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;QAC5C,GAAG,EAAE,gBAAgB;QACrB,YAAY,EAAE,mBAAmB;QACjC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAoB,EACpB,EACE,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,GAAG,IAAI,EAClB,wBAAwB,GAAG,IAAI,GAShC;IAED,OAAO,MAAM,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;QAC5C,GAAG,EAAE,gBAAgB;QACrB,YAAY,EAAE,gBAAgB;QAC9B,IAAI,EAAE;YACJ,QAAQ;YACR,OAAO;YACP,SAAS;YACT,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC;YACzB,WAAW;YACX,wBAAwB;SACzB;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/v6/permissions.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,178 @@
+import { type Address, type Hex } from "viem";
+import type { JBChainId } from "../types.js";
+/**
+ * Canonical JBProjectPayerDeployer address. The v6 deployment uses the same
+ * CREATE2 address on every chain supported by the SDK.
+ */
+export declare const JB_PROJECT_PAYER_DEPLOYER: Address;
+/** JBProjectPayerDeployer surface needed by web clients. */
+export declare const jbProjectPayerDeployerAbi: readonly [{
+    readonly type: "function";
+    readonly name: "deployProjectPayer";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "defaultProjectId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "defaultBeneficiary";
+        readonly type: "address";
+    }, {
+        readonly name: "defaultMemo";
+        readonly type: "string";
+    }, {
+        readonly name: "defaultMetadata";
+        readonly type: "bytes";
+    }, {
+        readonly name: "defaultAddToBalance";
+        readonly type: "bool";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "projectPayer";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "DeployProjectPayer";
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly name: "projectPayer";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "defaultProjectId";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "defaultBeneficiary";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "defaultMemo";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "defaultMetadata";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }, {
+        readonly name: "defaultAddToBalance";
+        readonly type: "bool";
+        readonly indexed: false;
+    }, {
+        readonly name: "directory";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}];
+/** Validate and normalize metadata bytes forwarded by a project payer. */
+export declare function normalizeProjectPayerMetadata(value?: string): Hex;
+/** Build a JBProjectPayerDeployer.deployProjectPayer transaction request. */
+export declare function buildDeployProjectPayerTx(args: {
+    chainId: JBChainId;
+    projectId: bigint;
+    beneficiary: Address;
+    memo?: string;
+    metadata?: string;
+    addToBalance?: boolean;
+    owner: Address;
+}): {
+    chainId: 1 | 10 | 11155111 | 11155420 | 421614 | 84532 | 42161 | 8453;
+    address: `0x${string}`;
+    abi: readonly [{
+        readonly type: "function";
+        readonly name: "deployProjectPayer";
+        readonly stateMutability: "nonpayable";
+        readonly inputs: readonly [{
+            readonly name: "defaultProjectId";
+            readonly type: "uint256";
+        }, {
+            readonly name: "defaultBeneficiary";
+            readonly type: "address";
+        }, {
+            readonly name: "defaultMemo";
+            readonly type: "string";
+        }, {
+            readonly name: "defaultMetadata";
+            readonly type: "bytes";
+        }, {
+            readonly name: "defaultAddToBalance";
+            readonly type: "bool";
+        }, {
+            readonly name: "owner";
+            readonly type: "address";
+        }];
+        readonly outputs: readonly [{
+            readonly name: "projectPayer";
+            readonly type: "address";
+        }];
+    }, {
+        readonly type: "event";
+        readonly name: "DeployProjectPayer";
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly name: "projectPayer";
+            readonly type: "address";
+            readonly indexed: true;
+        }, {
+            readonly name: "defaultProjectId";
+            readonly type: "uint256";
+            readonly indexed: false;
+        }, {
+            readonly name: "defaultBeneficiary";
+            readonly type: "address";
+            readonly indexed: false;
+        }, {
+            readonly name: "defaultMemo";
+            readonly type: "string";
+            readonly indexed: false;
+        }, {
+            readonly name: "defaultMetadata";
+            readonly type: "bytes";
+            readonly indexed: false;
+        }, {
+            readonly name: "defaultAddToBalance";
+            readonly type: "bool";
+            readonly indexed: false;
+        }, {
+            readonly name: "directory";
+            readonly type: "address";
+            readonly indexed: false;
+        }, {
+            readonly name: "owner";
+            readonly type: "address";
+            readonly indexed: false;
+        }, {
+            readonly name: "caller";
+            readonly type: "address";
+            readonly indexed: false;
+        }];
+    }];
+    functionName: "deployProjectPayer";
+    args: readonly [bigint, `0x${string}`, string, `0x${string}`, boolean, `0x${string}`];
+};
+/** Minimal receipt-log shape needed to decode a project-payer deployment. */
+export interface ProjectPayerDeployLog {
+    address: Address;
+    data: Hex;
+    topics: readonly Hex[];
+}
+/**
+ * Decode the payer address from a canonical JBProjectPayerDeployer event.
+ * Emitter verification prevents an unrelated same-signature log from being
+ * mistaken for the newly deployed payer.
+ */
+export declare function decodeDeployedProjectPayer(log: ProjectPayerDeployLog): Address | null;
+/** Return the first canonical project-payer deployment found in a receipt. */
+export declare function projectPayerFromDeployLogs(logs: readonly ProjectPayerDeployLog[]): Address | null;
+//# sourceMappingURL=projectPayers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectPayers.d.ts","sourceRoot":"","sources":["../../../src/v6/projectPayers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EACY,OAAO,CAAC;AAE1D,4DAA4D;AAC5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B5B,CAAC;AAEX,0EAA0E;AAC1E,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAMjE;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBA;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,qBAAqB,GACzB,OAAO,GAAG,IAAI,CAiBhB;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,qBAAqB,EAAE,GACrC,OAAO,GAAG,IAAI,CAMhB"}

package/dist/esm/v6/projectPayers.js

@@ -0,0 +1,101 @@
+import { decodeEventLog, isAddressEqual } from "viem";
+/**
+ * Canonical JBProjectPayerDeployer address. The v6 deployment uses the same
+ * CREATE2 address on every chain supported by the SDK.
+ */
+export const JB_PROJECT_PAYER_DEPLOYER = "0x7321740fd0dcf73dd3e2aa8fc060454abfce9517";
+/** JBProjectPayerDeployer surface needed by web clients. */
+export const jbProjectPayerDeployerAbi = [
+    {
+        type: "function",
+        name: "deployProjectPayer",
+        stateMutability: "nonpayable",
+        inputs: [
+            { name: "defaultProjectId", type: "uint256" },
+            { name: "defaultBeneficiary", type: "address" },
+            { name: "defaultMemo", type: "string" },
+            { name: "defaultMetadata", type: "bytes" },
+            { name: "defaultAddToBalance", type: "bool" },
+            { name: "owner", type: "address" },
+        ],
+        outputs: [{ name: "projectPayer", type: "address" }],
+    },
+    {
+        type: "event",
+        name: "DeployProjectPayer",
+        anonymous: false,
+        inputs: [
+            { name: "projectPayer", type: "address", indexed: true },
+            { name: "defaultProjectId", type: "uint256", indexed: false },
+            { name: "defaultBeneficiary", type: "address", indexed: false },
+            { name: "defaultMemo", type: "string", indexed: false },
+            { name: "defaultMetadata", type: "bytes", indexed: false },
+            { name: "defaultAddToBalance", type: "bool", indexed: false },
+            { name: "directory", type: "address", indexed: false },
+            { name: "owner", type: "address", indexed: false },
+            { name: "caller", type: "address", indexed: false },
+        ],
+    },
+];
+/** Validate and normalize metadata bytes forwarded by a project payer. */
+export function normalizeProjectPayerMetadata(value) {
+    const metadata = value?.trim() || "0x";
+    if (!/^0x(?:[0-9a-fA-F]{2})*$/.test(metadata)) {
+        throw new Error("Project payer metadata must be whole hex bytes.");
+    }
+    return metadata;
+}
+/** Build a JBProjectPayerDeployer.deployProjectPayer transaction request. */
+export function buildDeployProjectPayerTx(args) {
+    if (args.projectId <= 0n) {
+        throw new Error("A project payer requires a positive project ID.");
+    }
+    return {
+        chainId: args.chainId,
+        address: JB_PROJECT_PAYER_DEPLOYER,
+        abi: jbProjectPayerDeployerAbi,
+        functionName: "deployProjectPayer",
+        args: [
+            args.projectId,
+            args.beneficiary,
+            args.memo ?? "",
+            normalizeProjectPayerMetadata(args.metadata),
+            args.addToBalance ?? false,
+            args.owner,
+        ],
+    };
+}
+/**
+ * Decode the payer address from a canonical JBProjectPayerDeployer event.
+ * Emitter verification prevents an unrelated same-signature log from being
+ * mistaken for the newly deployed payer.
+ */
+export function decodeDeployedProjectPayer(log) {
+    if (!isAddressEqual(log.address, JB_PROJECT_PAYER_DEPLOYER))
+        return null;
+    try {
+        const decoded = decodeEventLog({
+            abi: jbProjectPayerDeployerAbi,
+            eventName: "DeployProjectPayer",
+            data: log.data,
+            topics: log.topics,
+            strict: true,
+        });
+        return decoded.eventName === "DeployProjectPayer"
+            ? decoded.args.projectPayer
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Return the first canonical project-payer deployment found in a receipt. */
+export function projectPayerFromDeployLogs(logs) {
+    for (const log of logs) {
+        const payer = decodeDeployedProjectPayer(log);
+        if (payer)
+            return payer;
+    }
+    return null;
+}
+//# sourceMappingURL=projectPayers.js.map

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

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

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

@@ -50,8 +50,9 @@ export type REVCroptopAllowedPost = RevDeployArgs6[5][number];
  *   issuance), out of 1e9; the group must total exactly 1e9 — use
  *   `fillSplitPercents`.
  * - `initialIssuance`: tokens minted per unit of base currency, 18-decimal
- *   fixed point (uint112). The sentinel 1n means "inherit the previous
- *   stage's issuance with its cuts applied".
+ *   fixed point (uint112). The exported `RULESET_WEIGHT_INHERIT` sentinel
+ *   (1n) means "inherit the previous stage's issuance with its cuts applied";
+ *   zero means genuine zero issuance.
  * - `issuanceCutFrequency`: seconds between issuance cuts (should be >= 1
  *   day; it becomes the stage's ruleset duration).
  * - `issuanceCutPercent`: how much issuance drops each period, out of 1e9