@dev.sail.money/sailor 0.0.2 → 1.0.0-38

package/packages/sdk/dist/intelligence.js

@@ -5,7 +5,7 @@
  * Do not edit manually — run `pnpm build` to regenerate.
  *
  * Spec version : 1.2.0
- * Generated at : 2026-06-05T10:53:26.868Z
+ * Generated at : 2026-06-12T09:09:34.635Z
  */
 export const SAIL_INTELLIGENCE_BASE_URL = "https://api.sail.money";
 export const SAIL_INTELLIGENCE_DOCS_URL = "https://api.sail.money/docs";

package/packages/sdk/dist/lifi.d.ts

@@ -75,6 +75,23 @@ export type FetchLifiQuoteParams = {
     /** Optional fetch implementation (defaults to global fetch). */
     fetchFn?: typeof fetch;
 };
+/**
+ * Compute the minimum acceptable output amount for a swap, given a quoted
+ * `toAmount` and a slippage tolerance.
+ *
+ * Use this to enforce slippage protection when building dispatch calldata —
+ * pass the result as `amountOutMinimum` (Uniswap) or `minAmount` (LiFi).
+ *
+ * @param toAmount  Expected output in the destination token's base units
+ *                  (from `LifiSwapQuote.toAmount` or a Quoter call).
+ * @param slippage  Maximum acceptable price movement as a fraction (0.03 = 3%).
+ *                  Defaults to `DEFAULT_SLIPPAGE` (3%).
+ *
+ * @example
+ * const quote = await fetchLifiQuote({ ... });
+ * const minOut = minTokenOut(quote.toAmount, 0.005); // 0.5% slippage
+ */
+export declare function minTokenOut(toAmount: bigint, slippage?: number): bigint;
 /**
  * Fetch an executable LiFi quote for a same-chain swap. Throws with the API's
  * error body when the quote is unavailable or malformed.

package/packages/sdk/dist/lifi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifi.d.ts","sourceRoot":"","sources":["../src/lifi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAsB,KAAK,GAAG,EAAY,MAAM,MAAM,CAAC;AAE5E,2BAA2B;AAC3B,eAAO,MAAM,cAAc,8BAA8B,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAIhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAOrC,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;EAAY,CAAC;AAE7C,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAEnE;AAED,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG;IAC1B,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,GAAG,CAAC;IACV,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoCzF"}
+{"version":3,"file":"lifi.d.ts","sourceRoot":"","sources":["../src/lifi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAsB,KAAK,GAAG,EAAY,MAAM,MAAM,CAAC;AAE5E,2BAA2B;AAC3B,eAAO,MAAM,cAAc,8BAA8B,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAIhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAOrC,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;EAAY,CAAC;AAE7C,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAEnE;AAED,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG;IAC1B,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,GAAG,CAAC;IACV,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAyB,GAAG,MAAM,CAMzF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoCzF"}

package/packages/sdk/dist/lifi.js

@@ -32,6 +32,30 @@ export const ERC20_ALLOWANCE_ABI = ERC20_ABI;
 export function encodeApprove(spender, amount) {
     return encodeFunctionData({ abi: ERC20_ABI, functionName: "approve", args: [spender, amount] });
 }
+/**
+ * Compute the minimum acceptable output amount for a swap, given a quoted
+ * `toAmount` and a slippage tolerance.
+ *
+ * Use this to enforce slippage protection when building dispatch calldata —
+ * pass the result as `amountOutMinimum` (Uniswap) or `minAmount` (LiFi).
+ *
+ * @param toAmount  Expected output in the destination token's base units
+ *                  (from `LifiSwapQuote.toAmount` or a Quoter call).
+ * @param slippage  Maximum acceptable price movement as a fraction (0.03 = 3%).
+ *                  Defaults to `DEFAULT_SLIPPAGE` (3%).
+ *
+ * @example
+ * const quote = await fetchLifiQuote({ ... });
+ * const minOut = minTokenOut(quote.toAmount, 0.005); // 0.5% slippage
+ */
+export function minTokenOut(toAmount, slippage = DEFAULT_SLIPPAGE) {
+    if (slippage < 0 || slippage >= 1)
+        throw new Error(`slippage must be in [0, 1) — got ${slippage}`);
+    // Scale to 1e6 precision to avoid floating-point truncation on small amounts.
+    const scale = 1000000n;
+    const keepFraction = BigInt(Math.round((1 - slippage) * 1_000_000));
+    return (toAmount * keepFraction) / scale;
+}
 /**
  * Fetch an executable LiFi quote for a same-chain swap. Throws with the API's
  * error body when the quote is unavailable or malformed.

package/packages/sdk/dist/lifi.js.map

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

package/packages/sdk/dist/safe.d.ts

@@ -129,6 +129,89 @@ export declare function buildSafeSetupInitializer(params: {
  * dependency on the Safe nonce. Layout: r = owner(32) ‖ s = 0(32) ‖ v = 1(1).
  */
 export declare function buildApprovedHashSignature(owner: Address): Hex;
+/** ABI for SafeProxyFactory.proxyCreationCode() — pure view returning SafeProxy creation bytecode. */
+export declare const safeProxyFactoryAbi: readonly [{
+    readonly type: "function";
+    readonly name: "proxyCreationCode";
+    readonly stateMutability: "pure";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+}];
+/**
+ * Compute the CREATE2 address SafeProxyFactory.createProxyWithNonce() assigns.
+ *
+ * Factory formula (from SafeProxyFactory source):
+ *   initCode     = proxyCreationCode ++ abi.encode(singleton)
+ *   salt         = keccak256(keccak256(initializer) ++ uint256(saltNonce))
+ *   deployedAddr = CREATE2(factory, salt, keccak256(initCode))
+ *
+ * `proxyCreationCode` must be read once from the factory via `safeProxyFactoryAbi`;
+ * it is identical on every chain since SAFE_V141.proxyFactory is the same address everywhere.
+ *
+ * This is the LOW-LEVEL factory primitive: `saltNonce` is the value handed to
+ * `createProxyWithNonce` verbatim. When the deployer is SailKernel.createAccount,
+ * the kernel does NOT use the caller's nonce directly — it binds it to the
+ * deployer + principals first. To predict a Sail SMA address, use
+ * `computeSailSmaAddress` (which applies `computeKernelBoundSalt`), NOT this
+ * function with the raw nonce.
+ *
+ * NOTE: the `initializer` encodes chain-specific addresses (kernel, safeModuleEnabler)
+ * via `buildSafeSetupInitializer`. Different initializers per chain → different CREATE2 salts
+ * → different deployed addresses, even with the same `saltNonce`. Cross-chain same-address
+ * requires the Sail Protocol to deploy kernel + safeModuleEnabler at identical addresses on
+ * every chain (deterministic CREATE2 deployment), or a registerExisting() flow that
+ * accepts a plain Safe deployed with a chain-agnostic initializer.
+ */
+export declare function computeSafeProxyAddress(params: {
+    initializer: Hex;
+    saltNonce: bigint;
+    proxyCreationCode: Hex;
+}): Address;
+/**
+ * Derive the salt SailKernel.createAccount actually passes to the factory.
+ *
+ * The kernel does NOT forward the caller's `saltNonce` directly — it binds it to
+ * the deployer (`msg.sender`) and the account principals to prevent address
+ * front-running (SailKernel.sol):
+ *
+ *   boundSalt = uint256(keccak256(abi.encode(
+ *     saltNonce, msg.sender, permissionSigner, manager, feePolicy)))
+ *
+ * In the standard onboarding flow `deployer === permissionSigner === owner`
+ * (the owner's EOA submits createAccount and is also the Safe's permission
+ * signer), while `manager` is the agent wallet and `feePolicy` is the chain's
+ * StandardFeePolicy.
+ */
+export declare function computeKernelBoundSalt(params: {
+    saltNonce: bigint;
+    /** `msg.sender` of createAccount — the EOA that deploys (the owner). */
+    deployer: Address;
+    permissionSigner: Address;
+    manager: Address;
+    feePolicy: Address;
+}): bigint;
+/**
+ * Compute the deterministic SMA (Safe) address that SailKernel.createAccount
+ * will deploy for the given owner/manager/feePolicy and salt.
+ *
+ * This is the address `sailor account predict` should show: it applies the
+ * kernel's salt binding (`computeKernelBoundSalt`) before the factory's CREATE2
+ * formula (`computeSafeProxyAddress`). Because the bound salt mixes in the
+ * deployer, permission signer, manager, and fee policy, the address changes if
+ * ANY of those change — not just the `initializer`.
+ */
+export declare function computeSailSmaAddress(params: {
+    initializer: Hex;
+    saltNonce: bigint;
+    deployer: Address;
+    permissionSigner: Address;
+    manager: Address;
+    feePolicy: Address;
+    proxyCreationCode: Hex;
+}): Address;
 /** ABI-encode the kernel's `setManager(newManager)` call. */
 export declare function encodeSetManager(newManager: Address): Hex;
 /**

package/packages/sdk/dist/safe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAsD,MAAM,MAAM,CAAC;AAalG;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBpB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBhB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAQvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,GAAG,CAqBN;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAK9D;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,GAAG,CAMzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,uEAAuE;IACvE,IAAI,EAAE,OAAO,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAmB7B"}
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,GAAG,EAST,MAAM,MAAM,CAAC;AAad;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBpB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBhB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAQvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,GAAG,CAqBN;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAK9D;AAED,sGAAsG;AACtG,eAAO,MAAM,mBAAmB;;;;;;;;;EAQtB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,WAAW,EAAE,GAAG,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,GAAG,CAAC;CACxB,GAAG,OAAO,CAgBV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAgBT;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,WAAW,EAAE,GAAG,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,GAAG,CAAC;CACxB,GAAG,OAAO,CAOV;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,GAAG,CAMzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,uEAAuE;IACvE,IAAI,EAAE,OAAO,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAmB7B"}

package/packages/sdk/dist/safe.js

@@ -1,4 +1,4 @@
-import { encodeFunctionData, encodePacked, pad, zeroAddress } from "viem";
+import { concat, encodeAbiParameters, encodeFunctionData, encodePacked, getCreate2Address, keccak256, pad, zeroAddress, } from "viem";
 /** Minimal SailKernel ABI fragment for the manager-rotation call. */
 const setManagerAbi = [
     {
@@ -121,6 +121,97 @@ export function buildSafeSetupInitializer(params) {
 export function buildApprovedHashSignature(owner) {
     return encodePacked(["bytes32", "bytes32", "uint8"], [pad(owner, { size: 32 }), pad("0x", { size: 32 }), 1]);
 }
+/** ABI for SafeProxyFactory.proxyCreationCode() — pure view returning SafeProxy creation bytecode. */
+export const safeProxyFactoryAbi = [
+    {
+        type: "function",
+        name: "proxyCreationCode",
+        stateMutability: "pure",
+        inputs: [],
+        outputs: [{ name: "", type: "bytes" }],
+    },
+];
+/**
+ * Compute the CREATE2 address SafeProxyFactory.createProxyWithNonce() assigns.
+ *
+ * Factory formula (from SafeProxyFactory source):
+ *   initCode     = proxyCreationCode ++ abi.encode(singleton)
+ *   salt         = keccak256(keccak256(initializer) ++ uint256(saltNonce))
+ *   deployedAddr = CREATE2(factory, salt, keccak256(initCode))
+ *
+ * `proxyCreationCode` must be read once from the factory via `safeProxyFactoryAbi`;
+ * it is identical on every chain since SAFE_V141.proxyFactory is the same address everywhere.
+ *
+ * This is the LOW-LEVEL factory primitive: `saltNonce` is the value handed to
+ * `createProxyWithNonce` verbatim. When the deployer is SailKernel.createAccount,
+ * the kernel does NOT use the caller's nonce directly — it binds it to the
+ * deployer + principals first. To predict a Sail SMA address, use
+ * `computeSailSmaAddress` (which applies `computeKernelBoundSalt`), NOT this
+ * function with the raw nonce.
+ *
+ * NOTE: the `initializer` encodes chain-specific addresses (kernel, safeModuleEnabler)
+ * via `buildSafeSetupInitializer`. Different initializers per chain → different CREATE2 salts
+ * → different deployed addresses, even with the same `saltNonce`. Cross-chain same-address
+ * requires the Sail Protocol to deploy kernel + safeModuleEnabler at identical addresses on
+ * every chain (deterministic CREATE2 deployment), or a registerExisting() flow that
+ * accepts a plain Safe deployed with a chain-agnostic initializer.
+ */
+export function computeSafeProxyAddress(params) {
+    const { initializer, saltNonce, proxyCreationCode } = params;
+    const initCodeHash = keccak256(concat([
+        proxyCreationCode,
+        encodeAbiParameters([{ type: "address" }], [SAFE_V141.singletonL2]),
+    ]));
+    const salt = keccak256(encodePacked(["bytes32", "uint256"], [keccak256(initializer), saltNonce]));
+    return getCreate2Address({
+        from: SAFE_V141.proxyFactory,
+        salt,
+        bytecodeHash: initCodeHash,
+    });
+}
+/**
+ * Derive the salt SailKernel.createAccount actually passes to the factory.
+ *
+ * The kernel does NOT forward the caller's `saltNonce` directly — it binds it to
+ * the deployer (`msg.sender`) and the account principals to prevent address
+ * front-running (SailKernel.sol):
+ *
+ *   boundSalt = uint256(keccak256(abi.encode(
+ *     saltNonce, msg.sender, permissionSigner, manager, feePolicy)))
+ *
+ * In the standard onboarding flow `deployer === permissionSigner === owner`
+ * (the owner's EOA submits createAccount and is also the Safe's permission
+ * signer), while `manager` is the agent wallet and `feePolicy` is the chain's
+ * StandardFeePolicy.
+ */
+export function computeKernelBoundSalt(params) {
+    const { saltNonce, deployer, permissionSigner, manager, feePolicy } = params;
+    return BigInt(keccak256(encodeAbiParameters([
+        { type: "uint256" },
+        { type: "address" },
+        { type: "address" },
+        { type: "address" },
+        { type: "address" },
+    ], [saltNonce, deployer, permissionSigner, manager, feePolicy])));
+}
+/**
+ * Compute the deterministic SMA (Safe) address that SailKernel.createAccount
+ * will deploy for the given owner/manager/feePolicy and salt.
+ *
+ * This is the address `sailor account predict` should show: it applies the
+ * kernel's salt binding (`computeKernelBoundSalt`) before the factory's CREATE2
+ * formula (`computeSafeProxyAddress`). Because the bound salt mixes in the
+ * deployer, permission signer, manager, and fee policy, the address changes if
+ * ANY of those change — not just the `initializer`.
+ */
+export function computeSailSmaAddress(params) {
+    const boundSalt = computeKernelBoundSalt(params);
+    return computeSafeProxyAddress({
+        initializer: params.initializer,
+        saltNonce: boundSalt,
+        proxyCreationCode: params.proxyCreationCode,
+    });
+}
 /** ABI-encode the kernel's `setManager(newManager)` call. */
 export function encodeSetManager(newManager) {
     return encodeFunctionData({

package/packages/sdk/dist/safe.js.map

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

package/packages/sdk/dist/templates/ammLiquidity.d.ts

@@ -1,16 +1,29 @@
 import type { Address, PermissionTemplate } from "../types.js";
-/** Params for SharedAmmLiquidityPermission. */
+/**
+ * Params for SharedAMMLiquidityPermission.
+ *
+ * Matches the on-chain `_applyConfig` decode exactly:
+ *   abi.decode(params, (address[], address[], uint128, bool, bool, bool, bool, bool))
+ *     → allowedTargets, allowedTokens, maxAmountPerTokenPerTx,
+ *       allowMint, allowIncrease, allowDecrease, allowCollect, allowBurn
+ */
 export type AmmLiquidityParams = {
-    /** Maximum total liquidity value in USD-equivalent (18-decimal WAD). */
-    maxLiquidityValueUsd: number;
-    /** Pool addresses the agent may LP into. */
-    allowedPools: Address[];
-    /** Protocol identifiers allowed (e.g. ["uniswapV3", "curveV2", "balancer"]). */
-    allowedProtocols: string[];
-    /** Whether single-sided deposits are permitted. */
-    allowSingleSided: boolean;
-    /** Maximum price range width in basis points (Uni V3 only). */
-    maxRangeBps?: number;
+    /** Position-manager / router addresses the agent may call (UniV3 NPM, Aerodrome, …). */
+    allowedTargets: Address[];
+    /** Token addresses the agent may provide as liquidity. */
+    allowedTokens: Address[];
+    /** Maximum amount of any single token per tx, in that token's base units (uint128). */
+    maxAmountPerTokenPerTx: bigint;
+    /** Allow mint / open-position (and Aerodrome add-liquidity). */
+    allowMint: boolean;
+    /** Allow increaseLiquidity. */
+    allowIncrease: boolean;
+    /** Allow decreaseLiquidity (and Aerodrome remove-liquidity). */
+    allowDecrease: boolean;
+    /** Allow collect (fee withdrawal). */
+    allowCollect: boolean;
+    /** Allow burn (close position NFT). */
+    allowBurn: boolean;
 };
 export declare const ammLiquidityTemplate: PermissionTemplate<AmmLiquidityParams>;
 //# sourceMappingURL=ammLiquidity.d.ts.map

package/packages/sdk/dist/templates/ammLiquidity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ammLiquidity.d.ts","sourceRoot":"","sources":["../../src/templates/ammLiquidity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA2B,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,gFAAgF;IAChF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAUF,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,CAAC,kBAAkB,CAuDvE,CAAC"}
+{"version":3,"file":"ammLiquidity.d.ts","sourceRoot":"","sources":["../../src/templates/ammLiquidity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA2B,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wFAAwF;IACxF,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,0DAA0D;IAC1D,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,uFAAuF;IACvF,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAaF,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,CAAC,kBAAkB,CAyDvE,CAAC"}

package/packages/sdk/dist/templates/ammLiquidity.js

@@ -1,56 +1,64 @@
 import { decodeAbiParameters, encodeAbiParameters } from "viem";
 const ABI = [
-    { name: "maxLiquidityValueUsd", type: "uint256" },
-    { name: "allowedPools", type: "address[]" },
-    { name: "allowedProtocols", type: "string[]" },
-    { name: "allowSingleSided", type: "bool" },
-    { name: "maxRangeBps", type: "uint256" },
+    { name: "allowedTargets", type: "address[]" },
+    { name: "allowedTokens", type: "address[]" },
+    { name: "maxAmountPerTokenPerTx", type: "uint128" },
+    { name: "allowMint", type: "bool" },
+    { name: "allowIncrease", type: "bool" },
+    { name: "allowDecrease", type: "bool" },
+    { name: "allowCollect", type: "bool" },
+    { name: "allowBurn", type: "bool" },
 ];
 export const ammLiquidityTemplate = {
-    name: "SharedAmmLiquidityPermission",
+    name: "SharedAMMLiquidityPermission",
     address: "0x0000000000000000000000000000000000000000",
     encoder: {
         encode(params) {
             return encodeAbiParameters(ABI, [
-                BigInt(Math.round(params.maxLiquidityValueUsd)),
-                params.allowedPools,
-                params.allowedProtocols,
-                params.allowSingleSided,
-                BigInt(params.maxRangeBps ?? 0),
+                params.allowedTargets,
+                params.allowedTokens,
+                params.maxAmountPerTokenPerTx,
+                params.allowMint,
+                params.allowIncrease,
+                params.allowDecrease,
+                params.allowCollect,
+                params.allowBurn,
             ]);
         },
         decode(data) {
             const decoded = decodeAbiParameters(ABI, data);
-            const maxRangeBps = Number(decoded[4]);
             return {
-                maxLiquidityValueUsd: Number(decoded[0]),
-                allowedPools: [...decoded[1]],
-                allowedProtocols: [...decoded[2]],
-                allowSingleSided: decoded[3],
-                ...(maxRangeBps > 0 ? { maxRangeBps } : {}),
+                allowedTargets: [...decoded[0]],
+                allowedTokens: [...decoded[1]],
+                maxAmountPerTokenPerTx: decoded[2],
+                allowMint: decoded[3],
+                allowIncrease: decoded[4],
+                allowDecrease: decoded[5],
+                allowCollect: decoded[6],
+                allowBurn: decoded[7],
             };
         },
     },
     explainer: {
         explain(params) {
             const warnings = [];
-            if (params.allowSingleSided) {
-                warnings.push("Single-sided deposits permitted — may result in immediate impermanent loss");
+            if (params.allowedTargets.length === 0) {
+                warnings.push("No targets specified — all liquidity operations will be blocked");
             }
-            if (params.maxRangeBps !== undefined && params.maxRangeBps > 5000) {
-                warnings.push(`Wide price range allowed: ±${params.maxRangeBps / 100}%`);
-            }
-            const rangeNote = params.maxRangeBps !== undefined
-                ? `Maximum price range (Uni V3): ±${params.maxRangeBps / 100}%`
-                : null;
+            const ops = [
+                params.allowMint && "mint",
+                params.allowIncrease && "increase",
+                params.allowDecrease && "decrease",
+                params.allowCollect && "collect",
+                params.allowBurn && "burn",
+            ].filter(Boolean);
             return {
-                templateName: "SharedAmmLiquidityPermission",
+                templateName: "SharedAMMLiquidityPermission",
                 humanReadable: [
-                    `Maximum liquidity value: $${params.maxLiquidityValueUsd.toLocaleString()} USD`,
-                    `Allowed protocols: ${params.allowedProtocols.join(", ")}`,
-                    `Allowed pools (${params.allowedPools.length}): ${params.allowedPools.join(", ")}`,
-                    `Single-sided deposits: ${params.allowSingleSided ? "allowed" : "not allowed"}`,
-                    ...(rangeNote ? [rangeNote] : []),
+                    `Maximum amount per token per tx: ${params.maxAmountPerTokenPerTx.toString()} (base units)`,
+                    `Allowed targets (${params.allowedTargets.length}): ${params.allowedTargets.join(", ")}`,
+                    `Allowed tokens: ${params.allowedTokens.join(", ")}`,
+                    `Enabled operations: ${ops.length ? ops.join(", ") : "none"}`,
                 ],
                 warnings,
             };

package/packages/sdk/dist/templates/ammLiquidity.js.map

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

package/packages/sdk/dist/templates/approveAndCallBatch.d.ts

@@ -1,14 +1,28 @@
-import type { Address, PermissionTemplate } from "../types.js";
-/** Params for SharedApproveAndCallBatchPermission. */
+import type { Address, Hex, PermissionTemplate } from "../types.js";
+/**
+ * Params for SharedApproveAndCallBatchPermission.
+ *
+ * Matches the on-chain `_applyConfig` decode exactly:
+ *   abi.decode(params, (Config))
+ * where Config is the tuple
+ *   (address[] tokens, address[] spenders, address[] consumingTargets,
+ *    bytes4[] consumingSelectors, uint256[] maxApprovalAmounts, bool requireAmountMatch)
+ *
+ * Note: the contract encodes a SINGLE struct, so the blob is one top-level tuple.
+ */
 export type ApproveAndCallBatchParams = {
-    /** Spender addresses that may receive ERC-20 approvals. */
-    allowedSpenders: Address[];
-    /** Token addresses for which approvals may be granted. */
-    allowedTokens: Address[];
-    /** Maximum total approval value per batch in USD-equivalent (18-decimal WAD). */
-    maxApprovalValueUsd: number;
-    /** Whether infinite (max-uint) approvals are permitted. */
-    allowInfiniteApprovals: boolean;
+    /** Allowlisted ERC-20 tokens that may be approved. Index-parallel with `maxApprovalAmounts`. */
+    tokens: Address[];
+    /** Allowlisted spenders that may receive the allowance. */
+    spenders: Address[];
+    /** Allowlisted consuming-call targets (often the same as spenders). */
+    consumingTargets: Address[];
+    /** Allowlisted selectors for the consuming call (4-byte hex, e.g. "0x095ea7b3"). */
+    consumingSelectors: Hex[];
+    /** Max approve amount per token, index-parallel with `tokens`. */
+    maxApprovalAmounts: bigint[];
+    /** When true, the consuming call's leading uint256 arg must equal the approved amount. */
+    requireAmountMatch: boolean;
 };
 export declare const approveAndCallBatchTemplate: PermissionTemplate<ApproveAndCallBatchParams>;
 //# sourceMappingURL=approveAndCallBatch.d.ts.map

package/packages/sdk/dist/templates/approveAndCallBatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approveAndCallBatch.d.ts","sourceRoot":"","sources":["../../src/templates/approveAndCallBatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA2B,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF,sDAAsD;AACtD,MAAM,MAAM,yBAAyB,GAAG;IACtC,2DAA2D;IAC3D,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,0DAA0D;IAC1D,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC;AASF,eAAO,MAAM,2BAA2B,EAAE,kBAAkB,CAAC,yBAAyB,CAgDrF,CAAC"}
+{"version":3,"file":"approveAndCallBatch.d.ts","sourceRoot":"","sources":["../../src/templates/approveAndCallBatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAsB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,gGAAgG;IAChG,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B,oFAAoF;IACpF,kBAAkB,EAAE,GAAG,EAAE,CAAC;IAC1B,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,0FAA0F;IAC1F,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAaF,eAAO,MAAM,2BAA2B,EAAE,kBAAkB,CAAC,yBAAyB,CA4DrF,CAAC"}

package/packages/sdk/dist/templates/approveAndCallBatch.js

@@ -1,49 +1,62 @@
 import { decodeAbiParameters, encodeAbiParameters } from "viem";
-const ABI = [
-    { name: "allowedSpenders", type: "address[]" },
-    { name: "allowedTokens", type: "address[]" },
-    { name: "maxApprovalValueUsd", type: "uint256" },
-    { name: "allowInfiniteApprovals", type: "bool" },
+const CONFIG_COMPONENTS = [
+    { name: "tokens", type: "address[]" },
+    { name: "spenders", type: "address[]" },
+    { name: "consumingTargets", type: "address[]" },
+    { name: "consumingSelectors", type: "bytes4[]" },
+    { name: "maxApprovalAmounts", type: "uint256[]" },
+    { name: "requireAmountMatch", type: "bool" },
 ];
+const ABI = [{ name: "config", type: "tuple", components: CONFIG_COMPONENTS }];
 export const approveAndCallBatchTemplate = {
     name: "SharedApproveAndCallBatchPermission",
     address: "0x0000000000000000000000000000000000000000",
     encoder: {
         encode(params) {
             return encodeAbiParameters(ABI, [
-                params.allowedSpenders,
-                params.allowedTokens,
-                BigInt(Math.round(params.maxApprovalValueUsd)),
-                params.allowInfiniteApprovals,
+                {
+                    tokens: params.tokens,
+                    spenders: params.spenders,
+                    consumingTargets: params.consumingTargets,
+                    consumingSelectors: params.consumingSelectors,
+                    maxApprovalAmounts: params.maxApprovalAmounts,
+                    requireAmountMatch: params.requireAmountMatch,
+                },
             ]);
         },
         decode(data) {
-            const decoded = decodeAbiParameters(ABI, data);
+            const [config] = decodeAbiParameters(ABI, data);
             return {
-                allowedSpenders: [...decoded[0]],
-                allowedTokens: [...decoded[1]],
-                maxApprovalValueUsd: Number(decoded[2]),
-                allowInfiniteApprovals: decoded[3],
+                tokens: [...config.tokens],
+                spenders: [...config.spenders],
+                consumingTargets: [...config.consumingTargets],
+                consumingSelectors: [...config.consumingSelectors],
+                maxApprovalAmounts: [...config.maxApprovalAmounts],
+                requireAmountMatch: config.requireAmountMatch,
             };
         },
     },
     explainer: {
         explain(params) {
             const warnings = [];
-            if (params.allowInfiniteApprovals) {
-                warnings.push("Infinite approvals enabled — spenders may pull tokens beyond the per-batch cap");
+            if (params.tokens.length !== params.maxApprovalAmounts.length) {
+                warnings.push("tokens and maxApprovalAmounts length mismatch — configuration will revert on-chain");
             }
-            if (params.allowedSpenders.length === 0) {
-                warnings.push("No spenders specified — all approvals will be blocked");
+            if (params.spenders.length === 0 || params.tokens.length === 0) {
+                warnings.push("Empty token or spender allowlist — configuration will revert on-chain");
+            }
+            if (!params.requireAmountMatch) {
+                warnings.push("Amount-match disabled — the consuming call may move less than the approved amount");
             }
             return {
                 templateName: "SharedApproveAndCallBatchPermission",
                 humanReadable: [
-                    `ERC-20 approvals restricted to ${params.allowedSpenders.length} approved spender(s)`,
-                    `Allowed tokens: ${params.allowedTokens.join(", ")}`,
-                    `Maximum approval value per batch: $${params.maxApprovalValueUsd.toLocaleString()} USD`,
-                    `Infinite approvals: ${params.allowInfiniteApprovals ? "allowed" : "not allowed"}`,
-                    `Approved spenders: ${params.allowedSpenders.join(", ")}`,
+                    `Approvable tokens (${params.tokens.length}): ${params.tokens.join(", ")}`,
+                    `Approved spenders: ${params.spenders.join(", ")}`,
+                    `Consuming targets: ${params.consumingTargets.join(", ")}`,
+                    `Consuming selectors: ${params.consumingSelectors.join(", ")}`,
+                    `Per-token approval caps: ${params.maxApprovalAmounts.map((a) => a.toString()).join(", ")}`,
+                    `Require amount match: ${params.requireAmountMatch ? "yes" : "no"}`,
                 ],
                 warnings,
             };