@latchprotocol/widgets 0.1.0

package/dist/callpath/launch.d.ts.map

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

package/dist/callpath/liquidity.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Liquidity call-path construction for both pool types.
+ *
+ * Concentrated liquidity and the liquidity book differ in what a "range" is -
+ * a tick pair versus a span of bins - and in the shape of their position
+ * manager params. Everything above this file works with the single
+ * {@link ../adapters/protocol.js | LiquidityRange} union; the divergence is
+ * confined to the two encoders here.
+ *
+ * Both paths go through `PositionManager.modifyLiquidities(unlockData, deadline)`
+ * with the same `abi.encode(actions, params)` transport the swap path uses.
+ *
+ * ## Why there is no integrator fee on this path
+ *
+ * `PAY_PORTION` and `TAKE_PORTION` split an output currency. Adding liquidity
+ * has no output to split, and removing it returns the user's own principal -
+ * skimming that is not a referral fee, it is a withdrawal charge. Integrator
+ * revenue on liquidity, if it is ever added, belongs in a hook that earns from
+ * the position, not in a router step that taxes the deposit. The `integrator`
+ * config is still carried here so it can be recorded in analytics events.
+ */
+import { type Address, type Hex } from "viem";
+import { type PoolKey } from "@latchprotocol/sdk";
+/** An encoded position-manager call. */
+export interface EncodedLiquidityCall {
+    readonly to: Address;
+    readonly data: Hex;
+    readonly value: bigint;
+    readonly planTrace: string;
+}
+/** Arguments for minting a new concentrated-liquidity position. */
+export interface BuildCLMintArgs {
+    readonly positionManager: Address;
+    readonly poolKey: PoolKey;
+    readonly tickLower: number;
+    readonly tickUpper: number;
+    readonly liquidity: bigint;
+    readonly amount0Max: bigint;
+    readonly amount1Max: bigint;
+    readonly owner: Address;
+    readonly deadline: bigint;
+    readonly hookData?: Hex;
+    /** Native value to attach, when one side of the pair is the native asset. */
+    readonly value?: bigint;
+}
+/** Encodes `CL_MINT_POSITION` followed by `SETTLE_PAIR` (and `SWEEP` of the native side when value is attached). */
+export declare function buildCLMintCall(args: BuildCLMintArgs): EncodedLiquidityCall;
+/** Arguments for decreasing or closing a concentrated-liquidity position. */
+export interface BuildCLDecreaseArgs {
+    readonly positionManager: Address;
+    readonly poolKey: PoolKey;
+    readonly tokenId: bigint;
+    readonly liquidity: bigint;
+    readonly amount0Min: bigint;
+    readonly amount1Min: bigint;
+    readonly recipient: Address;
+    readonly owner: Address;
+    readonly deadline: bigint;
+    readonly hookData?: Hex;
+}
+/** Encodes `CL_DECREASE_LIQUIDITY` followed by `TAKE_PAIR`. */
+export declare function buildCLDecreaseCall(args: BuildCLDecreaseArgs): EncodedLiquidityCall;
+/** Arguments for adding liquidity to a bin pool. */
+export interface BuildBinAddArgs {
+    readonly positionManager: Address;
+    readonly poolKey: PoolKey;
+    readonly amount0: bigint;
+    readonly amount1: bigint;
+    readonly amount0Max: bigint;
+    readonly amount1Max: bigint;
+    readonly activeIdDesired: number;
+    readonly idSlippage: number;
+    /** Bin offsets relative to the active id, one entry per bin. */
+    readonly deltaIds: readonly number[];
+    /** Share of `amount0` per bin, scaled to 1e18. Must sum to <= 1e18. */
+    readonly distributionX: readonly bigint[];
+    /** Share of `amount1` per bin, scaled to 1e18. Must sum to <= 1e18. */
+    readonly distributionY: readonly bigint[];
+    readonly to: Address;
+    readonly deadline: bigint;
+    readonly hookData?: Hex;
+    readonly value?: bigint;
+}
+/** Encodes `BIN_ADD_LIQUIDITY` followed by `SETTLE_PAIR` (and `SWEEP` of the native side when value is attached). */
+export declare function buildBinAddCall(args: BuildBinAddArgs): EncodedLiquidityCall;
+/** Arguments for removing liquidity from a bin pool. */
+export interface BuildBinRemoveArgs {
+    readonly positionManager: Address;
+    readonly poolKey: PoolKey;
+    readonly amount0Min: bigint;
+    readonly amount1Min: bigint;
+    /** Bin ids being burned. */
+    readonly ids: readonly number[];
+    /** Share amount burned per bin, aligned with `ids`. */
+    readonly amounts: readonly bigint[];
+    readonly from: Address;
+    readonly recipient: Address;
+    readonly deadline: bigint;
+    readonly hookData?: Hex;
+}
+/** Encodes `BIN_REMOVE_LIQUIDITY` followed by `TAKE_PAIR`. */
+export declare function buildBinRemoveCall(args: BuildBinRemoveArgs): EncodedLiquidityCall;
+//# sourceMappingURL=liquidity.d.ts.map

package/dist/callpath/liquidity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidity.d.ts","sourceRoot":"","sources":["../../src/callpath/liquidity.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAA2C,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AACvF,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAgHnE,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oHAAoH;AACpH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAqC3E;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;CACzB;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,CAuCnF;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qHAAqH;AACrH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAyD3E;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;CACzB;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,CA4CjF"}

package/dist/callpath/plan.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Action-plan encoding.
+ *
+ * A periphery call is a list of `(actionId, abi-encoded params)` pairs executed
+ * inside one vault lock. The pairs are transported as `abi.encode(bytes actions,
+ * bytes[] params)`, where `actions` is the raw concatenation of one-byte ids.
+ *
+ * `CalldataDecoder.decodeActionsRouterParams` requires *strict* encoding - the
+ * first word must be exactly `0x40` - which is what a standard two-parameter ABI
+ * encoding produces. Do not hand-roll this.
+ */
+import { type Hex } from "viem";
+/** One step of a plan. */
+export interface PlannedAction {
+    readonly action: number;
+    readonly params: Hex;
+    /** Debug label, never encoded. */
+    readonly label: string;
+}
+/** An ordered list of actions destined for one vault lock. */
+export declare class ActionPlan {
+    #private;
+    /** Appends an action. Order is the execution order. */
+    add(action: number, params: Hex, label: string): this;
+    /** The planned steps, in order. */
+    get steps(): readonly PlannedAction[];
+    /** Human-readable trace of the plan, used in dev tooling and error messages. */
+    describe(): string;
+    /** `abi.encode(bytes actions, bytes[] params)`. */
+    encode(): Hex;
+}
+/** Convenience constructor. */
+export declare function plan(): ActionPlan;
+//# sourceMappingURL=plan.d.ts.map

package/dist/callpath/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/callpath/plan.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAkC,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhE,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,8DAA8D;AAC9D,qBAAa,UAAU;;IAGrB,uDAAuD;IACvD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQrD,mCAAmC;IACnC,IAAI,KAAK,IAAI,SAAS,aAAa,EAAE,CAEpC;IAED,gFAAgF;IAChF,QAAQ,IAAI,MAAM;IAMlB,mDAAmD;IACnD,MAAM,IAAI,GAAG;CAgBd;AAED,+BAA+B;AAC/B,wBAAgB,IAAI,IAAI,UAAU,CAEjC"}

package/dist/callpath/swap.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Swap call-path construction - **including integrator fee attribution**.
+ *
+ * This is the file that turns `integrator: { referrer, feeBps }` into money.
+ * The fee is not a post-hoc transfer and not an off-chain promise: it is a step
+ * in the same plan as the swap, so it settles atomically with it.
+ *
+ * ## The two fee modes
+ *
+ * ### `take-portion` (default)
+ *
+ * ```text
+ * UniversalRouter.execute([INFI_SWAP], [plan], deadline)
+ *   plan:
+ *     0. CL_SWAP_EXACT_IN_SINGLE   amountOutMinimum = minAmountOutGross
+ *     1. SETTLE_ALL                pay currencyIn from the caller (via Permit2)
+ *     2. TAKE_PORTION              feeBps of the output credit -> referrer
+ *     3. TAKE_ALL                  the rest -> caller, floored at minAmountOutNet
+ * ```
+ *
+ * The vault credit is split before anything leaves the singleton, so the router
+ * never custodies the fee and there is no window in which it can be swept.
+ *
+ * ### `pay-portion`
+ *
+ * ```text
+ * UniversalRouter.execute([INFI_SWAP, PAY_PORTION, SWEEP], [...], deadline)
+ * ```
+ *
+ * The swap takes its whole output to the router, `PAY_PORTION` forwards the
+ * fee, and `SWEEP` returns the remainder to the recipient. Use this when the
+ * fee has to be taken across a plan the periphery cannot express alone.
+ *
+ * ## Two minimums, deliberately
+ *
+ * The swap action enforces `minAmountOutGross`; the final take/sweep enforces
+ * `minAmountOutNet`. Because `x - floor(x * bps / 10_000)` is monotonically
+ * non-decreasing in `x`, clearing the gross floor guarantees clearing the net
+ * floor. Both are encoded so that neither the pool nor the fee step can quietly
+ * erode the user's guarantee.
+ */
+import { type Address, type Hex } from "viem";
+import { poolKeyToTuple, type PoolKey } from "@latchprotocol/sdk";
+import { ActionPlan } from "./plan.js";
+import type { ResolvedIntegratorConfig } from "../config/integrator.js";
+/** ABI shape of a `PoolKey` struct. */
+export declare const POOL_KEY_COMPONENTS: readonly [{
+    readonly name: "currency0";
+    readonly type: "address";
+}, {
+    readonly name: "currency1";
+    readonly type: "address";
+}, {
+    readonly name: "hooks";
+    readonly type: "address";
+}, {
+    readonly name: "poolManager";
+    readonly type: "address";
+}, {
+    readonly name: "fee";
+    readonly type: "uint24";
+}, {
+    readonly name: "parameters";
+    readonly type: "bytes32";
+}];
+/** One hop of a swap, resolved to the exact pool it will execute against. */
+export interface SwapHop {
+    readonly poolKey: PoolKey;
+    readonly poolType: "CL" | "BIN";
+    /** Input currency of this hop. */
+    readonly currencyIn: Address;
+    /** Output currency of this hop. */
+    readonly currencyOut: Address;
+    readonly hookData?: Hex;
+}
+/** Everything needed to encode a swap transaction. */
+export interface BuildSwapCallArgs {
+    readonly router: Address;
+    readonly hops: readonly SwapHop[];
+    readonly amountIn: bigint;
+    readonly minAmountOutGross: bigint;
+    readonly minAmountOutNet: bigint;
+    /**
+     * Quoted gross output, used only to report the expected fee back to the UI.
+     * The chain always recomputes the fee from the realised output.
+     */
+    readonly expectedAmountOutGross?: bigint;
+    readonly integrator: ResolvedIntegratorConfig;
+    /** Who receives the output. Use the caller's own address for the normal case. */
+    readonly recipient: Address;
+    /** The account submitting the transaction, used to detect the sentinel case. */
+    readonly sender: Address;
+    readonly deadline: bigint;
+}
+/** A fully encoded swap transaction plus the trace used to explain it. */
+export interface EncodedSwapCall {
+    readonly to: Address;
+    readonly data: Hex;
+    readonly value: bigint;
+    readonly commands: Hex;
+    readonly inputs: readonly Hex[];
+    /** Human-readable dump of the periphery plan. */
+    readonly planTrace: string;
+    /** Populated whenever a fee step was encoded. */
+    readonly integratorFee: {
+        readonly referrer: Address;
+        readonly feeBps: number;
+        readonly currency: Address;
+        readonly mode: "take-portion" | "pay-portion";
+        /** Fee implied by the quoted output. The chain recomputes it on the real one. */
+        readonly expectedAmount: bigint;
+    } | null;
+}
+/**
+ * Builds the periphery action plan for a swap.
+ *
+ * Exported so integrators building their own router flows can reuse exactly the
+ * plan the widgets use, fee step included.
+ */
+export declare function buildSwapPlan(args: BuildSwapCallArgs): {
+    readonly plan: ActionPlan;
+    readonly currencyIn: Address;
+    readonly currencyOut: Address;
+};
+/** Encodes the full `UniversalRouter.execute` call for a swap. */
+export declare function buildSwapCall(args: BuildSwapCallArgs): EncodedSwapCall;
+/** Positional pool-key tuple, re-exported so callers do not reach into the SDK. */
+export { poolKeyToTuple };
+//# sourceMappingURL=swap.d.ts.map

package/dist/callpath/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../src/callpath/swap.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AASlE,OAAO,EAAE,UAAU,EAAQ,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAGxE,uCAAuC;AACvC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAOtB,CAAC;AAiDX,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,KAAK,CAAC;IAChC,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;CACzB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC;IAChC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAAC;QAC9C,iFAAiF;QACjF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;KACjC,GAAG,IAAI,CAAC;CACV;AAsFD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG;IACtD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,CAwFA;AA6BD,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAiEtE;AAED,mFAAmF;AACnF,OAAO,EAAE,cAAc,EAAE,CAAC"}