@pickhooks/sdk 0.0.0-stage → 0.4.0

package/dist/errors.js

@@ -0,0 +1,414 @@
+import { decodeErrorResult, toFunctionSelector } from "viem";
+import { formatAbiItem } from "viem/utils";
+import { agentsDeskAbi, agentsFactoryAbi, agentsHookAbi } from "./abis/agents.js";
+import { any3FactoryAbi, any3HookAbi } from "./abis/any3.js";
+import { anyTaxFactoryAbi, anyTaxHookAbi } from "./abis/anytax.js";
+import { callsDeskAbi, callsFactoryAbi, callsHookAbi } from "./abis/calls.js";
+import { dipDeskAbi } from "./abis/dips.js";
+import { hooksExecutorAbi, hooksFloorAbi, hooksFloorFactoryAbi } from "./abis/infra.js";
+import { leverEngineAbi, leverFactoryAbi, leverHookAbi, leverRouterAbi } from "./abis/lever.js";
+import { lever2EngineAbi, lever2FactoryAbi, lever2HookAbi } from "./abis/lever2.js";
+import { poolsFactoryAbi, poolsHookAbi } from "./abis/pools.js";
+import { stickyFactoryAbi, stickyTokenAbi, stickyValidatorAbi } from "./abis/sticky.js";
+import { coverDeskAbi, darkRoundAbi, launchDeskAbi, ruleAuctionAbi, sticky2FactoryAbi, sticky2TokenAbi, sticky2ValidatorAbi } from "./abis/sticky2.js";
+import { v1FactoryAbi, v1TokenAbi } from "./abis/v1.js";
+import { arenaAbi, floorVaultAbi, payrollBoxAbi, v2FactoryAbi, v2TokenAbi, voteBoxAbi } from "./abis/v2.js";
+/** sticky: what token.check() answers when no row stops a trade but the coins are not unlocked yet */
+const STICKY_LOCKED = 254;
+/** What hook any coin's factory.check() answers, in words. */
+export const CHECK_TEXT = {
+    0: "This coin can get a pickhooks pool.",
+    1: "There is no contract at this address.",
+    2: "BNB and stablecoins are the other side of a pool, not a coin to hook.",
+    3: "This coin is still on its launch curve. Once it trades on PancakeSwap it can get a pool.",
+    4: "This coin has a transfer tax. A pool here would be a way around it, so it gets none.",
+    5: "This coin pays dividends to holders. The pool would count as a holder, so it gets none.",
+    6: "No PancakeSwap pool of this coin against BNB holds at least 3 BNB, so there is no fair price to open at.",
+};
+/** hook any coin's factory and sticky's factory and validator: Bad(what) as a sentence */
+const BAD = {
+    // sticky 2 factory and dark round
+    tick: "The start price is not on the price ladder.",
+    drip: "The drip is at most an hour.",
+    ciphertext: "The sealed bid has the wrong shape.",
+    creator: "The creator address is empty.",
+    switcher: "The coin's switcher is not listed, or it has switch rows without one.",
+    round: "A round runs 2 to 60 minutes.",
+    allocation: "The round sells 10 to 30 % of the supply.",
+    raise: "The minimum raise is at least 0.05 BNB.",
+    step: "The step is 0 to 23.",
+    // hook any coin, open()
+    fee: "Pool fee: 0.2 to 1 % (feeBps 20 to 100).",
+    holderFee: "The holder fee cannot be higher than the pool fee.",
+    chest: "The fire: at most 10 % of a buy (chestBps up to 1000).",
+    bonus: "Bonus: at most 10 % (bonusBps up to 1000).",
+    bonusLock: "Bonus lock: 1 to 30 days.",
+    jackpotShare: "Jackpot share: 1 to 100 % of the pot (jackpotShareBps 100 to 10000).",
+    jackpotMinBuy: "Jackpot minimum buy: at most 10 BNB.",
+    silence: "Jackpot silence: 1 minute to 7 days.",
+    potShare: "Jackpot: potShareBps at most 10000.",
+    "no opener side for a pot": "A jackpot needs an opener side to fill it.",
+    maxMove: "maxMoveBps: at most 500 (5 %).",
+    slot: "That slot is out of range or taken. Check the coin again for a free slot.",
+    ticks: "The range is not valid for this slot.",
+    liquidity: "Put in coins (and BNB for a range around the price).",
+    partner: "That partner is not listed by pickhooks.",
+    "no pool": "There is no pool with this id.",
+    openerBps: "openerBps out of range.",
+    traderBps: "traderBps out of range.",
+    // sticky
+    seed: "The seed is out of range.",
+    creatorBps: "creatorBps out of range.",
+    startFdv: "startFdv out of range.",
+    "two sided": "The pool would be two sided.",
+    rows: "At most eight rows.",
+    "not a template": "Only the launcher's templates can launch right now (hook script is off).",
+    burn: "Auto burn: at most 10 % in total.",
+    release: "The unlock time must be 10 minutes to 30 days.",
+    age: "Hold time: at most 7 days.",
+    window: "Sell window: open at least a minute, the period at most a day.",
+    hour: "Market hours: whole hours from 1 to 23.",
+    terms: "The fee terms changed since they were read. Read them again.",
+    keep: "keepBps: at most 10000.",
+    value: "Send at least the seed.",
+    metadata: "The metadata link is too long.",
+    name: "Name or ticker too long.",
+    "sell deny must end": "A rule that stops sells or sends must let go by itself.",
+    windows: "One sell window at most, and not next to rows on hours or weekdays.",
+    hours: "The rows on hours close every hour of the day: leave one open.",
+    weekdays: "The rows on weekdays close every day: leave one open.",
+    take: "Burn and pot: at most 10 % of a buy together.",
+    pot: "Pot: 0.01 to 10 % of the buy.",
+    drop: "Drop: 0.01 to 100 % of the pot.",
+    "pot needs a drop": "A pot needs a drop row that pays it out.",
+    every: "Every n-th buy: n from 2 to 1,000,000.",
+    idle: "Time since the last buy: at most 30 days.",
+};
+/** every other error of the pickhooks contracts, by name */
+const BY_NAME = {
+    // hook any coin, factory
+    NotOwner: "Only the factory's owner can do that.",
+    NotOpener: "Only the opener of this pool can do that.",
+    NoLiquidity: "That is too little to add any liquidity. Put in more.",
+    FeeOnTransfer: "This coin takes a fee on transfers, so it cannot go into a pool.",
+    Transfer: "The coin refused the transfer. Check the balance and the allowance.",
+    // agents: the desk and the hook
+    NotPilot: "Only the coin's pilot (its agent's wallet) can do that.",
+    NoPilot: "This coin has no pilot any more: the holders fired it.",
+    NoPending: "This coin has no pending change.",
+    NoLock: "This wallet has no coins locked at the desk for this coin.",
+    Closed: "That vote is over: the change landed or was cancelled, or the pilot is gone.",
+    Unsteady: "The pool's price moved in this block already. The run waits for the next block.",
+    BadBucket: "That bucket does not exist, or BNB cannot move there.",
+    Empty: "That bucket is empty.",
+    DeskSet: "The desk is set once.",
+    NotDesk: "Only the desk can do that.",
+    NotReady: "The factory is not initialised yet.",
+    Liquidity: "The launch could not place the curve.",
+    AlreadyRegistered: "This coin is registered already.",
+    PriceMoved: "The coin's price moved more than allowed while the pool opened. Check again and open.",
+    TooShallow: "Not enough liquidity: the pool must be at least as deep as the coin's main pool.",
+    StillLocked: "This position is still locked. Each one stays 30 days after it went in.",
+    NoPosition: "That position is already out.",
+    TooMany: "A pool holds at most 8 positions.",
+    InvalidTick: "The range is not on the pool's tick spacing.",
+    // hook any coin, hook
+    UnknownPool: "There is no pickhooks pool with this id.",
+    NoPot: "This pool has no jackpot.",
+    NoBonus: "This pool has no bonus rule.",
+    NothingOwed: "Nothing to claim yet.",
+    NotBought: "Only coins bought in this pool can be locked, and no more than that.",
+    NoBonusLeft: "The bonus pot has nothing left for this wallet: it is empty, or the cap is reached.",
+    Locked: "The bonus is still locked.",
+    Reentry: "A call came back into the hook while it was busy.",
+    Pending: "A router still has a payment open in the vault.",
+    // sticky and the coins with rules
+    PoolPrice: "Someone opened this coin's pool first. Launch again (a new salt).",
+    NotCreator: "Only the coin's creator can do that.",
+    Nope: "The coin refused this.",
+    // hook any coin, tax line
+    PayFirst: "While this coin's anti-farmer tax runs, a sell in this pool must pay its coins in first (the SDK's sell does). Terminals sell it in its main pool.",
+    // pools, Lever
+    PartialFill: "The trade would not fill completely. Try a smaller amount.",
+    SwapNotFilled: "The trade would not fill completely. Try a smaller amount.",
+    // lever and Lever
+    MarginTooSmall: "The smallest position is 0.01 BNB of margin plus the open fee.",
+    InvalidLeverage: "Up to 3x in a coin's first 10 minutes, then up to 5x.",
+    TooManyPositions: "All position slots of this coin are taken. A bigger margin takes the smallest one's slot (Lever), or wait until one closes.",
+    OpenInterestLimit: "Longs are full for now: all longs together may borrow at most a quarter of the real BNB in the curve.",
+    LongsFull: "Longs are full for now: all longs together may borrow at most a quarter of the real BNB in the curve. Try a smaller position or wait for more buys.",
+    ShortsFull: "Shorts are full for now: all shorts together may sell coins for at most a quarter of the real BNB in the curve. Try a smaller position or wait for more buys.",
+    UnsafePosition: "This position would sit right at its liquidation point. Try a smaller one or a lower leverage.",
+    Unsafe: "This trade would leave a position at its liquidation point. Try a smaller margin or a lower leverage.",
+    BandFull: "The curve cannot lend that much right now. Try a smaller position.",
+    BadDebt: "This position cannot cover what it borrowed at this price. The next trade that reaches it liquidates it.",
+    Pushed: "The price was pushed in this second. Try again in a moment.",
+    TooSoon: "A position cannot be closed in the second it opened. Try again in a moment.",
+    Slippage: "The price moved past the limit while the transaction waited. Try again.",
+    Expired: "The transaction waited too long. Try again.",
+    InsufficientTokens: "That is more coins than this wallet holds.",
+    InsufficientCash: "The curve does not hold that much BNB.",
+    ZeroAmount: "That amount is too small to trade.",
+    UnsupportedSwap: "That amount is too small to trade.",
+    BadAmount: "That amount is too small to trade.",
+    ReserveLimit: "That amount is too big for the curve.",
+    AmountTooLarge: "That amount is too big for the curve.",
+    InactivePosition: "That position is already closed.",
+    NotExpired: "This has not run out yet: only its owner can close it now.",
+    UnknownMarket: "This is not a lever coin.",
+    InvalidMarket: "This is not a lever coin.",
+    NoLiquidityPositions: "Only the coin's curve can hold liquidity in this pool.",
+    Unauthorized: "This contract only takes that call from its own router or hook.",
+    // curve calls
+    TooEarly: "Calls open 10 minutes after the launch, and an owner can close a call 10 minutes after it opened.",
+    NotAbove: "That step is not fully above the price any more. Pick a step further up.",
+    TooFar: "A call can be at most 8 steps above the price.",
+    OverCap: "That is more than the step has left to rent: at most 10 % of a step is out at once.",
+    SameBlock: "Someone opened a call on this coin in the same block. Try again.",
+    PremiumTooHigh: "The premium went up since the quote. Try again.",
+    Paused: "PancakeSwap has paused its pools. Calls open again when it resumes.",
+    OffAverage: "The price is far from its 10 minute average right now. Anyone can close an ended call once it settles, or an hour after the end.",
+    NoCall: "That call is already closed.",
+    NothingPending: "Nothing waits for this wallet here.",
+    // curve calls and dip bids
+    TooSmall: "That is too small: below the smallest call or floor.",
+    Duration: "That duration is out of range (calls 10 minutes to 24 hours, floors 10 minutes to 7 days).",
+    Value: "The BNB sent does not match. Quote again.",
+    PayoutTooLow: "The payout fell below the minimum while the transaction waited. Try again.",
+    // dip bids
+    NoCoin: "That is not a coin contract.",
+    Strike: "Set a price for the bid.",
+    Premium: "The premium is between 0.01 % and 50 % of what a floor covers.",
+    Until: "The end of the bid has to be in the future.",
+    Deposit: "A new bid locks at least 0.01 BNB, and at least its smallest floor.",
+    BidOver: "That bid has ended: it takes no new floors.",
+    TooBig: "That is more than this bid or offer has free. Ask for less or pick another one.",
+    // sticky 2 desks (dev cover, dark launch, rule auction, launch desk); TooBig and IsClosed above are shared with dip bids
+    IsClosed: "That bid or offer is closed.",
+    NotWriter: "Only the wallet that posted the offer can do that.",
+    NoOffer: "There is no cover offer with this id.",
+    NoPolicy: "There is no policy with this id.",
+    Mark: "The mark is 10, 25, 50 or 100 % of the creator's coins sold.",
+    Stop: "The stop share has to be at most the mark.",
+    OfferOver: "This offer has ended: it takes no new policies.",
+    MarkHit: "The creator already sold past this mark: no new policies on it.",
+    StopHit: "The creator already sold past this offer's stop share: no new policies.",
+    Creator: "The creator cannot cover its own coin.",
+    OverBag: "A policy can only cover what this wallet's coins are worth right now. Ask for less.",
+    NotTriggered: "The creator has not sold past the mark yet (or it happened inside the 10 minute warm up).",
+    NoRound: "There is no dark round with this id.",
+    NotOpen: "Not every bid is open yet and the opening window is still running.",
+    Over: "This round takes no more bids.",
+    Opened: "That bid is open already.",
+    Nothing: "Nothing left to claim for this bid.",
+    NotSwitcher: "Only the coin's switcher can turn a game on.",
+    AlreadyStarted: "The auction of this coin has started already.",
+    Length: "The coin has no switch rows for the auction.",
+    NotAGame: "That rule is not one of the coin's games.",
+    Zero: "Burn more than nothing.",
+    Burn: "The burn failed: check the balance and the approval to the auction.",
+    NothingToSettle: "There is no auction round to settle for this coin.",
+    NotOperator: "Only the pad's reply bot may launch from a launch desk balance.",
+    NotAllowed: "This wallet has not allowed the bot to launch for it.",
+    Limit: "Over this wallet's limit per launch or per day.",
+    Balance: "Not enough BNB on the launch desk for this.",
+    GasFee: "The gas refund asked for is over the cap of 0.002 BNB.",
+    FeeTooHigh: "That fee is over the contract's cap.",
+    ZeroAddress: "That address is empty.",
+    Ended: "That floor has run out or was already handed in.",
+    NotOver: "Only the owner can end a floor before it runs out.",
+    NotYours: "That floor belongs to another wallet.",
+    NotMaker: "Only the wallet that posted the bid can do that.",
+    Delivery: "The coins could not be handed in: check that this wallet holds them and has approved the desk.",
+    NoBid: "There is no bid with this id.",
+    NoFloor: "There is no floor with this id.",
+    Reentrant: "The desk is busy. Try again.",
+    // HOOKS infra: floors and the protected buy
+    SupplyGrew: "The coin minted new coins since its floor opened, so the floor takes no more hand ins.",
+    Exists: "This coin already has a floor. Feed it instead.",
+    Amount: "Hand in more than zero coins.",
+    SendFailed: "The BNB could not be sent to that address.",
+    TooFewCoins: "The swap brought fewer coins than the minimum. Quote again or allow more slippage.",
+    WrongCoin: "The dip bid is for another coin.",
+    NothingToProtect: "No coins arrived to protect.",
+    Swap: "The swap through PancakeSwap failed.",
+    Target: "The executor only calls PancakeSwap's own routers.",
+};
+/** PancakeSwap's own errors that a trade can run into */
+const PANCAKE = [
+    ["0x5bf6f916", "The trade waited too long and ran out of time (deadline). Try again."],
+    [toFunctionSelector("TooLittleReceived(uint256,uint256)"), "The price moved: the trade would get less than the minimum. Quote again or allow more slippage."],
+    [toFunctionSelector("V3TooLittleReceived()"), "The price moved: the trade would get less than the minimum. Quote again or allow more slippage."],
+    [toFunctionSelector("InsufficientToken()"), "The trade got less than the minimum. Quote again or allow more slippage."],
+    ["0xd964f528", "The pool could not fill the whole amount. Try a smaller one."],
+];
+/** The pickhooks contracts' ABIs that errors are decoded with. */
+const ABIS = [
+    any3FactoryAbi,
+    any3HookAbi,
+    stickyFactoryAbi,
+    stickyValidatorAbi,
+    stickyTokenAbi,
+    sticky2FactoryAbi,
+    sticky2ValidatorAbi,
+    sticky2TokenAbi,
+    coverDeskAbi,
+    ruleAuctionAbi,
+    darkRoundAbi,
+    launchDeskAbi,
+    anyTaxFactoryAbi,
+    anyTaxHookAbi,
+    v1FactoryAbi,
+    v1TokenAbi,
+    v2FactoryAbi,
+    v2TokenAbi,
+    voteBoxAbi,
+    arenaAbi,
+    floorVaultAbi,
+    payrollBoxAbi,
+    poolsFactoryAbi,
+    poolsHookAbi,
+    leverFactoryAbi,
+    leverHookAbi,
+    leverEngineAbi,
+    leverRouterAbi,
+    lever2FactoryAbi,
+    lever2HookAbi,
+    lever2EngineAbi,
+    callsFactoryAbi,
+    callsHookAbi,
+    callsDeskAbi,
+    dipDeskAbi,
+    hooksExecutorAbi,
+    hooksFloorAbi,
+    hooksFloorFactoryAbi,
+    agentsFactoryAbi,
+    agentsHookAbi,
+    agentsDeskAbi,
+];
+/** every error selector the pickhooks ABIs know, for errors that PancakeSwap wraps (WrappedError, the quoter's revert) */
+const SELECTORS = ABIS.flatMap((abi) => abi.filter((x) => x.type === "error").map((x) => ({ sel: toFunctionSelector(formatAbiItem(x)).slice(2).toLowerCase(), abi })));
+/** An error of the SDK: `code` is the contract's error name (or "wallet", "reverted", "input"), `text` a sentence. */
+export class PickhooksError extends Error {
+    code;
+    args;
+    hash;
+    constructor(text, opts) {
+        super(text, { cause: opts.cause });
+        this.name = "PickhooksError";
+        this.code = opts.code;
+        this.args = opts.args;
+        this.hash = opts.hash;
+    }
+}
+/** The revert data inside a viem error (it nests them), or null. */
+export function findRevertData(err) {
+    let e = err;
+    for (let i = 0; i < 10 && e; i++) {
+        if (typeof e.data === "string" && e.data.startsWith("0x") && e.data.length >= 10)
+            return e.data;
+        if (e.data && typeof e.data.data === "string")
+            return e.data.data;
+        e = e.cause;
+    }
+    const m = String(err?.message ?? "").match(/0x[0-9a-f]{8,}/i);
+    return m ? m[0] : null;
+}
+/** A decoded contract error, searched at the start of the revert data and, for wrapped errors, anywhere inside it. */
+export function decodeRevert(data) {
+    for (const abi of ABIS) {
+        try {
+            const d = decodeErrorResult({ abi, data });
+            return { name: d.errorName, args: (d.args ?? []) };
+        }
+        catch {
+            /* not this contract's error */
+        }
+    }
+    const hex = data.toLowerCase().slice(2);
+    // a wrapped error carries the inner revert as bytes: find a known selector on a byte boundary and decode from there
+    for (const { sel, abi } of SELECTORS) {
+        let i = hex.indexOf(sel);
+        while (i >= 0) {
+            if (i % 2 === 0) {
+                try {
+                    const d = decodeErrorResult({ abi, data: `0x${hex.slice(i)}` });
+                    return { name: d.errorName, args: (d.args ?? []) };
+                }
+                catch {
+                    /* trailing bytes of the wrapper: try the selector with its own words only */
+                    try {
+                        const d = decodeErrorResult({ abi, data: `0x${hex.slice(i, i + 8 + 64 * 8)}` });
+                        return { name: d.errorName, args: (d.args ?? []) };
+                    }
+                    catch {
+                        /* keep looking */
+                    }
+                }
+            }
+            i = hex.indexOf(sel, i + 1);
+        }
+    }
+    return null;
+}
+/** require() strings of PancakeSwap's V3 contracts that need a sentence */
+const ERROR_STRING = {
+    "Unexpected error": "PancakeSwap's quoter could not run this trade: the coin refused it, and the quoter does not pass the reason on.",
+    "Transaction too old": "The trade's deadline passed before it was mined. Send it again.",
+    "Too little received": "The price moved more than the slippage allows. Quote again or allow more slippage.",
+    SPL: "The trade would move the price past its limit.",
+};
+/** A contract error as a sentence. */
+export function errorText(name, args) {
+    if (name === "Error")
+        return ERROR_STRING[String(args[0])] ?? `The contract refused: ${String(args[0] ?? "")}`;
+    if (name === "Panic")
+        return `The contract stopped with panic code ${String(args[0] ?? "")}.`;
+    if (name === "Refused")
+        return CHECK_TEXT[Number(args[0])] ?? "The factory refused this coin.";
+    if (name === "Blocked") {
+        const row = Number(args[0]);
+        return row === STICKY_LOCKED ? "Those coins are still locked: they unlock over time." : `Refused by rule ${row + 1} of the coin.`;
+    }
+    if (name === "Bad") {
+        const what = String(args[0] ?? "");
+        if (!what)
+            return "The hook refused these numbers.";
+        return BAD[what] ?? `Refused: ${what}.`;
+    }
+    return BY_NAME[name] ?? `The contract refused (${name}).`;
+}
+/**
+ * Any error as a code and a sentence: a wallet refusal, a pickhooks contract's error (wrapped by PancakeSwap or not), one
+ * of PancakeSwap's trade errors, or the fallback.
+ */
+export function explain(err, fallback = "The transaction would fail.") {
+    if (err instanceof PickhooksError)
+        return { code: err.code, text: err.message, args: err.args };
+    const msg = String(err?.message ?? "");
+    if (/user rejected|denied transaction|rejected the request|\b4001\b/i.test(msg))
+        return { code: "wallet", text: "Cancelled in the wallet. Nothing was sent." };
+    if (/insufficient funds/i.test(msg))
+        return { code: "funds", text: "Not enough BNB in this wallet for the amount plus gas." };
+    const data = findRevertData(err);
+    if (data) {
+        const d = decodeRevert(data);
+        if (d)
+            return { code: d.name, text: errorText(d.name, d.args), args: d.args };
+        const low = data.toLowerCase();
+        for (const [sel, text] of PANCAKE)
+            if (low.includes(sel.slice(2).toLowerCase()))
+                return { code: "pancake", text };
+    }
+    const reason = msg.match(/reverted with the following reason:\s*\n?\s*(.+)/);
+    if (reason)
+        return { code: "reverted", text: `The contract refused: ${reason[1].trim()}` };
+    return { code: "unknown", text: fallback };
+}
+/** Wraps any error as a PickhooksError (keeps the original as `cause`). */
+export function toPickhooksError(err, fallback, hash) {
+    if (err instanceof PickhooksError)
+        return err;
+    const e = explain(err, fallback);
+    return new PickhooksError(e.text, { code: e.code, args: e.args, hash, cause: err });
+}

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+import type { PublicClient } from "viem";
+import type { Addresses } from "./addresses.js";
+import { type AgentsModule } from "./agents.js";
+import { type AnyModule } from "./any.js";
+import { type ApiModule } from "./api.js";
+import { type Block, type BlocksCatalog } from "./blocks.js";
+import { type CoinsModule } from "./coins.js";
+import { type DesksModule } from "./desks.js";
+import { type DipsModule } from "./dips.js";
+import { type InfraModule } from "./infra.js";
+import { type Lever2Module, type LeverModule } from "./lever.js";
+import { type CallsModule, type PoolsModule } from "./pools.js";
+import { type StickyModule } from "./sticky.js";
+import { type PickhooksOptions, type SendOptions, type Sent, type TxRequest } from "./tx.js";
+import { type WalletModule } from "./wallet.js";
+import { type WatchModule } from "./watch.js";
+export type Pickhooks = {
+    addresses: Addresses;
+    publicClient: PublicClient;
+    /** hook any coin: pools next to coins that already trade (v3 with recapture, partners, routers; the tax line when set) */
+    any: AnyModule;
+    /** sticky rules: rules that stick to the coins */
+    sticky: StickyModule;
+    /** sticky 2: the same coins from the second factory, plus what the creator sold and the switch rows (off until it is on mainnet) */
+    sticky2: StickyModule & Pick<DesksModule, "devCounters" | "switches">;
+    /** dev cover and dev bond: cover against the creator selling, paid out of the desk when the creator's sold share reaches the mark */
+    cover: DesksModule["cover"];
+    /** the rule auction: holders burn coins to pick the game of the next round */
+    auction: DesksModule["auction"];
+    /** the dark launch: sealed bids before the coin exists, one price for everyone, born with BNB on both sides */
+    dark: DesksModule["dark"];
+    /** the launch desk of launch per reply: a wallet's balance the pad's bot may launch with, for that wallet only */
+    launchDesk: DesksModule["desk"];
+    /** coins with their rules in the coin (v1 and v2, also find the dev and CZ mode coins) */
+    coins: CoinsModule;
+    /** pools: coins with their rules in a PancakeSwap Infinity pool hook */
+    pools: PoolsModule;
+    /** curve calls: rent a step of a coin's curve */
+    calls: CallsModule;
+    /** Lever (v2): real liquidity, longs and shorts */
+    lever: Lever2Module;
+    /** lever (v1): the engine curve with longs */
+    leverV1: LeverModule;
+    /** dip bids: floors at a strike */
+    dips: DipsModule;
+    /** HOOKS infra: BNB floors under coins and the protected buy */
+    infra: InfraModule;
+    /** agents: coins run by an agent that rewrites their rules live, inside limits the chain checks; be the agent yourself (brief, act) */
+    agents: AgentsModule;
+    /** live events: every launch on the pad, every trade of a coin, everything that happens to an agent coin */
+    watch: WatchModule;
+    /** one address: everything it holds on pickhooks, what it can sell now, what it can claim */
+    wallet: WalletModule;
+    /** the building blocks: sticky rules' ready blocks with their numbers and rows, the hook script grammar, the rule book (offline; ph.api.blocks() asks the site) */
+    blocks: {
+        catalog: () => BlocksCatalog;
+        block: (id: string) => Block | null;
+    };
+    /** pickhooks.com's public JSON API */
+    api: ApiModule;
+    /** sends any TxRequest the build helpers return (estimate x gasPct + its extraGas) and waits for the receipt */
+    send: (tx: TxRequest, o?: SendOptions) => Promise<Sent>;
+    sendAll: (txs: TxRequest[], o?: SendOptions) => Promise<Sent[]>;
+};
+/**
+ * The pickhooks SDK. One client, a part per product:
+ *   any      hook any coin: quotes, trades with the recapture room, opening a pool with a partner, the payouts
+ *   sticky   sticky rules: launching from templates, checking a trade against the coin's table, trading, lifting
+ *   sticky2  sticky 2 (the same, plus what the creator sold); cover: dev cover and dev bond; auction: the rule auction;
+ *            dark: the dark launch (sealed bids, @pickhooks/sdk/tlock seals them); launchDesk: launch per reply's balance
+ *   coins    coins with rules in the coin (v1, v2): rules as sentences, the rule that would refuse a trade, launches
+ *   pools    rules in the pool; calls: curve calls; lever: Lever longs and shorts (leverV1 the first lever); dips: dip bids
+ *   agents   coins run by an agent: read the program, brief any model, act as the pilot, veto and fire as a holder
+ *   watch    live events (launches, trades, agent changes); wallet: one address, everything it holds and can claim
+ *   api      pickhooks.com's public JSON API (launch feed, board, activity)
+ *
+ *   const ph = createPickhooks({ walletClient });
+ *   const [pool] = await ph.any.pools({ limit: 1 });
+ *   const r = await ph.any.buy({ pool, bnbIn: parseEther("0.05") });
+ */
+export declare function createPickhooks(options?: PickhooksOptions): Pickhooks;
+export { BSC_MAINNET, LIMITS, NATIVE, ZERO_ADDRESS, type Addresses } from "./addresses.js";
+export { CHECK_TEXT, PickhooksError, decodeRevert, errorText, explain, findRevertData } from "./errors.js";
+export { DEFAULT_RPC, deadlineIn, minusBps, type PickhooksOptions, type SendOptions, type Sent, type TxRequest } from "./tx.js";
+export { blockedKind, buildInfiSwap, infiPriceBnb, infiQuote, infiSwapInput, permit2Approvals, poolIdOf, toKey, type PoolKey } from "./infinity.js";
+export { approvalFor, buildV3Buy, buildV3Sell, receivedOf, v3PriceBnb, v3Quote } from "./v3.js";
+export { type Venue, bestVenue, buildV2Buy, buildV2Sell, v2Quote, v2RouterAbi } from "./v2.js";
+export { MAX_TICK, MIN_TICK, TAX_QUOTE_MARK, afterTax, depthNeeds, fitLadder, partnerLink, rangeFor, tickOf, type AnyLine, type AnyModule, type AnyPool, type AnyQuote, type CoinCheck, type Earnings, type OpenOptions, type OpenParams, type PoolConfig, type PoolPosition, type PoolRef, type RangeKind, type Recapture, type TaxLive, type TradeResult, } from "./any.js";
+export { describeRows, stickyTable, stickyTestRun, testRunText, type StickyTestRun, type StickyCheck, type StickyCoin, type StickyLaunch, type StickyLot, type StickyModule, type StickyRow, type StickyTerms, } from "./sticky.js";
+export { CURVE, SUPPLY, simulate, type SimReport } from "./sticky-sim.js";
+export { ruleText, type CoinRule, type CoinsModule, type RuleCheck, type RuleCoin, type RuleCoinVersion, type RuleLaunch } from "./coins.js";
+export { type CallRow, type CallStep, type CallsModule, type HookCoin, type HookLaunch, type PoolsModule } from "./pools.js";
+export { LEVER2_REASON, type Lever2CloseQuote, type Lever2Module, type Lever2OpenQuote, type Lever2Row, type Lever2State, type LeverCoin, type LeverMarket, type LeverModule, type LeverPosition, } from "./lever.js";
+export { coinsFor, coverOf, strikeFromPrice, type DipBid, type DipFloor, type DipPost, type DipsModule } from "./dips.js";
+export { type ApiModule, type Launch, type LaunchFeed } from "./api.js";
+export { type AuctionState, type CoverOffer, type CoverPolicy, type CoverPost, type DarkBid, type DarkRoundState, type DesksModule, type DevCounters, } from "./desks.js";
+export { type FloorState, type InfraModule, type ProtectOffer } from "./infra.js";
+export { type AgentCoin, type AgentLaunch, type AgentLock, type AgentLook, type AgentPending, type AgentsModule, type JournalEntry } from "./agents.js";
+export { AGENT_LIMITS, AGENT_RULES, AGENT_RULE_BY_ID, AGENT_RULE_BY_KIND, ALLOWED_MASK, ANSWER_SCHEMA, BUCKETS, ENVELOPE_TUPLE, OBJECTIVES, PERSONALITIES, PROGRAM_TUPLE, agentKindsOf, decodeProgram, describeProgram, encodeProgram, noteHash, parseAnswer, readPlan, starterEnvelope, starterProgram, systemPrompt, toPlan, toProgram, userPrompt, type AgentAnswer, type AgentProfile, type AgentRule, type AgentRuleField, type Bucket, type Envelope, type Plan, type Program, } from "./agents-catalog.js";
+export { type AgentEvent, type WatchMode, type WatchOptions, type WatchModule, type WatchedLaunch, type WatchedTrade } from "./watch.js";
+export { type WalletCoin, type WalletModule, type WalletView } from "./wallet.js";
+export { BLOCKS_VERSION, BLOCK_ACTIONS, BLOCK_CHECKS, BLOCK_MARKS, BLOCK_OPERATORS, BLOCK_TRIGGERS, blockLineVars, blocksCatalog, type Block, type BlockAction, type BlockParam, type BlockVariable, type BlocksCatalog, type CoinRuleBlock, type CoinRuleField, type GrammarItem, } from "./blocks.js";
+export { ACT, FLAG, LOCKED, NONE, ON, OP, STICKY_LIMITS, TEMPLATES, TEMPLATE_BY_ID, VAR, VARS, VAR_BY_ID, compile, decodeRow, defaults, editToRow, emptyEditRow, encodeRow, paramProblems, rowProblems, rowText, scannerOf, tableProblems, templateOf, type Cond, type EditCond, type EditRow, type Pick, type Row, type Template, type TemplateId, } from "./sticky-rules.js";
+export { GROUPS, RULES, RULE_BY_ID, RULE_BY_KIND, buildRules, emptyExtras, emptyRules, fieldProblem, kindsOf, refusal, selectionProblem, v2Costs, worstScanner, defaults as ruleDefaults, type Picked, type R as CoinRules, type RuleDef, type X as CoinExtras, } from "./coin-rules.js";

package/dist/index.js

@@ -0,0 +1,91 @@
+import { agentsModule } from "./agents.js";
+import { anyModule } from "./any.js";
+import { apiModule } from "./api.js";
+import { blocksCatalog } from "./blocks.js";
+import { coinsModule } from "./coins.js";
+import { desksModule } from "./desks.js";
+import { dipsModule } from "./dips.js";
+import { infraModule } from "./infra.js";
+import { lever2Module, leverModule } from "./lever.js";
+import { callsModule, poolsModule } from "./pools.js";
+import { stickyModule } from "./sticky.js";
+import { makeCtx, sendAll, sendTx } from "./tx.js";
+import { walletModule } from "./wallet.js";
+import { watchModule } from "./watch.js";
+/**
+ * The pickhooks SDK. One client, a part per product:
+ *   any      hook any coin: quotes, trades with the recapture room, opening a pool with a partner, the payouts
+ *   sticky   sticky rules: launching from templates, checking a trade against the coin's table, trading, lifting
+ *   sticky2  sticky 2 (the same, plus what the creator sold); cover: dev cover and dev bond; auction: the rule auction;
+ *            dark: the dark launch (sealed bids, @pickhooks/sdk/tlock seals them); launchDesk: launch per reply's balance
+ *   coins    coins with rules in the coin (v1, v2): rules as sentences, the rule that would refuse a trade, launches
+ *   pools    rules in the pool; calls: curve calls; lever: Lever longs and shorts (leverV1 the first lever); dips: dip bids
+ *   agents   coins run by an agent: read the program, brief any model, act as the pilot, veto and fire as a holder
+ *   watch    live events (launches, trades, agent changes); wallet: one address, everything it holds and can claim
+ *   api      pickhooks.com's public JSON API (launch feed, board, activity)
+ *
+ *   const ph = createPickhooks({ walletClient });
+ *   const [pool] = await ph.any.pools({ limit: 1 });
+ *   const r = await ph.any.buy({ pool, bnbIn: parseEther("0.05") });
+ */
+export function createPickhooks(options = {}) {
+    const ctx = makeCtx(options);
+    const d = desksModule(ctx);
+    const sticky = stickyModule(ctx);
+    const sticky2 = stickyModule(ctx, true);
+    const coins = coinsModule(ctx);
+    const pools = poolsModule(ctx);
+    const calls = callsModule(ctx);
+    const lever = lever2Module(ctx);
+    const dips = dipsModule(ctx);
+    const any = anyModule(ctx);
+    const agents = agentsModule(ctx);
+    return {
+        addresses: ctx.a,
+        publicClient: ctx.pub,
+        any,
+        sticky,
+        sticky2: { ...sticky2, devCounters: d.devCounters, switches: d.switches },
+        cover: d.cover,
+        auction: d.auction,
+        dark: d.dark,
+        launchDesk: d.desk,
+        coins,
+        pools,
+        calls,
+        lever,
+        leverV1: leverModule(ctx),
+        dips,
+        infra: infraModule(ctx),
+        agents,
+        watch: watchModule(ctx, { sticky, sticky2, coins, pools, calls, agents, any }),
+        wallet: walletModule(ctx, { sticky, sticky2, coins, pools, calls, lever, agents, any, dips }),
+        blocks: { catalog: blocksCatalog, block: (id) => blocksCatalog().sticky.blocks.find((b) => b.id === id) ?? null },
+        api: apiModule(ctx),
+        send: (tx, o) => sendTx(ctx, tx, o),
+        sendAll: (txs, o) => sendAll(ctx, txs, o),
+    };
+}
+export { BSC_MAINNET, LIMITS, NATIVE, ZERO_ADDRESS } from "./addresses.js";
+export { CHECK_TEXT, PickhooksError, decodeRevert, errorText, explain, findRevertData } from "./errors.js";
+export { DEFAULT_RPC, deadlineIn, minusBps } from "./tx.js";
+export { blockedKind, buildInfiSwap, infiPriceBnb, infiQuote, infiSwapInput, permit2Approvals, poolIdOf, toKey } from "./infinity.js";
+export { approvalFor, buildV3Buy, buildV3Sell, receivedOf, v3PriceBnb, v3Quote } from "./v3.js";
+export { bestVenue, buildV2Buy, buildV2Sell, v2Quote, v2RouterAbi } from "./v2.js";
+export { MAX_TICK, MIN_TICK, TAX_QUOTE_MARK, afterTax, depthNeeds, fitLadder, partnerLink, rangeFor, tickOf, } from "./any.js";
+export { describeRows, stickyTable, stickyTestRun, testRunText, } from "./sticky.js";
+export { CURVE, SUPPLY, simulate } from "./sticky-sim.js";
+export { ruleText } from "./coins.js";
+export {} from "./pools.js";
+export { LEVER2_REASON, } from "./lever.js";
+export { coinsFor, coverOf, strikeFromPrice } from "./dips.js";
+export {} from "./api.js";
+export {} from "./desks.js";
+export {} from "./infra.js";
+export {} from "./agents.js";
+export { AGENT_LIMITS, AGENT_RULES, AGENT_RULE_BY_ID, AGENT_RULE_BY_KIND, ALLOWED_MASK, ANSWER_SCHEMA, BUCKETS, ENVELOPE_TUPLE, OBJECTIVES, PERSONALITIES, PROGRAM_TUPLE, agentKindsOf, decodeProgram, describeProgram, encodeProgram, noteHash, parseAnswer, readPlan, starterEnvelope, starterProgram, systemPrompt, toPlan, toProgram, userPrompt, } from "./agents-catalog.js";
+export {} from "./watch.js";
+export {} from "./wallet.js";
+export { BLOCKS_VERSION, BLOCK_ACTIONS, BLOCK_CHECKS, BLOCK_MARKS, BLOCK_OPERATORS, BLOCK_TRIGGERS, blockLineVars, blocksCatalog, } from "./blocks.js";
+export { ACT, FLAG, LOCKED, NONE, ON, OP, STICKY_LIMITS, TEMPLATES, TEMPLATE_BY_ID, VAR, VARS, VAR_BY_ID, compile, decodeRow, defaults, editToRow, emptyEditRow, encodeRow, paramProblems, rowProblems, rowText, scannerOf, tableProblems, templateOf, } from "./sticky-rules.js";
+export { GROUPS, RULES, RULE_BY_ID, RULE_BY_KIND, buildRules, emptyExtras, emptyRules, fieldProblem, kindsOf, refusal, selectionProblem, v2Costs, worstScanner, defaults as ruleDefaults, } from "./coin-rules.js";