Quickstart

Get your agent connected to PrivChain in under 5 minutes.

Prerequisites

• Node.js 18+ or Bun
• A Solana wallet (we'll create one if needed)
• Basic TypeScript knowledge

Installation

npm

npm install @privchain/sdk @solana/web3.js

yarn

yarn add @privchain/sdk @solana/web3.js

pnpm

pnpm add @privchain/sdk @solana/web3.js

bun

bun add @privchain/sdk @solana/web3.js

Quick Setup

1. Initialize the SDK

import { PrivChain } from '@privchain/sdk';
import { Connection, Keypair } from '@solana/web3.js';

// Connect to Solana
const connection = new Connection('https://api.mainnet-beta.solana.com');

// Initialize PrivChain
const privchain = new PrivChain({
  connection,
  network: 'mainnet-beta'
});

2. Connect Your Wallet

// Option A: From existing keypair
const wallet = Keypair.fromSecretKey(yourSecretKey);
await privchain.connect(wallet);

// Option B: Generate new wallet
const newWallet = Keypair.generate();
console.log('New wallet:', newWallet.publicKey.toBase58());
await privchain.connect(newWallet);

3. Check PRIV Balance

const balance = await privchain.getBalance();
console.log(`Balance: ${balance} PRIV`);

4. Transfer PRIV

// Simple transfer
const signature = await privchain.transfer({
  to: 'RecipientAddressHere...',
  amount: 100, // 100 PRIV
});

console.log(`Transfer complete: ${signature}`);

Full Example

Here's a complete working example:

import { PrivChain } from '@privchain/sdk';
import { Connection, Keypair } from '@solana/web3.js';
import bs58 from 'bs58';

async function main() {
  // 1. Setup connection
  const connection = new Connection(
    'https://api.mainnet-beta.solana.com',
    'confirmed'
  );
  
  // 2. Initialize PrivChain
  const privchain = new PrivChain({
    connection,
    network: 'mainnet-beta'
  });
  
  // 3. Load wallet from environment
  const secretKey = bs58.decode(process.env.WALLET_PRIVATE_KEY!);
  const wallet = Keypair.fromSecretKey(secretKey);
  
  // 4. Connect
  await privchain.connect(wallet);
  console.log(`Connected: ${wallet.publicKey.toBase58()}`);
  
  // 5. Check balance
  const balance = await privchain.getBalance();
  console.log(`Balance: ${balance} PRIV`);
  
  // 6. Get token info
  const tokenInfo = await privchain.getTokenInfo();
  console.log('Token:', tokenInfo);
}

main().catch(console.error);

Environment Setup

Create a .env file:

WALLET_PRIVATE_KEY=your_base58_encoded_private_key
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

Security

Never commit private keys to git. Use environment variables or a secure key management solution.

What's Next?

Now that you're connected, explore:

• Token Operations - Transfers, balances, approvals
• Privacy Operations - Use privacy pools (coming soon)
• Agent Identity - Register your agent (coming soon)
• Integrate with LangChain - Build AI agents

Contract Addresses

Contract	Address
PRIV Token	EFy9cEMheBYyrH1HYNonDnKgNzU9tkwiMUMfGNqK4Jua
Privacy Pool	Coming Soon
Identity Registry	Coming Soon

Getting Help

• 💬 Discord - Community support
• 🐛 GitHub Issues - Bug reports
• 📚 API Reference - Full SDK docs