How-to Guides
Each guide covers one task. Find what you need, follow the steps, move on.
Using the SDK
The TypeScript SDK (@spacecomputer-io/orbitport-sdk-ts) is the fastest path to working with Orbitport. These guides go from zero to production-ready:
- SDK Quickstart — Install, initialize, get a random number. Five minutes.
- Authentication — Set up API credentials, understand how the SDK manages tokens, and configure environment variables.
- IPFS Beacon — Work with the public IPFS beacon directly through the SDK: force IPFS as a source, pick specific values from the array, walk the block history, or point at a custom beacon.
- Error Handling — What to do when things go wrong. Error types, error codes, retry configuration, and the automatic IPFS fallback.
- Advanced Configuration — Everything you can tune: timeouts, retry behavior, custom IPFS gateways, debug logging.
Without the SDK
- Fetch cTRNG Without the SDK — Curl the API, hit the IPFS beacon directly, or use plain
fetch. No npm install required.
Related
Want to understand what's happening under the hood? The Concepts pages cover satellite communication, cosmic randomness, and the Orbitport architecture. For complete project examples (Web3 randomness, password generation, SIWE nonces), see the Recipes.