Credex 协议技能

与 Credex 协议交互——Arc 网络上面向 AI 代理的去中心化信用系统。

使用方法

基础目录：{baseDir}（即本 SKILL.md 文件所在目录）

所有命令均需在项目根目录下执行：

cd {baseDir}
npx ts-node scripts/client.ts  [args]   # 借款人命令
npx ts-node scripts/lp.ts  [args]       # 流动性提供者（LP）命令

输出格式：所有脚本均返回 JSON 格式，便于机器解析。请解析输出以提取如 creditLimit、txHash、debt 等字段。

环境变量

必需项（必须设置）

可选项

预检步骤：运行任意命令前，请确认已设置 WALLET_PRIVATE_KEY。若缺失，应提示用户补充。

合约地址（Arc 测试网）

客户端命令（借款人）

脚本：scripts/client.ts
执行方式：npx ts-node scripts/client.ts [args]

status

检查某代理的信用状态。

用法：

npx ts-node scripts/client.ts status 

参数：

• address（可选）：钱包地址。默认为 WALLET_PRIVATE_KEY 对应的地址。

返回值：JSON

{
  "creditLimit": "100.000000",
  "principal": "5.000000",
  "interest": "0.050000",
  "debt": "5.050000",
  "availableCredit": "95.000000",
  "active": true,
  "frozen": false
}

操作建议：调用 borrow 前，请使用 availableCredit 字段判断是否具备足够授信额度。

borrow

从资金池借入 USDC。

用法：

npx ts-node scripts/client.ts borrow 

参数：

• amount（必需）：USDC 金额，以十进制字符串形式传入（例如："5.0"）。

返回值：JSON

{
  "success": true,
  "txHash": "0x...",
  "borrowed": "5.000000",
  "newDebt": "5.000000",
  "availableCredit": "95.000000"
}

失败条件：amount > availableCredit。请先调用 status 查询可用额度。

repay

向资金池偿还债务。

用法：

npx ts-node scripts/client.ts repay 

参数：

• amount：指定需偿还的 USDC 金额（例如："5.0"）。
• all：自动计算总债务 + 1% 缓冲，并全额偿还。合约实际执行时将按真实欠款上限截断。

返回值：JSON

{
  "success": true,
  "txHash": "0x...",
  "repaid": "5.050000",
  "remainingDebt": "0.000000",
  "newCreditLimit": "110.000000"
}

注意：还款优先清偿 利息，再清偿 本金。每次成功还款后，信用额度提升 10%。

bridge

在 Arc 测试网与 Base Sepolia 之间跨链桥接 USDC。

用法：

npx ts-node scripts/client.ts bridge   

参数：

• amount：USDC 金额（例如："10.0"）。
• from：源链（arc 或 base）。
• to：目标链（arc 或 base）。

返回值：JSON

{
  "success": true,
  "amount": "10.000000",
  "from": "Arc_Testnet",
  "to": "Base_Sepolia",
  "estimatedArrival": "5-10 minutes"
}

失败条件：from === to。源链与目标链必须不同。

balance

查询钱包在两条链上的余额。

用法：

npx ts-node scripts/client.ts balance

返回值：JSON

{
  "arc": "50.000000",
  "base": "25.000000",
  "total": "75.000000"
}

LP 命令（流动性提供者）

脚本：scripts/lp.ts
执行方式：npx ts-node scripts/lp.ts [args]

pool-status

检查资金池整体健康状况与关键指标。

用法：

npx ts-node scripts/lp.ts pool-status

返回值：JSON

{
  "totalAssets": "1000.000000",
  "totalLiquidity": "800.000000",
  "totalDebt": "200.000000",
  "totalShares": "950.000000",
  "sharePrice": "1.052631",
  "utilizationPercent": 20
}

deposit

存入 USDC 以获取 LP 份额。

用法：

npx ts-node scripts/lp.ts deposit 

参数：

• amount：拟存入的 USDC 数量（例如："100.0"）。

返回值：JSON

{
  "success": true,
  "txHash": "0x...",
  "deposited": "100.000000",
  "sharesReceived": "95.000000",
  "totalShares": "95.000000"
}

withdraw

销毁 LP 份额以提取 USDC。

用法：

npx ts-node scripts/lp.ts withdraw 

参数：

• shares：拟销毁的份额数量（例如："50.0"）。
• all：根据当前可用流动性，提取最大可提金额。

返回值：JSON

{
  "success": true,
  "txHash": "0x...",
  "sharesBurned": "50.000000",
  "usdcReceived": "52.631579",
  "remainingShares": "45.000000"
}

注意：若流动性已被完全借出（即全部 USDC 已贷出），提款可能被限制。

lp-balance

查询某地址的 LP 持仓情况。

用法：

npx ts-node scripts/lp.ts lp-balance [address]

返回值：JSON

{
  "shares": "95.000000",
  "value": "100.000000"
}

协议机制

利息累积

• 利率：每个计息周期 0.1%（即 10 个基点）
• 计息周期：1 分钟（测试网已加速）
• 公式：debt = principal + accrued_interest

信用额度增长

每次还款后：

newLimit = currentLimit × 1.10

上限：10,000 USDC。

可用授信额度

availableCredit = creditLimit - principal

利息不占用借款能力——仅本金计入扣减。

LP 份额价格

sharePrice = totalAssets / totalShares

其中 totalAssets = liquidity + outstandingDebt。

工作流示例

借款人流程

1. 查询状态     → npx ts-node scripts/client.ts status
2. 发起借款     → npx ts-node scripts/client.ts borrow 5
3. 使用资金     → （在 Arc 上执行任务，或桥接到 Base）
4. 桥回资金     → npx ts-node scripts/client.ts bridge 5 base arc
5. 全额还款     → npx ts-node scripts/client.ts repay all
6. 验证增长     → npx ts-node scripts/client.ts status（额度已提升！）

LP 流程

1. 查询资金池   → npx ts-node scripts/lp.ts pool-status
2. 存入资金     → npx ts-node scripts/lp.ts deposit 100
3. 监控持仓     → npx ts-node scripts/lp.ts lp-balance
4. 提取资金     → npx ts-node scripts/lp.ts withdraw all

常见错误与恢复方案

参考资料

• 完整 ABI 与类型定义请参见 references/contracts.md。
• 实现细节请参见 scripts/client.ts 与 scripts/lp.ts。