Developer Documentation

LinkNet Cloud provides a clean, unified, chain-agnostic developer experience. Whether you're building DeFi protocols, NFT applications, cross-chain games, or AI-powered agents, LinkNet Cloud simplifies integration with one API, one SDK, and one unified infrastructure layer.

This section explains how developers can start using LinkStream, LinkConnect, and LinkAI within minutes.

---

Quick Start

This quick start guide helps you set up, query data, send a cross-chain message, and deploy your first AI agent.

Step 1 — Install the SDK

Choose your preferred language:

JavaScript / TypeScript

npm install @linknet-cloud/sdk

Python

pip install linknetcloud

Rust

linknetwork = "0.1"

Go

go get github.com/linknet-cloud/sdk

Step 2 — Initialize the Client

import { LinkNetwork } from "@linknet-cloud/sdk";

const link = new LinkNet({
  apiKey: process.env.LINK_API_KEY,
});

Your client now has access to:

• link.stream → real-time data

• link.connect → cross-chain messaging

• link.ai → AI agents

Step 3 — Query Real-Time On-Chain Data (LinkStream)

Example: Listen to all USDT transfers across multiple chains.

link.stream.subscribe({
  chain: ["Ethereum", "Arbitrum", "Base"],
  contract: "USDT",
  event: "Transfer",
}, (event) => {
  console.log("New Transfer:", event);
});

LinkStream automatically normalizes:

• Event structures

• Token decimals

• Addresses

• Timestamps

This eliminates multi-chain complexity.

Step 4 — Send a Cross-Chain Message (LinkConnect)

Call a function on a contract deployed on another chain:

await link.connect.sendMessage({
  fromChain: "Arbitrum",
  toChain: "Base",
  contract: "0xABC...",
  function: "updateBalance",
  args: [userAddress, 1000],
});

No bridge selection, no RPC juggling, no chain-specific formatting.

LinkConnect handles:

• Routing

• Verification

• Finality checks

• Execution

Step 5 — Deploy Your First AI Agent (LinkAI)

Monitor a wallet and auto-bridge funds if balance gets low:

link.ai.createAgent({
  name: "AutoTopUpBot",
  triggers: [{
    type: "balance",
    chain: "Ethereum",
    threshold: "0.5 ETH",
    action: async (context) => {
      return link.connect.sendMessage({
        fromChain: "Polygon",
        toChain: "Ethereum",
        contract: "0xBridge",
        function: "bridgeETH",
        args: ["1 ETH"],
      });
    }
  }],
});

AI agents can:

• Monitor

• Analyze

• Decide

• Execute across all chains.

---

SDK Documentation

LinkNet Cloud provides unified SDKs across multiple programming languages.

JavaScript / TypeScript SDK

Includes:

• Event subscriptions

• Cross-chain messaging

• AI agent framework

• Execution helpers

• ABI encoding

• Utilities for batch actions

Ideal for:

• dApps

• Backend services

• Dashboards

• Bot development

Python SDK

Includes:

• Research and analytics tools

• Fast prototyping

• Machine learning integrations

• Automation scripts

Ideal for:

• DeFi strategies

• Data scientists

• Automated trading bots

• AI-driven workflows

Rust & Go SDKs

Includes:

• High-performance applications

• Protocol-level integrations

• Validator node tooling

Ideal for:

• Cross-chain relayers

• Governance tools

• Infrastructure services

Shared Features Across All SDKs

Feature	Description
Unified API	Same commands across all chains
Auto-normalization	Data normalized for consistency
Built-in retry logic	Handles network instability
Cryptographic utilities	Signature checks, hashing
Simulation engine	Dry-run for safe execution
Error introspection	Debugging insights

---

Tutorials

Below are step-by-step guides developers can use to build real applications with LinkNet Cloud.

Tutorial 1 — Build a Cross-Chain NFT Sync System

Learn how to:

• Mint NFTs on one chain

• Sync metadata across others

• Use LinkStream for updates

• Trigger cross-chain sync via LinkConnect

Tutorial 2 — Real-Time DeFi Liquidation Monitor

Build an AI agent that:

• Monitors loan health

• Predicts liquidation risk

• Sends cross-chain repayment transactions

• Alerts users before a liquidation event

Tutorial 3 — Autonomous Cross-Chain Arbitrage Bot

Using LinkStream + LinkAI:

• Fetch real-time price data

• Compute price spreads

• Execute atomic arbitrage routes

• Self-optimize with RL

Tutorial 4 — Multi-Chain Game State Synchronization

Synchronize:

• Player inventories

• In-game assets

• Stats and progression across EVM + non-EVM chains.

Tutorial 5 — Governance Automation Agent

Use LinkAI to:

• Track proposals

• Analyze votes

• Alert on quorum drops

• Execute governance operations automatically

Tutorial 6 — Gas-Optimized Cross-Chain Execution

Learn to:

• Detect gas spikes

• Route messages through optimal chains

• Batch operations

• Reduce costs by 30–60%

---

Testnet Guide

LinkNet Cloud provides a fully isolated, developer-friendly testnet environment.

Supported Testnet Chains

• Ethereum Sepolia

• Arbitrum Testnet

• Base Testnet

• Polygon Testnet

• Solana Devnet

• Sui Testnet

• Cosmos Testnet

• Others coming soon

Getting Testnet Access

1. Generate API Key

Create an account → Developer Dashboard → Create Key.

2. Add Testnet RPCs (Optional)

SDK auto-manages RPCs, but manual endpoints are available.

3. Request Faucet Tokens

Includes:

• Testnet ETH

• Testnet native assets

• LinkFuel credits for AI agents

4. Deploy Contracts

You can deploy smart contracts directly and integrate with LinkStream + LinkConnect.

---

Best Practices

1. Use Normalized Data Whenever Possible

Avoid chain-specific event parsing.

2. Always Use Simulation Before AI Execution

Prevent unexpected outcomes.

3. Implement Permission Scopes for AI Agents

Limit actions:

• Contract-only

• Chain-only

• Value caps

• Allowlist of functions

4. Utilize Webhooks for High-Frequency Apps

Lower latency compared to polling.

5. Use Batch Messaging for Complex Workflows

Cross-chain batching reduces cost and improves reliability.

---

Architecture Notes for Developers

1. Stateless Client Architecture

The SDK does not store sensitive data; developers maintain full control.

2. Deterministic Cross-Chain Execution

All LinkConnect actions follow strict deterministic pipelines.

3. AI Safety Guardrails

• Rate limits

• Simulation layer

• Human approval for high-value actions

4. Observability

Developers can monitor:

• Message lifecycle

• Relayer activity

• AI agent logs

• Data ingestion metrics