@sentinelysolana/sdk 1.0.0

package/dist/clients/oracle.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * ============ ORACLECLIENT: MPP PAYMENT ABSTRACTION ============
+ *
+ * The masterpiece: Hides the x402 Protocol handshake behind
+ * a single beautiful method call.
+ *
+ * Developer calls: oracle.queryKalshiSignal()
+ * SDK silently handles:
+ * 1. Initial request (receives 402 Payment Required)
+ * 2. Micro-payment transaction (0.05 USDC)
+ * 3. Awaits confirmation
+ * 4. Fetches final prediction
+ *
+ * Developer experiences: 2-second await → AI prediction JSON
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleClient = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+/**
+ * OracleClient: Machine-to-Machine prediction oracle with invisible MPP payments
+ *
+ * @example
+ * ```typescript
+ * const oracle = new OracleClient(config);
+ * const signal = await oracle.queryKalshiSignal({
+ *   marketTicker: 'FED_RATES_MAR26',
+ * });
+ * // ^ 2-second await, automatic 0.05 USDC payment, full prediction
+ * console.log(signal.reasoning);
+ * ```
+ */
+class OracleClient {
+    /**
+     * Initialize OracleClient with Solana connection and config
+     *
+     * Supports both backend (keypair) and frontend (wallet adapter) modes
+     *
+     * @param config - SDK configuration
+     */
+    constructor(config) {
+        /** Treasury wallet (receives 0.05 USDC payments) */
+        this.TREASURY_WALLET = new web3_js_1.PublicKey('A7FnyNVtkcRMEkhaBjgtKZ1Z7Mh4N9XLBN8AGneXNK2F');
+        /** USDC Devnet mint */
+        this.USDC_MINT = new web3_js_1.PublicKey('EPjFWdd5Au17y2edWjNx5mKnvUcghLgMLKXZKL7xS1d');
+        /** x402 Protocol payment amount (0.05 USDC in cents) */
+        this.PAYMENT_AMOUNT_CENTS = 5;
+        this.connection = new web3_js_1.Connection(config.rpcUrl, config.commitment || 'confirmed');
+        // Determine signing mode (same as VaultClient)
+        if (config.keypair) {
+            this.keypair = web3_js_1.Keypair.fromSecretKey(config.keypair.secretKey);
+            this.userPublicKey = this.keypair.publicKey;
+        }
+        else if (config.signTransaction && config.publicKey) {
+            this.signTransaction = config.signTransaction;
+            this.userPublicKey = new web3_js_1.PublicKey(config.publicKey);
+        }
+        else {
+            throw new Error('OracleClient requires either (keypair) or (signTransaction + publicKey)');
+        }
+        this.mcpGatewayUrl =
+            config.mcpGatewayUrl || 'https://api.sentinely.io/v1';
+        this.irysGatewayUrl = config.irysGatewayUrl || 'https://gateway.irys.xyz';
+    }
+    /**
+     * Query Kalshi signal with automatic x402 micro-payment
+     *
+     * This is the core abstraction: developer calls once, SDK handles:
+     * 1. Initial request to MCP Gateway
+     * 2. Receives 402 Payment Required header
+     * 3. Executes 0.05 USDC Solana transaction
+     * 4. Awaits confirmation
+     * 5. Re-queries with payment headers
+     * 6. Returns final AI prediction
+     *
+     * @param query - Market query parameters
+     * @returns AI prediction with reasoning and context
+     *
+     * @example
+     * ```typescript
+     * const signal = await oracle.queryKalshiSignal({
+     *   marketTicker: 'FED_RATES_MAR26',
+     *   maxPriceBps: 9500,
+     * });
+     *
+     * console.log('Predicted side:', signal.side);
+     * console.log('Confidence:', signal.confidence, '%');
+     * console.log('Reasoning:', signal.reasoning);
+     * console.log('Kalshi market YES bid:', signal.kalshiContext.marketSnapshot.yesBidBps / 100, '%');
+     * ```
+     */
+    async queryKalshiSignal(query) {
+        try {
+            // ========= STEP 1: INITIAL REQUEST (EXPECTS 402) =========
+            this.log('Querying MCP Gateway...');
+            const initialResponse = await fetch(`${this.mcpGatewayUrl}/api/predict`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    market_ticker: query.marketTicker,
+                    max_price_bps: query.maxPriceBps || 10000,
+                }),
+            });
+            // Check if payment is required
+            if (initialResponse.status === 402) {
+                this.log('Payment required. Executing x402 micro-transaction...');
+                // ========= STEP 2: EXTRACT PAYMENT HEADERS =========
+                const paymentRequired = initialResponse.headers.get('x-mpp-version');
+                const paymentAmount = initialResponse.headers.get('x-payment-required-amount');
+                if (!paymentRequired || !paymentAmount) {
+                    throw new Error('Invalid 402 response: missing payment headers');
+                }
+                // ========= STEP 3: EXECUTE MICRO-PAYMENT =========
+                const paymentStatus = await this.executeMicroPayment(query.timeoutMs);
+                if (!paymentStatus.success || !paymentStatus.txHash) {
+                    throw new Error(`Payment failed: ${paymentStatus.error}`);
+                }
+                this.log(`Payment confirmed: ${paymentStatus.txHash}`);
+                // ========= STEP 4: RETRY REQUEST WITH PAYMENT PROOF =========
+                this.log('Retrying request with payment proof...');
+                const paidResponse = await fetch(`${this.mcpGatewayUrl}/api/predict`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'x-solana-payment-tx': paymentStatus.txHash,
+                        'x-solana-payment-signature': this.userPublicKey.toString(),
+                        'x-machine-public-key': this.userPublicKey.toString(),
+                    },
+                    body: JSON.stringify({
+                        market_ticker: query.marketTicker,
+                        max_price_bps: query.maxPriceBps || 10000,
+                    }),
+                });
+                if (!paidResponse.ok) {
+                    throw new Error(`Request failed after payment: ${paidResponse.statusText}`);
+                }
+                // ========= STEP 5: PARSE AND RETURN PREDICTION =========
+                const responseData = (await paidResponse.json());
+                return this.parseKalshiSignal(responseData, query.marketTicker);
+            }
+            else if (initialResponse.ok) {
+                // Payment already made (e.g., subscription)
+                const responseData = (await initialResponse.json());
+                return this.parseKalshiSignal(responseData, query.marketTicker);
+            }
+            else {
+                throw new Error(`Request failed: ${initialResponse.status} ${initialResponse.statusText}`);
+            }
+        }
+        catch (error) {
+            throw this.formatError('QUERY_FAILED', error);
+        }
+    }
+    /**
+     * Execute atomic 0.05 USDC micro-payment to treasury
+     *
+     * @private
+     * @param timeoutMs - Optional timeout
+     * @returns Payment status with transaction hash
+     */
+    async executeMicroPayment(timeoutMs) {
+        try {
+            // Get user's USDC token account
+            const userTokenAccount = await (0, spl_token_1.getAssociatedTokenAddress)(this.USDC_MINT, this.userPublicKey);
+            // Get treasury's USDC token account
+            const treasuryTokenAccount = await (0, spl_token_1.getAssociatedTokenAddress)(this.USDC_MINT, this.TREASURY_WALLET);
+            // Build transaction
+            const transaction = new web3_js_1.Transaction();
+            // Add SPL token transfer instruction
+            transaction.add((0, spl_token_1.createTransferInstruction)(userTokenAccount, treasuryTokenAccount, this.userPublicKey, this.PAYMENT_AMOUNT_CENTS, // 0.05 USDC in cents
+            [], spl_token_1.TOKEN_PROGRAM_ID));
+            // Sign and send with timeout
+            const startTime = Date.now();
+            const timeout = timeoutMs || 30000;
+            const txHash = await Promise.race([
+                this.sendAndConfirmTx(transaction),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Payment transaction timeout')), timeout)),
+            ]);
+            const elapsedTime = Date.now() - startTime;
+            this.log(`Payment executed in ${elapsedTime}ms`);
+            return {
+                success: true,
+                txHash,
+                amountPaidCents: this.PAYMENT_AMOUNT_CENTS,
+                timestamp: Date.now(),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                timestamp: Date.now(),
+            };
+        }
+    }
+    /**
+     * Parse MCP Gateway response into KalshiSignal
+     *
+     * @private
+     */
+    parseKalshiSignal(data, marketTicker) {
+        const prediction = data.prediction || {};
+        return {
+            marketTicker,
+            side: prediction.predicted_outcome === 'YES' ? 'YES' : 'NO',
+            amount: prediction.amount_usdc || 0,
+            confidence: prediction.confidence || 0,
+            riskScore: prediction.risk_score || 0,
+            reasoning: prediction.reasoning || '',
+            timestamp: Date.now(),
+            predictionId: `pred_${Date.now()}`,
+            kalshiContext: {
+                marketSnapshot: {
+                    yesBidBps: prediction.kalshi_yes_bid_bps || 5000,
+                    noBidBps: prediction.kalshi_no_bid_bps || 5000,
+                    isLive: prediction.kalshi_is_live || false,
+                },
+                topTradersConsensus: {
+                    consensusSide: prediction.top_traders_side || 'YES',
+                    consensusBps: prediction.top_traders_bps || 5000,
+                },
+            },
+        };
+    }
+    /**
+     * Send and confirm transaction (supports both keypair and wallet adapter)
+     *
+     * @private
+     */
+    async sendAndConfirmTx(transaction) {
+        if (this.keypair) {
+            // Backend mode: manual signing
+            transaction.sign(this.keypair);
+            const serialized = transaction.serialize();
+            const txHash = await this.connection.sendRawTransaction(serialized, {
+                skipPreflight: false,
+                maxRetries: 5,
+            });
+            await this.connection.confirmTransaction(txHash, 'confirmed');
+            return txHash;
+        }
+        else if (this.signTransaction) {
+            // Frontend mode: Use wallet adapter signing (non-custodial)
+            try {
+                const signedTx = await this.signTransaction(transaction);
+                const serialized = signedTx.serialize();
+                const txHash = await this.connection.sendRawTransaction(serialized, {
+                    skipPreflight: false,
+                    maxRetries: 5,
+                });
+                await this.connection.confirmTransaction(txHash, 'confirmed');
+                return txHash;
+            }
+            catch (error) {
+                throw new Error(`Transaction signing failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        else {
+            throw new Error('No signer available');
+        }
+    }
+    /**
+     * Format errors consistently
+     *
+     * @private
+     */
+    formatError(code, error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return new Error(`[OracleClient] ${code}: ${message}`);
+    }
+    /**
+     * Logging utility
+     *
+     * @private
+     */
+    log(message) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.log(`[OracleClient] ${message}`);
+        }
+    }
+}
+exports.OracleClient = OracleClient;
+exports.default = OracleClient;
+//# sourceMappingURL=oracle.js.map

package/dist/clients/oracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/clients/oracle.ts"],"names":[],"mappings":"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"}

package/dist/clients/vault.d.ts

@@ -0,0 +1,173 @@
+/**
+ * ============ VAULTCLIENT: ANCHOR ABSTRACTION ============
+ *
+ * Handles all NeuralVault operations without requiring
+ * developers to understand Anchor PDAs or cryptography.
+ *
+ * Simple API:
+ * - vault.initializeVault()
+ * - vault.deposit(amountUsdc)
+ * - vault.setRiskLimits({ maxPositionBps })
+ */
+import type { SentinelyConfig, VaultInitParams, RiskLimits, DepositParams, VaultState, VaultInitResponse, DepositResponse, RiskUpdateResponse } from '../types';
+/**
+ * VaultClient: Institutional vault management without Anchor complexity
+ *
+ * @example
+ * ```typescript
+ * const vault = new VaultClient(config);
+ * await vault.initializeVault({ maxPositionBps: 500 });
+ * await vault.deposit({ amountUsdc: 10000 });
+ * await vault.setRiskLimits({ maxPositionBps: 300 });
+ * const state = await vault.getVaultState();
+ * ```
+ */
+export declare class VaultClient {
+    private connection;
+    private keypair?;
+    private signTransaction?;
+    private programId;
+    private userPublicKey;
+    /** USDC Devnet mint */
+    private readonly USDC_MINT;
+    /**
+     * Initialize VaultClient
+     *
+     * Supports two modes:
+     * 1. Backend mode: Pass keypair for server-side signing
+     * 2. Frontend mode: Pass signTransaction + publicKey for wallet adapter (non-custodial)
+     *
+     * @param config - SDK configuration
+     */
+    constructor(config: SentinelyConfig);
+    /**
+     * Initialize a new NeuralVault PDA
+     *
+     * Abstracts away:
+     * - PDA derivation
+     * - Associated token account creation
+     * - Anchor instruction building
+     * - Rent funding
+     *
+     * @param params - Vault initialization parameters
+     * @returns Vault public key and transaction hash
+     *
+     * @example
+     * ```typescript
+     * const response = await vault.initializeVault({
+     *   maxPositionBps: 500,  // 5% max position
+     *   riskLevel: 60,
+     * });
+     * console.log('Vault created:', response.vaultPubkey);
+     * ```
+     */
+    initializeVault(params: VaultInitParams): Promise<VaultInitResponse>;
+    /**
+     * Deposit USDC into vault
+     *
+     * Abstracts away:
+     * - SPL token transfer
+     * - Anchor instruction encoding
+     * - Transaction signing
+     *
+     * @param params - Deposit parameters (amount in USDC)
+     * @returns Deposit confirmation and new balance
+     *
+     * @example
+     * ```typescript
+     * const response = await vault.deposit({ amountUsdc: 5000 });
+     * console.log('Deposited:', response.amountUsdc);
+     * console.log('New balance:', response.newBalanceUsdc);
+     * ```
+     */
+    deposit(params: DepositParams): Promise<DepositResponse>;
+    /**
+     * Update vault risk parameters
+     *
+     * Allows programmatic adjustment of:
+     * - Max position size (in basis points)
+     * - Risk tolerance level
+     *
+     * Abstracts away:
+     * - Anchor instruction building
+     * - Fixed-point BPS math
+     * - Transaction signing
+     *
+     * @param limits - New risk limits
+     * @returns Confirmation and updated parameters
+     *
+     * @example
+     * ```typescript
+     * const response = await vault.setRiskLimits({
+     *   maxPositionBps: 300,  // Reduce to 3%
+     *   riskLevel: 40,
+     * });
+     * console.log('Updated risk limit to:', response.maxPositionBps / 100, '%');
+     * ```
+     */
+    setRiskLimits(limits: RiskLimits): Promise<RiskUpdateResponse>;
+    /**
+     * Fetch current vault state from chain
+     *
+     * Returns:
+     * - Balance
+     * - Risk parameters
+     * - Activity status
+     * - Fee metrics
+     *
+     * @returns Current vault state
+     *
+     * @example
+     * ```typescript
+     * const state = await vault.getVaultState();
+     * console.log('Balance:', state.balanceCents / 100, 'USDC');
+     * console.log('Max position:', state.maxPositionBps / 100, '%');
+     * ```
+     */
+    getVaultState(): Promise<VaultState>;
+    /**
+     * Withdraw USDC from vault
+     *
+     * @param amountUsdc - Amount to withdraw
+     * @returns Withdrawal confirmation
+     */
+    withdraw(amountUsdc: number): Promise<DepositResponse>;
+    /**
+     * Send and confirm transaction (supports both keypair and wallet adapter)
+     *
+     * @private
+     */
+    private sendAndConfirmTx;
+    /**
+     * Read BigUInt64LE from buffer (for u64 fields)
+     *
+     * @private
+     */
+    private readBigUInt64LE;
+    /**
+     * Build instruction data for initialize_vault
+     *
+     * @private
+     */
+    private buildInitializeVaultIx;
+    /**
+     * Get sysvar rent address
+     *
+     * @private
+     */
+    private getSysvarRent;
+    /**
+     * Format errors with context and consistency
+     *
+     * @private
+     */
+    private formatError;
+    /**
+     * Logging utility
+     *
+     * @private
+     */
+    private log;
+}
+export default VaultClient;
+//# sourceMappingURL=vault.d.ts.map

package/dist/clients/vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/clients/vault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAqC;IAC7D,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAY;IAEjC,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAExB;IAEF;;;;;;;;OAQG;gBACS,MAAM,EAAE,eAAe;IAuBnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwE1E;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IA0E9D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+DpE;;;;;;;;;;;;;;;;;OAiBG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAiG1C;;;;;OAKG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA2E5D;;;;OAIG;YACW,gBAAgB;IAkC9B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAmC9B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;OAIG;IACH,OAAO,CAAC,GAAG;CASZ;AAED,eAAe,WAAW,CAAC"}