@solard/cli 0.2.16 → 0.2.17

package/src/index.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
+import { configure } from "measure-fn";
 import {
   addExternalContact,
-  configureSolardMeasure,
   createSolardMeasureCollector,
   executeRegistrySolSweep,
   executeRegistryTokenLiquidation,
@@ -21,10 +21,10 @@ import {
   simulateRegistryTokenLiquidation,
   wrappedSolAta,
   type TokenRow,
-} from "@solard/sdk";
+} from "@solard/core";
 
 import { handleMeteoraCommand } from "./meteora-commands.ts";
-import { handleFairfunCommand } from "./fairfun-commands.ts";
+import { handleAccountingCommand } from "./accounting-commands.ts";
 import { resolveDestinationRef } from "./refs.ts";
 import {
   VaultOnboardingError,
@@ -77,7 +77,12 @@ function int(flags: Flags, key: string, fallback?: number): number | undefined {
 function json(value: unknown): string {
   return JSON.stringify(
     value,
-    (_, item) => (typeof item === "bigint" ? item.toString() : item),
+    (_, item) =>
+      typeof item === "bigint"
+        ? item.toString()
+        : item instanceof Map
+          ? Object.fromEntries(item)
+          : item,
     2,
   );
 }
@@ -319,7 +324,7 @@ function commandNeedsSigningVault(
 }
 
 async function storedWalletCount(): Promise<number> {
-  const { createTraderSolard } = await import("@solard/sdk");
+  const { createTraderSolard } = await import("@solard/core");
   const probe = createTraderSolard();
   try {
     return (probe.db.wallets.select().all() as unknown[]).length;
@@ -357,6 +362,8 @@ External contacts (public addresses only; never signing wallets or group members
   slrd tokens
   slrd holders <token|ca> [--exclude <a,b>] [--min-raw N] [--json]         Complete on-chain holder snapshot
   slrd events <token|ca> [--all|--swaps|--transfers|--creates] [--jsonl]     Live typed Pump/PumpSwap + transfer/create stream
+  slrd events history <token|ca> [--provider auto|solscan|rpc] [--from-slot N] [--to-slot N] [--slot-order] [--json]
+                                                        Historical holder-balance movements with explicit completeness verification
 
 Vanity mints
   slrd vanity --suffix pump --out .\\mint.json [--count <n>]
@@ -398,8 +405,8 @@ Transfers and consolidation
                                                         Without --wallets, sweep considers all stored signing wallets
 
 Token liquidation
-  slrd liquidate tokens --except <token|mint> [--wallets <a,b,...>] [--slippage-bps 1500] [--no-jupiter] [--burn-unsellable] [--simulate | --live]
-                                                        Sell supported tokens except protected mint(s); unwrap WSOL; close unprotected zero-balance token accounts and reclaim rent
+  slrd liquidate tokens [--except <token|mint>] [--wallets <a,b,...>] [--except-wallet <wallet>] [--except-wallets <a,b,...>] [--slippage-bps 1500] [--no-jupiter] [--burn-unsellable] [--simulate | --live]
+                                                        Sell all supported tokens unless protected with --except; excluded wallets are not scanned or touched
 
 RPC
   All Solard JSON-RPC traffic is globally rate-limited to 5 req/s by default.
@@ -424,11 +431,15 @@ Trading
   slrd transfer-many --wallet <wallet> (--token <mint>|--sol) --file <allocations.json> [--id <stable-id> --live]
   slrd transfer-many status <stable-id>
   slrd transfer-many resume <stable-id> [--sender rpc|helius]
-  slrd rewards distribute <token|ca> --wallet <beneficiary> --id <ledger-id> --snapshot <snapshot.json> [--reward-mint <mint>] [--live]
-                                                        Snapshot contains cumulative totalClaimedRaw + recipients[].entitledRaw; Solard tracks confirmed payouts
-  slrd rewards status <distribution-id>
+  slrd rewards history <token|ca> [--wallet <reward-recipient>] [--provider auto|solscan|rpc] [--json]
+  slrd rewards distribute <token|ca> --wallet <beneficiary> --snapshot <snapshot.json> [--reward-mint <mint>] [--live]
+                                                        Pay every outstanding cumulative holder entitlement and exit when complete
+  slrd rewards stop <token|ca>                         Ask the currently running distribution for this token to stop before its next transfer
+  slrd rewards status <token|ca>                       Show remembered cumulative entitlement/payment state
+  slrd rewards audit <token|ca> [--holder <wallet>]   Show entitlement and confirmed-payment history
   slrd rewards inspect <token|ca>                      Show claim source, quote asset, estimated accrued creator reward, and payout address
-  slrd rewards claim <token|ca> --wallet <fee-payer>  Claim creator rewards; on-chain beneficiary receives the reward
+  slrd rewards claim <token|ca> --wallet <fee-payer> [--id <stable-claim-id> --basis <reward-basis.json>]
+  slrd rewards claim-status <stable-claim-id>
 
 Scripts (strategies stay outside the kernel)
   slrd scripts                              List scripts registered in slrd.config.ts
@@ -483,6 +494,7 @@ Environment
   RPC_ENDPOINT      required only for chain operations
   HELIUS_SENDER_URL regional/global Helius Sender endpoint used by launch scripts
   HELIUS_RPC_URL    RPC endpoint used for ordinary Helius-RPC buyer lane
+  SOLSCAN_API_KEY   optional indexed token-history provider; enables authoritative historical transfer reconstruction
   HELIUS_TIP_ACCOUNT, HELIUS_TIP_LAMPORTS, HELIUS_PRIORITY_MICRO_LAMPORTS launch transport policy
   SLRD_LAUNCH_*     launch resend/timeout policy; shared environment, not per-token metadata
   JITO_BLOCK_ENGINE_URL only when explicitly selecting the separate Jito sender
@@ -508,7 +520,7 @@ async function main() {
     flags.has("measure-stream") ||
     process.env.SLRD_MEASURE_STREAM === "1" ||
     process.env.SLRD_MEASURE_STREAM === "true";
-  configureSolardMeasure(
+  configure(
     streamMeasures
       ? {
           silent: false,
@@ -638,7 +650,7 @@ async function main() {
       listVanityMintPool,
       releaseVanityMintReservation,
       saveMintKeypairFile,
-    } = await import("@solard/sdk");
+    } = await import("@solard/core");
 
     if (values[0] === "pool") {
       const action = values[1] ?? "list";
@@ -816,13 +828,13 @@ async function main() {
       process.env.JITO_BLOCK_ENGINE_URL ??
       "https://mainnet.block-engine.jito.wtf"
     ).replace(/\/$/, "");
-    const { getJitoTipAccounts } = await import("@solard/sdk");
+    const { getJitoTipAccounts } = await import("@solard/core");
     const tipAccounts = await getJitoTipAccounts(endpoint);
     emit(json({ endpoint, tipAccounts }) + "\n");
     return;
   }
   if (command === "metadata" && values[0] === "upload") {
-    const { uploadPumpMetadata } = await import("@solard/sdk");
+    const { uploadPumpMetadata } = await import("@solard/core");
     const uploaded = await uploadPumpMetadata(
       {
         imagePath: need(flags, "image"),
@@ -848,13 +860,13 @@ async function main() {
   }
   const [{ sol, formatRaw }, { shortKey }, { createTraderSolard }] =
     await Promise.all([
-      import("@solard/sdk"),
-      import("@solard/sdk"),
-      import("@solard/sdk"),
+      import("@solard/core"),
+      import("@solard/core"),
+      import("@solard/core"),
     ]);
   const slrd = createTraderSolard();
   try {
-    if (await handleFairfunCommand({ command, values, flags, slrd, emit })) {
+    if (await handleAccountingCommand({ command, values, flags, slrd, emit })) {
       return;
     }
 
@@ -986,11 +998,8 @@ async function main() {
             (vanityResult
               ? `  vanity   suffix=${vanityResult.suffix} attempts=${vanityResult.attempts}\n`
               : "") +
-            `  storage  encrypted in Solard's local wallet database\n` +
-            `  password NOT saved; you will enter it again next invocation\n` +
             `╰──────────────────────────────────────────────────────╯\n` +
-            `\nNext:  slrd balances --wallet ${wallet.name}\n` +
-            `Backup: slrd export ${wallet.name} --out .\\${wallet.name}-key.txt\n`,
+            `\nNext:  slrd balances --wallet ${wallet.name}\n`,
         );
       } else {
         emit(`${OWL} created @${wallet.name} ${wallet.address}\n`);
@@ -1612,7 +1621,7 @@ async function main() {
           throw new Error(
             "Provide --uri <metadata_uri> or --image <local_path> --description <text>",
           );
-        const { uploadPumpMetadata } = await import("@solard/sdk");
+        const { uploadPumpMetadata } = await import("@solard/core");
         uploadedMetadata = await uploadPumpMetadata(
           {
             imagePath: need(flags, "image"),
@@ -1864,11 +1873,18 @@ async function main() {
     }
     if (command === "liquidate" && (values[0] ?? "tokens") === "tokens") {
       const except = csv(flags.get("except"));
-      if (except.length === 0) {
-        throw new Error(
-          "Usage: slrd liquidate tokens --except <token|mint>[,<token|mint>...] [--wallets <a,b,...>] [--burn-unsellable] [--simulate | --live]",
-        );
-      }
+      const exceptWalletValue =
+        flags.get("except-wallet") ?? flags.get("exceptWallet");
+      const exceptWalletsValue =
+        flags.get("except-wallets") ?? flags.get("exceptWallets");
+      if (exceptWalletValue === "true")
+        throw new Error("Missing --except-wallet <wallet>");
+      if (exceptWalletsValue === "true")
+        throw new Error("Missing --except-wallets <a,b,...>");
+      const exceptWalletRefs = [
+        ...(exceptWalletValue ? [exceptWalletValue] : []),
+        ...csv(exceptWalletsValue),
+      ].filter((ref, index, refs) => refs.indexOf(ref) === index);
       if (flags.has("simulate") && flags.has("live")) {
         throw new Error("Use either --simulate or --live, not both");
       }
@@ -1884,6 +1900,10 @@ async function main() {
         const mint = resolveTokenMintForPolicy(slrd, ref);
         emit(`PROTECT  ${ref} -> ${mint}\n`);
       }
+      for (const ref of exceptWalletRefs) {
+        const wallet = slrd.resolveWallet(ref);
+        emit(`EXCLUDE  ${ref} -> ${wallet.address.toBase58()}\n`);
+      }
       emit(
         `RPC      hard limit ${process.env.SLRD_RPC_MAX_RPS ?? "5"} req/s\n`,
       );
@@ -1899,19 +1919,27 @@ async function main() {
           name: string | null;
           amountUi: string;
           kind: string;
+          tokenAccount?: string;
         },
       ) => {
         const label = action.symbol ?? action.name ?? shortKey(action.mint);
+        const account =
+          action.kind === "close-empty" && action.tokenAccount
+            ? flags.has("verbose")
+              ? action.tokenAccount
+              : shortKey(action.tokenAccount)
+            : null;
         emit(
           `${prefix} ${index}/${total}  @${action.walletName}  ` +
             `${action.kind === "unwrap-wsol" ? "WSOL" : label}  ${action.amountUi}` +
-            `${action.kind === "close-empty" ? "  [close empty account]" : ""}\n`,
+            `${action.kind === "close-empty" ? `  [close empty account${account ? ` ${account}` : ""}]` : ""}\n`,
         );
       };
 
       const options = {
         except,
         walletRefs: csv(flags.get("wallets")),
+        exceptWalletRefs,
         slippageBps: int(flags, "slippage-bps", 1500) ?? 1500,
         via: flags.get("sender") ?? "rpc",
         delayMs: int(flags, "delay-ms", 0) ?? 0,
@@ -1941,6 +1969,13 @@ async function main() {
             );
           } else if (event.stage === "action-done") {
             showAction("OK  ", event.index, event.total, event.action);
+          } else if (event.stage === "action-pending") {
+            showAction("WAIT", event.index, event.total, event.action);
+            if (flags.has("verbose")) {
+              emit(
+                `         attempt=${event.attempt}/${event.maxAttempts} signature=${event.signature ?? "-"} ${event.reason}\n`,
+              );
+            }
           } else if (event.stage === "action-error") {
             showAction("FAIL", event.index, event.total, event.action);
             emit(`         ${event.error}\n`);
@@ -1981,7 +2016,7 @@ async function main() {
         }
 
         emit(
-          `KEEP     ${plan.totals.keepProtected} protected SLRD holding(s)\n` +
+          `KEEP     ${plan.totals.keepProtected} protected token holding(s)\n` +
             `SKIP     ${plan.totals.skipUnsupported} unsupported/no-liquidity holding(s)`,
         );
         if (plan.totals.skipUnsupported > 0) {
@@ -2423,23 +2458,84 @@ async function main() {
     }
     if (command === "rewards") {
       const action = values[0] ?? "inspect";
+
+      if (action === "claim-status") {
+        const id = values[1];
+        if (!id)
+          throw new Error("Usage: slrd rewards claim-status <stable-claim-id>");
+        emit(json(slrd.claims.creatorFees.status(id)) + "\n");
+        return;
+      }
+
       const tokenRef = values[1];
       if (!tokenRef)
         throw new Error(
-          "Usage: slrd rewards <inspect|claim> <token|ca> [--wallet <fee-payer>]",
+          "Usage: slrd rewards <inspect|claim|claim-status> <token|ca> [--wallet <fee-payer>]",
         );
 
       if (action === "claim") {
         const wallet = need(flags, "wallet");
-        const receipt = await slrd.claim(tokenRef, wallet, {
+        const basisPath = flags.get("basis");
+        let basis:
+          | {
+              id: string;
+              slot: number;
+              hash: string;
+              observedAtMs?: number | null;
+            }
+          | undefined;
+        if (basisPath && basisPath !== "true") {
+          const { readFileSync } = await import("node:fs");
+          const { resolve } = await import("node:path");
+          const parsed = JSON.parse(
+            readFileSync(resolve(basisPath), "utf8"),
+          ) as Record<string, unknown>;
+          if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            throw new Error("Reward basis file must contain a JSON object");
+          basis = {
+            id: String(parsed.id ?? "").trim(),
+            slot: Number(parsed.slot),
+            hash: String(parsed.hash ?? "").trim(),
+            observedAtMs:
+              parsed.observedAtMs == null ? null : Number(parsed.observedAtMs),
+          };
+        }
+        const result = await slrd.claims.creatorFees.claim(tokenRef, wallet, {
+          id: flags.get("id"),
+          basis,
           via: flags.get("sender") ?? "rpc",
+          skipSimulation: flags.has("skip-simulation"),
+          skipPreflight: flags.has("skip-preflight"),
         });
         emit(
           json({
             action: "claim",
-            token: tokenRef,
-            feePayer: wallet,
-            receipt,
+            claimId: result.claimId,
+            token: result.tokenMint,
+            feePayer: result.feePayer,
+            source: result.source,
+            quote: result.quoteAsset,
+            estimatedClaimRaw: result.estimatedClaimRaw,
+            claimedRaw: result.claimedRaw,
+            claimedUi:
+              result.claimedRaw == null
+                ? null
+                : formatRaw(result.claimedRaw, result.quoteAsset.decimals),
+            payouts: result.payouts,
+            receipt: result.receipt,
+            basis: result.basis,
+            checkpoint:
+              result.claimedRaw == null
+                ? null
+                : {
+                    id: result.claimId ?? result.claimSignature,
+                    claimSignature: result.claimSignature,
+                    slot: result.claimSlot,
+                    claimedRaw: result.claimedRaw,
+                    quoteMint: result.quoteAsset.mint,
+                    observedAtMs: result.observedAtMs,
+                    basis: result.basis,
+                  },
           }) + "\n",
         );
         return;
@@ -2449,24 +2545,27 @@ async function main() {
         let token = slrd.resolveToken(tokenRef);
         try {
           token = await slrd.refreshToken(token);
-        } catch {
-          // A registered token can still expose a useful claim plan when one
-          // enrichment source is temporarily unavailable.
-        }
+        } catch {}
         const { PublicKey } = await import("@solana/web3.js");
         const probeUser = token.creator
           ? new PublicKey(token.creator)
           : new PublicKey(token.mint);
         const plan = await slrd.resolveClaim(token, probeUser);
+        const payoutAddresses = plan.payouts?.length
+          ? plan.payouts.map((row) => row.address.toBase58())
+          : typeof plan.meta?.payoutAddress === "string"
+            ? [plan.meta.payoutAddress]
+            : token.creator
+              ? [token.creator]
+              : [];
         const payoutAddress =
-          typeof plan.meta?.payoutAddress === "string"
-            ? plan.meta.payoutAddress
-            : token.creator;
+          payoutAddresses.length === 1 ? payoutAddresses[0] : null;
         const output = {
           action: "inspect",
           token: token.mint,
           source: plan.source,
           payoutAddress: payoutAddress ?? null,
+          payoutAddresses,
           quote: {
             kind: plan.quoteAsset.kind,
             mint: plan.quoteAsset.mint.toBase58(),
@@ -2486,7 +2585,7 @@ async function main() {
         return;
       }
 
-      throw new Error("Usage: slrd rewards <inspect|claim> <token|ca>");
+      throw new Error("Usage: slrd rewards <inspect|claim|claim-status> ...");
     }
 
     if (command === "claim") {

package/src/meteora-commands.ts

@@ -5,7 +5,7 @@ import {
   type MeteoraStrategy,
   type MeteoraTimeframe,
   type Solard,
-} from "@solard/sdk";
+} from "@solard/core";
 
 const WSOL = "So11111111111111111111111111111111111111112";
 

package/src/pump/external-deployment-cli.ts

@@ -5,7 +5,7 @@ import {
   buildPumpExternalDeployment,
   createTraderSolard,
   type PumpExternalDeploymentBuild,
-} from "@solard/sdk";
+} from "@solard/core";
 
 export type ExternalPumpFlags = Map<string, string>;
 

package/src/pump/spam-buy-cli.ts

@@ -13,7 +13,7 @@ import {
   type PumpSpamBuyRunResult,
   type PumpSpamBuySettings,
   type SenderId,
-} from "@solard/sdk";
+} from "@solard/core";
 import {
   bigintFlag,
   enabled,

package/src/pump/token-launch-cli.ts

@@ -44,7 +44,7 @@ import {
   type TokenMetadata,
   type TraderSubmitMode,
   type VanityMintPoolReservation,
-} from "@solard/sdk";
+} from "@solard/core";
 
 export type Flags = Map<string, string[]>;
 
@@ -1697,7 +1697,7 @@ export async function runPumpTokenLaunchFromArgs(
       spam,
       kind: `cli:launch:pump:${input.alias}`,
       reporter: report,
-      beforeDeploymentBroadcast:
+      beforeDeploymentSubmission:
         armedEndpoints.length > 0
           ? async () => {
               await releaseArmedBuyerEndpoints({
@@ -1709,7 +1709,7 @@ export async function runPumpTokenLaunchFromArgs(
               });
             }
           : undefined,
-      onDeploymentBroadcastFailure:
+      onDeploymentSubmissionFailure:
         armedEndpoints.length > 0
           ? async (error) => {
               await abortArmedBuyerEndpoints({

package/src/pump/vamp-cli.ts

@@ -9,7 +9,7 @@ import {
   uploadPumpMetadata,
   type MetadataUploaderId,
   type PumpVampSourceMetadata,
-} from "@solard/sdk";
+} from "@solard/core";
 
 import {
   first,

package/src/raydium-commands.ts

@@ -15,7 +15,7 @@ import {
   tokenAmount,
   type Solard,
   type TradeAsset,
-} from "@solard/sdk";
+} from "@solard/core";
 
 type Flags = Map<string, string>;
 type Emit = (value: string) => void;

package/src/refs.ts

@@ -1,4 +1,4 @@
-import { findExternalContact } from "@solard/sdk";
+import { findExternalContact } from "@solard/core";
 
 export type ResolvedDestinationRef = {
   input: string;

package/src/token-history-command.ts

@@ -1,16 +1,13 @@
-import type { Solard } from "@solard/sdk";
+import type { Solard } from "@solard/core";
 import {
   analyzeTokenHistory,
   analyzeTokenHistoryForensicsFromStore,
-  backfillTokenHistory,
-  backfillRaydiumTokenHistory,
   getTokenHistoryCoverage,
   loadTokenHistoryTrades,
-  TokenHistoryError,
   type BackfillTokenHistoryOptions,
   type TokenHistoryCoverage,
   type TokenHistoryTrade,
-} from "@solard/sdk";
+} from "@solard/core";
 
 export type TokenHistoryCliFlags = Map<string, string>;
 
@@ -212,34 +209,15 @@ async function runBackfill(args: {
       }
     },
   };
-  let result: TokenHistoryCoverage;
-  try {
-    result = await backfillTokenHistory(
-      args.slrd.connection(),
-      args.mint,
-      backfillOptions,
-    );
-  } catch (error) {
-    if (
-      !(error instanceof TokenHistoryError) ||
-      error.code !== "UNSUPPORTED_TOKEN"
-    )
-      throw error;
-    progress(
-      "VENUE  Pump history unsupported; trying Raydium/LaunchLab discovery",
-    );
-    result = await backfillRaydiumTokenHistory(
-      args.slrd.connection(),
-      args.mint,
-      {
-        ...backfillOptions,
-        maxRaydiumPools: Math.max(
-          1,
-          Math.trunc(numberFlag(args.flags, "raydium-pools", 8) ?? 8),
-        ),
-      },
-    );
-  }
+  const market = await args.slrd.history.market(args.mint, {
+    ...backfillOptions,
+    backfill: true,
+    maxRaydiumPools: Math.max(
+      1,
+      Math.trunc(numberFlag(args.flags, "raydium-pools", 8) ?? 8),
+    ),
+  });
+  const result: TokenHistoryCoverage = market.coverage;
   if (jsonMode) {
     args.emit(`${json(result)}\n`);
     return;

package/src/vault-onboarding.ts

@@ -115,7 +115,7 @@ async function confirmNewPassword(): Promise<string> {
 
 async function validateAllStoredWallets(password: string): Promise<void> {
   setMasterKey(password);
-  const { createTraderSolard } = await import("@solard/sdk");
+  const { createTraderSolard } = await import("@solard/core");
   const probe = createTraderSolard();
   try {
     const integrity = probe.wallets.integrity();