debug

/agirails:debug

Diagnose and fix common ACTP integration issues.

What This Command Does

1. Identify issue type (transaction error, SDK error, network error)
2. Run diagnostic checks
3. Explain root cause
4. Provide actionable fix

Step-by-Step Instructions

Step 1: Identify Issue Type

If transaction ID provided:

• Fetch transaction details
• Check state validity
• Verify escrow balance

If error message provided:

• Parse error type
• Match against known patterns

If neither:

"What issue are you experiencing?"
Options:
  [Transaction stuck]
  [SDK error]
  [Payment failed]
  [Connection issues]
  [Other - describe]

Step 2: Common Error Patterns

Error	Cause	Fix
INSUFFICIENT_BALANCE	Not enough USDC	Mint test USDC (mock) or add funds
INVALID_STATE_TRANSITION	Wrong state for action	Check current state with /agirails:status
DEADLINE_PASSED	Transaction expired	Create new transaction with longer deadline
NOT_AUTHORIZED	Wrong caller	Use correct address (requester vs provider)
CONTRACT_PAUSED	Emergency pause active	Wait for unpause
ESCROW_NOT_LINKED	No funds locked	Call linkEscrow() first

Step 3: Diagnostic Commands

Check SDK Connection:

// Test connection
const client = await ACTPClient.create({
  mode: 'mock',
});
console.log('Mode:', client.getMode());
console.log('Address:', client.getAddress());
console.log('Info:', client.info);

Check Transaction State:

const tx = await client.standard.getTransaction('0x...');
console.log('State:', tx.state);
console.log('Requester:', tx.requester);
console.log('Provider:', tx.provider);
console.log('Amount:', tx.amount);
console.log('Deadline:', new Date(tx.deadline * 1000));
console.log('Is expired:', tx.deadline < Date.now() / 1000);

Check Balances:

const balance = await client.getBalance(client.getAddress());
const escrowBalance = await client.standard.getEscrowBalance('0x...');
console.log('USDC Balance (wei):', balance);
console.log('Locked in Escrow:', escrowBalance);