@bananapus/nana-sdk-core 1.0.0

package/dist/cjs/utils/token.js

@@ -0,0 +1,129 @@
+import { FixedInt } from "fpnum";
+import { parseUnits } from "viem";
+import { ONE_ETHER, MAX_CASH_OUT_TAX_RATE, MAX_RESERVED_PERCENT, } from "../constants.js";
+/**
+ * Return a quote for how much Token B to mint for a given `tokenAAmount`.
+ *
+ * Useful for when users specify how much they want to spend (Token A).
+ *
+ * Accounts for the ruleset's `weight` and `reservedPercent`.
+ *
+ * Returned quote contains:
+ * - total tokens to be minted (JB ruleset `weight`).
+ * - tokens reserved for project.
+ * - tokens minted for the payer.
+ */
+export const getTokenAToBQuote = (tokenAAmount, // wei
+cycleParams) => {
+    const { weight, reservedPercent } = cycleParams;
+    const weightRatio = BigInt(10 ** tokenAAmount.decimals);
+    const totalTokens = (weight.value * tokenAAmount.value) / weightRatio;
+    const reservedTokens = (weight.value * reservedPercent.value * tokenAAmount.value) /
+        BigInt(MAX_RESERVED_PERCENT) /
+        weightRatio;
+    const payerTokens = totalTokens - reservedTokens;
+    return {
+        tokenAAmount,
+        payerTokens,
+        reservedTokens,
+        totalTokens,
+    };
+};
+/**
+ * Return the amount of Token A it costs to buy 1 Token B.
+ *
+ * Accounts for the ruleset's `weight` and `reservedPercent`.
+ */
+export const getTokenBPrice = (tokenADecimals, cycleParams) => {
+    const oneTokenA = FixedInt.parse("1", tokenADecimals);
+    const weightRatio = BigInt(10 ** tokenADecimals);
+    // 1 Token A = x Token B
+    const tokenBQuote = getTokenAToBQuote(oneTokenA, cycleParams);
+    if (tokenBQuote.payerTokens === 0n)
+        return new FixedInt(0n, tokenADecimals);
+    const tokenBPrice = (ONE_ETHER * weightRatio) / tokenBQuote.payerTokens;
+    return new FixedInt(tokenBPrice, tokenADecimals);
+};
+/**
+ * Return the amount of Token A it costs to mint a given `tokenBAmount`.
+ *
+ * Accounts for the ruleset's `weight` and `reservedPercent`.
+ *
+ * Useful for when users specify the outcome they want (how much Token B they want).
+ */
+export const getTokenBtoAQuote = (tokenBAmount, // wei
+tokenADecimals, cycleParams) => {
+    const tokenBPrice = getTokenBPrice(tokenADecimals, cycleParams);
+    const oneTokenA = parseUnits("1", tokenADecimals);
+    const tokenAQuote = (tokenBPrice.value * tokenBAmount.value) / oneTokenA;
+    return new FixedInt(tokenAQuote, tokenADecimals);
+};
+/**
+ * Returns the ETH value (in wei) that a given [tokensAmount] can be redeemed for.
+ *
+ * @note Implements the formula:
+ * ```
+ * y = ox/s * ( (1 - r) + (x * r /s) )
+ * ```
+ *
+ * Where:
+ * - `y` = redeemable amount
+ * - `o` = overflow (primaryTerminalCurrentOverflow)
+ * - `x` = tokenAmount
+ * - `s` = total supply of token (realTotalTokenSupply)
+ * - `r` = cashOutTaxRate
+ *
+ * @implements JBCashOuts.cashOutFrom
+ * @see https://github.com/Bananapus/nana-core/blob/44ae030f910e4a40a9a70a1eccf67cb0cf0c80f9/src/libraries/JBCashOuts.sol
+ * @see https://www.desmos.com/calculator/sp9ru6zbpk
+ * @returns amount in ETH
+ */
+export const getTokenCashOutQuoteEth = (tokensAmount, { overflowWei, // surplus
+totalSupply, cashOutTaxRate, tokensReserved, }) => {
+    // alias names, to match the contract's implementation for easier manual comparison.
+    const surplus = overflowWei;
+    const cashOutCount = tokensAmount;
+    // If the cash out tax rate is the max, no surplus can be reclaimed.
+    if (cashOutTaxRate === MAX_CASH_OUT_TAX_RATE) {
+        return 0;
+    }
+    // If the total supply is being cashed out, return the entire surplus.
+    if (cashOutCount >= totalSupply) {
+        return surplus;
+    }
+    //
+    /**
+     * totalOutstandingTokensOf in contract.
+     * @note this deviates from the contract's `cashOutFrom` implementation.
+     */
+    const realTotalSupply = totalSupply + tokensReserved;
+    /**
+     * Get a reference to the linear proportion.
+     * ```
+     * base = ox/s
+     * ```
+     */
+    const base = (surplus * cashOutCount) / realTotalSupply;
+    /**
+     * These conditions are all part of the same curve.
+     * Edge conditions are separated to minimize the operations performed in those cases.
+     */
+    if (cashOutTaxRate === 0) {
+        return base;
+    }
+    const frac = (BigInt(cashOutTaxRate) * cashOutCount) / realTotalSupply;
+    /**
+     * ```
+     * numerator = (1 - r) + (x * r / s)
+     * ```
+     */
+    const numerator = BigInt(MAX_CASH_OUT_TAX_RATE - cashOutTaxRate) + frac;
+    /**
+     * ```
+     * y = base * numerator ==> ox/s * ( (1 - r) + (x * r / s) )
+     * ```
+     */
+    const y = (base * numerator) / BigInt(MAX_CASH_OUT_TAX_RATE);
+    return y;
+};
+//# sourceMappingURL=token.js.map

package/dist/cjs/utils/token.js.map

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

package/dist/cjs/utils/token.test.d.ts

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

package/dist/cjs/utils/token.test.d.ts.map

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

package/dist/cjs/utils/token.test.js

@@ -0,0 +1,38 @@
+import { FixedInt } from "fpnum";
+import { parseEther, parseUnits } from "viem";
+import { describe, expect, test } from "vitest";
+import { ReservedPercent } from "./data.js";
+import { getTokenAToBQuote, getTokenBPrice } from "./token.js";
+describe("token", () => {
+    describe("getTokenAToBQuote", () => {
+        test.each `
+      tokenAAmount       | tokenADecimals | expectedPayerTokens
+      ${1000000n}        | ${6}           | ${parseUnits("1", 18)}
+      ${parseEther("1")} | ${18}          | ${parseUnits("1", 18)}
+    `("should return the correct token B quote when amount is $tokenAAmount and decimals is $tokenADecimals", ({ tokenAAmount, tokenADecimals, expectedPayerTokens }) => {
+            const weight = FixedInt.parse("1", 18); // 1 token per USDC
+            const reservedPercent = new ReservedPercent(0);
+            const { payerTokens } = getTokenAToBQuote(new FixedInt(tokenAAmount, tokenADecimals), {
+                weight,
+                reservedPercent,
+            });
+            expect(payerTokens).toEqual(expectedPayerTokens);
+        });
+        test.each `
+      tokenADecimals | weight                       | expectedTokenBPrice
+      ${18}          | ${FixedInt.parse("1", 18)}   | ${parseUnits("1", 18)}
+      ${6}           | ${FixedInt.parse("1", 18)}   | ${parseUnits("1", 6)}
+      ${18}          | ${FixedInt.parse("0.5", 18)} | ${parseUnits("2", 18)}
+      ${6}           | ${FixedInt.parse("0.5", 18)} | ${parseUnits("2", 6)}
+      ${6}           | ${FixedInt.parse("0.8", 18)} | ${parseUnits("1.25", 6)}
+    `("should return the correct token A quote when amount is $tokenBAmount and decimals is $tokenADecimals", ({ tokenADecimals, expectedTokenBPrice, weight }) => {
+            const reservedPercent = new ReservedPercent(0);
+            const tokenBPrice = getTokenBPrice(tokenADecimals, {
+                weight,
+                reservedPercent,
+            });
+            expect(tokenBPrice.value).toBe(expectedTokenBPrice);
+        });
+    });
+});
+//# sourceMappingURL=token.test.js.map

package/dist/cjs/utils/token.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.test.js","sourceRoot":"","sources":["../../../src/utils/token.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,IAAI,CAAC,IAAI,CAAA;;QAEL,QAAQ,aAAa,CAAC,gBAAgB,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;QACzD,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;KAC5D,CACC,sGAAsG,EACtG,CAAC,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAK,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB;YAC/D,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,EAAE,WAAW,EAAE,GAAG,iBAAiB,CACvC,IAAI,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,EAC1C;gBACE,MAAM;gBACN,eAAe;aAChB,CACF,CAAC;YACF,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACnD,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,IAAI,CAAA;;QAEL,EAAE,eAAe,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;QACnE,CAAC,gBAAgB,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;QAClE,EAAE,eAAe,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;QACnE,CAAC,gBAAgB,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;QAClE,CAAC,gBAAgB,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;KACxE,CACC,sGAAsG,EACtG,CAAC,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAE,EAAE;YAClD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,WAAW,GAAG,cAAc,CAAC,cAAc,EAAE;gBACjD,MAAM;gBACN,eAAe;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACtD,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cjs/utils/tx.d.ts

@@ -0,0 +1,2 @@
+export declare function createSalt(): `0x${string}`;
+//# sourceMappingURL=tx.d.ts.map

package/dist/cjs/utils/tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../../src/utils/tx.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,kBAKzB"}

package/dist/cjs/utils/tx.js

@@ -0,0 +1,7 @@
+import { toBytes, toHex } from "viem";
+export function createSalt() {
+    const base = "0x" + Math.random().toString(16).slice(2); // idk lol
+    const salt = toHex(toBytes(base, { size: 32 }));
+    return salt;
+}
+//# sourceMappingURL=tx.js.map

package/dist/cjs/utils/tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.js","sourceRoot":"","sources":["../../../src/utils/tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAEtC,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAW,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;IAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEhD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cjs/utils/urn.d.ts

@@ -0,0 +1,8 @@
+import { JBChainId, JBVersion } from "../types.js";
+export declare function jbUrn(urn: string): {
+    chainId: JBChainId;
+    projectId: bigint;
+    version: JBVersion;
+} | null;
+export declare function toJbUrn(chainId: JBChainId, projectId: bigint): string | null;
+//# sourceMappingURL=urn.d.ts.map

package/dist/cjs/utils/urn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urn.d.ts","sourceRoot":"","sources":["../../../src/utils/urn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;CACpB,GAAG,IAAI,CAiCP;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5E"}

package/dist/cjs/utils/urn.js

@@ -0,0 +1,47 @@
+import { JB_CHAIN_SLUGS } from "../constants.js";
+export function jbUrn(urn) {
+    try {
+        const urlParts = urn.split(":").map((part) => part.trim());
+        if (urlParts.length < 2 || urlParts.length > 3)
+            return null;
+        let chainSlug;
+        let version;
+        let projectId;
+        if (urlParts.length === 2) {
+            // default to v4 [/eth:3]
+            version = 4;
+            chainSlug = urlParts[0];
+            projectId = urlParts[1];
+        }
+        else {
+            // with version [/v5:eth:3]
+            if (!urlParts[0].startsWith("v"))
+                return null;
+            version = Number(urlParts[0].replace("v", ""));
+            chainSlug = urlParts[1];
+            projectId = urlParts[2];
+        }
+        const chain = JB_CHAIN_SLUGS[chainSlug];
+        if (!chain || !projectId || !isValidVersion(version))
+            return null;
+        return {
+            chainId: chain.chain.id,
+            projectId: BigInt(projectId),
+            version,
+        };
+    }
+    catch (e) {
+        return null;
+    }
+}
+export function toJbUrn(chainId, projectId) {
+    const chain = Object.values(JB_CHAIN_SLUGS).find((chain) => chain.chain.id === chainId);
+    if (!chain) {
+        return null;
+    }
+    return `${chain.slug}:${projectId}`;
+}
+function isValidVersion(version) {
+    return version === 4 || version === 5 || version === 6;
+}
+//# sourceMappingURL=urn.js.map

package/dist/cjs/utils/urn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urn.js","sourceRoot":"","sources":["../../../src/utils/urn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,KAAK,CAAC,GAAW;IAK/B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5D,IAAI,SAA6B,CAAC;QAClC,IAAI,OAA2B,CAAC;QAChC,IAAI,SAA6B,CAAC;QAElC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,yBAAyB;YACzB,OAAO,GAAG,CAAC,CAAC;YACZ,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxB,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9C,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/C,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxB,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAElE,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAe;YACpC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;YAC5B,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAkB,EAAE,SAAiB;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAC9C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CACtC,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/cjs/utils/urn.test.d.ts

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

package/dist/cjs/utils/urn.test.d.ts.map

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

package/dist/cjs/utils/urn.test.js

@@ -0,0 +1,112 @@
+import { arbitrum, base, mainnet, optimism, sepolia } from "viem/chains";
+import { describe, expect, it } from "vitest";
+import { jbUrn } from "./urn.js";
+describe("jbUrn", () => {
+    describe("valid URNs", () => {
+        it("should parse /eth:3 as mainnet project id 3, version 4", () => {
+            const result = jbUrn("eth:3");
+            expect(result).toEqual({
+                chainId: mainnet.id,
+                projectId: 3n,
+                version: 4,
+            });
+        });
+        it("should parse /v5:eth:5 as mainnet project id 5, version 5", () => {
+            const result = jbUrn("v5:eth:5");
+            expect(result).toEqual({
+                chainId: mainnet.id,
+                projectId: 5n,
+                version: 5,
+            });
+        });
+        it("should parse large project IDs correctly", () => {
+            const result = jbUrn("eth:999999999999999999");
+            expect(result).toEqual({
+                chainId: mainnet.id,
+                projectId: 999999999999999999n,
+                version: 4,
+            });
+        });
+    });
+    describe("supported chains", () => {
+        const chainTests = [
+            { slug: "eth", chainId: mainnet.id, name: "Ethereum mainnet" },
+            { slug: "sep", chainId: sepolia.id, name: "Sepolia testnet" },
+            { slug: "op", chainId: optimism.id, name: "Optimism" },
+            { slug: "base", chainId: base.id, name: "Base" },
+            { slug: "arb", chainId: arbitrum.id, name: "Arbitrum" },
+        ];
+        chainTests.forEach(({ slug, chainId, name }) => {
+            it(`should parse ${name} (${slug}) correctly`, () => {
+                const result = jbUrn(`${slug}:42`);
+                expect(result).toEqual({ chainId, projectId: 42n, version: 4 });
+            });
+        });
+    });
+    describe("version validation", () => {
+        it("should accept versions 4, 5 and 6, default to 4", () => {
+            expect(jbUrn("v4:eth:1")?.version).toBe(4);
+            expect(jbUrn("v5:eth:1")?.version).toBe(5);
+            expect(jbUrn("v6:eth:1")?.version).toBe(6);
+            expect(jbUrn("eth:1")?.version).toBe(4); // default
+        });
+        it("should reject invalid versions", () => {
+            expect(jbUrn("v1:eth:3")).toBeNull();
+            expect(jbUrn("v7:eth:3")).toBeNull();
+            expect(jbUrn("v0:eth:3")).toBeNull();
+        });
+    });
+    describe("invalid URNs", () => {
+        it("should return null for invalid version format", () => {
+            expect(jbUrn("version5:eth:3")).toBeNull();
+            expect(jbUrn("5:eth:3")).toBeNull();
+            expect(jbUrn("V5:eth:3")).toBeNull();
+            expect(jbUrn("v5a:eth:3")).toBeNull();
+        });
+        it("should return null for unknown chain names", () => {
+            expect(jbUrn("bitcoin:3")).toBeNull();
+            expect(jbUrn("ethereum:3")).toBeNull();
+            expect(jbUrn("ETH:3")).toBeNull();
+        });
+        it("should return null for malformed URLs", () => {
+            expect(jbUrn("")).toBeNull();
+            expect(jbUrn("eth:")).toBeNull();
+            expect(jbUrn(":3")).toBeNull();
+            expect(jbUrn("v5:eth:3:extra")).toBeNull();
+            expect(jbUrn("eth")).toBeNull();
+        });
+        it("should handle invalid project IDs", () => {
+            expect(jbUrn("eth:abc")).toBeNull();
+            expect(jbUrn("eth:3.14")).toBeNull();
+            // 0x123 = 291
+            expect(jbUrn("eth:0x123")).toEqual({
+                chainId: mainnet.id,
+                projectId: 291n,
+                version: 4,
+            });
+        });
+    });
+    describe("edge cases", () => {
+        it("should handle whitespace by trimming", () => {
+            expect(jbUrn(" eth:3")).toEqual({
+                chainId: mainnet.id,
+                projectId: 3n,
+                version: 4,
+            });
+            expect(jbUrn("v5: eth : 3 ")).toEqual({
+                chainId: mainnet.id,
+                projectId: 3n,
+                version: 5,
+            });
+        });
+        it("should handle numeric edge cases", () => {
+            expect(jbUrn("eth:0003")?.projectId).toBe(3n);
+            expect(jbUrn("eth:0")?.projectId).toBe(0n);
+        });
+        it("should reject invalid formats", () => {
+            expect(jbUrn("eth-test:3")).toBeNull();
+            expect(jbUrn("a".repeat(1000) + ":1")).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=urn.test.js.map

package/dist/cjs/utils/urn.test.js.map

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

package/dist/esm/actions/JBSuckerAbi.d.ts

@@ -0,0 +1,32 @@
+export declare const JBSuckerAbi: readonly [{
+    readonly type: "function";
+    readonly name: "peer";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IJBSucker";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "projectId";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "peerChainId";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];
+//# sourceMappingURL=JBSuckerAbi.d.ts.map

package/dist/esm/actions/JBSuckerAbi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JBSuckerAbi.d.ts","sourceRoot":"","sources":["../../../src/actions/JBSuckerAbi.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwCd,CAAC"}

package/dist/esm/actions/JBSuckerAbi.js

@@ -0,0 +1,42 @@
+export const JBSuckerAbi = [
+    {
+        type: "function",
+        name: "peer",
+        inputs: [],
+        outputs: [
+            {
+                name: "",
+                type: "address",
+                internalType: "contract IJBSucker",
+            },
+        ],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "projectId",
+        inputs: [],
+        outputs: [
+            {
+                name: "",
+                type: "uint256",
+                internalType: "uint256",
+            },
+        ],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "peerChainId",
+        inputs: [],
+        outputs: [
+            {
+                name: "",
+                type: "uint256",
+                internalType: "uint256",
+            },
+        ],
+        stateMutability: "view",
+    },
+];
+//# sourceMappingURL=JBSuckerAbi.js.map

package/dist/esm/actions/JBSuckerAbi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JBSuckerAbi.js","sourceRoot":"","sources":["../../../src/actions/JBSuckerAbi.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,EAAE;QACV,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,oBAAoB;aACnC;SACF;QACD,eAAe,EAAE,MAAM;KACxB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,SAAS;aACxB;SACF;QACD,eAAe,EAAE,MAAM;KACxB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,SAAS;aACxB;SACF;QACD,eAAe,EAAE,MAAM;KACxB;CACO,CAAC"}

package/dist/esm/actions/dataHook.d.ts

@@ -0,0 +1,29 @@
+import { JBVersion } from "../types.js";
+import { Address, PublicClient } from "viem";
+/**
+ * Find the 721 data hook for a given project and ruleset.
+ *
+ * NOTE this is an expensive call. Best to run it server-side and cache it.
+ */
+export declare function find721DataHook(publicClient: PublicClient, args: {
+    dataHookAddress: Address;
+    projectId: bigint;
+    rulesetId: number;
+    version: JBVersion;
+}): Promise<`0x${string}` | null>;
+export declare function getHookSpecifications(publicClient: PublicClient, args: {
+    dataHookAddress: Address;
+    projectId: bigint;
+    rulesetId: number;
+    version: JBVersion;
+}): Promise<readonly {
+    hook: `0x${string}`;
+    noop: boolean;
+    amount: bigint;
+    metadata: `0x${string}`;
+}[] | readonly {
+    hook: `0x${string}`;
+    amount: bigint;
+    metadata: `0x${string}`;
+}[]>;
+//# sourceMappingURL=dataHook.d.ts.map

package/dist/esm/actions/dataHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataHook.d.ts","sourceRoot":"","sources":["../../../src/actions/dataHook.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnG,OAAO,EAAE,OAAO,EAAE,YAAY,EAA4C,MAAM,MAAM,CAAC;AAQvF;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE;IACJ,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;CACpB,iCA4DF;AAED,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE;IACJ,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;CACpB;;;;;;;;;KAgCF"}

package/dist/esm/actions/dataHook.js

@@ -0,0 +1,81 @@
+import { JB721HookContracts, JBAddressRegistryContracts } from "../types.js";
+import { getJBContractAddress } from "../utils/contracts.js";
+import { getContract, isAddressEqual, zeroAddress } from "viem";
+import { jb721TiersHookAbi, jb721TiersHookV5Abi, jbAddressRegistryAbi, } from "../generated/juicebox.js";
+import { debug } from "../utils/debug.js";
+/**
+ * Find the 721 data hook for a given project and ruleset.
+ *
+ * NOTE this is an expensive call. Best to run it server-side and cache it.
+ */
+export async function find721DataHook(publicClient, args) {
+    const chainId = publicClient.chain?.id;
+    if (!chainId) {
+        throw new Error("[@bananapus/nana-sdk-core] No chain ID on public client.");
+    }
+    const deployerAddress = getJBContractAddress(JB721HookContracts.JB721TiersHookDeployer, args.version, chainId);
+    const registerAddress = getJBContractAddress(JBAddressRegistryContracts.JBAddressRegistry, args.version, chainId);
+    if (!registerAddress) {
+        throw new Error(`[@bananapus/nana-sdk-core] No JBAddressRegistry address for chain ${chainId}.`);
+    }
+    const registry = getContract({
+        address: registerAddress,
+        abi: jbAddressRegistryAbi,
+        client: publicClient,
+    });
+    debug("🧃 getHookSpecifications::args", {
+        dataHookAddress: args.dataHookAddress,
+        projectId: args.projectId,
+        rulesetId: args.rulesetId,
+    });
+    const hookSpecs = await getHookSpecifications(publicClient, {
+        dataHookAddress: args.dataHookAddress,
+        projectId: args.projectId,
+        rulesetId: args.rulesetId,
+        version: args.version,
+    });
+    const res = await Promise.all(hookSpecs.map(async (h) => {
+        const deployerOf = await registry.read.deployerOf([h.hook]);
+        debug("🧃 deployerOf", {
+            hook: h.hook,
+            deployerOf,
+            deployerAddress,
+        });
+        return isAddressEqual(deployerOf, deployerAddress);
+    }));
+    const index = res.findIndex((r) => r);
+    if (index === -1) {
+        return null;
+    }
+    return hookSpecs[index].hook;
+}
+export async function getHookSpecifications(publicClient, args) {
+    // v6's returned JBPayHookSpecification gained a `noop` field, so the v4/v5 response
+    // doesn't decode with the v6 ABI.
+    const dataHook = getContract({
+        address: args.dataHookAddress,
+        abi: args.version === 6 ? jb721TiersHookAbi : jb721TiersHookV5Abi,
+        client: publicClient,
+    });
+    const [_, hookSpecifications] = await dataHook.read.beforePayRecordedWith([
+        {
+            projectId: args.projectId,
+            rulesetId: BigInt(args.rulesetId), // TODO update the ABI to be a number, will fix this.
+            terminal: zeroAddress,
+            beneficiary: zeroAddress,
+            amount: {
+                token: zeroAddress,
+                value: 0n,
+                decimals: 0,
+                currency: 0,
+            },
+            payer: zeroAddress,
+            weight: 0n,
+            reservedPercent: 0n,
+            metadata: zeroAddress,
+        },
+    ]);
+    debug("🧃 getHookSpecifications", { args, hookSpecifications });
+    return hookSpecifications;
+}
+//# sourceMappingURL=dataHook.js.map

package/dist/esm/actions/dataHook.js.map

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

package/dist/esm/actions/projectMetadata.d.ts

@@ -0,0 +1,16 @@
+import { Address, PublicClient } from "viem";
+import { JBProjectMetadata } from "../types.js";
+/**
+ * Fetch the project metadata for the given [projectId]
+ * @param publicClient - The Viem Public Client to use for fetching on-chain data.
+ * @link https://viem.sh/docs/clients/public.html
+ * @param opts.ipfsGatewayHostname - The hostname of the IPFS gateway to use. Defaults to "ipfs.io"
+ *
+ */
+export declare const getProjectMetadata: (publicClient: PublicClient, args: {
+    jbControllerAddress: Address;
+    projectId: bigint;
+}, opts?: {
+    ipfsGatewayHostname?: string;
+}) => Promise<JBProjectMetadata | undefined>;
+//# sourceMappingURL=projectMetadata.d.ts.map

package/dist/esm/actions/projectMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectMetadata.d.ts","sourceRoot":"","sources":["../../../src/actions/projectMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,YAAY,EAIb,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA+BhD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,YAAY,EAC1B,MAAM;IACJ,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,OAAO;IACL,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,KACA,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAWvC,CAAC"}