@omegax/protocol-sdk 0.4.0 → 0.4.1

package/README.md

@@ -2,6 +2,16 @@
 
 TypeScript SDK for OmegaX protocol integrations on Solana.
 
+## Network status
+
+- Current live network: **devnet beta**
+- Mainnet support: **coming soon**
+- Protocol UI: https://protocol.omegax.health
+- Protocol repository: `omegaxhealth_protocol`
+- Governance token:
+  - Mainnet CA: `4Aar9R14YMbEie6yh8WcH1gWXrBtfucoFjw6SpjXpump`
+  - Devnet: governance token distribution is via the protocol faucet
+
 It supports:
 
 - Oracle lifecycle, staking, attestation voting, and reward claims
@@ -39,6 +49,7 @@ npm install @omegax/protocol-sdk
 - Builders create **unsigned** transactions. Your app signs and submits them.
 - `programId` is explicit in SDK flows and should be passed from your runtime config.
 - Use `createProtocolClient(connection, programId)` for protocol operations.
+- `createConnection({ network: 'mainnet' })` is available but warns that mainnet is coming soon.
 
 ## Quickstart
 
@@ -47,7 +58,11 @@ npm install @omegax/protocol-sdk
 ```ts
 import { createConnection, createProtocolClient, createRpcClient } from '@omegax/protocol-sdk';
 
-const connection = createConnection('https://api.mainnet-beta.solana.com', 'confirmed');
+const connection = createConnection({
+  network: 'devnet',
+  rpcUrl: process.env.SOLANA_RPC_URL,
+  commitment: 'confirmed',
+});
 const programId = 'Bn6eixac1QEEVErGBvBjxAd6pgB9e2q4XHvAkinQ5y1B';
 
 const protocol = createProtocolClient(connection, programId);

package/dist/rpc.d.ts

@@ -1,4 +1,23 @@
 import { Connection, type Commitment } from '@solana/web3.js';
 import type { RpcClient } from './types.js';
+export type OmegaXNetwork = 'devnet' | 'mainnet';
+export type OmegaXNetworkInput = OmegaXNetwork | 'mainnet-beta';
+export interface OmegaXConnectionOptions {
+    network?: OmegaXNetworkInput;
+    rpcUrl?: string;
+    commitment?: Commitment;
+    warnOnComingSoon?: boolean;
+}
+export interface OmegaXNetworkInfo {
+    network: OmegaXNetwork;
+    solanaCluster: 'devnet' | 'mainnet-beta';
+    defaultRpcUrl: string;
+    isAvailable: boolean;
+    status: 'live' | 'coming_soon';
+    statusMessage: string;
+}
+export declare const OMEGAX_NETWORKS: Record<OmegaXNetwork, OmegaXNetworkInfo>;
+export declare function getOmegaXNetworkInfo(input?: OmegaXNetworkInput): OmegaXNetworkInfo;
 export declare function createConnection(rpcUrl: string, commitment?: Commitment): Connection;
+export declare function createConnection(options?: OmegaXConnectionOptions): Connection;
 export declare function createRpcClient(connection: Connection): RpcClient;

package/dist/rpc.js

@@ -1,7 +1,47 @@
 import { Connection, Transaction, } from '@solana/web3.js';
 import { normalizeClaimSimulationFailure } from './claims.js';
-export function createConnection(rpcUrl, commitment = 'confirmed') {
-    return new Connection(rpcUrl, commitment);
+export const OMEGAX_NETWORKS = {
+    devnet: {
+        network: 'devnet',
+        solanaCluster: 'devnet',
+        defaultRpcUrl: 'https://api.devnet.solana.com',
+        isAvailable: true,
+        status: 'live',
+        statusMessage: 'OmegaX devnet beta is live.',
+    },
+    mainnet: {
+        network: 'mainnet',
+        solanaCluster: 'mainnet-beta',
+        defaultRpcUrl: 'https://api.mainnet-beta.solana.com',
+        isAvailable: false,
+        status: 'coming_soon',
+        statusMessage: 'OmegaX mainnet support is coming soon. Please use devnet beta for now.',
+    },
+};
+function normalizeOmegaXNetwork(input) {
+    const normalized = String(input ?? 'devnet').trim().toLowerCase();
+    if (normalized === 'devnet')
+        return 'devnet';
+    if (normalized === 'mainnet' || normalized === 'mainnet-beta')
+        return 'mainnet';
+    throw new Error(`Unsupported OmegaX network "${String(input)}". Supported networks: "devnet", "mainnet".`);
+}
+export function getOmegaXNetworkInfo(input = 'devnet') {
+    const network = normalizeOmegaXNetwork(input);
+    return { ...OMEGAX_NETWORKS[network] };
+}
+export function createConnection(rpcUrlOrOptions = { network: 'devnet' }, commitment = 'confirmed') {
+    if (typeof rpcUrlOrOptions === 'string') {
+        return new Connection(rpcUrlOrOptions, commitment);
+    }
+    const options = rpcUrlOrOptions ?? {};
+    const resolvedCommitment = options.commitment ?? 'confirmed';
+    const networkInfo = getOmegaXNetworkInfo(options.network);
+    if (!networkInfo.isAvailable && (options.warnOnComingSoon ?? true)) {
+        console.warn(`[omegax-sdk] ${networkInfo.statusMessage}`);
+    }
+    const rpcUrl = options.rpcUrl ?? networkInfo.defaultRpcUrl;
+    return new Connection(rpcUrl, resolvedCommitment);
 }
 export function createRpcClient(connection) {
     return {

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@omegax/protocol-sdk",
-  "version": "0.4.0",
-  "description": "TypeScript SDK for OmegaX protocol oracle, reward, and coverage integrations on Solana.",
+  "version": "0.4.1",
+  "description": "TypeScript SDK for OmegaX protocol integrations on Solana devnet beta (mainnet coming soon).",
   "keywords": [
     "omegax",
     "solana",
     "protocol",
     "oracle",
     "sdk",
-    "health"
+    "health",
+    "devnet"
   ],
   "license": "Apache-2.0",
   "private": false,