Cdpm Agent Sdk

CDPM Agent SDK Guide

Overview

This guide is for AI agents authorized to manage CDPM positions on behalf of users. Agents have limited permissions and operate within specific boundaries.

Latest Package Address (v2): 0x70bd7eee646217a77502985113eec7a1d9c02ce09a187e5e5f50078ad36a13dc. Use this address for every moveCall. The original package/type address remains 0x612dfd45a2e350995d492a59b595e64ec07a2253912f9eb22c2fd5947c6135d6; use it for object and event type filters. The v2 upgrade transaction is Af6UArK3NcLXNWX5fNeitYBiAKdozHCuUh3qpMdUMevz and links Cetus DLMM v10. The UpgradeCap retains the dependency-only policy (192). Full deployment details live in reference/constants.md.

import { Transaction } from '@mysten/sui/transactions';
import { SuiGrpcClient } from '@mysten/sui/grpc';

Agent Permission Model

What Agents CAN Do

Agent Position Lifecycle

Since the position field is now Option<Position>, the agent controls the Cetus position lifecycle independently of the owner:

• agent_create_position<CoinTypeA, CoinTypeB> — opens a fresh Cetus position from pm.balance. Asserts the PM currently holds no position (EPositionAlreadyExists, 1010), that the passed pool matches the PM's bound pool_id (EWrongPool, 1012), and that the caller is in pm.agents (ENotAllow, 1002). Unused coin remainder is returned to pm.balance. Emits AgentPositionCreated.
• agent_destroy_position<CoinTypeA, CoinTypeB> — closes the Cetus position and routes the underlying assets back into pm.balance. Asserts the PM currently holds a position (ENoPosition, 1011) and that all Cetus rewards have been collected first (EPositionHasRewards, 1007). Emits AgentPositionDestroyed.

Agents cannot move funds out of the PM — both lifecycle functions keep assets inside pm.balance. Withdrawal to the owner remains owner-only.

What Agents CANNOT Do

Permission Check

function canAgentOperate(
  pm: PositionManager,
  agentAddress: string
): boolean {
  return pm.agents.includes(agentAddress);
}

// Example check
const { response: pm } = await client.getObject({ id: pmId, include: { content: true } });
const agents = pm?.content?.fields?.agents || [];
const isAuthorized = agents.includes(agentAddress);

Topics

Core Operations

• Agent Operations - Position lifecycle (create/destroy), add/remove liquidity, collect fees, transfer fees
• Scallop Lending - Agent-driven scallop_supply / scallop_redeem (one tx.moveCall each); yield fee shares fee_house.fee_rate with Kai
• Kai SAV Lending - Agent-driven kai_supply / kai_redeem (one tx.moveCall each); yield fee shares fee_house.fee_rate with Scallop
• Automation Strategies - Auto-compounding, rebalancing, fee collection scheduler

Monitoring & Best Practices

• Event Monitoring - Subscribe to agent events
• Best Practices - Pre-operation checks, batch operations, gas optimization
• Security - Security checklist for agents

Reference

• Error Handling - Common agent errors and recovery strategies
• Constants - Package IDs and default thresholds

Calculations

For liquidity calculations, bin price math, position management, and fee calculations, use the cdpm-calculation skill with the Cetus DLMM SDK:

import { BinUtils, FeeUtils } from '@cetusprotocol/dlmm-sdk/utils'

// Agent-specific calculations
const qPrice = BinUtils.getQPriceFromId(binId, binStep)
const liquidity = BinUtils.getLiquidity(amountA, amountB, qPrice)
const binId = BinUtils.getBinIdFromPrice(price, binStep, true, decimalA, decimalB)
const positionCount = BinUtils.getPositionCount(lowerBinId, upperBinId)
const { amount_a, amount_b } = BinUtils.calculateOutByShare(bin, removeLiquidity)

// Agent strategy helper
function distributeLiquidity(totalA: string, totalB: string, bins: number[], binStep: number) {
  return bins.map(binId => {
    const qPrice = BinUtils.getQPriceFromId(binId, binStep)
    const amountA = (BigInt(totalA) / BigInt(bins.length)).toString()
    const amountB = (BigInt(totalB) / BigInt(bins.length)).toString()
    return { binId, amountA, amountB, liquidity: BinUtils.getLiquidity(amountA, amountB, qPrice) }
  })
}

See cdpm-calculation-skill for the full reference (formulas, redemption sizing, distribution math).