@bananapus/nana-sdk-core 1.0.0

package/dist/esm/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/esm/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/esm/utils/token.test.d.ts

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

package/dist/esm/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/esm/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/esm/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/esm/utils/tx.d.ts

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

package/dist/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/utils/urn.test.d.ts

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

package/dist/esm/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/esm/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/esm/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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"}