Skip to main content

Query

Query commands for fetching data from the Sentinel dVPN network. All query commands support the shared flags documented in the command list.

Pagination

Commands that return lists (nodes, plans, sessions, subscriptions, deposits, providers) support pagination flags:

--page.limit uint maximum number of results to return (default 10)
--page.offset uint number of results to skip
--page.count-total include total count in the response
--page.reverse return results in descending order

Query All Nodes

Retrieve information about all registered nodes on the network.

sentinel-dvpncli query nodes \
--rpc.addrs https://rpc.sentinel.co:443 \
--page.limit 25

Filter flags:

FlagDescription
--status stringFilter by status (active, inactive)
--plan-id uintFilter nodes by plan identifier

Query a Node

Retrieve information about a specific node by address.

sentinel-dvpncli query node <sentnode_address> \
--rpc.addrs https://rpc.sentinel.co:443

Query All Plans

Retrieve information about all subscription plans.

sentinel-dvpncli query plans \
--rpc.addrs https://rpc.sentinel.co:443 \
--page.limit 25

Filter flags:

FlagDescription
--status stringFilter by status (active, inactive)
--provider-addr stringFilter plans by provider address

Query a Plan

Retrieve information about a specific plan by ID.

sentinel-dvpncli query plan <plan_id> \
--rpc.addrs https://rpc.sentinel.co:443

Query All Subscriptions

Retrieve information about all subscriptions.

sentinel-dvpncli query subscriptions \
--rpc.addrs https://rpc.sentinel.co:443 \
--page.limit 25

Filter flags:

FlagDescription
--account-addr stringFilter by account address
--plan-id uintFilter by plan identifier

Query a Subscription

Retrieve information about a specific subscription by ID.

sentinel-dvpncli query subscription <subscription_id> \
--rpc.addrs https://rpc.sentinel.co:443

Query All Sessions

Retrieve information about all sessions.

sentinel-dvpncli query sessions \
--rpc.addrs https://rpc.sentinel.co:443 \
--page.limit 25

Filter flags:

FlagDescription
--account-addr stringFilter by account address
--node-addr stringFilter by node address
--subscription-id uintFilter by subscription identifier

Query a Session

Retrieve information about a specific session by ID.

sentinel-dvpncli query session <session_id> \
--rpc.addrs https://rpc.sentinel.co:443

Query All Deposits

Retrieve information about all deposits.

sentinel-dvpncli query deposits \
--rpc.addrs https://rpc.sentinel.co:443 \
--page.limit 25

Query a Deposit

Retrieve information about a specific deposit by address.

sentinel-dvpncli query deposit <address> \
--rpc.addrs https://rpc.sentinel.co:443

Query All Providers

Retrieve information about all registered providers.

sentinel-dvpncli query providers \
--rpc.addrs https://rpc.sentinel.co:443 \
--page.limit 25

Filter flags:

FlagDescription
--status stringFilter by status (active, inactive)

Query a Provider

Retrieve information about a specific provider by address.

sentinel-dvpncli query provider <provider_address> \
--rpc.addrs https://rpc.sentinel.co:443

Query Parameters

Retrieve all network parameters for the VPN module.

sentinel-dvpncli query params \
--rpc.addrs https://rpc.sentinel.co:443