fix: testnet lifecycle error handling and Privy policy (#39)

[joeblau]

Summary

Improving error handling to diagnose and fix the testnet lifecycle failure at the init-agent-and-builder-approvals stage.

Diagnosis: Unfunded Testnet Wallet

Based on the error [UPSTREAM_ERROR] Approval failed and investigation of Hyperliquid documentation, the root cause is:

The master wallet (AGENT_CLI_TEST_MASTER_KEY) has never deposited on Hyperliquid testnet.

Hyperliquid returns "Must deposit before performing actions" when a wallet with no balance attempts approveAgent or approveBuilderFee actions.

Changes Made

Commit 1-3: Error handling improvements

1. 3349cdb: Fixed bare catch {} block to capture errors in lifecycle report
2. b682b24: Extract error code/message from CLI command envelope
3. e2e9b22: Verified exportPrivateKey/exportSeedPhrase are valid policy methods per Privy docs

Commit 4: Surface Hyperliquid approval errors (086f717)

• Modified submitApproval() to include:
  • Action type (approveAgent or approveBuilderFee)
  • Raw Hyperliquid response text
  • Full response object in error details
• Added masterAddress to lifecycle report for troubleshooting

Next Workflow Run Will Show

With these improvements, the next run will display:

[UPSTREAM_ERROR] approveAgent failed: Must deposit before performing actions

And lifecycle-report.json will contain:

{
  "masterAddress": "0x...",
  "error": {
    "stage": "init-agent-and-builder-approvals",
    "message": "[UPSTREAM_ERROR] approveAgent failed: Must deposit before performing actions"
  }
}

Human Step Required

The AGENT_CLI_TEST_MASTER_KEY wallet needs to be funded on Hyperliquid testnet.

Steps:

1. Trigger the workflow to get the master address from lifecycle-report.json:

   gh workflow run e2e.yml --ref cursor/fix-testnet-error-swallowing-a121

2. Download the artifact after the run completes:

   gh run download <run-id> --name testnet-journals-<run-id>

3. Get the master address from the report:

   cat lifecycle-report.json | jq -r '.masterAddress'

4. Fund the wallet with mock USDC:

   • Visit https://app.hyperliquid-testnet.xyz/trade
   • Connect with the master wallet address
   • Go to the Faucet tab
   • Claim mock USDC (any amount > 0 is sufficient)

5. Re-run the workflow - it should now pass the approval stage

Why This Is Needed

From Hyperliquid GitHub issue #9 and API documentation:

"Make sure your node has a nonzero perps USDC balance on the Hyperliquid testnet. You can claim mock USDC on the Faucet tab of the Hyperliquid testnet front end."

The approveAgent action must be signed by the master account, and that account must have deposited on Hyperliquid at least once. The agent wallet does not need funding.

Why This Started Failing on Oct 17

The secrets were switched from BLOXWAP_TEST_MASTER_KEY to AGENT_CLI_TEST_MASTER_KEY around Oct 18 (commit b1c014d). The new wallet likely has never deposited on Hyperliquid testnet.

The tests passed Oct 14-16 because the old wallet was funded.

Related

• Tracking issue: Testnet end-to-end test suite #39
• Orders stay mocked ✅