Intent SDK (Beta)

The Verdant Intent SDK is a TypeScript library that simplifies the process of managing Personas, generating Shards, and submitting private transfer intents.

Installation

Install the package via NPM or Yarn.

Bash

npm install @verdant-protocol/sdk @solana/web3.js

Initialization

Initialize the client by connecting it to a Solana Connection and a Wallet Adapter.

TypeScript

import { Connection, Keypair } from '@solana/web3.js';
import { VerdantClient, NetworkType } from '@verdant-protocol/sdk';

// 1. Setup Solana Connection
const connection = new Connection('https://api.devnet.solana.com');

// 2. Initialize Verdant Client
const client = new VerdantClient({
  connection: connection,
  network: NetworkType.DEVNET,
  wallet: userWallet // From your wallet adapter
});

Creating an Intent

To send a private transaction, you must build an IntentObject.

TypeScript

import { IntentBuilder, PrivacyLevel } from '@verdant-protocol/sdk';

async function sendPrivateFunds() {
  // Define the transfer details
  const intent = new IntentBuilder()
    .setRecipient('DestAddress1111111111111111111111111')
    .setAmount(1.5) // Amount in SOL
    .setPrivacyLevel(PrivacyLevel.HIGH) // Enables time delays
    .setSlippage(0.5) // 0.5% max fee variance
    .build();

  // Execute the intent
  try {
    const txHash = await client.executeIntent(intent);
    console.log(`Intent submitted. Hash: ${txHash}`);
  } catch (err) {
    console.error("Execution failed:", err);
  }
}

Listening for Updates

You can subscribe to the status of an intent using the WebSocket method.

TypeScript

client.onIntentUpdate((update) => {
  console.log(`Intent ${update.id} is now ${update.status}`);
  if (update.status === 'COMPLETED') {
    console.log("Transfer successful!");
  }
});