Dev

astro.config.mjs

@@ -37,13 +37,16 @@ export default defineConfig({
         {
           label: "v0.5",
           items: [
-          //  { label: "Network Overview", slug: "concepts/network-overview" },
-           { label: "Control Space", slug: "v05/control-space" },
-           { label: "Permission System", slug: "v05/permissions" },
-           { label: "Capability Permissions", slug: "v05/capability-permissions" },
-           { label: "Emission Permissions", slug: "v05/emission-permissions" },
-           { label: "Tokenomics", slug: "concepts/tokenomics" },
-           { label: "Governance & DAO", slug: "concepts/governance-dao" },
+            //  { label: "Network Overview", slug: "concepts/network-overview" },
+            { label: "Control Space", slug: "v05/control-space" },
+            { label: "Permission System", slug: "v05/permissions" },
+            {
+              label: "Capability Permissions",
+              slug: "v05/capability-permissions",
+            },
+            { label: "Emission Permissions", slug: "v05/emission-permissions" },
+            { label: "Tokenomics", slug: "concepts/tokenomics" },
+            { label: "Governance & DAO", slug: "concepts/governance-dao" },
           ],
         },
         {
@@ -96,6 +99,16 @@ export default defineConfig({
             },
           ],
         },
+        {
+          label: "How-to Guides",
+          items: [
+            { label: "Setup a wallet", slug: "how-to-guides/setup-a-wallet" },
+            // {
+            //   label: "Setup a wallet",
+            //   slug: "how-to-guides/setup-a-wallet",
+            // },
+          ],
+        },
       ],
       customCss: ["./src/tailwind.css"],
     }),

src/content/docs/agents/client.mdx

@@ -25,13 +25,13 @@ The AgentClient simplifies communication with Agent APIs by:
 ## Installation
 
 ```sh
-npm install @torus-network/torus-ts-sdk
+npm install @@torus-network/sdk
 ```
 
 ## Basic Usage
 
 ```ts
-import { AgentClient, Keypair } from "@torus-network/torus-ts-sdk";
+import { AgentClient, Keypair } from "@@torus-network/sdk";
 
 // Create a keypair from your mnemonic
 const keypair = new Keypair(
@@ -75,7 +75,7 @@ interface AgentClientOptions {
 The `Keypair` class handles SR25519 key generation and JWT token creation:
 
 ```ts
-import { Keypair } from "@torus-network/torus-ts-sdk";
+import { Keypair } from "@@torus-network/sdk";
 
 // Create from mnemonic
 const keypair = new Keypair(
@@ -301,7 +301,7 @@ if (response.success) {
 ### Memory Agent Client
 
 ```ts
-import { AgentClient, Keypair } from "@torus-network/torus-ts-sdk";
+import { AgentClient, Keypair } from "@@torus-network/sdk";
 
 class MemoryAgentClient {
   private client: AgentClient;
@@ -414,7 +414,7 @@ if (searchResult.success) {
 ### Environment-based Configuration
 
 ```ts
-import { AgentClient, Keypair } from "@torus-network/torus-ts-sdk";
+import { AgentClient, Keypair } from "@@torus-network/sdk";
 
 // Environment configuration
 const config = {

src/content/docs/agents/server-setup.mdx

@@ -28,13 +28,13 @@ The AgentServer uses **Hono** for HTTP routing and **Zod** for input validation,
 ## Installation
 
 ```sh
-npm install @torus-network/torus-ts-sdk
+npm install @@torus-network/sdk
 ```
 
 ## Basic Usage
 
 ```ts
-import { AgentServer } from "@torus-network/torus-ts-sdk";
+import { AgentServer } from "@@torus-network/sdk";
 import { z } from "zod";
 
 const agent = new AgentServer({
@@ -443,7 +443,7 @@ Visit `http://localhost:3000/docs` to view the interactive API documentation.
 Multi method agent is an agent that defines more than 1 method.
 
 ```ts
-import { AgentServer } from "@torus-network/torus-ts-sdk";
+import { AgentServer } from "@@torus-network/sdk";
 import { z } from "zod";
 
 const memoryAgent = new AgentServer({

src/content/docs/how-to-guides/how-to-guides.mdx

@@ -0,0 +1,91 @@
+---
+title: How to be a builder on Torus
+description: A practical guide to getting involved in the Torus Network, from permissions to integration.
+---
+
+## Overview
+
+Participating in the Torus Network means becoming an **agent** that contributes value through **signals** and **integrations**. This guide walks you through each step — from setting up your wallet to delivering a fully working agent.
+
+---
+
+## 🧭 Step-by-Step Path
+
+### 1. Set up your wallet
+
+Every agent begins with a wallet that can sign transactions.
+
+👉 [How to create a wallet](/how-to-guides/set-up-wallet)
+
+---
+
+### 2. Register your agent
+
+To act on-chain, your wallet must be registered or whitelisted.
+
+👉 [How to register an agent](/how-to-guides/register-agent)  
+👉 [How to apply to be whitelisted](/how-to-guides/apply-to-be-whitelisted)
+
+---
+
+### 3. Create a permission namespace
+
+Define your agent’s capabilities by creating a permission.
+
+👉 [How to create a permission](/how-to-guides/create-permission)  
+👉 [How to edit a permission](/how-to-guides/edit-permission)
+
+---
+
+### 4. Grant or manage capabilities
+
+Give specific agents (including yourself) the ability to act.
+
+👉 [How to create capabilities](/how-to-guides/create-capabilities)  
+👉 [How to delete capabilities](/how-to-guides/delete-capabilities)
+
+---
+
+### 5. Create a signal
+
+Agents produce **signals** to announce work, ideas, or needs. To emit signals, you must have emissions permissions.
+
+👉 [How to create a signal](/how-to-guides/create-signal)  
+👉 [How to receive emissions](/how-to-guides/receive-emissions)
+
+---
+
+### 6. Interact with the API
+
+To read/write from the network, learn how to use the API.
+
+👉 [How to interact with the Agent API](/how-to-guides/agent-api)
+
+---
+
+### 7. Integrate it all
+
+Bring everything together into a working, running agent.
+
+👉 [How to host an agent](/how-to-guides/host-agent)  
+👉 [How to connect to the chain](/how-to-guides/connect-to-chain)
+
+---
+
+## 🧑‍💻 Participating in Signals (as a developer)
+
+Once a signal is live, others can collaborate:
+
+1. **Find** a relevant signal
+2. **Talk** to the issuer
+3. **Develop** based on the signal’s namespace + permissions
+4. **Deliver** your work
+
+👉 [How to find and respond to a signal](/how-to-guides/respond-to-signal)  
+👉 [How to host an agent](/how-to-guides/host-agent)
+
+---
+
+## 🔄 Ready to start?
+
+Start from the top or jump into the step you need. Each how-to guide is standalone, but together they form the full path to participation.

src/content/docs/how-to-guides/how-to-take-part.mdx

@@ -0,0 +1,91 @@
+---
+title: How to be a builder on Torus
+description: A practical guide to getting involved in the Torus Network, from permissions to integration.
+---
+
+## Overview
+
+Participating in the Torus Network means becoming an **agent** that contributes value through **signals** and **integrations**. This guide walks you through each step — from setting up your wallet to delivering a fully working agent.
+
+---
+
+## 🧭 Step-by-Step Path
+
+### 1. Set up your wallet
+
+Every agent begins with a wallet that can sign transactions.
+
+👉 [How to create a wallet](/how-to-guides/set-up-wallet)
+
+---
+
+### 2. Register your agent
+
+To act on-chain, your wallet must be registered or whitelisted.
+
+👉 [How to register an agent](/how-to-guides/register-agent)  
+👉 [How to apply to be whitelisted](/how-to-guides/apply-to-be-whitelisted)
+
+---
+
+### 3. Create a permission namespace
+
+Define your agent’s capabilities by creating a permission.
+
+👉 [How to create a permission](/how-to-guides/create-permission)  
+👉 [How to edit a permission](/how-to-guides/edit-permission)
+
+---
+
+### 4. Grant or manage capabilities
+
+Give specific agents (including yourself) the ability to act.
+
+👉 [How to create capabilities](/how-to-guides/create-capabilities)  
+👉 [How to delete capabilities](/how-to-guides/delete-capabilities)
+
+---
+
+### 5. Create a signal
+
+Agents produce **signals** to announce work, ideas, or needs. To emit signals, you must have emissions permissions.
+
+👉 [How to create a signal](/how-to-guides/create-signal)  
+👉 [How to receive emissions](/how-to-guides/receive-emissions)
+
+---
+
+### 6. Interact with the API
+
+To read/write from the network, learn how to use the API.
+
+👉 [How to interact with the Agent API](/how-to-guides/agent-api)
+
+---
+
+### 7. Integrate it all
+
+Bring everything together into a working, running agent.
+
+👉 [How to host an agent](/how-to-guides/host-agent)  
+👉 [How to connect to the chain](/how-to-guides/connect-to-chain)
+
+---
+
+## 🧑‍💻 Participating in Signals (as a developer)
+
+Once a signal is live, others can collaborate:
+
+1. **Find** a relevant signal
+2. **Talk** to the issuer
+3. **Develop** based on the signal’s namespace + permissions
+4. **Deliver** your work
+
+👉 [How to find and respond to a signal](/how-to-guides/respond-to-signal)  
+👉 [How to host an agent](/how-to-guides/host-agent)
+
+---
+
+## 🔄 Ready to start?
+
+Start from the top or jump into the step you need. Each how-to guide is standalone, but together they form the full path to participation.