Sally protocol contracts

struct SwapPathData {
  uint8     version;     // V2=0 · V3=1 · V4=2
  address[] path;        // token hops
  uint256[] dexPath;     // per hop: dexId, or for
                         //   V4 = (fee<<24)|tickSpacing
  address[] pools;       // resolved pools (0x0 for V4)
  address   baseToken;   // intermediary
  uint256   estimatedAmountOut;
}
struct HybridSwapData {
  SwapPathData firstStep;
  SwapPathData secondStep;
  SwapPathData thirdStep;
  uint8        stepCount; // how many are populated
}

struct TokenInfos {
  uint256 buyEstimate;
  uint256 buyResult;     // actual received on buy
  uint256 sellEstimate;
  uint256 sellResult;    // actual received on sell
  bool    buySuccess;
  bool    approveSuccess;
  bool    sellSuccess;   // false ⇒ honeypot signal
}

struct V4Pos {
  address positionManager;
  uint256 tokenId;
  bytes32 poolId;
  address currency0; address currency1;
  uint24  fee; int24 tickSpacing; address hooks;
  int24   tickLower; int24 tickUpper;
  uint128 liquidity;
  bool    locked; uint256 unlockTime;
}

struct Lock {
  uint8   kind;          // 0=V2 1=V3 2=V4
  address asset;         // LP token / NFT manager
  uint256 tokenIdOrAmount;
  uint256 lockTime; uint256 unlockTime;
  address owner;
  address tokenA; address tokenB;
  uint256 nonce;
}

# version() on the swap proxy (both chains)
cast call 0x7777D0e2e2d772b5D750540B3932261574e87777 \
  "version()(bytes7)" --rpc-url $BASE_RPC
# → 0x76322e312e3000

# spot-mid vs execution price (WETH on Base)
cast call $SWAP "getUsdPrice(address)(uint256,address)" \
  0x4200000000000000000000000000000000000006 --rpc-url $BASE_RPC
cast call $SWAP "getUsdPriceImpact(address)(uint256,address)" \
  0x4200000000000000000000000000000000000006 --rpc-url $BASE_RPC

# sidecar view via the LIQUIDITY proxy (fallback)
cast call 0x7777d7fFF155B043CE0A0785dd8c8c42bEbe7777 \
  "getLocks(address)" $WALLET --rpc-url $BASE_RPC

# ── governance (Base) ──────────────────────────────────
GOV=0x777771f98153d85799360d65dde84e5cd3d17777   # Governor
TL=0x777793a53e3d6069686d3e2f87f4df0a4b027777    # Timelock 48h
# confirm the Timelock owns the swap proxy
cast call $SWAP "owner()(address)" --rpc-url $BASE_RPC  # → $TL
cast call $TL "getMinDelay()(uint256)" --rpc-url $BASE_RPC  # → 172800
# state(id) → 0 Pending 1 Active 2 Canceled 3 Defeated
#            4 Succeeded 5 Queued 6 Expired 7 Executed
cast call $GOV "state(uint256)(uint8)" $ID --rpc-url $BASE_RPC
cast call $GOV "proposalVotes(uint256)(uint256,uint256,uint256)" \
  $ID --rpc-url $BASE_RPC  # → (against, for, abstain)

import { createPublicClient, http } from 'viem'
import { base } from 'viem/chains'

const c = createPublicClient({ chain: base, transport: http() })
const SWAP = '0x7777D0e2e2d772b5D750540B3932261574e87777'
const LIQ  = '0x7777d7fFF155B043CE0A0785dd8c8c42bEbe7777'

// Lens view via the swap proxy (proxy addr + Lens ABI)
const [price] = await c.readContract({
  address: SWAP, abi: LENS_ABI,
  functionName: 'getUsdPrice', args: [weth],
})

// Sidecar view via the liquidity proxy (proxy addr + Sidecar ABI)
const v4 = await c.readContract({
  address: LIQ, abi: SIDECAR_ABI,
  functionName: 'getV4Positions', args: [wallet, 0n, 50n],
})

// Governance: proposal state + tally (Base Governor)
const GOV = '0x777771f98153d85799360d65dde84e5cd3d17777'
const state = await c.readContract({
  address: GOV, abi: GOVERNOR_ABI,
  functionName: 'state', args: [proposalId],
}) // 0 Pending · 1 Active · … · 7 Executed
const [against, forVotes, abstain] = await c.readContract({
  address: GOV, abi: GOVERNOR_ABI,
  functionName: 'proposalVotes', args: [proposalId],
})