@molpha/sdk 0.2.0-dev-20260913100330 → 0.2.0-dev-20261001125531

package/dist/utils.d.ts

@@ -1,14 +1,10 @@
 export { Wallet } from '@anchor-lang/core';
-import { S as Signer, n as SolanaKeypair, M as MolphaWallet } from './wallet-DwdBZgl1.js';
+import { r as SolanaKeypair, M as MolphaWallet } from './wallet-HfGXPpOp.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 };
+export { MolphaWallet, loadKeypair, walletFromKeypairFile };

package/dist/utils.js

@@ -1,4 +1,4 @@
-import { keypairFromSecretKey, signerFromKeypair } from './chunk-DT6IKCWB.js';
+import { keypairFromSecretKey } from './chunk-2X22JY7Q.js';
 import { readFileSync } from 'fs';
 import { Wallet } from '@anchor-lang/core';
 export { Wallet } from '@anchor-lang/core';
@@ -10,11 +10,7 @@ function loadKeypair(path) {
 function walletFromKeypairFile(path) {
   return new Wallet(loadKeypair(path));
 }
-var nodeWalletFromFile = walletFromKeypairFile;
-function keypairFileSigner(path) {
-  return signerFromKeypair(loadKeypair(path));
-}
 
-export { keypairFileSigner, loadKeypair, nodeWalletFromFile, walletFromKeypairFile };
+export { loadKeypair, walletFromKeypairFile };
 //# sourceMappingURL=utils.js.map
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +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"]}
+{"version":3,"sources":["../src/utils.ts"],"names":[],"mappings":";;;;;AAUO,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","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 { keypairFromSecretKey, type SolanaKeypair } from \"./solana/kit.js\";\nimport 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\nexport { Wallet };\nexport type { MolphaWallet };\n"]}

package/dist/{wallet-DwdBZgl1.d.ts → wallet-HfGXPpOp.d.ts}

@@ -44,6 +44,37 @@ interface APIConfig {
     responseParser: string;
     /** Optional expression applied to the parsed value before packing. */
     valueTransform?: string;
+    /**
+     * Median tolerance mode. Part of the `sourceId`; OMIT it for exact mode. See
+     * {@link AggregationConfig}.
+     */
+    aggregation?: AggregationConfig;
+}
+/** Numeric encoding of a tolerance-mode value: a signed `int256` scaled by `10^decimals`. */
+interface NumericConfig {
+    type: "int256";
+    /** Fractional digits, `0..255` (u8). The parsed decimal is scaled by `10^decimals`, rounded half to even. */
+    decimals: number;
+}
+/**
+ * Median tolerance aggregation. Instead of requiring every signer to fetch the identical
+ * value, the selected nodes exchange signed observations, drop stale ones (`maxAgeMs`) and
+ * those further than `maxDeviationBps` from the lower median, and sign the lower median of
+ * `signaturesRequired` surviving observations. The signed value is a signed `int256`
+ * (`encodeInt256Decimal`, `decodeInt256`, `formatInt256Decimal`).
+ *
+ * The whole object is hashed into the `sourceId` in exactly this key order. Requires
+ * `signaturesRequired >= 3`. `mode: "exact"` is rejected: exact mode is expressed by
+ * omitting `aggregation`.
+ */
+interface AggregationConfig {
+    mode: "tolerance";
+    rule: "median";
+    /** u32. Allowed deviation from the lower median, in basis points. */
+    maxDeviationBps: number;
+    /** Positive integer (u64 on the node, ≤ 2^53-1 here). Max observation age, in milliseconds. */
+    maxAgeMs: number;
+    numeric: NumericConfig;
 }
 /** ECDH-wrapped API config payload sent to selected nodes. */
 interface EncKeyBundle {
@@ -82,24 +113,27 @@ interface SchnorrSignature {
     /** 32-byte big-endian signers bitmap, hex. */
     signersBitmap: string;
 }
-/** A completed gateway round, ready to submit on-chain. */
-interface DataUpdateResult {
+/** Signed oracle attestation payload (cross-VM `AttestationPayload`). */
+interface AttestationPayload {
+    /** 32-byte packed value, hex — the bytes covered by the signature. */
+    value: string;
     /** 32-byte source id, hex (`deriveSourceId(apiConfig)`). */
     sourceId: string;
-    /** Human-readable value. */
-    value: string;
-    /** 32-byte packed value, hex — the bytes covered by the signature. */
-    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;
+    /** Unix seconds (u64). */
+    canonicalTimestamp: number;
+}
+/**
+ * Threshold-signed oracle attestation from a completed gateway round, ready to submit on-chain.
+ * Matches the cross-VM `Attestation` (`payload` + `signature`). `value` and `fresh` are gateway
+ * metadata and are not part of the signed struct.
+ */
+interface Attestation {
+    payload: AttestationPayload;
+    signature: SchnorrSignature;
+    /** Human-readable value (not signed). */
+    value: string;
     /** Whether the value was freshly fetched this round. */
     fresh: boolean;
 }
@@ -206,4 +240,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 EvmSigner as E, type MolphaWallet as M, type NodeKeyVerifier as N, type RegistrySelectionConfig as R, type Signer as S, type UpstreamQuote as U, type AssetDomain as a, type UpstreamTerms as b, type Node as c, type NodesInfo as d, type SourcePaymentOptions as e, type SolanaAccountMeta as f, type SolanaConnection as g, type SolanaAddress as h, type NodeKeyVerifierArgs as i, type EncKeyBundle as j, type RegistryInfo as k, type SchnorrSignature as l, gatewaySignerFromWallet as m, type SolanaKeypair as n, signerFromKeypair as s };
+export { type APIConfig as A, type EvmSigner as E, type MolphaWallet as M, type NodeKeyVerifier as N, type RegistrySelectionConfig as R, type Signer as S, type UpstreamQuote as U, type AssetDomain as a, type UpstreamTerms as b, type Node as c, type NodesInfo as d, type SourcePaymentOptions as e, type Attestation as f, type SolanaAccountMeta as g, type SolanaConnection as h, type SolanaAddress as i, type NodeKeyVerifierArgs as j, type AggregationConfig as k, type AttestationPayload as l, type EncKeyBundle as m, type NumericConfig as n, type RegistryInfo as o, type SchnorrSignature as p, gatewaySignerFromWallet as q, type SolanaKeypair as r, signerFromKeypair as s };