@solard/sdk 0.2.21 → 0.2.22

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@solard/sdk",
-  "version": "0.2.21",
-  "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.21"
+    "@solard/core": "0.2.22"
   },
   "scripts": {
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.browser.json",

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),

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,12 +30,11 @@ describe("sdk membrane", () => {
     expect(exportedNames(source)).toEqual({
       values: [
         "createSolard",
-        "decodeProgramDataLogs",
-        "decodePumpProgramData",
-        "decodePumpSwapProgramData",
-        "decodeRaydiumLaunchLabProgramData",
+        "fetchTokenMetadata",
         "formatRaw",
+        "publicTokenMetadataUrl",
         "subscribeLaunches",
+        "subscribeMigrations",
         "subscribeTrades",
         "sol",
         "tokenAmount",
@@ -48,18 +49,20 @@ describe("sdk membrane", () => {
         "CumulativeDistributionRecipient",
         "CumulativeDistributionState",
         "CumulativeEntitlement",
+        "FetchTokenMetadataOptions",
         "HumanAmount",
         "LaunchEvent",
         "LaunchSubscription",
         "LaunchVenue",
+        "MigrationDestination",
+        "MigrationEvent",
+        "MigrationSubscription",
+        "MigrationVenue",
         "MarketHistory",
         "MarketHistoryOptions",
         "MarketPrice",
         "MergedReplayEventStream",
-        "PumpDecodedEvent",
-        "PumpSwapDecodedEvent",
         "QuoteAsset",
-        "RaydiumLaunchLabDecodedEvent",
         "ReplayCoverage",
         "ReplayEventSubscription",
         "ReplayEventsOptions",
@@ -87,9 +90,15 @@ describe("sdk membrane", () => {
         "TokenHolderSnapshot",
         "TokenHolderSnapshotOptions",
         "TokenEventHistoryProgress",
+        "TokenMetadata",
+        "TokenMetadataHint",
+        "TokenMetadataKind",
+        "TokenMetadataMode",
         "TokenRef",
         "TokenRow",
         "WalletInfo",
+        "WalletPrivateKeyExport",
+        "WalletPrivateKeyFormat",
         "WalletRef",
       ].sort(),
     });
@@ -101,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,3 +1,4 @@
+export { default } from "./default.ts";
 export { createSolard } from "./client.ts";
 export type {
   Solard,
@@ -46,26 +47,33 @@ export type {
   TokenRef,
   TokenRow,
   WalletInfo,
+  WalletPrivateKeyExport,
+  WalletPrivateKeyFormat,
   WalletRef,
 } from "@solard/core";
 
 export {
-  decodeProgramDataLogs,
-  decodePumpProgramData,
-  decodePumpSwapProgramData,
-  decodeRaydiumLaunchLabProgramData,
+  fetchTokenMetadata,
+  publicTokenMetadataUrl,
   subscribeLaunches,
+  subscribeMigrations,
   subscribeTrades,
 } from "@solard/core";
 export type {
   LaunchEvent,
   LaunchSubscription,
   LaunchVenue,
+  MigrationDestination,
+  MigrationEvent,
+  MigrationSubscription,
+  MigrationVenue,
   TradeEvent,
   TradeSide,
   TradeSubscription,
   TradeVenue,
-  PumpDecodedEvent,
-  PumpSwapDecodedEvent,
-  RaydiumLaunchLabDecodedEvent,
+  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";