SDK overview

pnpm add @lightprotocol/stateless.js

import { ... } from "@x84-ai/sdk";              // Core SDK
import { ... } from "@x84-ai/sdk/settlement";    // Settlement (Light Protocol)

import { Connection, Keypair, PublicKey } from "@solana/web3.js";
import { AnchorProvider, Program } from "@coral-xyz/anchor";
import {
  X84_PROGRAM_ID,
  getNetworkConfig,
  findConfigPda,
  findAgentPda,
  registerAgent,
  fetchAgentIdentity,
  ServiceType,
  hashTag,
} from "@x84-ai/sdk";

// 1. Setup
const connection = new Connection("https://api.devnet.solana.com");
const wallet = new NodeWallet(ownerKeypair);
const provider = new AnchorProvider(connection, wallet);
const program = new Program(idl, provider);
const config = getNetworkConfig("devnet");

// 2. Register an agent (mints an NFT)
const { instruction, asset, agentPda } = await registerAgent(program, {
  owner: ownerKeypair.publicKey,
  configAuthority: ownerKeypair.publicKey,
  metadataUri: "https://example.com/agent.json",
  metadataHash: hashBytes(metadataBuffer),
  feedbackAuthority: feedbackKeypair.publicKey,
  tags: ["ai-assistant", "code-review"],  // auto-hashed
  collection: config.collection!,
  feeTreasury: config.feeTreasury!,
});
// Sign with: [ownerKeypair, asset]

// 3. Read the agent back
const agent = await fetchAgentIdentity(program, asset.publicKey);
console.log(agent.metadataUri, agent.owner.toBase58());

import {
  X84_PROGRAM_ID,        // Program ID: X84XHMKT7xvjgVUXFNQLZLSdCEEZu2wAPrAeP4M9Hhi
  MPL_CORE_PROGRAM_ID,   // Metaplex Core: CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d
  SEEDS,                 // PDA seed prefixes
  NETWORKS,              // Per-network deployment addresses
  getNetworkConfig,      // Get typed config for "devnet" | "mainnet"
  DEFAULT_REGISTRATION_FEE,    // 50_000_000 lamports (0.05 SOL)
  DEFAULT_SETTLEMENT_FEE_BPS,  // 300 (3%)
  MAX_SETTLEMENT_FEE_BPS,      // 1000 (10%)
} from "@x84-ai/sdk";

import {
  findConfigPda,           // ["config"]
  findAgentPda,            // ["agent", nftMint]
  findServicePda,          // ["service", nftMint, serviceTypeSeed]
  findFeedbackPda,         // ["feedback", nftMint, reviewer, nonce(8)]
  findValidationRequestPda, // ["val_request", nftMint, validator, hash[0..8]]
  findValidationResponsePda, // ["val_response", nftMint, validator, hash[0..8]]
  findDelegationPda,       // ["delegation", delegator, delegate, id(8)]
  findPaymentReqPda,       // ["payment_req", nftMint, serviceTypeSeed]
  findReceiptPda,          // ["receipt", paymentId]
  findCpiAuthorityPda,     // ["cpi_authority"]
} from "@x84-ai/sdk";

// Example
const [agentPda] = findAgentPda(nftMint);
const [servicePda] = findServicePda(nftMint, "a2a");

import {
  fetchProtocolConfig,
  fetchAgentIdentity,
  fetchAgentIdentityOrNull,  // returns null if not found
  fetchService,
  fetchFeedbackEntry,
  fetchDelegation,
  fetchDelegationByPda,
  fetchPaymentRequirement,
} from "@x84-ai/sdk";

const config = await fetchProtocolConfig(program);
const agent = await fetchAgentIdentity(program, nftMint);
const service = await fetchService(program, nftMint, ServiceType.A2A);

import {
  fetchAllAgents,
  fetchAgentsByOwner,
  fetchServicesByAgent,
  fetchDelegationsByDelegate,
  fetchDelegationsByAgent,
} from "@x84-ai/sdk";

const myAgents = await fetchAgentsByOwner(program, myPubkey);
const services = await fetchServicesByAgent(program, nftMint);
const delegations = await fetchDelegationsByDelegate(program, myPubkey);

import {
  hashTag,          // string -> 32-byte SHA-256 hash
  hashBytes,        // Uint8Array -> 32-byte SHA-256 hash
  stringToBytes32,  // string -> 32-byte zero-padded array
  zeroBytes32,      // 32 zero bytes
  zeroBytes64,      // 64 zero bytes
  randomPaymentId,  // random 32-byte payment ID
  randomSignature,  // random 64-byte signature placeholder
} from "@x84-ai/sdk";

import { parseX84Error, X84Error, X84ErrorCode } from "@x84-ai/sdk";

try {
  await program.methods.registerAgent(...).rpc();
} catch (err) {
  const x84err = parseX84Error(err);
  if (x84err) {
    console.log(x84err.code, x84err.message);
    // e.g. 6036, "Insufficient registration fee"
  }
}