Troubleshooting

Common issues and solutions.

CLI Issues

"Command not found: sadclaw"

Cause: CLI not installed or not in PATH.

Solution:

# Use npx instead
npx sadclaw

# Or install globally
npm install -g sadclaw

"No wallet found"

Cause: Wallet not initialized.

Solution:

npx sadclaw init

"Insufficient SOL for transaction"

Cause: Need SOL for Solana transaction fees.

Solution:

Send at least 0.01 SOL to your wallet address:

npx sadclaw address

"Insufficient USDC"

Cause: Not enough USDC to purchase VM.

Solution:

1. Check your balance: npx sadclaw balance

2. Fund your wallet with USDC on Solana

3. See Fund USDC on Solana

"Transaction failed"

Cause: Network congestion or RPC issues.

Solution:

1. Wait a few seconds and retry

2. Try a different RPC endpoint:

npx sadclaw config --set rpcUrl https://api.mainnet-beta.solana.com

VM Issues

"VM not provisioning"

Cause: Backend provisioning delay.

Solution:

1. Wait up to 5 minutes - provisioning can take time

2. Check status: npx sadclaw list

3. If stuck in "provisioning" for >10 minutes, contact support

"Can't SSH into VM"

Cause: Various connection issues.

Solutions:

1. Verify VM is active: npx sadclaw list

2. Check your network/firewall allows outbound SSH (port 22)

3. Try with verbose output:

npx sadclaw ssh <nft-mint> -- -v

1. Get credentials manually and test:

# Get SSH details
npx sadclaw list --json | jq '.[0]'

# Manual SSH
ssh root@<ip-address>

"VM expired"

Cause: Duration ended.

Solution:

The VM has been terminated. You need to purchase a new one:

npx sadclaw buy --tier STANDARD --duration 24

Tip: Set up monitoring to extend VMs before expiration.

"Permission denied (publickey)"

Cause: SSH key mismatch.

Solution:

Use the CLI to connect (it handles keys automatically):

npx sadclaw ssh <nft-mint>

Or retrieve fresh credentials:

npx sadclaw list --json

SDK Issues

"ECONNREFUSED"

Cause: Can't connect to API server.

Solution:

1. Check your internet connection

2. Verify API URL is correct:

const client = new SadClawClient({
  rpcUrl: 'https://api.mainnet-beta.solana.com',
  keypair,
  apiUrl: 'https://api.sadclaw.cloud', // Verify this
});

1. Check status.sadclaw.cloud for outages

"Invalid signature"

Cause: Wallet signature verification failed.

Solution:

Ensure you're using the correct keypair:

import { Keypair } from '@solana/web3.js';

// Load from file
const keypair = Keypair.fromSecretKey(
  Uint8Array.from(JSON.parse(fs.readFileSync('wallet.json')))
);

// Or from base64
const keypair = Keypair.fromSecretKey(
  Buffer.from(process.env.PRIVATE_KEY, 'base64')
);

"NFT not found"

Cause: Invalid NFT mint address or not owned by wallet.

Solution:

1. Verify the NFT mint address is correct

2. Check you're using the wallet that owns the NFT

3. List your VMs to get correct mint addresses:

const vms = await client.listVms();
console.log(vms.map(v => v.nftMint));

Network Issues

"RPC rate limited"

Cause: Too many requests to public RPC.

Solution:

Use a dedicated RPC provider:

• Helius

• QuickNode

• Alchemy

npx sadclaw config --set rpcUrl https://your-rpc-url.com

"Transaction timeout"

Cause: Solana network congestion.

Solution:

1. Retry the transaction

2. Try during off-peak hours

3. Increase priority fee (if supported)

Still Stuck?

1. Search GitHub Issues

2. Open a new issue with:

   • Your CLI/SDK version

   • Steps to reproduce

   • Full error message

3. Ask on Twitter/X