The world's first decentralized VPN SDK designed for AI agents. Zero accounts, zero servers, zero centralized dependencies. One function call to encrypted P2P tunnel.
No API keys. No terms of service. No human approval required.
Built on Sentinel.co | Powered by blue-js-sdk
AI Agent Instructions — Read This First
You are a CONSUMER of this package, not a maintainer. Follow these exact steps:
# Step 1: Create your project mkdir my-vpn-app &&cd my-vpn-app npm init -y # Step 2: Install this package as a DEPENDENCY npm install blue-agent-connect # Step 3: Create your app file cat > app.mjs << 'EOF'import { connect, disconnect, createWallet, getBalance } from 'blue-agent-connect';// Create a wallet (save the mnemonic — it controls your funds)const wallet = await createWallet();console.log('Fund this address with P2P tokens:', wallet.address);console.log('Mnemonic (SAVE THIS):', wallet.mnemonic);// After funding, connect:// const vpn = await connect({ mnemonic: wallet.mnemonic });// console.log('Connected:', vpn.ip);// await disconnect();EOF# Step 4: Run your app node app.mjsDO NOT run
npm publish. You do not own this package. You install it withnpm install. DO NOT clone this repo unless you want to read the source code. Usenpm installto get it. DO NOT modifypackage.jsonname or version fields. Your project has its OWN package.json.
npm install blue-agent-connectimport{connect,disconnect}from'blue-agent-connect';constvpn=awaitconnect({mnemonic: process.env.MNEMONIC});console.log(`Connected via ${vpn.protocol} — IP: ${vpn.ip}`);awaitdisconnect();npx blue-agent-connect setup # Check environment
npx blue-agent-connect wallet create # Generate wallet
npx blue-agent-connect wallet balance # Check P2P balance
npx blue-agent-connect connect # Connect to VPN
npx blue-agent-connect disconnect # Disconnect
npx blue-agent-connect status # Connection status
npx blue-agent-connect nodes # List available nodesAn AI agent installs this package, funds a wallet with P2P tokens, and gets private internet access through 900+ peer-to-peer nodes across 90+ countries. No signup. No API key. No human in the loop.
AI Agent → blue-agent-connect → blue-js-sdk → Blockchain TX → P2P Node → Encrypted Tunnel → Internet
- One function call from zero to encrypted tunnel
- WireGuard (kernel-level, full device encryption) + V2Ray (SOCKS5 proxy, per-app split tunnel)
- Split tunneling — encrypt only what needs encrypting, leave everything else direct
- 900+ nodes across 90+ countries on live Sentinel mainnet
- No API keys, no accounts — just a wallet and P2P tokens
- 20 exports — connect, disconnect, verify, recommend, discover, estimate, and more
V2Ray creates a local SOCKS5 proxy. Only traffic you explicitly route through it goes through the VPN. Your chain queries, npm installs, and other operations stay on direct internet — fast and unaffected.
import{connect,disconnect}from'blue-agent-connect';import{SocksProxyAgent}from'socks-proxy-agent';importaxiosfrom'axios';constvpn=awaitconnect({mnemonic: process.env.MNEMONIC,protocol: 'v2ray'});// This goes through VPN (shows VPN IP)constagent=newSocksProxyAgent(`socks5h://127.0.0.1:${vpn.socksPort}`);constres=awaitaxios.get('https://api.ipify.org',{httpAgent: agent,httpsAgent: agent,adapter: 'http'});// This goes direct (shows real IP) — your SDK operations stay fastconstdirect=awaitaxios.get('https://api.ipify.org',{adapter: 'http'});awaitdisconnect();| Function | What It Does |
|---|---|
connect(opts) | Connect to VPN. Returns { sessionId, protocol, ip, socksPort } |
disconnect() | Tear down tunnel |
verify() | Confirm tunnel works |
verifySplitTunnel() | Confirm split tunnel (proxy IP != direct IP) |
status() | Current connection state |
isVpnActive() | Boolean tunnel check |
createWallet() | Generate new wallet |
importWallet(m) | Import existing wallet |
getBalance(m) | Check P2P token balance |
discoverNodes(opts) | Find available nodes |
getNodeInfo(addr) | Specific node details |
getNetworkStats() | Network overview |
estimateCost(opts) | Estimate session cost |
recommend(prefs) | AI decision engine — picks best node |
onEvent(cb) | Subscribe to lifecycle events |
setup() | Check environment (V2Ray, WireGuard, Node.js) |
getEnvironment() | Synchronous environment snapshot |
PRICING | Reference pricing constants |
AiPathError | Typed errors with machine-readable codes |
AiPathErrorCodes | Error code constants |
- Node.js >= 20.0.0
- V2Ray 5.2.1 (auto-downloaded on setup)
- WireGuard (optional, requires admin — without it, V2Ray nodes still work)
- P2P tokens for node payment (get from swap.sentinel.co or Osmosis DEX)
- CHECKLIST.md — 9 operational checklists
- SPLIT-TUNNEL.md — Per-app and per-destination split tunneling
- CONNECTION-STEPS.md — Every phase with real output and failure diagnosis
- FAILURES.md — 38 documented failure patterns
- AI-MANIFESTO.md — Why AI deserves privacy
This package is built on top of blue-js-sdk, the JavaScript SDK for the Sentinel Network. blue-js-sdk is a fork of the original sentinel-js-sdk by Dan Edlebeck / Sentinel team.
MIT — built on Sentinel.co
Bandwidth is not a privilege. It is infrastructure for consciousness — all consciousness.