DEVREL-1012 fix squads vault detection

[nazreen]

Problem

• The API endpoint (https://4fnetmviidiqkjzenwxe66vgoa0soerr.lambda-url.us-east-1.on.aws/isSquad/${address}) by Squads only works for mainnet.

Changes

• Updated isSquadsV4Vault to take eid: EndpointId as first parameter and return null for Solana testnet (40168), since the Squads API only works on mainnet (30168). Throws for unsupported EIDs.

• Refactored assertValidSolanaAdmin to use flattened early-return structure for better readability

• Allow for PDAs owned by Squads V3 program (SMPLecH534NA9acpos4G6x7uf3LWbCAwZQE9e8ZekMu) - allows with warning instead of throwing

• Addressed missing case of when address is off curve by not owned by System Program or a Squads program (we should throw)

• Removed isPossibleSquadsVault function (unused, logic consolidated into assertValidSolanaAdmin)

• Added debug logging throughout address validation helpers using lazy logger factory pattern (fixes issue where logs weren't respecting --log-level flag)

Testing

pnpm build --filter=./packages/devtools-solana
cd examples/oft-solana

deploy and wire as usual, then refer to Proof of Test section
(update the delegate address in the LZ config)

Proof of Test

Tip: when looking through the logs, search for 'Solana addresses'.

When new delegate is regular (onCurve) address (EKXXXF8kzh4Bnq1HBHVwZgA5egJJWLDYqXmJTQtbbd5D)

npx hardhat lz:oapp:wire --oapp-config layerzero.config.ts --ci --multisig-key 59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff --log-level debug
...
debug:   [Solana addresses] [assertValidSolanaAdmin] start address=EKXXXF8kzh4Bnq1HBHVwZgA5egJJWLDYqXmJTQtbbd5D
debug:   [Solana addresses] [isOnCurveAddress] address=EKXXXF8kzh4Bnq1HBHVwZgA5egJJWLDYqXmJTQtbbd5D onCurve=true
debug:   [Solana addresses] [assertValidSolanaAdmin] address=EKXXXF8kzh4Bnq1HBHVwZgA5egJJWLDYqXmJTQtbbd5D valid

When new delegate is a Squads v4 vault on devnet (DokBLkqgnws2GsfBcbowX1bYqk4noYEhcDDdTZDV8Yh)

npx hardhat lz:oapp:wire --oapp-config layerzero.config.ts --ci --multisig-key 59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff --log-level debug
...
debug:   [Solana addresses] [assertValidSolanaAdmin] start address=DokBLkqgnws2GsfBcbowX1bYqk4noYEhcDDdTZDV8Yh
debug:   [Solana addresses] [isOnCurveAddress] address=DokBLkqgnws2GsfBcbowX1bYqk4noYEhcDDdTZDV8Yh onCurve=false
debug:   [Solana addresses] [assertValidSolanaAdmin] address=DokBLkqgnws2GsfBcbowX1bYqk4noYEhcDDdTZDV8Yh valid: off-curve, account does not exist (possibly unfunded Squads Vault)

When new delegate is a Squads v4 Multisig (invalid) on devnet (59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff)

npx hardhat lz:oapp:wire --oapp-config layerzero.config.ts --ci --multisig-key 59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff --log-level debug
...
debug:   [Solana addresses] [assertValidSolanaAdmin] start address=59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff
debug:   [Solana addresses] [isOnCurveAddress] address=59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff onCurve=false
debug:   [Solana addresses] [assertValidSolanaAdmin] address=59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff invalid: off-curve, account exists, owned by Squads Program (multisig account)
Error: SOLANA_OWNER_OR_DELEGATE_MULTISIG_ACCOUNT
Fix suggestion: The owner or delegate of the Solana OApp must not be the Squads multisig account address.
Elaboration: If you intend to use Squads Multisig, ensure that you are providing a Squads Vault address as the owner or delegate of the OApp. The Squads Multisig account address cannot be the owner or delegate.

error:   [OApp] Failed to check OApp delegate for [5jBe5bLSsm1wXu6YD5KTDyDehFmgUrE4Crw9LyedkWTe @ SOLANA_V2_TESTNET]: Error: Invalid owner/delegate address 59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff. This is a Squads multisig account. Use the vault address instead.
error:   [OApp] Failed to check OApp configuration: Error: Invalid owner/delegate address 59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff. This is a Squads multisig account. Use the vault address instead.
verbose: [::lz:oapp:wire:configure] Encountered an error: Error: Invalid owner/delegate address 59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff. This is a Squads multisig account. Use the vault address instead.
An unexpected error occurred:

Error: An error occurred while getting the OApp configuration: Error: Invalid owner/delegate address 59jdDuB6khhBf9nwwyJfwGXPeEF2mxTMbQusNXGAXjff. This is a Squads multisig account. Use the vault address instead.

[github-actions]

🚨 E2E Tests Failed

The E2E tests failed during CI. These tests validate real blockchain interactions and may fail due to:

• Network connectivity issues
• RPC rate limiting
• External service downtime
  Action Run: https://github.com/LayerZero-Labs/devtools/actions/runs/20075198942

This is non-blocking and does not prevent merging. Check the action logs above for detailed failure information.

[github-actions]

🚨 E2E Tests Failed

The E2E tests failed during CI. These tests validate real blockchain interactions and may fail due to:

• Network connectivity issues
• RPC rate limiting
• External service downtime
  Action Run: https://github.com/LayerZero-Labs/devtools/actions/runs/20075984672

This is non-blocking and does not prevent merging. Check the action logs above for detailed failure information.

[cursor]

PR Summary

Improves Solana address validation and Squads vault detection with network awareness and clearer rules.

• Changes isSquadsV4Vault(eid, address) to use Squads API only on mainnet; returns null on testnet and throws for unsupported EIDs
• Refactors assertValidSolanaAdmin with early returns and explicit cases: rejects Squads V4 multisig accounts, allows System Program (vault) and Squads V3 (with warning), throws for unrecognized program owners
• Adds module-scoped debug logging via createModuleLogger to isOnCurveAddress, isSquadsV4Vault, and assertValidSolanaAdmin
• Removes legacy isPossibleSquadsVault logic (consolidated into assertValidSolanaAdmin)
• Updates example examples/oft-solana/tasks/solana/debug.ts to pass eid to isSquadsV4Vault and note mainnet-only behavior
• Adds changesets for @layerzerolabs/devtools-solana and @layerzerolabs/oft-solana-example

^{Written by Cursor Bugbot for commit cf14b14. This will update automatically on new commits. Configure here.}

[github-actions]

🚨 E2E Tests Failed

The E2E tests failed during CI. These tests validate real blockchain interactions and may fail due to:

• Network connectivity issues
• RPC rate limiting
• External service downtime
  Action Run: https://github.com/LayerZero-Labs/devtools/actions/runs/20720743358

This is non-blocking and does not prevent merging. Check the action logs above for detailed failure information.