@bananapus/nana-sdk-core 1.0.0 → 1.1.1

package/dist/cjs/utils/urn.js

@@ -1,5 +1,9 @@
-import { JB_CHAIN_SLUGS } from "../constants.js";
-export function jbUrn(urn) {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jbUrn = jbUrn;
+exports.toJbUrn = toJbUrn;
+const constants_js_1 = require("../constants.js");
+function jbUrn(urn) {
     try {
         const urlParts = urn.split(":").map((part) => part.trim());
         if (urlParts.length < 2 || urlParts.length > 3)
@@ -21,7 +25,7 @@ export function jbUrn(urn) {
             chainSlug = urlParts[1];
             projectId = urlParts[2];
         }
-        const chain = JB_CHAIN_SLUGS[chainSlug];
+        const chain = constants_js_1.JB_CHAIN_SLUGS[chainSlug];
         if (!chain || !projectId || !isValidVersion(version))
             return null;
         return {
@@ -34,8 +38,8 @@ export function jbUrn(urn) {
         return null;
     }
 }
-export function toJbUrn(chainId, projectId) {
-    const chain = Object.values(JB_CHAIN_SLUGS).find((chain) => chain.chain.id === chainId);
+function toJbUrn(chainId, projectId) {
+    const chain = Object.values(constants_js_1.JB_CHAIN_SLUGS).find((chain) => chain.chain.id === chainId);
     if (!chain) {
         return null;
     }

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

@@ -1 +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"}
+{"version":3,"file":"urn.js","sourceRoot":"","sources":["../../../src/utils/urn.ts"],"names":[],"mappings":";;AAGA,sBAqCC;AAED,0BASC;AAnDD,kDAAiD;AAGjD,SAAgB,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,6BAAc,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,SAAgB,OAAO,CAAC,OAAkB,EAAE,SAAiB;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,6BAAc,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.js

@@ -1,111 +1,113 @@
-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,
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chains_1 = require("viem/chains");
+const vitest_1 = require("vitest");
+const urn_js_1 = require("./urn.js");
+(0, vitest_1.describe)("jbUrn", () => {
+    (0, vitest_1.describe)("valid URNs", () => {
+        (0, vitest_1.it)("should parse /eth:3 as mainnet project id 3, version 4", () => {
+            const result = (0, urn_js_1.jbUrn)("eth:3");
+            (0, vitest_1.expect)(result).toEqual({
+                chainId: chains_1.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,
+        (0, vitest_1.it)("should parse /v5:eth:5 as mainnet project id 5, version 5", () => {
+            const result = (0, urn_js_1.jbUrn)("v5:eth:5");
+            (0, vitest_1.expect)(result).toEqual({
+                chainId: chains_1.mainnet.id,
                 projectId: 5n,
                 version: 5,
             });
         });
-        it("should parse large project IDs correctly", () => {
-            const result = jbUrn("eth:999999999999999999");
-            expect(result).toEqual({
-                chainId: mainnet.id,
+        (0, vitest_1.it)("should parse large project IDs correctly", () => {
+            const result = (0, urn_js_1.jbUrn)("eth:999999999999999999");
+            (0, vitest_1.expect)(result).toEqual({
+                chainId: chains_1.mainnet.id,
                 projectId: 999999999999999999n,
                 version: 4,
             });
         });
     });
-    describe("supported chains", () => {
+    (0, vitest_1.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" },
+            { slug: "eth", chainId: chains_1.mainnet.id, name: "Ethereum mainnet" },
+            { slug: "sep", chainId: chains_1.sepolia.id, name: "Sepolia testnet" },
+            { slug: "op", chainId: chains_1.optimism.id, name: "Optimism" },
+            { slug: "base", chainId: chains_1.base.id, name: "Base" },
+            { slug: "arb", chainId: chains_1.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 });
+            (0, vitest_1.it)(`should parse ${name} (${slug}) correctly`, () => {
+                const result = (0, urn_js_1.jbUrn)(`${slug}:42`);
+                (0, vitest_1.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
+    (0, vitest_1.describe)("version validation", () => {
+        (0, vitest_1.it)("should accept versions 4, 5 and 6, default to 4", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("v4:eth:1")?.version).toBe(4);
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("v5:eth:1")?.version).toBe(5);
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("v6:eth:1")?.version).toBe(6);
+            (0, vitest_1.expect)((0, urn_js_1.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();
+        (0, vitest_1.it)("should reject invalid versions", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("v1:eth:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("v7:eth:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.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();
+    (0, vitest_1.describe)("invalid URNs", () => {
+        (0, vitest_1.it)("should return null for invalid version format", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("version5:eth:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("5:eth:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("V5:eth:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.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();
+        (0, vitest_1.it)("should return null for unknown chain names", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("bitcoin:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("ethereum:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.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();
+        (0, vitest_1.it)("should return null for malformed URLs", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth:")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)(":3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("v5:eth:3:extra")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth")).toBeNull();
         });
-        it("should handle invalid project IDs", () => {
-            expect(jbUrn("eth:abc")).toBeNull();
-            expect(jbUrn("eth:3.14")).toBeNull();
+        (0, vitest_1.it)("should handle invalid project IDs", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth:abc")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth:3.14")).toBeNull();
             // 0x123 = 291
-            expect(jbUrn("eth:0x123")).toEqual({
-                chainId: mainnet.id,
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth:0x123")).toEqual({
+                chainId: chains_1.mainnet.id,
                 projectId: 291n,
                 version: 4,
             });
         });
     });
-    describe("edge cases", () => {
-        it("should handle whitespace by trimming", () => {
-            expect(jbUrn(" eth:3")).toEqual({
-                chainId: mainnet.id,
+    (0, vitest_1.describe)("edge cases", () => {
+        (0, vitest_1.it)("should handle whitespace by trimming", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)(" eth:3")).toEqual({
+                chainId: chains_1.mainnet.id,
                 projectId: 3n,
                 version: 4,
             });
-            expect(jbUrn("v5: eth : 3 ")).toEqual({
-                chainId: mainnet.id,
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("v5: eth : 3 ")).toEqual({
+                chainId: chains_1.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);
+        (0, vitest_1.it)("should handle numeric edge cases", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth:0003")?.projectId).toBe(3n);
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth:0")?.projectId).toBe(0n);
         });
-        it("should reject invalid formats", () => {
-            expect(jbUrn("eth-test:3")).toBeNull();
-            expect(jbUrn("a".repeat(1000) + ":1")).toBeNull();
+        (0, vitest_1.it)("should reject invalid formats", () => {
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("eth-test:3")).toBeNull();
+            (0, vitest_1.expect)((0, urn_js_1.jbUrn)("a".repeat(1000) + ":1")).toBeNull();
         });
     });
 });

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

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

package/dist/cjs/v6/cashOut.d.ts

@@ -0,0 +1,88 @@
+import { Address, Hex, PublicClient } from "viem";
+import { jbMultiTerminalAbi } from "../generated/juicebox.js";
+import { JBChainId } from "../types.js";
+/**
+ * A prepared `cashOutTokensOf` transaction request, accepted as-is by viem's
+ * `walletClient.writeContract` and wagmi's `writeContract`.
+ */
+export interface V6CashOutTxRequest {
+    chainId: JBChainId;
+    address: Address;
+    abi: typeof jbMultiTerminalAbi;
+    functionName: "cashOutTokensOf";
+    args: readonly [Address, bigint, bigint, Address, bigint, Address, Hex];
+}
+/**
+ * Build a `cashOutTokensOf(holder, projectId, cashOutCount, tokenToReclaim,
+ * minTokensReclaimed, beneficiary, metadata)` transaction request for a v6 terminal.
+ *
+ * @param args.chainId The chain to cash out on.
+ * @param args.terminal The terminal holding the project's `tokenToReclaim` balance.
+ * @param args.holder The address whose project tokens are being cashed out.
+ * @param args.projectId The project's id.
+ * @param args.cashOutCount The number of project tokens to cash out, as a fixed point
+ * number with 18 decimals.
+ * @param args.tokenToReclaim The terminal token to reclaim from the project's surplus.
+ * @param args.minTokensReclaimed The minimum `tokenToReclaim` amount that must be
+ * reclaimed, else the transaction reverts. Defaults to 0.
+ * @param args.beneficiary The address that receives the reclaimed tokens.
+ * @param args.metadata Hook metadata. Defaults to "0x".
+ * @returns The transaction request.
+ */
+export declare function buildCashOutTx({ chainId, terminal, holder, projectId, cashOutCount, tokenToReclaim, minTokensReclaimed, beneficiary, metadata, }: {
+    chainId: JBChainId;
+    terminal: Address;
+    holder: Address;
+    projectId: bigint;
+    cashOutCount: bigint;
+    tokenToReclaim: Address;
+    minTokensReclaimed?: bigint;
+    beneficiary: Address;
+    metadata?: Hex;
+}): V6CashOutTxRequest;
+/**
+ * A cash out quote.
+ */
+export interface CashOutQuote {
+    /**
+     * The reclaimable surplus for the cash out count, before the protocol fee.
+     */
+    reclaimAmount: bigint;
+    /**
+     * The reclaim amount net of the 2.5% protocol cash out fee.
+     *
+     * The fee only applies when the ruleset's cash out tax rate is non-zero — for
+     * zero-tax rulesets the full {@link CashOutQuote.reclaimAmount} is paid out.
+     */
+    reclaimAmountAfterFee: bigint;
+}
+/**
+ * Quote the surplus reclaimed by cashing out `cashOutCount` project tokens, via
+ * `JBTerminalStore.currentReclaimableSurplusOf(projectId, cashOutCount, [], [],
+ * decimals, currency)`. Passing empty terminal/token arrays uses all of the project's
+ * terminals and tokens.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.chainId The chain to quote on.
+ * @param args.projectId The project's id.
+ * @param args.cashOutCount The number of project tokens to cash out, as a fixed point
+ * number with 18 decimals.
+ * @param args.decimals The decimals to quote the reclaim amount in. Defaults to 18.
+ * @param args.currency The currency to quote the reclaim amount in (an
+ * accounting-context currency, `uint32(uint160(token))`). Defaults to the native
+ * token's currency (61166).
+ * @returns The raw reclaim amount and the amount net of the 2.5% protocol fee.
+ *
+ * NOTE: the defaults quote in NATIVE terms (decimals 18, token-keyed native
+ * currency). For a project whose accounting token is not the native token
+ * (e.g. USDC), pass that token's `decimals` and `tokenCurrencyId(token)` to
+ * quote in its own terms and avoid a price-feed conversion.
+ */
+export declare function getCashOutQuote(client: PublicClient, { chainId, projectId, cashOutCount, decimals, currency, }: {
+    chainId: JBChainId;
+    projectId: bigint;
+    cashOutCount: bigint;
+    decimals?: bigint;
+    currency?: bigint;
+}): Promise<CashOutQuote>;
+//# sourceMappingURL=cashOut.d.ts.map

package/dist/cjs/v6/cashOut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cashOut.d.ts","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EACL,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAKxC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,kBAAkB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;IAChC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,cAAc,EACd,kBAAuB,EACvB,WAAW,EACX,QAAe,GAChB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,kBAAkB,CAgBrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,EACE,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAc,EACd,QAA2C,GAC5C,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,YAAY,CAAC,CAYvB"}

package/dist/cjs/v6/cashOut.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCashOutTx = buildCashOutTx;
+exports.getCashOutQuote = getCashOutQuote;
+const juicebox_js_1 = require("../generated/juicebox.js");
+const fee_js_1 = require("../utils/fee.js");
+const currency_js_1 = require("./currency.js");
+const types_js_1 = require("./types.js");
+/**
+ * Build a `cashOutTokensOf(holder, projectId, cashOutCount, tokenToReclaim,
+ * minTokensReclaimed, beneficiary, metadata)` transaction request for a v6 terminal.
+ *
+ * @param args.chainId The chain to cash out on.
+ * @param args.terminal The terminal holding the project's `tokenToReclaim` balance.
+ * @param args.holder The address whose project tokens are being cashed out.
+ * @param args.projectId The project's id.
+ * @param args.cashOutCount The number of project tokens to cash out, as a fixed point
+ * number with 18 decimals.
+ * @param args.tokenToReclaim The terminal token to reclaim from the project's surplus.
+ * @param args.minTokensReclaimed The minimum `tokenToReclaim` amount that must be
+ * reclaimed, else the transaction reverts. Defaults to 0.
+ * @param args.beneficiary The address that receives the reclaimed tokens.
+ * @param args.metadata Hook metadata. Defaults to "0x".
+ * @returns The transaction request.
+ */
+function buildCashOutTx({ chainId, terminal, holder, projectId, cashOutCount, tokenToReclaim, minTokensReclaimed = 0n, beneficiary, metadata = "0x", }) {
+    return {
+        chainId,
+        address: terminal,
+        abi: juicebox_js_1.jbMultiTerminalAbi,
+        functionName: "cashOutTokensOf",
+        args: [
+            holder,
+            projectId,
+            cashOutCount,
+            tokenToReclaim,
+            minTokensReclaimed,
+            beneficiary,
+            metadata,
+        ],
+    };
+}
+/**
+ * Quote the surplus reclaimed by cashing out `cashOutCount` project tokens, via
+ * `JBTerminalStore.currentReclaimableSurplusOf(projectId, cashOutCount, [], [],
+ * decimals, currency)`. Passing empty terminal/token arrays uses all of the project's
+ * terminals and tokens.
+ *
+ * @param client A viem public client on the given chain.
+ * @param args.chainId The chain to quote on.
+ * @param args.projectId The project's id.
+ * @param args.cashOutCount The number of project tokens to cash out, as a fixed point
+ * number with 18 decimals.
+ * @param args.decimals The decimals to quote the reclaim amount in. Defaults to 18.
+ * @param args.currency The currency to quote the reclaim amount in (an
+ * accounting-context currency, `uint32(uint160(token))`). Defaults to the native
+ * token's currency (61166).
+ * @returns The raw reclaim amount and the amount net of the 2.5% protocol fee.
+ *
+ * NOTE: the defaults quote in NATIVE terms (decimals 18, token-keyed native
+ * currency). For a project whose accounting token is not the native token
+ * (e.g. USDC), pass that token's `decimals` and `tokenCurrencyId(token)` to
+ * quote in its own terms and avoid a price-feed conversion.
+ */
+async function getCashOutQuote(client, { chainId, projectId, cashOutCount, decimals = 18n, currency = BigInt(currency_js_1.NATIVE_TOKEN_CURRENCY_ID), }) {
+    const reclaimAmount = await client.readContract({
+        address: (0, types_js_1.v6Address)("JBTerminalStore", chainId),
+        abi: juicebox_js_1.jbTerminalStoreAbi,
+        functionName: "currentReclaimableSurplusOf",
+        args: [projectId, cashOutCount, [], [], decimals, currency],
+    });
+    return {
+        reclaimAmount,
+        reclaimAmountAfterFee: (0, fee_js_1.applyJbDaoCashOutFee)(reclaimAmount),
+    };
+}
+//# sourceMappingURL=cashOut.js.map

package/dist/cjs/v6/cashOut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cashOut.js","sourceRoot":"","sources":["../../../src/v6/cashOut.ts"],"names":[],"mappings":";;AAuCA,wCAoCC;AAyCD,0CA2BC;AA9ID,0DAGkC;AAElC,4CAAuD;AACvD,+CAAyD;AACzD,yCAAuC;AAcvC;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,cAAc,EACd,kBAAkB,GAAG,EAAE,EACvB,WAAW,EACX,QAAQ,GAAG,IAAI,GAWhB;IACC,OAAO;QACL,OAAO;QACP,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,gCAAkB;QACvB,YAAY,EAAE,iBAAiB;QAC/B,IAAI,EAAE;YACJ,MAAM;YACN,SAAS;YACT,YAAY;YACZ,cAAc;YACd,kBAAkB;YAClB,WAAW;YACX,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAmBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,eAAe,CACnC,MAAoB,EACpB,EACE,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAQ,GAAG,GAAG,EACd,QAAQ,GAAG,MAAM,CAAC,sCAAwB,CAAC,GAO5C;IAED,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;QAC9C,OAAO,EAAE,IAAA,oBAAS,EAAC,iBAAiB,EAAE,OAAO,CAAC;QAC9C,GAAG,EAAE,gCAAkB;QACvB,YAAY,EAAE,6BAA6B;QAC3C,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC5D,CAAC,CAAC;IAEH,OAAO;QACL,aAAa;QACb,qBAAqB,EAAE,IAAA,6BAAoB,EAAC,aAAa,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/cjs/v6/cashOut.test.d.ts

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

package/dist/cjs/v6/cashOut.test.d.ts.map

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

package/dist/cjs/v6/cashOut.test.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const viem_1 = require("viem");
+const vitest_1 = require("vitest");
+const constants_js_1 = require("../constants.js");
+const juicebox_js_1 = require("../generated/juicebox.js");
+const cashOut_js_1 = require("./cashOut.js");
+const types_js_1 = require("./types.js");
+const chainId = 11155111;
+const terminal = "0x1111111111111111111111111111111111111111";
+const holder = "0x2222222222222222222222222222222222222222";
+const beneficiary = "0x3333333333333333333333333333333333333333";
+const projectId = 3n;
+(0, vitest_1.describe)("cashOut", () => {
+    (0, vitest_1.test)("buildCashOutTx encodes cashOutTokensOf", () => {
+        const tx = (0, cashOut_js_1.buildCashOutTx)({
+            chainId,
+            terminal,
+            holder,
+            projectId,
+            cashOutCount: constants_js_1.ONE_ETHER,
+            tokenToReclaim: constants_js_1.NATIVE_TOKEN,
+            beneficiary,
+        });
+        (0, vitest_1.expect)(tx.chainId).toEqual(chainId);
+        (0, vitest_1.expect)(tx.address).toEqual(terminal);
+        (0, vitest_1.expect)(tx.functionName).toEqual("cashOutTokensOf");
+        (0, vitest_1.expect)(tx.args).toEqual([
+            holder,
+            projectId,
+            constants_js_1.ONE_ETHER,
+            constants_js_1.NATIVE_TOKEN,
+            0n,
+            beneficiary,
+            "0x",
+        ]);
+        (0, vitest_1.expect)(() => (0, viem_1.encodeFunctionData)(tx)).not.toThrow();
+    });
+    (0, vitest_1.test)("buildCashOutTx passes minTokensReclaimed and metadata through", () => {
+        const tx = (0, cashOut_js_1.buildCashOutTx)({
+            chainId,
+            terminal,
+            holder,
+            projectId,
+            cashOutCount: constants_js_1.ONE_ETHER,
+            tokenToReclaim: constants_js_1.NATIVE_TOKEN,
+            minTokensReclaimed: 999n,
+            beneficiary,
+            metadata: "0x1234",
+        });
+        (0, vitest_1.expect)(tx.args[4]).toEqual(999n);
+        (0, vitest_1.expect)(tx.args[6]).toEqual("0x1234");
+        (0, vitest_1.expect)(() => (0, viem_1.encodeFunctionData)(tx)).not.toThrow();
+    });
+    (0, vitest_1.test)("getCashOutQuote reads the terminal store and applies the 2.5% fee", async () => {
+        const calls = [];
+        const client = {
+            async readContract(params) {
+                calls.push(params);
+                return constants_js_1.ONE_ETHER;
+            },
+        };
+        const quote = await (0, cashOut_js_1.getCashOutQuote)(client, {
+            chainId,
+            projectId,
+            cashOutCount: constants_js_1.ONE_ETHER,
+        });
+        (0, vitest_1.expect)(quote.reclaimAmount).toEqual(constants_js_1.ONE_ETHER);
+        (0, vitest_1.expect)(quote.reclaimAmountAfterFee).toEqual(975000000000000000n);
+        (0, vitest_1.expect)(calls[0].address).toEqual((0, types_js_1.v6Address)("JBTerminalStore", chainId));
+        (0, vitest_1.expect)(calls[0].abi).toBe(juicebox_js_1.jbTerminalStoreAbi);
+        (0, vitest_1.expect)(calls[0].functionName).toEqual("currentReclaimableSurplusOf");
+        // Empty terminal/token arrays use all of the project's terminals and tokens;
+        // defaults quote 18 decimals in the native token's currency.
+        (0, vitest_1.expect)(calls[0].args).toEqual([projectId, constants_js_1.ONE_ETHER, [], [], 18n, 61166n]);
+    });
+    (0, vitest_1.test)("getCashOutQuote respects custom decimals and currency", async () => {
+        const calls = [];
+        const client = {
+            async readContract(params) {
+                calls.push(params);
+                return 0n;
+            },
+        };
+        await (0, cashOut_js_1.getCashOutQuote)(client, {
+            chainId,
+            projectId,
+            cashOutCount: constants_js_1.ONE_ETHER,
+            decimals: 6n,
+            currency: 0x3606eb48n,
+        });
+        (0, vitest_1.expect)(calls[0].args).toEqual([
+            projectId,
+            constants_js_1.ONE_ETHER,
+            [],
+            [],
+            6n,
+            0x3606eb48n,
+        ]);
+    });
+});
+//# sourceMappingURL=cashOut.test.js.map

package/dist/cjs/v6/cashOut.test.js.map

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

package/dist/cjs/v6/currency.d.ts

@@ -0,0 +1,43 @@
+import { Address } from "viem";
+/**
+ * The v6 base currency id for ETH (JBCurrencyIds.ETH).
+ *
+ * Base currencies are the small standard ids (ETH = 1, USD = 2) used to denominate a
+ * ruleset's `baseCurrency` and fund access limits. They are NOT the same as
+ * accounting-context currencies, which are derived from a token's address via
+ * {@link tokenCurrencyId}. Never use an accounting-context currency (e.g. 61166 for the
+ * native token) as a ruleset `baseCurrency` to "skip the price feed" — base currency
+ * must be 1 or 2.
+ *
+ * @link https://github.com/Bananapus/nana-core-v6/blob/main/src/libraries/JBCurrencyIds.sol
+ */
+export declare const BASE_CURRENCY_ETH = 1;
+/**
+ * The v6 base currency id for USD (JBCurrencyIds.USD).
+ *
+ * See {@link BASE_CURRENCY_ETH} for the distinction between base currencies and
+ * accounting-context currencies.
+ *
+ * @link https://github.com/Bananapus/nana-core-v6/blob/main/src/libraries/JBCurrencyIds.sol
+ */
+export declare const BASE_CURRENCY_USD = 2;
+/**
+ * The accounting-context currency id of the network's native token (e.g. ETH).
+ *
+ * Equal to `uint32(uint160(0x000000000000000000000000000000000000EEEe))` = 61166.
+ * This is what {@link tokenCurrencyId} returns for the native token address.
+ */
+export declare const NATIVE_TOKEN_CURRENCY_ID = 61166;
+/**
+ * The v6 accounting-context currency id for a token: `uint32(uint160(tokenAddress))`,
+ * i.e. the lowest 4 bytes of the token's address.
+ *
+ * Use this for terminal accounting contexts (`{ token, decimals, currency }`) — NOT for
+ * a ruleset's `baseCurrency`, which must be a base currency id
+ * ({@link BASE_CURRENCY_ETH} or {@link BASE_CURRENCY_USD}).
+ *
+ * @param token The token address to derive a currency id from.
+ * @returns The token's accounting-context currency id (fits in a uint32).
+ */
+export declare function tokenCurrencyId(token: Address): number;
+//# sourceMappingURL=currency.d.ts.map

package/dist/cjs/v6/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../src/v6/currency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}