@solard/sdk 0.2.20 → 0.2.22

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@solard/sdk",
-  "version": "0.2.20",
-  "description": "Public Solard SDK for wallets, transactions, trading and token launches.",
+  "version": "0.2.22",
+  "description": "Public Solard SDK for wallets, trading, history, live market subscriptions and token metadata.",
   "type": "module",
   "main": "./src/index.ts",
   "module": "./src/index.ts",
@@ -12,6 +12,11 @@
       "types": "./src/browser/index.ts",
       "import": "./src/browser/index.ts",
       "default": "./src/browser/index.ts"
+    },
+    "./protocol": {
+      "types": "./src/protocol.ts",
+      "import": "./src/protocol.ts",
+      "default": "./src/protocol.ts"
     }
   },
   "files": [
@@ -22,7 +27,7 @@
   "license": "MIT",
   "dependencies": {
     "@solana/web3.js": "^1.98.4",
-    "@solard/core": "0.2.20"
+    "@solard/core": "0.2.22"
   },
   "scripts": {
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.browser.json",

package/src/browser/index.ts

@@ -67,16 +67,3 @@ export type {
   BrowserTradeSide,
   BrowserWalletSigner,
 } from "./types.ts";
-export { createPriceFeed, connectPriceFeed } from "@solard/core";
-export type {
-  LaunchFeedListener,
-  PriceFeedClient,
-  PriceFeedCommand,
-  PriceFeedLaunch,
-  PriceFeedListener,
-  PriceFeedMessage,
-  PriceFeedPrice,
-  PriceFeedStatus,
-  PriceFeedVenue,
-  SharedPriceFeed,
-} from "@solard/core";

package/src/client.ts

@@ -20,6 +20,8 @@ import {
   type TokenHolderSnapshotOptions,
   type TokenRef,
   type WalletRef,
+  type WalletPrivateKeyExport,
+  type WalletPrivateKeyFormat,
 } from "@solard/core";
 
 export type SolardOptions = {
@@ -78,6 +80,11 @@ export type Solard = {
   createVanityWallet: ReturnType<typeof createCoreSolard>["createVanityWallet"];
   importWallet: ReturnType<typeof createCoreSolard>["importWallet"];
   listWallets: ReturnType<typeof createCoreSolard>["listWallets"];
+  walletAddress(wallet: WalletRef): string;
+  exportWalletPrivateKey(
+    wallet: WalletRef,
+    format?: WalletPrivateKeyFormat,
+  ): WalletPrivateKeyExport;
   addToken: ReturnType<typeof createCoreSolard>["addToken"];
   resolveToken: ReturnType<typeof createCoreSolard>["resolveToken"];
   tokenAccounts: ReturnType<typeof createCoreSolard>["tokenAccounts"];
@@ -127,6 +134,8 @@ export function createSolard(options: SolardOptions = {}): Solard {
     createVanityWallet: core.createVanityWallet.bind(core),
     importWallet: core.importWallet.bind(core),
     listWallets: core.listWallets.bind(core),
+    walletAddress: core.walletAddress.bind(core),
+    exportWalletPrivateKey: core.exportWalletPrivateKey.bind(core),
     addToken: core.addToken.bind(core),
     resolveToken: core.resolveToken.bind(core),
     tokenAccounts: core.tokenAccounts.bind(core),
@@ -137,5 +146,3 @@ export function createSolard(options: SolardOptions = {}): Solard {
     sell: core.sell.bind(core),
   });
 }
-
-export const createTraderSolard = createSolard;

package/src/default.ts

@@ -0,0 +1,28 @@
+import { createSolard, type Solard } from "./client.ts";
+
+let instance: Solard | undefined;
+
+function client(): Solard {
+  instance ??= createSolard();
+  return instance;
+}
+
+const slrd = new Proxy({} as Solard, {
+  get(_target, key) {
+    if (key === "close") {
+      return () => {
+        const current = instance;
+        instance = undefined;
+        current?.close();
+      };
+    }
+    const current = client();
+    const value = Reflect.get(current as object, key, current);
+    return typeof value === "function" ? value.bind(current) : value;
+  },
+  set() {
+    return false;
+  },
+});
+
+export default slrd;

package/src/export-surface.test.ts

@@ -4,6 +4,8 @@ import { join } from "node:path";
 
 const source = readFileSync(join(import.meta.dir, "index.ts"), "utf8");
 const client = readFileSync(join(import.meta.dir, "client.ts"), "utf8");
+const protocol = readFileSync(join(import.meta.dir, "protocol.ts"), "utf8");
+const defaultClient = readFileSync(join(import.meta.dir, "default.ts"), "utf8");
 
 function exportedNames(value: string) {
   const values: string[] = [];
@@ -28,8 +30,12 @@ describe("sdk membrane", () => {
     expect(exportedNames(source)).toEqual({
       values: [
         "createSolard",
-        "createTraderSolard",
+        "fetchTokenMetadata",
         "formatRaw",
+        "publicTokenMetadataUrl",
+        "subscribeLaunches",
+        "subscribeMigrations",
+        "subscribeTrades",
         "sol",
         "tokenAmount",
       ].sort(),
@@ -43,7 +49,15 @@ describe("sdk membrane", () => {
         "CumulativeDistributionRecipient",
         "CumulativeDistributionState",
         "CumulativeEntitlement",
+        "FetchTokenMetadataOptions",
         "HumanAmount",
+        "LaunchEvent",
+        "LaunchSubscription",
+        "LaunchVenue",
+        "MigrationDestination",
+        "MigrationEvent",
+        "MigrationSubscription",
+        "MigrationVenue",
         "MarketHistory",
         "MarketHistoryOptions",
         "MarketPrice",
@@ -60,6 +74,10 @@ describe("sdk membrane", () => {
         "SendReceipt",
         "SenderId",
         "SimulationResult",
+        "TradeEvent",
+        "TradeSide",
+        "TradeSubscription",
+        "TradeVenue",
         "Solard",
         "SolardCanonicalEvent",
         "SolardClaimAttribution",
@@ -72,9 +90,15 @@ describe("sdk membrane", () => {
         "TokenHolderSnapshot",
         "TokenHolderSnapshotOptions",
         "TokenEventHistoryProgress",
+        "TokenMetadata",
+        "TokenMetadataHint",
+        "TokenMetadataKind",
+        "TokenMetadataMode",
         "TokenRef",
         "TokenRow",
         "WalletInfo",
+        "WalletPrivateKeyExport",
+        "WalletPrivateKeyFormat",
         "WalletRef",
       ].sort(),
     });
@@ -86,8 +110,35 @@ describe("sdk membrane", () => {
     expect(client).not.toMatch(/\.\.\/\.\.\/core\/src|@solard\/core\//);
   });
 
+  test("keeps raw protocol decoders off the root surface", () => {
+    expect(source).not.toMatch(
+      /decode(?:ProgramDataLogs|PumpProgramData|PumpSwapProgramData|RaydiumLaunchLabProgramData)/,
+    );
+    expect(exportedNames(protocol)).toEqual({
+      values: [
+        "decodeProgramDataLogs",
+        "decodePumpProgramData",
+        "decodePumpSwapProgramData",
+        "decodeRaydiumLaunchLabProgramData",
+      ].sort(),
+      types: [
+        "PumpDecodedEvent",
+        "PumpSwapDecodedEvent",
+        "RaydiumLaunchLabDecodedEvent",
+      ].sort(),
+    });
+  });
+
+  test("exports a lazy zero-config default client", () => {
+    expect(source).toContain('export { default } from "./default.ts"');
+    expect(defaultClient).toContain("instance ??= createSolard()");
+    expect(defaultClient).toContain('if (key === "close")');
+    expect(defaultClient).not.toContain("export default createSolard()");
+  });
+
   test("does not create persistence at module import", () => {
     expect(source).not.toMatch(/createCoreSolard|createTraderSolard\(\)/);
+    expect(defaultClient).not.toMatch(/^const\s+\w+\s*=\s*createSolard\(\)/m);
     expect(client.indexOf("createCoreSolard(options)")).toBeGreaterThan(
       client.indexOf("export function createSolard"),
     );

package/src/index.ts

@@ -1,4 +1,5 @@
-export { createSolard, createTraderSolard } from "./client.ts";
+export { default } from "./default.ts";
+export { createSolard } from "./client.ts";
 export type {
   Solard,
   SolardEventsApi,
@@ -46,18 +47,33 @@ export type {
   TokenRef,
   TokenRow,
   WalletInfo,
+  WalletPrivateKeyExport,
+  WalletPrivateKeyFormat,
   WalletRef,
 } from "@solard/core";
-export { createPriceFeed, connectPriceFeed } from "@solard/core";
+
+export {
+  fetchTokenMetadata,
+  publicTokenMetadataUrl,
+  subscribeLaunches,
+  subscribeMigrations,
+  subscribeTrades,
+} from "@solard/core";
 export type {
-  LaunchFeedListener,
-  PriceFeedClient,
-  PriceFeedCommand,
-  PriceFeedLaunch,
-  PriceFeedListener,
-  PriceFeedMessage,
-  PriceFeedPrice,
-  PriceFeedStatus,
-  PriceFeedVenue,
-  SharedPriceFeed,
+  LaunchEvent,
+  LaunchSubscription,
+  LaunchVenue,
+  MigrationDestination,
+  MigrationEvent,
+  MigrationSubscription,
+  MigrationVenue,
+  TradeEvent,
+  TradeSide,
+  TradeSubscription,
+  TradeVenue,
+  FetchTokenMetadataOptions,
+  TokenMetadata,
+  TokenMetadataHint,
+  TokenMetadataKind,
+  TokenMetadataMode,
 } from "@solard/core";

package/src/protocol.ts

@@ -0,0 +1,11 @@
+export {
+  decodeProgramDataLogs,
+  decodePumpProgramData,
+  decodePumpSwapProgramData,
+  decodeRaydiumLaunchLabProgramData,
+} from "@solard/core";
+export type {
+  PumpDecodedEvent,
+  PumpSwapDecodedEvent,
+  RaydiumLaunchLabDecodedEvent,
+} from "@solard/core";