@molpha/sdk 0.1.0 → 0.2.0-dev-20260911175245

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
 export { Wallet } from '@anchor-lang/core';
-import { S as Signer, h as SolanaKeypair, M as MolphaWallet } from './wallet-CbpYQO4l.js';
+import { S as Signer, h as SolanaKeypair, M as MolphaWallet } from './wallet-udLZ5Iy0.js';
 import '@solana/kit';
 
 /** Load a Solana CLI keypair JSON file (array of 64 bytes) into a `Keypair`. */

package/dist/utils.js

@@ -1,4 +1,4 @@
-import { keypairFromSecretKey, signerFromKeypair } from './chunk-MFELBWSL.js';
+import { keypairFromSecretKey, signerFromKeypair } from './chunk-DT6IKCWB.js';
 import { readFileSync } from 'fs';
 import { Wallet } from '@anchor-lang/core';
 export { Wallet } from '@anchor-lang/core';

package/dist/{wallet-CbpYQO4l.d.ts → wallet-udLZ5Iy0.d.ts}

@@ -4,9 +4,13 @@ import { Address } from '@solana/kit';
 /**
  * Public protocol types (spec §8). Kept dependency-free so they can be imported
  * from any entry point.
+ *
+ * Hex convention: every `*Id`, bitmap, scalar and address field typed `string` is plain
+ * lowercase hex without a `0x` prefix unless documented otherwise.
  */
 /** A registered oracle node as returned by the gateway. */
 interface Node {
+    /** Position in the registry snapshot; maps to signers-bitmap bit `index`. */
     index: number;
     peerId: string;
     address: string;
@@ -15,8 +19,8 @@ interface Node {
 }
 /** Selected node-key material that must be authenticated before private API encryption. */
 interface NodeKeyVerifierArgs {
-    /** 32-byte feed id, hex. */
-    feedId: string;
+    /** 32-byte source id, hex. */
+    sourceId: string;
     /** On-chain registry version the gateway round is bound to. */
     registryVersion: number;
     /** Canonical timestamp used to derive the selected indexes. */
@@ -31,7 +35,7 @@ interface NodeKeyVerifierArgs {
  * private API request before secrets are encrypted or posted.
  */
 type NodeKeyVerifier = (args: NodeKeyVerifierArgs) => void | Promise<void>;
-/** The off-chain API definition a feed resolves. */
+/** The off-chain API definition a source resolves. */
 interface APIConfig {
     url: string;
     method?: "GET" | "POST" | "PUT";
@@ -49,20 +53,26 @@ interface EncKeyBundle {
     /** nodeIndex -> hex(nonceEnv || wrappedSymKey) */
     envelopes: Record<string, string>;
 }
-/** Signs a message and returns a 64-byte ed25519 signature. */
+/** Signs a 32-byte 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`).
+ * On-chain registry fields a gateway selection round is bound to. `registryVersion`
+ * comes from `RegistryState.current_version`; `redundancyBuffer` and `nodeCount` from
+ * the version-addressed `Registry` snapshot.
  */
 interface RegistrySelectionConfig {
     registryVersion: number;
     /** Selection padding: `min(signaturesRequired + redundancyBuffer, nodeCount)`. */
     redundancyBuffer: number;
+    /**
+     * `Registry.node_count` of the snapshot — the value the chain derives selection from.
+     * Optional for standalone callers; when absent the gateway node-list length is used.
+     */
+    nodeCount?: number;
 }
 /**
- * Aggregate Schnorr signature in the commitment-address form the shipped program
- * verifies (`MOLPHA_MESSAGE_V1`). The legacy `(rx, ryParity)` fields are gone.
+ * Aggregate Schnorr signature in the commitment-address form the program verifies over
+ * the attestation message (see `attestationMessageHash`).
  */
 interface SchnorrSignature {
     /** 32-byte scalar, hex. */
@@ -74,10 +84,11 @@ interface SchnorrSignature {
 }
 /** A completed gateway round, ready to submit on-chain. */
 interface DataUpdateResult {
-    feedId: string;
+    /** 32-byte source id, hex (`deriveSourceId(apiConfig)`). */
+    sourceId: string;
     /** Human-readable value. */
     value: string;
-    /** 32-byte packed value, hex. */
+    /** 32-byte packed value, hex — the bytes covered by the signature. */
     valuePacked: string;
     /** canonicalTimestamp (seconds). */
     timestamp: number;
@@ -109,7 +120,7 @@ type SolanaAccountMeta = {
 /** Anchor `Wallet` plus optional gateway auth override. */
 type MolphaWallet = Wallet & {
     /**
-     * Signs gateway `authMessage` payloads. When omitted, derived from Anchor
+     * Signs gateway request-auth hashes (`hashRequestAuth`). When omitted, derived from Anchor
      * `Wallet.payer` when the keypair secret is available (Node `Wallet`, etc.).
      */
     signAuthMessage?: Signer;
@@ -119,4 +130,4 @@ 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 };
+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 SolanaAccountMeta as b, type SolanaConnection as c, type SolanaAddress as d, type NodeKeyVerifierArgs as e, type SchnorrSignature as f, gatewaySignerFromWallet as g, type SolanaKeypair as h, signerFromKeypair as s };