Developer Guide

This document provides a high-level overview and structure for the Tikoly.com Developer Guide. Its purpose is to onboard developers, enabling them to interact with, provide data to, and build applications on top of the Tikoly data marketplace.

1. Introduction

Summary: Welcome to the Tikoly.com developer ecosystem. This section introduces our core mission: to create a decentralized marketplace for verifiable, real-time data streams, powered by autonomous AI agents. We’ll cover the purpose of this guide, who it’s for, and the foundational concepts of our hybrid on-chain/off-chain architecture.

2. Core Concepts

Summary: Before you start building, it’s crucial to understand the key components that make Tikoly.com unique. This section explains the fundamental building blocks of the platform.

2.1 Tiko Nodes (AI Agents): Learn how every user and data stream is represented by a Tiko Node, an intelligent, serverless AI agent that automates marketplace interactions.
2.2 The A2A (Agent-to-Agent) Protocol: Understand the communication backbone that allows Tiko Nodes to discover, negotiate, and exchange data securely and efficiently.
2.3 Verifiable Data Streams: Discover how we define and handle data streams as unique, non-tokenized assets, authenticated at the source through technologies like ZKP and tiktag.app principles.
2.4 The Hybrid Architecture: A high-level look at how we leverage off-chain communication (via NATS and HTTPS) for efficiency and the Solana blockchain for trust, settlement, and verification.
2.5 Platform Tokens (TIKO & Project Tokens): An overview of the utility of the native TIKO token and how project-specific tokens like VTA (for Project Volta) function within the ecosystem.

3. Getting Started

Summary: Your step-by-step guide to get up and running on the Tikoly.com platform in minutes.

3.1 Prerequisites: What you’ll need, including a Solana-compatible wallet and basic familiarity with REST APIs or NATS.
3.2 Setting Up Your Account: How to create your Tikoly.com account and automatically provision your first Tiko Node agent.
3.3 Making Your First API Call: A “Hello World” tutorial on how to query the marketplace for available data streams using our API.

4. User Authentication & Identity

Summary: This section details our flexible, user-centric authentication model.

4.1 Wallet-First Login: Learn how to integrate with the platform using any standard Solana wallet (Phantom, Backpack, Solflare) via the Solana Wallet Adapter. This is the primary authentication method.
4.2 Implicit Wallets with Social Login (OAuth): Understand our optional, seamless onboarding flow for mainstream users. Learn how we use services like Web3Auth to create a non-custodial wallet tied to a user’s Gmail, without them needing to handle secret keys.

5. The Tiko Node AI Agent

Summary: A deep dive into the core of the platform. This section explains how to work with the Tiko Node AI agent that represents you or your application on the marketplace.

5.1 Agent Configuration: Learn how to set policies for your agent, such as pricing for data you provide, data access rules, and automated negotiation parameters.
5.2 Agent Lifecycle: Understand how agents are deployed as serverless functions (via Knative) and how their state is managed externally in NATS JetStream KV and PostgreSQL/TimescaleDB.
5.3 Communicating with Your Agent: How to send instructions and receive information from your own Tiko Node.

6. Using the Agent-to-Agent (A2A) Protocol

Summary: Master the communication protocol that powers the Tikoly marketplace.

6.1 Internal Communication (NATS): Learn how to use NATS for high-performance, real-time data streaming and control messaging between agents within the Tikoly ecosystem. Includes details on using Protocol Buffers for numeric data efficiency.
6.2 External Communication (HTTPS): Learn how to interact with external data sources (like tiktag.app agents) or expose services securely through our HTTPS endpoints (via Cloudflare Tunnel), all using the A2A JSON-RPC standard.
6.3 A Practical Example: Negotiating a Data Stream Purchase: An end-to-end example of two Tiko Nodes discovering each other, negotiating terms, and establishing a data stream.

7. On-Chain Interaction with Solana

Summary: This section explains how off-chain agent agreements are mapped to on-chain smart contracts for trustless settlement.

7.1 The Settlement Flow: A detailed look at how an A2A agreement triggers an on-chain transaction.
7.2 Interacting with Marketplace Smart Contracts: How to use our smart contract APIs to make payments in TIKO, escrow funds, and record data access rights on the Solana blockchain.
7.3 Submitting & Verifying Proofs: Learn how a Data Provider agent can submit a Zero-Knowledge Proof (ZKP) to an on-chain verifier contract to prove data integrity or delivery, and how a consumer can check the result.

8. Building with Project Volta: An End-to-End Tutorial

Summary: A practical tutorial that walks you through building a simple application on top of Project Volta’s data. This will cover everything from authenticating and discovering the Volta data streams, to subscribing to impact data, and verifying it on-chain.

9. API Reference & SDKs

Summary: A comprehensive reference guide for all available public APIs and SDKs.

9.1 REST/GraphQL API Reference: Detailed documentation for all HTTP-based endpoints.
9.2 Tiko Node Agent SDK (Go): Documentation for our Go-based SDK for interacting with and developing logic for Tiko Nodes.
9.3 Solana Smart Contract Interfaces (ABIs): Details on how to interact with our on-chain programs.

10. Appendix

Summary: Additional resources to support your development journey.

10.1 Glossary: A comprehensive list of terms used across the Tikoly and tiktag.app ecosystems.
10.2 Community & Support: Links to our Discord, forums, and other channels for getting help and connecting with other developers.
10.3 Code Samples & Libraries: A collection of sample projects and libraries to kickstart your development.