@bananapus/nana-sdk-core 1.0.0 → 1.1.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/v6/launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAe,MAAM,MAAM,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAiB,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD,KAAK,iBAAiB,GAAG,oBAAoB,CAC3C,OAAO,eAAe,EACtB,SAAS,EACT,kBAAkB,CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAChC,eAAe,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,OAAsB,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,mBAAmB,CAYrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,SAAS,CAAC;IACnB,kBAAkB,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACrD,GAAG,gBAAgB,EAAE,CAmBrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,iBAAiB,CAuBnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC7C,qBAAqB,CAAC,EAAE,eAAe,CAAC,uBAAuB,CAAC,CAAC;CAClE,GAAG,eAAe,CAWlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,SAAS,eAAe,EAAE,CAAC;IAClD,sBAAsB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeA"}

package/dist/esm/v6/launch.js

@@ -0,0 +1,176 @@
+import { zeroAddress } from "viem";
+import { NATIVE_TOKEN, NATIVE_TOKEN_DECIMALS } from "../constants.js";
+import { jbControllerAbi, jbProjectsAbi } from "../generated/juicebox.js";
+import { BASE_CURRENCY_ETH, tokenCurrencyId } from "./currency.js";
+import { v6Address } from "./types.js";
+/**
+ * Read the fee (in wei) that `JBProjects` charges to create a new project.
+ *
+ * Launch transactions must send EXACTLY this value as `msg.value` or they
+ * revert. The fee is dynamic — read it per chain right before launching, and
+ * never reuse a value across chains.
+ */
+export async function getProjectCreationFee(client, chainId) {
+    return client.readContract({
+        address: v6Address("JBProjects", chainId),
+        abi: jbProjectsAbi,
+        functionName: "creationFee",
+    });
+}
+/**
+ * Build a `JBAccountingContext` for a token.
+ *
+ * The context currency is ALWAYS token-keyed: `uint32(uint160(token))`
+ * (native token → 61166). This is distinct from a ruleset's `baseCurrency`,
+ * which must be a standard currency id (ETH=1, USD=2) — never use a
+ * token-keyed currency as a base currency to "skip the price feed".
+ *
+ * @param token The token address. Defaults to the native token sentinel
+ * (`0x…EEEe`).
+ * @param decimals The token's decimals. Defaults to 18 for the native token;
+ * REQUIRED for any other token (there is no safe default).
+ */
+export function buildAccountingContext(token = NATIVE_TOKEN, decimals) {
+    const isNative = token.toLowerCase() === NATIVE_TOKEN.toLowerCase();
+    if (decimals === undefined && !isNative) {
+        throw new Error(`decimals is required for non-native token ${token} (there is no safe default)`);
+    }
+    return {
+        token,
+        decimals: decimals ?? NATIVE_TOKEN_DECIMALS,
+        currency: tokenCurrencyId(token),
+    };
+}
+/**
+ * Build the standard terminal configurations for a launch:
+ *
+ * 1. `JBMultiTerminal` accepting the given accounting contexts (the
+ *    project's treasury), and
+ * 2. `JBRouterTerminalRegistry` with EMPTY accounting contexts — registering
+ *    the router registry makes the project accept ANY token via swap
+ *    routing. It is skipped on chains where it isn't deployed.
+ *
+ * @param args.accountingContexts The contexts the multi terminal accepts.
+ * Defaults to just the native token context.
+ */
+export function buildTerminalConfigurations(args) {
+    const configurations = [
+        {
+            terminal: v6Address("JBMultiTerminal", args.chainId),
+            accountingContextsToAccept: args.accountingContexts ?? [
+                buildAccountingContext(),
+            ],
+        },
+    ];
+    try {
+        configurations.push({
+            terminal: v6Address("JBRouterTerminalRegistry", args.chainId),
+            accountingContextsToAccept: [],
+        });
+    }
+    catch {
+        // No router terminal registry on this chain — the multi terminal alone
+        // is a valid configuration.
+    }
+    return configurations;
+}
+/**
+ * Build a `JBRulesetMetadata` with safe defaults (v6 field names ONLY):
+ * everything false/zero, `baseCurrency` ETH (1), no data hook.
+ *
+ * Note `scopeCashOutsToLocalBalances` is the v6 spelling — it replaces the
+ * old inverted `useTotalSurplusForCashOuts`, and `false` keeps the v6
+ * default behavior of cashing out against total surplus.
+ *
+ * @param overrides Any metadata fields to override.
+ */
+export function buildRulesetMetadata(overrides) {
+    return {
+        reservedPercent: 0,
+        cashOutTaxRate: 0,
+        baseCurrency: BASE_CURRENCY_ETH,
+        pausePay: false,
+        pauseCreditTransfers: false,
+        allowOwnerMinting: false,
+        allowSetCustomToken: false,
+        allowTerminalMigration: false,
+        allowSetTerminals: false,
+        allowSetController: false,
+        allowAddAccountingContext: false,
+        allowAddPriceFeed: false,
+        ownerMustSendPayouts: false,
+        holdFees: false,
+        scopeCashOutsToLocalBalances: false,
+        useDataHookForPay: false,
+        useDataHookForCashOut: false,
+        dataHook: zeroAddress,
+        metadata: 0,
+        ...overrides,
+    };
+}
+/**
+ * Build a `JBRulesetConfig` with safe defaults: starts as soon as possible,
+ * no duration (rules can change any time), no issuance (`weight` 0), no
+ * approval hook, default metadata, no splits, and ZERO payouts (an empty
+ * `fundAccessLimitGroups` means the project can pay out NOTHING — funds can
+ * only leave via cash outs).
+ *
+ * @param args.mustStartAtOrAfter Earliest start timestamp (uint48). 0 (the
+ * default) starts at the deploy block. For omnichain launches pass ONE
+ * shared timestamp so every chain's ruleset is byte-identical.
+ * @param args.duration Seconds the ruleset is locked for. 0 = no duration.
+ * @param args.weight Tokens issued per unit of `baseCurrency` paid, as an
+ * 18-decimal fixed point (uint112).
+ * @param args.weightCutPercent Issuance cut applied each cycle, out of 1e9.
+ * @param args.approvalHook A deadline contract queued rulesets must clear.
+ * @param args.metadata Ruleset metadata; see {@link buildRulesetMetadata}.
+ * @param args.splitGroups Split groups to set alongside the ruleset.
+ * @param args.fundAccessLimitGroups Payout limits / surplus allowances.
+ */
+export function buildRulesetConfiguration(args) {
+    return {
+        mustStartAtOrAfter: args?.mustStartAtOrAfter ?? 0,
+        duration: args?.duration ?? 0,
+        weight: args?.weight ?? 0n,
+        weightCutPercent: args?.weightCutPercent ?? 0,
+        approvalHook: args?.approvalHook ?? zeroAddress,
+        metadata: args?.metadata ?? buildRulesetMetadata(),
+        splitGroups: args?.splitGroups ?? [],
+        fundAccessLimitGroups: args?.fundAccessLimitGroups ?? [],
+    };
+}
+/**
+ * Build a `JBController.launchProjectFor` transaction request creating a new
+ * project on a single chain.
+ *
+ * The transaction is payable and must send EXACTLY the current project
+ * creation fee — read it with {@link getProjectCreationFee} on the same
+ * chain right before sending.
+ *
+ * @param args.owner The address that receives the project NFT (full control).
+ * @param args.projectUri An IPFS URI (`ipfs://…`) pointing to the project's
+ * metadata.
+ * @param args.rulesetConfigurations The project's initial rulesets; see
+ * {@link buildRulesetConfiguration}.
+ * @param args.terminalConfigurations The project's terminals; see
+ * {@link buildTerminalConfigurations}.
+ * @param args.memo An optional memo emitted with the launch event.
+ * @param args.creationFee The exact fee read from `JBProjects.creationFee()`.
+ */
+export function buildLaunchProjectTx(args) {
+    return {
+        chainId: args.chainId,
+        address: v6Address("JBController", args.chainId),
+        abi: jbControllerAbi,
+        functionName: "launchProjectFor",
+        args: [
+            args.owner,
+            args.projectUri,
+            args.rulesetConfigurations,
+            args.terminalConfigurations,
+            args.memo ?? "",
+        ],
+        value: args.creationFee,
+    };
+}
+//# sourceMappingURL=launch.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,135 @@
+import { decodeFunctionData, encodeFunctionData, parseEther, zeroAddress, } from "viem";
+import { sepolia } from "viem/chains";
+import { describe, expect, test } from "vitest";
+import { NATIVE_TOKEN, USDC_ADDRESSES } from "../constants.js";
+import { jbControllerAbi } from "../generated/juicebox.js";
+import { buildAccountingContext, buildLaunchProjectTx, buildRulesetConfiguration, buildRulesetMetadata, buildTerminalConfigurations, getProjectCreationFee, } from "./launch.js";
+import { v6Address } from "./types.js";
+const OWNER = "0x000000000000000000000000000000000000dEaD";
+/** A stub PublicClient that records readContract calls. */
+function stubClient(returnValue, calls = []) {
+    const client = {
+        readContract: async (params) => {
+            calls.push(params);
+            return returnValue;
+        },
+    };
+    return { client, calls };
+}
+describe("buildAccountingContext", () => {
+    test("defaults to the native token (61166 currency, 18 decimals)", () => {
+        expect(buildAccountingContext()).toEqual({
+            token: NATIVE_TOKEN,
+            decimals: 18,
+            currency: 61166,
+        });
+    });
+    test("keys the currency off the token address", () => {
+        const usdc = USDC_ADDRESSES[sepolia.id];
+        const context = buildAccountingContext(usdc, 6);
+        expect(context.token).toBe(usdc);
+        expect(context.decimals).toBe(6);
+        expect(context.currency).toBe(Number(BigInt(usdc) & 0xffffffffn));
+    });
+    test("requires decimals for non-native tokens", () => {
+        expect(() => buildAccountingContext(USDC_ADDRESSES[sepolia.id])).toThrow(/decimals is required/);
+    });
+});
+describe("buildTerminalConfigurations", () => {
+    test("pairs the multi terminal with the router registry (empty contexts)", () => {
+        const configurations = buildTerminalConfigurations({
+            chainId: sepolia.id,
+        });
+        expect(configurations).toHaveLength(2);
+        expect(configurations[0].terminal).toBe(v6Address("JBMultiTerminal", sepolia.id));
+        expect(configurations[0].accountingContextsToAccept).toEqual([
+            buildAccountingContext(),
+        ]);
+        expect(configurations[1].terminal).toBe(v6Address("JBRouterTerminalRegistry", sepolia.id));
+        expect(configurations[1].accountingContextsToAccept).toEqual([]);
+    });
+    test("accepts explicit accounting contexts", () => {
+        const usdcContext = buildAccountingContext(USDC_ADDRESSES[sepolia.id], 6);
+        const configurations = buildTerminalConfigurations({
+            chainId: sepolia.id,
+            accountingContexts: [usdcContext],
+        });
+        expect(configurations[0].accountingContextsToAccept).toEqual([usdcContext]);
+    });
+});
+describe("buildRulesetMetadata", () => {
+    test("uses safe v6 defaults", () => {
+        const metadata = buildRulesetMetadata();
+        expect(metadata.reservedPercent).toBe(0);
+        expect(metadata.cashOutTaxRate).toBe(0);
+        expect(metadata.baseCurrency).toBe(1);
+        expect(metadata.scopeCashOutsToLocalBalances).toBe(false);
+        expect(metadata.dataHook).toBe(zeroAddress);
+        expect(metadata.metadata).toBe(0);
+        // v6 field name only — the old inverted field must not exist.
+        expect("useTotalSurplusForCashOuts" in metadata).toBe(false);
+    });
+    test("honors overrides", () => {
+        const metadata = buildRulesetMetadata({
+            reservedPercent: 5000,
+            baseCurrency: 2,
+            allowOwnerMinting: true,
+        });
+        expect(metadata.reservedPercent).toBe(5000);
+        expect(metadata.baseCurrency).toBe(2);
+        expect(metadata.allowOwnerMinting).toBe(true);
+        expect(metadata.pausePay).toBe(false);
+    });
+});
+describe("buildRulesetConfiguration", () => {
+    test("uses safe defaults (zero payouts, no approval hook)", () => {
+        const configuration = buildRulesetConfiguration();
+        expect(configuration.mustStartAtOrAfter).toBe(0);
+        expect(configuration.duration).toBe(0);
+        expect(configuration.weight).toBe(0n);
+        expect(configuration.weightCutPercent).toBe(0);
+        expect(configuration.approvalHook).toBe(zeroAddress);
+        expect(configuration.splitGroups).toEqual([]);
+        expect(configuration.fundAccessLimitGroups).toEqual([]);
+        expect(configuration.metadata).toEqual(buildRulesetMetadata());
+    });
+});
+describe("buildLaunchProjectTx", () => {
+    test("encodes against the controller ABI with the creation fee as value", () => {
+        const creationFee = parseEther("0.01");
+        const request = buildLaunchProjectTx({
+            chainId: sepolia.id,
+            owner: OWNER,
+            projectUri: "ipfs://bafy",
+            rulesetConfigurations: [
+                buildRulesetConfiguration({ weight: parseEther("1000") }),
+            ],
+            terminalConfigurations: buildTerminalConfigurations({
+                chainId: sepolia.id,
+            }),
+            creationFee,
+        });
+        expect(request.address).toBe(v6Address("JBController", sepolia.id));
+        expect(request.value).toBe(creationFee);
+        expect(request.args[4]).toBe(""); // default memo
+        const data = encodeFunctionData(request);
+        const decoded = decodeFunctionData({ abi: jbControllerAbi, data });
+        if (decoded.functionName !== "launchProjectFor") {
+            throw new Error("decoded the wrong function");
+        }
+        expect(decoded.args[0].toLowerCase()).toBe(OWNER.toLowerCase());
+    });
+});
+describe("getProjectCreationFee", () => {
+    test("reads JBProjects.creationFee on the requested chain", async () => {
+        const { client, calls } = stubClient(parseEther("0.001"));
+        const fee = await getProjectCreationFee(client, sepolia.id);
+        expect(fee).toBe(parseEther("0.001"));
+        expect(calls).toHaveLength(1);
+        expect(calls[0]).toMatchObject({
+            address: v6Address("JBProjects", sepolia.id),
+            functionName: "creationFee",
+        });
+    });
+});
+//# sourceMappingURL=launch.test.js.map

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

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

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

@@ -0,0 +1,176 @@
+import { Address, Hex, PublicClient } from "viem";
+import { revLoansAbi } from "../generated/juicebox.js";
+import { JBChainId } from "../types.js";
+/**
+ * The denominator for REVLoans fee percents: prepaid fee percents and source fee percents
+ * are expressed out of 1000.
+ */
+export declare const LOANS_MAX_FEE = 1000n;
+/**
+ * The minimum `prepaidFeePercent` REVLoans accepts when borrowing: 25 of {@link LOANS_MAX_FEE}
+ * (2.5%), paid upfront to the source revnet. Prepaying more than the minimum extends the
+ * loan's zero-additional-cost duration; after it expires the repayment cost increases
+ * linearly until the loan liquidates at 10 years.
+ */
+export declare const MIN_PREPAID_FEE_PERCENT = 25n;
+/**
+ * The upfront fee REVLoans routes to the $REV revnet on every borrow: 10 of
+ * {@link LOANS_MAX_FEE} (1%), taken in addition to the prepaid fee.
+ */
+export declare const REV_PREPAID_FEE_PERCENT = 10n;
+/**
+ * The JBPermissions permission id apps grant to the REVLoans contract before borrowing
+ * against a holder's tokens (v6 ROOT permission id 1). REVLoans needs it to manage the
+ * holder's collateral tokens on their behalf.
+ */
+export declare const REVLOANS_PERMISSION_ID = 1;
+/**
+ * A Permit2 single allowance, passed to `repayLoan` when repaying with an ERC-20 via a
+ * signed permit. Pass {@link EMPTY_SINGLE_ALLOWANCE} (the default) when repaying with the
+ * native token or a pre-approved ERC-20.
+ */
+export type JBSingleAllowance = {
+    sigDeadline: bigint;
+    amount: bigint;
+    expiration: number;
+    nonce: number;
+    signature: Hex;
+};
+/**
+ * An empty Permit2 allowance: use when no permit signature is needed (native-token
+ * repayments, or ERC-20s already approved to REVLoans).
+ */
+export declare const EMPTY_SINGLE_ALLOWANCE: JBSingleAllowance;
+/**
+ * Builds a `borrowFrom` transaction on REVLoans, opening a loan against a holder's revnet
+ * tokens.
+ *
+ * The caller must be the holder or have permission to act on their behalf, and the holder
+ * must have granted permission id {@link REVLOANS_PERMISSION_ID} to REVLoans.
+ *
+ * @param args.chainId The chain to borrow on.
+ * @param args.revnetId The revnet to borrow from.
+ * @param args.token The terminal token to borrow.
+ * @param args.minBorrowAmount The minimum amount to borrow, denominated in `token`.
+ * Defaults to 0.
+ * @param args.collateralCount The number of revnet tokens to lock as collateral, as a
+ * fixed point number with 18 decimals.
+ * @param args.beneficiary The address that receives the borrowed funds and the loan NFT.
+ * @param args.prepaidFeePercent The fee percent to prepay, out of {@link LOANS_MAX_FEE}.
+ * Must be at least {@link MIN_PREPAID_FEE_PERCENT}.
+ * @param args.holder The address whose tokens are used as collateral.
+ */
+export declare function buildBorrowTx({ chainId, revnetId, token, minBorrowAmount, collateralCount, beneficiary, prepaidFeePercent, holder, }: {
+    chainId: JBChainId;
+    revnetId: bigint;
+    token: Address;
+    minBorrowAmount?: bigint;
+    collateralCount: bigint;
+    beneficiary: Address;
+    prepaidFeePercent: bigint;
+    holder: Address;
+}): {
+    chainId: JBChainId;
+    address: Address;
+    abi: typeof revLoansAbi;
+    functionName: "borrowFrom";
+    args: readonly [bigint, Address, bigint, bigint, Address, bigint, Address];
+};
+/**
+ * Builds a `repayLoan` transaction on REVLoans, paying down a loan and reclaiming
+ * collateral.
+ *
+ * Payable: when the loan's source token is the native token, send the repayment as
+ * `value`.
+ *
+ * @param args.chainId The chain the loan lives on.
+ * @param args.loanId The id of the loan being repaid (also the loan NFT's token id).
+ * @param args.maxRepayBorrowAmount The maximum amount to repay, denominated in the loan's
+ * source token. Excess above what's owed is refunded.
+ * @param args.collateralCountToReturn The number of collateral tokens to reclaim, as a
+ * fixed point number with 18 decimals.
+ * @param args.beneficiary The address that receives the reclaimed collateral (and any new
+ * loan NFT for a partial repayment).
+ * @param args.allowance A Permit2 allowance for ERC-20 repayments. Defaults to
+ * {@link EMPTY_SINGLE_ALLOWANCE}.
+ * @param args.value The native-token repayment to send along. Defaults to 0.
+ */
+export declare function buildRepayLoanTx({ chainId, loanId, maxRepayBorrowAmount, collateralCountToReturn, beneficiary, allowance, value, }: {
+    chainId: JBChainId;
+    loanId: bigint;
+    maxRepayBorrowAmount: bigint;
+    collateralCountToReturn: bigint;
+    beneficiary: Address;
+    allowance?: JBSingleAllowance;
+    value?: bigint;
+}): {
+    chainId: JBChainId;
+    address: Address;
+    abi: typeof revLoansAbi;
+    functionName: "repayLoan";
+    args: readonly [bigint, bigint, bigint, Address, JBSingleAllowance];
+    value: bigint;
+};
+/**
+ * Builds a `reallocateCollateralFromLoan` transaction on REVLoans, moving collateral out
+ * of an existing loan and into a new loan (optionally adding more collateral and borrowing
+ * more).
+ *
+ * Note: this internally opens a new loan with the full current borrow capacity, so it is
+ * economically equivalent to borrowing.
+ *
+ * @param args.chainId The chain the loan lives on.
+ * @param args.loanId The id of the loan to reallocate collateral from.
+ * @param args.collateralCountToTransfer The number of collateral tokens to move from the
+ * existing loan into the new one, as a fixed point number with 18 decimals.
+ * @param args.token The terminal token to borrow with the new loan.
+ * @param args.minBorrowAmount The minimum amount the new loan must borrow, denominated in
+ * `token`. Defaults to 0.
+ * @param args.collateralCountToAdd The number of additional collateral tokens to add to
+ * the new loan, as a fixed point number with 18 decimals.
+ * @param args.beneficiary The address that receives the borrowed funds and the new loan
+ * NFT.
+ * @param args.prepaidFeePercent The fee percent to prepay on the new loan, out of
+ * {@link LOANS_MAX_FEE}. Must be at least {@link MIN_PREPAID_FEE_PERCENT}.
+ */
+export declare function buildReallocateCollateralTx({ chainId, loanId, collateralCountToTransfer, token, minBorrowAmount, collateralCountToAdd, beneficiary, prepaidFeePercent, }: {
+    chainId: JBChainId;
+    loanId: bigint;
+    collateralCountToTransfer: bigint;
+    token: Address;
+    minBorrowAmount?: bigint;
+    collateralCountToAdd: bigint;
+    beneficiary: Address;
+    prepaidFeePercent: bigint;
+}): {
+    chainId: JBChainId;
+    address: Address;
+    abi: typeof revLoansAbi;
+    functionName: "reallocateCollateralFromLoan";
+    args: readonly [bigint, bigint, Address, bigint, bigint, Address, bigint];
+};
+/**
+ * Reads how much a given collateral count can borrow from a revnet, via
+ * `REVLoans.borrowableAmountFrom`.
+ *
+ * @param client A viem PublicClient connected to `chainId`.
+ * @param args.chainId The chain to read on.
+ * @param args.revnetId The revnet to borrow from.
+ * @param args.collateralCount The number of revnet tokens that would be locked as
+ * collateral, as a fixed point number with 18 decimals.
+ * @param args.decimals The decimals the returned amounts should be denominated in.
+ * @param args.currency The currency the returned amounts should be denominated in.
+ * @returns `borrowableNow` (currently borrowable, net of the revnet's cash-out delay) and
+ * `borrowableCapacity` (the full capacity the collateral represents).
+ */
+export declare function getBorrowableAmount(client: PublicClient, { chainId, revnetId, collateralCount, decimals, currency, }: {
+    chainId: JBChainId;
+    revnetId: bigint;
+    collateralCount: bigint;
+    decimals: bigint;
+    currency: bigint;
+}): Promise<{
+    borrowableNow: bigint;
+    borrowableCapacity: bigint;
+}>;
+//# sourceMappingURL=loans.d.ts.map

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

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