Developers

Install the SDK

3 min readView as markdown ↗

Choose your language's native package manager. Go, JavaScript and C/C++ use the base Go, JS/WASM and CGo SDKs directly. The other language packages wrap those same implementations.

One SDK core, many packages: the Go module, JS/WASM runtime, CGo runtime and mobile frameworks it is delivered through, and the language packages that use or wrap them

Release availability: two packages install today from their public registries: the Go module (through Go's module proxy) and @urnetwork/sdk for JavaScript and TypeScript (npm). The other language packages are awaiting publication; their commands below are the installation contract for that release, and each language guide also explains local package builds. Socket examples need a release containing the new socket API.

LanguageNative installationAvailable todayGuide
Cvcpkg add port urnetwork-sdkNot yet publishedC guide
C++vcpkg add port urnetwork-sdkNot yet publishedC++ guide
C#dotnet add package URnetwork.SDKNot yet publishedC# guide
Gogo get github.com/urnetwork/sdk/v2026@latestYesGo guide
Javaimplementation("io.ur:urnetwork-sdk:<version>")Not yet publishedJava guide
JavaScriptnpm install @urnetwork/sdkYesJavaScript guide
Kotlinimplementation("io.ur:urnetwork-sdk:<version>")Not yet publishedKotlin guide
Pythonpip install urnetwork-sdkNot yet publishedPython guide
Rubygem install urnetwork-sdkNot yet publishedRuby guide
Rustcargo add urnetwork-sdkNot yet publishedRust guide
Swift.package(url: "https://github.com/urnetwork/sdk-swift", exact: "<version>")Not yet publishedSwift guide
TypeScriptnpm install @urnetwork/sdkYesTypeScript guide

These unqualified commands select default/stable releases. For previews, use npm install @urnetwork/sdk@nightly, pip install --pre urnetwork-sdk, dotnet add package URnetwork.SDK --prerelease, or gem install urnetwork-sdk --pre. Cargo, Maven and SwiftPM can pin the exact preview version. Preview package names are the same as stable package names.

Java and Kotlin on Android

Use io.ur:urnetwork-sdk-android:<version> instead of the desktop JVM coordinate. The Android AAR is built with gomobile; desktop Java/Kotlin use JNA over the CGo runtime. Swift uses the existing Apple XCFramework.

Package contents

Python wheels, Ruby gems, NuGet packages and desktop JVM packages include their supported native libraries. The Rust crate downloads a version-pinned, checksum-verified native asset at build time and embeds it in the executable. Consumers need no Go compiler or manual DLL download. Support is limited to the platforms included in that release; Linux packages state their libc floor.

The npm package contains its paired Go/WASM runtime and TypeScript declarations, with runnable Node and browser examples. Both use a configured hosted Device. The browser's native fetch API has no custom socket factory; see the language's HTTP integration guide for its Axios request adapter and Direct Sockets example.

Examples and socket behavior

Open the Examples browser for each language's installation README, socket/README.md run guide, and executable source files. Read Socket for the difference between a kernel socket and a Device socket, including possible duplicate delivery when UDP races the first datagram across IPv4 and IPv6.

For source installation, version pinning and alternative package managers, use the language guides above. C/C++ recipes are published to a configured first-party Conan remote or vcpkg Git registry; add that remote/registry once before the commands above. Inclusion in the upstream public collections requires their maintainers' acceptance. The language guides include this setup and local CMake archive installation.