@molpha/sdk 0.1.0

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+export { Wallet } from '@anchor-lang/core';
+import { S as Signer, h as SolanaKeypair, M as MolphaWallet } from './wallet-CbpYQO4l.js';
+import '@solana/kit';
+
+/** Load a Solana CLI keypair JSON file (array of 64 bytes) into a `Keypair`. */
+declare function loadKeypair(path: string): SolanaKeypair;
+/** Anchor `Wallet` backed by a keypair file (gateway auth derived from the same key). */
+declare function walletFromKeypairFile(path: string): MolphaWallet;
+/** @deprecated Use `walletFromKeypairFile`. */
+declare const nodeWalletFromFile: typeof walletFromKeypairFile;
+/** @deprecated Use `walletFromKeypairFile` — gateway auth is derived from the same keypair. */
+declare function keypairFileSigner(path: string): Signer;
+
+export { MolphaWallet, keypairFileSigner, loadKeypair, nodeWalletFromFile, walletFromKeypairFile };

package/dist/utils.js

@@ -0,0 +1,20 @@
+import { keypairFromSecretKey, signerFromKeypair } from './chunk-MFELBWSL.js';
+import { readFileSync } from 'fs';
+import { Wallet } from '@anchor-lang/core';
+export { Wallet } from '@anchor-lang/core';
+
+function loadKeypair(path) {
+  const raw = JSON.parse(readFileSync(path, "utf-8"));
+  return keypairFromSecretKey(Uint8Array.from(raw));
+}
+function walletFromKeypairFile(path) {
+  return new Wallet(loadKeypair(path));
+}
+var nodeWalletFromFile = walletFromKeypairFile;
+function keypairFileSigner(path) {
+  return signerFromKeypair(loadKeypair(path));
+}
+
+export { keypairFileSigner, loadKeypair, nodeWalletFromFile, walletFromKeypairFile };
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"names":[],"mappings":";;;;;AAWO,SAAS,YAAY,IAAA,EAA6B;AACvD,EAAA,MAAM,MAAM,IAAA,CAAK,KAAA,CAAM,YAAA,CAAa,IAAA,EAAM,OAAO,CAAC,CAAA;AAClD,EAAA,OAAO,oBAAA,CAAqB,UAAA,CAAW,IAAA,CAAK,GAAG,CAAC,CAAA;AAClD;AAGO,SAAS,sBAAsB,IAAA,EAA4B;AAChE,EAAA,OAAO,IAAI,MAAA,CAAO,WAAA,CAAY,IAAI,CAAC,CAAA;AACrC;AAGO,IAAM,kBAAA,GAAqB;AAG3B,SAAS,kBAAkB,IAAA,EAAsB;AACtD,EAAA,OAAO,iBAAA,CAAkB,WAAA,CAAY,IAAI,CAAC,CAAA;AAC5C","file":"utils.js","sourcesContent":["/**\n * `@molpha/sdk/utils` — Node.js-only helpers (fs + keypair files). Kept out of the main\n * entry so browser bundles never pull in `fs`.\n */\nimport { readFileSync } from \"node:fs\";\nimport { Wallet } from \"@anchor-lang/core\";\nimport type { Signer } from \"./core/types.js\";\nimport { keypairFromSecretKey, type SolanaKeypair } from \"./solana/kit.js\";\nimport { signerFromKeypair, type MolphaWallet } from \"./wallet.js\";\n\n/** Load a Solana CLI keypair JSON file (array of 64 bytes) into a `Keypair`. */\nexport function loadKeypair(path: string): SolanaKeypair {\n  const raw = JSON.parse(readFileSync(path, \"utf-8\")) as number[];\n  return keypairFromSecretKey(Uint8Array.from(raw));\n}\n\n/** Anchor `Wallet` backed by a keypair file (gateway auth derived from the same key). */\nexport function walletFromKeypairFile(path: string): MolphaWallet {\n  return new Wallet(loadKeypair(path));\n}\n\n/** @deprecated Use `walletFromKeypairFile`. */\nexport const nodeWalletFromFile = walletFromKeypairFile;\n\n/** @deprecated Use `walletFromKeypairFile` — gateway auth is derived from the same keypair. */\nexport function keypairFileSigner(path: string): Signer {\n  return signerFromKeypair(loadKeypair(path));\n}\n\nexport { Wallet };\nexport type { MolphaWallet };\n"]}

package/dist/wallet-CbpYQO4l.d.ts

@@ -0,0 +1,122 @@
+import { web3, Wallet } from '@anchor-lang/core';
+import { Address } from '@solana/kit';
+
+/**
+ * Public protocol types (spec §8). Kept dependency-free so they can be imported
+ * from any entry point.
+ */
+/** A registered oracle node as returned by the gateway. */
+interface Node {
+    index: number;
+    peerId: string;
+    address: string;
+    /** Node secp256k1 public key (hex). Used for ECDH config encryption. */
+    signingKey: string;
+}
+/** Selected node-key material that must be authenticated before private API encryption. */
+interface NodeKeyVerifierArgs {
+    /** 32-byte feed id, hex. */
+    feedId: string;
+    /** On-chain registry version the gateway round is bound to. */
+    registryVersion: number;
+    /** Canonical timestamp used to derive the selected indexes. */
+    timestamp: number;
+    /** Selected node indexes derived from the round bitmap, ascending. */
+    selectedIndexes: readonly number[];
+    /** Gateway-provided selected nodes whose keys must be authenticated. */
+    selectedNodes: readonly Node[];
+}
+/**
+ * Authenticates selected gateway node encryption keys. Throwing fails the
+ * private API request before secrets are encrypted or posted.
+ */
+type NodeKeyVerifier = (args: NodeKeyVerifierArgs) => void | Promise<void>;
+/** The off-chain API definition a feed resolves. */
+interface APIConfig {
+    url: string;
+    method?: "GET" | "POST" | "PUT";
+    headers?: Record<string, string>;
+    /** Expression that extracts the value from the HTTP response. */
+    responseParser: string;
+    /** Optional expression applied to the parsed value before packing. */
+    valueTransform?: string;
+}
+/** ECDH-wrapped API config payload sent to selected nodes. */
+interface EncKeyBundle {
+    ephemeralPub: string;
+    nonceSym: string;
+    ciphertext: string;
+    /** nodeIndex -> hex(nonceEnv || wrappedSymKey) */
+    envelopes: Record<string, string>;
+}
+/** Signs a message and returns a 64-byte ed25519 signature. */
+type Signer = (message: Uint8Array) => Promise<Uint8Array>;
+/**
+ * On-chain registry fields a gateway selection round is bound to. Fetched from
+ * `RegistryState` (`current_version`, `redundancy_buffer`).
+ */
+interface RegistrySelectionConfig {
+    registryVersion: number;
+    /** Selection padding: `min(signaturesRequired + redundancyBuffer, nodeCount)`. */
+    redundancyBuffer: number;
+}
+/**
+ * Aggregate Schnorr signature in the commitment-address form the shipped program
+ * verifies (`MOLPHA_MESSAGE_V1`). The legacy `(rx, ryParity)` fields are gone.
+ */
+interface SchnorrSignature {
+    /** 32-byte scalar, hex. */
+    s: string;
+    /** 20-byte EVM-style commitment address, hex. */
+    commitmentAddr: string;
+    /** 32-byte big-endian signers bitmap, hex. */
+    signersBitmap: string;
+}
+/** A completed gateway round, ready to submit on-chain. */
+interface DataUpdateResult {
+    feedId: string;
+    /** Human-readable value. */
+    value: string;
+    /** 32-byte packed value, hex. */
+    valuePacked: string;
+    /** canonicalTimestamp (seconds). */
+    timestamp: number;
+    registryVersion: number;
+    signaturesRequired: number;
+    /** 32-byte big-endian bitmap, hex. */
+    signersBitmap: string;
+    /** 32-byte scalar, hex. */
+    s: string;
+    /** 20-byte commitment address, hex. */
+    commitmentAddr: string;
+    /** Whether the value was freshly fetched this round. */
+    fresh: boolean;
+}
+
+type SolanaAddress = Address | string | InstanceType<typeof web3.PublicKey>;
+type SolanaConnection = InstanceType<typeof web3.Connection>;
+type SolanaKeypair = InstanceType<typeof web3.Keypair>;
+type SolanaAccountMeta = {
+    pubkey: InstanceType<typeof web3.PublicKey>;
+    isSigner: boolean;
+    isWritable: boolean;
+};
+
+/**
+ * Unified wallet surface: Anchor txs + optional gateway authSig signing.
+ */
+
+/** Anchor `Wallet` plus optional gateway auth override. */
+type MolphaWallet = Wallet & {
+    /**
+     * Signs gateway `authMessage` payloads. When omitted, derived from Anchor
+     * `Wallet.payer` when the keypair secret is available (Node `Wallet`, etc.).
+     */
+    signAuthMessage?: Signer;
+};
+/** ed25519 gateway signer from a Solana keypair's 32-byte seed. */
+declare function signerFromKeypair(keypair: SolanaKeypair): Signer;
+/** Resolve the gateway auth signer for a Molpha wallet, if available. */
+declare function gatewaySignerFromWallet(wallet: Wallet): Signer | undefined;
+
+export { type APIConfig as A, type DataUpdateResult as D, type EncKeyBundle as E, type MolphaWallet as M, type NodeKeyVerifier as N, type RegistrySelectionConfig as R, type Signer as S, type Node as a, type SolanaConnection as b, type SolanaAddress as c, type NodeKeyVerifierArgs as d, type SolanaAccountMeta as e, type SchnorrSignature as f, gatewaySignerFromWallet as g, type SolanaKeypair as h, signerFromKeypair as s };

package/idl/index.ts

@@ -0,0 +1,14 @@
+import type { Idl } from "@anchor-lang/core";
+import idlJson from "./molpha.json" with { type: "json" };
+
+/**
+ * Vendored Molpha Anchor IDL (`target/idl/molpha.json` from the program repo).
+ *
+ * Re-exported as `MOLPHA_IDL` and used as the default in `MolphaSDK` /
+ * `MolphaSolanaClient.create`. Pass `idl` / `programId` only when pinning a
+ * different deployment. Keep this copy aligned with the on-chain program you target.
+ */
+export const MOLPHA_IDL = idlJson as Idl;
+
+/** Program address baked into the vendored IDL. */
+export const MOLPHA_PROGRAM_ADDRESS: string = idlJson.address;