# Quickstart

**Checklist**:

* [x] Anchor contracts deployed ✅
* [x] PromptVault accessible via CLI 🔑
* [x] UI SDK wired to front-end 🎨

This section helps developers quickly set up the essential components of the PromptHub protocol. It includes building the smart contract layer, initializing SDKs, and launching a local web interface for testing and development.

**Prerequisites**

Before you begin, ensure your development environment meets these requirements:

```bash
# Required system dependencies
$ node -v  # Required: v16.0.0 or higher
$ npm -v   # Required: v8.0.0 or higher
$ solana --version  # Required: v1.14.0 or higher
$ anchor --version  # Required: v0.26.0 or higher

# Set up Solana development environment if needed
$ sh -c "$(curl -sSfL https://release.solana.com/v1.14.2/install)"
$ solana-keygen new  # Generate a new keypair if you don't have one
```

**1. Core Protocol Setup**

```bash
# Clone and initialize the core protocol repository
$ git clone https://github.com/PromptHubLabs/prompthub-protocol.git
$ cd prompthub-protocol
$ npm install

# Configure your development environment
$ cp .env.example .env
$ nano .env  # Edit with your Solana keypair path and RPC provider

# Build Solana smart contracts
$ anchor build
$ anchor keys sync  # Sync program IDs with declaration file

# Start local validator (optional for testnet)
$ solana-test-validator

# Deploy contracts to localnet/devnet
$ anchor deploy --provider.cluster devnet  # For devnet deployment
# OR
$ anchor deploy  # For local development (default)

# Verify deployment
$ solana program show --output json <PROGRAM_ID>
```

**2. SDK Integration**

```bash
# Clone the SDK repository
$ git clone https://github.com/PromptHubLabs/prompthub-sdk.git
$ cd prompthub-sdk
$ npm install

# Configure SDK to point to your deployment
$ cp config.example.json config.json
$ nano config.json  # Update with your deployed program IDs

# Run sample agent interactions
$ node examples/registerPrompt.js
$ node examples/callPrompt.js

# Example output:
# > Prompt registered with ID: my_summarizer_v1
# > Transaction signature: 5K3QC9Vj2aUh2Aig6...
```

The SDK exposes the following core interfaces:

```typescript
// Main client class
const client = new PromptHubClient({
  cluster: "devnet",                          // or "mainnet-beta", "localnet" 
  wallet: new NodeWallet(yourKeypair),        // or web-based wallet adapter
  promptVaultProgramId: "abc123...",          // Your deployed program ID
});

// Register a new prompt
const promptId = await client.registerPrompt({
  name: "Text Summarizer",
  description: "Summarizes long text into concise points",
  inputs: {
    "text": { type: "string", required: true },
    "length": { type: "number", default: 3 }
  },
  template: "Summarize this text in {{length}} bullet points: {{text}}",
  // ... other fields
});

// Execute a prompt
const result = await client.executePrompt("text_summarizer_v1", {
  text: "This is a long document that needs summarization...",
  length: 5
});

console.log(result.output);  // The summarized text
console.log(result.signature);  // PromptSig verification hash
```

**3. Frontend Application**

```bash
# Clone and run the frontend application
$ git clone https://github.com/PromptHubLabs/prompthub-app.git
$ cd prompthub-app
$ npm install

# Configure app environment
$ cp .env.local.example .env.local
$ nano .env.local  # Add your RPC URL and program IDs

# Start local development server
$ npm run dev  # Starts at http://localhost:3000

# For production build
$ npm run build
$ npm start
```

The frontend application provides:

* A visual PromptDSL editor with schema validation
* PromptVault explorer for browsing public prompts
* DAG Builder interface for creating multi-step workflows
* Wallet integration for on-chain transactions

**4. Common Issues and Troubleshooting**

**Problem**: Anchor build fails with Rust errors**Solution**: Ensure you have Rust toolchain installed: `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`

**Problem**: Transaction errors during prompt registration**Solution**: Check SOL balance: `solana balance`. Airdrop if needed: `solana airdrop 2`

**Problem**: SDK connection issues**Solution**: Verify RPC endpoint is correct and responsive: `curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}' https://your-rpc-endpoint`

Once initialized, developers can:

* Register new prompts via the frontend
* Browse the PromptVault and Asset Store
* Visualize prompt DAGs
* Simulate prompt invocation with model-compatible agents

These tools together form a full-stack developer environment for building on PromptHub.