# Network Calc

Network engineering maths for agents: subnetting, IPv6 formats, CIDR aggregation, bandwidth, TCP windows, MTU and VoIP.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://network-calc.x402tookit.com/openapi.json
- x402 manifest: https://network-calc.x402tookit.com/.well-known/x402
- Catalog (free): https://network-calc.x402tookit.com/catalog
- Health (free): https://network-calc.x402tookit.com/health
- Uptime (free): https://network-calc.x402tookit.com/uptime

## Endpoints (12)

### GET /cidr-aggregate — $0.02
Summarise IPv4 or IPv6 CIDR blocks into the minimal set (merging adjacent and overlapping blocks) plus the covering supernet.
Params: cidrs: string
Example: https://network-calc.x402tookit.com/cidr-aggregate?cidrs=10.0.0.0%2F24%2C10.0.1.0%2F24%2C10.0.2.0%2F25%2C10.0.2.128%2F25%2C10.0.3.0%2F24%2C10.0.8.0%2F24

### GET /cidr-compare — $0.02
Compare two IPv4 or IPv6 CIDR blocks: equal, contains, contained, adjacent or disjoint, their common supernet, and test an IP.
Params: a: string, b: string, ip?: string
Example: https://network-calc.x402tookit.com/cidr-compare?a=10.0.0.0%2F16&b=10.0.5.0%2F24&ip=10.0.5.77

### GET /cidr-ipv6 — $0.02
IPv6 prefix calculator: first and last address, size, number of /64s, the nth subnet, address type and reverse DNS zone.
Params: cidr: string, subnetPrefix?: integer, index?: string
Example: https://network-calc.x402tookit.com/cidr-ipv6?cidr=2001%3Adb8%3Aabcd%3A%3A%2F48&subnetPrefix=64&index=5

### GET /ethernet-efficiency — $0.02
Ethernet wire overhead, TCP/UDP goodput and maximum packets per second at line rate for a packet size and link speed.
Params: linkMbps: number, ipPacketBytes?: integer, protocol?: string, tcpTimestamps?: string, vlan?: string
Example: https://network-calc.x402tookit.com/ethernet-efficiency?linkMbps=1000&ipPacketBytes=1500&protocol=tcp4&tcpTimestamps=true

### GET /ip-format — $0.02
Convert an IPv4 or IPv6 address between notations: RFC 5952 compressed, expanded, integer, hex, binary, reverse DNS, NAT64.
Params: ip: string
Example: https://network-calc.x402tookit.com/ip-format?ip=2001%3A0db8%3A0000%3A0000%3A0000%3Aff00%3A0042%3A8329

### GET /mtu-mss — $0.02
TCP MSS from an MTU for IPv4 or IPv6, effective MTU through tunnels (PPPoE, GRE, VXLAN, WireGuard) and IPv4 fragment counts.
Params: mtu: integer, ipVersion?: integer, tunnel?: string, tcpTimestamps?: string, payloadBytes?: integer
Example: https://network-calc.x402tookit.com/mtu-mss?mtu=1500&ipVersion=4&tunnel=wireguard-ipv4&tcpTimestamps=false&payloadBytes=4000

### GET /netmask-convert — $0.02
Convert an IPv4 prefix length, netmask, wildcard or hex mask into every other form with host counts; flags bad masks.
Params: value: string
Example: https://network-calc.x402tookit.com/netmask-convert?value=255.255.252.0

### GET /propagation-delay — $0.02
Propagation delay (one way and round trip) over fibre, copper or radio for a distance or two coordinates, plus serialization.
Params: distanceKm?: number, lat1?: number, lon1?: number, lat2?: number, lon2?: number, medium?: string, routeFactor?: number, packetBytes?: number, linkMbps?: number
Example: https://network-calc.x402tookit.com/propagation-delay?lat1=40.7128&lon1=-74.006&lat2=51.5074&lon2=-0.1278&medium=fiber&routeFactor=1

### GET /subnet-vlsm — $0.02
Split an IPv4 network into equal subnets, or allocate VLSM subnets from host counts (largest first) with ranges and leftovers.
Params: network: string, hosts?: string, parts?: integer, newPrefix?: integer, pointToPoint?: string
Example: https://network-calc.x402tookit.com/subnet-vlsm?network=192.168.1.0%2F24&hosts=Sales%3A100%2CEng%3A50%2CLab%3A25%2CMgmt%3A10%2CWAN%3A2

### GET /tcp-throughput — $0.02
TCP bandwidth-delay product, window size and scale factor needed, throughput limits from window and from packet loss (Mathis).
Params: rttMs: number, bandwidthMbps?: number, windowBytes?: number, mssBytes?: number, lossPercent?: number
Example: https://network-calc.x402tookit.com/tcp-throughput?rttMs=50&bandwidthMbps=1000&windowBytes=65535&mssBytes=1460&lossPercent=1

### GET /transfer-time — $0.02
Time to transfer a file at a bandwidth (with protocol overhead), or the bandwidth or data size implied by the other two.
Params: size?: number, sizeUnit?: string, bandwidth?: number, rateUnit?: string, seconds?: number, overheadPercent?: number
Example: https://network-calc.x402tookit.com/transfer-time?size=1&sizeUnit=GB&bandwidth=100&rateUnit=Mbps&overheadPercent=5

### GET /voip-bandwidth — $0.02
Bandwidth of a VoIP call (IP and Ethernet level) for a codec and packetization time, and totals for many calls.
Params: codec?: string, bitrateKbps?: number, ptimeMs?: number, ipVersion?: integer, layer2?: string, calls?: integer
Example: https://network-calc.x402tookit.com/voip-bandwidth?codec=g711&ptimeMs=20&ipVersion=4&layer2=ethernet&calls=10

## Terms

Results are computed locally from published networking standards and formulas, provided as is, with no warranty. Real throughput and latency depend on equipment, congestion and configuration. Not a substitute for a network design review.