@omegax/protocol-sdk 0.4.0 → 0.4.2

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/protocol.js

@@ -1172,7 +1172,7 @@ function encodeSubmitOutcomeAttestationData(params) {
     const outcomeHash = hashStringTo32(params.outcomeId);
     const replayHash = hashStringTo32(params.replayKey);
     const digest = params.attestationDigestHex
-        ? Buffer.from(params.attestationDigestHex.replace(/^0x/, ''), 'hex')
+        ? Buffer.from(fromHex(params.attestationDigestHex, 32))
         : Buffer.from(hashStringTo32(`${params.cycleId}:${params.outcomeId}:${params.replayKey}`));
     if (digest.length !== 32) {
         throw new Error('attestation digest must be 32 bytes');

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/dist/utils.js

@@ -86,7 +86,13 @@ export function toHex(bytes) {
     return Buffer.from(bytes).toString('hex');
 }
 export function fromHex(value, expectedLength) {
-    const normalized = value.trim().toLowerCase().replace(/^0x/, '');
+    const normalized = value.trim().replace(/^0x/i, '');
+    if (normalized.length % 2 !== 0) {
+        throw new Error('invalid hex string: expected an even number of characters');
+    }
+    if (!/^[0-9a-fA-F]*$/.test(normalized)) {
+        throw new Error('invalid hex string: contains non-hex characters');
+    }
     const bytes = Buffer.from(normalized, 'hex');
     if (typeof expectedLength === 'number' && bytes.length !== expectedLength) {
         throw new Error(`invalid hex length: expected ${expectedLength}, got ${bytes.length}`);

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.2",
+  "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,