blue-js-sdk 2.0.0

package/operator.js

@@ -0,0 +1,134 @@
+/**
+ * Sentinel dVPN SDK — Operator Entry Point
+ *
+ * ~70 exports for operators, testers, plan managers, and auditing tools.
+ * Batch sessions, network audit, plan/provider/lease management, fee grants, authz.
+ *
+ * Usage:
+ *   import { batchStartSessions, auditNetwork } from 'sentinel-dvpn-sdk/operator';
+ *
+ * For consumer VPN app functions (connect, disconnect, wallet, security):
+ *   import { connect, disconnect, listNodes } from 'sentinel-dvpn-sdk/consumer';
+ *
+ * WARNING: These functions can cost real P2P tokens in bulk. They are NOT for
+ * end-user VPN apps. A consumer app accidentally using batchStartSessions
+ * will drain the wallet.
+ */
+
+// ─── Batch Session Operations ───────────────────────────────────────────────
+
+export {
+  batchStartSessions,
+  waitForBatchSessions,
+} from './batch.js';
+
+export {
+  buildBatchStartSession,
+  extractAllSessionIds,
+} from './cosmjs-setup.js';
+
+// ─── Network Audit & Node Testing ──────────────────────────────────────────
+
+export {
+  testNode,
+  auditNetwork,
+  loadTransportCache,
+  saveTransportCache,
+  recordTransportSuccess,
+  recordTransportFailure,
+} from './audit.js';
+
+// ─── Plan Management ────────────────────────────────────────────────────────
+
+export {
+  encodeMsgCreatePlan,
+  encodeMsgUpdatePlanStatus,
+  encodeMsgLinkNode,
+  encodeMsgUnlinkNode,
+  encodeMsgPlanStartSession,
+} from './plan-operations.js';
+
+export {
+  encodeMsgUpdatePlanDetails,
+} from './v3protocol.js';
+
+// ─── Provider Management ────────────────────────────────────────────────────
+
+export {
+  encodeMsgRegisterProvider,
+  encodeMsgUpdateProviderDetails,
+  encodeMsgUpdateProviderStatus,
+} from './plan-operations.js';
+
+// ─── Lease Management ───────────────────────────────────────────────────────
+
+export {
+  encodeMsgStartLease,
+  encodeMsgEndLease,
+} from './plan-operations.js';
+
+// ─── Fee Grants ─────────────────────────────────────────────────────────────
+
+export {
+  buildFeeGrantMsg,
+  buildRevokeFeeGrantMsg,
+  queryFeeGrants,
+  queryFeeGrantsIssued,
+  grantPlanSubscribers,
+  renewExpiringGrants,
+  monitorFeeGrants,
+} from './cosmjs-setup.js';
+
+// ─── Authz ──────────────────────────────────────────────────────────────────
+
+export {
+  buildAuthzGrantMsg,
+  buildAuthzRevokeMsg,
+  buildAuthzExecMsg,
+  encodeForExec,
+  queryAuthzGrants,
+} from './cosmjs-setup.js';
+
+// ─── Chain Direct (broadcast, registry, LCD) ────────────────────────────────
+
+export {
+  broadcast,
+  broadcastWithFeeGrant,
+  createSafeBroadcaster,
+  createClient,
+  buildRegistry,
+  lcd,
+  MSG_TYPES,
+} from './cosmjs-setup.js';
+
+// ─── Address Conversion ─────────────────────────────────────────────────────
+
+export {
+  sentToSentprov,
+  sentToSentnode,
+  sentprovToSent,
+} from './cosmjs-setup.js';
+
+// ─── Query Helpers (plans, subscriptions, network) ──────────────────────────
+
+export {
+  discoverPlans,
+  queryPlanSubscribers,
+  getPlanStats,
+  queryPlanNodes,
+  getNetworkOverview,
+} from './cosmjs-setup.js';
+
+// ─── Session Encoders ───────────────────────────────────────────────────────
+
+export {
+  encodeMsgStartSession,
+  encodeMsgEndSession,
+  encodeMsgStartSubscription,
+  encodeMsgSubStartSession,
+  encodeMsgCancelSubscription,
+  encodeMsgRenewSubscription,
+  encodeMsgShareSubscription,
+  encodeMsgUpdateSubscription,
+  encodeMsgUpdateSession,
+} from './v3protocol.js';

package/package.json

@@ -0,0 +1,113 @@
+{
+  "name": "blue-js-sdk",
+  "version": "2.0.0",
+  "description": "Decentralized VPN SDK for the Sentinel P2P bandwidth network. WireGuard + V2Ray tunnels, Cosmos blockchain, 900+ nodes across 90+ countries. TypeScript types included.",
+  "type": "module",
+  "main": "index.js",
+  "types": "types/index.d.ts",
+  "bin": {
+    "sentinel": "./cli/index.js",
+    "sentinel-ai": "./ai-path/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./index.js"
+    },
+    "./consumer": "./consumer.js",
+    "./operator": "./operator.js",
+    "./ai-path": "./ai-path/index.js",
+    "./blue": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "types/*": [
+        "types/*"
+      ]
+    }
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "*.js",
+    "types/",
+    "chain/",
+    "connection/",
+    "protocol/",
+    "wallet/",
+    "security/",
+    "pricing/",
+    "speedtest/",
+    "state/",
+    "client/",
+    "cli/",
+    "config/",
+    "errors/",
+    "examples/",
+    "ai-path/",
+    "bin/setup.js",
+    "dist/",
+    "src/",
+    "generated/",
+    "proto/",
+    "tsconfig.json",
+    "tsconfig.build.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npx tsc --project tsconfig.build.json",
+    "proto:generate": "npx protoc --ts_proto_out=generated --ts_proto_opt=esModuleInterop=true --ts_proto_opt=env=node --ts_proto_opt=outputTypeRegistry=true --proto_path=proto proto/sentinel/types/v1/*.proto proto/sentinel/node/v3/*.proto proto/sentinel/session/v3/*.proto proto/sentinel/plan/v3/*.proto proto/sentinel/subscription/v3/*.proto proto/sentinel/lease/v1/*.proto proto/sentinel/provider/v2/*.proto",
+    "test": "node test/smoke.js",
+    "test:exports": "node -e \"import('./index.js').then(m => console.log(Object.keys(m).length + ' exports OK'))\"",
+    "postinstall": "node bin/setup.js || true"
+  },
+  "keywords": [
+    "vpn",
+    "dvpn",
+    "sentinel",
+    "decentralized",
+    "wireguard",
+    "v2ray",
+    "p2p",
+    "privacy",
+    "cosmos",
+    "blockchain",
+    "socks5",
+    "tunnel",
+    "bandwidth",
+    "peer-to-peer",
+    "censorship-resistant",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sentinel-Autonomybuilder/sentinel-dvpn-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Sentinel-Autonomybuilder/sentinel-dvpn-sdk/issues"
+  },
+  "homepage": "https://github.com/Sentinel-Autonomybuilder/sentinel-dvpn-sdk#readme",
+  "dependencies": {
+    "@cosmjs/amino": "0.32.2",
+    "@cosmjs/crypto": "0.32.2",
+    "@cosmjs/encoding": "0.32.2",
+    "@cosmjs/proto-signing": "0.32.2",
+    "@cosmjs/stargate": "0.32.2",
+    "@noble/curves": "^1.4.0",
+    "axios": "^1.7.0",
+    "dotenv": "^16.4.0",
+    "socks-proxy-agent": "^8.0.0"
+  },
+  "devDependencies": {
+    "@bufbuild/protobuf": "^2.11.0",
+    "ts-proto": "^2.11.6",
+    "typescript": "^6.0.2"
+  }
+}

package/plan-operations.js

@@ -0,0 +1,199 @@
+/**
+ * Plan, Provider & Lease Operations for Sentinel dVPN
+ *
+ * Contains all encoder functions for plan management, provider registration,
+ * and node leasing. These are the 10 message types NOT in v3protocol.js.
+ *
+ * v3protocol.js handles: direct session, subscription, sub-session (3 types)
+ * This file handles: provider (3), plan (4), lease (2), plan-session (1) = 10 types
+ */
+
+// ─── Protobuf Encoding Primitives ────────────────────────────────────────────
+// Shared with v3protocol.js — single source of truth for protobuf encoding.
+import { encodeVarint, protoString, protoInt64, protoEmbedded, decToScaledInt, encodePrice } from './v3protocol.js';
+
+// protoUint64 is identical to protoInt64 — both use varint wire type 0
+function protoUint64(fieldNum, n) {
+  return protoInt64(fieldNum, n);
+}
+
+function protoBool(fieldNum, val) {
+  if (!val) return Buffer.alloc(0); // false = omit (protobuf default)
+  return Buffer.concat([encodeVarint((BigInt(fieldNum) << 3n) | 0n), encodeVarint(1)]);
+}
+
+// decToScaledInt and encodePrice imported from v3protocol.js (single source of truth)
+
+/**
+ * Encode google.protobuf.Duration { seconds, nanos }
+ * Used by MsgCreatePlanRequest for plan duration.
+ */
+function encodeDuration({ seconds, nanos = 0 }) {
+  return Buffer.concat([
+    protoInt64(1, seconds),
+    nanos ? protoInt64(2, nanos) : Buffer.alloc(0),
+  ]);
+}
+
+// ─── Provider Messages ───────────────────────────────────────────────────────
+
+/**
+ * MsgRegisterProviderRequest (sentinel.provider.v3)
+ * Register a new provider. One wallet = one provider.
+ * from: sent prefix (account address)
+ */
+export function encodeMsgRegisterProvider({ from, name, identity, website, description }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoString(2, name),
+    protoString(3, identity || ''),
+    protoString(4, website || ''),
+    protoString(5, description || ''),
+  ]));
+}
+
+/**
+ * MsgUpdateProviderDetailsRequest (sentinel.provider.v3)
+ * Update existing provider info.
+ * from: sentprov prefix (provider address)
+ */
+export function encodeMsgUpdateProviderDetails({ from, name, identity, website, description }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoString(2, name || ''),
+    protoString(3, identity || ''),
+    protoString(4, website || ''),
+    protoString(5, description || ''),
+  ]));
+}
+
+/**
+ * MsgUpdateProviderStatusRequest (sentinel.provider.v3)
+ * Activate/deactivate provider. Status: 1=active, 2=inactive_pending, 3=inactive
+ * from: sentprov prefix (provider address — use sentToSentprov() to derive)
+ */
+export function encodeMsgUpdateProviderStatus({ from, status }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, status),
+  ]));
+}
+
+// ─── Plan Messages ───────────────────────────────────────────────────────────
+
+/**
+ * MsgCreatePlanRequest (sentinel.plan.v3)
+ * Create a new subscription plan.
+ * from: sentprov prefix (provider address)
+ * bytes: total bandwidth as string (e.g. "10000000000" for 10GB)
+ * duration: { seconds: N } — plan validity period
+ * prices: [{ denom, base_value, quote_value }] — subscription cost
+ * isPrivate: boolean
+ *
+ * NOTE: Plans start INACTIVE by default — must send MsgUpdatePlanStatusRequest separately!
+ */
+export function encodeMsgCreatePlan({ from, bytes, duration, prices, isPrivate }) {
+  const parts = [protoString(1, from)];
+  if (bytes) parts.push(protoString(2, String(bytes)));
+  if (duration) parts.push(protoEmbedded(3, encodeDuration(
+    typeof duration === 'number' ? { seconds: duration } : duration
+  )));
+  for (const p of (prices || [])) {
+    parts.push(protoEmbedded(4, encodePrice(p)));
+  }
+  if (isPrivate) parts.push(protoBool(5, true));
+  return Uint8Array.from(Buffer.concat(parts));
+}
+
+/**
+ * MsgUpdatePlanStatusRequest (sentinel.plan.v3)
+ * Activate/deactivate a plan. Status: 1=active, 2=inactive_pending, 3=inactive
+ * from: sentprov prefix (provider address)
+ */
+export function encodeMsgUpdatePlanStatus({ from, id, status }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoUint64(2, id),
+    protoInt64(3, status),
+  ]));
+}
+
+/**
+ * MsgLinkNodeRequest (sentinel.plan.v3)
+ * Link a leased node to a plan. Requires active lease for the node.
+ * from: sentprov prefix (provider address)
+ */
+export function encodeMsgLinkNode({ from, id, nodeAddress }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoUint64(2, id),
+    protoString(3, nodeAddress),
+  ]));
+}
+
+/**
+ * MsgUnlinkNodeRequest (sentinel.plan.v3)
+ * Remove a node from a plan.
+ * from: sentprov prefix (provider address)
+ */
+export function encodeMsgUnlinkNode({ from, id, nodeAddress }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoUint64(2, id),
+    protoString(3, nodeAddress),
+  ]));
+}
+
+/**
+ * MsgStartSessionRequest (sentinel.plan.v3) — COMBINED subscribe + session
+ * Subscribes to a plan AND starts a session in one TX.
+ * from: sent prefix (account address)
+ */
+export function encodeMsgPlanStartSession({ from, id, denom = 'udvpn', renewalPricePolicy = 0, nodeAddress }) {
+  const parts = [
+    protoString(1, from),
+    protoUint64(2, id),
+    protoString(3, denom),
+  ];
+  if (renewalPricePolicy) parts.push(protoInt64(4, renewalPricePolicy));
+  if (nodeAddress) parts.push(protoString(5, nodeAddress));
+  return Uint8Array.from(Buffer.concat(parts));
+}
+
+// ─── Lease Messages ──────────────────────────────────────────────────────────
+
+/**
+ * MsgStartLeaseRequest (sentinel.lease.v1)
+ * Lease a node from its operator. Provider pays node's hourly price.
+ * from: sentprov prefix (provider address)
+ *
+ * CRITICAL: maxPrice must EXACTLY match the node's hourly_prices from LCD.
+ * Any mismatch → "invalid price" error.
+ */
+export function encodeMsgStartLease({ from, nodeAddress, hours, maxPrice, renewalPricePolicy = 0 }) {
+  const parts = [
+    protoString(1, from),
+    protoString(2, nodeAddress),
+    protoInt64(3, hours),
+  ];
+  if (maxPrice) parts.push(protoEmbedded(4, encodePrice(maxPrice)));
+  if (renewalPricePolicy) parts.push(protoInt64(5, renewalPricePolicy));
+  return Uint8Array.from(Buffer.concat(parts));
+}
+
+/**
+ * MsgEndLeaseRequest (sentinel.lease.v1)
+ * End an active lease.
+ * from: sentprov prefix (provider address)
+ */
+export function encodeMsgEndLease({ from, id }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoUint64(2, id),
+  ]));
+}
+
+// ─── Exported Helpers ────────────────────────────────────────────────────────
+
+export { encodePrice, encodeDuration, decToScaledInt };
+export { encodeVarint, protoString, protoInt64, protoUint64, protoBool, protoEmbedded };