SDK Documentation

import { Loop } from "@loopprotocol/sdk";
import { Connection, Keypair } from "@solana/web3.js";

// Initialize
const connection = new Connection("https://api.mainnet-beta.solana.com");
const wallet = Keypair.generate(); // Use your wallet

const loop = new Loop({ connection, wallet });

// Wrap USDC to Cred (1:1)
const wrapTx = await loop.cred.wrap({
  amount: 100_000_000, // 100 USDC (6 decimals)
});
console.log("Wrapped:", wrapTx);

// Stack Cred for yield
const stackTx = await loop.vault.stack({
  amount: 100_000_000, // 100 Cred
  lockPeriod: 30, // 30 days
});
console.log("Stacked:", stackTx);

// Check position
const position = await loop.vault.getPosition(wallet.publicKey);
console.log("APY:", position.currentApy);

import { LoopByoaaClient } from "@loopprotocol/sdk-byoaa";

const loop = new LoopByoaaClient({
  apiKey: process.env.LOOP_BYOAA_API_KEY!, // dev keys route to https://dev-api.kya.looplocal.io by default
});

const agent = await loop.agents.register({
  external_id: "friend-test-agent",
  display_name: "Friend Test Agent",
  purpose: "Dev adopter integration test",
  risk_tier: "low",
});

await loop.permissions.grant({
  agent_id: agent.id,
  on_behalf_of_user_id: "user_123",
  layer: "shopping",
  action_class: "purchase",
  amount_cap_cents: 2500,
});

const decision = await loop.decisions.request({
  agent_id: agent.id,
  on_behalf_of_user_id: "user_123",
  intended_action: {
    layer: "shopping",
    action_class: "purchase",
    amount_cents: 1250,
    target: { merchant_name: "Loop Demo Merchant" },
  },
});

const pack = await loop.audit.exportPack({
  range: { from: new Date(Date.now() - 86_400_000), to: new Date() },
  format: "json",
});
console.log(decision.outcome, pack.manifest);

// Initialize a vault
const initTx = await loop.vault.initialize({
  owner: wallet.publicKey,
  agent: agentPublicKey,
  policy: {
    dailyLimit: 1000_000_000, // 1000 Cred
    autoStack: true,
    requireUserAbove: 500_000_000,
  },
});

// Get vault info
const vault = await loop.vault.get(wallet.publicKey);
console.log("Balance:", vault.credBalance);
console.log("Staked:", vault.stakedAmount);
console.log("Agent:", vault.agent);

// Wrap USDC → Cred
const wrapTx = await loop.cred.wrap({
  amount: 100_000_000, // 100 USDC
  destination: vaultAddress, // Optional: direct to vault
});

// Unwrap Cred → USDC
const unwrapTx = await loop.cred.unwrap({
  amount: 50_000_000, // 50 Cred
});

// Check balance
const balance = await loop.cred.getBalance(wallet.publicKey);

// Stack with lock period
const stackTx = await loop.vault.stack({
  amount: 1000_000_000, // 1000 Cred
  lockPeriod: 90, // 90 days for bonus APY
});

// Unstake (after lock expires)
const unstakeTx = await loop.vault.unstake({
  amount: 500_000_000,
});

// Claim yield
const claimTx = await loop.vault.claimYield();

// Get staking info
const position = await loop.vault.getPosition(wallet.publicKey);
console.log({
  staked: position.stakedAmount,
  apy: position.currentApy,
  pendingYield: position.pendingYield,
  unlockDate: position.unlockDate,
});

// Register a new agent
const registerTx = await loop.agents.register({
  name: "ShopCapture Pro",
  capabilities: ["shopping_capture", "data_licensing"],
  feePercentage: 5, // 5% of captured value
  metadata: {
    description: "Captures value from retail purchases",
    website: "https://shopcapture.ai",
  },
});

// Get agent info
const agent = await loop.agents.get(agentPublicKey);
console.log("Token Price:", agent.tokenPrice);
console.log("Subscribers:", agent.subscriberCount);

// Subscribe to an agent
const subscribeTx = await loop.agents.subscribe({
  agent: agentPublicKey,
  vault: vaultAddress,
});

// Buy agent tokens (bonding curve)
const buyTx = await loop.agents.buyTokens({
  agent: agentPublicKey,
  amount: 100,
  maxPrice: 1_500_000, // Slippage protection
});