@moon-x/solana-adapter 0.1.0 → 0.2.0

package/README.md

@@ -33,7 +33,7 @@ const signer = createSolanaSigner({
   walletId,         // the Solana wallet the agent was provisioned for
   address,          // base58 wallet pubkey (needed to attach the signature)
   baseUrl,          // wallets backend URL
-  publishableKey,   // moon_pk_…
+  secretKey,        // moon_sk_* (server-only; the sign routes are secret-key-only)
 });
 
 // Arbitrary message → 64-byte ed25519 signature

package/dist/index.d.mts

@@ -1,4 +1,6 @@
 import { Transaction, VersionedTransaction } from '@solana/web3.js';
+import { Ed25519SignFn } from '@moon-x/signing-codec/solana';
+export { Ed25519SignFn } from '@moon-x/signing-codec/solana';
 
 /**
  * Connection + identity for a Solana ephemeral signer. `apiPrivHex` is
@@ -22,10 +24,16 @@ interface SolanaSignerConfig {
      * by signer pubkey.
      */
     address: string;
-    /** Wallets backend base URL (no trailing slash). */
-    baseUrl: string;
-    /** MoonX publishable key (`moon_pk_…`). */
-    publishableKey: string;
+    /**
+     * Wallets backend base URL (no trailing slash). Optional — defaults to
+     * the standard MoonX deployment. Override only for local/dev.
+     */
+    baseUrl?: string;
+    /**
+     * MoonX secret key (`moon_sk_*`). The ephemeral-signer routes are
+     * secret-key-only; server-only, never expose to the browser.
+     */
+    secretKey: string;
     /** Optional fetch override — e.g. for Next.js route handlers or test stubs. */
     fetchImpl?: typeof fetch;
 }
@@ -33,19 +41,35 @@ declare class SolanaSchemeMismatchError extends Error {
     constructor(scheme: string);
 }
 /**
- * Chain-aware Solana signer backed by a MoonX ephemeral signer. Construct
- * once per (agent, wallet) and call the intent-level methods.
+ * Build an `Ed25519SignFn` backed by a MoonX ephemeral signer. This is the
+ * *transport* half — it owns the `/ephemeral-signers/sign` HTTP call, so it
+ * needs the backend `baseUrl` and the app `secretKey` (server-only). Pass
+ * the result to `new MoonXSolanaSigner(sign, address)`.
  *
- * All chain logic (message-bytes + signature attachment) lives in
- * @moon-x/signing-codec/solana — this class is just the ephemeral-signer
- * *backend* that supplies the `Ed25519SignFn`. The same signing-codec is
- * driven by the user/MPC backend in the iframe.
+ * Exposed separately so the chain logic and the transport stay decoupled:
+ * any other `Ed25519SignFn` (e.g. the iframe's MPC sign fn, or a test stub)
+ * drives the same `MoonXSolanaSigner` without going through here.
+ */
+declare function ephemeralSignerEd25519SignFn(cfg: SolanaSignerConfig): Ed25519SignFn;
+/**
+ * Chain-aware Solana signer: produces the bytes to sign and attaches the
+ * signature, independent of *how* the bytes get signed. All chain logic
+ * lives in @moon-x/signing-codec/solana; this class just binds it to a
+ * single `Ed25519SignFn` and exposes intent-level methods.
+ *
+ * Two ways to construct:
+ *   - `new MoonXSolanaSigner(sign, address)` with any `Ed25519SignFn` —
+ *     transport-independent. `address` (base58 pubkey) is needed only for
+ *     `signTransaction`, since Solana keys signatures by signer pubkey.
+ *   - `new MoonXSolanaSigner(config)` with the ephemeral-signer connection +
+ *     secret key — the server-side convenience; equivalent to
+ *     `new MoonXSolanaSigner(ephemeralSignerEd25519SignFn(config), config.address)`.
  */
 declare class MoonXSolanaSigner {
-    private readonly cfg;
-    constructor(cfg: SolanaSignerConfig);
-    /** Ephemeral-signer backend: sign raw bytes, return the 64-byte sig. */
     private readonly sign;
+    private readonly address?;
+    constructor(sign: Ed25519SignFn, address?: string);
+    constructor(config: SolanaSignerConfig);
     /**
      * Sign an arbitrary message. Accepts a UTF-8 string or raw bytes and
      * returns the 64-byte ed25519 signature, verifiable against the wallet's
@@ -59,7 +83,11 @@ declare class MoonXSolanaSigner {
      */
     signTransaction(transaction: Transaction | VersionedTransaction): Promise<Uint8Array>;
 }
-/** Convenience factory mirroring the class constructor. */
+/**
+ * Convenience factory for the server-side ephemeral-signer path.
+ * Equivalent to `new MoonXSolanaSigner(config)`. For a custom transport,
+ * construct the class directly with your own `Ed25519SignFn` + address.
+ */
 declare function createSolanaSigner(cfg: SolanaSignerConfig): MoonXSolanaSigner;
 
-export { MoonXSolanaSigner, SolanaSchemeMismatchError, type SolanaSignerConfig, createSolanaSigner };
+export { MoonXSolanaSigner, SolanaSchemeMismatchError, type SolanaSignerConfig, createSolanaSigner, ephemeralSignerEd25519SignFn };

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { Transaction, VersionedTransaction } from '@solana/web3.js';
+import { Ed25519SignFn } from '@moon-x/signing-codec/solana';
+export { Ed25519SignFn } from '@moon-x/signing-codec/solana';
 
 /**
  * Connection + identity for a Solana ephemeral signer. `apiPrivHex` is
@@ -22,10 +24,16 @@ interface SolanaSignerConfig {
      * by signer pubkey.
      */
     address: string;
-    /** Wallets backend base URL (no trailing slash). */
-    baseUrl: string;
-    /** MoonX publishable key (`moon_pk_…`). */
-    publishableKey: string;
+    /**
+     * Wallets backend base URL (no trailing slash). Optional — defaults to
+     * the standard MoonX deployment. Override only for local/dev.
+     */
+    baseUrl?: string;
+    /**
+     * MoonX secret key (`moon_sk_*`). The ephemeral-signer routes are
+     * secret-key-only; server-only, never expose to the browser.
+     */
+    secretKey: string;
     /** Optional fetch override — e.g. for Next.js route handlers or test stubs. */
     fetchImpl?: typeof fetch;
 }
@@ -33,19 +41,35 @@ declare class SolanaSchemeMismatchError extends Error {
     constructor(scheme: string);
 }
 /**
- * Chain-aware Solana signer backed by a MoonX ephemeral signer. Construct
- * once per (agent, wallet) and call the intent-level methods.
+ * Build an `Ed25519SignFn` backed by a MoonX ephemeral signer. This is the
+ * *transport* half — it owns the `/ephemeral-signers/sign` HTTP call, so it
+ * needs the backend `baseUrl` and the app `secretKey` (server-only). Pass
+ * the result to `new MoonXSolanaSigner(sign, address)`.
  *
- * All chain logic (message-bytes + signature attachment) lives in
- * @moon-x/signing-codec/solana — this class is just the ephemeral-signer
- * *backend* that supplies the `Ed25519SignFn`. The same signing-codec is
- * driven by the user/MPC backend in the iframe.
+ * Exposed separately so the chain logic and the transport stay decoupled:
+ * any other `Ed25519SignFn` (e.g. the iframe's MPC sign fn, or a test stub)
+ * drives the same `MoonXSolanaSigner` without going through here.
+ */
+declare function ephemeralSignerEd25519SignFn(cfg: SolanaSignerConfig): Ed25519SignFn;
+/**
+ * Chain-aware Solana signer: produces the bytes to sign and attaches the
+ * signature, independent of *how* the bytes get signed. All chain logic
+ * lives in @moon-x/signing-codec/solana; this class just binds it to a
+ * single `Ed25519SignFn` and exposes intent-level methods.
+ *
+ * Two ways to construct:
+ *   - `new MoonXSolanaSigner(sign, address)` with any `Ed25519SignFn` —
+ *     transport-independent. `address` (base58 pubkey) is needed only for
+ *     `signTransaction`, since Solana keys signatures by signer pubkey.
+ *   - `new MoonXSolanaSigner(config)` with the ephemeral-signer connection +
+ *     secret key — the server-side convenience; equivalent to
+ *     `new MoonXSolanaSigner(ephemeralSignerEd25519SignFn(config), config.address)`.
  */
 declare class MoonXSolanaSigner {
-    private readonly cfg;
-    constructor(cfg: SolanaSignerConfig);
-    /** Ephemeral-signer backend: sign raw bytes, return the 64-byte sig. */
     private readonly sign;
+    private readonly address?;
+    constructor(sign: Ed25519SignFn, address?: string);
+    constructor(config: SolanaSignerConfig);
     /**
      * Sign an arbitrary message. Accepts a UTF-8 string or raw bytes and
      * returns the 64-byte ed25519 signature, verifiable against the wallet's
@@ -59,7 +83,11 @@ declare class MoonXSolanaSigner {
      */
     signTransaction(transaction: Transaction | VersionedTransaction): Promise<Uint8Array>;
 }
-/** Convenience factory mirroring the class constructor. */
+/**
+ * Convenience factory for the server-side ephemeral-signer path.
+ * Equivalent to `new MoonXSolanaSigner(config)`. For a custom transport,
+ * construct the class directly with your own `Ed25519SignFn` + address.
+ */
 declare function createSolanaSigner(cfg: SolanaSignerConfig): MoonXSolanaSigner;
 
-export { MoonXSolanaSigner, SolanaSchemeMismatchError, type SolanaSignerConfig, createSolanaSigner };
+export { MoonXSolanaSigner, SolanaSchemeMismatchError, type SolanaSignerConfig, createSolanaSigner, ephemeralSignerEd25519SignFn };

package/dist/index.js

@@ -22,7 +22,8 @@ var src_exports = {};
 __export(src_exports, {
   MoonXSolanaSigner: () => MoonXSolanaSigner,
   SolanaSchemeMismatchError: () => SolanaSchemeMismatchError,
-  createSolanaSigner: () => createSolanaSigner
+  createSolanaSigner: () => createSolanaSigner,
+  ephemeralSignerEd25519SignFn: () => ephemeralSignerEd25519SignFn
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -96,22 +97,29 @@ function requireEd25519(result) {
   }
   return hexToBytes(sigHex);
 }
+function ephemeralSignerEd25519SignFn(cfg) {
+  return async (message) => {
+    const result = await (0, import_sdk.signWithEphemeralSigner)({
+      apiPubHex: cfg.apiPubHex,
+      apiPrivHex: cfg.apiPrivHex,
+      walletId: cfg.walletId,
+      rawSigningPayloadHex: bytesToHex(message),
+      baseUrl: cfg.baseUrl,
+      secretKey: cfg.secretKey,
+      fetchImpl: cfg.fetchImpl
+    });
+    return requireEd25519(result);
+  };
+}
 var MoonXSolanaSigner = class {
-  constructor(cfg) {
-    this.cfg = cfg;
-    /** Ephemeral-signer backend: sign raw bytes, return the 64-byte sig. */
-    this.sign = async (message) => {
-      const result = await (0, import_sdk.signWithEphemeralSigner)({
-        apiPubHex: this.cfg.apiPubHex,
-        apiPrivHex: this.cfg.apiPrivHex,
-        walletId: this.cfg.walletId,
-        rawSigningPayloadHex: bytesToHex(message),
-        baseUrl: this.cfg.baseUrl,
-        publishableKey: this.cfg.publishableKey,
-        fetchImpl: this.cfg.fetchImpl
-      });
-      return requireEd25519(result);
-    };
+  constructor(signOrConfig, address) {
+    if (typeof signOrConfig === "function") {
+      this.sign = signOrConfig;
+      this.address = address;
+    } else {
+      this.sign = ephemeralSignerEd25519SignFn(signOrConfig);
+      this.address = signOrConfig.address;
+    }
   }
   /**
    * Sign an arbitrary message. Accepts a UTF-8 string or raw bytes and
@@ -127,7 +135,12 @@ var MoonXSolanaSigner = class {
    * `connection.sendRawTransaction`.
    */
   signTransaction(transaction) {
-    return signSolanaTransaction(this.sign, transaction, this.cfg.address);
+    if (!this.address) {
+      throw new Error(
+        "MoonXSolanaSigner: address is required to sign a transaction (Solana keys signatures by signer pubkey). Pass it as the second constructor arg, or use SolanaSignerConfig.address."
+      );
+    }
+    return signSolanaTransaction(this.sign, transaction, this.address);
   }
 };
 function createSolanaSigner(cfg) {
@@ -137,5 +150,6 @@ function createSolanaSigner(cfg) {
 0 && (module.exports = {
   MoonXSolanaSigner,
   SolanaSchemeMismatchError,
-  createSolanaSigner
+  createSolanaSigner,
+  ephemeralSignerEd25519SignFn
 });

package/dist/index.mjs

@@ -74,22 +74,29 @@ function requireEd25519(result) {
   }
   return hexToBytes(sigHex);
 }
+function ephemeralSignerEd25519SignFn(cfg) {
+  return async (message) => {
+    const result = await signWithEphemeralSigner({
+      apiPubHex: cfg.apiPubHex,
+      apiPrivHex: cfg.apiPrivHex,
+      walletId: cfg.walletId,
+      rawSigningPayloadHex: bytesToHex(message),
+      baseUrl: cfg.baseUrl,
+      secretKey: cfg.secretKey,
+      fetchImpl: cfg.fetchImpl
+    });
+    return requireEd25519(result);
+  };
+}
 var MoonXSolanaSigner = class {
-  constructor(cfg) {
-    this.cfg = cfg;
-    /** Ephemeral-signer backend: sign raw bytes, return the 64-byte sig. */
-    this.sign = async (message) => {
-      const result = await signWithEphemeralSigner({
-        apiPubHex: this.cfg.apiPubHex,
-        apiPrivHex: this.cfg.apiPrivHex,
-        walletId: this.cfg.walletId,
-        rawSigningPayloadHex: bytesToHex(message),
-        baseUrl: this.cfg.baseUrl,
-        publishableKey: this.cfg.publishableKey,
-        fetchImpl: this.cfg.fetchImpl
-      });
-      return requireEd25519(result);
-    };
+  constructor(signOrConfig, address) {
+    if (typeof signOrConfig === "function") {
+      this.sign = signOrConfig;
+      this.address = address;
+    } else {
+      this.sign = ephemeralSignerEd25519SignFn(signOrConfig);
+      this.address = signOrConfig.address;
+    }
   }
   /**
    * Sign an arbitrary message. Accepts a UTF-8 string or raw bytes and
@@ -105,7 +112,12 @@ var MoonXSolanaSigner = class {
    * `connection.sendRawTransaction`.
    */
   signTransaction(transaction) {
-    return signSolanaTransaction(this.sign, transaction, this.cfg.address);
+    if (!this.address) {
+      throw new Error(
+        "MoonXSolanaSigner: address is required to sign a transaction (Solana keys signatures by signer pubkey). Pass it as the second constructor arg, or use SolanaSignerConfig.address."
+      );
+    }
+    return signSolanaTransaction(this.sign, transaction, this.address);
   }
 };
 function createSolanaSigner(cfg) {
@@ -114,5 +126,6 @@ function createSolanaSigner(cfg) {
 export {
   MoonXSolanaSigner,
   SolanaSchemeMismatchError,
-  createSolanaSigner
+  createSolanaSigner,
+  ephemeralSignerEd25519SignFn
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moon-x/solana-adapter",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Chain-aware Solana signing helpers for MoonX ephemeral signers. Serializes the message bytes and assembles ready-to-broadcast transactions/signatures so integrators never hand-roll payload construction.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@moon-x/core": "0.7.0"
+    "@moon-x/core": "0.9.0"
   },
   "peerDependencies": {
     "@solana/web3.js": "^1.98.0"