[Proxy Colonies] Feat: Proxy colony balance validation

[iamsamgibbs]

Description

This PR adds validation for balances on a proxy chain to the simple payment action (and should work for other actions once those forms have been updated).

It also fixes an issue with the fetchTokenFromChain lambda which was returning a malformed token due to the fragment changes.

Testing

• Step 1 - Create a "Manage supported chain" action to add proxy chain 1.

• Step 2 - Switch your metamask wallet to proxy chain 1 (follow the steps in [Proxy colonies] Handle incoming funds #4174 if you haven't already set it up)
• Step 3 - Copy the colony address and send tokens via metamask to the colony.

• Step 4 - Deploy a token to the proxy chain, mint tokens and add it as an approved token.

In your terminal, run node scripts/deploy-token-to-chain.js
Please use the following values for the input
foreignChainId 265669101
foreignChainRpcUrl http://localhost:8546
colonyAddress <COLONY_ADDRESS_HERE>

Then we must mint some tokens to generate our incoming funds. Copy the token address that was printed to the console and paste it somewhere to access later.

Run node scripts/unlock-mint-tokens-on-chain.js
Please use the following values for the input
foreignChainRpcUrl http://localhost:8546
colonyAddress <COLONY_ADDRESS_HERE>
tokenAddress <TOKEN_ADDRESS_YOU_COPIED_FROM_THE_CONSOLE>
tokenAmount 100

Then we need to add this as an approved token, otherwise it won't show in the incoming funds list. The "manage tokens" action has yet to be updated to support this, so we must manually add it to the database. In GraphiQL, run this query:

mutation MyMutation {
  createColonyTokens(input: {tokenID: "<TOKEN_ADDRESS>", colonyID: "<COLONY_ADDRESS>"})
}

• Step 5 - Refresh and navigate to http://localhost:9091/planex/balances confirm that the current balances for the tokens on the proxy chain are 0.

• Step 5 - Navigate to http://localhost:9091/planex/incoming
• Step 6 - Accept all available funds.

• Step 7 - Back to the balances page, check that the newly claimed tokens are shown.

• Step 8 - Create a simple payment action. In the "From" field, select the proxy chain. In the "Amount" field, select a token and enter an amount higher than the available balance. Check the error validation shows. Then check it disappears with an amount below the available balance.

• Step 9 - Switch the "From" field to the "Ganache" main chain. (Note: The amount is not revalidated when switching chains or domains (the same is true on master for domains) - this should be handled as a separate issue.) Enter a new amount and check the validation works as expected.

Diffs

New stuff ✨

• Balances are now validated correctly for proxy chain balances

Changes 🏗

• Fix token structure in fetchTokenByChain lambda

Resolves #4193

[iamsamgibbs]

Don't bother mapping through tokens that don't exist on this chain where the balances will definitely be 0.

[rdig]

Good to go

[mmioana]

Really nice work @iamsamgibbs 🎉 the amount field is validated based on the available funds on each chain

Screen.Recording.2025-02-07.at.13.43.20.mov