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

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-udLZ5Iy0.js';
+import { S as Signer, n as SolanaKeypair, M as MolphaWallet } from './wallet-DwdBZgl1.js';
 import '@solana/kit';
 
 /** Load a Solana CLI keypair JSON file (array of 64 bytes) into a `Keypair`. */

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

@@ -77,7 +77,7 @@ interface RegistrySelectionConfig {
 interface SchnorrSignature {
     /** 32-byte scalar, hex. */
     s: string;
-    /** 20-byte EVM-style commitment address, hex. */
+    /** 20-bytecommitment address, hex. */
     commitmentAddr: string;
     /** 32-byte big-endian signers bitmap, hex. */
     signersBitmap: string;
@@ -103,6 +103,82 @@ interface DataUpdateResult {
     /** Whether the value was freshly fetched this round. */
     fresh: boolean;
 }
+/**
+ * Registry selection policy as advertised by the gateway's `GET /v1/nodes`.
+ *
+ * Advisory only — the authoritative values come from the on-chain registry read
+ * ({@link RegistrySelectionConfig}). Useful to gateway-only callers with no Solana
+ * connection, who otherwise cannot size a paid source's eligible set.
+ */
+interface RegistryInfo {
+    /** `RegistryState.current_version`. */
+    version: number;
+    nodeCount: number;
+    redundancyBuffer: number;
+}
+/** `GET /v1/nodes` payload: the peer set plus the advisory registry policy. */
+interface NodesInfo {
+    nodes: Node[];
+    /** Absent when the gateway could not read the chain. */
+    registry?: RegistryInfo;
+}
+/** EIP-712 domain fields of the token contract that settles a source payment. */
+interface AssetDomain {
+    name: string;
+    version: string;
+}
+/**
+ * Signs a 32-byte EIP-712 digest, returning a 65-byte `r || s || v` signature.
+ * Private keys never leave the caller's process.
+ */
+interface EvmSigner {
+    /** 0x-prefixed 20-byte address that funds the authorizations. */
+    address: string;
+    signDigest(digest: Uint8Array): Promise<Uint8Array>;
+}
+/** A paywalled API source's own payment terms, read from its HTTP 402. */
+interface UpstreamTerms {
+    x402Version: 1 | 2;
+    /** The source's `accepts` entry, echoed verbatim in the signed payload. */
+    requirements: Record<string, unknown>;
+    /** The source's network id, as it wrote it (CAIP-2 or an x402 v1 name). */
+    network: string;
+    chainId: number;
+    /** Token contract, 0x-prefixed — the EIP-712 verifying contract. */
+    asset: string;
+    payTo: string;
+    /** Price per source call, in token base units. */
+    amount: string;
+    maxTimeoutSeconds: number;
+    domain: AssetDomain;
+    /** The source URL these terms were read from. */
+    resource: string;
+}
+/**
+ * The gateway's relayed quote for a paywalled source, from `extensions.upstream`
+ * of a 402 response. It carries no payment terms of its own: the price, recipient
+ * and network come from the source's own 402, which the caller reads directly.
+ */
+interface UpstreamQuote {
+    resource: string;
+    signaturesRequired: number;
+    redundancyBuffer: number;
+    nodeCount: number;
+    /** Source fetches this round may perform, and so authorizations to sign. */
+    eligibleSetSize: number;
+    supportedX402Versions: number[];
+    /** The source's own rejection detail, when a round hit the paywall the hard way. */
+    error?: string;
+}
+/** Pays an API source that is itself x402-paywalled. */
+interface SourcePaymentOptions {
+    /** Wallet that funds the source calls (see `createEvmSignerFromPrivateKey`). */
+    signer: EvmSigner;
+    /** Terms to use instead of probing the source for its 402. */
+    terms?: UpstreamTerms;
+    /** EIP-712 domain override for sources that omit `extra.name` / `extra.version`. */
+    assetDomain?: AssetDomain;
+}
 
 type SolanaAddress = Address | string | InstanceType<typeof web3.PublicKey>;
 type SolanaConnection = InstanceType<typeof web3.Connection>;
@@ -130,4 +206,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 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 };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molpha/sdk",
-  "version": "0.2.0-dev-20260911175245",
+  "version": "0.2.0-dev-20260913100330",
   "description": "Molpha Consumer SDK — subscribe, request signed data from the gateway, submit attestations and read on-chain feeds.",
   "license": "MIT",
   "repository": {