TN Node is the database layer powering TRUF.NETWORK, built on top of the Kwil framework.
This documentation is intended for node operators, developers and contributors. It includes guides for setup, upgrades, development, and SDK usage.
Deploy a TRUF.NETWORK node in minutes using our pre-configured Amazon Machine Image:
🚀 AMI Deployment Guide - Recommended for beginners
Choose your preferred deployment method:
| Method | Time | Skill Level | Best For |
|---|---|---|---|
| AMI Deployment | 5-10 min | Beginner | Quick start, AWS users |
| Manual Setup | 45-60 min | Advanced | Full control, custom infrastructure |
📊 Compare All Deployment Options
After deploying your node, you'll need to expose it to external clients. We provide cloud-specific guides:
- AWS Endpoint Deployment - Configure Security Groups, Route53, and networking on AWS
- Digital Ocean Endpoint Deployment - Configure Cloud Firewalls, networking, and DNS on Digital Ocean
For definitions of key terms used throughout this project, refer to the Terminology Reference.
Steps and best practices for upgrading TN nodes:
We provide official SDKs to integrate and interact with the TN network:
-
Go SDK
📦 trufnetwork/sdk-go
A comprehensive Go client for deploying and managing TN data streams. -
TypeScript SDK
📦 trufnetwork/sdk-js
A TypeScript library for both Node.js and browser environments.
- Stream deployment and initialization
- Data insertion, querying, and retrieval
- Composed stream creation and updates
- Configurable node connections
Learn how to query data through AI Clients: TRUF.NETWORK MCP
For production deployments behind reverse proxies: MCP Reverse Proxy Configuration
For contributors and developers building on top of TN:
Need to request, sign, or verify TrufNetwork attestations? Start with the quick guide:
This project is licensed under the Apache License 2.0. See the LICENSE file for details.