@solard/sdk 0.2.13 → 0.2.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solard/sdk",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "Public Solard SDK for wallets, transactions, trading and token launches.",
   "type": "module",
   "main": "./src/index.ts",
@@ -22,7 +22,7 @@
   "license": "MIT",
   "dependencies": {
     "@solana/web3.js": "^1.98.4",
-    "@solard/core": "0.2.13"
+    "@solard/core": "0.2.15"
   },
   "scripts": {
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.browser.json",

package/src/browser/client.ts

@@ -6,11 +6,32 @@ import {
   VersionedTransaction,
 } from "@solana/web3.js";
 
+import {
+  buildPumpExternalDeployment,
+  type PumpLaunchPairInput,
+} from "@solard/core/launches/pump/external-deployment.ts";
+
+import {
+  snapshotTokenHolders,
+  type TokenHolderSnapshotOptions,
+} from "@solard/core/chain/holders.ts";
+import { readMint } from "@solard/core/chain/state.ts";
+import {
+  subscribeTokenEvents,
+  type SubscribeTokenEventsOptions,
+} from "@solard/core/events/token-events.ts";
+import type { TokenRow } from "@solard/core/db/schema.ts";
+import { PumpCurveVenue } from "@solard/core/venues/pump/pump-curve-venue.ts";
+import { PumpSwapVenue } from "@solard/core/venues/pump/pumpswap-venue.ts";
+import { VenueRegistry } from "@solard/core/venues/route-resolver.ts";
+
 import { BrowserSolardStore, defaultBrowserStorage } from "./storage.ts";
 import { buildLocalPumpBuy, buildLocalPumpSell } from "./pump.ts";
 import type {
   BrowserBroadcastResult,
   BrowserPortfolio,
+  BrowserPumpDeploymentBuild,
+  BrowserPumpDeploymentResult,
   BrowserSolardOptions,
   BrowserTradeBuild,
   BrowserTradeResult,
@@ -170,6 +191,67 @@ export class BrowserSolard {
     }
   }
 
+  private async inspectPumpToken(value: string): Promise<TokenRow> {
+    const mintText = this.resolveTokenOrMint(value);
+    const mint = new PublicKey(mintText);
+    const info = await readMint(this.connection, mint);
+    const registry = new VenueRegistry()
+      .register(new PumpCurveVenue())
+      .register(new PumpSwapVenue());
+    const inspected = await registry.inspect(this.connection, mint);
+    if (!inspected)
+      throw new Error(
+        `Mint ${mintText} is not a supported Pump/PumpSwap token.`,
+      );
+    const now = Date.now();
+    return {
+      id: 0,
+      mint: mintText,
+      name: null,
+      symbol: null,
+      decimals: info.decimals,
+      createKind: "unknown",
+      creator: null,
+      quoteMint: null,
+      quoteTokenProgram: null,
+      baseTokenProgram: info.tokenProgram.toBase58(),
+      bondingCurve: null,
+      pool: null,
+      sharingConfig: null,
+      venueHint: "unknown",
+      metadataJson: null,
+      refreshedAtMs: now,
+      createdAtMs: now,
+      updatedAtMs: now,
+      ...inspected,
+    } as TokenRow;
+  }
+
+  /** Complete holder snapshot suitable for reward allocation. */
+  async snapshotHolders(
+    token: string,
+    options: Omit<TokenHolderSnapshotOptions, "token"> = {},
+  ) {
+    const row = await this.inspectPumpToken(token);
+    return await snapshotTokenHolders(this.connection, row.mint, {
+      ...options,
+      token: row,
+    });
+  }
+
+  /** Typed Pump/PumpSwap swap and mint-mentioned transfer stream. */
+  async subscribeTokenEvents(
+    token: string,
+    options: SubscribeTokenEventsOptions = {},
+  ) {
+    const row = await this.inspectPumpToken(token);
+    return await subscribeTokenEvents({
+      connection: this.connection,
+      token: row,
+      options,
+    });
+  }
+
   async getPortfolio(address?: string | PublicKey): Promise<BrowserPortfolio> {
     const owner =
       address instanceof PublicKey
@@ -316,6 +398,59 @@ export class BrowserSolard {
     );
   }
 
+  /**
+   * Build a Pump create_v2 transaction for the connected wallet without asking
+   * it to sign and without broadcasting. The generated mint signature is already
+   * present; the connected wallet remains the missing payer signature.
+   */
+  async buildPumpDeployment(args: {
+    name: string;
+    symbol: string;
+    uri: string;
+    pair?: PumpLaunchPairInput;
+    beneficiary?: string | PublicKey;
+    mayhemMode?: boolean;
+    cashback?: boolean;
+    cuLimit?: number;
+    priorityMicroLamports?: number;
+  }): Promise<BrowserPumpDeploymentBuild> {
+    const payer = this.signer().publicKey;
+    if (!payer) throw new Error("Connected browser wallet has no public key.");
+    return await buildPumpExternalDeployment({
+      connection: this.connection,
+      payer,
+      ...args,
+    });
+  }
+
+  /** Build, request the wallet signature, broadcast, and confirm a Pump launch. */
+  async deployPump(args: {
+    name: string;
+    symbol: string;
+    uri: string;
+    pair?: PumpLaunchPairInput;
+    beneficiary?: string | PublicKey;
+    mayhemMode?: boolean;
+    cashback?: boolean;
+    cuLimit?: number;
+    priorityMicroLamports?: number;
+    skipPreflight?: boolean;
+  }): Promise<BrowserPumpDeploymentResult> {
+    const build = await this.buildPumpDeployment(args);
+    const receipt = await this.signAndBroadcast(build.transaction, {
+      blockhash: build.blockhash,
+      lastValidBlockHeight: build.lastValidBlockHeight,
+      skipPreflight: args.skipPreflight,
+    });
+    return {
+      ...receipt,
+      mint: build.mint,
+      beneficiary: build.beneficiary,
+      quoteMint: build.quoteMint,
+      quoteKind: build.quoteKind,
+    };
+  }
+
   async buildBuy(args: {
     token: string;
     sol: string | number;

package/src/browser/index.ts

@@ -20,11 +20,38 @@ export {
 } from "./storage.ts";
 export { BrowserKeyVault, KeypairBrowserSigner } from "./wallet.ts";
 export { buildLocalPumpBuy, buildLocalPumpSell } from "./pump.ts";
+export {
+  PUMP_USDC_MINT,
+  buildPumpExternalDeployment,
+  resolvePumpQuoteAsset,
+} from "@solard/core/launches/pump/external-deployment.ts";
+export type {
+  PumpExternalDeploymentBuild,
+  PumpCustomPairSelection,
+  PumpLaunchPairInput,
+} from "@solard/core/launches/pump/external-deployment.ts";
+export { snapshotTokenHolders } from "@solard/core/chain/holders.ts";
+export type {
+  TokenHolder,
+  ExcludedTokenHolder,
+  TokenHolderSnapshot,
+  TokenHolderSnapshotOptions,
+} from "@solard/core/chain/holders.ts";
+export { subscribeTokenEvents } from "@solard/core/events/token-events.ts";
+export type {
+  SolardTokenEvent,
+  SolardTokenSwapEvent,
+  SolardTokenTransferEvent,
+  SubscribeTokenEventsOptions,
+  TokenEventSubscription,
+} from "@solard/core/events/token-events.ts";
 
 export type {
   BrowserBroadcastResult,
   BrowserContact,
   BrowserPortfolio,
+  BrowserPumpDeploymentBuild,
+  BrowserPumpDeploymentResult,
   BrowserSolardOptions,
   BrowserStorageLike,
   BrowserTokenAlias,

package/src/browser/types.ts

@@ -97,3 +97,12 @@ export type BrowserSolardOptions = {
   rpcMaxRps?: number;
   fetch?: typeof globalThis.fetch;
 };
+export type BrowserPumpDeploymentBuild =
+  import("@solard/core/launches/pump/external-deployment.ts").PumpExternalDeploymentBuild;
+
+export type BrowserPumpDeploymentResult = BrowserBroadcastResult & {
+  mint: string;
+  beneficiary: string;
+  quoteMint: string;
+  quoteKind: "native-sol" | "spl-token";
+};

package/src/index.ts

@@ -24,3 +24,30 @@ export type {
 // Direct source re-exports used by the source-executed CLI.
 export { readMint } from "../../core/src/chain/state.ts";
 export { transferTokenIxs } from "../../core/src/tx/spl.ts";
+// Direct source re-exports for the target-weight portfolio controller and
+// backtester. Keeping these explicit lets the source-executed CLI/examples use
+// the new strategy without requiring a root @solard/core barrel replacement.
+export {
+  normalizeTargetWeightPolicy,
+  planTargetWeightRebalance,
+  targetWeightGapPct,
+} from "../../core/src/strategy/target-weight.ts";
+export type {
+  TargetWeightCandle,
+  TargetWeightGapMode,
+  TargetWeightGapPolicy,
+  TargetWeightPolicy,
+  TargetWeightRebalancePlan,
+} from "../../core/src/strategy/target-weight.ts";
+export { simulateTargetWeightStrategy } from "../../core/src/backtest/target-weight-sim.ts";
+export type {
+  TargetWeightBacktestExecution,
+  TargetWeightBacktestResult,
+  TargetWeightBacktestSummary,
+  TargetWeightDecision,
+} from "../../core/src/backtest/target-weight-sim.ts";
+export {
+  backtestTargetWeightToken,
+  backtestTargetWeightTokenWithDependencies,
+} from "../../core/src/backtest/token-backtest.ts";
+export type { TokenTargetWeightBacktestResult } from "../../core/src/backtest/token-backtest.ts";