sally-defi-ts-sdk 0.3.2

package/dist/permit2.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Permit2 + EIP-2612 signature approvals.
+ *
+ * Two distinct things live here:
+ *
+ * - **EIP-2612** (`signPermit2612`) — the token-native `permit(owner,spender,
+ *   value,nonce,deadline,v,r,s)`. Used by {@link Token.permit} so a swap can
+ *   authorise the proxy with a *signature* instead of a separate `approve` tx, on
+ *   tokens that support it (USDC, DAI-family wrappers, many others).
+ *
+ * - **Permit2** (`Permit2`, `0x000000000022D473030F116dDEE9F6B43aC78BA3`) —
+ *   Uniswap's universal approval contract. Sally's controller uses it
+ *   *internally* for the V4 PositionManager pull; user swaps do not require it.
+ *
+ * Both produce EIP-712 signatures via ethers; nothing is broadcast here.
+ */
+import { Contract, type Signer } from "ethers";
+import type { SallyClient } from "./client.js";
+export declare const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+export declare const MAX_UINT160: bigint;
+export declare const MAX_UINT48: bigint;
+/** Sign an EIP-2612 `Permit` and return `[v, r, s]` (v number, r/s 0x-hex bytes32). */
+export declare function signPermit2612(account: Signer, opts: {
+    token: string;
+    tokenName: string;
+    version: string;
+    chainId: number;
+    owner: string;
+    spender: string;
+    value: bigint;
+    nonce: number;
+    deadline: number;
+}): Promise<[number, string, string]>;
+/** Sign a Permit2 `PermitSingle` and return the 65-byte signature (0x-hex). */
+export declare function signPermitSingle(account: Signer, opts: {
+    chainId: number;
+    token: string;
+    spender: string;
+    amount: bigint;
+    expiration: number | bigint;
+    nonce: number | bigint;
+    sigDeadline: number | bigint;
+}): Promise<string>;
+export declare const PERMIT2_ABI: readonly [{
+    readonly name: "allowance";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint48";
+    }];
+}, {
+    readonly name: "approve";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }];
+    readonly outputs: readonly [];
+}];
+/** Thin helper around the canonical Permit2 contract for advanced flows. */
+export declare class Permit2 {
+    private _c;
+    readonly address: string;
+    readonly contract: Contract;
+    constructor(client: SallyClient);
+    allowance(owner: string, token: string, spender: string): Promise<[bigint, number, number]>;
+    /** On-chain `Permit2.approve` (after the token is approved to Permit2). */
+    approveToken(token: string, spender: string, amount?: bigint, expiration?: bigint, tx?: Record<string, any>): Promise<any>;
+}
+//# sourceMappingURL=permit2.d.ts.map

package/dist/permit2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.d.ts","sourceRoot":"","sources":["../src/permit2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAyB,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,eAAO,MAAM,eAAe,+CAA+C,CAAC;AAC5E,eAAO,MAAM,WAAW,QAAkB,CAAC;AAC3C,eAAO,MAAM,UAAU,QAAiB,CAAC;AAKzC,uFAAuF;AACvF,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CA0BnC;AAKD,+EAA+E;AAC/E,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B,GACA,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBd,CAAC;AAEX,4EAA4E;AAC5E,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAc;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEhB,MAAM,EAAE,WAAW;IAMzB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAKjG,2EAA2E;IACrE,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAoB,EAC5B,UAAU,GAAE,MAAmB,EAC/B,EAAE,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAC3B,OAAO,CAAC,GAAG,CAAC;CAIhB"}

package/dist/permit2.js

@@ -0,0 +1,130 @@
+/**
+ * Permit2 + EIP-2612 signature approvals.
+ *
+ * Two distinct things live here:
+ *
+ * - **EIP-2612** (`signPermit2612`) — the token-native `permit(owner,spender,
+ *   value,nonce,deadline,v,r,s)`. Used by {@link Token.permit} so a swap can
+ *   authorise the proxy with a *signature* instead of a separate `approve` tx, on
+ *   tokens that support it (USDC, DAI-family wrappers, many others).
+ *
+ * - **Permit2** (`Permit2`, `0x000000000022D473030F116dDEE9F6B43aC78BA3`) —
+ *   Uniswap's universal approval contract. Sally's controller uses it
+ *   *internally* for the V4 PositionManager pull; user swaps do not require it.
+ *
+ * Both produce EIP-712 signatures via ethers; nothing is broadcast here.
+ */
+import { Contract, getAddress, Signature } from "ethers";
+// Canonical Permit2, identical on every EVM chain (CREATE2).
+export const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+export const MAX_UINT160 = 2n ** 160n - 1n;
+export const MAX_UINT48 = 2n ** 48n - 1n;
+// --------------------------------------------------------------------------- //
+// EIP-2612
+// --------------------------------------------------------------------------- //
+/** Sign an EIP-2612 `Permit` and return `[v, r, s]` (v number, r/s 0x-hex bytes32). */
+export async function signPermit2612(account, opts) {
+    const domain = {
+        name: opts.tokenName,
+        version: opts.version,
+        chainId: opts.chainId,
+        verifyingContract: getAddress(opts.token),
+    };
+    const types = {
+        Permit: [
+            { name: "owner", type: "address" },
+            { name: "spender", type: "address" },
+            { name: "value", type: "uint256" },
+            { name: "nonce", type: "uint256" },
+            { name: "deadline", type: "uint256" },
+        ],
+    };
+    const message = {
+        owner: getAddress(opts.owner),
+        spender: getAddress(opts.spender),
+        value: opts.value,
+        nonce: opts.nonce,
+        deadline: opts.deadline,
+    };
+    const sig = await account.signTypedData(domain, types, message);
+    const split = Signature.from(sig);
+    return [split.v, split.r, split.s];
+}
+// --------------------------------------------------------------------------- //
+// Permit2 (AllowanceTransfer — PermitSingle)
+// --------------------------------------------------------------------------- //
+/** Sign a Permit2 `PermitSingle` and return the 65-byte signature (0x-hex). */
+export async function signPermitSingle(account, opts) {
+    const domain = {
+        name: "Permit2",
+        chainId: opts.chainId,
+        verifyingContract: PERMIT2_ADDRESS,
+    };
+    const types = {
+        PermitDetails: [
+            { name: "token", type: "address" },
+            { name: "amount", type: "uint160" },
+            { name: "expiration", type: "uint48" },
+            { name: "nonce", type: "uint48" },
+        ],
+        PermitSingle: [
+            { name: "details", type: "PermitDetails" },
+            { name: "spender", type: "address" },
+            { name: "sigDeadline", type: "uint256" },
+        ],
+    };
+    const message = {
+        details: {
+            token: getAddress(opts.token),
+            amount: opts.amount,
+            expiration: opts.expiration,
+            nonce: opts.nonce,
+        },
+        spender: getAddress(opts.spender),
+        sigDeadline: opts.sigDeadline,
+    };
+    return account.signTypedData(domain, types, message);
+}
+// Minimal Permit2 ABI for allowance reads + approve.
+export const PERMIT2_ABI = [
+    {
+        name: "allowance", type: "function", stateMutability: "view",
+        inputs: [
+            { name: "user", type: "address" }, { name: "token", type: "address" },
+            { name: "spender", type: "address" },
+        ],
+        outputs: [
+            { name: "amount", type: "uint160" }, { name: "expiration", type: "uint48" },
+            { name: "nonce", type: "uint48" },
+        ],
+    },
+    {
+        name: "approve", type: "function", stateMutability: "nonpayable",
+        inputs: [
+            { name: "token", type: "address" }, { name: "spender", type: "address" },
+            { name: "amount", type: "uint160" }, { name: "expiration", type: "uint48" },
+        ],
+        outputs: [],
+    },
+];
+/** Thin helper around the canonical Permit2 contract for advanced flows. */
+export class Permit2 {
+    _c;
+    address;
+    contract;
+    constructor(client) {
+        this._c = client;
+        this.address = getAddress(PERMIT2_ADDRESS);
+        this.contract = new Contract(this.address, PERMIT2_ABI, client.w3);
+    }
+    async allowance(owner, token, spender) {
+        const r = await this.contract.allowance(getAddress(owner), getAddress(token), getAddress(spender));
+        return [BigInt(r[0]), Number(r[1]), Number(r[2])];
+    }
+    /** On-chain `Permit2.approve` (after the token is approved to Permit2). */
+    async approveToken(token, spender, amount = MAX_UINT160, expiration = MAX_UINT48, tx = {}) {
+        const fn = this.contract.getFunction("approve");
+        return this._c.send(fn, [getAddress(token), getAddress(spender), amount, expiration], tx);
+    }
+}
+//# sourceMappingURL=permit2.js.map

package/dist/permit2.js.map

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

package/dist/previews.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Transaction previews for sign-externally mode.
+ *
+ * A {@link TxPreview} is what you inspect before signing with your own wallet:
+ * the fully-populated **unsigned** transaction, the ABI-decoded function + args,
+ * the simulated on-chain result (`eth_call`, decoded per the ABI), the decoded
+ * revert reason if it would fail, and the gas estimate. It answers "what happens
+ * to my wallet if I broadcast this?" — without holding your key.
+ */
+import type { SwapPlan } from "./safety.js";
+/** Inspectable, simulated, unsigned transaction. */
+export declare class TxPreview {
+    unsignedTx: Record<string, any>;
+    sender: string;
+    to: string;
+    function: string;
+    args: Record<string, any>;
+    value: bigint;
+    simulatedReturn: any;
+    revert: string | null;
+    gas: bigint | null;
+    constructor(opts: {
+        unsignedTx: Record<string, any>;
+        sender: string;
+        to: string;
+        function: string;
+        args?: Record<string, any>;
+        value?: bigint;
+        simulatedReturn?: any;
+        revert?: string | null;
+        gas?: bigint | null;
+    });
+    get willRevert(): boolean;
+    summary(): string;
+}
+/**
+ * A swap prepared for external signing.
+ *
+ * Inspect `plan` to see the wallet effect (expected output, min received, price
+ * impact, honeypot/tax screen), then sign + broadcast the unsigned txs yourself —
+ * `approveTx` first (if `needsApproval`), then `swapTx`.
+ */
+export declare class SwapBuild {
+    plan: SwapPlan;
+    swapTx: Record<string, any>;
+    approveTx: Record<string, any> | null;
+    needsApproval: boolean;
+    constructor(opts: {
+        plan: SwapPlan;
+        swapTx: Record<string, any>;
+        approveTx?: Record<string, any> | null;
+        needsApproval?: boolean;
+    });
+    get isSafe(): boolean;
+    summary(): string;
+}
+//# sourceMappingURL=previews.d.ts.map

package/dist/previews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previews.d.ts","sourceRoot":"","sources":["../src/previews.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,oDAAoD;AACpD,qBAAa,SAAS;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,GAAG,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEP,IAAI,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,GAAG,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB;IAYD,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,OAAO,IAAI,MAAM;CASlB;AAED;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACtC,aAAa,EAAE,OAAO,CAAC;gBAEX,IAAI,EAAE;QAChB,IAAI,EAAE,QAAQ,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;QACvC,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB;IAOD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,IAAI,MAAM;CAIlB"}

package/dist/previews.js

@@ -0,0 +1,69 @@
+/**
+ * Transaction previews for sign-externally mode.
+ *
+ * A {@link TxPreview} is what you inspect before signing with your own wallet:
+ * the fully-populated **unsigned** transaction, the ABI-decoded function + args,
+ * the simulated on-chain result (`eth_call`, decoded per the ABI), the decoded
+ * revert reason if it would fail, and the gas estimate. It answers "what happens
+ * to my wallet if I broadcast this?" — without holding your key.
+ */
+/** Inspectable, simulated, unsigned transaction. */
+export class TxPreview {
+    unsignedTx; // sign with your own wallet, then broadcastTransaction
+    sender;
+    to;
+    function; // decoded function name
+    args; // decoded named arguments
+    value;
+    simulatedReturn; // decoded eth_call result (null if it reverts)
+    revert; // decoded revert reason if it would revert
+    gas; // estimated gas (null if it reverts)
+    constructor(opts) {
+        this.unsignedTx = opts.unsignedTx;
+        this.sender = opts.sender;
+        this.to = opts.to;
+        this.function = opts.function;
+        this.args = opts.args ?? {};
+        this.value = opts.value ?? 0n;
+        this.simulatedReturn = opts.simulatedReturn ?? null;
+        this.revert = opts.revert ?? null;
+        this.gas = opts.gas ?? null;
+    }
+    get willRevert() {
+        return this.revert !== null;
+    }
+    summary() {
+        if (this.willRevert) {
+            return `TxPreview(${this.function} -> WOULD REVERT: ${this.revert})`;
+        }
+        return (`TxPreview(${this.function} on ${this.to.slice(0, 10)}…  ` +
+            `returns=${this.simulatedReturn}  gas~${this.gas}  value=${this.value})`);
+    }
+}
+/**
+ * A swap prepared for external signing.
+ *
+ * Inspect `plan` to see the wallet effect (expected output, min received, price
+ * impact, honeypot/tax screen), then sign + broadcast the unsigned txs yourself —
+ * `approveTx` first (if `needsApproval`), then `swapTx`.
+ */
+export class SwapBuild {
+    plan;
+    swapTx; // unsigned executeHybridSwap
+    approveTx; // unsigned ERC-20 approve (if needed)
+    needsApproval;
+    constructor(opts) {
+        this.plan = opts.plan;
+        this.swapTx = opts.swapTx;
+        this.approveTx = opts.approveTx ?? null;
+        this.needsApproval = opts.needsApproval ?? false;
+    }
+    get isSafe() {
+        return this.plan?.isSafe ?? false;
+    }
+    summary() {
+        const appr = this.needsApproval ? " +approve" : "";
+        return `SwapBuild(${this.plan.summary()}${appr})`;
+    }
+}
+//# sourceMappingURL=previews.js.map

package/dist/previews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previews.js","sourceRoot":"","sources":["../src/previews.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,oDAAoD;AACpD,MAAM,OAAO,SAAS;IACpB,UAAU,CAAsB,CAAC,uDAAuD;IACxF,MAAM,CAAS;IACf,EAAE,CAAS;IACX,QAAQ,CAAS,CAAC,wBAAwB;IAC1C,IAAI,CAAsB,CAAC,0BAA0B;IACrD,KAAK,CAAS;IACd,eAAe,CAAM,CAAC,+CAA+C;IACrE,MAAM,CAAgB,CAAC,2CAA2C;IAClE,GAAG,CAAgB,CAAC,qCAAqC;IAEzD,YAAY,IAUX;QACC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,aAAa,IAAI,CAAC,QAAQ,qBAAqB,IAAI,CAAC,MAAM,GAAG,CAAC;QACvE,CAAC;QACD,OAAO,CACL,aAAa,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK;YAC1D,WAAW,IAAI,CAAC,eAAe,SAAS,IAAI,CAAC,GAAG,WAAW,IAAI,CAAC,KAAK,GAAG,CACzE,CAAC;IACJ,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IACpB,IAAI,CAAW;IACf,MAAM,CAAsB,CAAC,6BAA6B;IAC1D,SAAS,CAA6B,CAAC,sCAAsC;IAC7E,aAAa,CAAU;IAEvB,YAAY,IAKX;QACC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;IACnD,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC;IACpC,CAAC;IAED,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,aAAa,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,CAAC;IACpD,CAAC;CACF"}

package/dist/safety.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Swap-safety configuration and the inspectable {@link SwapPlan}.
+ *
+ * The SDK never lets funds move on a route it has not (a) integrity-checked and
+ * (b) — when possible — simulated end-to-end. {@link SwapPlan} is the artifact of
+ * that work: the chosen route, every candidate it beat, the realized output from
+ * an on-chain simulation, the slippage floor, price-impact and the honeypot/tax
+ * probe. `execute` builds a plan, enforces {@link SafetyConfig}, sends, then
+ * asserts the received balance actually grew by `minOut` (trust the chain).
+ */
+import type { SwapPath, TokenInfo } from "./types.js";
+export declare const DEFAULT_SLIPPAGE_BPS = 50;
+export declare const DEFAULT_DEADLINE_SECS = 1200;
+export declare const DEFAULT_PROBE_VALUE: bigint;
+/** Tunable guard rails. Pass one to `new SallyClient(..., { safety })` or per call. */
+export declare class SafetyConfig {
+    readonly slippageBps: number;
+    readonly deadlineSecs: number;
+    readonly priceImpactWarnBps: number;
+    readonly priceImpactBlockBps: number;
+    readonly taxWarnBps: number;
+    readonly taxBlockBps: number;
+    readonly checkIntegrity: boolean;
+    readonly checkHoneypot: boolean;
+    readonly simulate: boolean;
+    readonly balanceDeltaAssert: boolean;
+    readonly probeValue: bigint;
+    readonly unlimitedApproval: boolean;
+    constructor(opts?: Partial<SafetyConfigFields>);
+    /** Return a copy with some fields overridden (mirrors dataclasses.replace). */
+    replace(opts: Partial<SafetyConfigFields>): SafetyConfig;
+    private fields;
+}
+export interface SafetyConfigFields {
+    slippageBps: number;
+    deadlineSecs: number;
+    priceImpactWarnBps: number;
+    priceImpactBlockBps: number;
+    taxWarnBps: number;
+    taxBlockBps: number;
+    checkIntegrity: boolean;
+    checkHoneypot: boolean;
+    simulate: boolean;
+    balanceDeltaAssert: boolean;
+    probeValue: bigint;
+    unlimitedApproval: boolean;
+}
+/** One quoted route plus its simulated realized output (null if it reverted). */
+export declare class RouteCandidate {
+    label: string;
+    route: SwapPath;
+    quotedOut: bigint;
+    simulatedOut: bigint | null;
+    integrityProblems: string[];
+    constructor(label: string, route: SwapPath, quotedOut: bigint, simulatedOut?: bigint | null, integrityProblems?: string[]);
+    get usable(): boolean;
+    /** Ranking key: realized output if simulated, else the quote. */
+    get score(): bigint;
+}
+/** A fully-vetted swap, ready to execute (or inspect/reject). */
+export declare class SwapPlan {
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: bigint;
+    route: SwapPath;
+    quotedOut: bigint;
+    simulatedOut: bigint | null;
+    minOut: bigint;
+    priceImpactBps: number | null;
+    tokenSafety: TokenInfo | null;
+    candidates: RouteCandidate[];
+    warnings: string[];
+    blockReasons: string[];
+    constructor(tokenIn: string, tokenOut: string, amountIn: bigint, route: SwapPath, quotedOut: bigint, simulatedOut: bigint | null, minOut: bigint, priceImpactBps: number | null, tokenSafety: TokenInfo | null, candidates: RouteCandidate[], warnings?: string[], blockReasons?: string[]);
+    get isSafe(): boolean;
+    /** Best available estimate of output (simulated if present, else quoted). */
+    get expectedOut(): bigint;
+    summary(): string;
+}
+//# sourceMappingURL=safety.d.ts.map

package/dist/safety.d.ts.map

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

package/dist/safety.js

@@ -0,0 +1,133 @@
+/**
+ * Swap-safety configuration and the inspectable {@link SwapPlan}.
+ *
+ * The SDK never lets funds move on a route it has not (a) integrity-checked and
+ * (b) — when possible — simulated end-to-end. {@link SwapPlan} is the artifact of
+ * that work: the chosen route, every candidate it beat, the realized output from
+ * an on-chain simulation, the slippage floor, price-impact and the honeypot/tax
+ * probe. `execute` builds a plan, enforces {@link SafetyConfig}, sends, then
+ * asserts the received balance actually grew by `minOut` (trust the chain).
+ */
+// Defaults aligned with mainstream SDKs (Uniswap interface / 1inch).
+export const DEFAULT_SLIPPAGE_BPS = 50; // 0.5%
+export const DEFAULT_DEADLINE_SECS = 1200; // 20 min
+export const DEFAULT_PROBE_VALUE = 10n ** 16n; // 0.01 native, for the getTokenInfos honeypot probe
+/** Tunable guard rails. Pass one to `new SallyClient(..., { safety })` or per call. */
+export class SafetyConfig {
+    slippageBps;
+    deadlineSecs;
+    // price impact (bps of expected-at-marginal-price)
+    priceImpactWarnBps;
+    priceImpactBlockBps;
+    // transfer tax (bps), measured by the getTokenInfos round-trip probe
+    taxWarnBps;
+    taxBlockBps;
+    // toggles
+    checkIntegrity;
+    checkHoneypot;
+    simulate;
+    balanceDeltaAssert;
+    probeValue;
+    // approval: exact-amount by default (safer than infinite approve)
+    unlimitedApproval;
+    constructor(opts = {}) {
+        this.slippageBps = opts.slippageBps ?? DEFAULT_SLIPPAGE_BPS;
+        this.deadlineSecs = opts.deadlineSecs ?? DEFAULT_DEADLINE_SECS;
+        this.priceImpactWarnBps = opts.priceImpactWarnBps ?? 500; // 5%  -> warning
+        this.priceImpactBlockBps = opts.priceImpactBlockBps ?? 1500; // 15% -> hard block
+        this.taxWarnBps = opts.taxWarnBps ?? 1000; // 10%
+        this.taxBlockBps = opts.taxBlockBps ?? 5000; // 50%
+        this.checkIntegrity = opts.checkIntegrity ?? true;
+        this.checkHoneypot = opts.checkHoneypot ?? true;
+        this.simulate = opts.simulate ?? true;
+        this.balanceDeltaAssert = opts.balanceDeltaAssert ?? true;
+        this.probeValue = opts.probeValue ?? DEFAULT_PROBE_VALUE;
+        this.unlimitedApproval = opts.unlimitedApproval ?? false;
+    }
+    /** Return a copy with some fields overridden (mirrors dataclasses.replace). */
+    replace(opts) {
+        return new SafetyConfig({ ...this.fields(), ...opts });
+    }
+    fields() {
+        return {
+            slippageBps: this.slippageBps,
+            deadlineSecs: this.deadlineSecs,
+            priceImpactWarnBps: this.priceImpactWarnBps,
+            priceImpactBlockBps: this.priceImpactBlockBps,
+            taxWarnBps: this.taxWarnBps,
+            taxBlockBps: this.taxBlockBps,
+            checkIntegrity: this.checkIntegrity,
+            checkHoneypot: this.checkHoneypot,
+            simulate: this.simulate,
+            balanceDeltaAssert: this.balanceDeltaAssert,
+            probeValue: this.probeValue,
+            unlimitedApproval: this.unlimitedApproval,
+        };
+    }
+}
+/** One quoted route plus its simulated realized output (null if it reverted). */
+export class RouteCandidate {
+    label;
+    route;
+    quotedOut;
+    simulatedOut;
+    integrityProblems;
+    constructor(label, route, quotedOut, simulatedOut = null, integrityProblems = []) {
+        this.label = label;
+        this.route = route;
+        this.quotedOut = quotedOut;
+        this.simulatedOut = simulatedOut;
+        this.integrityProblems = integrityProblems;
+    }
+    get usable() {
+        return this.integrityProblems.length === 0 && (this.simulatedOut === null || this.simulatedOut > 0n);
+    }
+    /** Ranking key: realized output if simulated, else the quote. */
+    get score() {
+        return this.simulatedOut !== null ? this.simulatedOut : this.quotedOut;
+    }
+}
+/** A fully-vetted swap, ready to execute (or inspect/reject). */
+export class SwapPlan {
+    tokenIn;
+    tokenOut;
+    amountIn;
+    route;
+    quotedOut;
+    simulatedOut;
+    minOut;
+    priceImpactBps;
+    tokenSafety;
+    candidates;
+    warnings;
+    blockReasons;
+    constructor(tokenIn, tokenOut, amountIn, route, quotedOut, simulatedOut, minOut, priceImpactBps, tokenSafety, candidates, warnings = [], blockReasons = []) {
+        this.tokenIn = tokenIn;
+        this.tokenOut = tokenOut;
+        this.amountIn = amountIn;
+        this.route = route;
+        this.quotedOut = quotedOut;
+        this.simulatedOut = simulatedOut;
+        this.minOut = minOut;
+        this.priceImpactBps = priceImpactBps;
+        this.tokenSafety = tokenSafety;
+        this.candidates = candidates;
+        this.warnings = warnings;
+        this.blockReasons = blockReasons;
+    }
+    get isSafe() {
+        return this.blockReasons.length === 0;
+    }
+    /** Best available estimate of output (simulated if present, else quoted). */
+    get expectedOut() {
+        return this.simulatedOut !== null ? this.simulatedOut : this.quotedOut;
+    }
+    summary() {
+        const sim = this.simulatedOut !== null ? `${this.simulatedOut}` : "n/a";
+        return (`SwapPlan(${this.amountIn} ${this.tokenIn.slice(0, 8)}… -> ${this.tokenOut.slice(0, 8)}…  ` +
+            `out~${this.expectedOut} sim=${sim} min=${this.minOut} ` +
+            `impact=${this.priceImpactBps}bps steps=${this.route.stepCount} ` +
+            `${this.isSafe ? "SAFE" : "BLOCKED:" + this.blockReasons.join(",")})`);
+    }
+}
+//# sourceMappingURL=safety.js.map

package/dist/safety.js.map

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