@bananapus/nana-sdk-core 1.0.0 → 1.1.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"splits.d.ts","sourceRoot":"","sources":["../../../src/v6/splits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAe,MAAM,MAAM,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,KAAK,kBAAkB,GAAG,oBAAoB,CAC5C,OAAO,eAAe,EACtB,YAAY,EACZ,kBAAkB,CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA6B5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CASV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC;CACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQA"}

package/dist/esm/v6/splits.js

@@ -0,0 +1,109 @@
+import { zeroAddress } from "viem";
+import { SPLITS_TOTAL_PERCENT } from "../constants.js";
+import { jbControllerAbi } from "../generated/juicebox.js";
+import { v6Address } from "./types.js";
+/**
+ * The group id for a project's reserved-token splits.
+ */
+export const RESERVED_TOKEN_SPLIT_GROUP_ID = 1n;
+/**
+ * The group id for a project's payout splits of the given token:
+ * `uint256(uint160(token))`.
+ *
+ * Use the project's ACCOUNTING token (e.g. USDC for a USDC-accounting
+ * project), not the native-token sentinel, or payouts will be looked up
+ * under the wrong group.
+ */
+export function payoutSplitGroupId(token) {
+    return BigInt(token);
+}
+/**
+ * Scale integer shares so the group totals EXACTLY `SPLITS_TOTAL_PERCENT`
+ * (1e9), assigning the rounding remainder to the largest share (the first
+ * one, on ties). Per-row rounding drifts, and `JBSplits` reverts unless the
+ * group sums to exactly 1e9 — always run computed percents through this
+ * before encoding.
+ *
+ * @param shares Non-negative integer shares, each already denominated out of
+ * `SPLITS_TOTAL_PERCENT` (their sum should be ~1e9; only rounding drift is
+ * corrected here).
+ * @returns A new array summing to exactly `SPLITS_TOTAL_PERCENT`. An empty
+ * input returns an empty array (an empty group is valid).
+ * @throws If a share is negative or non-integer, or if the drift from
+ * `SPLITS_TOTAL_PERCENT` exceeds one unit per share (the input was not
+ * normalized to `SPLITS_TOTAL_PERCENT`).
+ */
+export function fillSplitPercents(shares) {
+    if (shares.length === 0)
+        return [];
+    for (const share of shares) {
+        if (!Number.isInteger(share) || share < 0) {
+            throw new Error(`Split shares must be non-negative integers, got ${share}`);
+        }
+    }
+    const filled = [...shares];
+    const sum = filled.reduce((total, share) => total + share, 0);
+    const delta = SPLITS_TOTAL_PERCENT - sum;
+    if (delta === 0)
+        return filled;
+    // Per-row rounding can drift by at most one unit per share. Anything larger means
+    // the input wasn't normalized to SPLITS_TOTAL_PERCENT — silently rewriting it would
+    // hand a beneficiary a very different share than intended.
+    if (Math.abs(delta) > filled.length) {
+        throw new Error(`Split shares sum to ${sum}; expected ~${SPLITS_TOTAL_PERCENT} (drift larger than rounding error)`);
+    }
+    let largestIndex = 0;
+    for (let i = 1; i < filled.length; i++) {
+        if (filled[i] > filled[largestIndex])
+            largestIndex = i;
+    }
+    filled[largestIndex] += delta;
+    return filled;
+}
+/**
+ * Build a `JBSplit` with safe defaults: pays a beneficiary wallet directly
+ * (`projectId` 0, no hook, `preferAddToBalance` false, unlocked).
+ *
+ * @param args.beneficiary The address that receives the split.
+ * @param args.percent The split's share, out of `SPLITS_TOTAL_PERCENT` (1e9).
+ * Run computed groups through {@link fillSplitPercents} first.
+ * @param args.projectId Route the split to a project instead of a wallet
+ * (the beneficiary then receives that project's tokens). Defaults to 0n.
+ * @param args.preferAddToBalance For project-routed splits, use
+ * `addToBalanceOf` instead of `pay`. Defaults to false.
+ * @param args.lockedUntil Timestamp until which the split cannot be changed.
+ * Defaults to 0 (unlocked).
+ * @param args.hook A split hook contract to receive the split. Defaults to
+ * the zero address (no hook).
+ */
+export function buildSplit(args) {
+    return {
+        percent: args.percent,
+        projectId: args.projectId ?? 0n,
+        beneficiary: args.beneficiary,
+        preferAddToBalance: args.preferAddToBalance ?? false,
+        lockedUntil: args.lockedUntil ?? 0,
+        hook: args.hook ?? zeroAddress,
+    };
+}
+/**
+ * Build a `JBController.setSplitGroupsOf` transaction request setting a
+ * project's split groups for a given ruleset.
+ *
+ * The caller must be the project's owner or have the `SET_SPLIT_GROUPS`
+ * permission. Each group must total exactly `SPLITS_TOTAL_PERCENT`.
+ *
+ * @param args.rulesetId The id of the ruleset the split groups apply to.
+ * @param args.splitGroups Use {@link RESERVED_TOKEN_SPLIT_GROUP_ID} for the
+ * reserved-token group and {@link payoutSplitGroupId} for payout groups.
+ */
+export function buildSetSplitGroupsTx(args) {
+    return {
+        chainId: args.chainId,
+        address: v6Address("JBController", args.chainId),
+        abi: jbControllerAbi,
+        functionName: "setSplitGroupsOf",
+        args: [args.projectId, args.rulesetId, args.splitGroups],
+    };
+}
+//# sourceMappingURL=splits.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"splits.js","sourceRoot":"","sources":["../../../src/v6/splits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,WAAW,EAAE,MAAM,MAAM,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqBvC;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAgB;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,mDAAmD,KAAK,EAAE,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,oBAAoB,GAAG,GAAG,CAAC;IACzC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAE/B,kFAAkF;IAClF,oFAAoF;IACpF,2DAA2D;IAC3D,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,uBAAuB,GAAG,eAAe,oBAAoB,qCAAqC,CACnG,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;YAAE,YAAY,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,IAO1B;IACC,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,KAAK;QACpD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;QAClC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,WAAW;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAKrC;IACC,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC;QAChD,GAAG,EAAE,eAAe;QACpB,YAAY,EAAE,kBAA2B;QACzC,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAU;KAClE,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,133 @@
+import { decodeFunctionData, encodeFunctionData } from "viem";
+import { sepolia } from "viem/chains";
+import { describe, expect, test } from "vitest";
+import { NATIVE_TOKEN, SPLITS_TOTAL_PERCENT } from "../constants.js";
+import { jbControllerAbi } from "../generated/juicebox.js";
+import { RESERVED_TOKEN_SPLIT_GROUP_ID, buildSetSplitGroupsTx, buildSplit, fillSplitPercents, payoutSplitGroupId, } from "./splits.js";
+import { v6Address } from "./types.js";
+const BENEFICIARY = "0x000000000000000000000000000000000000dEaD";
+describe("fillSplitPercents", () => {
+    test("returns an empty array for an empty group", () => {
+        expect(fillSplitPercents([])).toEqual([]);
+    });
+    test("leaves an exact group untouched", () => {
+        expect(fillSplitPercents([600_000_000, 400_000_000])).toEqual([
+            600_000_000, 400_000_000,
+        ]);
+        expect(fillSplitPercents([SPLITS_TOTAL_PERCENT])).toEqual([
+            SPLITS_TOTAL_PERCENT,
+        ]);
+    });
+    test("assigns a positive remainder to the largest share", () => {
+        const third = Math.floor(SPLITS_TOTAL_PERCENT / 3);
+        const filled = fillSplitPercents([third, third, third]);
+        // 3 * 333,333,333 = 999,999,999 — one atom short; the first max takes it.
+        expect(filled).toEqual([third + 1, third, third]);
+        expect(filled.reduce((a, b) => a + b, 0)).toBe(SPLITS_TOTAL_PERCENT);
+    });
+    test("assigns the remainder to the largest share, not the last", () => {
+        const filled = fillSplitPercents([100_000_000, 899_999_999]);
+        expect(filled).toEqual([100_000_000, 900_000_000]);
+    });
+    test("shaves a negative remainder off the largest share", () => {
+        const filled = fillSplitPercents([500_000_000, 500_000_001]);
+        expect(filled).toEqual([500_000_000, 500_000_000]);
+        expect(filled.reduce((a, b) => a + b, 0)).toBe(SPLITS_TOTAL_PERCENT);
+    });
+    test("uneven 7-way split fills to exactly 1e9", () => {
+        const seventh = Math.floor(SPLITS_TOTAL_PERCENT / 7);
+        const shares = Array(7).fill(seventh);
+        const filled = fillSplitPercents(shares);
+        expect(filled.reduce((a, b) => a + b, 0)).toBe(SPLITS_TOTAL_PERCENT);
+        // 1e9 - 7 * 142,857,142 = 6 atoms on the first max.
+        expect(filled[0]).toBe(seventh + 6);
+        expect(filled.slice(1)).toEqual(Array(6).fill(seventh));
+    });
+    test("throws when the drift exceeds rounding error", () => {
+        expect(() => fillSplitPercents([0])).toThrow(/drift larger than rounding/);
+        expect(() => fillSplitPercents([50, 50])).toThrow(/drift larger than rounding/);
+        expect(() => fillSplitPercents([0, 0, 0])).toThrow(/drift larger than rounding/);
+    });
+    test("does not mutate the input", () => {
+        const shares = [499999999, 499999999, 1];
+        fillSplitPercents(shares);
+        expect(shares).toEqual([499999999, 499999999, 1]);
+    });
+    test("throws on negative or non-integer shares", () => {
+        expect(() => fillSplitPercents([-1, SPLITS_TOTAL_PERCENT])).toThrow(/non-negative integers/);
+        expect(() => fillSplitPercents([0.5, SPLITS_TOTAL_PERCENT])).toThrow(/non-negative integers/);
+    });
+    test("repairs a small oversum even above the total", () => {
+        // sum = 1e9 + 2; shaving 2 off the largest still leaves it non-negative.
+        const filled = fillSplitPercents([SPLITS_TOTAL_PERCENT + 1, 1]);
+        expect(filled).toEqual([SPLITS_TOTAL_PERCENT - 1, 1]);
+        expect(filled.reduce((a, b) => a + b, 0)).toBe(SPLITS_TOTAL_PERCENT);
+    });
+    test("throws when the group oversums beyond repair", () => {
+        // sum = 1.8e9; the -8e8 delta far exceeds rounding error.
+        expect(() => fillSplitPercents([600_000_000, 600_000_000, 600_000_000])).toThrow(/drift larger than rounding/);
+    });
+});
+describe("split group ids", () => {
+    test("reserved-token group id is 1n", () => {
+        expect(RESERVED_TOKEN_SPLIT_GROUP_ID).toBe(1n);
+    });
+    test("payout group id is uint256(uint160(token))", () => {
+        expect(payoutSplitGroupId(NATIVE_TOKEN)).toBe(61166n);
+        expect(payoutSplitGroupId("0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984")).toBe(BigInt("0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"));
+    });
+});
+describe("buildSplit", () => {
+    test("applies safe defaults", () => {
+        const split = buildSplit({ beneficiary: BENEFICIARY, percent: 1 });
+        expect(split).toEqual({
+            percent: 1,
+            projectId: 0n,
+            beneficiary: BENEFICIARY,
+            preferAddToBalance: false,
+            lockedUntil: 0,
+            hook: "0x0000000000000000000000000000000000000000",
+        });
+    });
+    test("honors overrides", () => {
+        const split = buildSplit({
+            beneficiary: BENEFICIARY,
+            percent: 5,
+            projectId: 3n,
+            preferAddToBalance: true,
+            lockedUntil: 1_750_000_000,
+            hook: BENEFICIARY,
+        });
+        expect(split.projectId).toBe(3n);
+        expect(split.preferAddToBalance).toBe(true);
+        expect(split.lockedUntil).toBe(1_750_000_000);
+        expect(split.hook).toBe(BENEFICIARY);
+    });
+});
+describe("buildSetSplitGroupsTx", () => {
+    test("encodes against the controller ABI", () => {
+        const percents = fillSplitPercents([
+            Math.floor(SPLITS_TOTAL_PERCENT * 0.7),
+            Math.floor(SPLITS_TOTAL_PERCENT * 0.3),
+        ]);
+        const request = buildSetSplitGroupsTx({
+            chainId: sepolia.id,
+            projectId: 5n,
+            rulesetId: 1700000000n,
+            splitGroups: [
+                {
+                    groupId: RESERVED_TOKEN_SPLIT_GROUP_ID,
+                    splits: percents.map((percent) => buildSplit({ beneficiary: BENEFICIARY, percent })),
+                },
+            ],
+        });
+        expect(request.address).toBe(v6Address("JBController", sepolia.id));
+        expect(request.chainId).toBe(sepolia.id);
+        expect(request.functionName).toBe("setSplitGroupsOf");
+        const data = encodeFunctionData(request);
+        const decoded = decodeFunctionData({ abi: jbControllerAbi, data });
+        expect(decoded.functionName).toBe("setSplitGroupsOf");
+        expect(decoded.args[0]).toBe(5n);
+    });
+});
+//# sourceMappingURL=splits.test.js.map

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

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

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

@@ -0,0 +1,247 @@
+import { Address, Hex, PublicClient } from "viem";
+import { JBChainId } from "../types.js";
+/**
+ * Minimal v6 JBSucker ABI. v6 identifies remote beneficiaries as bytes32 (for cross-VM
+ * compatibility) and adds an opaque `metadata` attribution payload to prepared leaves.
+ */
+export declare const jbSuckerV6Abi: readonly [{
+    readonly type: "function";
+    readonly name: "prepare";
+    readonly inputs: readonly [{
+        readonly name: "projectTokenCount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "beneficiary";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "minTokensReclaimed";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "metadata";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "toRemote";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "claim";
+    readonly inputs: readonly [{
+        readonly name: "claimData";
+        readonly type: "tuple";
+        readonly internalType: "struct JBClaim";
+        readonly components: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "leaf";
+            readonly type: "tuple";
+            readonly internalType: "struct JBLeaf";
+            readonly components: readonly [{
+                readonly name: "index";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "beneficiary";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }, {
+                readonly name: "projectTokenCount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "terminalTokenAmount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "metadata";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }];
+        }, {
+            readonly name: "proof";
+            readonly type: "bytes32[32]";
+            readonly internalType: "bytes32[32]";
+        }];
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}];
+/**
+ * A leaf of a v6 sucker's merkle tree, representing tokens bridged for one beneficiary.
+ * The beneficiary is a bytes32 (an EVM address left-padded to 32 bytes).
+ */
+export type JBLeaf = {
+    index: bigint;
+    beneficiary: Hex;
+    projectTokenCount: bigint;
+    terminalTokenAmount: bigint;
+    metadata: Hex;
+};
+/**
+ * A 32-entry bytes32 merkle inclusion proof, matching the fixed-size `bytes32[32]` the
+ * sucker's `claim` function takes.
+ */
+export type JBLeafProof = readonly [
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex,
+    Hex
+];
+/**
+ * A claim against a v6 sucker: the terminal token being claimed, the merkle leaf, and its
+ * inclusion proof. The proof must contain exactly 32 bytes32 entries.
+ */
+export type JBClaim = {
+    token: Address;
+    leaf: JBLeaf;
+    proof: JBLeafProof;
+};
+/**
+ * A v6 sucker pair for a project: the local sucker and its remote counterpart.
+ * The registry stores remotes as bytes32; this type carries the unpacked EVM address.
+ */
+export type JBSuckerPairV6 = {
+    local: Address;
+    remote: Address;
+    remoteChainId: bigint;
+};
+/**
+ * Builds a `prepare` transaction on a v6 sucker, locking project tokens into an outbox
+ * leaf destined for the remote chain.
+ *
+ * The beneficiary is an EVM address; it's left-padded to bytes32 internally (v6 suckers
+ * identify beneficiaries as bytes32 for cross-VM compatibility).
+ *
+ * @param args.chainId The chain the sucker lives on.
+ * @param args.sucker The sucker's address.
+ * @param args.projectTokenCount The number of project tokens to bridge, as a fixed point
+ * number with 18 decimals.
+ * @param args.beneficiary The address that will claim the bridged tokens on the remote chain.
+ * @param args.minTokensReclaimed The minimum number of terminal tokens to reclaim when the
+ * project tokens are cashed out. Defaults to 0.
+ * @param args.token The local terminal token being bridged alongside the project tokens.
+ * @param args.metadata Opaque bytes32 attribution payload hashed into the leaf. Defaults to
+ * zero.
+ */
+export declare function buildBridgePrepareTx({ chainId, sucker, projectTokenCount, beneficiary, minTokensReclaimed, token, metadata, }: {
+    chainId: JBChainId;
+    sucker: Address;
+    projectTokenCount: bigint;
+    beneficiary: Address;
+    minTokensReclaimed?: bigint;
+    token: Address;
+    metadata?: Hex;
+}): {
+    chainId: JBChainId;
+    address: Address;
+    abi: typeof jbSuckerV6Abi;
+    functionName: "prepare";
+    args: readonly [bigint, Hex, bigint, Address, Hex];
+};
+/**
+ * Builds a `claim` transaction on a v6 sucker, redeeming an inbox leaf that was bridged
+ * from the remote chain.
+ *
+ * @param args.chainId The chain the sucker lives on.
+ * @param args.sucker The sucker's address.
+ * @param args.claim The claim: terminal token, leaf (with bytes32 beneficiary), and a
+ * 32-entry bytes32 inclusion proof.
+ */
+export declare function buildBridgeClaimTx({ chainId, sucker, claim, }: {
+    chainId: JBChainId;
+    sucker: Address;
+    claim: JBClaim;
+}): {
+    chainId: JBChainId;
+    address: Address;
+    abi: typeof jbSuckerV6Abi;
+    functionName: "claim";
+    args: readonly [JBClaim];
+};
+/**
+ * Builds a `toRemote` transaction on a v6 sucker, sending the outbox tree for a token to
+ * the remote chain.
+ *
+ * Payable: bridging over CCIP requires a fee to be sent along as `value`. Native-bridge
+ * suckers (OP/Base/Arbitrum) take no fee.
+ *
+ * @param args.chainId The chain the sucker lives on.
+ * @param args.sucker The sucker's address.
+ * @param args.token The local terminal token whose outbox tree should be bridged.
+ * @param args.value The bridge fee to send along. Defaults to 0.
+ */
+export declare function buildToRemoteTx({ chainId, sucker, token, value, }: {
+    chainId: JBChainId;
+    sucker: Address;
+    token: Address;
+    value?: bigint;
+}): {
+    chainId: JBChainId;
+    address: Address;
+    abi: typeof jbSuckerV6Abi;
+    functionName: "toRemote";
+    args: readonly [Address];
+    value: bigint;
+};
+/**
+ * Reads a project's v6 sucker pairs from the JBSuckerRegistry on the given chain.
+ *
+ * The v6 registry stores remote suckers as bytes32 (for cross-VM compatibility); for EVM
+ * peers the address is in the low 20 bytes, which this unpacks to a checksummed address.
+ *
+ * @param client A viem PublicClient connected to `chainId`.
+ * @param args.chainId The chain to read the registry on.
+ * @param args.projectId The project to look up pairs for.
+ */
+export declare function getV6SuckerPairs(client: PublicClient, { chainId, projectId }: {
+    chainId: JBChainId;
+    projectId: bigint;
+}): Promise<JBSuckerPairV6[]>;
+//# sourceMappingURL=suckers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suckers.d.ts","sourceRoot":"","sources":["../../../src/v6/suckers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,GAAG,EACH,YAAY,EAKb,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDhB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,GAAG,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,GAAG,CAAC;CACf,CAAC;AAEF;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,SAAS;IACjC,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IACtC,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IACtC,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IACtC,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;IAAE,GAAG;CACvC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,kBAAuB,EACvB,KAAK,EACL,QAAmB,GACpB,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG;IACF,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,aAAa,CAAC;IAC1B,YAAY,EAAE,SAAS,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CACpD,CAeA;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,MAAM,EACN,KAAK,GACN,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG;IACF,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,aAAa,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC1B,CAQA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,MAAM,EACN,KAAK,EACL,KAAU,GACX,EAAE;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG;IACF,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,aAAa,CAAC;IAC1B,YAAY,EAAE,UAAU,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,CASA;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC,cAAc,EAAE,CAAC,CAa3B"}